@harjs/react-ui 1.0.0

package/dist/libs/infrastructure/shared/DATE.js

@@ -0,0 +1,148 @@
+class DATE {
+    /**
+     * Formats a Date object into an ISO standard string format (YYYY-MM-DD).
+     *
+     * @param date - The Date object to format.
+     * @returns A string formatted as "YYYY-MM-DD".
+     *
+     * @example
+     * ```ts
+     * DateUtility.toYMD(new Date()); // "2026-06-23"
+     * ```
+     */
+    YMD = (date) => {
+        const year = date.getFullYear();
+        const month = String(date.getMonth() + 1).padStart(2, "0");
+        const day = String(date.getDate()).padStart(2, "0");
+        return `${year}-${month}-${day}`;
+    };
+    /**
+     * Formats a Date object into a localized European/Turkish string format (DD-MM-YYYY).
+     *
+     * @param date - The Date object to format.
+     * @returns A string formatted as "DD-MM-YYYY".
+     *
+     * @example
+     * ```ts
+     * DateUtility.toDMY(new Date()); // "23-06-2026"
+     * ```
+     */
+    DMY = (date) => {
+        const day = String(date.getDate()).padStart(2, "0");
+        const month = String(date.getMonth() + 1).padStart(2, "0");
+        const year = date.getFullYear();
+        return `${day}-${month}-${year}`;
+    };
+    /**
+     * Formats a Date object into a verbose text representation based on the requested locale.
+     *
+     * @param date - The Date object to format.
+     * @param lang - The language key (e.g., "tr", "en").
+     * @param useUTC - If true, enforces the formatting to target the UTC timezone.
+     * @returns A verbose localized date string (e.g., "23 Haziran 2026").
+     */
+    Verbose = (date, lang = "tr", useUTC = false) => {
+        return date.toLocaleDateString(this.GetLocaleFromLanguage(lang), {
+            day: "numeric",
+            month: "long",
+            year: "numeric",
+            ...(useUTC ? { timeZone: "UTC" } : {}),
+        });
+    };
+    /**
+     * Formats a Date object into a detailed localized date and time string.
+     *
+     * @param date - The Date object to format.
+     * @param lang - The language key (e.g., "tr", "en").
+     * @param useUTC - If true, enforces the formatting to target the UTC timezone.
+     * @returns A localized date-time string (e.g., "23 Haziran 2026 15:08").
+     */
+    VerboseWithTime = (date, lang = "tr", useUTC = false) => {
+        return date.toLocaleString(this.GetLocaleFromLanguage(lang), {
+            day: "numeric",
+            month: "long",
+            year: "numeric",
+            hour: "2-digit",
+            minute: "2-digit",
+            ...(useUTC ? { timeZone: "UTC" } : {}),
+        });
+    };
+    /**
+     * Formats a date into a relative human-readable string (e.g., "3 days ago", "just now").
+     * Extremely useful for social feeds, activity logs, or comment sections.
+     *
+     * @param date - The target Date object to evaluate.
+     * @param lang - The language key (currently supports "tr" and "en").
+     * @returns A relative time string.
+     */
+    RelativeTime = (date, lang = "tr") => {
+        const now = new Date();
+        const diffInSeconds = Math.floor((now.getTime() - date.getTime()) / 1000);
+        const locales = {
+            tr: { justNow: "az önce", seconds: "saniye önce", minutes: "dakika önce", hours: "saat önce", days: "gün önce" },
+            en: { justNow: "just now", seconds: "seconds ago", minutes: "minutes ago", hours: "hours ago", days: "days ago" },
+        };
+        const currentLocale = locales[lang] || locales.tr;
+        if (diffInSeconds < 5)
+            return currentLocale.justNow;
+        if (diffInSeconds < 60)
+            return `${diffInSeconds} ${currentLocale.seconds}`;
+        const diffInMinutes = Math.floor(diffInSeconds / 60);
+        if (diffInMinutes < 60)
+            return `${diffInMinutes} ${currentLocale.minutes}`;
+        const diffInHours = Math.floor(diffInMinutes / 60);
+        if (diffInHours < 24)
+            return `${diffInHours} ${currentLocale.hours}`;
+        const diffInDays = Math.floor(diffInHours / 24);
+        return `${diffInDays} ${currentLocale.days}`;
+    };
+    /**
+     * Safely checks whether a given string, number, or object can be parsed into a valid Date.
+     * Prevents runtime crashes from "Invalid Date" outputs.
+     *
+     * @param value - The input variable to validate.
+     * @returns `true` if the input is a valid date, otherwise `false`.
+     */
+    IsValid = (value) => {
+        if (value instanceof Date) {
+            return !isNaN(value.getTime());
+        }
+        if (typeof value === "string" || typeof value === "number") {
+            const parsed = new Date(value);
+            return !isNaN(parsed.getTime());
+        }
+        return false;
+    };
+    /**
+     * Compares two dates and checks if the first date is strictly before the second date.
+     */
+    IsBefore = (dateA, dateB) => {
+        return dateA.getTime() < dateB.getTime();
+    };
+    /**
+     * Compares two dates and checks if the first date is strictly after the second date.
+     */
+    IsAfter = (dateA, dateB) => {
+        return dateA.getTime() > dateB.getTime();
+    };
+    /**
+     * Map shorthand language identifiers to standard global BCP 47 locale codes.
+     */
+    GetLocaleFromLanguage = (lang) => {
+        const languageToLocaleMap = {
+            tr: "tr-TR",
+            en: "en-US",
+            fr: "fr-FR",
+            de: "de-DE",
+            es: "es-ES",
+            ja: "ja-JP",
+            ru: "ru-RU",
+            zh: "zh-CN",
+            hi: "hi-IN",
+            fa: "fa-IR",
+            ko: "ko-KR",
+        };
+        return languageToLocaleMap[lang] || lang;
+    };
+}
+export default DATE;

package/dist/libs/infrastructure/shared/Enums.d.ts

@@ -0,0 +1,18 @@
+export declare enum FilterOperator {
+    Contains = 1,
+    DoesNotContains = 2,
+    Equals = 3,
+    DoesNotEquals = 4,
+    BeginsWith = 5,
+    EndsWith = 6,
+    Blank = 7,
+    NotBlank = 8
+}
+export declare enum SessionStorage {
+    SelectedMenuItem = "selected-menu-item",
+    MenuIsLocked = "is-menu-locked"
+}
+export declare enum DispatchEvent {
+    SelectedMenuItem = "selectedMenuItem",
+    MenuLock = "menuLock"
+}

package/dist/libs/infrastructure/shared/Enums.js

@@ -0,0 +1,21 @@
+export var FilterOperator;
+(function (FilterOperator) {
+    FilterOperator[FilterOperator["Contains"] = 1] = "Contains";
+    FilterOperator[FilterOperator["DoesNotContains"] = 2] = "DoesNotContains";
+    FilterOperator[FilterOperator["Equals"] = 3] = "Equals";
+    FilterOperator[FilterOperator["DoesNotEquals"] = 4] = "DoesNotEquals";
+    FilterOperator[FilterOperator["BeginsWith"] = 5] = "BeginsWith";
+    FilterOperator[FilterOperator["EndsWith"] = 6] = "EndsWith";
+    FilterOperator[FilterOperator["Blank"] = 7] = "Blank";
+    FilterOperator[FilterOperator["NotBlank"] = 8] = "NotBlank";
+})(FilterOperator || (FilterOperator = {}));
+export var SessionStorage;
+(function (SessionStorage) {
+    SessionStorage["SelectedMenuItem"] = "selected-menu-item";
+    SessionStorage["MenuIsLocked"] = "is-menu-locked";
+})(SessionStorage || (SessionStorage = {}));
+export var DispatchEvent;
+(function (DispatchEvent) {
+    DispatchEvent["SelectedMenuItem"] = "selectedMenuItem";
+    DispatchEvent["MenuLock"] = "menuLock";
+})(DispatchEvent || (DispatchEvent = {}));

package/dist/libs/infrastructure/shared/NUMBER.d.ts

@@ -0,0 +1,8 @@
+declare class NUMBER {
+    Decimal: (locale: Intl.LocalesArgument, digits?: {
+        minimum?: number;
+        maximum?: number;
+    }) => Intl.NumberFormat;
+}
+declare const _default: NUMBER;
+export default _default;

package/dist/libs/infrastructure/shared/NUMBER.js

@@ -0,0 +1,10 @@
+class NUMBER {
+    Decimal = (locale, digits) => {
+        return new Intl.NumberFormat(locale, {
+            style: "decimal",
+            minimumFractionDigits: digits?.minimum ?? 0,
+            maximumFractionDigits: digits?.maximum ?? 2,
+        });
+    };
+}
+export default new NUMBER();

package/dist/libs/infrastructure/shared/PHONE.d.ts

@@ -0,0 +1,8 @@
+declare class PHONE {
+    FormatByMask: (countryCode: string, value: string) => string;
+    private GetMaskByCountry;
+    private GenerateMask;
+    private countryMasks;
+}
+declare const _default: PHONE;
+export default _default;

package/dist/libs/infrastructure/shared/PHONE.js

@@ -0,0 +1,126 @@
+class PHONE {
+    FormatByMask = (countryCode, value) => {
+        const digits = value.replace(/\D/g, "");
+        const mask = this.GetMaskByCountry(countryCode ?? "+90", digits.length);
+        let result = "";
+        let i = 0;
+        for (const char of mask) {
+            if (char === "9") {
+                if (!digits[i])
+                    break;
+                result += digits[i++];
+            }
+            else {
+                result += char;
+            }
+        }
+        return result;
+    };
+    GetMaskByCountry(countryCode, length) {
+        const masks = countryCode ? this.countryMasks[countryCode] : undefined;
+        if (masks && masks.length > 0) {
+            if (length) {
+                const exact = masks.find((m) => typeof m !== "string" && !!m.lengths?.includes(length));
+                if (exact)
+                    return exact.mask;
+                const generic = masks.find((m) => typeof m !== "string" && !m.lengths);
+                if (generic)
+                    return generic.mask;
+                const closest = masks
+                    .filter((m) => typeof m !== "string" && !!m.lengths)
+                    .sort((a, b) => Math.abs((a.lengths[0] ?? 0) - length) - Math.abs((b.lengths[0] ?? 0) - length))[0];
+                if (closest)
+                    return closest.mask;
+            }
+            const first = masks[0];
+            return typeof first === "string" ? first : first.mask;
+        }
+        return this.GenerateMask(length ?? 10);
+    }
+    GenerateMask(length) {
+        if (length <= 0)
+            return "";
+        const max = Math.min(length, 15); // E.164 max
+        const groups = max <= 10 ? [3, 3, max - 6] : [3, 3, 4, max - 10];
+        return groups
+            .filter((g) => g > 0)
+            .map((g) => "9".repeat(g))
+            .join(" ");
+    }
+    countryMasks = {
+        // 🇹🇷 Türkiye
+        "+90": [{ mask: "999 999 99 99", lengths: [10] }],
+        // 🇩🇪 Almanya
+        "+49": [
+            { mask: "999 9999999", lengths: [10] },
+            { mask: "9999 999999", lengths: [10, 11] },
+            { mask: "99999 99999", lengths: [10] },
+        ],
+        // 🇧🇷 Brezilya
+        "+55": [
+            { mask: "99 9999 9999", lengths: [10] }, // sabit
+            { mask: "99 99999 9999", lengths: [11] }, // mobil
+        ],
+        // 🇺🇸 ABD / 🇨🇦 Kanada
+        "+1": [{ mask: "999 999 9999", lengths: [10] }],
+        // 🇬🇧 İngiltere
+        "+44": [
+            { mask: "9999 999999", lengths: [10] }, // London / area
+            { mask: "99 9999 9999", lengths: [10] }, // mobile
+        ],
+        // 🇫🇷 Fransa
+        "+33": [{ mask: "9 99 99 99 99", lengths: [9] }],
+        // 🇮🇹 İtalya
+        "+39": [{ mask: "999 999 9999", lengths: [9, 10] }],
+        // 🇪🇸 İspanya
+        "+34": [{ mask: "999 999 999", lengths: [9] }],
+        // 🇳🇱 Hollanda
+        "+31": [{ mask: "9 99999999", lengths: [9] }],
+        // 🇧🇪 Belçika
+        "+32": [{ mask: "999 99 99 99", lengths: [9] }],
+        // 🇨🇭 İsviçre
+        "+41": [{ mask: "99 999 99 99", lengths: [9] }],
+        // 🇵🇹 Portekiz
+        "+351": [{ mask: "999 999 999", lengths: [9] }],
+        // 🇷🇺 Rusya / 🇰🇿 Kazakistan
+        "+7": [{ mask: "999 999 99 99", lengths: [10] }],
+        // 🇮🇳 Hindistan
+        "+91": [{ mask: "99999 99999", lengths: [10] }],
+        // 🇨🇳 Çin
+        "+86": [{ mask: "999 9999 9999", lengths: [11] }],
+        // 🇯🇵 Japonya
+        "+81": [{ mask: "99 9999 9999", lengths: [10] }],
+        // 🇰🇷 Güney Kore
+        "+82": [
+            { mask: "99 9999 9999", lengths: [10] },
+            { mask: "999 9999 9999", lengths: [11] },
+        ],
+        // 🇦🇺 Avustralya
+        "+61": [{ mask: "9 9999 9999", lengths: [9] }],
+        // 🇲🇽 Meksika
+        "+52": [{ mask: "999 999 9999", lengths: [10] }],
+        // 🇦🇷 Arjantin
+        "+54": [{ mask: "99 9999 9999", lengths: [10] }],
+        // 🇿🇦 Güney Afrika
+        "+27": [{ mask: "99 999 9999", lengths: [9] }],
+        // 🇦🇪 BAE
+        "+971": [{ mask: "99 999 9999", lengths: [9] }],
+        // 🇸🇦 Suudi Arabistan
+        "+966": [{ mask: "99 999 9999", lengths: [9] }],
+        // 🇮🇱 İsrail
+        "+972": [{ mask: "99 999 9999", lengths: [9] }],
+        // 🇪🇬 Mısır
+        "+20": [{ mask: "9999 999999", lengths: [10] }],
+        // 🇳🇬 Nijerya
+        "+234": [{ mask: "999 999 9999", lengths: [10] }],
+        // 🇸🇪 İsveç
+        "+46": [{ mask: "99 999 9999", lengths: [9, 10] }],
+        // 🇳🇴 Norveç
+        "+47": [{ mask: "999 99 999", lengths: [8] }],
+        // 🇩🇰 Danimarka
+        "+45": [{ mask: "99 99 99 99", lengths: [8] }],
+        // 🇵🇱 Polonya
+        "+48": [{ mask: "999 999 999", lengths: [9] }],
+    };
+}
+export default new PHONE();

package/dist/libs/infrastructure/shared/Utils.d.ts

@@ -0,0 +1,20 @@
+import { Border, Color, FileCategory, Icon, Icons, MimeTypes, Sizes, Status, Variants } from "../types";
+declare class Utils {
+    GetClassName: (variant?: Variants, status?: Status, color?: Color, border?: Border, size?: Sizes, icon?: Icon, className?: string) => string[];
+    GetCookie: (name: string) => string | null | undefined;
+    GetOS: () => "Windows" | "MacOS" | "UNIX" | "Linux" | "Android" | "iOS" | "Bilinmeyen OS";
+    GetOSShortCutIcons: () => "" | "⌘" | "ctrl";
+    GetFileTypeInformation: (mimeType: MimeTypes) => {
+        category: FileCategory;
+        readableType: string;
+        commonExtensions: string[];
+        icon?: Icons;
+        color?: string;
+    };
+    StringFormat: (value: string, ...args: any[]) => string;
+    IsNullOrEmpty: (value: unknown) => boolean;
+    DeepEqual: (obj1: any, obj2: any) => boolean;
+    RandomCharacterGenerator: (length: number) => string;
+}
+declare const _default: Utils;
+export default _default;