@dxtmisha/functional-basic 1.1.9 → 1.2.0

package/CHANGELOG.md

@@ -2,6 +2,16 @@
 
 All notable changes to this project will be documented in this file.
 
+## [1.2.0] - 2026-05-14
+
+### Added
+- **Functions**: Added `getFirst` utility function to safely retrieve the first element from arrays or objects, providing consistent behavior for various data structures with full TypeScript support.
+
+### Changed / Improved
+- **Dependencies**: Integrated `@dxtmisha/media` into `peerDependencies` to ensure better compatibility with media-related utilities.
+- **Build System**: Optimized the build configuration by simplifying export maps and standardizing type definition paths within the distribution.
+- **Maintenance**: Standardized internal scripts and performed general cleanup of obsolete type definitions and exported files.
+
 ## [1.1.8] - 2026-05-12
 
 ### Added

package/dist/library.js

@@ -4249,14 +4249,24 @@ function xn(e) {
 	Q || (Q = e);
 }
 //#endregion
-//#region src/functions/getKey.ts
+//#region src/functions/getFirst.ts
 function Sn(e) {
+	if (i(e)) return e == null ? void 0 : e[0];
+	if (t(e)) {
+		var n;
+		return (n = Object.values(e)) == null ? void 0 : n[0];
+	}
+	return e;
+}
+//#endregion
+//#region src/functions/getKey.ts
+function Cn(e) {
 	var t, n, r;
 	return (t = (n = e == null ? void 0 : e.key) == null ? e == null ? void 0 : e.code : n) == null ? e == null || (r = e.keyCode) == null ? void 0 : r.toString() : t;
 }
 //#endregion
 //#region src/functions/getLengthOfAllArray.ts
-function Cn(e) {
+function wn(e) {
 	return r(e, (e) => {
 		var t;
 		return (t = e == null ? void 0 : e.length) == null ? 0 : t;
@@ -4264,41 +4274,41 @@ function Cn(e) {
 }
 //#endregion
 //#region src/functions/getMaxLengthAllArray.ts
-function wn(e) {
+function Tn(e) {
 	if (!l(e)) return 0;
-	let t = Cn(e);
+	let t = wn(e);
 	return t.length > 1e4 ? t.reduce((e, t) => Math.max(e, t)) : Math.max(...t);
 }
 //#endregion
 //#region src/functions/getMinLengthAllArray.ts
-function Tn(e) {
+function En(e) {
 	if (!l(e)) return 0;
-	let t = Cn(e);
+	let t = wn(e);
 	return t.length > 1e4 ? t.reduce((e, t) => Math.min(e, t)) : Math.min(...t);
 }
 //#endregion
 //#region src/functions/getMouseClientX.ts
-function En(e) {
+function Dn(e) {
 	var t, n;
 	return (e == null ? void 0 : e.clientX) || (e == null || (t = e.targetTouches) == null || (t = t[0]) == null ? void 0 : t.clientX) || (e == null || (n = e.touches) == null || (n = n[0]) == null ? void 0 : n.clientX) || 0;
 }
 //#endregion
 //#region src/functions/getMouseClientY.ts
-function Dn(e) {
+function On(e) {
 	var t, n;
 	return (e == null ? void 0 : e.clientY) || (e == null || (t = e.targetTouches) == null || (t = t[0]) == null ? void 0 : t.clientY) || (e == null || (n = e.touches) == null || (n = n[0]) == null ? void 0 : n.clientY) || 0;
 }
 //#endregion
 //#region src/functions/getMouseClient.ts
-function On(e) {
+function kn(e) {
 	return {
-		x: En(e),
-		y: Dn(e)
+		x: Dn(e),
+		y: On(e)
 	};
 }
 //#endregion
 //#region src/functions/getObjectByKeys.ts
-function kn(e, t) {
+function An(e, t) {
 	let r = {};
 	return n(e) && t.forEach((t) => {
 		t in e && e[t] !== void 0 && (r[t] = e[t]);
@@ -4306,7 +4316,7 @@ function kn(e, t) {
 }
 //#endregion
 //#region src/functions/getObjectNoUndefined.ts
-function An(e, t = void 0) {
+function jn(e, t = void 0) {
 	let n = {};
 	return r(e, (e, r) => {
 		e !== t && (n[r] = e);
@@ -4314,42 +4324,42 @@ function An(e, t = void 0) {
 }
 //#endregion
 //#region src/functions/getObjectOrNone.ts
-function jn(e) {
+function Mn(e) {
 	return n(e) ? e : {};
 }
 //#endregion
 //#region src/functions/getOnlyText.ts
-function Mn(e) {
+function Nn(e) {
 	return F(e).replace(/[^\p{L}\p{N}\s]+/gu, "").trim();
 }
 //#endregion
 //#region src/functions/strFill.ts
-function Nn(e, t) {
+function Pn(e, t) {
 	return String(e).repeat(t);
 }
 //#endregion
 //#region src/functions/getRandomText.ts
-function Pn(e, t, n = "#", r = 2, i = 12) {
+function Fn(e, t, n = "#", r = 2, i = 12) {
 	let a = f(e, t), o = [];
-	for (let e = 0; e < a; e++) o.push(Nn(n, f(r, i)));
+	for (let e = 0; e < a; e++) o.push(Pn(n, f(r, i)));
 	return o.join(" ");
 }
 //#endregion
 //#region src/functions/getStepPercent.ts
-function Fn(e, t) {
+function In(e, t) {
 	let n = e == null ? 0 : e;
 	return t > n ? 100 / (t - n) : 0;
 }
 //#endregion
 //#region src/functions/getStepValue.ts
-function In(e, t) {
+function Ln(e, t) {
 	let n = e == null ? 0 : e;
 	return t > n ? (t - n) / 100 : 0;
 }
 //#endregion
 //#region src/functions/goScroll.ts
-var Ln = 0;
-function Rn(e, t, n) {
+var Rn = 0;
+function zn(e, t, n) {
 	if (!s()) return;
 	let r = t == null ? void 0 : t.closest(e);
 	if (t && r && r.scrollHeight !== r.offsetHeight) {
@@ -4357,12 +4367,12 @@ function Rn(e, t, n) {
 		if (n) {
 			let a = n.getBoundingClientRect();
 			r.scrollTop = t.offsetTop - (a.top - e.top) - (a.height / 2 - i.height / 2), r.scrollTop + r.offsetHeight < t.offsetTop + t.offsetHeight && (r.scrollTop = t.offsetTop + t.offsetHeight - r.offsetHeight);
-		} else r.scrollTop > t.offsetTop ? r.scrollTop = i.top - e.top - Ln : r.scrollTop + r.offsetHeight < t.offsetTop + t.offsetHeight && (r.scrollTop = i.top - e.top + i.height - e.height + Ln);
+		} else r.scrollTop > t.offsetTop ? r.scrollTop = i.top - e.top - Rn : r.scrollTop + r.offsetHeight < t.offsetTop + t.offsetHeight && (r.scrollTop = i.top - e.top + i.height - e.height + Rn);
 	}
 }
 //#endregion
 //#region src/functions/goScrollSmooth.ts
-function zn(e, t, n = 0) {
+function Bn(e, t, n = 0) {
 	if (!s()) return;
 	let r = (t == null ? void 0 : t.behavior) || "smooth";
 	if ("scrollIntoView" in e && !n) {
@@ -4384,7 +4394,7 @@ function zn(e, t, n = 0) {
 }
 //#endregion
 //#region src/functions/goScrollTo.ts
-function Bn(e, t, n = "smooth") {
+function Vn(e, t, n = "smooth") {
 	if (!s() || !e || !t) return;
 	let r = e.getBoundingClientRect(), i = t.getBoundingClientRect();
 	e.scrollBy({
@@ -4395,13 +4405,13 @@ function Bn(e, t, n = "smooth") {
 }
 //#endregion
 //#region src/functions/isShare.ts
-function Vn() {
+function Hn() {
 	return s() && typeof navigator < "u" && !!navigator.share;
 }
 //#endregion
 //#region src/functions/handleShare.ts
-async function Hn(e) {
-	if (Vn() && navigator.canShare && navigator.canShare(e)) try {
+async function Un(e) {
+	if (Hn() && navigator.canShare && navigator.canShare(e)) try {
 		return await navigator.share(e), !0;
 	} catch (e) {
 		w.on({
@@ -4414,12 +4424,12 @@ async function Hn(e) {
 }
 //#endregion
 //#region src/functions/inArray.ts
-function Un(e, t) {
+function Wn(e, t) {
 	return e.includes(t);
 }
 //#endregion
 //#region src/functions/initScrollbarOffset.ts
-async function Wn() {
+async function Gn() {
 	if (s()) {
 		let e = await Et.get();
 		document.body.style.setProperty("--sys-scrollbar-offset", `${e}px`);
@@ -4427,7 +4437,7 @@ async function Wn() {
 }
 //#endregion
 //#region src/functions/intersectKey.ts
-function Gn(e, n) {
+function Kn(e, n) {
 	let i = {};
 	return t(e) && t(n) && r(e, (e, t) => {
 		t in n && (i[t] = e);
@@ -4435,7 +4445,7 @@ function Gn(e, n) {
 }
 //#endregion
 //#region src/functions/isDifferent.ts
-function Kn(e, t) {
+function qn(e, t) {
 	let n = Object.keys(e).length !== Object.keys(t).length;
 	return n || r(e, (e, r) => {
 		e !== (t == null ? void 0 : t[r]) && (n = !0);
@@ -4443,7 +4453,7 @@ function Kn(e, t) {
 }
 //#endregion
 //#region src/functions/isElementVisible.ts
-function qn(e) {
+function Jn(e) {
 	if (!s()) return !1;
 	let t = k(e);
 	if (!t || "isConnected" in t && t.isConnected === !1) return !1;
@@ -4452,16 +4462,16 @@ function qn(e) {
 }
 //#endregion
 //#region src/functions/isInput.ts
-var Jn = (e) => {
+var Yn = (e) => {
 	if (e instanceof HTMLElement) {
 		let t = e.tagName.toLowerCase();
 		return !!(t === "input" || t === "textarea" || t === "select" || e.isContentEditable || e.getAttribute("contenteditable") === "true");
 	}
 	return !1;
-}, Yn = (e, t) => e.code === "Space" || e.code === "Enter" || e.key === " " || e.key === "Spacebar" || e.key === "Enter" || e.keyCode === 13 || e.keyCode === 32 ? t === void 0 ? !Jn(e.target) : !t : !1;
+}, Xn = (e, t) => e.code === "Space" || e.code === "Enter" || e.key === " " || e.key === "Spacebar" || e.key === "Enter" || e.keyCode === 13 || e.keyCode === 32 ? t === void 0 ? !Yn(e.target) : !t : !1;
 //#endregion
 //#region src/functions/isFloat.ts
-function Xn(e) {
+function Zn(e) {
 	switch (typeof e) {
 		case "number": return !0;
 		case "string": return /^-?\d+(\.\d+)?$/.test(e);
@@ -4470,18 +4480,18 @@ function Xn(e) {
 }
 //#endregion
 //#region src/functions/isIntegerBetween.ts
-function Zn(e, t) {
+function Qn(e, t) {
 	let n = Math.floor(t);
 	return e >= n && e < n + 1;
 }
 //#endregion
 //#region src/functions/isSelectedByList.ts
-function Qn(e, t) {
+function $n(e, t) {
 	return Array.isArray(e) ? e.every((e) => y(e, t)) : y(e, t);
 }
 //#endregion
 //#region src/functions/removeCommonPrefix.ts
-function $n(e, t) {
+function er(e, t) {
 	if (e.startsWith(t)) return e.slice(t.length).trim();
 	let n = 0;
 	for (; e[n] === t[n] && n < e.length && n < t.length;) n++;
@@ -4489,13 +4499,13 @@ function $n(e, t) {
 }
 //#endregion
 //#region src/functions/replaceComponentName.ts
-var er = (e, t, n) => {
+var tr = (e, t, n) => {
 	var r;
 	return e == null || (r = e.replace(RegExp(`<${t}`, "ig"), `<${n}`)) == null || (r = r.replace(RegExp(`</${t}`, "ig"), `</${n}`)) == null ? void 0 : r.trim();
 };
 //#endregion
 //#region src/functions/uniqueArray.ts
-function tr(e) {
+function nr(e) {
 	return [...new Set(e)];
 }
 //#endregion
@@ -4504,12 +4514,12 @@ function $(e, n, i = !0) {
 	let a = Z(e);
 	return t(e) && t(n) && r(n, (n, r) => {
 		let o = e == null ? void 0 : e[r];
-		t(o) && t(n) ? i && Array.isArray(o) && Array.isArray(n) ? a[r] = Z(tr([...o, ...n])) : a[r] = $(Array.isArray(o) ? { ...o } : o, n, i) : a[r] = t(n) ? Z(n) : n;
+		t(o) && t(n) ? i && Array.isArray(o) && Array.isArray(n) ? a[r] = Z(nr([...o, ...n])) : a[r] = $(Array.isArray(o) ? { ...o } : o, n, i) : a[r] = t(n) ? Z(n) : n;
 	}), a;
 }
 //#endregion
 //#region src/functions/replaceTemplate.ts
-function nr(e, t) {
+function rr(e, t) {
 	let n = e;
 	return r(t, (e, t) => {
 		n = n.replace(Pt(`[${t}]`), x(e));
@@ -4517,7 +4527,7 @@ function nr(e, t) {
 }
 //#endregion
 //#region src/functions/secondToTime.ts
-function rr(e, t) {
+function ir(e, t) {
 	let n = v(e);
 	if (n > 0) {
 		let e = String(Math.floor(n / 60)).padStart(2, "0"), r = String(n % 60).padStart(2, "0");
@@ -4527,7 +4537,7 @@ function rr(e, t) {
 }
 //#endregion
 //#region src/functions/setValues.ts
-function ir(e, t, { multiple: n = !1, maxlength: r = 0, alwaysChange: a = !0, notEmpty: o = !1 }) {
+function ar(e, t, { multiple: n = !1, maxlength: r = 0, alwaysChange: a = !0, notEmpty: o = !1 }) {
 	if (n) {
 		if (i(e)) {
 			let n = e.indexOf(t), i = [...e];
@@ -4539,7 +4549,7 @@ function ir(e, t, { multiple: n = !1, maxlength: r = 0, alwaysChange: a = !0, no
 }
 //#endregion
 //#region src/functions/splice.ts
-function ar(e, n, i) {
+function or(e, n, i) {
 	if (t(e) && t(n)) {
 		if (i) {
 			let a = {}, o = !1;
@@ -4553,34 +4563,34 @@ function ar(e, n, i) {
 }
 //#endregion
 //#region src/functions/toCamelCaseFirst.ts
-function or(e) {
+function sr(e) {
 	return H(e).replace(/^([a-z])/, (e) => `${e.toUpperCase()}`);
 }
 //#endregion
 //#region src/functions/toKebabCase.ts
-function sr(e) {
+function cr(e) {
 	return e.toString().trim().replace(/[^\w-. ]+/g, "").replace(/[ .]+/g, "-").replace(/(?<=[A-Z])([A-Z])/g, (e) => `${e.toLowerCase()}`).replace(/^[A-Z]/, (e) => e.toLowerCase()).replace(/(?<=[\w ])[A-Z]/g, (e) => `-${e.toLowerCase()}`).replace(/[A-Z]/g, (e) => e.toLowerCase());
 }
 //#endregion
 //#region src/functions/toNumberByMax.ts
-function cr(e, t, n, r) {
+function lr(e, t, n, r) {
 	let i = v(e), a = v(t);
-	return t && a < i ? `${lr(a, n, r)}+` : lr(i, n, r);
+	return t && a < i ? `${ur(a, n, r)}+` : ur(i, n, r);
 }
-var lr = (e, t, n) => t ? new R(n).number(e) : e;
+var ur = (e, t, n) => t ? new R(n).number(e) : e;
 //#endregion
 //#region src/functions/toPercent.ts
-function ur(e, t) {
+function dr(e, t) {
 	return e === 0 ? t : 1 / e * t;
 }
 //#endregion
 //#region src/functions/toPercentBy100.ts
-function dr(e, t) {
-	return ur(e, t) * 100;
+function fr(e, t) {
+	return dr(e, t) * 100;
 }
 //#endregion
 //#region src/functions/uint8ArrayToBase64.ts
-function fr(e) {
+function pr(e) {
 	let t = "";
 	for (let n of e) t += String.fromCharCode(n);
 	if (s()) return window.btoa(t);
@@ -4592,7 +4602,7 @@ function fr(e) {
 }
 //#endregion
 //#region src/functions/writeClipboardData.ts
-async function pr(e) {
+async function mr(e) {
 	if (s()) try {
 		await navigator.clipboard.writeText(e);
 	} catch (n) {
@@ -4601,4 +4611,4 @@ async function pr(e) {
 	}
 }
 //#endregion
-export { P as Api, M as ApiCache, Ae as ApiDataReturn, je as ApiDefault, Me as ApiHeaders, Pe as ApiHydration, ze as ApiInstance, N as ApiMethodItem, Fe as ApiPreparation, Re as ApiResponse, Oe as ApiStatus, Be as BroadcastMessage, Ue as Cache, He as CacheItem, We as CacheStatic, Qe as Cookie, Ye as CookieBlock, Je as CookieBlockInstance, I as CookieStorage, E as DataStorage, et as Datetime, w as ErrorCenter, ue as ErrorCenterHandler, de as ErrorCenterInstance, Ce as EventItem, tt as Formatters, U as FormattersType, nt as GEO_FLAG_ICON_NAME, D as Geo, rt as GeoFlag, be as GeoInstance, R as GeoIntl, it as GeoPhone, at as Global, st as Hash, ot as HashInstance, ut as Icons, j as Loading, Te as LoadingInstance, Ct as Meta, K as MetaManager, xt as MetaOg, vt as MetaOpenGraphAge, gt as MetaOpenGraphAvailability, _t as MetaOpenGraphCondition, yt as MetaOpenGraphGender, J as MetaOpenGraphTag, ht as MetaOpenGraphType, mt as MetaRobots, wt as MetaStatic, q as MetaTag, St as MetaTwitter, bt as MetaTwitterCard, Y as MetaTwitterTag, Tt as ResumableTimer, Et as ScrollbarWidth, zt as SearchList, Mt as SearchListData, Nt as SearchListItem, Lt as SearchListMatcher, Rt as SearchListOptions, T as ServerStorage, Vt as StorageCallback, Kt as TRANSLATE_GLOBAL_PREFIX, qt as TRANSLATE_TIME_OUT, Xt as Translate, Jt as TranslateFile, Yt as TranslateInstance, jt as addTagHighlightMatch, F as anyToString, Wt as applyTemplate, Zt as arrFill, nn as blobToBase64, rn as capitalize, Z as copyObject, an as copyObjectLite, W as createElement, on as domQuerySelector, sn as domQuerySelectorAll, G as encodeAttribute, oe as encodeLiteAttribute, dn as ensureMaxSize, X as escapeExp, fn as eventStopPropagation, x as executeFunction, Ie as executePromise, r as forEach, pn as frame, mn as getArrayHighlightMatch, hn as getAttributes, gn as getClipboardData, $e as getColumn, _n as getCurrentDate, vn as getCurrentTime, k as getElement, bn as getElementId, cn as getElementImage, dt as getElementItem, xe as getElementOrWindow, pe as getElementSafeScript, Ft as getExactSearchExp, Pt as getExp, me as getHydrationData, V as getItemByPath, Sn as getKey, Cn as getLengthOfAllArray, wn as getMaxLengthAllArray, Tn as getMinLengthAllArray, On as getMouseClient, En as getMouseClientX, Dn as getMouseClientY, kn as getObjectByKeys, An as getObjectNoUndefined, jn as getObjectOrNone, Mn as getOnlyText, Pn as getRandomText, o as getRequestString, It as getSearchExp, Dt as getSeparatingSearchExp, Fn as getStepPercent, In as getStepValue, Rn as goScroll, zn as goScrollSmooth, Bn as goScrollTo, Hn as handleShare, Un as inArray, xn as initGetElementId, Wn as initScrollbarOffset, Gn as intersectKey, Gt as isApiSuccess, i as isArray, Kn as isDifferent, se as isDomData, s as isDomRuntime, qn as isElementVisible, Yn as isEnter, l as isFilled, Xn as isFloat, b as isFunction, Se as isInDom, Jn as isInput, Zn as isIntegerBetween, c as isNull, m as isNumber, t as isObject, n as isObjectNotArray, u as isOnLine, y as isSelected, Qn as isSelectedByList, Vn as isShare, d as isString, O as isWindow, f as random, $n as removeCommonPrefix, er as replaceComponentName, $ as replaceRecursive, nr as replaceTemplate, un as resizeImageByMax, rr as secondToTime, ft as setElementItem, ir as setValues, ee as sleep, ar as splice, Nn as strFill, Ge as strSplit, A as toArray, H as toCamelCase, or as toCamelCaseFirst, L as toDate, sr as toKebabCase, v as toNumber, cr as toNumberByMax, ur as toPercent, dr as toPercentBy100, a as toString, Ke as transformation, fr as uint8ArrayToBase64, tr as uniqueArray, pr as writeClipboardData };
+export { P as Api, M as ApiCache, Ae as ApiDataReturn, je as ApiDefault, Me as ApiHeaders, Pe as ApiHydration, ze as ApiInstance, N as ApiMethodItem, Fe as ApiPreparation, Re as ApiResponse, Oe as ApiStatus, Be as BroadcastMessage, Ue as Cache, He as CacheItem, We as CacheStatic, Qe as Cookie, Ye as CookieBlock, Je as CookieBlockInstance, I as CookieStorage, E as DataStorage, et as Datetime, w as ErrorCenter, ue as ErrorCenterHandler, de as ErrorCenterInstance, Ce as EventItem, tt as Formatters, U as FormattersType, nt as GEO_FLAG_ICON_NAME, D as Geo, rt as GeoFlag, be as GeoInstance, R as GeoIntl, it as GeoPhone, at as Global, st as Hash, ot as HashInstance, ut as Icons, j as Loading, Te as LoadingInstance, Ct as Meta, K as MetaManager, xt as MetaOg, vt as MetaOpenGraphAge, gt as MetaOpenGraphAvailability, _t as MetaOpenGraphCondition, yt as MetaOpenGraphGender, J as MetaOpenGraphTag, ht as MetaOpenGraphType, mt as MetaRobots, wt as MetaStatic, q as MetaTag, St as MetaTwitter, bt as MetaTwitterCard, Y as MetaTwitterTag, Tt as ResumableTimer, Et as ScrollbarWidth, zt as SearchList, Mt as SearchListData, Nt as SearchListItem, Lt as SearchListMatcher, Rt as SearchListOptions, T as ServerStorage, Vt as StorageCallback, Kt as TRANSLATE_GLOBAL_PREFIX, qt as TRANSLATE_TIME_OUT, Xt as Translate, Jt as TranslateFile, Yt as TranslateInstance, jt as addTagHighlightMatch, F as anyToString, Wt as applyTemplate, Zt as arrFill, nn as blobToBase64, rn as capitalize, Z as copyObject, an as copyObjectLite, W as createElement, on as domQuerySelector, sn as domQuerySelectorAll, G as encodeAttribute, oe as encodeLiteAttribute, dn as ensureMaxSize, X as escapeExp, fn as eventStopPropagation, x as executeFunction, Ie as executePromise, r as forEach, pn as frame, mn as getArrayHighlightMatch, hn as getAttributes, gn as getClipboardData, $e as getColumn, _n as getCurrentDate, vn as getCurrentTime, k as getElement, bn as getElementId, cn as getElementImage, dt as getElementItem, xe as getElementOrWindow, pe as getElementSafeScript, Ft as getExactSearchExp, Pt as getExp, Sn as getFirst, me as getHydrationData, V as getItemByPath, Cn as getKey, wn as getLengthOfAllArray, Tn as getMaxLengthAllArray, En as getMinLengthAllArray, kn as getMouseClient, Dn as getMouseClientX, On as getMouseClientY, An as getObjectByKeys, jn as getObjectNoUndefined, Mn as getObjectOrNone, Nn as getOnlyText, Fn as getRandomText, o as getRequestString, It as getSearchExp, Dt as getSeparatingSearchExp, In as getStepPercent, Ln as getStepValue, zn as goScroll, Bn as goScrollSmooth, Vn as goScrollTo, Un as handleShare, Wn as inArray, xn as initGetElementId, Gn as initScrollbarOffset, Kn as intersectKey, Gt as isApiSuccess, i as isArray, qn as isDifferent, se as isDomData, s as isDomRuntime, Jn as isElementVisible, Xn as isEnter, l as isFilled, Zn as isFloat, b as isFunction, Se as isInDom, Yn as isInput, Qn as isIntegerBetween, c as isNull, m as isNumber, t as isObject, n as isObjectNotArray, u as isOnLine, y as isSelected, $n as isSelectedByList, Hn as isShare, d as isString, O as isWindow, f as random, er as removeCommonPrefix, tr as replaceComponentName, $ as replaceRecursive, rr as replaceTemplate, un as resizeImageByMax, ir as secondToTime, ft as setElementItem, ar as setValues, ee as sleep, or as splice, Pn as strFill, Ge as strSplit, A as toArray, H as toCamelCase, sr as toCamelCaseFirst, L as toDate, cr as toKebabCase, v as toNumber, lr as toNumberByMax, dr as toPercent, fr as toPercentBy100, a as toString, Ke as transformation, pr as uint8ArrayToBase64, nr as uniqueArray, mr as writeClipboardData };

package/dist/src/functions/getFirst.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Возвращает первый элемент массива или объекта
+ *
+ * Returns the first element of an array or object
+ * @param value Входное значение
+ * @returns Первый элемент массива или объекта
+ */
+export declare function getFirst<T>(value: T | T[] | Record<string, T>): T | undefined;

package/dist/src/library.d.ts

@@ -85,6 +85,7 @@ export * from './functions/getElementOrWindow';
 export * from './functions/getElementSafeScript';
 export * from './functions/getExactSearchExp';
 export * from './functions/getExp';
+export * from './functions/getFirst';
 export * from './functions/getHydrationData';
 export * from './functions/getItemByPath';
 export * from './functions/getKey';

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@dxtmisha/functional-basic",
   "private": false,
-  "version": "1.1.9",
+  "version": "1.2.0",
   "type": "module",
   "description": "Foundational utility library for modern web development — HTTP client, geolocation, i18n, SEO meta tags, caching, storage, DOM utilities, and more. Framework-agnostic, zero dependencies, TypeScript-first.",
   "keywords": [
@@ -75,8 +75,7 @@
     ".": {
       "import": "./dist/library.js",
       "types": "./dist/src/library.d.ts"
-    },
-    "./types/*": "./dist/src/*"
+    }
   },
   "engines": {
     "node": ">=20.0.0"