@dxtmisha/functional 1.15.7 → 1.15.9

package/CHANGELOG.md

@@ -2,6 +2,13 @@
 
 All notable changes to this project will be documented in this file.
 
+## [1.15.8] - 2026-08-05
+
+### Changed
+- **ListRecord**: Refactored `ListRecord<Item extends ListDataBasic>` type definition to `Item[] | Record<string, Item>` for enhanced flexibility with custom item objects and record structures.
+- **package.json**: Expanded package `files` distribution list to include `ai-prompts` and `ai-mcp.json` context definitions.
+- **AI Documentation**: Updated JSDoc prompt rules, added MCP resource definitions (`ai-mcp.json`), and updated package metadata (`ai-description.md`, `ai-types.md`).
+
 ## [1.15.7] - 2026-08-05
 
 ### Changed

package/ai-description.md

@@ -1,7 +1,24 @@
-This library is a reactive utility and component architecture framework for Vue 3 that standardizes design system component construction, locale-aware data formatting, browser storage state, and API request lifecycle orchestration. It provides abstract component models for computing styles, classes, slots, and properties, alongside wrappers for reactive state synchronization and dynamic component rendering. Design System Architecture components abstractly encapsulate Vue component structures, automating class and style generation, property change detection, slot bindings, and dynamic component rendering. API and Network Management modules manage asynchronous HTTP request lifecycles, server-side prefetching, CRUD mutations, response contract validation, error handling, and unified client-side search or formatting pipelines. Localization and Formatting utilities deliver reactive interfaces for internationalized formatting of dates, currencies, numbers, measurement units, country flag metadata, and dynamic translation lists. Storage and State controls wrap browser local storage, session storage, cookies, broadcast channels, and URL query or hash parameters into reactive references. List and Search utilities provide reactive controllers for hierarchical list filtering, multi-item selection tracking, focus navigation, and debounced text searches. DOM and Lifecycle controls manage intersection observers for lazy loading, document head metadata, scrollbar dimensions, global loading state tracking, and reactive event listeners. Injection and Singleton utilities support managed lifecycle topologies across application, component-subtree, or closure scopes. Studying ai-types.md is mandatory when implementing custom component constructors extending base design abstract classes, defining request or response validation contracts, configuring complex API management options, typing list data inputs and selection states, setting up functional plugin options, or establishing singleton execution topologies. The library integrates directly with Vue 3 reactivity and SSR runtime paradigms, Vue Router navigation mechanisms, and core functional utility packages.
+# @dxtmisha/functional Reference
+
+A reactive utility and component architecture library for Vue 3 providing high-level abstract base classes, state management composables, and localized formatting helpers.
+
+## Key Capabilities & Groupings
+- **API & Network**: Reactive composables for asynchronous HTTP requests, mutation workflows, SSR prefetching, response contract validation, error mappings, and list orchestration.
+- **Storage & State**: Persistent storage composables synchronizing state with cookies, web storage, URL query/hash parameters, and cross-tab messaging.
+- **Localization & Formatting**: Utilities for reactive handling of dates, numbers, currency, unit conversions, country flags, and dynamic translations.
+- **List & Search**: Helpers for managing reactive data filtering, selection state, text highlighting, debouncing, and router-bound navigation lists.
+- **DOM & System**: DOM visibility tracking, reactive page metadata management, global loading states, scrollbar measurements, and singleton dependency injection.
+- **Design Components**: Abstract base classes for standardized component rendering, dynamic class/style computation, prop tracking, and element exposure.
+
+## Triggers for Studying `ai-types.md`
+Study `ai-types.md` when implementing abstract component constructors, defining API validation contracts or error schemas, typing complex list structures and search options, configuring singleton execution scopes, or managing reactive Vue prop and subcomponent bindings.
+
+## Integration Context
+This library integrates natively into Vue 3 and Vue Router applications through a unified global plugin that configures shared API, routing, localization, and metadata services.
+
 ## Mandatory Rules
-Read the corresponding file if your task relates to:
-- 'node_modules/@dxtmisha/functional/ai-prompts/api-reference.md': Scope factory initialization, reactive singletons, and REST API management patterns
-- 'node_modules/@dxtmisha/functional/ai-prompts/localization-seo.md': Geographic context, internationalization formatting, translation utilities, HTML metadata management, and scrollbar measurement
-- 'node_modules/@dxtmisha/functional/ai-prompts/reactivity-lists.md': Async reactivity helpers, list management, search filtering, and DOM event observers
-- 'node_modules/@dxtmisha/functional/ai-prompts/storage-state.md': Reactive composables for persistent browser storage, cookies, broadcast messaging, and URL hashes
+Read the corresponding file ONLY when working on a task related to (even if not working directly with this package):
+- 'node_modules/@dxtmisha/functional/ai-resources/api-reference.md': Reactive singleton scope initialization and REST API management patterns
+- 'node_modules/@dxtmisha/functional/ai-resources/localization-seo.md': Geographic context, locale-aware formatting, reactive translations, document metadata, and scrollbar width measurement
+- 'node_modules/@dxtmisha/functional/ai-resources/reactivity-lists.md': Async reactivity composables, reactive list models, search filtering, and DOM observer utilities
+- 'node_modules/@dxtmisha/functional/ai-resources/storage-state.md': Reactive composables for browser storage, cookies, cross-tab synchronization, and URL hash state

package/ai-mcp-resources.json

@@ -0,0 +1,38 @@
+[
+  {
+    "uri": "@dxtmisha/functional/ai-types.md",
+    "name": "Type Definitions (@dxtmisha/functional)",
+    "mimeType": "text/markdown",
+    "description": "Compressed and AI-optimized TypeScript declaration contracts for functional Vue 3 utilities and base components."
+  },
+  {
+    "uri": "@dxtmisha/functional/ai-description.md",
+    "name": "Package Overview & Rules (@dxtmisha/functional)",
+    "mimeType": "text/markdown",
+    "description": "High-density project overview, key capabilities, and prompt trigger guidelines."
+  },
+  {
+    "uri": "@dxtmisha/functional/ai-resources/api-reference.md",
+    "name": "API Rules (@dxtmisha/functional)",
+    "mimeType": "text/markdown",
+    "description": "Reactive singleton scope initialization and REST API management patterns."
+  },
+  {
+    "uri": "@dxtmisha/functional/ai-resources/localization-seo.md",
+    "name": "Localization Rules (@dxtmisha/functional)",
+    "mimeType": "text/markdown",
+    "description": "Geographic context, locale-aware formatting, reactive translations, and document metadata."
+  },
+  {
+    "uri": "@dxtmisha/functional/ai-resources/reactivity-lists.md",
+    "name": "Lists Rules (@dxtmisha/functional)",
+    "mimeType": "text/markdown",
+    "description": "Async reactivity composables, reactive list models, search filtering, and DOM observer utilities."
+  },
+  {
+    "uri": "@dxtmisha/functional/ai-resources/storage-state.md",
+    "name": "Storage Rules (@dxtmisha/functional)",
+    "mimeType": "text/markdown",
+    "description": "Reactive composables for browser storage, cookies, cross-tab synchronization, and URL hash state."
+  }
+]