@dxtmisha/functional 1.15.2 → 1.15.5

package/dist/classes/ref/GeoIntlRef.d.ts

@@ -5,6 +5,13 @@ import { RefOrNormal } from '../../types/refTypes';
  * Reactive class for managing the formatting of numbers and dates.
  *
  * Реактивный класс для управления форматированием чисел и дат.
+ *
+ * @remarks
+ * Avoid using this reactive class if reactive updates are not required.
+ * For non-reactive formatting, use the standard `GeoIntl` class from `@dxtmisha/functional-basic`.
+ *
+ * Старайтесь избегать этого класса, если не требуется реактивная переменная.
+ * Для нереактивного форматирования используйте обычный `GeoIntl` из `@dxtmisha/functional-basic`.
  */
 export declare class GeoIntlRef {
     private location;

package/dist/composables/ref/useGeoIntlRef.d.ts

@@ -3,5 +3,12 @@ import { GeoIntlRef } from '../../classes/ref/GeoIntlRef';
  * Returns a class object for working with data formatting.
  *
  * Возвращает объект класса для работы с форматированием данных.
+ *
+ * @remarks
+ * Avoid using this reactive composable if reactive updates are not required.
+ * For non-reactive formatting, use the standard `GeoIntl` class from `@dxtmisha/functional-basic`.
+ *
+ * Старайтесь избегать этого хука, если не требуется реактивная переменная.
+ * Для нереактивного форматирования используйте обычный `GeoIntl` из `@dxtmisha/functional-basic`.
  */
 export declare function useGeoIntlRef(): GeoIntlRef;

package/dist/composables/ref/useLazyItemByMarginRef.d.ts

@@ -1,7 +1,9 @@
+import { useLazyRef, LazyItem } from './useLazyRef';
 import { RefType } from '../../types/refTypes';
+import { ShallowRef } from 'vue';
 export type LazyItemByMargin = {
     rootMargin: string;
-    item: any;
+    item: ReturnType<typeof useLazyRef>;
 };
 /**
  * Hook for initializing the tracking of an element's appearance on the screen by margin.
@@ -10,13 +12,13 @@ export type LazyItemByMargin = {
  * @param element element for tracking/ элемента для отслеживания
  * @param rootMargin root margin for IntersectionObserver/ отступ для IntersectionObserver
  */
-export declare const useLazyItemByMarginRef: (element: RefType<HTMLElement | undefined>, rootMargin: string) => {
+export declare const useLazyItemByMarginRef: (element: RefType<HTMLElement | undefined>, rootMargin?: string) => {
     /** Lazy item status/ Статус ленивого элемента */
-    lazyItemStatus: any;
+    lazyItemStatus: ShallowRef<boolean, boolean>;
     /**
      * Getting a tracked lazy item.
      *
      * Получение отслеживаемого ленивого элемента.
      */
-    readonly lazyItem: any;
+    readonly lazyItem: LazyItem | undefined;
 };

package/dist/composables/ref/useLazyRef.d.ts

@@ -19,7 +19,7 @@ export declare const useLazyRef: (options?: IntersectionObserverInit) => {
      * Получение отслеживаемого элемента.
      * @param element tracked element/ отслеживаемый элемент
      */
-    getItem(element: HTMLElement): LazyItem;
+    getItem(element?: HTMLElement): LazyItem | undefined;
     /**
      * Adding an element for tracking.
      *

package/dist/composables/ref/useMeta.d.ts

@@ -1,4 +1,4 @@
-import { MetaRobots, MetaStatic } from '@dxtmisha/functional-basic';
+import { MetaRobots, Meta } from '@dxtmisha/functional-basic';
 import { Ref } from 'vue';
 /**
  * Vue composable for reactive meta tags management with automatic DOM synchronization.
@@ -8,7 +8,7 @@ import { Ref } from 'vue';
  * Использует паттерн singleton - все компоненты используют одно состояние мета-тегов.
  */
 export declare const useMeta: () => Readonly<{
-    meta: typeof MetaStatic;
+    meta: Meta;
     /** Reactive page title (without suffix) / Реактивный заголовок страницы (без суффикса) */
     title: Ref<string, string>;
     /** Reactive keywords meta tag / Реактивный мета-тег keywords */
@@ -111,10 +111,10 @@ export declare const useMeta: () => Readonly<{
      * Устанавливает суффикс для заголовка страницы.
      * @param suffix Suffix to set / Суффикс для установки
      */
-    setSuffix: (suffix: string) => typeof MetaStatic;
+    setSuffix: (suffix: string) => void;
 } & {
     init(): Readonly<{
-        meta: typeof MetaStatic;
+        meta: Meta;
         /** Reactive page title (without suffix) / Реактивный заголовок страницы (без суффикса) */
         title: Ref<string, string>;
         /** Reactive keywords meta tag / Реактивный мета-тег keywords */
@@ -217,7 +217,7 @@ export declare const useMeta: () => Readonly<{
          * Устанавливает суффикс для заголовка страницы.
          * @param suffix Suffix to set / Суффикс для установки
          */
-        setSuffix: (suffix: string) => typeof MetaStatic;
+        setSuffix: (suffix: string) => void;
     }>;
     destroyExecute?(): void;
 }>;

package/dist/composables/ref/useSearchRef.d.ts

@@ -1,6 +1,6 @@
 import { Ref, ComputedRef } from 'vue';
 import { SearchColumns, SearchFormatList, SearchItem, SearchOptions } from '@dxtmisha/functional-basic';
-import { SearchListInput } from '../../types/searchTypes';
+import { SearchColumnsInput, SearchListInput } from '../../types/searchTypes';
 /**
  * Composable for handling search logic with reactive data.
  *
@@ -10,7 +10,7 @@ import { SearchListInput } from '../../types/searchTypes';
  * @param value reactive search string / реактивная строка поиска
  * @param options search options / настройки поиска
  */
-export declare function useSearchRef<T extends SearchItem, K extends SearchColumns<T>>(list: SearchListInput<T>, columns: K, value?: Ref<string>, options?: SearchOptions): {
+export declare function useSearchRef<T extends SearchItem, K extends SearchColumns<T>>(list: SearchListInput<T>, columns?: SearchColumnsInput<T, K>, value?: Ref<string>, options?: SearchOptions): {
     /**
      * Whether the search is currently active (minimum character limit reached)/
      * Активен ли поиск в данный момент (достигнут ли лимит символов)

package/dist/library.js

@@ -969,13 +969,13 @@ function Je(e, t) {
 //#endregion
 //#region src/composables/ref/useSearchRef.ts
 function Ye(e, t, n, r) {
-	let i = new b(void 0, t, void 0, r), { search: a, searchDelay: o, loading: s } = Je(i, n), c = () => H(C(e)) || [], l = F(() => i.setValue(o.value).getItem().isSearch()), u = F(() => i.setList(c()).setValue(o.value).to());
+	let i = () => H(C(t)), a = new b(void 0, i(), void 0, r), { search: o, searchDelay: s, loading: c } = Je(a, n), l = () => H(C(e)) || [], u = F(() => a.setColumns(i()).setValue(s.value).getItem().isSearch()), d = F(() => a.setList(l()).setColumns(i()).setValue(s.value).to());
 	return {
-		isSearch: l,
-		search: a,
-		loading: s,
-		listSearch: u,
-		length: F(() => u.value.length)
+		isSearch: u,
+		search: o,
+		loading: c,
+		listSearch: d,
+		length: F(() => d.value.length)
 	};
 }
 //#endregion
@@ -1126,6 +1126,7 @@ var ot = (e = { rootMargin: "128px 0px" }) => {
 	return {
 		intersectionObserver: n,
 		getItem(e) {
+			if (!e) return;
 			let n = D(e);
 			return t[n];
 		},
@@ -1158,7 +1159,7 @@ var ot = (e = { rootMargin: "128px 0px" }) => {
 		rootMargin: e,
 		item: r
 	}), r;
-}, lt = (e, t) => {
+}, lt = (e, t = "128px 0px") => {
 	let n = ct(t);
 	return {
 		lazyItemStatus: n.addLazyItem(e),
@@ -1181,7 +1182,7 @@ var dt = /* @__PURE__ */ function(e) {
 	return e.global = "global", e.provide = "provide", e.local = "local", e;
 }({}), ft = 1, pt = re(1e5, 999999), mt = () => `__execute_use${pt}::${ft++}`, ht = () => x.get("__ui:execute-use-global__", () => []);
 function $(e, t = "provide") {
-	let n = mt(), r, i = (t) => {
+	let n = mt(), r = (t) => {
 		let n = Object.freeze(e(...t));
 		return {
 			...n,
@@ -1189,21 +1190,19 @@ function $(e, t = "provide") {
 				return n;
 			}
 		};
-	}, a = (e) => {
-		let t = Object.freeze(i(e));
+	}, i = (e) => {
+		let t = Object.freeze(r(e));
 		return me(n, t), t;
-	}, o = (e) => {
-		let t = i(e);
+	}, a = (e) => {
+		let t = r(e);
 		return Object.freeze({
 			...t,
 			destroyExecute() {
-				r = void 0;
+				x.remove(n);
 			}
 		});
-	}, s = (...e) => t === "provide" ? de(n, void 0) || a(e) : (r || K.run(() => {
-		r = o(e);
-	}), r);
-	return t === "global" && ht().push(s), s;
+	}, o = (...e) => t === "provide" ? de(n, void 0) || i(e) : x.get(n, () => K.run(() => a(e)));
+	return t === "global" && ht().push(o), o;
 }
 function gt(e) {
 	return $(e, "global");
@@ -1220,7 +1219,7 @@ function yt() {
 //#endregion
 //#region src/composables/ref/useMeta.ts
 var bt = vt(() => {
-	let e = _, t = L(e.getTitle()), n = L(e.getKeywords()), r = L(e.getDescription()), i = L(e.getImage()), a = L(e.getCanonical()), o = L(e.getRobots()), s = L(e.getAuthor()), c = L(e.getSiteName()), l = () => e.html(), u = (e) => {
+	let e = _.getItem(), t = L(e.getTitle()), n = L(e.getKeywords()), r = L(e.getDescription()), i = L(e.getImage()), a = L(e.getCanonical()), o = L(e.getRobots()), s = L(e.getAuthor()), c = L(e.getSiteName()), l = () => e.html(), u = (e) => {
 		t.value = e, x();
 	}, d = (e) => {
 		n.value = e, x();

package/dist/types/searchTypes.d.ts

@@ -1,6 +1,10 @@
 import { RefOrNormal } from './refTypes';
-import { SearchItem, SearchListValue } from '@dxtmisha/functional-basic';
+import { SearchColumns, SearchItem, SearchListValue } from '@dxtmisha/functional-basic';
 /** Search list data / Данные списка поиска */
 export type SearchListValueRef<T extends SearchItem> = RefOrNormal<SearchListValue<T>>;
 /** Search list input / Входные данные списка поиска */
 export type SearchListInput<T extends SearchItem> = SearchListValueRef<T> | (() => SearchListValueRef<T>);
+/** Search columns ref / Реактивные столбцы поиска */
+export type SearchColumnsRef<T extends SearchItem, K extends SearchColumns<T>> = RefOrNormal<K>;
+/** Search columns input / Входные данные столбцов поиска */
+export type SearchColumnsInput<T extends SearchItem, K extends SearchColumns<T>> = SearchColumnsRef<T, K> | (() => SearchColumnsRef<T, K>);

package/package.json

@@ -1,35 +1,60 @@
 {
   "name": "@dxtmisha/functional",
   "private": false,
-  "version": "1.15.2",
+  "version": "1.15.5",
   "type": "module",
-  "description": "A comprehensive library of utilities, base classes, and Vue 3 composables for reactive web development. Extends @dxtmisha/functional-basic with Composition API.",
+  "description": "A comprehensive library of utilities, base classes, and Vue 3 composables for reactive web development — API orchestration, state singletons (executeUse), storage sync, i18n, formatters, and component design. Extends @dxtmisha/functional-basic.",
   "keywords": [
-    "functional",
-    "utilities",
-    "helpers",
-    "typescript",
     "vue",
     "vue3",
     "composition-api",
     "composables",
-    "classes",
     "reactivity",
+    "typescript",
+    "utilities",
+    "helpers",
+    "functional",
+    "ssr",
+    "hydration",
     "api-client",
+    "execute-use",
+    "singletons",
+    "state-management",
+    "design-constructor",
+    "base-classes",
     "storage",
+    "localStorage",
+    "sessionStorage",
+    "cookie",
+    "broadcast-channel",
     "i18n",
+    "intl",
+    "localization",
+    "translate",
     "geo",
+    "geolocation",
+    "flags",
     "datetime",
-    "cache",
-    "ui"
+    "formatters",
+    "units",
+    "meta",
+    "seo",
+    "dom",
+    "events",
+    "list-data",
+    "search",
+    "lazy-loading",
+    "computed-async",
+    "router",
+    "dxt"
   ],
   "author": "dxtmisha@gmail.com",
   "license": "MIT",
-  "homepage": "https://github.com/dxtmisha/dxt-ui/tree/main/packages/functional-basic",
+  "homepage": "https://github.com/dxtmisha/dxt-ui/tree/main/packages/functional",
   "repository": {
     "type": "git",
     "url": "git+https://github.com/dxtmisha/dxt-ui.git",
-    "directory": "packages/functional-basic"
+    "directory": "packages/functional"
   },
   "bugs": {
     "url": "https://github.com/dxtmisha/dxt-ui/issues"