@dxtmisha/functional-basic 1.8.7 → 1.8.10

package/CHANGELOG.md

@@ -2,6 +2,29 @@
 
 All notable changes to this project will be documented in this file.
 
+## [1.8.10] - 2026-08-20
+
+### Changed
+- **AI Resource Metadata & Types**:
+  - Migrated prompt resource metadata from monolithic `prompts.json` into individual resource descriptor files (`ai-types-list/resources/api-reference.json`).
+  - Regenerated AI type definitions and package descriptions with updated AI prompt formats.
+- **Git Configuration**:
+  - Added `ai-description.md` and `ai-mcp-resources.json` to `.gitignore`.
+
+## [1.8.9] - 2026-08-16
+
+### Added
+- **LLM Configuration**: Added `llms.txt` configuration for package-level LLM context and documentation indexing.
+
+### Changed
+- **AI Documentation & Types**: Regenerated package descriptions (`ai-description.md`) and updated AI type definitions.
+
+## [1.8.8] - 2026-08-15
+
+### Changed
+- **getMouseClient / getMouseClientX / getMouseClientY**: Updated event parameter type definition from `MouseEvent & TouchEvent` to `MouseEvent | TouchEvent` and refactored coordinate resolution with explicit `'clientX' in event` and `'clientY' in event` property checks.
+- **Tests & Documentation**: Updated unit test suites and wiki documentation files across all languages (ru, en, vi) to match the updated `MouseEvent | TouchEvent` event signature.
+
 ## [1.8.7] - 2026-08-12
 
 ### Changed

package/ai-description.md

@@ -1,13 +1,6 @@
-This package is a comprehensive utility library providing robust tools for API requests, data caching, localization, formatting, and state management. Study it to understand enterprise-grade frontend architecture, robust error handling, SSR-compatible data hydration, and advanced internationalization primitives.
+This package is a comprehensive utility library designed for web applications, providing robust core functions for API requests, caching, internationalization (Geo/Intl), state management, DOM manipulation, and SEO metadata control. An AI assistant must study this file when implementing or refactoring features related to HTTP communication, localized data formatting, browser storage, query/hash state synchronization, or search filtering to ensure adherence to established patterns and type definitions.
 
-API Integration
-State Management
-Caching
-Internationalization
-Localization
-URL Routing
-Event Handling
-Meta Tags
+Key Capabilities: API Integration, Request Caching, Internationalization, Cookie Management, Local Storage, URL State, DOM Utilities, Meta Tags, Search Matching, Error Handling
 ## Mandatory Rules
 You MUST evaluate whether your task relates to any of the following topics (even if not working directly with this package). If related material is present, you are strictly obligated to read and study the corresponding file before proceeding:
-- 'node_modules/@dxtmisha/functional-basic/ai-resources/api-reference.md': Provides code examples and usage patterns for the @dxtmisha/functional-basic library modules including HTTP client, storage, geolocation, and DOM helpers. It helps AI agents understand how to correctly integrate and utilize utility functions for frontend and backend tasks.
+- 'node_modules/@dxtmisha/functional-basic/ai-resources/api-reference.md': Provides code examples and usage patterns for HTTP clients, caching, data storage, localization, and DOM helpers from the @dxtmisha/functional-basic library. Guides AI assistants on how to properly implement core functional utilities in TypeScript applications.

package/ai-mcp-resources.json

@@ -13,8 +13,8 @@
   },
   {
     "uri": "@dxtmisha/functional-basic/ai-resources/api-reference.md",
-    "name": "API Reference and Examples (@dxtmisha/functional-basic)",
+    "name": "API Reference And Examples (@dxtmisha/functional-basic)",
     "mimeType": "text/markdown",
-    "description": "Provides code examples and usage patterns for the @dxtmisha/functional-basic library modules including HTTP client, storage, geolocation, and DOM helpers. It helps AI agents understand how to correctly integrate and utilize utility functions for frontend and backend tasks."
+    "description": "Provides code examples and usage patterns for HTTP clients, caching, data storage, localization, and DOM helpers from the @dxtmisha/functional-basic library. Guides AI assistants on how to properly implement core functional utilities in TypeScript applications."
   }
 ]

package/ai-types.md

@@ -1,4 +1,4 @@
-All these methods are in the @dxtmisha/functional-basic (v1.8.7) library.
+All these methods are in the @dxtmisha/functional-basic (v1.8.10) library.
 
 /** Check if server runs on localhost @keywords api, localhost */
 export declare class Api {
@@ -2074,17 +2074,14 @@ export declare function getMaxLengthAllArray(data: ObjectOrArray<string>): numbe
  */
 export declare function getMinLengthAllArray(data: ObjectOrArray<string>): number;
 
-/** Returns mouse client coordinates from event. @keywords mouse, coordinates, clientX, clientY */
-export declare function getMouseClient(event: MouseEvent & TouchEvent): ImageCoordinator;
+/** Returns the position of the mouse cursor or click. @keywords getMouseClient mouse touch event coordinates */
+export declare function getMouseClient(event: MouseEvent | TouchEvent): ImageCoordinator;
 
-/**
- * Returns the client X coordinate from mouse or touch events.
- * @keywords mouse client x coordinate touch clientX
- */
-export declare function getMouseClientX(event: MouseEvent & TouchEvent): number;
+/** Returns mouse X coordinate or click location. @keywords mouse client x coordinate */
+export declare function getMouseClientX(event: MouseEvent | TouchEvent): number;
 
-/** Returns mouse client Y coordinate or click location. @keywords mouse y client cursor coordinate */
-export declare function getMouseClientY(event: MouseEvent & TouchEvent): number;
+/** Returns the Y coordinate of the mouse cursor or touch event. @keywords getMouseClientY mouse touch Y coordinate */
+export declare function getMouseClientY(event: MouseEvent | TouchEvent): number;
 
 /** Filter object by keys @keywords getObjectByKeys pick keys */
 export declare function getObjectByKeys<T extends Record<string, any>, K extends keyof T>(data: T, keys: K[]): Pick<T, K>;

package/dist/functions/getMouseClient.d.ts

@@ -6,4 +6,4 @@ import { ImageCoordinator } from '../types/basicTypes';
  * @param event event object/ объект события
  * @returns coordinates of the mouse cursor / координаты курсора мыши
  */
-export declare function getMouseClient(event: MouseEvent & TouchEvent): ImageCoordinator;
+export declare function getMouseClient(event: MouseEvent | TouchEvent): ImageCoordinator;

package/dist/functions/getMouseClientX.d.ts

@@ -5,4 +5,4 @@
  * @param event event object/ объект события
  * @returns X coordinate / координата X
  */
-export declare function getMouseClientX(event: MouseEvent & TouchEvent): number;
+export declare function getMouseClientX(event: MouseEvent | TouchEvent): number;

package/dist/functions/getMouseClientY.d.ts

@@ -5,4 +5,4 @@
  * @param event event object/ объект события
  * @returns Y coordinate / координата Y
  */
-export declare function getMouseClientY(event: MouseEvent & TouchEvent): number;
+export declare function getMouseClientY(event: MouseEvent | TouchEvent): number;

package/dist/library.js

@@ -4739,13 +4739,13 @@ function Bn(e) {
 //#region src/functions/getMouseClientX.ts
 function Vn(e) {
 	var t, n;
-	return (e == null ? void 0 : e.clientX) || (e == null || (t = e.targetTouches) == null || (t = t[0]) == null ? void 0 : t.clientX) || (e == null || (n = e.touches) == null || (n = n[0]) == null ? void 0 : n.clientX) || 0;
+	return "clientX" in e ? e.clientX : (e == null || (t = e.targetTouches) == null || (t = t[0]) == null ? void 0 : t.clientX) || (e == null || (n = e.touches) == null || (n = n[0]) == null ? void 0 : n.clientX) || 0;
 }
 //#endregion
 //#region src/functions/getMouseClientY.ts
 function Hn(e) {
 	var t, n;
-	return (e == null ? void 0 : e.clientY) || (e == null || (t = e.targetTouches) == null || (t = t[0]) == null ? void 0 : t.clientY) || (e == null || (n = e.touches) == null || (n = n[0]) == null ? void 0 : n.clientY) || 0;
+	return "clientY" in e ? e.clientY : (e == null || (t = e.targetTouches) == null || (t = t[0]) == null ? void 0 : t.clientY) || (e == null || (n = e.touches) == null || (n = n[0]) == null ? void 0 : n.clientY) || 0;
 }
 //#endregion
 //#region src/functions/getMouseClient.ts

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@dxtmisha/functional-basic",
   "private": false,
-  "version": "1.8.7",
+  "version": "1.8.10",
   "type": "module",
   "description": "Foundational isomorphic utility library for modern web and SSR development — HTTP client, state storage, i18n localization, SEO metadata, DOM events, formatting, and data utilities. Framework-agnostic, TypeScript-first.",
   "keywords": [

package/ai-resources/prompts.json

@@ -1,8 +0,0 @@
-[
-  {
-    "path": "ai-resources/api-reference.md",
-    "md5": "5b6b7850a06fbe60c2ff108599c45dc3",
-    "name": "API Reference and Examples",
-    "description": "Provides code examples and usage patterns for the @dxtmisha/functional-basic library modules including HTTP client, storage, geolocation, and DOM helpers. It helps AI agents understand how to correctly integrate and utilize utility functions for frontend and backend tasks."
-  }
-]