@dxtmisha/functional 1.15.9 → 1.15.13

package/CHANGELOG.md

@@ -2,6 +2,31 @@
 
 All notable changes to this project will be documented in this file.
 
+## [1.15.13] - 2026-08-20
+
+### Added
+- **LLM Configuration (`llms.txt`)**: Added `llms.txt` indexing package capabilities, core composables (`executeUse`, `useApiRef`, `useStorageRef`, `useGeoIntlRef`), and AI resource documentation links.
+
+### Changed
+- **AI Resource Metadata & Types**:
+  - Migrated prompt resource cache from monolithic `prompts.json` to individual resource descriptor files in `ai-types-list/resources/`.
+  - Regenerated AI type definitions and package descriptions with updated AI prompt formats.
+
+## [1.15.12] - 2026-08-13
+
+### Changed
+- **Scripts**: Updated `prepublishOnly` script in `package.json` to execute `dxt-types-save` (`npm run library && npm run build && dxt-types-save`).
+
+## [1.15.11] - 2026-08-13
+
+### Changed
+- **AI Documentation & Types**: Updated `types` script in `package.json` to build the library before running `dxt-types`, added `ai-types.md` to `.gitignore`, and regenerated modular `ai-types-list/` type declaration files.
+
+## [1.15.10] - 2026-08-11
+
+### Changed
+- **AI Documentation**: Added architectural directive in `ai-doc.md` requiring complex business logic with potential for reuse to be extracted into external service composables wrapped with `executeUse*` (`executeUseGlobal`, `executeUseLocal`, or `executeUseProvide`).
+
 ## [1.15.8] - 2026-08-05
 
 ### Changed

package/ai-description.md

@@ -1,24 +1,11 @@
-# @dxtmisha/functional Reference
+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.
 
-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.
+To study ai-types.md, focus on reactive API request wrappers, component constructor definitions, and internationalization utilities for type-safe state synchronization.
 
+Key Capabilities: API Integration, Reactive Storage, Internationalization Support, Component Design, List Management
 ## 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/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
+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.

package/ai-doc.md

@@ -6,3 +6,4 @@ Vue 3 reactive utilities built on `@dxtmisha/functional-basic`. See `ai-types.md
 - **Priority**: Always use `@dxtmisha/functional` reactive composables instead of low-level `@dxtmisha/functional-basic` primitives in Vue 3 applications.
 - **API & State Singletons**: **NEVER** call `useApi*` / `executeUse*` hooks directly in Vue components (`<script setup>`). Wrap them in `executeUseGlobal` (startup), `executeUseLocal` (lazy, session scope), or `executeUseProvide` (scoped tree) inside external service files. Components only import and call the resulting hook.
 - **Purity & Atomicity**: Keep Vue components minimal. Extract all reactive state management, network orchestration, and side effects into external composables.
+- **Reusable Business Logic (`executeUse*`)**: Any complex business logic or state logic with any potential for reuse MUST be extracted into external service composables wrapped with `executeUse*` (`executeUseGlobal`, `executeUseLocal`, or `executeUseProvide`).

package/ai-mcp-resources.json

@@ -3,36 +3,36 @@
     "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."
+    "description": "TypeScript type definitions and signatures for AI coding assistant."
   },
   {
     "uri": "@dxtmisha/functional/ai-description.md",
-    "name": "Package Overview & Rules (@dxtmisha/functional)",
+    "name": "Project Overview (@dxtmisha/functional)",
     "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/ai-resources/api-reference.md",
-    "name": "API Rules (@dxtmisha/functional)",
+    "name": "API Management and Reactive Singletons (@dxtmisha/functional)",
     "mimeType": "text/markdown",
-    "description": "Reactive singleton scope initialization and REST API management patterns."
+    "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."
   },
   {
     "uri": "@dxtmisha/functional/ai-resources/localization-seo.md",
-    "name": "Localization Rules (@dxtmisha/functional)",
+    "name": "Localization and SEO Management (@dxtmisha/functional)",
     "mimeType": "text/markdown",
-    "description": "Geographic context, locale-aware formatting, reactive translations, and document metadata."
+    "description": "Utilities for locale-aware formatting, multi-key translations, and reactive HTML document metadata handling. Solves internationalization and SEO requirements in frontend applications."
   },
   {
     "uri": "@dxtmisha/functional/ai-resources/reactivity-lists.md",
-    "name": "Lists Rules (@dxtmisha/functional)",
+    "name": "Reactivity Helpers and DOM Utilities (@dxtmisha/functional)",
     "mimeType": "text/markdown",
-    "description": "Async reactivity composables, reactive list models, search filtering, and DOM observer utilities."
+    "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."
   },
   {
     "uri": "@dxtmisha/functional/ai-resources/storage-state.md",
-    "name": "Storage Rules (@dxtmisha/functional)",
+    "name": "Reactive Storage Composables (@dxtmisha/functional)",
     "mimeType": "text/markdown",
-    "description": "Reactive composables for browser storage, cookies, cross-tab synchronization, and URL hash state."
+    "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."
   }
 ]