@dxtmisha/functional-basic 1.3.7 → 1.3.9

package/CHANGELOG.md

@@ -2,6 +2,26 @@
 
 All notable changes to this project will be documented in this file.
 
+## [1.3.9] - 2026-06-17
+
+### Changed / Improved
+- **GeoInstance**: Extended `setValueDefault` to accept functional callbacks: `code?: string | (() => string)`. Dynamic resolution via `executeFunction` is performed when fallback to the default code occurs.
+- **Geo**: Updated static `setValueDefault` signature to accept a function parameter `string | (() => string)`.
+
+## [1.3.8] - 2026-06-16
+
+### Added
+- **UrlItem**: Introduced a new isomorphic utility class for parsing, inspecting, and modifying URLs. It provides read-only getters for standard URL parts (`href`, `protocol`, `pathname`, `hash`, etc.), a single `set()` method to update the URL value, and a static `getInstance()` method to retrieve a request-isolated instance from `ServerStorage`.
+- **Tests**: Created a comprehensive test suite `UrlItem.test.ts` to verify parsing fallbacks in SSR/DOM environments, property values, and `getInstance` request-isolation behavior.
+
+## [1.3.7] - 2026-06-16
+
+### Added
+- **Geo**: Added static `setValueDefault` method to configure the default country/language code.
+
+### Changed / Improved
+- **GeoInstance**: Updated `setValueDefault` to dynamically re-evaluate and update the active location, item, and language properties when a new default code is assigned.
+
 ## [1.3.6] - 2026-06-16
 
 ### Added

package/ai-description.txt

@@ -1,23 +1,18 @@
-This library is a comprehensive, SSR-compatible utility collection for TypeScript/JavaScript web applications, providing a standardized interface for common web development tasks. It functions as a modular framework rather than a single-purpose library, offering unified management for data persistence, HTTP requests, UI state, and localization.
+This library is a comprehensive, isomorphic utility toolkit for TypeScript applications, focusing on data management, HTTP communication, internationalization, and DOM manipulation. 
 
-Core components include:
-1. HTTP API Management: A centralized `ApiInstance` supporting request/response interception, auto-hydration for SSR, caching, and structured error handling via `ApiErrorStorage`.
-2. Storage & State: Wrappers for `localStorage`, `sessionStorage` (`DataStorage`), `cookies` (`CookieStorage`), and a global data registry.
-3. Localization: Extensive support for internationalization, including date/number/currency formatting (`GeoIntl`) and a translation system (`TranslateInstance`).
-4. DOM/Utility Tools: Event listeners (`EventItem`) with SSR safety, scrollbar width detection, responsive image/file processing, and type-safe utilities for arrays, objects, and strings.
-5. Meta Management: Structured handling of standard HTML, Open Graph, and Twitter meta tags.
+1. Core Purpose:
+The library acts as a centralized foundation for common application tasks. It provides a robust HTTP client (Fetch wrapper with built-in retries, caching, and hydration support), state management (localized storage, cookie handling, URL hash synchronization), internationalization (translation management, date/time/currency formatting), and DOM utility functions (event listeners, scroll management, meta tag management).
 
-The library is indispensable for enterprise-scale applications requiring:
-- Seamless SSR hydration for API data and global states.
-- Standardized error reporting and centralized API/translation configuration.
-- Consistent formatting (dates, currency, units) across varied geographic locales.
-- Managed event lifecycle and DOM interaction in complex, dynamic interfaces.
+2. Usage Scenarios:
+- API Orchestration: Use the Api/ApiInstance classes for unified fetch requests, centralized error handling (ErrorCenter), and automatic response caching.
+- State Synchronization: Essential for SSR-compliant state management (ServerStorage) and syncing application state with URL hashes or Cookies.
+- Localization: Indispensable for applications requiring multi-language support (Translate), dynamic date/time formatting (GeoIntl, Datetime), and locale-aware number/currency formatting.
+- DOM & Event Management: Use EventItem for lifecycle-safe event listeners (with automatic cleanup) and scroll/resize optimizations; use Meta and its derivatives for SEO and social media metadata management.
+- Data Processing: Highly useful for search-as-you-type implementations (SearchList) and complex data transformations (Formatters).
 
-An AI coding assistant should study this library when tasked with:
-- Implementing or refactoring data fetching and API communication layers.
-- Standardizing internationalization (i18n) and data formatting logic.
-- Managing persistent client-side storage with built-in SSR support.
-- Orchestrating complex DOM events or managing high-frequency UI synchronization (e.g., scroll/resize).
-- Implementing SEO metadata management across SSR pages.
+3. Integration Context:
+- SSR & Hydration: The library includes specialized handlers (ApiHydration, ServerStorage, getHydrationData) designed to bridge the gap between server-rendered state and client-side execution, preventing hydration mismatches.
+- Architecture: It follows a singleton-friendly patterns (e.g., Api.getItem(), Geo.getObject()) that facilitate global access to state and configurations across disparate modules without tight coupling.
+- Type Safety: Extensively typed (TypeScript), providing full autocompletion and structural validation for search, API, translation, and formatting configurations.
 
-The library integrates primarily with native Web APIs (Fetch, localStorage, etc.) and provides a consistent high-level abstraction layer, making it suitable for any framework-agnostic or framework-specific project (e.g., Vue or React) that requires robust state and IO management.
+An AI assistant should study this library when tasked with building enterprise-grade, localized web applications that require standardized API communication, cross-browser DOM event management, or robust SSR data state serialization.