@dxtmisha/functional 1.11.6 → 1.11.8

package/dist/library.js

@@ -2,7 +2,7 @@ import { Api as e, ApiMethodItem as t, BroadcastMessage as n, Cookie as r, DataS
 import { computed as M, customRef as oe, effectScope as se, getCurrentInstance as ce, h as le, hasInjectionContext as ue, inject as de, isRef as N, onServerPrefetch as fe, onUnmounted as pe, provide as me, ref as P, shallowRef as F, toRefs as he, triggerRef as ge, useAttrs as _e, useSlots as ve, watch as I, watchEffect as ye } from "vue";
 export * from "@dxtmisha/functional-basic";
 //#endregion
-//#region \0@oxc-project+runtime@0.126.0/helpers/typeof.js
+//#region \0@oxc-project+runtime@0.128.0/helpers/typeof.js
 function L(e) {
 	"@babel/helpers - typeof";
 	return L = typeof Symbol == "function" && typeof Symbol.iterator == "symbol" ? function(e) {
@@ -12,7 +12,7 @@ function L(e) {
 	}, L(e);
 }
 //#endregion
-//#region \0@oxc-project+runtime@0.126.0/helpers/toPrimitive.js
+//#region \0@oxc-project+runtime@0.128.0/helpers/toPrimitive.js
 function be(e, t) {
 	if (L(e) != "object" || !e) return e;
 	var n = e[Symbol.toPrimitive];
@@ -24,13 +24,13 @@ function be(e, t) {
 	return (t === "string" ? String : Number)(e);
 }
 //#endregion
-//#region \0@oxc-project+runtime@0.126.0/helpers/toPropertyKey.js
+//#region \0@oxc-project+runtime@0.128.0/helpers/toPropertyKey.js
 function xe(e) {
 	var t = be(e, "string");
 	return L(t) == "symbol" ? t : t + "";
 }
 //#endregion
-//#region \0@oxc-project+runtime@0.126.0/helpers/defineProperty.js
+//#region \0@oxc-project+runtime@0.128.0/helpers/defineProperty.js
 function R(e, t, n) {
 	return (t = xe(t)) in e ? Object.defineProperty(e, t, {
 		value: n,
@@ -910,6 +910,8 @@ function Ke(e, t, n, r, i, a, o, s) {
 		loadingDelete: S == null ? void 0 : S.loading,
 		isSearch: v == null ? void 0 : v.isSearch,
 		search: v == null ? void 0 : v.search,
+		init: C.init,
+		initSsr: C.initSsr,
 		reset: C.reset,
 		abort: C.abort,
 		sendPost: async (e) => await (y == null ? void 0 : y.send(e)),
@@ -918,10 +920,16 @@ function Ke(e, t, n, r, i, a, o, s) {
 	};
 }
 //#endregion
+//#region src/composables/ref/useApiManagementAsyncRef.ts
+function qe(e, t, n, r, i, a, o, s) {
+	let c = Ke(e, t, n, r, i, a, o, s);
+	return c.initSsr(), c;
+}
+//#endregion
 //#region src/composables/ref/useBroadcastValueRef.ts
-var qe = () => v.get("__ui:broadcast-value-ref__", () => ({}));
-function Je(e, t) {
-	let r = `broadcast--${e}`, i = qe();
+var Je = () => v.get("__ui:broadcast-value-ref__", () => ({}));
+function Ye(e, t) {
+	let r = `broadcast--${e}`, i = Je();
 	if (r in i) return i[r];
 	let a = P(b(t));
 	if (E()) {
@@ -936,11 +944,11 @@ function Je(e, t) {
 }
 //#endregion
 //#region src/composables/ref/useCookieRef.ts
-var Ye = () => v.get("__ui:cookie-ref__", () => ({}));
-function Xe(e, t, n) {
-	let i = Ye();
+var Xe = () => v.get("__ui:cookie-ref__", () => ({}));
+function Ze(e, t, n) {
+	let i = Xe();
 	if (e in i) return i[e];
-	let a = new r(e), o = Je(`__cookie:${e}`, a.get(t, n));
+	let a = new r(e), o = Ye(`__cookie:${e}`, a.get(t, n));
 	return U.run(() => {
 		I(o, (e) => {
 			a.set(e, n);
@@ -949,14 +957,14 @@ function Xe(e, t, n) {
 }
 //#endregion
 //#region src/composables/ref/useGeoIntlRef.ts
-function Ze() {
+function Qe() {
 	return new Pe();
 }
 //#endregion
 //#region src/composables/ref/useHashRef.ts
-var Qe = () => v.get("__ui:hash-ref__", () => ({}));
-function $e(e, t) {
-	let n = Qe();
+var $e = () => v.get("__ui:hash-ref__", () => ({}));
+function et(e, t) {
+	let n = $e();
 	if (e in n) return n[e];
 	let r = F(f.get(e, t));
 	return E() && (U.run(() => {
@@ -967,7 +975,7 @@ function $e(e, t) {
 }
 //#endregion
 //#region src/composables/ref/useLazyRef.ts
-var et = (e = { rootMargin: "128px 0px" }) => {
+var tt = (e = { rootMargin: "128px 0px" }) => {
 	let t = {}, n = E() && "IntersectionObserver" in window ? new IntersectionObserver((e) => {
 		e.forEach((e) => {
 			let n = w(e.target);
@@ -1011,16 +1019,16 @@ var et = (e = { rootMargin: "128px 0px" }) => {
 		removeLazyItem: r,
 		disconnectLazy: () => n == null ? void 0 : n.disconnect()
 	};
-}, tt = () => v.get("__ui:lazy-item-by-margin-ref__", () => []), nt = (e) => {
-	let t = tt(), n = t.find((t) => t.rootMargin === e);
+}, nt = () => v.get("__ui:lazy-item-by-margin-ref__", () => []), rt = (e) => {
+	let t = nt(), n = t.find((t) => t.rootMargin === e);
 	if (n) return n.item;
-	let r = et({ rootMargin: e });
+	let r = tt({ rootMargin: e });
 	return t.push({
 		rootMargin: e,
 		item: r
 	}), r;
-}, rt = (e, t) => {
-	let n = nt(t);
+}, it = (e, t) => {
+	let n = rt(t);
 	return {
 		lazyItemStatus: n.addLazyItem(e),
 		get lazyItem() {
@@ -1030,7 +1038,7 @@ var et = (e = { rootMargin: "128px 0px" }) => {
 };
 //#endregion
 //#region src/composables/ref/useLoadingRef.ts
-function it() {
+function at() {
 	let e = F(m.is());
 	return E() && m.registrationEvent(({ detail: t }) => {
 		e.value = t.loading;
@@ -1040,9 +1048,9 @@ function it() {
 //#region src/functions/executeUse.ts
 var Q = /* @__PURE__ */ function(e) {
 	return e.global = "global", e.provide = "provide", e.local = "local", e;
-}({}), at = 1, ot = re(1e5, 999999), st = () => `__execute_use${ot}::${at++}`, ct = () => v.get("__ui:execute-use-global__", () => []);
+}({}), ot = 1, st = re(1e5, 999999), ct = () => `__execute_use${st}::${ot++}`, lt = () => v.get("__ui:execute-use-global__", () => []);
 function $(e, t = Q.provide) {
-	let n = st(), r, i = (t) => {
+	let n = ct(), r, i = (t) => {
 		let n = Object.freeze(e(...t));
 		return {
 			...n,
@@ -1064,41 +1072,56 @@ function $(e, t = Q.provide) {
 	}, s = (...e) => t === Q.provide ? de(n, void 0) || a(e) : (r || U.run(() => {
 		r = o(e);
 	}), r);
-	return t === Q.global && ct().push(s), s;
+	return t === Q.global && lt().push(s), s;
 }
-function lt(e) {
+function ut(e) {
 	return $(e, Q.global);
 }
-function ut(e) {
+function dt(e) {
 	return $(e, Q.provide);
 }
-function dt(e) {
+function ft(e) {
 	return $(e, Q.local);
 }
-function ft() {
-	ct().forEach((e) => e());
+function pt() {
+	lt().forEach((e) => e());
 }
 //#endregion
 //#region src/composables/ref/useMeta.ts
-var pt = dt(() => {
-	let e = h, t = P(e.getTitle()), n = P(e.getKeywords()), r = P(e.getDescription()), i = P(e.getImage()), a = P(e.getCanonical()), o = P(e.getRobots()), s = P(e.getAuthor()), c = P(e.getSiteName());
-	return I(t, () => {
-		e.setTitle(t.value);
-	}), I(n, () => {
-		e.setKeywords(n.value);
-	}), I(r, () => {
-		e.setDescription(r.value);
-	}), I(i, () => {
-		e.setImage(i.value);
-	}), I(a, () => {
-		e.setCanonical(a.value);
-	}), I(o, () => {
-		e.setRobots(o.value);
-	}), I(s, () => {
-		e.setAuthor(s.value);
-	}), I(c, () => {
-		e.setSiteName(c.value);
-	}), {
+var mt = ft(() => {
+	let e = h, t = P(e.getTitle()), n = P(e.getKeywords()), r = P(e.getDescription()), i = P(e.getImage()), a = P(e.getCanonical()), o = P(e.getRobots()), s = P(e.getAuthor()), c = P(e.getSiteName()), l = () => e.html(), u = (e) => {
+		t.value = e, x();
+	}, d = (e) => {
+		n.value = e, x();
+	}, f = (e) => {
+		r.value = e, x();
+	}, p = (e) => {
+		i.value = e, x();
+	}, m = (e) => {
+		a.value = e, x();
+	}, g = (e) => {
+		o.value = e, x();
+	}, _ = (e) => {
+		s.value = e, x();
+	}, v = (e) => {
+		c.value = e, x();
+	}, y = () => {
+		t.value = e.getTitle(), n.value = e.getKeywords(), r.value = e.getDescription(), i.value = e.getImage(), a.value = e.getCanonical(), o.value = e.getRobots(), s.value = e.getAuthor(), c.value = e.getSiteName();
+	}, b = () => {
+		e.setTitle(t.value), e.setKeywords(n.value), e.setDescription(r.value), e.setImage(i.value), e.setCanonical(a.value), e.setRobots(o.value), e.setAuthor(s.value), e.setSiteName(c.value);
+	}, x = () => {
+		E() || b();
+	};
+	return I([
+		t,
+		n,
+		r,
+		i,
+		a,
+		o,
+		s,
+		c
+	], () => b()), {
 		meta: e,
 		title: t,
 		keyword: n,
@@ -1108,10 +1131,21 @@ var pt = dt(() => {
 		canonical: a,
 		robots: o,
 		siteName: c,
-		getHtmlMeta: () => e.html(),
+		getHtmlMeta: l,
+		sync: y,
+		update: b,
+		updateSsr: x,
+		setTitle: u,
+		setKeywords: d,
+		setDescription: f,
+		setAuthor: _,
+		setImage: p,
+		setCanonical: m,
+		setRobots: g,
+		setSiteName: v,
 		setSuffix: (t) => e.setSuffix(t)
 	};
-}), mt = () => pt(), ht = (e, t, n = !0) => {
+}), ht = () => mt(), gt = (e, t, n = !0) => {
 	var r;
 	let i = N(t) ? t : P(t || ((r = e.value) == null || (r = r[0]) == null ? void 0 : r.value) || ""), a = () => o(i.value), o = (t) => {
 		var n;
@@ -1136,9 +1170,9 @@ var pt = dt(() => {
 			s((t = e.value) == null || (t = t[0]) == null ? void 0 : t.value);
 		}
 	};
-}, gt = () => v.get("__ui:session-ref__", () => ({}));
-function _t(e, t) {
-	let n = gt();
+}, _t = () => v.get("__ui:session-ref__", () => ({}));
+function vt(e, t) {
+	let n = _t();
 	if (e in n) return n[e];
 	let r = new i(e, !0), a = P(r.get(t));
 	return U.run(() => {
@@ -1147,9 +1181,9 @@ function _t(e, t) {
 }
 //#endregion
 //#region src/composables/ref/useStorageRef.ts
-var vt = () => v.get("__ui:storage-ref__", () => ({}));
-function yt(e, t, n) {
-	let r = vt();
+var yt = () => v.get("__ui:storage-ref__", () => ({}));
+function bt(e, t, n) {
+	let r = yt();
 	if (e in r) return r[e];
 	let a = new i(e), o = P(a.get(t, n));
 	return U.run(() => {
@@ -1160,7 +1194,7 @@ function yt(e, t, n) {
 }
 //#endregion
 //#region src/composables/ref/useTranslateRef.ts
-function bt(e, t = y.getItem()) {
+function xt(e, t = y.getItem()) {
 	let n = F(t.getListSync(e, !0)), r = async () => {
 		n.value = { ...await t.getList(e) };
 	};
@@ -1173,10 +1207,10 @@ function bt(e, t = y.getItem()) {
 	}
 	return n;
 }
-var xt = (e) => bt(e);
+var St = (e) => xt(e);
 //#endregion
 //#region src/functions/computedAsync.ts
-function St(e, t, n, r) {
+function Ct(e, t, n, r) {
 	let i = F(b(t)), a = !0, o = async () => {
 		let t = await x(e);
 		t !== n && (i.value = t);
@@ -1187,7 +1221,7 @@ function St(e, t, n, r) {
 }
 //#endregion
 //#region src/functions/computedByLanguage.ts
-function Ct(e, t = () => void 0, n, r) {
+function wt(e, t = () => void 0, n, r) {
 	return M(() => {
 		if (G.get().value && (n === void 0 || n())) {
 			let t = e();
@@ -1198,7 +1232,7 @@ function Ct(e, t = () => void 0, n, r) {
 }
 //#endregion
 //#region src/functions/computedEternity.ts
-function wt(e, t) {
+function Tt(e, t) {
 	return oe((n, r) => {
 		let i = F(b(t)), a = !1, o = async () => {
 			i.value = await x(e), r();
@@ -1219,17 +1253,17 @@ function wt(e, t) {
 }
 //#endregion
 //#region src/functions/dxtFunctionalPlugin.ts
-var Tt = { install(t, n = {}) {
-	if (n.api && e.setConfig(n.api), n.translate && y.setConfig(n.translate), n.icons && p.setConfig(n.icons), n.metaSuffix && mt().setSuffix(n.metaSuffix), n.router) q.set(n.router);
+var Et = { install(t, n = {}) {
+	if (n.api && e.setConfig(n.api), n.translate && y.setConfig(n.translate), n.icons && p.setConfig(n.icons), n.metaSuffix && ht().setSuffix(n.metaSuffix), n.router) q.set(n.router);
 	else {
 		let e = t.config.globalProperties.$router;
 		e && q.set(e);
 	}
-	n.errorCauses && o.addList(n.errorCauses), ft();
+	n.errorCauses && o.addList(n.errorCauses), pt();
 } };
 //#endregion
 //#region src/functions/getInject.ts
-function Et(e) {
+function Dt(e) {
 	if (ue()) {
 		let t = de(e);
 		if (t) return t;
@@ -1237,19 +1271,19 @@ function Et(e) {
 }
 //#endregion
 //#region src/functions/render/getBind.ts
-function Dt(e, t = {}, n = "value", r = !1) {
+function Ot(e, t = {}, n = "value", r = !1) {
 	let i = typeof t == "string", a = i ? t : n, o = i ? {} : t;
 	return e ? e && O(e) && (a in e || r) ? B(o, e) : B(o, { [a]: e }) : i ? {} : { ...o };
 }
 //#endregion
 //#region src/functions/ref/getBindRef.ts
-function Ot(e, t = {}, n = "value") {
-	return M(() => Dt(z(e), z(t), n));
+function kt(e, t = {}, n = "value") {
+	return M(() => Ot(z(e), z(t), n));
 }
 //#endregion
 //#region src/functions/ref/setRef.ts
-function kt(e, t) {
+function At(e, t) {
 	e.value !== t && (e.value = t);
 }
 //#endregion
-export { je as DatetimeRef, Ce as DesignAbstract, we as DesignAsyncAbstract, Se as DesignChanged, ke as DesignComp, V as DesignComponents, Ae as DesignConstructorAbstract, U as EffectScopeGlobal, Me as EventRef, Q as ExecuteUseType, Ne as GeoFlagRef, Pe as GeoIntlRef, G as GeoRef, Fe as ListDataRef, q as RouterItemRef, Ie as ScrollbarWidthRef, St as computedAsync, Ct as computedByLanguage, wt as computedEternity, Tt as dxtFunctionalPlugin, $ as executeUse, lt as executeUseGlobal, ft as executeUseGlobalInit, dt as executeUseLocal, ut as executeUseProvide, Dt as getBind, Ot as getBindRef, Te as getClassName, Ee as getIndexForRender, Et as getInject, J as getOptions, z as getRef, De as render, Le as setApiRefGlobalConditions, kt as setRef, xt as t, B as toBind, Oe as toBinds, H as toRefItem, Re as useApiAsyncRef, ze as useApiDelete, Be as useApiGet, Ke as useApiManagementRef, Ve as useApiPost, He as useApiPut, X as useApiRef, Z as useApiRequest, Je as useBroadcastValueRef, Xe as useCookieRef, Ue as useFormattersRef, Ze as useGeoIntlRef, $e as useHashRef, rt as useLazyItemByMarginRef, et as useLazyRef, it as useLoadingRef, mt as useMeta, ht as useRouterList, Ge as useSearchRef, We as useSearchValueRef, _t as useSessionRef, yt as useStorageRef, bt as useTranslateRef };
+export { je as DatetimeRef, Ce as DesignAbstract, we as DesignAsyncAbstract, Se as DesignChanged, ke as DesignComp, V as DesignComponents, Ae as DesignConstructorAbstract, U as EffectScopeGlobal, Me as EventRef, Q as ExecuteUseType, Ne as GeoFlagRef, Pe as GeoIntlRef, G as GeoRef, Fe as ListDataRef, q as RouterItemRef, Ie as ScrollbarWidthRef, Ct as computedAsync, wt as computedByLanguage, Tt as computedEternity, Et as dxtFunctionalPlugin, $ as executeUse, ut as executeUseGlobal, pt as executeUseGlobalInit, ft as executeUseLocal, dt as executeUseProvide, Ot as getBind, kt as getBindRef, Te as getClassName, Ee as getIndexForRender, Dt as getInject, J as getOptions, z as getRef, De as render, Le as setApiRefGlobalConditions, At as setRef, St as t, B as toBind, Oe as toBinds, H as toRefItem, Re as useApiAsyncRef, ze as useApiDelete, Be as useApiGet, qe as useApiManagementAsyncRef, Ke as useApiManagementRef, Ve as useApiPost, He as useApiPut, X as useApiRef, Z as useApiRequest, Ye as useBroadcastValueRef, Ze as useCookieRef, Ue as useFormattersRef, Qe as useGeoIntlRef, et as useHashRef, it as useLazyItemByMarginRef, tt as useLazyRef, at as useLoadingRef, ht as useMeta, gt as useRouterList, Ge as useSearchRef, We as useSearchValueRef, vt as useSessionRef, bt as useStorageRef, xt as useTranslateRef };

package/dist/types/apiTypes.d.ts

@@ -0,0 +1,66 @@
+import { ApiData, ApiDataValidation, ApiDefaultValue, ApiFetch, ApiMethodItem, SearchColumns, SearchItem, SearchOptions } from '@dxtmisha/functional-basic';
+import { RefOrNormal, RefType } from './refTypes';
+import { Ref } from 'vue';
+/** Options for api requests/ Опции для запросов api */
+export type ApiOptions = ApiMethodItem | RefOrNormal<ApiFetch>;
+/**
+ * Base type for API management values, either a single value or an array.
+ *
+ * Базовый тип для значений управления API: одиночное значение или массив.
+ */
+export type ApiManagementValue = ApiDefaultValue | ApiDefaultValue[];
+/**
+ * Configuration for the main GET request in API management.
+ *
+ * Конфигурация для основного GET-запроса в управлении API.
+ */
+export type ApiManagementGet<Return extends ApiManagementValue, Type extends ApiManagementValue = Return> = {
+    /** API endpoint path / Путь к API */
+    path?: RefOrNormal<string | undefined>;
+    /** Additional request options / Дополнительные опции запроса */
+    options?: ApiOptions;
+    /** Enable reactive updates when path or options change / Включить реактивные обновления при изменении пути или опций */
+    reactivity?: boolean;
+    /** Condition to trigger the request / Условие выполнения запроса */
+    conditions?: RefType<boolean>;
+    /** Custom transformation for the fetched data / Пользовательская трансформация полученных данных */
+    transformation?: (data: Type, isResponseContractValid?: ApiDataValidation) => ApiData<Return>;
+    /** Function to validate response data contract / Функция для проверки контракта данных ответа */
+    validateResponseContract?: (data: Type) => ApiDataValidation;
+    /** Validation function or class constructor for data / Функция валидации или конструктор класса для данных */
+    typeData?: ((data: Return) => boolean) | any;
+    /** Whether to clear data when the component is unmounted / Удалять ли данные при размонтировании компонента */
+    unmounted?: boolean;
+    /** Function to provide skeleton data during loading / Функция, предоставляющая данные-заглушки во время загрузки */
+    skeleton?: () => Return;
+};
+/**
+ * Configuration for client-side search across API data.
+ *
+ * Конфигурация для клиентского поиска по данным API.
+ */
+export type ApiManagementSearch<T extends SearchItem, K extends SearchColumns<T>> = {
+    /** List of columns to search through / Список столбцов для поиска */
+    columns: K;
+    /** Reactive search query / Реактивная строка поиска */
+    value?: Ref<string>;
+    /** Additional search algorithm options / Дополнительные опции алгоритма поиска */
+    options?: SearchOptions;
+};
+/**
+ * Configuration for mutation requests (POST, PUT, DELETE).
+ *
+ * Конфигурация для запросов мутации (POST, PUT, DELETE).
+ */
+export type ApiManagementRequest<T, Return extends ApiData<T> = ApiData<T>> = {
+    /** Target API endpoint path / Целевой путь к API */
+    path?: RefOrNormal<string | undefined>;
+    /** Action to perform after a successful request / Действие после успешного выполнения запроса */
+    action?: (data: Return | undefined) => Promise<void> | void;
+    /** Transformation before sending data / Трансформация перед отправкой данных */
+    transformation?: (data: T) => Return;
+    /** Whether to wrap the payload in a 'data' property / Обертывать ли полезную нагрузку в свойство 'data' */
+    toData?: boolean;
+    /** Additional mutation request options / Дополнительные опции запроса мутации */
+    options?: ApiOptions;
+};

package/dist/types/constructorTypes.d.ts

@@ -0,0 +1,126 @@
+import { Ref, PropType, ComputedRef } from 'vue';
+import { Undefined } from '@dxtmisha/functional-basic';
+import { RefOrNormal, RefType } from './refTypes';
+/** Generic record type for constructor items/ Дженерик тип записи для элементов конструктора */
+export type ConstrItem = Record<string, any>;
+/** Constructor value wrapper with optional value property/ Обертка значения конструктора с опциональным свойством value */
+export type ConstrValue<T = any> = {
+    /** Optional value of type T/ Опциональное значение типа T */
+    value?: T;
+};
+/** Generic record type for constructor components/ Дженерик тип записи для компонентов конструктора */
+export type ConstrComponent = Record<string, any>;
+/**
+ * Constructor component modification type with reactive or normal values/
+ * Тип модификации компонента конструктора с реактивными или обычными значениями
+ */
+export type ConstrComponentMod<P extends ConstrItem> = ConstrItem | {
+    [K in keyof P]?: RefOrNormal<P[K]>;
+};
+export type ConstrExpose<E extends Element, EXPOSE extends ConstrItem> = EXPOSE & {
+    elementHtml?: ComputedRef<E | undefined>;
+};
+/** Utility type to convert union types to intersection types/ Утилитарный тип для преобразования объединенных типов в пересеченные */
+export type UnionToIntersection<U> = (U extends any ? (k: U) => void : never) extends (k: infer I) => void ? I : never;
+/** Extract emit item type from constructor item/ Извлечение типа элемента emit из элемента конструктора */
+export type ConstrEmitItem<T extends ConstrItem> = T[keyof T];
+/**
+ * Constructor emit type with proper event handler signatures/
+ * Тип emit конструктора с правильными сигнатурами обработчиков событий
+ */
+export type ConstrEmit<T extends ConstrItem = ConstrItem> = UnionToIntersection<ConstrEmitItem<{
+    [K in keyof T]: (evt: K, ...args: T[K]) => void;
+}>>;
+/** Object type for CSS class names with boolean values/ Тип объекта для CSS классов с булевыми значениями */
+export type ConstrClassObject = Record<string, boolean | undefined>;
+/**
+ * Constructor class type supporting strings, arrays, and objects/
+ * Тип класса конструктора, поддерживающий строки, массивы и объекты
+ */
+export type ConstrClass = string | (string | ConstrClass | Undefined)[] | ConstrClassObject;
+/** Record type for mapping class names to class definitions/ Тип записи для сопоставления имен классов с определениями классов */
+export type ConstrClassList = Record<string, ConstrClass>;
+/** Constructor classes with required main class and additional class list/ Классы конструктора с обязательным основным классом и дополнительным списком классов */
+export type ConstrClasses = {
+    main: ConstrClass;
+} & ConstrClassList;
+/** Constructor style item type for individual style properties/ Тип элемента стиля конструктора для отдельных свойств стиля */
+export type ConstrStylesItem = string | null;
+/**
+ * Constructor styles type supporting objects and arrays of style definitions/
+ * Тип стилей конструктора, поддерживающий объекты и массивы определений стилей
+ */
+export type ConstrStyles = Record<string, ConstrStylesItem> | ConstrStyles[];
+/**
+ * Constructor options interface for component configuration/
+ * Интерфейс опций конструктора для конфигурации компонента
+ */
+export type ConstrOptions<COMP extends ConstrComponent, EMITS extends ConstrItem, P extends ConstrItem> = {
+    /** Optional components configuration/ Опциональная конфигурация компонентов */
+    components?: COMP;
+    /** Optional component modifications/ Опциональные модификации компонента */
+    compMod?: ConstrComponentMod<P>;
+    /** Optional emit handlers/ Опциональные обработчики emit */
+    emits?: ConstrEmit<EMITS>;
+    /** Optional reactive classes/ Опциональные реактивные классы */
+    classes?: RefType<ConstrClasses>;
+    /** Optional reactive styles/ Опциональные реактивные стили */
+    styles?: RefType<ConstrStyles>;
+};
+/**
+ * Constructor setup interface for component initialization/
+ * Интерфейс настройки конструктора для инициализации компонента
+ */
+export type ConstrSetup<E extends Element, CLASSES extends ConstrClasses, SETUP extends ConstrItem> = {
+    /** Component name/ Имя компонента */
+    name: string;
+    /** Reactive element reference/ Реактивная ссылка на элемент */
+    element: Ref<E | undefined>;
+    /** Reactive classes/ Реактивные классы */
+    classes: RefType<CLASSES>;
+    /** Reactive styles/ Реактивные стили */
+    styles: RefType<ConstrStyles>;
+} & SETUP;
+/** Constructor registration configuration/ Конфигурация регистрации конструктора */
+export type ConstrRegistration = {
+    /** Optional flag for registration/ Опциональный флаг для регистрации */
+    flag?: boolean;
+    /** Optional translation map/ Опциональная карта переводов */
+    translate?: Record<string, string>;
+};
+/**
+ * Constructor bind type for component binding with class and style support/
+ * Тип привязки конструктора для привязки компонента с поддержкой классов и стилей
+ */
+export type ConstrBind<T> = T & Record<string, any> & {
+    /** Optional key/ Опциональный ключ */
+    key?: string;
+    /** Optional CSS classes/ Опциональные CSS классы */
+    class?: ConstrClass;
+    /** Optional styles/ Опциональные стили */
+    style?: ConstrStyles;
+};
+/** Constructor prop item options for Vue prop definitions/ Опции элемента prop конструктора для определений Vue prop */
+export type ConstrPropItemOptions<T = any> = {
+    /** Vue prop type/ Тип Vue prop */
+    type?: PropType<T>;
+    /** Required flag/ Флаг обязательности */
+    required?: boolean;
+    /** Default value/ Значение по умолчанию */
+    default?: any;
+    /** Custom validator function/ Пользовательская функция валидации */
+    validator?(value: any, props: any): boolean;
+};
+/** Constructor prop item type with options or direct PropType/ Тип элемента prop конструктора с опциями или прямым PropType */
+export type ConstrPropItem<T = any> = ConstrPropItemOptions<T> | PropType<T>;
+/** Constructor props type for component prop definitions/ Тип props конструктора для определений props компонента */
+export type ConstrProps<P = Record<string, any>> = {
+    [K in keyof P]: ConstrPropItem<P[K]>;
+};
+/**
+ * Props for link handling/ Пропсы для обработки ссылок
+ */
+export type ConstrHrefProps = {
+    /** Hyperlink reference/ Гиперссылка */
+    href?: string;
+};

package/dist/types/listTypes.d.ts

@@ -0,0 +1,63 @@
+import { NumberOrString, NumberOrStringOrBoolean } from '@dxtmisha/functional-basic';
+import { ConstrBind } from './constructorTypes';
+/** Type of list item/ Тип элемента списка */
+export type ListType = 'item' | 'space' | 'line' | 'subtitle' | 'html' | 'menu' | 'menu-group' | 'group';
+/** Basic data structure for list item/ Базовая структура данных для элемента списка */
+export type ListDataBasic = {
+    /** Optional display label/ Опциональная отображаемая метка */
+    label?: NumberOrString;
+    /** Any value associated with the item/ Любое значение, связанное с элементом */
+    value?: any;
+    /** Search text for filtering/ Текст поиска для фильтрации */
+    search?: string;
+};
+/** Extended list item with type and index/ Расширенный элемент списка с типом и индексом */
+export type ListDataItem<Item extends ListDataBasic = ListDataBasic> = ConstrBind<Item & {
+    /** Parent item identifier/ Идентификатор родительского элемента */
+    parent?: string;
+    /** Type of list item/ Тип элемента списка */
+    type: ListType;
+    /** Unique item identifier/ Уникальный идентификатор элемента */
+    index: string;
+}>;
+/** Array of list data items/ Массив элементов данных списка */
+export type ListList<Item extends ListDataBasic = ListDataBasic> = ListDataItem<Item>[];
+/**
+ * List or record structure for list data/
+ * Структура списка или записи для данных списка
+ */
+export type ListRecord<Item extends ListDataBasic = ListDataBasic> = ListList<Item> | Record<string, any>;
+/**
+ * Extended list item with additional state properties/
+ * Расширенный элемент списка с дополнительными свойствами состояния
+ */
+export type ListDataFullItem<Item extends ListDataBasic = ListDataBasic> = ListDataItem<Item> & {
+    /** Whether the item has focus/ Имеет ли элемент фокус */
+    focus: boolean;
+    /** Highlighted text portion/ Выделенная часть текста */
+    highlight?: string;
+    /** Whether the item is selected/ Выбран ли элемент */
+    selected: boolean;
+    /** Whether the item is disabled/ Отключен ли элемент */
+    disabled?: boolean;
+};
+/**
+ * Array of extended list items with state/
+ * Массив расширенных элементов списка с состоянием
+ */
+export type ListDataFull<Item extends ListDataBasic = ListDataBasic> = ListDataFullItem<Item>[];
+/** Input item for list creation/ Входной элемент для создания списка */
+export type ListListInputItem<Item extends ListDataBasic = ListDataBasic> = ConstrBind<Item>;
+/**
+ * Various input formats for list creation/
+ * Различные форматы входных данных для создания списка
+ */
+export type ListListInput<Item extends ListDataBasic = ListDataBasic> = ListListInputItem<Item>[] | string[] | Record<string, ListListInputItem<Item>> | Record<string, string>;
+/** Single selected item identifier/ Идентификатор одного выбранного элемента */
+export type ListSelectedItem = NumberOrStringOrBoolean;
+/** Single or multiple selected items/ Один или несколько выбранных элементов */
+export type ListSelectedList = ListSelectedItem | ListSelectedItem[];
+/** Name of selected list item/ Название выбранного элемента списка */
+export type ListName = string | number | undefined;
+/** Array of list item names/ Массив названий выбранных элементов списка */
+export type ListNames = ListName[];

package/dist/types/refTypes.d.ts

@@ -0,0 +1,36 @@
+import { ComputedRef, Ref, VNode, VNodeArrayChildren } from 'vue';
+/**
+ * Union type for Vue reactive references (computed or ref)/
+ * Объединенный тип для Vue реактивных ссылок (computed или ref)
+ */
+export type RefType<T> = ComputedRef<T> | Ref<T>;
+/**
+ * Union type for Vue reactive references that can be undefined/
+ * Объединенный тип для Vue реактивных ссылок, которые могут быть undefined
+ */
+export type RefUndefined<T> = RefType<T | undefined>;
+/**
+ * Union type that can be either a Vue reactive reference or a normal value/
+ * Объединенный тип, который может быть либо Vue реактивной ссылкой, либо обычным значением
+ */
+export type RefOrNormal<T> = RefType<T> | T;
+/**
+ * Union type for Vue raw children content
+ * (strings, numbers, booleans, VNodes, arrays, functions)/
+ * Объединенный тип для Vue сырого содержимого дочерних элементов
+ * (строки, числа, булевы, VNode, массивы, функции)
+ */
+export type RawChildren = string | number | boolean | VNode | VNodeArrayChildren | (() => any);
+/**
+ * Type for Vue raw slots with optional stability flag/
+ * Тип для Vue сырых слотов с опциональным флагом стабильности
+ */
+export type RawSlots = {
+    /** Slot name mapping to unknown content/ Маппинг имени слота к неизвестному содержимому */
+    [name: string]: unknown;
+    /**
+     * Optional stability flag for performance optimization/
+     * Опциональный флаг стабильности для оптимизации производительности
+     */
+    $stable?: boolean;
+};