@herowcode/utils 1.0.1

package/dist/date/parseTimeSpent.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);
+}

package/dist/date/parseTimeSpent.js.map

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

package/dist/function.d.ts

@@ -0,0 +1,18 @@
+type TAnyFunction = (...args: unknown[]) => unknown;
+/**
+ * Creates a debounced function that delays invoking func until after delay milliseconds
+ * have elapsed since the last time the debounced function was invoked
+ * @param fn - The function to debounce
+ * @param delay - The number of milliseconds to delay
+ * @returns The debounced function
+ */
+export declare function debounce<T extends TAnyFunction>(fn: T, delay: number): (...args: Parameters<T>) => void;
+/**
+ * Creates a throttled function that only invokes func at most once per every delay milliseconds
+ * @param fn - The function to throttle
+ * @param delay - The number of milliseconds to throttle invocations to
+ * @returns The throttled function
+ */
+export declare function throttle<T extends TAnyFunction>(fn: T, delay: number): (...args: Parameters<T>) => void;
+export {};
+//# sourceMappingURL=function.d.ts.map

package/dist/function.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"function.d.ts","sourceRoot":"","sources":["../src/function.ts"],"names":[],"mappings":"AAAA,KAAK,YAAY,GAAG,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,OAAO,CAAA;AAEnD;;;;;;GAMG;AACH,wBAAgB,QAAQ,CAAC,CAAC,SAAS,YAAY,EAC7C,EAAE,EAAE,CAAC,EACL,KAAK,EAAE,MAAM,GACZ,CAAC,GAAG,IAAI,EAAE,UAAU,CAAC,CAAC,CAAC,KAAK,IAAI,CAiBlC;AAED;;;;;GAKG;AACH,wBAAgB,QAAQ,CAAC,CAAC,SAAS,YAAY,EAC7C,EAAE,EAAE,CAAC,EACL,KAAK,EAAE,MAAM,GACZ,CAAC,GAAG,IAAI,EAAE,UAAU,CAAC,CAAC,CAAC,KAAK,IAAI,CA+BlC"}

package/dist/function.esm.js

@@ -0,0 +1,54 @@
+/**
+ * Creates a debounced function that delays invoking func until after delay milliseconds
+ * have elapsed since the last time the debounced function was invoked
+ * @param fn - The function to debounce
+ * @param delay - The number of milliseconds to delay
+ * @returns The debounced function
+ */
+export function debounce(fn, delay) {
+    if (typeof fn !== "function") {
+        throw new Error("First argument must be a function");
+    }
+    if (typeof delay !== "number" || delay < 0) {
+        throw new Error("Delay must be a non-negative number");
+    }
+    let timeoutId;
+    return function (...args) {
+        if (timeoutId) {
+            clearTimeout(timeoutId);
+        }
+        timeoutId = setTimeout(() => fn.apply(this, args), delay);
+    };
+}
+/**
+ * Creates a throttled function that only invokes func at most once per every delay milliseconds
+ * @param fn - The function to throttle
+ * @param delay - The number of milliseconds to throttle invocations to
+ * @returns The throttled function
+ */
+export function throttle(fn, delay) {
+    if (typeof fn !== "function") {
+        throw new Error("First argument must be a function");
+    }
+    if (typeof delay !== "number" || delay < 0) {
+        throw new Error("Delay must be a non-negative number");
+    }
+    let lastCall = 0;
+    let timeoutId;
+    return function (...args) {
+        const now = Date.now();
+        if (now - lastCall >= delay) {
+            lastCall = now;
+            fn.apply(this, args);
+        }
+        else {
+            if (timeoutId) {
+                clearTimeout(timeoutId);
+            }
+            timeoutId = setTimeout(() => {
+                lastCall = Date.now();
+                fn.apply(this, args);
+            }, delay - (now - lastCall));
+        }
+    };
+}

package/dist/function.js

@@ -0,0 +1,54 @@
+/**
+ * Creates a debounced function that delays invoking func until after delay milliseconds
+ * have elapsed since the last time the debounced function was invoked
+ * @param fn - The function to debounce
+ * @param delay - The number of milliseconds to delay
+ * @returns The debounced function
+ */
+export function debounce(fn, delay) {
+    if (typeof fn !== "function") {
+        throw new Error("First argument must be a function");
+    }
+    if (typeof delay !== "number" || delay < 0) {
+        throw new Error("Delay must be a non-negative number");
+    }
+    let timeoutId;
+    return function (...args) {
+        if (timeoutId) {
+            clearTimeout(timeoutId);
+        }
+        timeoutId = setTimeout(() => fn.apply(this, args), delay);
+    };
+}
+/**
+ * Creates a throttled function that only invokes func at most once per every delay milliseconds
+ * @param fn - The function to throttle
+ * @param delay - The number of milliseconds to throttle invocations to
+ * @returns The throttled function
+ */
+export function throttle(fn, delay) {
+    if (typeof fn !== "function") {
+        throw new Error("First argument must be a function");
+    }
+    if (typeof delay !== "number" || delay < 0) {
+        throw new Error("Delay must be a non-negative number");
+    }
+    let lastCall = 0;
+    let timeoutId;
+    return function (...args) {
+        const now = Date.now();
+        if (now - lastCall >= delay) {
+            lastCall = now;
+            fn.apply(this, args);
+        }
+        else {
+            if (timeoutId) {
+                clearTimeout(timeoutId);
+            }
+            timeoutId = setTimeout(() => {
+                lastCall = Date.now();
+                fn.apply(this, args);
+            }, delay - (now - lastCall));
+        }
+    };
+}

package/dist/function.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"function.js","sourceRoot":"","sources":["../src/function.ts"],"names":[],"mappings":";;AASA,4BAoBC;AAQD,4BAkCC;AArED;;;;;;GAMG;AACH,SAAgB,QAAQ,CACtB,EAAK,EACL,KAAa;IAEb,IAAI,OAAO,EAAE,KAAK,UAAU,EAAE,CAAC;QAC7B,MAAM,IAAI,KAAK,CAAC,mCAAmC,CAAC,CAAA;IACtD,CAAC;IAED,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,GAAG,CAAC,EAAE,CAAC;QAC3C,MAAM,IAAI,KAAK,CAAC,qCAAqC,CAAC,CAAA;IACxD,CAAC;IAED,IAAI,SAAoD,CAAA;IAExD,OAAO,UAAyB,GAAG,IAAmB;QACpD,IAAI,SAAS,EAAE,CAAC;YACd,YAAY,CAAC,SAAS,CAAC,CAAA;QACzB,CAAC;QACD,SAAS,GAAG,UAAU,CAAC,GAAG,EAAE,CAAC,EAAE,CAAC,KAAK,CAAC,IAAI,EAAE,IAAI,CAAC,EAAE,KAAK,CAAC,CAAA;IAC3D,CAAC,CAAA;AACH,CAAC;AAED;;;;;GAKG;AACH,SAAgB,QAAQ,CACtB,EAAK,EACL,KAAa;IAEb,IAAI,OAAO,EAAE,KAAK,UAAU,EAAE,CAAC;QAC7B,MAAM,IAAI,KAAK,CAAC,mCAAmC,CAAC,CAAA;IACtD,CAAC;IAED,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,GAAG,CAAC,EAAE,CAAC;QAC3C,MAAM,IAAI,KAAK,CAAC,qCAAqC,CAAC,CAAA;IACxD,CAAC;IAED,IAAI,QAAQ,GAAG,CAAC,CAAA;IAChB,IAAI,SAAoD,CAAA;IAExD,OAAO,UAAyB,GAAG,IAAmB;QACpD,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,EAAE,CAAA;QAEtB,IAAI,GAAG,GAAG,QAAQ,IAAI,KAAK,EAAE,CAAC;YAC5B,QAAQ,GAAG,GAAG,CAAA;YACd,EAAE,CAAC,KAAK,CAAC,IAAI,EAAE,IAAI,CAAC,CAAA;QACtB,CAAC;aAAM,CAAC;YACN,IAAI,SAAS,EAAE,CAAC;gBACd,YAAY,CAAC,SAAS,CAAC,CAAA;YACzB,CAAC;YACD,SAAS,GAAG,UAAU,CACpB,GAAG,EAAE;gBACH,QAAQ,GAAG,IAAI,CAAC,GAAG,EAAE,CAAA;gBACrB,EAAE,CAAC,KAAK,CAAC,IAAI,EAAE,IAAI,CAAC,CAAA;YACtB,CAAC,EACD,KAAK,GAAG,CAAC,GAAG,GAAG,QAAQ,CAAC,CACzB,CAAA;QACH,CAAC;IACH,CAAC,CAAA;AACH,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,6 @@
+export * from "./array/index.js";
+export * from "./date/index.js";
+export { debounce, throttle } from "./function.js";
+export { randomInt } from "./number.js";
+export * from "./string/index.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAGA,cAAc,kBAAkB,CAAA;AAChC,cAAc,iBAAiB,CAAA;AAE/B,OAAO,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAA;AAElD,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAA;AAEvC,cAAc,mBAAmB,CAAA"}

package/dist/index.esm.js

@@ -0,0 +1,10 @@
+// Date utilities
+// Array utilities
+export * from "./array/index.js";
+export * from "./date/index.js";
+// Function utilities
+export { debounce, throttle } from "./function.js";
+// Number utilities
+export { randomInt } from "./number.js";
+// String utilities
+export * from "./string/index.js";

package/dist/index.js

@@ -0,0 +1,10 @@
+// Date utilities
+// Array utilities
+export * from "./array/index.js";
+export * from "./date/index.js";
+// Function utilities
+export { debounce, throttle } from "./function.js";
+// Number utilities
+export { randomInt } from "./number.js";
+// String utilities
+export * from "./string/index.js";

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAAA,iBAAiB;;;;;;;;;;;;;;;;;AAEjB,kBAAkB;AAClB,mDAAgC;AAChC,kDAA+B;AAC/B,qBAAqB;AACrB,6CAAkD;AAAzC,uGAAA,QAAQ,OAAA;AAAE,uGAAA,QAAQ,OAAA;AAC3B,mBAAmB;AACnB,yCAAuC;AAA9B,sGAAA,SAAS,OAAA;AAClB,mBAAmB;AACnB,oDAAiC"}

package/dist/number.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Generates a random integer between min and max (inclusive)
+ * @param min - The minimum value (inclusive)
+ * @param max - The maximum value (inclusive)
+ * @returns A random integer between min and max
+ */
+export declare function randomInt(min: number, max: number): number;
+//# sourceMappingURL=number.d.ts.map

package/dist/number.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"number.d.ts","sourceRoot":"","sources":["../src/number.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,wBAAgB,SAAS,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,CAU1D"}

package/dist/number.esm.js

@@ -0,0 +1,15 @@
+/**
+ * Generates a random integer between min and max (inclusive)
+ * @param min - The minimum value (inclusive)
+ * @param max - The maximum value (inclusive)
+ * @returns A random integer between min and max
+ */
+export function randomInt(min, max) {
+    if (!Number.isInteger(min) || !Number.isInteger(max)) {
+        throw new Error("Both min and max must be integers");
+    }
+    if (min > max) {
+        throw new Error("Min value cannot be greater than max value");
+    }
+    return Math.floor(Math.random() * (max - min + 1)) + min;
+}

package/dist/number.js

@@ -0,0 +1,15 @@
+/**
+ * Generates a random integer between min and max (inclusive)
+ * @param min - The minimum value (inclusive)
+ * @param max - The maximum value (inclusive)
+ * @returns A random integer between min and max
+ */
+export function randomInt(min, max) {
+    if (!Number.isInteger(min) || !Number.isInteger(max)) {
+        throw new Error("Both min and max must be integers");
+    }
+    if (min > max) {
+        throw new Error("Min value cannot be greater than max value");
+    }
+    return Math.floor(Math.random() * (max - min + 1)) + min;
+}

package/dist/number.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"number.js","sourceRoot":"","sources":["../src/number.ts"],"names":[],"mappings":";;AAMA,8BAUC;AAhBD;;;;;GAKG;AACH,SAAgB,SAAS,CAAC,GAAW,EAAE,GAAW;IAChD,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,GAAG,CAAC,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,GAAG,CAAC,EAAE,CAAC;QACrD,MAAM,IAAI,KAAK,CAAC,mCAAmC,CAAC,CAAA;IACtD,CAAC;IAED,IAAI,GAAG,GAAG,GAAG,EAAE,CAAC;QACd,MAAM,IAAI,KAAK,CAAC,4CAA4C,CAAC,CAAA;IAC/D,CAAC;IAED,OAAO,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,GAAG,GAAG,GAAG,CAAC,CAAC,CAAC,GAAG,GAAG,CAAA;AAC1D,CAAC"}

package/dist/string/camel-case.d.ts

@@ -0,0 +1,2 @@
+export declare function camelCase(str: string): string;
+//# sourceMappingURL=camel-case.d.ts.map

package/dist/string/camel-case.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"camel-case.d.ts","sourceRoot":"","sources":["../../src/string/camel-case.ts"],"names":[],"mappings":"AAAA,wBAAgB,SAAS,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CA0B7C"}

package/dist/string/camel-case.esm.js

@@ -0,0 +1,21 @@
+export function camelCase(str) {
+    if (typeof str !== "string") {
+        throw new Error("Input must be a string");
+    }
+    if (str.length === 0) {
+        return str;
+    }
+    const words = str
+        .toLowerCase()
+        .replace(/[^a-zA-Z0-9\s\-_]/g, "")
+        .split(/[\s\-_]+/)
+        .filter((word) => word.length > 0);
+    if (words.length === 0) {
+        return "";
+    }
+    return (words[0] +
+        words
+            .slice(1)
+            .map((word) => word.charAt(0).toUpperCase() + word.slice(1))
+            .join(""));
+}

package/dist/string/camel-case.js

@@ -0,0 +1,21 @@
+export function camelCase(str) {
+    if (typeof str !== "string") {
+        throw new Error("Input must be a string");
+    }
+    if (str.length === 0) {
+        return str;
+    }
+    const words = str
+        .toLowerCase()
+        .replace(/[^a-zA-Z0-9\s\-_]/g, "")
+        .split(/[\s\-_]+/)
+        .filter((word) => word.length > 0);
+    if (words.length === 0) {
+        return "";
+    }
+    return (words[0] +
+        words
+            .slice(1)
+            .map((word) => word.charAt(0).toUpperCase() + word.slice(1))
+            .join(""));
+}

package/dist/string/camel-case.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"camel-case.js","sourceRoot":"","sources":["../../src/string/camel-case.ts"],"names":[],"mappings":";;AAAA,8BA0BC;AA1BD,SAAgB,SAAS,CAAC,GAAW;IACnC,IAAI,OAAO,GAAG,KAAK,QAAQ,EAAE,CAAC;QAC5B,MAAM,IAAI,KAAK,CAAC,wBAAwB,CAAC,CAAA;IAC3C,CAAC;IAED,IAAI,GAAG,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACrB,OAAO,GAAG,CAAA;IACZ,CAAC;IAED,MAAM,KAAK,GAAG,GAAG;SACd,WAAW,EAAE;SACb,OAAO,CAAC,oBAAoB,EAAE,EAAE,CAAC;SACjC,KAAK,CAAC,UAAU,CAAC;SACjB,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC,CAAA;IAEpC,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACvB,OAAO,EAAE,CAAA;IACX,CAAC;IAED,OAAO,CACL,KAAK,CAAC,CAAC,CAAC;QACR,KAAK;aACF,KAAK,CAAC,CAAC,CAAC;aACR,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,WAAW,EAAE,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;aAC3D,IAAI,CAAC,EAAE,CAAC,CACZ,CAAA;AACH,CAAC"}

package/dist/string/capitalize.d.ts

@@ -0,0 +1,2 @@
+export declare function capitalize(str: string): string;
+//# sourceMappingURL=capitalize.d.ts.map

package/dist/string/capitalize.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"capitalize.d.ts","sourceRoot":"","sources":["../../src/string/capitalize.ts"],"names":[],"mappings":"AAAA,wBAAgB,UAAU,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAU9C"}

package/dist/string/capitalize.esm.js

@@ -0,0 +1,9 @@
+export function capitalize(str) {
+    if (typeof str !== "string") {
+        throw new Error("Input must be a string");
+    }
+    if (str.length === 0) {
+        return str;
+    }
+    return str.charAt(0).toUpperCase() + str.slice(1).toLowerCase();
+}

package/dist/string/capitalize.js

@@ -0,0 +1,9 @@
+export function capitalize(str) {
+    if (typeof str !== "string") {
+        throw new Error("Input must be a string");
+    }
+    if (str.length === 0) {
+        return str;
+    }
+    return str.charAt(0).toUpperCase() + str.slice(1).toLowerCase();
+}

package/dist/string/capitalize.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"capitalize.js","sourceRoot":"","sources":["../../src/string/capitalize.ts"],"names":[],"mappings":";;AAAA,gCAUC;AAVD,SAAgB,UAAU,CAAC,GAAW;IACpC,IAAI,OAAO,GAAG,KAAK,QAAQ,EAAE,CAAC;QAC5B,MAAM,IAAI,KAAK,CAAC,wBAAwB,CAAC,CAAA;IAC3C,CAAC;IAED,IAAI,GAAG,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACrB,OAAO,GAAG,CAAA;IACZ,CAAC;IAED,OAAO,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,WAAW,EAAE,GAAG,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,WAAW,EAAE,CAAA;AACjE,CAAC"}

package/dist/string/index.d.ts

@@ -0,0 +1,9 @@
+export * from "./camel-case";
+export * from "./capitalize";
+export * from "./kebab-case";
+export * from "./remove-html-tags";
+export * from "./slugify";
+export * from "./snake-case";
+export * from "./to-sentence-case";
+export * from "./truncate";
+//# sourceMappingURL=index.d.ts.map

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

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

package/dist/string/index.esm.js

@@ -0,0 +1,8 @@
+export * from "./camel-case";
+export * from "./capitalize";
+export * from "./kebab-case";
+export * from "./remove-html-tags";
+export * from "./slugify";
+export * from "./snake-case";
+export * from "./to-sentence-case";
+export * from "./truncate";

package/dist/string/index.js

@@ -0,0 +1,8 @@
+export * from "./camel-case";
+export * from "./capitalize";
+export * from "./kebab-case";
+export * from "./remove-html-tags";
+export * from "./slugify";
+export * from "./snake-case";
+export * from "./to-sentence-case";
+export * from "./truncate";

package/dist/string/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/string/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,+CAA4B;AAC5B,+CAA4B;AAC5B,+CAA4B;AAC5B,qDAAkC;AAClC,4CAAyB;AACzB,+CAA4B;AAC5B,qDAAkC;AAClC,6CAA0B"}

package/dist/string/kebab-case.d.ts

@@ -0,0 +1,2 @@
+export declare function kebabCase(str: string): string;
+//# sourceMappingURL=kebab-case.d.ts.map

package/dist/string/kebab-case.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"kebab-case.d.ts","sourceRoot":"","sources":["../../src/string/kebab-case.ts"],"names":[],"mappings":"AAAA,wBAAgB,SAAS,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAW7C"}

package/dist/string/kebab-case.esm.js

@@ -0,0 +1,11 @@
+export function kebabCase(str) {
+    if (typeof str !== "string") {
+        throw new Error("Input must be a string");
+    }
+    return str
+        .replace(/([a-z])([A-Z])/g, "$1-$2")
+        .replace(/[\s_]+/g, "-")
+        .replace(/[^a-zA-Z0-9-]/g, "")
+        .toLowerCase()
+        .replace(/^-+|-+$/g, "");
+}

package/dist/string/kebab-case.js

@@ -0,0 +1,11 @@
+export function kebabCase(str) {
+    if (typeof str !== "string") {
+        throw new Error("Input must be a string");
+    }
+    return str
+        .replace(/([a-z])([A-Z])/g, "$1-$2")
+        .replace(/[\s_]+/g, "-")
+        .replace(/[^a-zA-Z0-9-]/g, "")
+        .toLowerCase()
+        .replace(/^-+|-+$/g, "");
+}

package/dist/string/kebab-case.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"kebab-case.js","sourceRoot":"","sources":["../../src/string/kebab-case.ts"],"names":[],"mappings":";;AAAA,8BAWC;AAXD,SAAgB,SAAS,CAAC,GAAW;IACnC,IAAI,OAAO,GAAG,KAAK,QAAQ,EAAE,CAAC;QAC5B,MAAM,IAAI,KAAK,CAAC,wBAAwB,CAAC,CAAA;IAC3C,CAAC;IAED,OAAO,GAAG;SACP,OAAO,CAAC,iBAAiB,EAAE,OAAO,CAAC;SACnC,OAAO,CAAC,SAAS,EAAE,GAAG,CAAC;SACvB,OAAO,CAAC,gBAAgB,EAAE,EAAE,CAAC;SAC7B,WAAW,EAAE;SACb,OAAO,CAAC,UAAU,EAAE,EAAE,CAAC,CAAA;AAC5B,CAAC"}

package/dist/string/remove-html-tags.d.ts

@@ -0,0 +1,2 @@
+export declare function removeHtmlTags(input: string): string;
+//# sourceMappingURL=remove-html-tags.d.ts.map

package/dist/string/remove-html-tags.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"remove-html-tags.d.ts","sourceRoot":"","sources":["../../src/string/remove-html-tags.ts"],"names":[],"mappings":"AAAA,wBAAgB,cAAc,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAepD"}

package/dist/string/remove-html-tags.esm.js

@@ -0,0 +1,14 @@
+export function removeHtmlTags(input) {
+    // Input validation
+    if (!input || typeof input !== "string") {
+        return "";
+    }
+    // Apply reasonable input length limit for safety
+    const maxLength = 100000; // Adjust based on your requirements
+    let updatedInput = input;
+    if (updatedInput.length > maxLength) {
+        updatedInput = updatedInput.slice(0, maxLength);
+    }
+    // Use a non-backtracking approach to prevent ReDoS vulnerabilities
+    return updatedInput.replace(/<(?:[^>"']|"[^"]*"|'[^']*')*>/g, "");
+}

package/dist/string/remove-html-tags.js

@@ -0,0 +1,14 @@
+export function removeHtmlTags(input) {
+    // Input validation
+    if (!input || typeof input !== "string") {
+        return "";
+    }
+    // Apply reasonable input length limit for safety
+    const maxLength = 100000; // Adjust based on your requirements
+    let updatedInput = input;
+    if (updatedInput.length > maxLength) {
+        updatedInput = updatedInput.slice(0, maxLength);
+    }
+    // Use a non-backtracking approach to prevent ReDoS vulnerabilities
+    return updatedInput.replace(/<(?:[^>"']|"[^"]*"|'[^']*')*>/g, "");
+}

package/dist/string/remove-html-tags.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"remove-html-tags.js","sourceRoot":"","sources":["../../src/string/remove-html-tags.ts"],"names":[],"mappings":";;AAAA,wCAeC;AAfD,SAAgB,cAAc,CAAC,KAAa;IAC1C,mBAAmB;IACnB,IAAI,CAAC,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QACxC,OAAO,EAAE,CAAA;IACX,CAAC;IAED,iDAAiD;IACjD,MAAM,SAAS,GAAG,MAAM,CAAA,CAAC,oCAAoC;IAC7D,IAAI,YAAY,GAAG,KAAK,CAAA;IACxB,IAAI,YAAY,CAAC,MAAM,GAAG,SAAS,EAAE,CAAC;QACpC,YAAY,GAAG,YAAY,CAAC,KAAK,CAAC,CAAC,EAAE,SAAS,CAAC,CAAA;IACjD,CAAC;IAED,mEAAmE;IACnE,OAAO,YAAY,CAAC,OAAO,CAAC,gCAAgC,EAAE,EAAE,CAAC,CAAA;AACnE,CAAC"}

package/dist/string/slugify.d.ts

@@ -0,0 +1,2 @@
+export declare function slugify(text: string): string;
+//# sourceMappingURL=slugify.d.ts.map

package/dist/string/slugify.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"slugify.d.ts","sourceRoot":"","sources":["../../src/string/slugify.ts"],"names":[],"mappings":"AAAA,wBAAgB,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAQ5C"}

package/dist/string/slugify.esm.js

@@ -0,0 +1,9 @@
+export function slugify(text) {
+    return text
+        .normalize("NFD")
+        .replace(/[\u0300-\u036f]/g, "")
+        .replace(/[^\w\s]/gi, "")
+        .trim()
+        .replace(/\s+/g, "-")
+        .toLowerCase();
+}

package/dist/string/slugify.js

@@ -0,0 +1,9 @@
+export function slugify(text) {
+    return text
+        .normalize("NFD")
+        .replace(/[\u0300-\u036f]/g, "")
+        .replace(/[^\w\s]/gi, "")
+        .trim()
+        .replace(/\s+/g, "-")
+        .toLowerCase();
+}

package/dist/string/slugify.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"slugify.js","sourceRoot":"","sources":["../../src/string/slugify.ts"],"names":[],"mappings":";;AAAA,0BAQC;AARD,SAAgB,OAAO,CAAC,IAAY;IAClC,OAAO,IAAI;SACR,SAAS,CAAC,KAAK,CAAC;SAChB,OAAO,CAAC,kBAAkB,EAAE,EAAE,CAAC;SAC/B,OAAO,CAAC,WAAW,EAAE,EAAE,CAAC;SACxB,IAAI,EAAE;SACN,OAAO,CAAC,MAAM,EAAE,GAAG,CAAC;SACpB,WAAW,EAAE,CAAA;AAClB,CAAC"}

package/dist/string/snake-case.d.ts

@@ -0,0 +1,2 @@
+export declare function snakeCase(str: string): string;
+//# sourceMappingURL=snake-case.d.ts.map

package/dist/string/snake-case.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"snake-case.d.ts","sourceRoot":"","sources":["../../src/string/snake-case.ts"],"names":[],"mappings":"AAAA,wBAAgB,SAAS,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAW7C"}

package/dist/string/snake-case.esm.js

@@ -0,0 +1,11 @@
+export function snakeCase(str) {
+    if (typeof str !== "string") {
+        throw new Error("Input must be a string");
+    }
+    return str
+        .replace(/([a-z])([A-Z])/g, "$1_$2")
+        .replace(/[\s-]+/g, "_")
+        .replace(/[^a-zA-Z0-9_]/g, "")
+        .toLowerCase()
+        .replace(/^_+|_+$/g, "");
+}

package/dist/string/snake-case.js

@@ -0,0 +1,11 @@
+export function snakeCase(str) {
+    if (typeof str !== "string") {
+        throw new Error("Input must be a string");
+    }
+    return str
+        .replace(/([a-z])([A-Z])/g, "$1_$2")
+        .replace(/[\s-]+/g, "_")
+        .replace(/[^a-zA-Z0-9_]/g, "")
+        .toLowerCase()
+        .replace(/^_+|_+$/g, "");
+}

package/dist/string/snake-case.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"snake-case.js","sourceRoot":"","sources":["../../src/string/snake-case.ts"],"names":[],"mappings":";;AAAA,8BAWC;AAXD,SAAgB,SAAS,CAAC,GAAW;IACnC,IAAI,OAAO,GAAG,KAAK,QAAQ,EAAE,CAAC;QAC5B,MAAM,IAAI,KAAK,CAAC,wBAAwB,CAAC,CAAA;IAC3C,CAAC;IAED,OAAO,GAAG;SACP,OAAO,CAAC,iBAAiB,EAAE,OAAO,CAAC;SACnC,OAAO,CAAC,SAAS,EAAE,GAAG,CAAC;SACvB,OAAO,CAAC,gBAAgB,EAAE,EAAE,CAAC;SAC7B,WAAW,EAAE;SACb,OAAO,CAAC,UAAU,EAAE,EAAE,CAAC,CAAA;AAC5B,CAAC"}

package/dist/string/to-sentence-case.d.ts

@@ -0,0 +1,2 @@
+export declare function toSentenceCase(str: string): string;
+//# sourceMappingURL=to-sentence-case.d.ts.map

package/dist/string/to-sentence-case.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"to-sentence-case.d.ts","sourceRoot":"","sources":["../../src/string/to-sentence-case.ts"],"names":[],"mappings":"AAAA,wBAAgB,cAAc,CAAC,GAAG,EAAE,MAAM,UAQzC"}

package/dist/string/to-sentence-case.esm.js

@@ -0,0 +1,9 @@
+export function toSentenceCase(str) {
+    return str
+        .replace(/_/g, " ")
+        .replace(/([A-Z])/g, " $1")
+        .toLowerCase()
+        .replace(/^\w/, (c) => c.toUpperCase())
+        .replace(/\s+/g, " ")
+        .trim();
+}