npm - @dxtmisha/functional-basic - Versions diffs - 1.4.3 → 1.6.1 - Mend

@dxtmisha/functional-basic 1.4.3 → 1.6.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (191) hide show

package/CHANGELOG.md CHANGED Viewed

@@ -2,6 +2,23 @@
 All notable changes to this project will be documented in this file.
+## [1.5.0] - 2026-07-02
+### Added
+- **GeoUnit**: Introduced a new isomorphic class `GeoUnit` for localized unit formatting and automatic conversions (e.g. converting and formatting Celsius to Fahrenheit, grams to ounces, meters to feet) for customary unit systems (US, Myanmar, Liberia, UK).
+- **Tests**: Created a comprehensive test suite `GeoUnit.test.ts` to verify unit translation and formatting across multiple locales.
+### Changed
+- **geoTypes**: Standardized `GeoItem['unit']` property types in `geoTypes.ts` to use exact Unicode CLDR unit names.
+## [1.4.4] - 2026-06-27
+### Added
+- **ErrorCenterHandler**: Introduced `callbacks` list and `addCallback(callback)` method to register callback functions that are executed on every triggered error.
+- **ErrorCenterInstance**: Added `addCallback(callback)` instance method to register global error callbacks.
+- **ErrorCenter**: Added static `addCallback(callback)` helper to simplify the registration of global error callbacks.
+- **Tests**: Added comprehensive unit tests in `ErrorCenterHandler.test.ts`, `ErrorCenterInstance.test.ts`, and `ErrorCenter.test.ts` to verify the execution of global callbacks.
 ## [1.4.3] - 2026-06-25
 ### Changed

package/ai-description.md CHANGED Viewed

@@ -1,22 +1,21 @@
-### 1. Core Purpose
-This library provides a comprehensive, isomorphic (SSR/Client) utility framework for web applications. It centralizes cross-cutting concerns, including HTTP request management with middleware/hooks, reactive URL state synchronization (Query/Hash), global configuration, internationalization, metadata management, and data caching.
+Core Purpose: This library is a comprehensive isomorphic toolkit for web application development, providing high-level abstractions for API communication (fetch/caching/hydration), internationalization (translations/formatting), localized date/time manipulation, persistent data storage (Cookie/LocalStorage), reactive URL state management (Hash/Query), and DOM event handling.
-### 2. Key Expositions
-*   **Networking**: `Api`, `ApiInstance`, and `ApiCache` manage HTTP requests, caching layers, error handling (`ApiError`), and SSR hydration.
-*   **State & Sync**: `QueryInstance` and `HashInstance` provide reactive, syncable interfaces for URL-based states. `DataStorage` handles `localStorage`/`sessionStorage` with SSR isolation.
-*   **Localization (Geo/Intl)**: `Geo`, `GeoInstance`, and `GeoIntl` manage locale, timezone, and phone mask logic. `Translate` and `TranslateInstance` provide file-based and API-backed localization.
-*   **UI Helpers**: `EventItem` (DOM event wrapper with memory leak protection), `Loading` (global load state), `Icons` (asset management), and `Formatters` (data display utilities).
-*   **Meta Management**: `Meta` and its manager classes control document `<head>` elements, including Open Graph and Twitter Cards.
-*   **Core Utilities**: A suite of functions in `src/functions/` for type-safe data transformation, deep object cloning, DOM manipulation, and URL encoding.
+Key Expositions:
+1. Api & ApiInstance: Orchestrates HTTP requests with support for middleware (preparation/end), automatic hydration for SSR, request caching, and centralized error handling.
+2. Geo, GeoIntl, GeoFlag, GeoPhone, GeoUnit: A suite for locale-sensitive data handling including currency, date, numeric, and unit conversions (metric/imperial based on region).
+3. Meta, MetaOg, MetaTwitter: Declarative management of HTML head tags, Open Graph, and Twitter Cards.
+4. DataStorage, CookieStorage, ServerStorage: Unified persistent storage interfaces with built-in SSR data isolation and hydration support.
+5. SearchList: A specialized state machine for filtering, matching, and highlighting item collections based on column definitions and regex search.
+6. EventItem: A robust wrapper for DOM listeners that includes auto-cleanup, lifecycle control, and specialized optimizations (e.g., resize/scroll-sync).
+7. Translation System: Asynchronous/Synchronous multi-locale translation manager with fallback logic and file-based loading.
-### 3. Triggers for Studying ai-types.md
-The `ai-types.md` file is **mandatory** if the AI is tasked with:
-*   Extending or implementing new `ApiFetch` or `ApiConfig` interfaces.
-*   Integrating custom error handling via `ErrorCenter` or `ApiErrorStorageItem`.
-*   Extending geographical data schemas (`GeoItem`, `GeoPhoneValue`).
-*   Implementing new meta-tag configurations or Open Graph properties.
-*   Implementing search functionality using `SearchList` and associated types.
-*   **Crucial**: Whenever the task involves modifying request/response schemas or adding global middleware via `ApiInstance` options, as the types define strict constraints on request lifecycle hooks (`ApiPreparation`, `ApiPreparationEnd`).
+Triggers for Studying ai-types.md:
+It is mandatory to analyze ai-types.md when:
+- You need to extend or define custom configurations for the API layer (ApiConfig, ApiFetch).
+- You are implementing custom Error/Exception handling logic using the ErrorCenter structures.
+- You are adding new locale definitions, phone mask structures, or unit conversion mappings.
+- You need to debug hydration mismatches between SSR and client-side data state.
+- You are extending search logic or defining new search list result types.
-### 4. Integration Context
-The library acts as a foundational "System Toolkit." It is designed to be injected into frontend frameworks (Vue/React) via lifecycle-aware wrappers (e.g., triggering `createElement` only on mount). It bridge the gap between server (SSR) and client states through `ServerStorage` and `ApiHydration`, ensuring that state generated on the server is correctly transferred to the client without hydration mismatches.
+Integration Context:
+This library serves as the foundation layer for application state and external communication. It is designed to be used in conjunction with modern reactive frameworks (Vue/React) by leveraging the provided hydration hooks to synchronize state between the server environment and the browser client. It relies on the global DOM environment where available, but degrades to neutral behaviors or errors in non-browser environments to ensure compatibility with SSR processes.