@dxtmisha/functional 1.15.8 → 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,7 +1,14 @@
-A reactive utility and component architecture library for Vue 3 providing high-level abstract base classes, state management composables, and localized formatting helpers. It standardizes reactive API orchestration, browser storage binding, DOM visibility tracking, internationalization, and design component construction across client and server-rendered environments. Key capabilities are grouped into API and network composables for managing asynchronous HTTP requests, mutation workflows, SSR prefetching, response contract validation, error mappings, and list orchestration; design component base classes for standardized component rendering, dynamic class and style computation, prop change tracking, slot management, and element exposure; localization and formatting utilities for reactive handling of dates, numbers, currency, unit conversions, country flags, dynamic translations, and language-dependent computed properties; persistent storage composables synchronizing state with cookies, web storage, URL query or hash parameters, and cross-tab messaging; list and search helpers for managing reactive data filtering, selection state, text highlighting, debouncing, and router-bound navigation lists; and DOM system utilities for IntersectionObserver lazy visibility tracking, reactive page metadata management, global loading states, scrollbar measurements, and singleton dependency injection. 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. 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-prompts/api-reference.md': Reactive singleton scope initialization and REST API management patterns
-- 'node_modules/@dxtmisha/functional/ai-prompts/localization-seo.md': Geographic context, locale-aware formatting, reactive translations, document metadata, and scrollbar width measurement
-- 'node_modules/@dxtmisha/functional/ai-prompts/reactivity-lists.md': Async reactivity composables, reactive list models, search filtering, and DOM observer utilities
-- 'node_modules/@dxtmisha/functional/ai-prompts/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

@@ -0,0 +1,38 @@
+[
+  {
+    "uri": "@dxtmisha/functional/ai-types.md",
+    "name": "Type Definitions (@dxtmisha/functional)",
+    "mimeType": "text/markdown",
+    "description": "TypeScript type definitions and signatures for AI coding assistant."
+  },
+  {
+    "uri": "@dxtmisha/functional/ai-description.md",
+    "name": "Project Overview (@dxtmisha/functional)",
+    "mimeType": "text/markdown",
+    "description": "Project overview, usage guidelines, and mandatory prompt rules for AI coding assistant."
+  },
+  {
+    "uri": "@dxtmisha/functional/ai-resources/api-reference.md",
+    "name": "API Management and Scope Singletons (@dxtmisha/functional)",
+    "mimeType": "text/markdown",
+    "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 and SEO Utilities (@dxtmisha/functional)",
+    "mimeType": "text/markdown",
+    "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": "Reactivity Helpers and DOM Utilities (@dxtmisha/functional)",
+    "mimeType": "text/markdown",
+    "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": "Reactive Storage Composables (@dxtmisha/functional)",
+    "mimeType": "text/markdown",
+    "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."
+  }
+]