@dxtmisha/functional 1.15.12 → 1.15.14

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 (76) hide show
  1. package/CHANGELOG.md +18 -0
  2. package/ai-description.md +8 -11
  3. package/ai-mcp-resources.json +8 -8
  4. package/ai-types.md +1 -1645
  5. package/dist/library.d.ts +3556 -67
  6. package/dist/library.js +281 -311
  7. package/package.json +11 -4
  8. package/ai-resources/prompts.json +0 -26
  9. package/dist/classes/design/DesignAbstract.d.ts +0 -61
  10. package/dist/classes/design/DesignAsyncAbstract.d.ts +0 -28
  11. package/dist/classes/design/DesignChanged.d.ts +0 -42
  12. package/dist/classes/design/DesignComp.d.ts +0 -4
  13. package/dist/classes/design/DesignComponents.d.ts +0 -81
  14. package/dist/classes/design/DesignConstructorAbstract.d.ts +0 -150
  15. package/dist/classes/ref/DatetimeRef.d.ts +0 -123
  16. package/dist/classes/ref/EffectScopeGlobal.d.ts +0 -22
  17. package/dist/classes/ref/EventRef.d.ts +0 -22
  18. package/dist/classes/ref/GeoFlagRef.d.ts +0 -82
  19. package/dist/classes/ref/GeoIntlRef.d.ts +0 -220
  20. package/dist/classes/ref/GeoRef.d.ts +0 -82
  21. package/dist/classes/ref/GeoUnitRef.d.ts +0 -153
  22. package/dist/classes/ref/ListDataRef.d.ts +0 -366
  23. package/dist/classes/ref/RouterItemRef.d.ts +0 -61
  24. package/dist/classes/ref/ScrollbarWidthRef.d.ts +0 -22
  25. package/dist/composables/ref/useApiAsyncRef.d.ts +0 -70
  26. package/dist/composables/ref/useApiDelete.d.ts +0 -23
  27. package/dist/composables/ref/useApiGet.d.ts +0 -23
  28. package/dist/composables/ref/useApiManagementAsyncRef.d.ts +0 -58
  29. package/dist/composables/ref/useApiManagementRef.d.ts +0 -161
  30. package/dist/composables/ref/useApiPost.d.ts +0 -23
  31. package/dist/composables/ref/useApiPut.d.ts +0 -23
  32. package/dist/composables/ref/useApiRef.d.ts +0 -159
  33. package/dist/composables/ref/useApiRequest.d.ts +0 -105
  34. package/dist/composables/ref/useBroadcastValueRef.d.ts +0 -11
  35. package/dist/composables/ref/useCookieRef.d.ts +0 -11
  36. package/dist/composables/ref/useFormattersRef.d.ts +0 -21
  37. package/dist/composables/ref/useGeoIntlRef.d.ts +0 -14
  38. package/dist/composables/ref/useGeoUnitRef.d.ts +0 -7
  39. package/dist/composables/ref/useHashRef.d.ts +0 -9
  40. package/dist/composables/ref/useLazyItemByMarginRef.d.ts +0 -24
  41. package/dist/composables/ref/useLazyRef.d.ts +0 -42
  42. package/dist/composables/ref/useLoadingRef.d.ts +0 -7
  43. package/dist/composables/ref/useMeta.d.ts +0 -223
  44. package/dist/composables/ref/useQueryRef.d.ts +0 -9
  45. package/dist/composables/ref/useRouterList.d.ts +0 -28
  46. package/dist/composables/ref/useSearchRef.d.ts +0 -36
  47. package/dist/composables/ref/useSearchValueRef.d.ts +0 -19
  48. package/dist/composables/ref/useSessionRef.d.ts +0 -9
  49. package/dist/composables/ref/useStorageRef.d.ts +0 -10
  50. package/dist/composables/ref/useTranslateRef.d.ts +0 -40
  51. package/dist/flags.d.ts +0 -1
  52. package/dist/functions/basic.d.ts +0 -1
  53. package/dist/functions/computedAsync.d.ts +0 -13
  54. package/dist/functions/computedByLanguage.d.ts +0 -15
  55. package/dist/functions/computedEternity.d.ts +0 -15
  56. package/dist/functions/dxtFunctionalPlugin.d.ts +0 -82
  57. package/dist/functions/executeUse.d.ts +0 -216
  58. package/dist/functions/getInject.d.ts +0 -7
  59. package/dist/functions/getOptions.d.ts +0 -10
  60. package/dist/functions/ref/executeFunctionRef.d.ts +0 -11
  61. package/dist/functions/ref/getApiErrorRef.d.ts +0 -10
  62. package/dist/functions/ref/getBindRef.d.ts +0 -13
  63. package/dist/functions/ref/getRef.d.ts +0 -8
  64. package/dist/functions/ref/render.d.ts +0 -13
  65. package/dist/functions/ref/setRef.d.ts +0 -9
  66. package/dist/functions/ref/toRefItem.d.ts +0 -9
  67. package/dist/functions/render/getBind.d.ts +0 -14
  68. package/dist/functions/render/getClassName.d.ts +0 -8
  69. package/dist/functions/render/getIndexForRender.d.ts +0 -10
  70. package/dist/functions/toBind.d.ts +0 -10
  71. package/dist/functions/toBinds.d.ts +0 -9
  72. package/dist/types/apiTypes.d.ts +0 -74
  73. package/dist/types/constructorTypes.d.ts +0 -126
  74. package/dist/types/listTypes.d.ts +0 -65
  75. package/dist/types/refTypes.d.ts +0 -43
  76. package/dist/types/searchTypes.d.ts +0 -10
package/CHANGELOG.md CHANGED
@@ -2,6 +2,24 @@
2
2
 
3
3
  All notable changes to this project will be documented in this file.
4
4
 
5
+ ## [1.15.14] - 2026-08-22
6
+
7
+ ### Added
8
+ - **DesignConstructorAbstract**: Added `getKeyClass(name)` method to retrieve `{ key, class }` binding object for component sub-elements based on element class/key name.
9
+ - **ConstrBind**: Added default generic parameter `T = ConstrItem` to `ConstrBind<T = ConstrItem>` type definition.
10
+ - **Exports & Distribution**: Added `ai-screenshot` to package `files` and configured explicit export mappings for `./ai-types.md`, `./ai-description.md`, `./ai-resources/*`, and `./ai-screenshot/*` in `package.json`.
11
+ - **Documentation**: Migrated package documentation to `src/storybook/` with comprehensive guides across English, Russian, and Vietnamese.
12
+
13
+ ## [1.15.13] - 2026-08-20
14
+
15
+ ### Added
16
+ - **LLM Configuration (`llms.txt`)**: Added `llms.txt` indexing package capabilities, core composables (`executeUse`, `useApiRef`, `useStorageRef`, `useGeoIntlRef`), and AI resource documentation links.
17
+
18
+ ### Changed
19
+ - **AI Resource Metadata & Types**:
20
+ - Migrated prompt resource cache from monolithic `prompts.json` to individual resource descriptor files in `ai-types-list/resources/`.
21
+ - Regenerated AI type definitions and package descriptions with updated AI prompt formats.
22
+
5
23
  ## [1.15.12] - 2026-08-13
6
24
 
7
25
  ### Changed
package/ai-description.md CHANGED
@@ -1,14 +1,11 @@
1
- This package is a comprehensive Vue-based utility library designed to simplify state management, reactive routing, internationalization, and API communication. Developers should study this package to leverage its pre-built reactive wrappers, robust component constructors, and seamless API integration tools for modern frontend applications.
1
+ @dxtmisha/functional is a Vue 3 reactive framework extension providing component design constructors, advanced reactive primitives, and state management composables. It delivers unified solutions for reactive API orchestration, SSR prefetching, internationalization, storage/URL synchronization, and viewport observation.
2
2
 
3
- Key Capabilities:
4
- - API Integration
5
- - Reactive Storage
6
- - Internationalization Formatting
7
- - Component Management
8
- - Route Navigation
3
+ Study ai-types.md when implementing or typing Vue components with OOP design constructors, orchestrating reactive API requests and mutations with SSR support or contract validation, synchronizing state across browser storage, cookies, broadcast channels, or URL parameters, managing scoped singleton state, formatting localized dates, units, and geographic metadata reactively, implementing search and list data pipelines, observing element visibility, or managing SEO head metadata and global plugins.
4
+
5
+ Key Capabilities: Component Design Constructors, Reactive API Management, SSR Prefetching, Storage Synchronization, Cross-Tab Messaging, URL State Synchronization, Internationalization Formatting, Geographic Unit Conversion, Datetime Localization, List Data Management, Debounced Search, Viewport Lazy Loading, Reactive SEO Management, Singleton State Management, DOM Event Binding, Async Computed Reactivity
9
6
  ## Mandatory Rules
10
7
  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:
11
- - 'node_modules/@dxtmisha/functional/ai-resources/api-reference.md': Defines usage patterns and guidelines for REST API management and scope-isolated singleton factories within the @dxtmisha/functional library. It provides technical instructions for initializing global, local, and provided singletons alongside reactive CRUD operations.
12
- - 'node_modules/@dxtmisha/functional/ai-resources/localization-seo.md': Provides utilities for locale-aware formatting, translation primitives, geographic context resolution, and reactive HTML document metadata handling. Solves internationalization and SEO management tasks in web applications using functional components.
13
- - 'node_modules/@dxtmisha/functional/ai-resources/reactivity-lists.md': This file provides advanced async reactivity composables, list data models, search filters, and DOM observers for managing application state and UI lifecycle. It solves technical tasks related to asynchronous computed properties, optimized multi-field searching, and safe event listener management in frontend codebases.
14
- - 'node_modules/@dxtmisha/functional/ai-resources/storage-state.md': Provides composable Vue-like reactive wrappers for persistent and synchronized browser state management, including localStorage, sessionStorage, cookies, broadcast channels, and URL hash fragments. Solves technical tasks related to cross-tab communication, SSR-safe cookie handling, and state persistence for web applications.
8
+ - 'node_modules/@dxtmisha/functional/ai-resources/api-reference.md': Defines guidance and usage patterns for scope-isolated reactive singleton factories and REST API management in @dxtmisha/functional. Details scope initialization functions (executeUseGlobal, executeUseLocal, executeUseProvide) and reactive CRUD operations via useApiManagementRef.
9
+ - 'node_modules/@dxtmisha/functional/ai-resources/localization-seo.md': Provides reactive utility tools for internationalization, geographic context detection, multi-key translations, and dynamic HTML document metadata/SEO tag management. It standardizes locale-aware formatting for numbers, dates, and currencies across the application. Solves technical requirements for global localization and search engine optimization.
10
+ - 'node_modules/@dxtmisha/functional/ai-resources/reactivity-lists.md': Provides composables and utility classes for asynchronous reactivity, reactive list state management, and debounced multi-field search. Includes helpers for managed DOM event listeners and IntersectionObserver-based lazy loading. Solves advanced state synchronization and efficient DOM handling in reactive applications.
11
+ - 'node_modules/@dxtmisha/functional/ai-resources/storage-state.md': Contains composable utilities for managing persistent and synchronized browser state across storage mediums and tabs. Includes reactive wrappers for localStorage, sessionStorage, cookies, BroadcastChannel, and URL hash fragments. Solves client-side state persistence, SSR safety, and cross-tab communication requirements.
@@ -13,26 +13,26 @@
13
13
  },
14
14
  {
15
15
  "uri": "@dxtmisha/functional/ai-resources/api-reference.md",
16
- "name": "API Management and Scope Singletons (@dxtmisha/functional)",
16
+ "name": "API Management & Reactive Singletons (@dxtmisha/functional)",
17
17
  "mimeType": "text/markdown",
18
- "description": "Defines usage patterns and guidelines for REST API management and scope-isolated singleton factories within the @dxtmisha/functional library. It provides technical instructions for initializing global, local, and provided singletons alongside reactive CRUD operations."
18
+ "description": "Defines guidance and usage patterns for scope-isolated reactive singleton factories and REST API management in @dxtmisha/functional. Details scope initialization functions (executeUseGlobal, executeUseLocal, executeUseProvide) and reactive CRUD operations via useApiManagementRef."
19
19
  },
20
20
  {
21
21
  "uri": "@dxtmisha/functional/ai-resources/localization-seo.md",
22
- "name": "Localization and SEO Utilities (@dxtmisha/functional)",
22
+ "name": "Localization, Geo & SEO Management (@dxtmisha/functional)",
23
23
  "mimeType": "text/markdown",
24
- "description": "Provides utilities for locale-aware formatting, translation primitives, geographic context resolution, and reactive HTML document metadata handling. Solves internationalization and SEO management tasks in web applications using functional components."
24
+ "description": "Provides reactive utility tools for internationalization, geographic context detection, multi-key translations, and dynamic HTML document metadata/SEO tag management. It standardizes locale-aware formatting for numbers, dates, and currencies across the application. Solves technical requirements for global localization and search engine optimization."
25
25
  },
26
26
  {
27
27
  "uri": "@dxtmisha/functional/ai-resources/reactivity-lists.md",
28
- "name": "Reactivity Helpers and DOM Utilities (@dxtmisha/functional)",
28
+ "name": "Reactivity and DOM Utilities (@dxtmisha/functional)",
29
29
  "mimeType": "text/markdown",
30
- "description": "This file provides advanced async reactivity composables, list data models, search filters, and DOM observers for managing application state and UI lifecycle. It solves technical tasks related to asynchronous computed properties, optimized multi-field searching, and safe event listener management in frontend codebases."
30
+ "description": "Provides composables and utility classes for asynchronous reactivity, reactive list state management, and debounced multi-field search. Includes helpers for managed DOM event listeners and IntersectionObserver-based lazy loading. Solves advanced state synchronization and efficient DOM handling in reactive applications."
31
31
  },
32
32
  {
33
33
  "uri": "@dxtmisha/functional/ai-resources/storage-state.md",
34
- "name": "Reactive Storage Composables (@dxtmisha/functional)",
34
+ "name": "Reactive Storage State Composables (@dxtmisha/functional)",
35
35
  "mimeType": "text/markdown",
36
- "description": "Provides composable Vue-like reactive wrappers for persistent and synchronized browser state management, including localStorage, sessionStorage, cookies, broadcast channels, and URL hash fragments. Solves technical tasks related to cross-tab communication, SSR-safe cookie handling, and state persistence for web applications."
36
+ "description": "Contains composable utilities for managing persistent and synchronized browser state across storage mediums and tabs. Includes reactive wrappers for localStorage, sessionStorage, cookies, BroadcastChannel, and URL hash fragments. Solves client-side state persistence, SSR safety, and cross-tab communication requirements."
37
37
  }
38
38
  ]