@dxtmisha/functional 1.15.13 → 1.15.15

package/CHANGELOG.md

@@ -2,6 +2,14 @@
 
 All notable changes to this project will be documented in this file.
 
+## [1.15.14] - 2026-08-22
+
+### Added
+- **DesignConstructorAbstract**: Added `getKeyClass(name)` method to retrieve `{ key, class }` binding object for component sub-elements based on element class/key name.
+- **ConstrBind**: Added default generic parameter `T = ConstrItem` to `ConstrBind<T = ConstrItem>` type definition.
+- **Exports & Distribution**: Added `ai-screenshot` to package `files` and configured explicit export mappings for `./ai-types.md`, `./ai-description.md`, `./ai-resources/*`, and `./ai-screenshot/*` in `package.json`.
+- **Documentation**: Migrated package documentation to `src/storybook/` with comprehensive guides across English, Russian, and Vietnamese.
+
 ## [1.15.13] - 2026-08-20
 
 ### Added

package/ai-description.md

@@ -1,11 +1,11 @@
-This package provides a comprehensive collection of Vue composables, reactive utilities, and design component constructors tailored for enterprise application architecture, state management, and API integration.
+@dxtmisha/functional is a Vue 3 reactive framework extension providing component design constructors, advanced reactive primitives, and state management composables. It delivers unified solutions for reactive API orchestration, SSR prefetching, internationalization, storage/URL synchronization, and viewport observation.
 
-To study ai-types.md, focus on reactive API request wrappers, component constructor definitions, and internationalization utilities for type-safe state synchronization.
+Study ai-types.md when implementing or typing Vue components with OOP design constructors, orchestrating reactive API requests and mutations with SSR support or contract validation, synchronizing state across browser storage, cookies, broadcast channels, or URL parameters, managing scoped singleton state, formatting localized dates, units, and geographic metadata reactively, implementing search and list data pipelines, observing element visibility, or managing SEO head metadata and global plugins.
 
-Key Capabilities: API Integration, Reactive Storage, Internationalization Support, Component Design, List Management
+Key Capabilities: Component Design Constructors, Reactive API Management, SSR Prefetching, Storage Synchronization, Cross-Tab Messaging, URL State Synchronization, Internationalization Formatting, Geographic Unit Conversion, Datetime Localization, List Data Management, Debounced Search, Viewport Lazy Loading, Reactive SEO Management, Singleton State Management, DOM Event Binding, Async Computed Reactivity
 ## 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/ai-resources/api-reference.md': Defines guidance and usage patterns for REST API management and scope-isolated singleton factories within the library. It solves the technical task of configuring reactive CRUD operations, caching, and lifecycle scopes like global, local, and provided singletons.
-- 'node_modules/@dxtmisha/functional/ai-resources/localization-seo.md': Utilities for locale-aware formatting, multi-key translations, and reactive HTML document metadata handling. Solves internationalization and SEO requirements in frontend applications.
-- 'node_modules/@dxtmisha/functional/ai-resources/reactivity-lists.md': Provides advanced async reactivity composables, reactive list data models, debounced search filters, and DOM observer utilities. This file solves complex state management and performance optimization tasks in frontend applications using functional helpers.
-- 'node_modules/@dxtmisha/functional/ai-resources/storage-state.md': Provides composable Vue-like functions for managing persistent and synchronized browser state across localStorage, sessionStorage, cookies, BroadcastChannel, and URL hash fragments. Solves technical tasks related to cross-tab communication, SSR-safe cookie handling, and reactive storage binding.
+- 'node_modules/@dxtmisha/functional/ai-resources/api-reference.md': Defines guidance and usage patterns for scope-isolated reactive singleton factories and REST API management in @dxtmisha/functional. Details scope initialization functions (executeUseGlobal, executeUseLocal, executeUseProvide) and reactive CRUD operations via useApiManagementRef.
+- 'node_modules/@dxtmisha/functional/ai-resources/localization-seo.md': Provides reactive utility tools for internationalization, geographic context detection, multi-key translations, and dynamic HTML document metadata/SEO tag management. It standardizes locale-aware formatting for numbers, dates, and currencies across the application. Solves technical requirements for global localization and search engine optimization.
+- 'node_modules/@dxtmisha/functional/ai-resources/reactivity-lists.md': Provides composables and utility classes for asynchronous reactivity, reactive list state management, and debounced multi-field search. Includes helpers for managed DOM event listeners and IntersectionObserver-based lazy loading. Solves advanced state synchronization and efficient DOM handling in reactive applications.
+- 'node_modules/@dxtmisha/functional/ai-resources/storage-state.md': Contains composable utilities for managing persistent and synchronized browser state across storage mediums and tabs. Includes reactive wrappers for localStorage, sessionStorage, cookies, BroadcastChannel, and URL hash fragments. Solves client-side state persistence, SSR safety, and cross-tab communication requirements.

package/ai-mcp-resources.json

@@ -13,26 +13,26 @@
   },
   {
     "uri": "@dxtmisha/functional/ai-resources/api-reference.md",
-    "name": "API Management and Reactive Singletons (@dxtmisha/functional)",
+    "name": "API Management & Reactive Singletons (@dxtmisha/functional)",
     "mimeType": "text/markdown",
-    "description": "Defines guidance and usage patterns for REST API management and scope-isolated singleton factories within the library. It solves the technical task of configuring reactive CRUD operations, caching, and lifecycle scopes like global, local, and provided singletons."
+    "description": "Defines guidance and usage patterns for scope-isolated reactive singleton factories and REST API management in @dxtmisha/functional. Details scope initialization functions (executeUseGlobal, executeUseLocal, executeUseProvide) and reactive CRUD operations via useApiManagementRef."
   },
   {
     "uri": "@dxtmisha/functional/ai-resources/localization-seo.md",
-    "name": "Localization and SEO Management (@dxtmisha/functional)",
+    "name": "Localization, Geo & SEO Management (@dxtmisha/functional)",
     "mimeType": "text/markdown",
-    "description": "Utilities for locale-aware formatting, multi-key translations, and reactive HTML document metadata handling. Solves internationalization and SEO requirements in frontend applications."
+    "description": "Provides reactive utility tools for internationalization, geographic context detection, multi-key translations, and dynamic HTML document metadata/SEO tag management. It standardizes locale-aware formatting for numbers, dates, and currencies across the application. Solves technical requirements for global localization and search engine optimization."
   },
   {
     "uri": "@dxtmisha/functional/ai-resources/reactivity-lists.md",
-    "name": "Reactivity Helpers and DOM Utilities (@dxtmisha/functional)",
+    "name": "Reactivity and DOM Utilities (@dxtmisha/functional)",
     "mimeType": "text/markdown",
-    "description": "Provides advanced async reactivity composables, reactive list data models, debounced search filters, and DOM observer utilities. This file solves complex state management and performance optimization tasks in frontend applications using functional helpers."
+    "description": "Provides composables and utility classes for asynchronous reactivity, reactive list state management, and debounced multi-field search. Includes helpers for managed DOM event listeners and IntersectionObserver-based lazy loading. Solves advanced state synchronization and efficient DOM handling in reactive applications."
   },
   {
     "uri": "@dxtmisha/functional/ai-resources/storage-state.md",
-    "name": "Reactive Storage Composables (@dxtmisha/functional)",
+    "name": "Reactive Storage State Composables (@dxtmisha/functional)",
     "mimeType": "text/markdown",
-    "description": "Provides composable Vue-like functions for managing persistent and synchronized browser state across localStorage, sessionStorage, cookies, BroadcastChannel, and URL hash fragments. Solves technical tasks related to cross-tab communication, SSR-safe cookie handling, and reactive storage binding."
+    "description": "Contains composable utilities for managing persistent and synchronized browser state across storage mediums and tabs. Includes reactive wrappers for localStorage, sessionStorage, cookies, BroadcastChannel, and URL hash fragments. Solves client-side state persistence, SSR safety, and cross-tab communication requirements."
   }
 ]