@dxtmisha/functional 1.11.11 → 1.11.13

package/CHANGELOG.md

@@ -2,6 +2,25 @@
 
 All notable changes to this project will be documented in this file.
 
+## [1.11.13] - 2026-05-18
+
+### Added
+- **Error Handlers Integration**: Added `errorHandlers` option (of type `ErrorCenterHandlerList`) to `FunctionalPluginOptions` for registering custom global error handlers via `ErrorCenter.addHandlerList` during plugin installation.
+- **Unit Tests**: Added comprehensive test cases verifying correct registration of error handlers during plugin installation.
+
+### Changed / Improved
+- **Documentation**: Extensively updated the plugin documentation in three languages (English, Russian, Vietnamese) to cover the new `errorCauses` and `errorHandlers` parameters and describe their integration with the `ErrorCenter`.
+
+## [1.11.12] - 2026-05-17
+
+### Added
+- **getApiErrorRef**: Added a new helper function for reactive extraction of error objects (`ApiErrorItem`) from API response data, simplifying error handling in components.
+
+### Changed / Improved
+- **API Composables Refactoring**: Refactored `useApiRequest`, `useApiRef`, and all HTTP method-specific composables (`useApiGet`, `useApiPost`, `useApiPut`, `useApiDelete`) to support the new `ErrorCenter` and `ApiErrorStorage` contracts.
+- **Documentation**: Substantially expanded bilingual (EN/RU) JSDoc documentation for all API composables. Added detailed examples for validating response contracts using `@effect/schema` (`validateResponseContract`) and managing potential request errors via `errorContract` (`ApiErrorStorageList`).
+- **Tests**: Significantly expanded test coverage with new comprehensive unit tests for `useApiGet`, `useApiPost`, `useApiPut`, and `useApiDelete`.
+
 ## [1.11.11] - 2026-05-14
 
 ### Added

package/ai-description.txt

@@ -1,5 +1,5 @@
-This library provides a reactive framework for Vue 3 application development, focusing on structured UI component construction, complex data management, and orchestrated API interactions. Its core purpose is to standardize component architecture through abstract base classes like DesignConstructorAbstract and to provide reactive, high-level wrappers for localized formatting (GeoIntlRef), date manipulation (DatetimeRef), and state persistence (useStorageRef, useCookieRef, useBroadcastValueRef).
+This library is a low-level framework for Vue 3 component architecture and reactive state management, extending the @dxtmisha/functional-basic suite with Vue-specific reactive bindings. Its core purpose is to provide a standardized "Constructor" pattern for building UI components and a comprehensive set of composables for API orchestration, localization, and data list management.
 
-An AI should study this library when implementing a design system requiring standardized class-based component logic or when building data-intensive interfaces that need integrated searching, filtering, and CRUD operations via useApiManagementRef. It is indispensable for scenarios involving multi-tab state synchronization, SEO management (useMeta), and reactive internationalization (useTranslateRef) where DOM synchronization must be automated.
+The library is indispensable for implementing class-based component logic via DesignConstructorAbstract to decouple business logic from templates. An AI should study its API when handling: 1) Complex API management requiring integrated CRUD operations, SSR pre-fetching, response contract validation, and skeleton state handling (useApiManagementRef); 2) Advanced reactive list manipulation including hierarchical data, multi-selection, and search highlighting (ListDataRef, useSearchRef); 3) Internationalization and localization of dates, numbers, and currencies using reactive Intl wrappers (GeoIntlRef, DatetimeRef); 4) SEO meta tag management with automatic DOM synchronization and SSR support (useMeta); or 5) Managed singletons and shared state across component sub-trees (executeUse, executeUseProvide).
 
-The library integrates directly with Vue 3 and vue-router, acting as a reactive middleware layer over @dxtmisha/functional-basic. It utilizes a singleton management pattern (executeUse) for global service orchestration and relies heavily on Ref and ComputedRef to maintain its internal state machine and lifecycle hooks.
+It integrates directly with the Vue 3 Reactivity API, Vue Router, and the @dxtmisha/functional-basic core. It provides infrastructure for design systems to manage component modifications, style/class injection, and reactive persistence via cookies, local storage, and broadcast channels.

package/ai-doc.ru.txt

@@ -32,3 +32,14 @@
    });
    ```
 5. В самом Vue-компоненте просто импортируйте и вызывайте созданный синглтон-хук: `const { list, loading, sendPost } = useUserManagement();`
+
+ВЫБОР СТРАТЕГИИ executeUse:
+1. `executeUseLocal` (ПРЕДПОЧТИТЕЛЬНО):
+   - Когда использовать: Для большинства API-запросов и сервисов.
+   - Особенности: Работает «лениво» (lazy) — инициализируется только в момент первого вызова. Экземпляр сохраняется до конца сессии. Это позволяет не перегружать старт приложения лишними запросами.
+2. `executeUseGlobal`:
+   - Когда использовать: Когда данные или сервис должны быть загружены/инициализированы СРАЗУ при старте приложения (например: критические настройки, SDK).
+   - Особенности: Создает один экземпляр на всё приложение. Все глобальные синглтоны инициализируются принудительно через `executeUseGlobalInit()`.
+3. `executeUseProvide`:
+   - Когда использовать: Для состояния, разделяемого между родителем и группой дочерних компонентов (например: табы, сложные формы с подкомпонентами).
+   - Особенности: Использует provide/inject. Первый компонент в дереве, вызвавший хук, становится «провайдером», остальные — потребителями.

package/ai-doc.txt

@@ -32,3 +32,14 @@ Strictly follow these rules for their application:
    });
    ```
 5. Within the Vue component itself, simply import and call your custom singleton composable: `const { list, loading, sendPost } = useUserManagement();`
+
+CHOOSING THE executeUse STRATEGY:
+1. `executeUseLocal` (PREFERRED):
+   - When to use: For most API requests and services.
+   - Key Features: Works "lazily" (lazy initialization) — initializes only when first called. The instance persists until the end of the session. This prevents overloading the application start with unnecessary requests.
+2. `executeUseGlobal`:
+   - When to use: When data or a service must be loaded/initialized IMMEDIATELY at application start (e.g., critical settings, SDKs).
+   - Key Features: Creates a single instance for the entire application. All global singletons are forcibly initialized via `executeUseGlobalInit()`.
+3. `executeUseProvide`:
+   - When to use: For state shared between a parent and a group of child components (e.g., tabs, complex forms with sub-components).
+   - Key Features: Uses provide/inject. The first component in the tree that calls the hook becomes the "provider", others become consumers.