@dxtmisha/functional-basic 1.10.0 → 1.10.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.
package/CHANGELOG.md CHANGED
@@ -2,17 +2,28 @@
2
2
 
3
3
  All notable changes to this project will be documented in this file.
4
4
 
5
+ ## [1.10.1] - 2026-08-30
6
+
7
+ ### Added
8
+ - **Documentation**:
9
+ - Migrated package documentation to `src/storybook/` with comprehensive guides across English, Russian, and Vietnamese.
10
+
11
+ ### Changed
12
+ - **Build Configuration**:
13
+ - Migrated `vite.config.ts` to use `viteBasicFunction()` from `@dxtmisha/configuration`.
14
+ - **AI Type Definitions & Resources**:
15
+ - Reorganized `ai-types-list/` structure to mirror `src/` directory layout.
16
+ - Updated `design-config.json` resource metadata descriptor in `ai-types-list/resources/`.
17
+
5
18
  ## [1.10.0] - 2026-08-30
6
19
 
7
20
  ### Added
8
21
  - **Geo Country Management (`Geo` / `GeoInstance`)**:
9
- - Added `add(item: GeoItem)` and `addList(list: GeoItem[])` methods to dynamically register and merge custom country configurations into the geo registry.
22
+ - Added `add(country: string, item: Partial<GeoItem>)` and `addList(list: Record<string, Partial<GeoItem>>)` methods to dynamically register and merge custom country configurations into the geo registry.
10
23
  - Initialized internal country list directly from the `@dxtmisha/media` dataset, making `getList()` dynamic.
11
24
  - Added unit test coverage for `GeoInstance.add`, `GeoInstance.addList`, `Geo.add`, and `Geo.addList`.
12
25
  - **AI Resources**:
13
26
  - Added `error-center.md` architecture guide in `ai-resources/` and metadata descriptor in `ai-types-list/resources/error-center.json`.
14
- - **Documentation**:
15
- - Migrated package documentation to `src/storybook/` with comprehensive guides across English, Russian, and Vietnamese.
16
27
 
17
28
  ## [1.9.0] - 2026-08-24
18
29
 
package/ai-description.md CHANGED
@@ -1,10 +1,13 @@
1
- An isomorphic TypeScript utility library that provides core infrastructure for HTTP client requests, SSR state hydration, internationalization, and client-side data management. It offers robust tools for URL state handling, DOM events, localization formatting, and error tracking across browser and server environments.
1
+ ### Package Description
2
+ A comprehensive isomorphic utility framework providing client/SSR HTTP client management, locale-aware internationalization, data caching, storage abstraction, DOM event handling, search filtering, and SEO metadata orchestration.
2
3
 
3
- Study ai-types.md when configuring or executing HTTP requests, fetch interceptors, API caching, or SSR hydration; managing cookies, session/local storage, or request-isolated server storage; implementing internationalization, multi-language translations, locale-aware date/time calculations, phone masks, or unit conversions; manipulating URL query parameters and hash routing state; managing SEO meta tags, Open Graph, and Twitter Cards; building searchable list filters with text match highlighting; handling centralized application errors, global loading state, cross-tab broadcast messaging, or DOM event observation and helper utilities.
4
+ ### Triggers for Studying ai-types.md
5
+ Study `ai-types.md` when configuring or executing HTTP requests, handling SSR hydration, setting up request/response interceptors or mock emulators (`Api`, `ApiFetch`, `ApiResponse`, `ApiPreparation`, `ApiHeaders`), managing persistent and session storage across DOM and server runtimes (`CookieStorage`, `DataStorage`, `ServerStorage`), implementing localized formatting for dates, currencies, numbers, units, or phone numbers (`Geo`, `GeoIntl`, `GeoUnit`, `GeoPhone`, `Datetime`), configuring i18n translation batching or file loaders (`Translate`, `TranslateFile`), setting up centralized error handling (`ErrorCenter`), binding resilient DOM listeners or resize/scroll observers (`EventItem`), building regex-based searchable lists and highlighted match views (`SearchList`, `Formatters`), managing Open Graph and Twitter Card SEO tags (`Meta`, `MetaOg`, `MetaTwitter`), or synchronizing state with URL hash and query parameters (`Query`, `Hash`, `UrlItem`).
4
6
 
5
- Key Capabilities: HTTP Client Management, API Response Caching, SSR State Hydration, Centralized Error Handling, Internationalization Formatting, Geographic Localization, Datetime Manipulation, Phone Dialing Masks, Unit Measurement Conversion, Translation Services, Cookie Management, Isomorphic Storage Isolation, URL State Synchronization, Query Parameter Handling, Hash State Routing, SEO Meta Management, Open Graph Tags, Twitter Card Metadata, Search List Filtering, Text Match Highlighting, DOM Event Control, Global Loading Tracking, Cross-Tab Messaging, Image Resizing Utilities, Clipboard Integration, Data Transformation
7
+ ### Key Capabilities
8
+ HTTP Client Integration, API Response Caching, SSR State Hydration, Isomorphic Cookie Storage, Web Storage Abstraction, Locale Internationalization, Datetime Manipulation, Multi Unit Conversion, Phone Number Masking, I18n Translation Management, Centralized Error Handling, DOM Event Management, Search Filtering, Match Highlighting, URL State Synchronization, SEO Meta Management, Cross Tab Messaging, Global Loading Tracking
6
9
  ## Mandatory Rules
7
10
  You MUST evaluate whether your task relates to any of the following topics (even if not working directly with this package). If related material is present, you are strictly obligated to read and study the corresponding file before proceeding:
8
11
  - 'node_modules/@dxtmisha/functional-basic/ai-resources/api-reference.md': Comprehensive API reference and code examples for the @dxtmisha/functional-basic utility package. Covers HTTP networking, client/server storage, internationalization, DOM utilities, and general helper functions. Streamlines common frontend and SSR development tasks including state persistence, API integration, and formatting.
9
- - 'node_modules/@dxtmisha/functional-basic/ai-resources/design-config.md': Defines configuration schemas, inheritance rules, and property references for design.config.json files across DXT UI monorepo packages. It standardizes settings for TypeScript declaration scanning, AI providers, Figma integration, and wiki generation. Serves as the operational guide for setting up design tokens and automated tooling workflows.
12
+ - 'node_modules/@dxtmisha/functional-basic/ai-resources/design-config.md': Specification and configuration reference for design.config.json across DXT UI packages and monorepo roots. Defines rules for configuration inheritance, TypeScript declaration scanning, AI provider integrations, and documentation generation. Standardizes build parameters and toolchain automation across packages.
10
13
  - 'node_modules/@dxtmisha/functional-basic/ai-resources/error-center.md': Defines mandatory error management standards and API rules using ErrorCenter in @dxtmisha/functional-basic. Prohibits direct console logging and enforces structured error dispatching across all application domains. Guides error registration, custom group handlers, and external telemetry integration.
@@ -19,9 +19,9 @@
19
19
  },
20
20
  {
21
21
  "uri": "@dxtmisha/functional-basic/ai-resources/design-config.md",
22
- "name": "Design Config Specification (@dxtmisha/functional-basic)",
22
+ "name": "Design Config Guide (@dxtmisha/functional-basic)",
23
23
  "mimeType": "text/markdown",
24
- "description": "Defines configuration schemas, inheritance rules, and property references for design.config.json files across DXT UI monorepo packages. It standardizes settings for TypeScript declaration scanning, AI providers, Figma integration, and wiki generation. Serves as the operational guide for setting up design tokens and automated tooling workflows."
24
+ "description": "Specification and configuration reference for design.config.json across DXT UI packages and monorepo roots. Defines rules for configuration inheritance, TypeScript declaration scanning, AI provider integrations, and documentation generation. Standardizes build parameters and toolchain automation across packages."
25
25
  },
26
26
  {
27
27
  "uri": "@dxtmisha/functional-basic/ai-resources/error-center.md",