@herowcode/utils 1.0.1 → 1.1.0

package/README.md

@@ -51,133 +51,162 @@ const debouncedFn = debounce(() => console.log('Called!'), 300);
 
 ## API Reference
 
+### Array Utilities
+
+#### `shuffle<T>(array: T[]): T[]`
+Returns a new array with the elements shuffled in random order.
+
+```typescript
+shuffle([1, 2, 3, 4]); // e.g., [3, 1, 4, 2]
+```
+
+#### `unique<T>(array: T[]): T[]`
+Removes duplicate values from an array, preserving the first occurrence.
+
+```typescript
+unique([1, 2, 2, 3, 1]); // [1, 2, 3]
+```
+
 ### Date Utilities
 
-#### `formatDate(date: Date, format: string): string`
+#### `formatDate(date: Date | string | number, locale?: string, opts?: Intl.DateTimeFormatOptions): string`
+Formats a date using the specified locale and options.
+
+```typescript
+formatDate(new Date('2023-12-25'), 'en-US'); // "December 25, 2023"
+```
+
+#### `fixTimezoneOffset(utcDate: Date | string): Dayjs`
+Adjusts a UTC date string or Date object for the local timezone offset.
 
-Formats a date according to the specified format.
+```typescript
+fixTimezoneOffset('2025-09-08T12:00:00Z');
+```
 
-**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)
+#### `getCurrentDateInUTC(): Dayjs`
+Returns the current date/time as a Dayjs object in UTC.
 
 ```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"
+getCurrentDateInUTC();
 ```
 
-#### `addDays(date: Date, amount: number): Date`
+#### `getDateInUTC(date: Date): Dayjs`
+Converts a Date to a Dayjs object in UTC.
 
-Adds a specified number of days to a date. Returns a new Date object.
+```typescript
+getDateInUTC(new Date());
+```
+
+#### `parseTimeSpent(initialDate: string | Date, finalDate: string | Date, locale?: string): string`
+Returns a human-readable string describing the time difference between two dates, localized.
 
 ```typescript
-const date = new Date('2023-12-25');
-addDays(date, 5); // 2023-12-30
-addDays(date, -5); // 2023-12-20
+parseTimeSpent('2020-01-01', '2022-04-16', 'en-US'); // "2 years, 3 months, and 15 days"
 ```
 
-#### `diffInDays(date1: Date, date2: Date): number`
+### Files Utilities
 
-Calculates the difference in days between two dates.
+#### `compressImage({ file, maxWidth, maxHeight, quality, allowedFileTypes }): Promise<File>`
+Compresses an image file to WebP format, optionally resizing and restricting file types.
 
 ```typescript
-const date1 = new Date('2023-12-30');
-const date2 = new Date('2023-12-25');
-diffInDays(date1, date2); // 5
-diffInDays(date2, date1); // -5
+await compressImage({ file, maxWidth: 800, maxHeight: 600, quality: 0.8 });
 ```
 
-#### `isBefore(date1: Date, date2: Date): boolean`
+#### `downloadUrl(url: string): Promise<boolean>`
+Downloads a file from a URL in the browser, returning true if successful.
 
-Checks if the first date is before the second date.
+```typescript
+await downloadUrl('https://example.com/file.pdf');
+```
+
+#### `formatBytes(bytes: number): string`
+Formats a byte count as a human-readable string (e.g., "1.23 MB").
 
 ```typescript
-const date1 = new Date('2023-12-20');
-const date2 = new Date('2023-12-25');
-isBefore(date1, date2); // true
-isBefore(date2, date1); // false
+formatBytes(1234567); // "1.18 MB"
 ```
 
-#### `isAfter(date1: Date, date2: Date): boolean`
+### Function Utilities
 
-Checks if the first date is after the second date.
+#### `debounce<T>(fn: T, delay: number): (...args: Parameters<T>) => void`
+Creates a debounced function that delays invoking `fn` until after `delay` ms have elapsed since the last call.
 
 ```typescript
-const date1 = new Date('2023-12-30');
-const date2 = new Date('2023-12-25');
-isAfter(date1, date2); // true
-isAfter(date2, date1); // false
+const debounced = debounce(() => { /* ... */ }, 300);
 ```
 
-### String Utilities
+#### `throttle<T>(fn: T, delay: number): (...args: Parameters<T>) => void`
+Creates a throttled function that only invokes `fn` at most once per `delay` ms.
 
-#### `capitalize(str: string): string`
+```typescript
+const throttled = throttle(() => { /* ... */ }, 100);
+```
 
-Capitalizes the first letter of a string and converts the rest to lowercase.
+#### `tryCatch<T, E = Error, D = null>(fn: Promise<T> | (() => Promise<T> | T), defaultData?: D): Promise<{ data: T | D; error: E | null }>`
+Executes a function or promise and returns an object with `data` or `error`.
 
 ```typescript
-capitalize('hello world'); // "Hello world"
-capitalize('HELLO WORLD'); // "Hello world"
-capitalize('hELLo WoRLd'); // "Hello world"
+const result = await tryCatch(() => fetchData());
+if (result.error) { /* handle error */ }
 ```
 
-#### `camelCase(str: string): string`
+### String Utilities
 
-Converts a string to camelCase by removing special characters and capitalizing words.
+#### `camelCase(str: string): string`
+Converts a string to camelCase.
 
 ```typescript
 camelCase('hello world'); // "helloWorld"
-camelCase('hello-world'); // "helloWorld"
-camelCase('hello_world_test'); // "helloWorldTest"
-camelCase('The Quick Brown Fox'); // "theQuickBrownFox"
 ```
 
-### Number Utilities
+#### `capitalize(str: string): string`
+Capitalizes the first letter and lowercases the rest.
 
-#### `randomInt(min: number, max: number): number`
+```typescript
+capitalize('hELLO'); // "Hello"
+```
 
-Generates a random integer between min and max (inclusive).
+#### `kebabCase(str: string): string`
+Converts a string to kebab-case.
 
 ```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
+kebabCase('Hello World'); // "hello-world"
 ```
 
-### Function Utilities
+#### `removeHtmlTags(input: string): string`
+Removes all HTML tags from a string.
 
-#### `debounce<T>(fn: T, delay: number): T`
+```typescript
+removeHtmlTags('<p>Hello</p>'); // "Hello"
+```
 
-Creates a debounced function that delays invoking `fn` until after `delay` milliseconds have elapsed since the last time it was invoked.
+#### `slugify(text: string): string`
+Converts a string to a URL-friendly slug.
 
 ```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
+slugify('Hello World!'); // "hello-world"
 ```
 
-#### `throttle<T>(fn: T, delay: number): T`
+#### `snakeCase(str: string): string`
+Converts a string to snake_case.
+
+```typescript
+snakeCase('Hello World'); // "hello_world"
+```
 
-Creates a throttled function that only invokes `fn` at most once per every `delay` milliseconds.
+#### `toSentenceCase(str: string): string`
+Converts a string to sentence case.
 
 ```typescript
-const throttledScroll = throttle(() => {
-  console.log('Scroll event handled');
-}, 100);
+toSentenceCase('helloWorld'); // "Hello world"
+```
+
+#### `truncate(str: string, length: number, suffix = "..."): string`
+Truncates a string to a specified length, appending a suffix if truncated.
 
-// Will execute immediately, then at most once every 100ms
-window.addEventListener('scroll', throttledScroll);
+```typescript
+truncate('Hello world', 5); // "He..."
 ```
 
 ## Browser Support
@@ -212,13 +241,4 @@ 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`
+Contributions are welcome! Please feel free to submit a Pull Request.

package/dist/date/{fixTimezoneOffset.d.ts → fix-timezone-offset.d.ts}

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

package/dist/date/fix-timezone-offset.d.ts.map

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

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

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

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

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

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

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

package/dist/date/{getCurrentDateInUTC.d.ts → get-current-date-in-utc.d.ts}

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

package/dist/date/get-current-date-in-utc.d.ts.map

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

package/dist/date/get-current-date-in-utc.js.map

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

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

package/dist/date/get-date-in-utc.d.ts.map

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

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

@@ -1,7 +1,7 @@
 export * from "./dayjs";
-export * from "./fixTimezoneOffset";
-export * from "./formatDate";
-export * from "./getCurrentDateInUTC";
-export * from "./getDateInUTC";
-export * from "./parseTimeSpent";
+export * from "./fix-timezone-offset";
+export * from "./format-date";
+export * from "./get-current-date-in-utc";
+export * from "./get-date-in-utc";
+export * from "./parse-time-spent";
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +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"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/date/index.ts"],"names":[],"mappings":"AAAA,cAAc,SAAS,CAAA;AACvB,cAAc,uBAAuB,CAAA;AACrC,cAAc,eAAe,CAAA;AAC7B,cAAc,2BAA2B,CAAA;AACzC,cAAc,mBAAmB,CAAA;AACjC,cAAc,oBAAoB,CAAA"}

package/dist/date/index.esm.js

@@ -1,6 +1,6 @@
 export * from "./dayjs";
-export * from "./fixTimezoneOffset";
-export * from "./formatDate";
-export * from "./getCurrentDateInUTC";
-export * from "./getDateInUTC";
-export * from "./parseTimeSpent";
+export * from "./fix-timezone-offset";
+export * from "./format-date";
+export * from "./get-current-date-in-utc";
+export * from "./get-date-in-utc";
+export * from "./parse-time-spent";

package/dist/date/index.js

@@ -1,6 +1,6 @@
 export * from "./dayjs";
-export * from "./fixTimezoneOffset";
-export * from "./formatDate";
-export * from "./getCurrentDateInUTC";
-export * from "./getDateInUTC";
-export * from "./parseTimeSpent";
+export * from "./fix-timezone-offset";
+export * from "./format-date";
+export * from "./get-current-date-in-utc";
+export * from "./get-date-in-utc";
+export * from "./parse-time-spent";

package/dist/date/index.js.map

@@ -1 +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"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/date/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,0CAAuB;AACvB,wDAAqC;AACrC,gDAA6B;AAC7B,4DAAyC;AACzC,oDAAiC;AACjC,qDAAkC"}

package/dist/date/{parseTimeSpent.d.ts → parse-time-spent.d.ts}

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

package/dist/date/parse-time-spent.d.ts.map

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

@@ -1,4 +1,4 @@
-import { fixTimezoneOffset } from "./fixTimezoneOffset";
+import { fixTimezoneOffset } from "./fix-timezone-offset";
 // Supported locales and their translations
 const locales = {
     "pt-BR": {

package/dist/date/{parseTimeSpent.js → parse-time-spent.js}

@@ -1,4 +1,4 @@
-import { fixTimezoneOffset } from "./fixTimezoneOffset";
+import { fixTimezoneOffset } from "./fix-timezone-offset";
 // Supported locales and their translations
 const locales = {
     "pt-BR": {

package/dist/date/parse-time-spent.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"parse-time-spent.js","sourceRoot":"","sources":["../../src/date/parse-time-spent.ts"],"names":[],"mappings":"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"}

package/dist/files/compress-image.d.ts

@@ -0,0 +1,10 @@
+interface ICompressImageParams {
+    file: File;
+    maxWidth?: number;
+    maxHeight?: number;
+    quality?: number;
+    allowedFileTypes?: string[];
+}
+export declare function compressImage({ file, maxWidth, maxHeight, quality, allowedFileTypes, }: ICompressImageParams): Promise<File>;
+export {};
+//# sourceMappingURL=compress-image.d.ts.map

package/dist/files/compress-image.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"compress-image.d.ts","sourceRoot":"","sources":["../../src/files/compress-image.ts"],"names":[],"mappings":"AAAA,UAAU,oBAAoB;IAC5B,IAAI,EAAE,IAAI,CAAA;IACV,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,gBAAgB,CAAC,EAAE,MAAM,EAAE,CAAA;CAC5B;AAYD,wBAAgB,aAAa,CAAC,EAC5B,IAAI,EACJ,QAAmC,EACnC,SAAoC,EACpC,OAAW,EACX,gBAAyE,GAC1E,EAAE,oBAAoB,iBAiEtB"}

package/dist/files/compress-image.esm.js

@@ -0,0 +1,57 @@
+function convertToWebp(filename) {
+    const lastDotIndex = filename.lastIndexOf(".");
+    if (lastDotIndex === -1) {
+        return `${filename}.webp`;
+    }
+    return `${filename.substring(0, lastDotIndex)}.webp`;
+}
+export function compressImage({ file, maxWidth = Number.POSITIVE_INFINITY, maxHeight = Number.POSITIVE_INFINITY, quality = 1, allowedFileTypes = ["image/jpg", "image/jpeg", "image/png", "image/webp"], }) {
+    if (!allowedFileTypes.includes(file.type)) {
+        throw new Error("Image format not supported");
+    }
+    return new Promise((resolve, reject) => {
+        const reader = new FileReader();
+        reader.onload = (event) => {
+            var _a;
+            const compressed = new Image();
+            compressed.onload = () => {
+                const canvas = document.createElement("canvas");
+                let width = compressed.width;
+                let height = compressed.height;
+                if (width > height) {
+                    if (width > maxWidth) {
+                        height *= maxWidth / width;
+                        width = maxWidth;
+                    }
+                }
+                else {
+                    if (height > maxHeight) {
+                        width *= maxHeight / height;
+                        height = maxHeight;
+                    }
+                }
+                canvas.width = width;
+                canvas.height = height;
+                const context = canvas.getContext("2d");
+                if (!context) {
+                    reject(new Error("Failed to get canvas context"));
+                    return;
+                }
+                context.drawImage(compressed, 0, 0, width, height);
+                canvas.toBlob((blob) => {
+                    if (!blob) {
+                        reject(new Error("Failed to compress image."));
+                        return;
+                    }
+                    const compressedFile = new File([blob], convertToWebp(file.name), {
+                        type: "image/webp",
+                        lastModified: Date.now(),
+                    });
+                    resolve(compressedFile);
+                }, "image/webp", quality);
+            };
+            compressed.src = (_a = event.target) === null || _a === void 0 ? void 0 : _a.result;
+        };
+        reader.readAsDataURL(file);
+    });
+}

package/dist/files/compress-image.js

@@ -0,0 +1,57 @@
+function convertToWebp(filename) {
+    const lastDotIndex = filename.lastIndexOf(".");
+    if (lastDotIndex === -1) {
+        return `${filename}.webp`;
+    }
+    return `${filename.substring(0, lastDotIndex)}.webp`;
+}
+export function compressImage({ file, maxWidth = Number.POSITIVE_INFINITY, maxHeight = Number.POSITIVE_INFINITY, quality = 1, allowedFileTypes = ["image/jpg", "image/jpeg", "image/png", "image/webp"], }) {
+    if (!allowedFileTypes.includes(file.type)) {
+        throw new Error("Image format not supported");
+    }
+    return new Promise((resolve, reject) => {
+        const reader = new FileReader();
+        reader.onload = (event) => {
+            var _a;
+            const compressed = new Image();
+            compressed.onload = () => {
+                const canvas = document.createElement("canvas");
+                let width = compressed.width;
+                let height = compressed.height;
+                if (width > height) {
+                    if (width > maxWidth) {
+                        height *= maxWidth / width;
+                        width = maxWidth;
+                    }
+                }
+                else {
+                    if (height > maxHeight) {
+                        width *= maxHeight / height;
+                        height = maxHeight;
+                    }
+                }
+                canvas.width = width;
+                canvas.height = height;
+                const context = canvas.getContext("2d");
+                if (!context) {
+                    reject(new Error("Failed to get canvas context"));
+                    return;
+                }
+                context.drawImage(compressed, 0, 0, width, height);
+                canvas.toBlob((blob) => {
+                    if (!blob) {
+                        reject(new Error("Failed to compress image."));
+                        return;
+                    }
+                    const compressedFile = new File([blob], convertToWebp(file.name), {
+                        type: "image/webp",
+                        lastModified: Date.now(),
+                    });
+                    resolve(compressedFile);
+                }, "image/webp", quality);
+            };
+            compressed.src = (_a = event.target) === null || _a === void 0 ? void 0 : _a.result;
+        };
+        reader.readAsDataURL(file);
+    });
+}

package/dist/files/compress-image.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"compress-image.js","sourceRoot":"","sources":["../../src/files/compress-image.ts"],"names":[],"mappings":"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"}

package/dist/files/download-url.d.ts

@@ -0,0 +1,2 @@
+export declare const downloadUrl: (url: string) => Promise<boolean>;
+//# sourceMappingURL=download-url.d.ts.map

package/dist/files/download-url.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"download-url.d.ts","sourceRoot":"","sources":["../../src/files/download-url.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,WAAW,GAAU,KAAK,MAAM,KAAG,OAAO,CAAC,OAAO,CAyB9D,CAAA"}

package/dist/files/download-url.esm.js

@@ -0,0 +1,24 @@
+export const downloadUrl = async (url) => {
+    try {
+        const urlObj = new URL(url);
+        const pathname = urlObj.pathname;
+        const segments = pathname.split("/").filter((segment) => segment.length > 0);
+        const filename = segments.length > 0 ? segments[segments.length - 1] : null;
+        if (!filename || !filename.includes(".")) {
+            throw new Error("URL does not contain a valid filename");
+        }
+        const response = await fetch(url, { mode: "cors" });
+        const blob = await response.blob();
+        const link = document.createElement("a");
+        link.href = window.URL.createObjectURL(blob);
+        link.download = filename;
+        document.body.appendChild(link);
+        link.click();
+        document.body.removeChild(link);
+        return true;
+    }
+    catch (error) {
+        console.error("Error downloading the file", error);
+        return false;
+    }
+};

package/dist/files/download-url.js

@@ -0,0 +1,24 @@
+export const downloadUrl = async (url) => {
+    try {
+        const urlObj = new URL(url);
+        const pathname = urlObj.pathname;
+        const segments = pathname.split("/").filter((segment) => segment.length > 0);
+        const filename = segments.length > 0 ? segments[segments.length - 1] : null;
+        if (!filename || !filename.includes(".")) {
+            throw new Error("URL does not contain a valid filename");
+        }
+        const response = await fetch(url, { mode: "cors" });
+        const blob = await response.blob();
+        const link = document.createElement("a");
+        link.href = window.URL.createObjectURL(blob);
+        link.download = filename;
+        document.body.appendChild(link);
+        link.click();
+        document.body.removeChild(link);
+        return true;
+    }
+    catch (error) {
+        console.error("Error downloading the file", error);
+        return false;
+    }
+};

package/dist/files/download-url.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"download-url.js","sourceRoot":"","sources":["../../src/files/download-url.ts"],"names":[],"mappings":";;;AAAO,MAAM,WAAW,GAAG,KAAK,EAAE,GAAW,EAAoB,EAAE;IACjE,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,IAAI,GAAG,CAAC,GAAG,CAAC,CAAA;QAC3B,MAAM,QAAQ,GAAG,MAAM,CAAC,QAAQ,CAAA;QAChC,MAAM,QAAQ,GAAG,QAAQ,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,MAAM,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,OAAO,CAAC,MAAM,GAAG,CAAC,CAAC,CAAA;QAC5E,MAAM,QAAQ,GAAG,QAAQ,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,QAAQ,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAA;QAE3E,IAAI,CAAC,QAAQ,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC;YACzC,MAAM,IAAI,KAAK,CAAC,uCAAuC,CAAC,CAAA;QAC1D,CAAC;QAED,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,GAAG,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC,CAAA;QACnD,MAAM,IAAI,GAAG,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAA;QAElC,MAAM,IAAI,GAAG,QAAQ,CAAC,aAAa,CAAC,GAAG,CAAC,CAAA;QACxC,IAAI,CAAC,IAAI,GAAG,MAAM,CAAC,GAAG,CAAC,eAAe,CAAC,IAAI,CAAC,CAAA;QAC5C,IAAI,CAAC,QAAQ,GAAG,QAAQ,CAAA;QACxB,QAAQ,CAAC,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC,CAAA;QAC/B,IAAI,CAAC,KAAK,EAAE,CAAA;QACZ,QAAQ,CAAC,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC,CAAA;QAC/B,OAAO,IAAI,CAAA;IACb,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,OAAO,CAAC,KAAK,CAAC,4BAA4B,EAAE,KAAK,CAAC,CAAA;QAClD,OAAO,KAAK,CAAA;IACd,CAAC;AACH,CAAC,CAAA;AAzBY,QAAA,WAAW,eAyBvB"}

package/dist/files/format-bytes.d.ts

@@ -0,0 +1,2 @@
+export declare function formatBytes(bytes: number): string;
+//# sourceMappingURL=format-bytes.d.ts.map

package/dist/files/format-bytes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"format-bytes.d.ts","sourceRoot":"","sources":["../../src/files/format-bytes.ts"],"names":[],"mappings":"AAAA,wBAAgB,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAejD"}

package/dist/files/format-bytes.esm.js

@@ -0,0 +1,13 @@
+export function formatBytes(bytes) {
+    if (bytes < 0) {
+        throw new Error("Size in bytes cannot be negative");
+    }
+    const units = ["B", "KB", "MB", "GB", "TB", "PB"];
+    let size = bytes;
+    let index = 0;
+    while (size >= 1024 && index < units.length - 1) {
+        size /= 1024;
+        index++;
+    }
+    return `${size.toFixed(2)} ${units[index]}`;
+}

package/dist/files/format-bytes.js

@@ -0,0 +1,13 @@
+export function formatBytes(bytes) {
+    if (bytes < 0) {
+        throw new Error("Size in bytes cannot be negative");
+    }
+    const units = ["B", "KB", "MB", "GB", "TB", "PB"];
+    let size = bytes;
+    let index = 0;
+    while (size >= 1024 && index < units.length - 1) {
+        size /= 1024;
+        index++;
+    }
+    return `${size.toFixed(2)} ${units[index]}`;
+}

package/dist/files/format-bytes.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"format-bytes.js","sourceRoot":"","sources":["../../src/files/format-bytes.ts"],"names":[],"mappings":";;AAAA,kCAeC;AAfD,SAAgB,WAAW,CAAC,KAAa;IACvC,IAAI,KAAK,GAAG,CAAC,EAAE,CAAC;QACd,MAAM,IAAI,KAAK,CAAC,kCAAkC,CAAC,CAAA;IACrD,CAAC;IAED,MAAM,KAAK,GAAG,CAAC,GAAG,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,CAAC,CAAA;IACjD,IAAI,IAAI,GAAG,KAAK,CAAA;IAChB,IAAI,KAAK,GAAG,CAAC,CAAA;IAEb,OAAO,IAAI,IAAI,IAAI,IAAI,KAAK,GAAG,KAAK,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAChD,IAAI,IAAI,IAAI,CAAA;QACZ,KAAK,EAAE,CAAA;IACT,CAAC;IAED,OAAO,GAAG,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,KAAK,CAAC,KAAK,CAAC,EAAE,CAAA;AAC7C,CAAC"}