@dxtmisha/functional-basic 1.1.0 → 1.1.6

package/CHANGELOG.md

@@ -0,0 +1,81 @@
+# Changelog
+
+All notable changes to this project will be documented in this file.
+
+## [1.1.6] - 2026-05-08
+
+### Added
+- **ApiResponse**: Added `emulatorAsync()` method for synchronous response emulation.
+- **Meta**: Added `setSuffix()` and `getSuffix()` for managing page title suffixes.
+- **Meta**: Added `htmlTitle()` for generating HTML-safe title strings.
+
+### Changed / Improved
+- **Api**: Refactored `ApiInstance` and `makeQuery` for more explicit base path handling (`pathToApi`).
+- **Api**: Improved SSR hydration stability and internal emulation logic.
+- **MetaManager**: Optimized `set()` method to avoid redundant updates when content is identical.
+- **getElementId**: Simplified ID generation logic by removing the `id-server-` prefix from server-side IDs.
+- **Documentation**: Completed a massive bilingual (EN/RU) JSDoc overhaul for all functions and classes.
+- **Tests**: Added unit tests for `ApiResponse.emulatorAsync` and improved general test coverage.
+
+## [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 @@
+This library is a high-level infrastructure and utility toolkit designed for isomorphic TypeScript applications. Its primary function is to provide structured abstractions for networking, state persistence, internationalization, and localized data formatting. The networking layer features an advanced Fetch API wrapper (Api, ApiInstance) with built-in support for singleton or isolated instances, automated retries with jitter, request/response interceptors, global status management, and SSR-to-client hydration (ApiHydration). Storage utilities encompass request-isolated ServerStorage for SSR, prefix-supported Local/Session storage (DataStorage), reactive URL Hash management (Hash), and standardized Cookie handling. The internationalization suite includes wrappers for the Intl API (GeoIntl) to handle complex formatting for currencies, dates, and plurals, alongside country-specific logic for phone masks (GeoPhone) and flag identification (GeoFlag). It also contains a specialized translation engine (Translate) supporting batch asynchronous loading and fallback mechanisms. Additionally, it provides advanced UI logic utilities like SearchList for regex-based filtering with text highlighting and EventItem for managed DOM event lifecycles. An AI should study this library when implementing robust API clients, managing cross-platform storage, handling multi-locale UI components, or developing isomorphic applications requiring data consistency between server and client. It integrates directly with standard web APIs (Fetch, Intl, BroadcastChannel, ResizeObserver) and provides a centralized error reporting system (ErrorCenter) and global loading state (Loading).