@herowcode/utils 1.1.10 → 1.1.11

package/dist/cjs/date/dayjs.d.ts

@@ -1,3 +1,20 @@
 import dayJs from "dayjs";
+import "dayjs/locale/en";
+import "dayjs/locale/es";
+import "dayjs/locale/fr";
+import "dayjs/locale/pt-br";
+export interface IDayjsIntlConfig {
+    locale?: Intl.LocalesArgument;
+    options?: Intl.DateTimeFormatOptions;
+}
+export interface IDayjsIntlResolvedConfig {
+    locale: Intl.LocalesArgument;
+    options: Intl.DateTimeFormatOptions;
+}
+export declare function getDayjsGlobalIntl(): IDayjsIntlResolvedConfig;
+export declare function setDayjsGlobalIntl(config: IDayjsIntlConfig): IDayjsIntlResolvedConfig;
+export declare function resetDayjsGlobalIntl(): IDayjsIntlResolvedConfig;
+export declare function withDayjsGlobalIntl<T>(config: IDayjsIntlConfig, callback: () => T): T;
+export declare function resolveDayjsIntlConfig(config?: IDayjsIntlConfig): IDayjsIntlResolvedConfig;
 export declare const dayjs: typeof dayJs;
 //# sourceMappingURL=dayjs.d.ts.map

package/dist/cjs/date/dayjs.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"dayjs.d.ts","sourceRoot":"","sources":["../../../src/date/dayjs.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAA;AAezB,eAAO,MAAM,KAAK,cAAQ,CAAA"}
+{"version":3,"file":"dayjs.d.ts","sourceRoot":"","sources":["../../../src/date/dayjs.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,MAAM,OAAO,CAAA;AAOzB,OAAO,iBAAiB,CAAA;AACxB,OAAO,iBAAiB,CAAA;AACxB,OAAO,iBAAiB,CAAA;AACxB,OAAO,oBAAoB,CAAA;AAI3B,MAAM,WAAW,gBAAgB;IAC/B,MAAM,CAAC,EAAE,IAAI,CAAC,eAAe,CAAA;IAC7B,OAAO,CAAC,EAAE,IAAI,CAAC,qBAAqB,CAAA;CACrC;AAED,MAAM,WAAW,wBAAwB;IACvC,MAAM,EAAE,IAAI,CAAC,eAAe,CAAA;IAC5B,OAAO,EAAE,IAAI,CAAC,qBAAqB,CAAA;CACpC;AAuFD,wBAAgB,kBAAkB,IAAI,wBAAwB,CAK7D;AAED,wBAAgB,kBAAkB,CAChC,MAAM,EAAE,gBAAgB,GACvB,wBAAwB,CAG1B;AAED,wBAAgB,oBAAoB,IAAI,wBAAwB,CAM/D;AAED,wBAAgB,mBAAmB,CAAC,CAAC,EACnC,MAAM,EAAE,gBAAgB,EACxB,QAAQ,EAAE,MAAM,CAAC,GAChB,CAAC,CAYH;AAED,wBAAgB,sBAAsB,CACpC,MAAM,CAAC,EAAE,gBAAgB,GACxB,wBAAwB,CAE1B;AAUD,eAAO,MAAM,KAAK,cAAQ,CAAA"}

package/dist/cjs/date/dayjs.js

@@ -4,18 +4,121 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
 };
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.dayjs = void 0;
+exports.getDayjsGlobalIntl = getDayjsGlobalIntl;
+exports.setDayjsGlobalIntl = setDayjsGlobalIntl;
+exports.resetDayjsGlobalIntl = resetDayjsGlobalIntl;
+exports.withDayjsGlobalIntl = withDayjsGlobalIntl;
+exports.resolveDayjsIntlConfig = resolveDayjsIntlConfig;
 const dayjs_1 = __importDefault(require("dayjs"));
-const advancedFormat_js_1 = __importDefault(require("dayjs/plugin/advancedFormat.js"));
-const customParseFormat_js_1 = __importDefault(require("dayjs/plugin/customParseFormat.js"));
-const localizedFormat_js_1 = __importDefault(require("dayjs/plugin/localizedFormat.js"));
-const relativeTime_js_1 = __importDefault(require("dayjs/plugin/relativeTime.js"));
-const timezone_js_1 = __importDefault(require("dayjs/plugin/timezone.js"));
-const utc_js_1 = __importDefault(require("dayjs/plugin/utc.js"));
-dayjs_1.default.extend(utc_js_1.default);
-dayjs_1.default.extend(customParseFormat_js_1.default);
-dayjs_1.default.extend(advancedFormat_js_1.default);
-dayjs_1.default.extend(timezone_js_1.default);
-dayjs_1.default.extend(localizedFormat_js_1.default);
-dayjs_1.default.extend(relativeTime_js_1.default);
+const advancedFormat_1 = __importDefault(require("dayjs/plugin/advancedFormat"));
+const customParseFormat_1 = __importDefault(require("dayjs/plugin/customParseFormat"));
+const localizedFormat_1 = __importDefault(require("dayjs/plugin/localizedFormat"));
+const relativeTime_1 = __importDefault(require("dayjs/plugin/relativeTime"));
+const timezone_1 = __importDefault(require("dayjs/plugin/timezone"));
+const utc_1 = __importDefault(require("dayjs/plugin/utc"));
+require("dayjs/locale/en");
+require("dayjs/locale/es");
+require("dayjs/locale/fr");
+require("dayjs/locale/pt-br");
+const DEFAULT_INTL_CONFIG = {
+    locale: "pt-BR",
+    options: {
+        month: "long",
+        day: "numeric",
+        year: "numeric",
+    },
+};
+let globalIntlConfig = {
+    locale: DEFAULT_INTL_CONFIG.locale,
+    options: { ...DEFAULT_INTL_CONFIG.options },
+};
+function mergeIntlConfigs(base, override) {
+    var _a;
+    if (!override) {
+        return {
+            locale: base.locale,
+            options: { ...base.options },
+        };
+    }
+    const mergedLocale = (_a = override.locale) !== null && _a !== void 0 ? _a : base.locale;
+    const mergedOptions = { ...base.options };
+    if (override.options) {
+        for (const key of Object.keys(override.options)) {
+            const value = override.options[key];
+            if (value === undefined || value === null) {
+                delete mergedOptions[key];
+            }
+            else {
+                ;
+                mergedOptions[key] = value;
+            }
+        }
+    }
+    return {
+        locale: mergedLocale,
+        options: mergedOptions,
+    };
+}
+const intlPlugin = (pluginConfig, DayjsClass) => {
+    if (pluginConfig) {
+        globalIntlConfig = mergeIntlConfigs(globalIntlConfig, pluginConfig);
+    }
+    const formatIntl = function formatIntl(config) {
+        const resolved = mergeIntlConfigs(globalIntlConfig, config);
+        return new Intl.DateTimeFormat(resolved.locale, resolved.options).format(this.toDate());
+    };
+    const toIntlFormatter = function toIntlFormatter(config) {
+        const resolved = mergeIntlConfigs(globalIntlConfig, config);
+        return new Intl.DateTimeFormat(resolved.locale, resolved.options);
+    };
+    Object.defineProperty(DayjsClass.prototype, "formatIntl", {
+        value: formatIntl,
+        configurable: true,
+    });
+    Object.defineProperty(DayjsClass.prototype, "toIntlFormatter", {
+        value: toIntlFormatter,
+        configurable: true,
+    });
+};
+function getDayjsGlobalIntl() {
+    return {
+        locale: globalIntlConfig.locale,
+        options: { ...globalIntlConfig.options },
+    };
+}
+function setDayjsGlobalIntl(config) {
+    globalIntlConfig = mergeIntlConfigs(globalIntlConfig, config);
+    return getDayjsGlobalIntl();
+}
+function resetDayjsGlobalIntl() {
+    globalIntlConfig = {
+        locale: DEFAULT_INTL_CONFIG.locale,
+        options: { ...DEFAULT_INTL_CONFIG.options },
+    };
+    return getDayjsGlobalIntl();
+}
+function withDayjsGlobalIntl(config, callback) {
+    const previous = getDayjsGlobalIntl();
+    globalIntlConfig = mergeIntlConfigs(globalIntlConfig, config);
+    try {
+        return callback();
+    }
+    finally {
+        globalIntlConfig = {
+            locale: previous.locale,
+            options: { ...previous.options },
+        };
+    }
+}
+function resolveDayjsIntlConfig(config) {
+    return mergeIntlConfigs(globalIntlConfig, config);
+}
+dayjs_1.default.extend(utc_1.default);
+dayjs_1.default.extend(customParseFormat_1.default);
+dayjs_1.default.extend(advancedFormat_1.default);
+dayjs_1.default.extend(timezone_1.default);
+dayjs_1.default.extend(localizedFormat_1.default);
+dayjs_1.default.extend(relativeTime_1.default);
+dayjs_1.default.extend(intlPlugin);
 exports.dayjs = dayjs_1.default;
 //# sourceMappingURL=dayjs.js.map

package/dist/cjs/date/dayjs.js.map

@@ -1 +1 @@
-{"version":3,"file":"dayjs.js","sourceRoot":"","sources":["../../../src/date/dayjs.ts"],"names":[],"mappings":";;;;;;AAAA,kDAAyB;AACzB,uFAA2D;AAC3D,6FAAiE;AACjE,yFAA6D;AAC7D,mFAAuD;AACvD,2EAA+C;AAC/C,iEAAqC;AAErC,eAAK,CAAC,MAAM,CAAC,gBAAG,CAAC,CAAA;AACjB,eAAK,CAAC,MAAM,CAAC,8BAAiB,CAAC,CAAA;AAC/B,eAAK,CAAC,MAAM,CAAC,2BAAc,CAAC,CAAA;AAC5B,eAAK,CAAC,MAAM,CAAC,qBAAQ,CAAC,CAAA;AACtB,eAAK,CAAC,MAAM,CAAC,4BAAe,CAAC,CAAA;AAC7B,eAAK,CAAC,MAAM,CAAC,yBAAY,CAAC,CAAA;AAEb,QAAA,KAAK,GAAG,eAAK,CAAA"}
+{"version":3,"file":"dayjs.js","sourceRoot":"","sources":["../../../src/date/dayjs.ts"],"names":[],"mappings":"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"}

package/dist/cjs/date/format-date.d.ts

@@ -1,2 +1,23 @@
-export declare function formatDate(date: Date | string | number, locale?: Intl.LocalesArgument, opts?: Intl.DateTimeFormatOptions): string;
+import type { IDayjsIntlConfig } from "./dayjs";
+export interface IFormatDateConfig {
+    /** Optional locale override applied to the underlying dayjs instance */
+    locale?: string;
+    /**
+     * When provided, format using dayjs tokens (e.g. "DD/MM/YYYY").
+     * Unless `useIntl` is true, this takes precedence over Intl formatting.
+     */
+    format?: string;
+    /**
+     * Intl configuration used when formatting through `Intl.DateTimeFormat`.
+     * Values are merged on top of the global Intl configuration.
+     */
+    intl?: IDayjsIntlConfig;
+    /**
+     * Forces the use of Intl formatting even if a format string is supplied.
+     */
+    useIntl?: boolean;
+}
+type TLocaleOrConfig = Intl.LocalesArgument | IFormatDateConfig;
+export declare function formatDate(date: Date | string | number, localeOrConfig?: TLocaleOrConfig, opts?: Intl.DateTimeFormatOptions): string;
+export {};
 //# sourceMappingURL=format-date.d.ts.map

package/dist/cjs/date/format-date.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"format-date.d.ts","sourceRoot":"","sources":["../../../src/date/format-date.ts"],"names":[],"mappings":"AAAA,wBAAgB,UAAU,CACxB,IAAI,EAAE,IAAI,GAAG,MAAM,GAAG,MAAM,EAC5B,MAAM,GAAE,IAAI,CAAC,eAAyB,EACtC,IAAI,GAAE,IAAI,CAAC,qBAA0B,UAQtC"}
+{"version":3,"file":"format-date.d.ts","sourceRoot":"","sources":["../../../src/date/format-date.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,SAAS,CAAA;AAG/C,MAAM,WAAW,iBAAiB;IAChC,wEAAwE;IACxE,MAAM,CAAC,EAAE,MAAM,CAAA;IACf;;;OAGG;IACH,MAAM,CAAC,EAAE,MAAM,CAAA;IACf;;;OAGG;IACH,IAAI,CAAC,EAAE,gBAAgB,CAAA;IACvB;;OAEG;IACH,OAAO,CAAC,EAAE,OAAO,CAAA;CAClB;AAED,KAAK,eAAe,GAAG,IAAI,CAAC,eAAe,GAAG,iBAAiB,CAAA;AAqC/D,wBAAgB,UAAU,CACxB,IAAI,EAAE,IAAI,GAAG,MAAM,GAAG,MAAM,EAC5B,cAAc,GAAE,eAA6C,EAC7D,IAAI,CAAC,EAAE,IAAI,CAAC,qBAAqB,GAChC,MAAM,CAkDR"}

package/dist/cjs/date/format-date.js

@@ -1,13 +1,71 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.formatDate = formatDate;
-function formatDate(date, locale = "pt-BR", opts = {}) {
-    var _a, _b, _c;
-    return new Intl.DateTimeFormat(locale, {
-        month: (_a = opts.month) !== null && _a !== void 0 ? _a : "long",
-        day: (_b = opts.day) !== null && _b !== void 0 ? _b : "numeric",
-        year: (_c = opts.year) !== null && _c !== void 0 ? _c : "numeric",
-        ...opts,
-    }).format(new Date(date));
+const dayjs_1 = require("./dayjs");
+function isFormatDateConfig(value) {
+    return Boolean(value) && typeof value === "object" && !Array.isArray(value);
+}
+function isValidLocaleTag(value) {
+    if (typeof Intl !== "undefined" &&
+        typeof Intl.getCanonicalLocales === "function") {
+        try {
+            Intl.getCanonicalLocales(value);
+            return true;
+        }
+        catch (_a) {
+            return false;
+        }
+    }
+    return /^[a-z]{2,3}(?:-[A-Za-z0-9]{2,8})*$/.test(value);
+}
+function toDayjsLocale(locale) {
+    if (!locale)
+        return undefined;
+    const first = Array.isArray(locale)
+        ? locale[0]
+        : locale;
+    return typeof first === "string" ? first : String(first);
+}
+function formatDate(date, localeOrConfig = (0, dayjs_1.getDayjsGlobalIntl)().locale, opts) {
+    var _a;
+    const instance = (0, dayjs_1.dayjs)(date);
+    if (!instance.isValid()) {
+        throw new RangeError("Invalid time value");
+    }
+    if (isFormatDateConfig(localeOrConfig)) {
+        const { format, locale, intl, useIntl } = localeOrConfig;
+        const baseLocale = locale !== null && locale !== void 0 ? locale : toDayjsLocale(intl === null || intl === void 0 ? void 0 : intl.locale);
+        const workingInstance = baseLocale ? instance.locale(baseLocale) : instance;
+        if (format && !useIntl) {
+            return workingInstance.format(format);
+        }
+        const intlConfig = intl
+            ? {
+                locale: (_a = intl.locale) !== null && _a !== void 0 ? _a : baseLocale,
+                options: intl.options,
+            }
+            : baseLocale
+                ? {
+                    locale: baseLocale,
+                }
+                : undefined;
+        return workingInstance.formatIntl(intlConfig);
+    }
+    if (typeof localeOrConfig === "string" && opts === undefined) {
+        if (!isValidLocaleTag(localeOrConfig)) {
+            return instance.format(localeOrConfig);
+        }
+    }
+    const localeForDayjs = toDayjsLocale(localeOrConfig);
+    const workingInstance = localeForDayjs
+        ? instance.locale(localeForDayjs)
+        : instance;
+    const intlConfig = localeOrConfig !== undefined || opts !== undefined
+        ? {
+            locale: localeOrConfig,
+            options: opts,
+        }
+        : undefined;
+    return workingInstance.formatIntl(intlConfig);
 }
 //# sourceMappingURL=format-date.js.map

package/dist/cjs/date/format-date.js.map

@@ -1 +1 @@
-{"version":3,"file":"format-date.js","sourceRoot":"","sources":["../../../src/date/format-date.ts"],"names":[],"mappings":";;AAAA,gCAWC;AAXD,SAAgB,UAAU,CACxB,IAA4B,EAC5B,SAA+B,OAAO,EACtC,OAAmC,EAAE;;IAErC,OAAO,IAAI,IAAI,CAAC,cAAc,CAAC,MAAM,EAAE;QACrC,KAAK,EAAE,MAAA,IAAI,CAAC,KAAK,mCAAI,MAAM;QAC3B,GAAG,EAAE,MAAA,IAAI,CAAC,GAAG,mCAAI,SAAS;QAC1B,IAAI,EAAE,MAAA,IAAI,CAAC,IAAI,mCAAI,SAAS;QAC5B,GAAG,IAAI;KACR,CAAC,CAAC,MAAM,CAAC,IAAI,IAAI,CAAC,IAAI,CAAC,CAAC,CAAA;AAC3B,CAAC"}
+{"version":3,"file":"format-date.js","sourceRoot":"","sources":["../../../src/date/format-date.ts"],"names":[],"mappings":"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"}

package/dist/date/dayjs.d.ts

@@ -1,3 +1,20 @@
 import dayJs from "dayjs";
+import "dayjs/locale/en";
+import "dayjs/locale/es";
+import "dayjs/locale/fr";
+import "dayjs/locale/pt-br";
+export interface IDayjsIntlConfig {
+    locale?: Intl.LocalesArgument;
+    options?: Intl.DateTimeFormatOptions;
+}
+export interface IDayjsIntlResolvedConfig {
+    locale: Intl.LocalesArgument;
+    options: Intl.DateTimeFormatOptions;
+}
+export declare function getDayjsGlobalIntl(): IDayjsIntlResolvedConfig;
+export declare function setDayjsGlobalIntl(config: IDayjsIntlConfig): IDayjsIntlResolvedConfig;
+export declare function resetDayjsGlobalIntl(): IDayjsIntlResolvedConfig;
+export declare function withDayjsGlobalIntl<T>(config: IDayjsIntlConfig, callback: () => T): T;
+export declare function resolveDayjsIntlConfig(config?: IDayjsIntlConfig): IDayjsIntlResolvedConfig;
 export declare const dayjs: typeof dayJs;
 //# sourceMappingURL=dayjs.d.ts.map

package/dist/date/dayjs.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"dayjs.d.ts","sourceRoot":"","sources":["../../src/date/dayjs.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAA;AAezB,eAAO,MAAM,KAAK,cAAQ,CAAA"}
+{"version":3,"file":"dayjs.d.ts","sourceRoot":"","sources":["../../src/date/dayjs.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,MAAM,OAAO,CAAA;AAOzB,OAAO,iBAAiB,CAAA;AACxB,OAAO,iBAAiB,CAAA;AACxB,OAAO,iBAAiB,CAAA;AACxB,OAAO,oBAAoB,CAAA;AAI3B,MAAM,WAAW,gBAAgB;IAC/B,MAAM,CAAC,EAAE,IAAI,CAAC,eAAe,CAAA;IAC7B,OAAO,CAAC,EAAE,IAAI,CAAC,qBAAqB,CAAA;CACrC;AAED,MAAM,WAAW,wBAAwB;IACvC,MAAM,EAAE,IAAI,CAAC,eAAe,CAAA;IAC5B,OAAO,EAAE,IAAI,CAAC,qBAAqB,CAAA;CACpC;AAuFD,wBAAgB,kBAAkB,IAAI,wBAAwB,CAK7D;AAED,wBAAgB,kBAAkB,CAChC,MAAM,EAAE,gBAAgB,GACvB,wBAAwB,CAG1B;AAED,wBAAgB,oBAAoB,IAAI,wBAAwB,CAM/D;AAED,wBAAgB,mBAAmB,CAAC,CAAC,EACnC,MAAM,EAAE,gBAAgB,EACxB,QAAQ,EAAE,MAAM,CAAC,GAChB,CAAC,CAYH;AAED,wBAAgB,sBAAsB,CACpC,MAAM,CAAC,EAAE,gBAAgB,GACxB,wBAAwB,CAE1B;AAUD,eAAO,MAAM,KAAK,cAAQ,CAAA"}

package/dist/date/format-date.d.ts

@@ -1,2 +1,23 @@
-export declare function formatDate(date: Date | string | number, locale?: Intl.LocalesArgument, opts?: Intl.DateTimeFormatOptions): string;
+import type { IDayjsIntlConfig } from "./dayjs";
+export interface IFormatDateConfig {
+    /** Optional locale override applied to the underlying dayjs instance */
+    locale?: string;
+    /**
+     * When provided, format using dayjs tokens (e.g. "DD/MM/YYYY").
+     * Unless `useIntl` is true, this takes precedence over Intl formatting.
+     */
+    format?: string;
+    /**
+     * Intl configuration used when formatting through `Intl.DateTimeFormat`.
+     * Values are merged on top of the global Intl configuration.
+     */
+    intl?: IDayjsIntlConfig;
+    /**
+     * Forces the use of Intl formatting even if a format string is supplied.
+     */
+    useIntl?: boolean;
+}
+type TLocaleOrConfig = Intl.LocalesArgument | IFormatDateConfig;
+export declare function formatDate(date: Date | string | number, localeOrConfig?: TLocaleOrConfig, opts?: Intl.DateTimeFormatOptions): string;
+export {};
 //# sourceMappingURL=format-date.d.ts.map

package/dist/date/format-date.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"format-date.d.ts","sourceRoot":"","sources":["../../src/date/format-date.ts"],"names":[],"mappings":"AAAA,wBAAgB,UAAU,CACxB,IAAI,EAAE,IAAI,GAAG,MAAM,GAAG,MAAM,EAC5B,MAAM,GAAE,IAAI,CAAC,eAAyB,EACtC,IAAI,GAAE,IAAI,CAAC,qBAA0B,UAQtC"}
+{"version":3,"file":"format-date.d.ts","sourceRoot":"","sources":["../../src/date/format-date.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,SAAS,CAAA;AAG/C,MAAM,WAAW,iBAAiB;IAChC,wEAAwE;IACxE,MAAM,CAAC,EAAE,MAAM,CAAA;IACf;;;OAGG;IACH,MAAM,CAAC,EAAE,MAAM,CAAA;IACf;;;OAGG;IACH,IAAI,CAAC,EAAE,gBAAgB,CAAA;IACvB;;OAEG;IACH,OAAO,CAAC,EAAE,OAAO,CAAA;CAClB;AAED,KAAK,eAAe,GAAG,IAAI,CAAC,eAAe,GAAG,iBAAiB,CAAA;AAqC/D,wBAAgB,UAAU,CACxB,IAAI,EAAE,IAAI,GAAG,MAAM,GAAG,MAAM,EAC5B,cAAc,GAAE,eAA6C,EAC7D,IAAI,CAAC,EAAE,IAAI,CAAC,qBAAqB,GAChC,MAAM,CAkDR"}

package/dist/esm/date/dayjs.js

@@ -1,14 +1,112 @@
 import dayJs from "dayjs";
-import advancedFormat from "dayjs/plugin/advancedFormat.js";
-import customParseFormat from "dayjs/plugin/customParseFormat.js";
-import localizedFormat from "dayjs/plugin/localizedFormat.js";
-import relativeTime from "dayjs/plugin/relativeTime.js";
-import timezone from "dayjs/plugin/timezone.js";
-import utc from "dayjs/plugin/utc.js";
+import advancedFormat from "dayjs/plugin/advancedFormat";
+import customParseFormat from "dayjs/plugin/customParseFormat";
+import localizedFormat from "dayjs/plugin/localizedFormat";
+import relativeTime from "dayjs/plugin/relativeTime";
+import timezone from "dayjs/plugin/timezone";
+import utc from "dayjs/plugin/utc";
+import "dayjs/locale/en";
+import "dayjs/locale/es";
+import "dayjs/locale/fr";
+import "dayjs/locale/pt-br";
+const DEFAULT_INTL_CONFIG = {
+    locale: "pt-BR",
+    options: {
+        month: "long",
+        day: "numeric",
+        year: "numeric",
+    },
+};
+let globalIntlConfig = {
+    locale: DEFAULT_INTL_CONFIG.locale,
+    options: { ...DEFAULT_INTL_CONFIG.options },
+};
+function mergeIntlConfigs(base, override) {
+    var _a;
+    if (!override) {
+        return {
+            locale: base.locale,
+            options: { ...base.options },
+        };
+    }
+    const mergedLocale = (_a = override.locale) !== null && _a !== void 0 ? _a : base.locale;
+    const mergedOptions = { ...base.options };
+    if (override.options) {
+        for (const key of Object.keys(override.options)) {
+            const value = override.options[key];
+            if (value === undefined || value === null) {
+                delete mergedOptions[key];
+            }
+            else {
+                ;
+                mergedOptions[key] = value;
+            }
+        }
+    }
+    return {
+        locale: mergedLocale,
+        options: mergedOptions,
+    };
+}
+const intlPlugin = (pluginConfig, DayjsClass) => {
+    if (pluginConfig) {
+        globalIntlConfig = mergeIntlConfigs(globalIntlConfig, pluginConfig);
+    }
+    const formatIntl = function formatIntl(config) {
+        const resolved = mergeIntlConfigs(globalIntlConfig, config);
+        return new Intl.DateTimeFormat(resolved.locale, resolved.options).format(this.toDate());
+    };
+    const toIntlFormatter = function toIntlFormatter(config) {
+        const resolved = mergeIntlConfigs(globalIntlConfig, config);
+        return new Intl.DateTimeFormat(resolved.locale, resolved.options);
+    };
+    Object.defineProperty(DayjsClass.prototype, "formatIntl", {
+        value: formatIntl,
+        configurable: true,
+    });
+    Object.defineProperty(DayjsClass.prototype, "toIntlFormatter", {
+        value: toIntlFormatter,
+        configurable: true,
+    });
+};
+export function getDayjsGlobalIntl() {
+    return {
+        locale: globalIntlConfig.locale,
+        options: { ...globalIntlConfig.options },
+    };
+}
+export function setDayjsGlobalIntl(config) {
+    globalIntlConfig = mergeIntlConfigs(globalIntlConfig, config);
+    return getDayjsGlobalIntl();
+}
+export function resetDayjsGlobalIntl() {
+    globalIntlConfig = {
+        locale: DEFAULT_INTL_CONFIG.locale,
+        options: { ...DEFAULT_INTL_CONFIG.options },
+    };
+    return getDayjsGlobalIntl();
+}
+export function withDayjsGlobalIntl(config, callback) {
+    const previous = getDayjsGlobalIntl();
+    globalIntlConfig = mergeIntlConfigs(globalIntlConfig, config);
+    try {
+        return callback();
+    }
+    finally {
+        globalIntlConfig = {
+            locale: previous.locale,
+            options: { ...previous.options },
+        };
+    }
+}
+export function resolveDayjsIntlConfig(config) {
+    return mergeIntlConfigs(globalIntlConfig, config);
+}
 dayJs.extend(utc);
 dayJs.extend(customParseFormat);
 dayJs.extend(advancedFormat);
 dayJs.extend(timezone);
 dayJs.extend(localizedFormat);
 dayJs.extend(relativeTime);
+dayJs.extend(intlPlugin);
 export const dayjs = dayJs;

package/dist/esm/date/format-date.js

@@ -1,9 +1,67 @@
-export function formatDate(date, locale = "pt-BR", opts = {}) {
-    var _a, _b, _c;
-    return new Intl.DateTimeFormat(locale, {
-        month: (_a = opts.month) !== null && _a !== void 0 ? _a : "long",
-        day: (_b = opts.day) !== null && _b !== void 0 ? _b : "numeric",
-        year: (_c = opts.year) !== null && _c !== void 0 ? _c : "numeric",
-        ...opts,
-    }).format(new Date(date));
+import { dayjs, getDayjsGlobalIntl } from "./dayjs.js";
+function isFormatDateConfig(value) {
+    return Boolean(value) && typeof value === "object" && !Array.isArray(value);
+}
+function isValidLocaleTag(value) {
+    if (typeof Intl !== "undefined" &&
+        typeof Intl.getCanonicalLocales === "function") {
+        try {
+            Intl.getCanonicalLocales(value);
+            return true;
+        }
+        catch (_a) {
+            return false;
+        }
+    }
+    return /^[a-z]{2,3}(?:-[A-Za-z0-9]{2,8})*$/.test(value);
+}
+function toDayjsLocale(locale) {
+    if (!locale)
+        return undefined;
+    const first = Array.isArray(locale)
+        ? locale[0]
+        : locale;
+    return typeof first === "string" ? first : String(first);
+}
+export function formatDate(date, localeOrConfig = getDayjsGlobalIntl().locale, opts) {
+    var _a;
+    const instance = dayjs(date);
+    if (!instance.isValid()) {
+        throw new RangeError("Invalid time value");
+    }
+    if (isFormatDateConfig(localeOrConfig)) {
+        const { format, locale, intl, useIntl } = localeOrConfig;
+        const baseLocale = locale !== null && locale !== void 0 ? locale : toDayjsLocale(intl === null || intl === void 0 ? void 0 : intl.locale);
+        const workingInstance = baseLocale ? instance.locale(baseLocale) : instance;
+        if (format && !useIntl) {
+            return workingInstance.format(format);
+        }
+        const intlConfig = intl
+            ? {
+                locale: (_a = intl.locale) !== null && _a !== void 0 ? _a : baseLocale,
+                options: intl.options,
+            }
+            : baseLocale
+                ? {
+                    locale: baseLocale,
+                }
+                : undefined;
+        return workingInstance.formatIntl(intlConfig);
+    }
+    if (typeof localeOrConfig === "string" && opts === undefined) {
+        if (!isValidLocaleTag(localeOrConfig)) {
+            return instance.format(localeOrConfig);
+        }
+    }
+    const localeForDayjs = toDayjsLocale(localeOrConfig);
+    const workingInstance = localeForDayjs
+        ? instance.locale(localeForDayjs)
+        : instance;
+    const intlConfig = localeOrConfig !== undefined || opts !== undefined
+        ? {
+            locale: localeOrConfig,
+            options: opts,
+        }
+        : undefined;
+    return workingInstance.formatIntl(intlConfig);
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@herowcode/utils",
-  "version": "1.1.10",
+  "version": "1.1.11",
   "description": "A lightweight collection of utility functions for everyday JavaScript/TypeScript development",
   "main": "dist/cjs/index.js",
   "module": "dist/esm/index.js",