@dxtmisha/functional 1.13.3 → 1.13.5

package/CHANGELOG.md

@@ -2,6 +2,26 @@
 
 All notable changes to this project will be documented in this file.
 
+## [1.13.5] - 2026-06-17
+
+### Changed / Improved
+- **GeoRef**: Refactored static getters (`getCountry`, `getLanguage`, `getStandard`, `getFirstDay`) to use request-isolated computed references via `ServerStorage.get`. This isolates their reactive state per request, resolving potential cross-request state pollution during SSR.
+
+## [1.13.4] - 2026-06-17
+
+### Added
+- **GeoRef**: Added static reactive `setValueDefault` method to configure the default country/language code.
+- **dxtFunctionalPlugin**: Extended `location` configuration option to accept `string | (() => string)` callbacks, registering the default fallback location dynamically during Vue application initialization.
+
+## [1.13.3] - 2026-06-16
+
+### Added
+- **GeoRef**: Added static reactive `setValueDefault` method to configure the default country/language code.
+- **dxtFunctionalPlugin**: Added `location?: string` plugin configuration parameter to set the default fallback location dynamically during Vue application initialization.
+
+### Changed / Improved
+- **Tests**: Configured test suites (`GeoRef.test.ts` and `dxtFunctionalPlugin.test.ts`) to cover fallback value detection and default settings.
+
 ## [1.13.2] - 2026-06-05
 
 ### Changed / Improved

package/ai-description.txt

@@ -1,10 +1,18 @@
-Core Purpose: This library is a comprehensive Vue 3 framework for reactive application architecture. It provides high-level abstractions for API orchestration (fetching, mutation, SSR, schema validation), state management (singletons, reactive storage, session/cookie handling), component design (base classes for rendering and lifecycle management), and localization/internationalization (geo-data, formatting, date management).
+This library is a collection of Vue 3-based utility classes and composables designed for building complex, reactive, and SSR-ready interfaces. It provides a standardized framework for API management, component state, geographic/localization data, and dynamic rendering.
 
-Usage Scenarios: Study this API when building complex, data-intensive Vue 3 applications requiring:
-1. Centralized, reactive API management (GET/POST/PUT/DELETE) with built-in SSR support, caching, and automatic response contract validation.
-2. Unified component architecture using base design classes for consistent styling, rendering, and lifecycle event management.
-3. Complex list handling, client-side searching, and advanced data formatting (Intl, currency, dates).
-4. Cross-tab communication or persistent reactive state storage (localStorage, sessionStorage, cookies).
-5. Global service configuration (meta tags, translation, icons, API settings) via Vue plugins.
+1. Core Purpose:
+An infrastructure-level toolkit for Vue 3 that abstracts asynchronous data fetching, state management, and UI rendering logic. It provides structured classes and composables to handle API lifecycle (GET/POST/PUT/DELETE), reactive data transformations, internationalization (Intl), and component orchestration.
 
-Integration Context: The library acts as a core infrastructure layer. It is built on top of Vue 3's Composition API and `vue-router`. It relies heavily on `@dxtmisha/functional-basic` for underlying logic. It should be treated as the primary service and utility layer that replaces manual store management (like Pinia) and repetitive API/lifecycle boilerplate by providing standardized patterns (e.g., `executeUse` for singletons) for shared state and service orchestration.
+2. Usage Scenarios:
+- API Orchestration: When building complex forms, data tables, or dashboards requiring integrated state, validation (via @effect/schema compatibility), and SSR support. Use `useApiManagementRef` for unified CRUD handling or `useApiRef` for individual requests.
+- Reactive Data Management: When you need synchronized data across browser tabs (`useBroadcastValueRef`) or persistence across reloads (`useStorageRef`, `useCookieRef`).
+- Localization & Formatting: When the application needs to dynamically handle geographic data, currency formatting, file sizes, or date manipulation via `GeoIntlRef` and `useGeoIntlRef`.
+- Component Design System: When building modular UI components that require consistent prop-to-style/class mapping (`DesignConstructorAbstract`, `DesignComponents`).
+- Lifecycle & DOM Utilities: When implementing lazy loading (`useLazyRef`) or global state management using `executeUse` for singletons.
+
+3. Integration Context:
+- Vue 3 Core: Heavily leverages `Ref`, `ComputedRef`, and `provide/inject`.
+- Data Fetching: Acts as a high-level wrapper over an underlying `functional-basic` library.
+- Routing: Integrates with `vue-router` via `RouterItemRef` and `useRouterList`.
+- SSR: Provides specific `Async` variants (e.g., `useApiAsyncRef`) for server-side pre-fetching.
+- Schema Validation: Designed to work with `@effect/schema` for robust API contract validation.