@dxtmisha/functional-basic 1.8.6 → 1.8.7

package/CHANGELOG.md

@@ -2,6 +2,19 @@
 
 All notable changes to this project will be documented in this file.
 
+## [1.8.7] - 2026-08-12
+
+### Changed
+- **toNumber**: Refactored `toNumber` utility function to use primitive helper functions (`isFilled`, `isString`) for safer type coercion and input handling.
+- **AI Documentation & Types**: Standardized bilingual JSDoc/TSDoc comments across library classes, functions, and type definitions; updated `ai-types.md` and `ai-types-list/` generated declaration files.
+- **Scripts**: Updated `types` script in `package.json` to execute `library` and `build` before `dxt-types`.
+
+## [1.8.6] - 2026-08-10
+
+### Changed
+- **AI Resources**: Renamed `ai-prompts/` directory to `ai-resources/` and `ai-mcp.json` to `ai-mcp-resources.json` across package metadata and configuration.
+- **Package Metadata**: Updated `package.json` `files` list to include `ai-resources` and `ai-mcp-resources.json`.
+
 ## [1.8.5] - 2026-08-05
 
 ### Changed

package/ai-description.md

@@ -1,21 +1,13 @@
-# Package Overview & Rules (@dxtmisha/functional-basic)
-
-## Core Purpose
-This library provides an isomorphic suite of client- and server-side utilities designed for web application infrastructure, state management, internationalization, and network communication. It serves as a unified foundation for API lifecycle management, SSR hydration, browser storage, and data transformation across JavaScript runtimes.
-
-## Key Capabilities & Groupings
-- **API & Network**: Streamlines HTTP fetch requests with configurable defaults, automatic retries with jitter, response caching, error classification, and SSR client hydration script generation.
-- **Storage & State Management**: Supplies request-isolated SSR storage contexts, type-safe cookie management, synchronized URL query and hash state, local and session storage with age-based expiration, and cross-tab broadcast messaging.
-- **Localization & Geographic Tools**: Provides automated country and language detection, phone number mask matching, metric-to-imperial unit conversion, pluralization, currency formatting, and asynchronous multi-language translation resolution.
-- **Search & Data Handling**: Enables multi-column list searching, search match highlighting, fuzzy and exact regular expression matching, multi-field array sorting, and recursive object template replacement.
-- **UI, DOM, & Event Helpers**: Delivers DOM element manipulation, ResizeObserver and scroll-sync event listeners, global loading indicators, icon registration, resumable timers, and isomorphic HTML meta tag management for standard SEO, Open Graph, and Twitter Cards.
-
-## Triggers for Studying `ai-types.md`
-Studying type definitions in `ai-types.md` is mandatory when typing complex API request or response structures, configuring custom request wrappers, defining criteria for error storage items, specifying search column paths, setting up custom translation dictionaries, or implementing isolated server storage contexts during SSR.
-
-## Integration Context
-This package connects with modern web frameworks and SSR environments by wrapping standard Web APIs, fetch interfaces, and DOM listeners with environment-agnostic abstractions and automated client-side hydration hooks.
-
+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.
+
+API Integration
+State Management
+Caching
+Internationalization
+Localization
+URL Routing
+Event Handling
+Meta Tags
 ## Mandatory Rules
-Read the corresponding file ONLY when working on a task related to (even if not working directly with this package):
-- 'node_modules/@dxtmisha/functional-basic/ai-resources/api-reference.md': HTTP client caching, storage management, geolocation localization, and DOM utility helpers
+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.

package/ai-mcp-resources.json

@@ -3,18 +3,18 @@
     "uri": "@dxtmisha/functional-basic/ai-types.md",
     "name": "Type Definitions (@dxtmisha/functional-basic)",
     "mimeType": "text/markdown",
-    "description": "Compressed and AI-optimized TypeScript declaration contracts for core utilities."
+    "description": "TypeScript type definitions and signatures for AI coding assistant."
   },
   {
     "uri": "@dxtmisha/functional-basic/ai-description.md",
-    "name": "Package Overview & Rules (@dxtmisha/functional-basic)",
+    "name": "Project Overview (@dxtmisha/functional-basic)",
     "mimeType": "text/markdown",
-    "description": "High-density project overview, key capabilities, and prompt trigger guidelines."
+    "description": "Project overview, usage guidelines, and mandatory prompt rules for AI coding assistant."
   },
   {
     "uri": "@dxtmisha/functional-basic/ai-resources/api-reference.md",
-    "name": "API & Core Utilities (@dxtmisha/functional-basic)",
+    "name": "API Reference and Examples (@dxtmisha/functional-basic)",
     "mimeType": "text/markdown",
-    "description": "HTTP client caching, storage management, geolocation localization, and DOM utility helpers."
+    "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."
   }
 ]

package/ai-resources/prompts.json

@@ -0,0 +1,8 @@
+[
+  {
+    "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."
+  }
+]