@dxtmisha/functional-basic 1.10.0 → 1.11.0

package/CHANGELOG.md

@@ -2,17 +2,41 @@
 
 All notable changes to this project will be documented in this file.
 
+## [1.11.0] - 2026-09-07
+
+### Added
+- **Configuration Types**:
+  - Added `DesignUiConfigPackagePrompt`, `promptInclude`, and `promptPackageOnly` type definitions to `src/types/basicTypes.ts`.
+  - Added AI resource documentation for `design-config.md` with prompt exclusion rules.
+
+### Changed
+- **Dependencies**:
+  - Updated workspace package dependencies to explicit `>=` semver ranges (`@dxtmisha/media >= 0.7.3`).
+- **AI Documentation**:
+  - Refined descriptions and updated MD5 hashes in `ai-types-list/resources/` for `design-config.json` and `error-center.json`.
+
+## [1.10.1] - 2026-08-30
+
+### Added
+- **Documentation**:
+  - Migrated package documentation to `src/storybook/` with comprehensive guides across English, Russian, and Vietnamese.
+
+### Changed
+- **Build Configuration**:
+  - Migrated `vite.config.ts` to use `viteBasicFunction()` from `@dxtmisha/configuration`.
+- **AI Type Definitions & Resources**:
+  - Reorganized `ai-types-list/` structure to mirror `src/` directory layout.
+  - Updated `design-config.json` resource metadata descriptor in `ai-types-list/resources/`.
+
 ## [1.10.0] - 2026-08-30
 
 ### Added
 - **Geo Country Management (`Geo` / `GeoInstance`)**:
-  - Added `add(item: GeoItem)` and `addList(list: GeoItem[])` methods to dynamically register and merge custom country configurations into the geo registry.
+  - 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.
   - Initialized internal country list directly from the `@dxtmisha/media` dataset, making `getList()` dynamic.
   - Added unit test coverage for `GeoInstance.add`, `GeoInstance.addList`, `Geo.add`, and `Geo.addList`.
 - **AI Resources**:
   - Added `error-center.md` architecture guide in `ai-resources/` and metadata descriptor in `ai-types-list/resources/error-center.json`.
-- **Documentation**:
-  - Migrated package documentation to `src/storybook/` with comprehensive guides across English, Russian, and Vietnamese.
 
 ## [1.9.0] - 2026-08-24
 

package/ai-description.md

@@ -1,10 +1,8 @@
-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.
+This package provides a comprehensive isomorphic toolkit containing core services, state managers, and utilities for both browser and server-side runtimes. It includes integrated modules for HTTP requests with SSR hydration and caching, geographic localization, date and measurement unit formatting, dictionary translations, persistent storage, and URL state synchronization. An AI assistant should consult this package when implementing API integration layers, configuring SEO and social metadata, managing multi-locale formatting, or coordinating client-server storage and DOM utilities.
 
-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.
-
-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
+Key Capabilities: API Client, Request Caching, SSR Hydration, API Mocking, Error Management, Geographic Localization, Locale Formatting, Translation Management, Phone Masking, Unit Conversion, DateTime Localization, Cookie Management, Server Storage, Browser Storage, URL State Sync, Broadcast Messaging, SEO Meta Management, Open Graph Metadata, Twitter Card Management, DOM Event Handling, Search List Filtering, Text Highlighting, Clipboard Utilities, Global Loading State
 ## Mandatory Rules
 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:
-- '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.
-- '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.
-- '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.
+- 'node_modules/@dxtmisha/functional-basic/ai-resources/api-reference.md': API reference and code examples for HTTP client, storage, localization, DOM, and utility functions.
+- 'node_modules/@dxtmisha/functional-basic/ai-resources/design-config.md': Rules and schema for configuring design systems, TypeScript declaration scanning, AI generation, and package settings.
+- 'node_modules/@dxtmisha/functional-basic/ai-resources/error-center.md': Standards and APIs for centralized error handling, routing exceptions via ErrorCenter without direct console logging.

package/ai-doc.md

@@ -2,7 +2,7 @@ Framework-agnostic utility library. **Vue developers MUST search `@dxtmisha/func
 
 ## Coding Standards & Conventions
 
-- **Class Structure**: Properties/Variables (`public`->`protected`->`private`) -> Constructor -> Public Methods -> Protected Methods -> Private Methods. Within each method group, follow order: 1) `get` / `set` (getters/setters), 2) `is...` / `has...`, 3) `get...` / `set...`, 4) `add...` / `remove...`, 5) `update...` / `reset...`, 6) remaining methods. Within each subgroup, methods are grouped semantically by logical pairs and rules (e.g., `min` / `max`, `width` / `height`, `x` / `y` / `z`), and remaining methods are sorted alphabetically.
+- **Class Structure**: Properties/Variables (`public`->`protected`->`private`) -> Constructor -> Public Methods -> Protected Methods -> Private Methods. Within each method group, follow order: 1) `get` (getters), 2) `set` (setters), 3) `is...`, 4) `has...`, 5) `get...`, 6) `set...`, 7) `add...`, 8) `remove...`, 9) `update...`, 10) `reset...`, 11) remaining methods. Within each subgroup, methods are grouped semantically by logical pairs and rules (e.g., `min` / `max`, `width` / `height`, `x` / `y` / `z`), and remaining methods are sorted alphabetically.
 - **Style/Types**: `PascalCase` classes, `camelCase` methods/props, `UPPER_SNAKE_CASE` constants. No `any` (use `unknown`/generics). Explicit return types for ALL methods. Export all interfaces. Type files: `*Types.ts`. Use `@effect/schema` for schemas.
 - **SSR Safety**: Isomorphic code. Do NOT store request state in globals. Use `isDomRuntime()` before `window`/`document`. Use `ServerStorage.get('key', () => new Class())` for request-isolated singletons.
 - **Utility & Primitive Functions**: ALWAYS use primitive helper functions from this package (e.g. `isFunction`, `executeFunction`, `isFilled`, `isObject`, `isString`, `isArray`, etc.) instead of writing custom inline checks or conditions.

package/ai-mcp-resources.json

@@ -15,18 +15,18 @@
     "uri": "@dxtmisha/functional-basic/ai-resources/api-reference.md",
     "name": "Functional Basic API Reference (@dxtmisha/functional-basic)",
     "mimeType": "text/markdown",
-    "description": "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."
+    "description": "API reference and code examples for HTTP client, storage, localization, DOM, and utility functions."
   },
   {
     "uri": "@dxtmisha/functional-basic/ai-resources/design-config.md",
-    "name": "Design Config Specification (@dxtmisha/functional-basic)",
+    "name": "Design System Configuration Guide (@dxtmisha/functional-basic)",
     "mimeType": "text/markdown",
-    "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."
+    "description": "Rules and schema for configuring design systems, TypeScript declaration scanning, AI generation, and package settings."
   },
   {
     "uri": "@dxtmisha/functional-basic/ai-resources/error-center.md",
-    "name": "Centralized Error Handling Guide (@dxtmisha/functional-basic)",
+    "name": "ErrorCenter Handling Guide (@dxtmisha/functional-basic)",
     "mimeType": "text/markdown",
-    "description": "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."
+    "description": "Standards and APIs for centralized error handling, routing exceptions via ErrorCenter without direct console logging."
   }
 ]

package/ai-resources/design-config.md

@@ -28,6 +28,9 @@ Configuration specification for DXT UI packages and monorepo root.
 - `distDir` (`string`, default: `'dist'`): Output directory path for compiled JavaScript files.
 - `aiResourcesDir` (`string`, default: `'ai-resources'`): Directory path containing AI resource and prompt files.
 - `promptScanDepth` (`number`, default: `6`): Maximum directory scan depth for collecting AI prompt packages.
+- `promptExclude` (`string | string[]`): List of library names to exclude from the `ai-prompt.md` file (e.g. `["@dxtmisha/styles"]`).
+- `promptInclude` (`string | string[]`): Whitelist of library names to include in the `ai-prompt.md` file; if specified, only these libraries will be included (e.g. `["@dxtmisha/d1", "@dxtmisha/constructor"]`).
+- `promptPackageOnly` (`boolean`, default: `false`): When `true`, restricts `ai-prompt.md` package discovery to only libraries defined in the root `package.json` (`dependencies`, `devDependencies`, etc.).
 - `separator` (`string`, default: `'/'`): Token path delimiter used when splitting design tokens into sub-branches.
 - `separatorBasicName` (`string`): Base token name stripped during branch segmentation.
 - `separatorLimit` (`number`): Maximum recursion depth for token key splitting.
@@ -73,6 +76,9 @@ Complete `design.config.json` incorporating all available configuration properti
   "distDir": "dist",
   "aiResourcesDir": "ai-resources",
   "promptScanDepth": 6,
+  "promptExclude": [
+    "@dxtmisha/styles"
+  ],
   "separator": "/",
   "separatorBasicName": "basic",
   "separatorLimit": 3,
@@ -101,4 +107,5 @@ Complete `design.config.json` incorporating all available configuration properti
    import { PropertiesConfig } from '../Properties/PropertiesConfig'
    const isExcluded = PropertiesConfig.getTypesExclude()
    const skipVue = PropertiesConfig.isTypesWithoutVue()
+   const promptExcluded = PropertiesConfig.getPromptExclude()
    ```