@dxtmisha/functional 1.11.1 → 1.11.7

package/CHANGELOG.md

@@ -0,0 +1,79 @@
+# Changelog
+
+All notable changes to this project will be documented in this file.
+
+## [1.11.6] - 2026-05-01
+
+### Added
+- **useApiAsyncRef**: Introduced `useApiAsyncRef` for asynchronous API initialization within Vue async setup components.
+- **useApiRef**: Added support for synchronous cache recovery via `recovery()`.
+- **useApiRef**: Added support for server prefetching via `initSsr()` and Vue's `onServerPrefetch`.
+- **getInject**: Moved utility to `@dxtmisha/functional` for wider availability and easier dependency injection.
+
+### Changed / Improved
+- **useApiRef**: Enhanced with response contract validation and improved initialization logic.
+- **useApiRef**: Optimized internals with new helpers like `isConditions` and `getApiFetch`.
+- **SSR & Hydration**: Improved hydration stability by ensuring API data is available immediately upon client mount, preventing flickering and mismatches.
+
+## [1.1.5] - 2026-04-26
+
+### Added
+- **Api**: Added `setOrigin()` and `getOrigin()` methods for managing the protocol and domain of the base URL.
+- **Api**: Added `setConfig()` method for bulk configuration of API settings.
+- **Api**: Added support for `endResetLimit` in `ApiFetch` to control recursive retries via `setEnd`.
+- **Api**: Added support for jittered retry delays to prevent request thundering herds.
+- **ServerStorage**: Added `remove()` method for deleting items from storage.
+- **ServerStorage**: Added `setErrorStatus()` method to toggle visibility of context-missing errors.
+
+## [1.1.4] - 2026-04-25
+
+### Added
+- **Meta**: Added `htmlTitle()` method to `Meta`, `MetaStatic`, and `MetaManager` classes for generating HTML-safe title strings.
+
+### Changed / Improved
+- **MetaManager**: The `toHtml()` method now excludes the `<title>` tag, allowing for more flexible title management via `htmlTitle()`.
+- **Package**: Added `CHANGELOG.md` to the list of files included in the package distribution.
+
+## [1.1.3] - 2026-04-24
+
+### Added
+- **ResumableTimer**: Added a new class for managing timers with pause and resume functionality.
+- **ApiDataReturn**: Implemented a class for standardizing API responses with support for descriptions and texts.
+- **MetaStatic**: Added a class for managing static meta-data.
+- **Datetime**: Added functionality for working with dates and times.
+- **Translate**: Implemented a localization and translation system.
+- **GeoInstance**: Added an instance for advanced geolocation data handling.
+- **ApiHydration**: Added support for API data hydration for SSR.
+- **StorageCallback**: Added a callback mechanism for tracking storage changes.
+- **New Functions**:
+  - `getCurrentTime` — returns the current time.
+  - `getArrayHighlightMatch` — searches for and highlights matches in arrays.
+
+### Changed / Improved
+- **Refactoring**: Major refactoring of the `functional-basic` package to improve architecture.
+- **SSR**: Adapted the API and related modules for full Server-Side Rendering support.
+- **API**:
+  - Improved the core `Api` class.
+  - Refined `ApiCache` and caching systems.
+- **Cookie**:
+  - Completely redesigned the Cookie handling mechanics, including `CookieBlock` and `CookieStorage`.
+  - Added `getListenerRaw` support to `CookieStorage.init()` for initializing from raw cookie strings (essential for SSR).
+  - Extracted cookie parsing and formatting logic into protected `parse()` and `format()` methods.
+  - Expanded `CookieOptions` to support modern attributes: `path`, `domain`, `secure`, `httpOnly`, and `partitioned` (CHIPS).
+  - Updated `setListener` signature to include the fully formatted cookie string as a third parameter, facilitating easier SSR header management.
+- **Function Optimization**:
+  - `getSearchExp` and `getSeparatingSearchExp` — refined search mechanisms.
+  - `getRequestString` — improved query string generation.
+  - `addTagHighlightMatch` — optimized tag highlighting.
+  - `applyTemplate` — expanded template support.
+  - `forEach`, `frame`, `blobToBase64`, `getElementId` — technical improvements and optimization.
+
+### Fixed
+- **Testing**: Fixed and updated all unit tests (`vitest`) for stability and coverage.
+- **Geo**: Fixed logic errors in geolocation functions and their tests.
+- Fixed type definition errors and minor bugs in core functions.
+
+### Documentation
+- **JSDoc**: Completed a full revision and standardization of JSDoc comments for all classes and functions.
+- **ServerStorage**: Added detailed descriptions of methods and operating principles.
+- Updated `ApiDataReturn` documentation.

package/ai-description.txt

@@ -0,0 +1,5 @@
+A Vue 3-centric orchestration framework and utility library designed for reactive data management, API synchronization, and localized UI logic. Its primary function is providing high-level abstractions for network request life cycles, including integrated GET/mutation handling with skeleton support, and complex list state management covering focus, selection, and client-side filtering. It offers specialized reactive primitives such as asynchronous computed properties, demand-cached refs, and multi-strategy singleton management using Global, Local, and Provide/Inject patterns.
+
+An AI should study this API when implementing robust API-to-UI orchestration involving data transformation and contract validation, or when developing UI components that require standardized class/style resolution through the library’s abstract design classes. It is indispensable for scenarios requiring multi-tab state synchronization via broadcast channels, cookie-backed reactive variables, and SSR-compatible SEO meta-tag management. The library's i18n and localization modules are critical for handling country-specific formatting for currencies, units, relative time, and geographical metadata.
+
+The library is built upon the Vue 3 Composition API and @dxtmisha/functional-basic, integrating directly with Vue Router for navigation-aware data structures. It functions as a middleware layer between raw data sources and the presentation layer, requiring the dxtFunctionalPlugin for global service initialization including API clients, translation instances, and icon configurations.