@herowcode/utils 1.0.1

package/README.md

@@ -0,0 +1,224 @@
+# @herowcode/utils
+
+A lightweight collection of utility functions for everyday JavaScript/TypeScript development. Built with dayjs for powerful date manipulation.
+
+## Features
+
+- 🚀 **Powered by dayjs** - Robust date manipulation with dayjs integration
+- 📦 **TypeScript support** - Full type definitions included  
+- 🧪 **Well tested** - Comprehensive test coverage
+- 📱 **Universal** - Works in Node.js and browsers
+- 🎯 **Tree-shakable** - Only import what you need
+- 📂 **Scoped exports** - Import from specific modules
+
+## Installation
+
+```bash
+npm install @herowcode/utils
+# or
+yarn add @herowcode/utils
+```
+
+## Usage
+
+### Import everything:
+```typescript
+import { formatDate, capitalize, debounce } from '@herowcode/utils';
+```
+
+### Import by scope:
+```typescript
+import { formatDate, addDays } from '@herowcode/utils/date';
+import { capitalize, camelCase } from '@herowcode/utils/string';
+import { randomInt } from '@herowcode/utils/number';
+import { debounce, throttle } from '@herowcode/utils/function';
+```
+
+### Examples:
+```typescript
+// Date formatting with dayjs power
+console.log(formatDate(new Date(), 'DD/MM/YYYY')); // "08/09/2025"
+console.log(formatDate('2023-12-25', 'MMMM Do, YYYY')); // "December 25th, 2023"
+
+// String utilities
+console.log(capitalize('hello world')); // "Hello world"
+console.log(camelCase('hello-world')); // "helloWorld"
+console.log(kebabCase('helloWorld')); // "hello-world"
+
+// Function utilities
+const debouncedFn = debounce(() => console.log('Called!'), 300);
+```
+
+## API Reference
+
+### Date Utilities
+
+#### `formatDate(date: Date, format: string): string`
+
+Formats a date according to the specified format.
+
+**Supported format tokens:**
+- `YYYY` - 4-digit year
+- `YY` - 2-digit year
+- `MM` - 2-digit month (01-12)
+- `DD` - 2-digit day (01-31)
+- `HH` - 2-digit hours (00-23)
+- `mm` - 2-digit minutes (00-59)
+- `ss` - 2-digit seconds (00-59)
+
+```typescript
+formatDate(new Date('2023-12-25'), 'YYYY-MM-DD'); // "2023-12-25"
+formatDate(new Date('2023-12-25'), 'DD/MM/YYYY'); // "25/12/2023"
+formatDate(new Date('2023-12-25T10:30:45'), 'DD/MM/YYYY HH:mm:ss'); // "25/12/2023 10:30:45"
+```
+
+#### `addDays(date: Date, amount: number): Date`
+
+Adds a specified number of days to a date. Returns a new Date object.
+
+```typescript
+const date = new Date('2023-12-25');
+addDays(date, 5); // 2023-12-30
+addDays(date, -5); // 2023-12-20
+```
+
+#### `diffInDays(date1: Date, date2: Date): number`
+
+Calculates the difference in days between two dates.
+
+```typescript
+const date1 = new Date('2023-12-30');
+const date2 = new Date('2023-12-25');
+diffInDays(date1, date2); // 5
+diffInDays(date2, date1); // -5
+```
+
+#### `isBefore(date1: Date, date2: Date): boolean`
+
+Checks if the first date is before the second date.
+
+```typescript
+const date1 = new Date('2023-12-20');
+const date2 = new Date('2023-12-25');
+isBefore(date1, date2); // true
+isBefore(date2, date1); // false
+```
+
+#### `isAfter(date1: Date, date2: Date): boolean`
+
+Checks if the first date is after the second date.
+
+```typescript
+const date1 = new Date('2023-12-30');
+const date2 = new Date('2023-12-25');
+isAfter(date1, date2); // true
+isAfter(date2, date1); // false
+```
+
+### String Utilities
+
+#### `capitalize(str: string): string`
+
+Capitalizes the first letter of a string and converts the rest to lowercase.
+
+```typescript
+capitalize('hello world'); // "Hello world"
+capitalize('HELLO WORLD'); // "Hello world"
+capitalize('hELLo WoRLd'); // "Hello world"
+```
+
+#### `camelCase(str: string): string`
+
+Converts a string to camelCase by removing special characters and capitalizing words.
+
+```typescript
+camelCase('hello world'); // "helloWorld"
+camelCase('hello-world'); // "helloWorld"
+camelCase('hello_world_test'); // "helloWorldTest"
+camelCase('The Quick Brown Fox'); // "theQuickBrownFox"
+```
+
+### Number Utilities
+
+#### `randomInt(min: number, max: number): number`
+
+Generates a random integer between min and max (inclusive).
+
+```typescript
+randomInt(1, 10); // Random integer between 1 and 10
+randomInt(0, 100); // Random integer between 0 and 100
+randomInt(-5, 5); // Random integer between -5 and 5
+```
+
+### Function Utilities
+
+#### `debounce<T>(fn: T, delay: number): T`
+
+Creates a debounced function that delays invoking `fn` until after `delay` milliseconds have elapsed since the last time it was invoked.
+
+```typescript
+const debouncedSearch = debounce((query: string) => {
+  console.log('Searching for:', query);
+}, 300);
+
+// Will only execute once after 300ms of no new calls
+debouncedSearch('a');
+debouncedSearch('ab');
+debouncedSearch('abc'); // Only this will execute
+```
+
+#### `throttle<T>(fn: T, delay: number): T`
+
+Creates a throttled function that only invokes `fn` at most once per every `delay` milliseconds.
+
+```typescript
+const throttledScroll = throttle(() => {
+  console.log('Scroll event handled');
+}, 100);
+
+// Will execute immediately, then at most once every 100ms
+window.addEventListener('scroll', throttledScroll);
+```
+
+## Browser Support
+
+This library supports all modern browsers and Node.js environments. It uses ES2018 features and requires:
+
+- Node.js 10+
+- Modern browsers (Chrome 63+, Firefox 58+, Safari 12+, Edge 79+)
+
+## Development
+
+```bash
+# Install dependencies
+npm install
+
+# Run tests
+npm test
+
+# Run tests in watch mode
+npm run test:watch
+
+# Build the library
+npm run build
+
+# Run tests with coverage
+npm run test:coverage
+```
+
+## License
+
+MIT © [HerowCode](https://github.com/herowcode)
+
+## Contributing
+
+Contributions are welcome! Please feel free to submit a Pull Request.
+
+## Changelog
+
+### 1.0.0
+- Initial release
+- Date utilities: `formatDate`, `addDays`, `diffInDays`, `isBefore`, `isAfter`
+- String utilities: `capitalize`, `camelCase`
+- Number utilities: `randomInt`
+- Function utilities: `debounce`, `throttle`

package/dist/array/index.d.ts

@@ -0,0 +1,3 @@
+export * from "./shuffle";
+export * from "./unique";
+//# sourceMappingURL=index.d.ts.map

package/dist/array/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/array/index.ts"],"names":[],"mappings":"AAAA,cAAc,WAAW,CAAA;AACzB,cAAc,UAAU,CAAA"}

package/dist/array/index.esm.js

@@ -0,0 +1,2 @@
+export * from "./shuffle";
+export * from "./unique";

package/dist/array/index.js

@@ -0,0 +1,2 @@
+export * from "./shuffle";
+export * from "./unique";

package/dist/array/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/array/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,4CAAyB;AACzB,2CAAwB"}

package/dist/array/shuffle.d.ts

@@ -0,0 +1,2 @@
+export declare function shuffle<T>(array: T[]): T[];
+//# sourceMappingURL=shuffle.d.ts.map

package/dist/array/shuffle.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"shuffle.d.ts","sourceRoot":"","sources":["../../src/array/shuffle.ts"],"names":[],"mappings":"AAAA,wBAAgB,OAAO,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,GAAG,CAAC,EAAE,CAc1C"}

package/dist/array/shuffle.esm.js

@@ -0,0 +1,12 @@
+export function shuffle(array) {
+    const shuffled = [...array];
+    for (let i = shuffled.length - 1; i > 0; i--) {
+        // Get cryptographically strong random values
+        const randomBuffer = new Uint32Array(1);
+        crypto.getRandomValues(randomBuffer);
+        // Use modulo to get a value in our range
+        const j = randomBuffer[0] % (i + 1);
+        [shuffled[i], shuffled[j]] = [shuffled[j], shuffled[i]];
+    }
+    return shuffled;
+}

package/dist/array/shuffle.js

@@ -0,0 +1,12 @@
+export function shuffle(array) {
+    const shuffled = [...array];
+    for (let i = shuffled.length - 1; i > 0; i--) {
+        // Get cryptographically strong random values
+        const randomBuffer = new Uint32Array(1);
+        crypto.getRandomValues(randomBuffer);
+        // Use modulo to get a value in our range
+        const j = randomBuffer[0] % (i + 1);
+        [shuffled[i], shuffled[j]] = [shuffled[j], shuffled[i]];
+    }
+    return shuffled;
+}

package/dist/array/shuffle.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"shuffle.js","sourceRoot":"","sources":["../../src/array/shuffle.ts"],"names":[],"mappings":";;AAAA,0BAcC;AAdD,SAAgB,OAAO,CAAI,KAAU;IACnC,MAAM,QAAQ,GAAG,CAAC,GAAG,KAAK,CAAC,CAAA;IAC3B,KAAK,IAAI,CAAC,GAAG,QAAQ,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC,GAAG,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC;QAC7C,6CAA6C;QAC7C,MAAM,YAAY,GAAG,IAAI,WAAW,CAAC,CAAC,CAAC,CAAA;QACvC,MAAM,CAAC,eAAe,CAAC,YAAY,CAAC,CAAA;QAEpC,yCAAyC;QACzC,MAAM,CAAC,GAAG,YAAY,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,CAGlC;QAAA,CAAC,QAAQ,CAAC,CAAC,CAAC,EAAE,QAAQ,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC,CAAC,EAAE,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAA;IAC1D,CAAC;IACD,OAAO,QAAQ,CAAA;AACjB,CAAC"}

package/dist/array/unique.d.ts

@@ -0,0 +1,2 @@
+export declare function unique<T>(array: T[]): T[];
+//# sourceMappingURL=unique.d.ts.map

package/dist/array/unique.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"unique.d.ts","sourceRoot":"","sources":["../../src/array/unique.ts"],"names":[],"mappings":"AAAA,wBAAgB,MAAM,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,GAAG,CAAC,EAAE,CAEzC"}

package/dist/array/unique.esm.js

@@ -0,0 +1,3 @@
+export function unique(array) {
+    return [...new Set(array)];
+}

package/dist/array/unique.js

@@ -0,0 +1,3 @@
+export function unique(array) {
+    return [...new Set(array)];
+}

package/dist/array/unique.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"unique.js","sourceRoot":"","sources":["../../src/array/unique.ts"],"names":[],"mappings":";;AAAA,wBAEC;AAFD,SAAgB,MAAM,CAAI,KAAU;IAClC,OAAO,CAAC,GAAG,IAAI,GAAG,CAAC,KAAK,CAAC,CAAC,CAAA;AAC5B,CAAC"}

package/dist/date/dayjs.d.ts

@@ -0,0 +1,3 @@
+import dayJs from "dayjs";
+export declare const dayjs: typeof dayJs;
+//# sourceMappingURL=dayjs.d.ts.map

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

@@ -0,0 +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"}

package/dist/date/dayjs.esm.js

@@ -0,0 +1,14 @@
+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";
+dayJs.extend(utc);
+dayJs.extend(customParseFormat);
+dayJs.extend(advancedFormat);
+dayJs.extend(timezone);
+dayJs.extend(localizedFormat);
+dayJs.extend(relativeTime);
+export const dayjs = dayJs;

package/dist/date/dayjs.js

@@ -0,0 +1,14 @@
+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";
+dayJs.extend(utc);
+dayJs.extend(customParseFormat);
+dayJs.extend(advancedFormat);
+dayJs.extend(timezone);
+dayJs.extend(localizedFormat);
+dayJs.extend(relativeTime);
+export const dayjs = dayJs;

package/dist/date/dayjs.js.map

@@ -0,0 +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"}

package/dist/date/fixTimezoneOffset.d.ts

@@ -0,0 +1,3 @@
+import type { Dayjs } from "dayjs";
+export declare function fixTimezoneOffset(utcDate: Date | string): Dayjs;
+//# sourceMappingURL=fixTimezoneOffset.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"fixTimezoneOffset.d.ts","sourceRoot":"","sources":["../../src/date/fixTimezoneOffset.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,OAAO,CAAA;AAIlC,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,IAAI,GAAG,MAAM,GAAG,KAAK,CAG/D"}

package/dist/date/fixTimezoneOffset.esm.js

@@ -0,0 +1,5 @@
+import { dayjs } from "./dayjs";
+export function fixTimezoneOffset(utcDate) {
+    const offset = new Date(utcDate).getTimezoneOffset();
+    return dayjs(utcDate).add(offset, "minute");
+}

package/dist/date/fixTimezoneOffset.js

@@ -0,0 +1,5 @@
+import { dayjs } from "./dayjs";
+export function fixTimezoneOffset(utcDate) {
+    const offset = new Date(utcDate).getTimezoneOffset();
+    return dayjs(utcDate).add(offset, "minute");
+}

package/dist/date/fixTimezoneOffset.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fixTimezoneOffset.js","sourceRoot":"","sources":["../../src/date/fixTimezoneOffset.ts"],"names":[],"mappings":";;AAIA,8CAGC;AALD,mCAA+B;AAE/B,SAAgB,iBAAiB,CAAC,OAAsB;IACtD,MAAM,MAAM,GAAG,IAAI,IAAI,CAAC,OAAO,CAAC,CAAC,iBAAiB,EAAE,CAAA;IACpD,OAAO,IAAA,aAAK,EAAC,OAAO,CAAC,CAAC,GAAG,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAA;AAC7C,CAAC"}

package/dist/date/formatDate.d.ts

@@ -0,0 +1,2 @@
+export declare function formatDate(date: Date | string | number, locale?: Intl.LocalesArgument, opts?: Intl.DateTimeFormatOptions): string;
+//# sourceMappingURL=formatDate.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"formatDate.d.ts","sourceRoot":"","sources":["../../src/date/formatDate.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"}

package/dist/date/formatDate.esm.js

@@ -0,0 +1,9 @@
+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));
+}

package/dist/date/formatDate.js

@@ -0,0 +1,9 @@
+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));
+}

package/dist/date/formatDate.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"formatDate.js","sourceRoot":"","sources":["../../src/date/formatDate.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"}

package/dist/date/getCurrentDateInUTC.d.ts

@@ -0,0 +1,3 @@
+import type { Dayjs } from "dayjs";
+export declare function getCurrentDateInUTC(): Dayjs;
+//# sourceMappingURL=getCurrentDateInUTC.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"getCurrentDateInUTC.d.ts","sourceRoot":"","sources":["../../src/date/getCurrentDateInUTC.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,OAAO,CAAA;AAIlC,wBAAgB,mBAAmB,IAAI,KAAK,CAE3C"}

package/dist/date/getCurrentDateInUTC.esm.js

@@ -0,0 +1,4 @@
+import { dayjs } from "./dayjs";
+export function getCurrentDateInUTC() {
+    return dayjs().utc();
+}

package/dist/date/getCurrentDateInUTC.js

@@ -0,0 +1,4 @@
+import { dayjs } from "./dayjs";
+export function getCurrentDateInUTC() {
+    return dayjs().utc();
+}

package/dist/date/getCurrentDateInUTC.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"getCurrentDateInUTC.js","sourceRoot":"","sources":["../../src/date/getCurrentDateInUTC.ts"],"names":[],"mappings":";;AAIA,kDAEC;AAJD,mCAA+B;AAE/B,SAAgB,mBAAmB;IACjC,OAAO,IAAA,aAAK,GAAE,CAAC,GAAG,EAAE,CAAA;AACtB,CAAC"}

package/dist/date/getDateInUTC.d.ts

@@ -0,0 +1,3 @@
+import type { Dayjs } from "dayjs";
+export declare function getDateInUTC(date: Date): Dayjs;
+//# sourceMappingURL=getDateInUTC.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"getDateInUTC.d.ts","sourceRoot":"","sources":["../../src/date/getDateInUTC.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,OAAO,CAAA;AAIlC,wBAAgB,YAAY,CAAC,IAAI,EAAE,IAAI,GAAG,KAAK,CAE9C"}

package/dist/date/getDateInUTC.esm.js

@@ -0,0 +1,4 @@
+import { dayjs } from "./dayjs";
+export function getDateInUTC(date) {
+    return dayjs(date).utc();
+}

package/dist/date/getDateInUTC.js

@@ -0,0 +1,4 @@
+import { dayjs } from "./dayjs";
+export function getDateInUTC(date) {
+    return dayjs(date).utc();
+}

package/dist/date/getDateInUTC.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"getDateInUTC.js","sourceRoot":"","sources":["../../src/date/getDateInUTC.ts"],"names":[],"mappings":";;AAIA,oCAEC;AAJD,mCAA+B;AAE/B,SAAgB,YAAY,CAAC,IAAU;IACrC,OAAO,IAAA,aAAK,EAAC,IAAI,CAAC,CAAC,GAAG,EAAE,CAAA;AAC1B,CAAC"}

package/dist/date/index.d.ts

@@ -0,0 +1,7 @@
+export * from "./dayjs";
+export * from "./fixTimezoneOffset";
+export * from "./formatDate";
+export * from "./getCurrentDateInUTC";
+export * from "./getDateInUTC";
+export * from "./parseTimeSpent";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/date/index.ts"],"names":[],"mappings":"AAAA,cAAc,SAAS,CAAA;AACvB,cAAc,qBAAqB,CAAA;AACnC,cAAc,cAAc,CAAA;AAC5B,cAAc,uBAAuB,CAAA;AACrC,cAAc,gBAAgB,CAAA;AAC9B,cAAc,kBAAkB,CAAA"}

package/dist/date/index.esm.js

@@ -0,0 +1,6 @@
+export * from "./dayjs";
+export * from "./fixTimezoneOffset";
+export * from "./formatDate";
+export * from "./getCurrentDateInUTC";
+export * from "./getDateInUTC";
+export * from "./parseTimeSpent";

package/dist/date/index.js

@@ -0,0 +1,6 @@
+export * from "./dayjs";
+export * from "./fixTimezoneOffset";
+export * from "./formatDate";
+export * from "./getCurrentDateInUTC";
+export * from "./getDateInUTC";
+export * from "./parseTimeSpent";

package/dist/date/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/date/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,0CAAuB;AACvB,sDAAmC;AACnC,+CAA4B;AAC5B,wDAAqC;AACrC,iDAA8B;AAC9B,mDAAgC"}

package/dist/date/parseTimeSpent.d.ts

@@ -0,0 +1,2 @@
+export declare function parseTimeSpent(initialDate: string | Date, finalDate: string | Date, locale?: string): string;
+//# sourceMappingURL=parseTimeSpent.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"parseTimeSpent.d.ts","sourceRoot":"","sources":["../../src/date/parseTimeSpent.ts"],"names":[],"mappings":"AA4DA,wBAAgB,cAAc,CAC5B,WAAW,EAAE,MAAM,GAAG,IAAI,EAC1B,SAAS,EAAE,MAAM,GAAG,IAAI,EACxB,MAAM,SAAU,UAsCjB"}

package/dist/date/parseTimeSpent.esm.js

@@ -0,0 +1,85 @@
+import { fixTimezoneOffset } from "./fixTimezoneOffset";
+// Supported locales and their translations
+const locales = {
+    "pt-BR": {
+        year: { singular: "ano", plural: "anos" },
+        month: { singular: "mês", plural: "meses" },
+        day: { singular: "dia", plural: "dias" },
+        formatList: (parts) => {
+            if (parts.length === 0)
+                return "";
+            if (parts.length === 1)
+                return parts[0];
+            const lastPart = parts[parts.length - 1];
+            const otherParts = parts.slice(0, -1);
+            return `${otherParts.join(", ")} e ${lastPart}`;
+        },
+    },
+    "en-US": {
+        year: { singular: "year", plural: "years" },
+        month: { singular: "month", plural: "months" },
+        day: { singular: "day", plural: "days" },
+        formatList: (parts) => {
+            if (parts.length === 0)
+                return "";
+            if (parts.length === 1)
+                return parts[0];
+            if (parts.length === 2)
+                return `${parts[0]} and ${parts[1]}`;
+            return `${parts.slice(0, -1).join(", ")}, and ${parts[parts.length - 1]}`;
+        },
+    },
+    "es-ES": {
+        year: { singular: "año", plural: "años" },
+        month: { singular: "mes", plural: "meses" },
+        day: { singular: "día", plural: "días" },
+        formatList: (parts) => {
+            if (parts.length === 0)
+                return "";
+            if (parts.length === 1)
+                return parts[0];
+            const lastPart = parts[parts.length - 1];
+            const otherParts = parts.slice(0, -1);
+            return `${otherParts.join(", ")} y ${lastPart}`;
+        },
+    },
+    "fr-FR": {
+        year: { singular: "an", plural: "ans" },
+        month: { singular: "mois", plural: "mois" },
+        day: { singular: "jour", plural: "jours" },
+        formatList: (parts) => {
+            if (parts.length === 0)
+                return "";
+            if (parts.length === 1)
+                return parts[0];
+            const lastPart = parts[parts.length - 1];
+            const otherParts = parts.slice(0, -1);
+            return `${otherParts.join(", ")} et ${lastPart}`;
+        },
+    },
+};
+export function parseTimeSpent(initialDate, finalDate, locale = "pt-BR") {
+    const final = fixTimezoneOffset(finalDate);
+    const initial = fixTimezoneOffset(initialDate);
+    const years = final.diff(initial, "year");
+    const months = final.diff(initial.add(years, "year"), "month");
+    const days = final.diff(initial.add(years, "year").add(months, "month"), "day");
+    // Use default locale if the requested one isn't supported
+    const translations = locales[locale] || locales["pt-BR"];
+    // Format each time unit
+    const parts = [];
+    if (years > 0) {
+        const unit = years === 1 ? translations.year.singular : translations.year.plural;
+        parts.push(`${years} ${unit}`);
+    }
+    if (months > 0) {
+        const unit = months === 1 ? translations.month.singular : translations.month.plural;
+        parts.push(`${months} ${unit}`);
+    }
+    if (days > 0) {
+        const unit = days === 1 ? translations.day.singular : translations.day.plural;
+        parts.push(`${days} ${unit}`);
+    }
+    // Format according to locale's list formatting rules
+    return translations.formatList(parts);
+}