@dxtmisha/functional 1.15.9 → 1.15.12

package/CHANGELOG.md

@@ -2,6 +2,21 @@
 
 All notable changes to this project will be documented in this file.
 
+## [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,14 @@
-# @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.
-
+This package is a comprehensive Vue-based utility library designed to simplify state management, reactive routing, internationalization, and API communication. Developers should study this package to leverage its pre-built reactive wrappers, robust component constructors, and seamless API integration tools for modern frontend applications.
+
+Key Capabilities:
+- API Integration
+- Reactive Storage
+- Internationalization Formatting
+- Component Management
+- Route Navigation
 ## 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 usage patterns and guidelines for REST API management and scope-isolated singleton factories within the @dxtmisha/functional library. It provides technical instructions for initializing global, local, and provided singletons alongside reactive CRUD operations.
+- 'node_modules/@dxtmisha/functional/ai-resources/localization-seo.md': Provides utilities for locale-aware formatting, translation primitives, geographic context resolution, and reactive HTML document metadata handling. Solves internationalization and SEO management tasks in web applications using functional components.
+- 'node_modules/@dxtmisha/functional/ai-resources/reactivity-lists.md': This file provides advanced async reactivity composables, list data models, search filters, and DOM observers for managing application state and UI lifecycle. It solves technical tasks related to asynchronous computed properties, optimized multi-field searching, and safe event listener management in frontend codebases.
+- 'node_modules/@dxtmisha/functional/ai-resources/storage-state.md': Provides composable Vue-like reactive wrappers for persistent and synchronized browser state management, including localStorage, sessionStorage, cookies, broadcast channels, and URL hash fragments. Solves technical tasks related to cross-tab communication, SSR-safe cookie handling, and state persistence for web applications.

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 Scope Singletons (@dxtmisha/functional)",
     "mimeType": "text/markdown",
-    "description": "Reactive singleton scope initialization and REST API management patterns."
+    "description": "Defines usage patterns and guidelines for REST API management and scope-isolated singleton factories within the @dxtmisha/functional library. It provides technical instructions for initializing global, local, and provided singletons alongside reactive CRUD operations."
   },
   {
     "uri": "@dxtmisha/functional/ai-resources/localization-seo.md",
-    "name": "Localization Rules (@dxtmisha/functional)",
+    "name": "Localization and SEO Utilities (@dxtmisha/functional)",
     "mimeType": "text/markdown",
-    "description": "Geographic context, locale-aware formatting, reactive translations, and document metadata."
+    "description": "Provides utilities for locale-aware formatting, translation primitives, geographic context resolution, and reactive HTML document metadata handling. Solves internationalization and SEO management tasks in web applications using functional components."
   },
   {
     "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": "This file provides advanced async reactivity composables, list data models, search filters, and DOM observers for managing application state and UI lifecycle. It solves technical tasks related to asynchronous computed properties, optimized multi-field searching, and safe event listener management in frontend codebases."
   },
   {
     "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 reactive wrappers for persistent and synchronized browser state management, including localStorage, sessionStorage, cookies, broadcast channels, and URL hash fragments. Solves technical tasks related to cross-tab communication, SSR-safe cookie handling, and state persistence for web applications."
   }
 ]

package/ai-resources/prompts.json

@@ -0,0 +1,26 @@
+[
+  {
+    "path": "ai-resources/api-reference.md",
+    "md5": "4b38e33b9fd417537df8bf76c492d263",
+    "name": "API Management and Scope Singletons",
+    "description": "Defines usage patterns and guidelines for REST API management and scope-isolated singleton factories within the @dxtmisha/functional library. It provides technical instructions for initializing global, local, and provided singletons alongside reactive CRUD operations."
+  },
+  {
+    "path": "ai-resources/localization-seo.md",
+    "md5": "99983d3a7683e94f3e62b67851b8244d",
+    "name": "Localization and SEO Utilities",
+    "description": "Provides utilities for locale-aware formatting, translation primitives, geographic context resolution, and reactive HTML document metadata handling. Solves internationalization and SEO management tasks in web applications using functional components."
+  },
+  {
+    "path": "ai-resources/reactivity-lists.md",
+    "md5": "6e8b7100e59f0ffd08416bed080802db",
+    "name": "Reactivity Helpers and DOM Utilities",
+    "description": "This file provides advanced async reactivity composables, list data models, search filters, and DOM observers for managing application state and UI lifecycle. It solves technical tasks related to asynchronous computed properties, optimized multi-field searching, and safe event listener management in frontend codebases."
+  },
+  {
+    "path": "ai-resources/storage-state.md",
+    "md5": "7c6142dc8dc5172b2cbf5fca08b2b2d5",
+    "name": "Reactive Storage Composables",
+    "description": "Provides composable Vue-like reactive wrappers for persistent and synchronized browser state management, including localStorage, sessionStorage, cookies, broadcast channels, and URL hash fragments. Solves technical tasks related to cross-tab communication, SSR-safe cookie handling, and state persistence for web applications."
+  }
+]