@karbonjs/utils 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 KarbonJS
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,79 @@
+# @karbonjs/utils
+
+Lightweight utility functions for date, string, number formatting and more. Pure TypeScript, zero dependencies, works with any framework.
+
+## Install
+
+```bash
+npm install @karbonjs/utils
+```
+
+## Date
+
+```typescript
+import { formatDate, formatDateTime, timeAgo, formatMonthYear, isToday, isPast } from '@karbonjs/utils'
+
+formatDate('2026-03-15')                    // "15 mars 2026"
+formatDateTime('2026-03-15T14:30:00')       // "15 mars 2026 à 14:30"
+timeAgo('2026-03-15T10:00:00')             // "Il y a 5h"
+formatMonthYear('2026-03-15')              // "mars 2026"
+
+// English locale
+formatDate('2026-03-15', { locale: 'en-US' })  // "Mar 15, 2026"
+timeAgo('2026-03-15', { locale: 'en' })        // "5h ago"
+```
+
+## String
+
+```typescript
+import { truncate, slugify, capitalize, pluralize, stripHtml, initials, escapeHtml, camelCase, kebabCase } from '@karbonjs/utils'
+
+truncate('Long text here...', 10)           // "Long text ..."
+slugify('Mon Super Article !')              // "mon-super-article"
+capitalize('hello')                         // "Hello"
+pluralize(3, 'article')                     // "3 articles"
+pluralize(1, 'article')                     // "1 article"
+stripHtml('<p>Hello <b>world</b></p>')      // "Hello world"
+initials('John Doe')                        // "JO"
+escapeHtml('<script>alert("xss")</script>') // "&lt;script&gt;..."
+camelCase('my-variable')                    // "myVariable"
+kebabCase('myVariable')                     // "my-variable"
+```
+
+## Number
+
+```typescript
+import { formatSize, formatCount, clamp, formatPercent, formatPrice, randomInt } from '@karbonjs/utils'
+
+formatSize(2_500_000)          // "2.4 Mo"
+formatSize(2_500_000, 'en')    // "2.4 MB"
+formatCount(12345)             // "12 345"
+clamp(150, 0, 100)            // 100
+formatPercent(0.856)           // "85.6%"
+formatPrice(29.99)             // "29,99 €"
+formatPrice(29.99, 'USD', 'en-US')  // "$29.99"
+randomInt(1, 10)               // 7
+```
+
+## Timing
+
+```typescript
+import { debounce, throttle } from '@karbonjs/utils'
+
+const search = debounce(() => fetchResults(), 400)
+const scroll = throttle(() => handleScroll(), 200)
+```
+
+## Cookies
+
+```typescript
+import { setCookie, getCookie, deleteCookie } from '@karbonjs/utils'
+
+setCookie('theme', 'dark', { days: 365 })
+getCookie('theme')              // "dark"
+deleteCookie('theme')
+```
+
+## License
+
+MIT

package/dist/cookie.d.ts

@@ -0,0 +1,19 @@
+export interface CookieOptions {
+    days?: number;
+    path?: string;
+    sameSite?: 'Strict' | 'Lax' | 'None';
+    secure?: boolean;
+}
+/**
+ * Set a client-side cookie.
+ */
+export declare function setCookie(name: string, value: string, opts?: CookieOptions): void;
+/**
+ * Get a client-side cookie value.
+ */
+export declare function getCookie(name: string): string | null;
+/**
+ * Delete a client-side cookie.
+ */
+export declare function deleteCookie(name: string, opts?: CookieOptions): void;
+//# sourceMappingURL=cookie.d.ts.map

package/dist/cookie.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cookie.d.ts","sourceRoot":"","sources":["../src/cookie.ts"],"names":[],"mappings":"AAGA,MAAM,WAAW,aAAa;IAC5B,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,QAAQ,CAAC,EAAE,QAAQ,GAAG,KAAK,GAAG,MAAM,CAAA;IACpC,MAAM,CAAC,EAAE,OAAO,CAAA;CACjB;AAgBD;;GAEG;AACH,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,IAAI,GAAE,aAAkB,GAAG,IAAI,CAKrF;AAED;;GAEG;AACH,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAUrD;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,GAAE,aAAkB,GAAG,IAAI,CAGzE"}

package/dist/cookie.js

@@ -0,0 +1,50 @@
+const IS_BROWSER = typeof document !== 'undefined';
+const IS_SECURE = IS_BROWSER && window.location.protocol === 'https:';
+function buildFlags(opts = {}) {
+    const path = opts.path ?? '/';
+    const sameSite = opts.sameSite ?? 'Strict';
+    const secure = opts.secure ?? (sameSite === 'None' ? true : IS_SECURE);
+    return `path=${path}; SameSite=${sameSite}${secure ? '; Secure' : ''}`;
+}
+/**
+ * Escape special regex characters in a string.
+ */
+function escapeRegex(str) {
+    return str.replace(/[.*+?^${}()|[\]\\]/g, '\\$&');
+}
+/**
+ * Set a client-side cookie.
+ */
+export function setCookie(name, value, opts = {}) {
+    if (!IS_BROWSER)
+        return;
+    const days = opts.days ?? 30;
+    const expires = new Date(Date.now() + days * 864e5).toUTCString();
+    document.cookie = `${name}=${encodeURIComponent(value)}; expires=${expires}; ${buildFlags(opts)}`;
+}
+/**
+ * Get a client-side cookie value.
+ */
+export function getCookie(name) {
+    if (!IS_BROWSER)
+        return null;
+    const escaped = escapeRegex(name);
+    const match = document.cookie.match(new RegExp(`(?:^|; )${escaped}=([^;]*)`));
+    if (!match)
+        return null;
+    try {
+        return decodeURIComponent(match[1]);
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * Delete a client-side cookie.
+ */
+export function deleteCookie(name, opts = {}) {
+    if (!IS_BROWSER)
+        return;
+    document.cookie = `${name}=; expires=Thu, 01 Jan 1970 00:00:00 GMT; ${buildFlags(opts)}`;
+}
+//# sourceMappingURL=cookie.js.map

package/dist/cookie.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cookie.js","sourceRoot":"","sources":["../src/cookie.ts"],"names":[],"mappings":"AAAA,MAAM,UAAU,GAAG,OAAO,QAAQ,KAAK,WAAW,CAAA;AAClD,MAAM,SAAS,GAAG,UAAU,IAAI,MAAM,CAAC,QAAQ,CAAC,QAAQ,KAAK,QAAQ,CAAA;AASrE,SAAS,UAAU,CAAC,OAAsB,EAAE;IAC1C,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,IAAI,GAAG,CAAA;IAC7B,MAAM,QAAQ,GAAG,IAAI,CAAC,QAAQ,IAAI,QAAQ,CAAA;IAC1C,MAAM,MAAM,GAAG,IAAI,CAAC,MAAM,IAAI,CAAC,QAAQ,KAAK,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,SAAS,CAAC,CAAA;IACtE,OAAO,QAAQ,IAAI,cAAc,QAAQ,GAAG,MAAM,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,EAAE,EAAE,CAAA;AACxE,CAAC;AAED;;GAEG;AACH,SAAS,WAAW,CAAC,GAAW;IAC9B,OAAO,GAAG,CAAC,OAAO,CAAC,qBAAqB,EAAE,MAAM,CAAC,CAAA;AACnD,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,SAAS,CAAC,IAAY,EAAE,KAAa,EAAE,OAAsB,EAAE;IAC7E,IAAI,CAAC,UAAU;QAAE,OAAM;IACvB,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,IAAI,EAAE,CAAA;IAC5B,MAAM,OAAO,GAAG,IAAI,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,GAAG,IAAI,GAAG,KAAK,CAAC,CAAC,WAAW,EAAE,CAAA;IACjE,QAAQ,CAAC,MAAM,GAAG,GAAG,IAAI,IAAI,kBAAkB,CAAC,KAAK,CAAC,aAAa,OAAO,KAAK,UAAU,CAAC,IAAI,CAAC,EAAE,CAAA;AACnG,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,SAAS,CAAC,IAAY;IACpC,IAAI,CAAC,UAAU;QAAE,OAAO,IAAI,CAAA;IAC5B,MAAM,OAAO,GAAG,WAAW,CAAC,IAAI,CAAC,CAAA;IACjC,MAAM,KAAK,GAAG,QAAQ,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,MAAM,CAAC,WAAW,OAAO,UAAU,CAAC,CAAC,CAAA;IAC7E,IAAI,CAAC,KAAK;QAAE,OAAO,IAAI,CAAA;IACvB,IAAI,CAAC;QACH,OAAO,kBAAkB,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAA;IACrC,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAA;IACb,CAAC;AACH,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,YAAY,CAAC,IAAY,EAAE,OAAsB,EAAE;IACjE,IAAI,CAAC,UAAU;QAAE,OAAM;IACvB,QAAQ,CAAC,MAAM,GAAG,GAAG,IAAI,6CAA6C,UAAU,CAAC,IAAI,CAAC,EAAE,CAAA;AAC1F,CAAC"}

package/dist/date.d.ts

@@ -0,0 +1,29 @@
+export interface DateFormatOptions {
+    locale?: string;
+}
+/**
+ * Format a date as "14 mars 2026"
+ */
+export declare function formatDate(d: string | Date, opts?: DateFormatOptions): string;
+/**
+ * Format a date+time as "14 mars 2026 à 15:30"
+ */
+export declare function formatDateTime(d: string | Date, opts?: DateFormatOptions): string;
+/**
+ * Relative time: "Il y a 5 min", "Il y a 3j", "Il y a 2 mois"
+ * Supports French (default) and English.
+ */
+export declare function timeAgo(dateStr: string | Date, opts?: DateFormatOptions): string;
+/**
+ * Format as "mars 2026" — useful for "Member since..."
+ */
+export declare function formatMonthYear(d: string | Date, opts?: DateFormatOptions): string;
+/**
+ * Check if a date is today
+ */
+export declare function isToday(d: string | Date): boolean;
+/**
+ * Check if a date is in the past
+ */
+export declare function isPast(d: string | Date): boolean;
+//# sourceMappingURL=date.d.ts.map

package/dist/date.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"date.d.ts","sourceRoot":"","sources":["../src/date.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,iBAAiB;IAChC,MAAM,CAAC,EAAE,MAAM,CAAA;CAChB;AAUD;;GAEG;AACH,wBAAgB,UAAU,CAAC,CAAC,EAAE,MAAM,GAAG,IAAI,EAAE,IAAI,CAAC,EAAE,iBAAiB,GAAG,MAAM,CAM7E;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,CAAC,EAAE,MAAM,GAAG,IAAI,EAAE,IAAI,CAAC,EAAE,iBAAiB,GAAG,MAAM,CAIjF;AAED;;;GAGG;AACH,wBAAgB,OAAO,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,EAAE,IAAI,CAAC,EAAE,iBAAiB,GAAG,MAAM,CA+BhF;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,CAAC,EAAE,MAAM,GAAG,IAAI,EAAE,IAAI,CAAC,EAAE,iBAAiB,GAAG,MAAM,CAElF;AAED;;GAEG;AACH,wBAAgB,OAAO,CAAC,CAAC,EAAE,MAAM,GAAG,IAAI,GAAG,OAAO,CAIjD;AAED;;GAEG;AACH,wBAAgB,MAAM,CAAC,CAAC,EAAE,MAAM,GAAG,IAAI,GAAG,OAAO,CAEhD"}

package/dist/date.js

@@ -0,0 +1,88 @@
+const DEFAULT_LOCALE = 'fr-FR';
+function toDate(d) {
+    const date = new Date(d);
+    if (isNaN(date.getTime()))
+        return new Date();
+    return date;
+}
+/**
+ * Format a date as "14 mars 2026"
+ */
+export function formatDate(d, opts) {
+    return toDate(d).toLocaleDateString(opts?.locale ?? DEFAULT_LOCALE, {
+        day: '2-digit',
+        month: 'short',
+        year: 'numeric',
+    });
+}
+/**
+ * Format a date+time as "14 mars 2026 à 15:30"
+ */
+export function formatDateTime(d, opts) {
+    const locale = opts?.locale ?? DEFAULT_LOCALE;
+    const date = toDate(d);
+    return `${formatDate(date, opts)} à ${date.toLocaleTimeString(locale, { hour: '2-digit', minute: '2-digit' })}`;
+}
+/**
+ * Relative time: "Il y a 5 min", "Il y a 3j", "Il y a 2 mois"
+ * Supports French (default) and English.
+ */
+export function timeAgo(dateStr, opts) {
+    const locale = opts?.locale ?? DEFAULT_LOCALE;
+    const fr = locale.startsWith('fr');
+    const date = toDate(dateStr);
+    const diff = Date.now() - date.getTime();
+    // Future date
+    if (diff < 0)
+        return fr ? "À l'instant" : 'Just now';
+    const minutes = Math.floor(diff / 60_000);
+    const hours = Math.floor(diff / 3_600_000);
+    const days = Math.floor(diff / 86_400_000);
+    const months = Math.floor(days / 30);
+    const years = Math.floor(months / 12);
+    if (fr) {
+        if (minutes < 1)
+            return "À l'instant";
+        if (minutes < 60)
+            return `Il y a ${minutes} min`;
+        if (hours < 24)
+            return `Il y a ${hours}h`;
+        if (days < 30)
+            return `Il y a ${days}j`;
+        if (months < 12)
+            return `Il y a ${months} mois`;
+        return `Il y a ${years} an${years > 1 ? 's' : ''}`;
+    }
+    if (minutes < 1)
+        return 'Just now';
+    if (minutes < 60)
+        return `${minutes}m ago`;
+    if (hours < 24)
+        return `${hours}h ago`;
+    if (days < 30)
+        return `${days}d ago`;
+    if (months < 12)
+        return `${months}mo ago`;
+    return `${years}y ago`;
+}
+/**
+ * Format as "mars 2026" — useful for "Member since..."
+ */
+export function formatMonthYear(d, opts) {
+    return toDate(d).toLocaleDateString(opts?.locale ?? DEFAULT_LOCALE, { month: 'long', year: 'numeric' });
+}
+/**
+ * Check if a date is today
+ */
+export function isToday(d) {
+    const date = toDate(d);
+    const now = new Date();
+    return date.getFullYear() === now.getFullYear() && date.getMonth() === now.getMonth() && date.getDate() === now.getDate();
+}
+/**
+ * Check if a date is in the past
+ */
+export function isPast(d) {
+    return toDate(d).getTime() < Date.now();
+}
+//# sourceMappingURL=date.js.map

package/dist/date.js.map

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

package/dist/date.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=date.test.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"date.test.d.ts","sourceRoot":"","sources":["../src/date.test.ts"],"names":[],"mappings":""}

package/dist/date.test.js

@@ -0,0 +1,53 @@
+import { describe, it, expect } from 'vitest';
+import { formatDate, formatDateTime, timeAgo, formatMonthYear, isToday, isPast } from './date';
+describe('formatDate', () => {
+    it('formats date in French by default', () => {
+        const result = formatDate('2026-03-14');
+        expect(result).toMatch(/14/);
+        expect(result).toMatch(/2026/);
+    });
+    it('accepts locale override', () => {
+        const result = formatDate('2026-03-14', { locale: 'en-US' });
+        expect(result).toMatch(/14/);
+        expect(result).toMatch(/2026/);
+    });
+});
+describe('formatDateTime', () => {
+    it('includes time', () => {
+        const result = formatDateTime('2026-03-14T15:30:00');
+        expect(result).toMatch(/15/);
+        expect(result).toMatch(/30/);
+    });
+});
+describe('timeAgo', () => {
+    it('returns "À l\'instant" for recent dates in French', () => {
+        expect(timeAgo(new Date().toISOString())).toBe("À l'instant");
+    });
+    it('returns "Just now" for English locale', () => {
+        expect(timeAgo(new Date().toISOString(), { locale: 'en-US' })).toBe('Just now');
+    });
+});
+describe('formatMonthYear', () => {
+    it('formats month and year in French', () => {
+        const result = formatMonthYear('2026-03-14');
+        expect(result).toMatch(/2026/);
+    });
+});
+describe('isToday', () => {
+    it('returns true for today', () => {
+        expect(isToday(new Date())).toBe(true);
+    });
+    it('returns false for yesterday', () => {
+        const yesterday = new Date(Date.now() - 86_400_000);
+        expect(isToday(yesterday)).toBe(false);
+    });
+});
+describe('isPast', () => {
+    it('returns true for past date', () => {
+        expect(isPast('2020-01-01')).toBe(true);
+    });
+    it('returns false for future date', () => {
+        expect(isPast('2099-01-01')).toBe(false);
+    });
+});
+//# sourceMappingURL=date.test.js.map

package/dist/date.test.js.map

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

package/dist/debounce.d.ts

@@ -0,0 +1,22 @@
+export interface Cancelable {
+    cancel: () => void;
+}
+/**
+ * Create a debounced version of a function.
+ * The call is delayed by `ms` milliseconds; any new call resets the timer.
+ * Call `.cancel()` to clear pending execution.
+ *
+ * ```ts
+ * const debouncedSearch = debounce(() => loadItems(), 400)
+ * input.addEventListener('input', debouncedSearch)
+ * // cleanup: debouncedSearch.cancel()
+ * ```
+ */
+export declare function debounce<T extends (...args: any[]) => void>(fn: T, ms?: number): T & Cancelable;
+/**
+ * Create a throttled version of a function.
+ * The function is called at most once every `ms` milliseconds.
+ * Call `.cancel()` to reset the throttle.
+ */
+export declare function throttle<T extends (...args: any[]) => void>(fn: T, ms?: number): T & Cancelable;
+//# sourceMappingURL=debounce.d.ts.map

package/dist/debounce.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"debounce.d.ts","sourceRoot":"","sources":["../src/debounce.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,UAAU;IACzB,MAAM,EAAE,MAAM,IAAI,CAAA;CACnB;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,QAAQ,CAAC,CAAC,SAAS,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,IAAI,EAAE,EAAE,EAAE,CAAC,EAAE,EAAE,SAAM,GAAG,CAAC,GAAG,UAAU,CAQ5F;AAED;;;;GAIG;AACH,wBAAgB,QAAQ,CAAC,CAAC,SAAS,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,IAAI,EAAE,EAAE,EAAE,CAAC,EAAE,EAAE,SAAM,GAAG,CAAC,GAAG,UAAU,CAW5F"}

package/dist/debounce.js

@@ -0,0 +1,42 @@
+/**
+ * Create a debounced version of a function.
+ * The call is delayed by `ms` milliseconds; any new call resets the timer.
+ * Call `.cancel()` to clear pending execution.
+ *
+ * ```ts
+ * const debouncedSearch = debounce(() => loadItems(), 400)
+ * input.addEventListener('input', debouncedSearch)
+ * // cleanup: debouncedSearch.cancel()
+ * ```
+ */
+export function debounce(fn, ms = 400) {
+    let timer = null;
+    const debounced = ((...args) => {
+        if (timer)
+            clearTimeout(timer);
+        timer = setTimeout(() => { timer = null; fn(...args); }, ms);
+    });
+    debounced.cancel = () => { if (timer) {
+        clearTimeout(timer);
+        timer = null;
+    } };
+    return debounced;
+}
+/**
+ * Create a throttled version of a function.
+ * The function is called at most once every `ms` milliseconds.
+ * Call `.cancel()` to reset the throttle.
+ */
+export function throttle(fn, ms = 200) {
+    let last = 0;
+    const throttled = ((...args) => {
+        const now = Date.now();
+        if (now - last >= ms) {
+            last = now;
+            fn(...args);
+        }
+    });
+    throttled.cancel = () => { last = 0; };
+    return throttled;
+}
+//# sourceMappingURL=debounce.js.map

package/dist/debounce.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"debounce.js","sourceRoot":"","sources":["../src/debounce.ts"],"names":[],"mappings":"AAIA;;;;;;;;;;GAUG;AACH,MAAM,UAAU,QAAQ,CAAqC,EAAK,EAAE,EAAE,GAAG,GAAG;IAC1E,IAAI,KAAK,GAAyC,IAAI,CAAA;IACtD,MAAM,SAAS,GAAG,CAAC,CAAC,GAAG,IAAW,EAAE,EAAE;QACpC,IAAI,KAAK;YAAE,YAAY,CAAC,KAAK,CAAC,CAAA;QAC9B,KAAK,GAAG,UAAU,CAAC,GAAG,EAAE,GAAG,KAAK,GAAG,IAAI,CAAC,CAAC,EAAE,CAAC,GAAG,IAAI,CAAC,CAAA,CAAC,CAAC,EAAE,EAAE,CAAC,CAAA;IAC7D,CAAC,CAA8B,CAAA;IAC/B,SAAS,CAAC,MAAM,GAAG,GAAG,EAAE,GAAG,IAAI,KAAK,EAAE,CAAC;QAAC,YAAY,CAAC,KAAK,CAAC,CAAC;QAAC,KAAK,GAAG,IAAI,CAAA;IAAC,CAAC,CAAC,CAAC,CAAA;IAC7E,OAAO,SAAS,CAAA;AAClB,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,QAAQ,CAAqC,EAAK,EAAE,EAAE,GAAG,GAAG;IAC1E,IAAI,IAAI,GAAG,CAAC,CAAA;IACZ,MAAM,SAAS,GAAG,CAAC,CAAC,GAAG,IAAW,EAAE,EAAE;QACpC,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,EAAE,CAAA;QACtB,IAAI,GAAG,GAAG,IAAI,IAAI,EAAE,EAAE,CAAC;YACrB,IAAI,GAAG,GAAG,CAAA;YACV,EAAE,CAAC,GAAG,IAAI,CAAC,CAAA;QACb,CAAC;IACH,CAAC,CAA8B,CAAA;IAC/B,SAAS,CAAC,MAAM,GAAG,GAAG,EAAE,GAAG,IAAI,GAAG,CAAC,CAAA,CAAC,CAAC,CAAA;IACrC,OAAO,SAAS,CAAA;AAClB,CAAC"}

package/dist/debounce.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=debounce.test.d.ts.map

package/dist/debounce.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"debounce.test.d.ts","sourceRoot":"","sources":["../src/debounce.test.ts"],"names":[],"mappings":""}

package/dist/debounce.test.js

@@ -0,0 +1,49 @@
+import { describe, it, expect, vi } from 'vitest';
+import { debounce, throttle } from './debounce';
+describe('debounce', () => {
+    it('delays execution', async () => {
+        vi.useFakeTimers();
+        const fn = vi.fn();
+        const debounced = debounce(fn, 100);
+        debounced();
+        expect(fn).not.toHaveBeenCalled();
+        vi.advanceTimersByTime(100);
+        expect(fn).toHaveBeenCalledTimes(1);
+        vi.useRealTimers();
+    });
+    it('resets timer on subsequent calls', () => {
+        vi.useFakeTimers();
+        const fn = vi.fn();
+        const debounced = debounce(fn, 100);
+        debounced();
+        vi.advanceTimersByTime(50);
+        debounced();
+        vi.advanceTimersByTime(50);
+        expect(fn).not.toHaveBeenCalled();
+        vi.advanceTimersByTime(50);
+        expect(fn).toHaveBeenCalledTimes(1);
+        vi.useRealTimers();
+    });
+});
+describe('throttle', () => {
+    it('executes immediately on first call', () => {
+        const fn = vi.fn();
+        const throttled = throttle(fn, 100);
+        throttled();
+        expect(fn).toHaveBeenCalledTimes(1);
+    });
+    it('blocks subsequent calls within interval', () => {
+        vi.useFakeTimers();
+        const fn = vi.fn();
+        const throttled = throttle(fn, 100);
+        throttled();
+        throttled();
+        throttled();
+        expect(fn).toHaveBeenCalledTimes(1);
+        vi.advanceTimersByTime(100);
+        throttled();
+        expect(fn).toHaveBeenCalledTimes(2);
+        vi.useRealTimers();
+    });
+});
+//# sourceMappingURL=debounce.test.js.map

package/dist/debounce.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"debounce.test.js","sourceRoot":"","sources":["../src/debounce.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,QAAQ,CAAA;AACjD,OAAO,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAA;AAE/C,QAAQ,CAAC,UAAU,EAAE,GAAG,EAAE;IACxB,EAAE,CAAC,kBAAkB,EAAE,KAAK,IAAI,EAAE;QAChC,EAAE,CAAC,aAAa,EAAE,CAAA;QAClB,MAAM,EAAE,GAAG,EAAE,CAAC,EAAE,EAAE,CAAA;QAClB,MAAM,SAAS,GAAG,QAAQ,CAAC,EAAE,EAAE,GAAG,CAAC,CAAA;QAEnC,SAAS,EAAE,CAAA;QACX,MAAM,CAAC,EAAE,CAAC,CAAC,GAAG,CAAC,gBAAgB,EAAE,CAAA;QAEjC,EAAE,CAAC,mBAAmB,CAAC,GAAG,CAAC,CAAA;QAC3B,MAAM,CAAC,EAAE,CAAC,CAAC,qBAAqB,CAAC,CAAC,CAAC,CAAA;QAEnC,EAAE,CAAC,aAAa,EAAE,CAAA;IACpB,CAAC,CAAC,CAAA;IAEF,EAAE,CAAC,kCAAkC,EAAE,GAAG,EAAE;QAC1C,EAAE,CAAC,aAAa,EAAE,CAAA;QAClB,MAAM,EAAE,GAAG,EAAE,CAAC,EAAE,EAAE,CAAA;QAClB,MAAM,SAAS,GAAG,QAAQ,CAAC,EAAE,EAAE,GAAG,CAAC,CAAA;QAEnC,SAAS,EAAE,CAAA;QACX,EAAE,CAAC,mBAAmB,CAAC,EAAE,CAAC,CAAA;QAC1B,SAAS,EAAE,CAAA;QACX,EAAE,CAAC,mBAAmB,CAAC,EAAE,CAAC,CAAA;QAC1B,MAAM,CAAC,EAAE,CAAC,CAAC,GAAG,CAAC,gBAAgB,EAAE,CAAA;QAEjC,EAAE,CAAC,mBAAmB,CAAC,EAAE,CAAC,CAAA;QAC1B,MAAM,CAAC,EAAE,CAAC,CAAC,qBAAqB,CAAC,CAAC,CAAC,CAAA;QAEnC,EAAE,CAAC,aAAa,EAAE,CAAA;IACpB,CAAC,CAAC,CAAA;AACJ,CAAC,CAAC,CAAA;AAEF,QAAQ,CAAC,UAAU,EAAE,GAAG,EAAE;IACxB,EAAE,CAAC,oCAAoC,EAAE,GAAG,EAAE;QAC5C,MAAM,EAAE,GAAG,EAAE,CAAC,EAAE,EAAE,CAAA;QAClB,MAAM,SAAS,GAAG,QAAQ,CAAC,EAAE,EAAE,GAAG,CAAC,CAAA;QACnC,SAAS,EAAE,CAAA;QACX,MAAM,CAAC,EAAE,CAAC,CAAC,qBAAqB,CAAC,CAAC,CAAC,CAAA;IACrC,CAAC,CAAC,CAAA;IAEF,EAAE,CAAC,yCAAyC,EAAE,GAAG,EAAE;QACjD,EAAE,CAAC,aAAa,EAAE,CAAA;QAClB,MAAM,EAAE,GAAG,EAAE,CAAC,EAAE,EAAE,CAAA;QAClB,MAAM,SAAS,GAAG,QAAQ,CAAC,EAAE,EAAE,GAAG,CAAC,CAAA;QAEnC,SAAS,EAAE,CAAA;QACX,SAAS,EAAE,CAAA;QACX,SAAS,EAAE,CAAA;QACX,MAAM,CAAC,EAAE,CAAC,CAAC,qBAAqB,CAAC,CAAC,CAAC,CAAA;QAEnC,EAAE,CAAC,mBAAmB,CAAC,GAAG,CAAC,CAAA;QAC3B,SAAS,EAAE,CAAA;QACX,MAAM,CAAC,EAAE,CAAC,CAAC,qBAAqB,CAAC,CAAC,CAAC,CAAA;QAEnC,EAAE,CAAC,aAAa,EAAE,CAAA;IACpB,CAAC,CAAC,CAAA;AACJ,CAAC,CAAC,CAAA"}

package/dist/index.d.ts

@@ -0,0 +1,9 @@
+export { formatDate, formatDateTime, timeAgo, formatMonthYear, isToday, isPast } from './date';
+export type { DateFormatOptions } from './date';
+export { truncate, slugify, capitalize, pluralize, stripHtml, initials, hashColorIndex, escapeHtml, camelCase, kebabCase, isImage } from './string';
+export { formatSize, formatCount, clamp, formatPercent, formatPrice, randomInt } from './number';
+export { debounce, throttle } from './debounce';
+export type { Cancelable } from './debounce';
+export { setCookie, getCookie, deleteCookie } from './cookie';
+export type { CookieOptions } from './cookie';
+//# 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":"AAAA,OAAO,EAAE,UAAU,EAAE,cAAc,EAAE,OAAO,EAAE,eAAe,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAA;AAC9F,YAAY,EAAE,iBAAiB,EAAE,MAAM,QAAQ,CAAA;AAE/C,OAAO,EAAE,QAAQ,EAAE,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,SAAS,EAAE,QAAQ,EAAE,cAAc,EAAE,UAAU,EAAE,SAAS,EAAE,SAAS,EAAE,OAAO,EAAE,MAAM,UAAU,CAAA;AAEnJ,OAAO,EAAE,UAAU,EAAE,WAAW,EAAE,KAAK,EAAE,aAAa,EAAE,WAAW,EAAE,SAAS,EAAE,MAAM,UAAU,CAAA;AAEhG,OAAO,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAA;AAC/C,YAAY,EAAE,UAAU,EAAE,MAAM,YAAY,CAAA;AAE5C,OAAO,EAAE,SAAS,EAAE,SAAS,EAAE,YAAY,EAAE,MAAM,UAAU,CAAA;AAC7D,YAAY,EAAE,aAAa,EAAE,MAAM,UAAU,CAAA"}

package/dist/index.js

@@ -0,0 +1,6 @@
+export { formatDate, formatDateTime, timeAgo, formatMonthYear, isToday, isPast } from './date';
+export { truncate, slugify, capitalize, pluralize, stripHtml, initials, hashColorIndex, escapeHtml, camelCase, kebabCase, isImage } from './string';
+export { formatSize, formatCount, clamp, formatPercent, formatPrice, randomInt } from './number';
+export { debounce, throttle } from './debounce';
+export { setCookie, getCookie, deleteCookie } from './cookie';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,cAAc,EAAE,OAAO,EAAE,eAAe,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAA;AAG9F,OAAO,EAAE,QAAQ,EAAE,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,SAAS,EAAE,QAAQ,EAAE,cAAc,EAAE,UAAU,EAAE,SAAS,EAAE,SAAS,EAAE,OAAO,EAAE,MAAM,UAAU,CAAA;AAEnJ,OAAO,EAAE,UAAU,EAAE,WAAW,EAAE,KAAK,EAAE,aAAa,EAAE,WAAW,EAAE,SAAS,EAAE,MAAM,UAAU,CAAA;AAEhG,OAAO,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAA;AAG/C,OAAO,EAAE,SAAS,EAAE,SAAS,EAAE,YAAY,EAAE,MAAM,UAAU,CAAA"}

package/dist/number.d.ts

@@ -0,0 +1,29 @@
+/**
+ * Format bytes to human-readable size.
+ * formatSize(1536) → "1.5 Ko" (fr) or "1.5 KB" (en)
+ */
+export declare function formatSize(bytes: number, locale?: string): string;
+/**
+ * Format a number with locale separators.
+ * formatCount(12345) → "12 345" (fr) or "12,345" (en)
+ */
+export declare function formatCount(n: number, locale?: string): string;
+/**
+ * Clamp a value between min and max.
+ */
+export declare function clamp(value: number, min: number, max: number): number;
+/**
+ * Format a ratio as percentage.
+ * formatPercent(0.856) → "85.6%"
+ */
+export declare function formatPercent(ratio: number, decimals?: number): string;
+/**
+ * Format a price with currency.
+ * formatPrice(29.99) → "29,99 €" (fr) or "$29.99" (en)
+ */
+export declare function formatPrice(amount: number, currency?: string, locale?: string): string;
+/**
+ * Generate a random integer between min and max (inclusive).
+ */
+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;;;GAGG;AACH,wBAAgB,UAAU,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,SAAO,GAAG,MAAM,CAS/D;AAED;;;GAGG;AACH,wBAAgB,WAAW,CAAC,CAAC,EAAE,MAAM,EAAE,MAAM,SAAU,GAAG,MAAM,CAE/D;AAED;;GAEG;AACH,wBAAgB,KAAK,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,CAErE;AAED;;;GAGG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,MAAM,EAAE,QAAQ,SAAI,GAAG,MAAM,CAGjE;AAED;;;GAGG;AACH,wBAAgB,WAAW,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,SAAQ,EAAE,MAAM,SAAU,GAAG,MAAM,CAMtF;AAED;;GAEG;AACH,wBAAgB,SAAS,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,CAE1D"}

package/dist/number.js

@@ -0,0 +1,57 @@
+/**
+ * Format bytes to human-readable size.
+ * formatSize(1536) → "1.5 Ko" (fr) or "1.5 KB" (en)
+ */
+export function formatSize(bytes, locale = 'fr') {
+    const fr = locale.startsWith('fr');
+    const units = fr ? ['o', 'Ko', 'Mo', 'Go', 'To'] : ['B', 'KB', 'MB', 'GB', 'TB'];
+    if (bytes < 1024)
+        return `${bytes} ${units[0]}`;
+    if (bytes < 1_048_576)
+        return `${(bytes / 1024).toFixed(1)} ${units[1]}`;
+    if (bytes < 1_073_741_824)
+        return `${(bytes / 1_048_576).toFixed(1)} ${units[2]}`;
+    if (bytes < 1_099_511_627_776)
+        return `${(bytes / 1_073_741_824).toFixed(1)} ${units[3]}`;
+    return `${(bytes / 1_099_511_627_776).toFixed(1)} ${units[4]}`;
+}
+/**
+ * Format a number with locale separators.
+ * formatCount(12345) → "12 345" (fr) or "12,345" (en)
+ */
+export function formatCount(n, locale = 'fr-FR') {
+    return n.toLocaleString(locale);
+}
+/**
+ * Clamp a value between min and max.
+ */
+export function clamp(value, min, max) {
+    return Math.min(Math.max(value, min), max);
+}
+/**
+ * Format a ratio as percentage.
+ * formatPercent(0.856) → "85.6%"
+ */
+export function formatPercent(ratio, decimals = 1) {
+    const d = Math.max(0, Math.min(decimals, 20));
+    return `${(ratio * 100).toFixed(d)}%`;
+}
+/**
+ * Format a price with currency.
+ * formatPrice(29.99) → "29,99 €" (fr) or "$29.99" (en)
+ */
+export function formatPrice(amount, currency = 'EUR', locale = 'fr-FR') {
+    try {
+        return new Intl.NumberFormat(locale, { style: 'currency', currency }).format(amount);
+    }
+    catch {
+        return `${amount.toFixed(2)} ${currency}`;
+    }
+}
+/**
+ * Generate a random integer between min and max (inclusive).
+ */
+export function randomInt(min, max) {
+    return Math.floor(Math.random() * (max - min + 1)) + min;
+}
+//# sourceMappingURL=number.js.map

package/dist/number.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"number.js","sourceRoot":"","sources":["../src/number.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,MAAM,UAAU,UAAU,CAAC,KAAa,EAAE,MAAM,GAAG,IAAI;IACrD,MAAM,EAAE,GAAG,MAAM,CAAC,UAAU,CAAC,IAAI,CAAC,CAAA;IAClC,MAAM,KAAK,GAAG,EAAE,CAAC,CAAC,CAAC,CAAC,GAAG,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,CAAC,CAAA;IAEhF,IAAI,KAAK,GAAG,IAAI;QAAE,OAAO,GAAG,KAAK,IAAI,KAAK,CAAC,CAAC,CAAC,EAAE,CAAA;IAC/C,IAAI,KAAK,GAAG,SAAS;QAAE,OAAO,GAAG,CAAC,KAAK,GAAG,IAAI,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,KAAK,CAAC,CAAC,CAAC,EAAE,CAAA;IACxE,IAAI,KAAK,GAAG,aAAa;QAAE,OAAO,GAAG,CAAC,KAAK,GAAG,SAAS,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,KAAK,CAAC,CAAC,CAAC,EAAE,CAAA;IACjF,IAAI,KAAK,GAAG,iBAAiB;QAAE,OAAO,GAAG,CAAC,KAAK,GAAG,aAAa,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,KAAK,CAAC,CAAC,CAAC,EAAE,CAAA;IACzF,OAAO,GAAG,CAAC,KAAK,GAAG,iBAAiB,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,KAAK,CAAC,CAAC,CAAC,EAAE,CAAA;AAChE,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,WAAW,CAAC,CAAS,EAAE,MAAM,GAAG,OAAO;IACrD,OAAO,CAAC,CAAC,cAAc,CAAC,MAAM,CAAC,CAAA;AACjC,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,KAAK,CAAC,KAAa,EAAE,GAAW,EAAE,GAAW;IAC3D,OAAO,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,KAAK,EAAE,GAAG,CAAC,EAAE,GAAG,CAAC,CAAA;AAC5C,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,aAAa,CAAC,KAAa,EAAE,QAAQ,GAAG,CAAC;IACvD,MAAM,CAAC,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,GAAG,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC,CAAA;IAC7C,OAAO,GAAG,CAAC,KAAK,GAAG,GAAG,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG,CAAA;AACvC,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,WAAW,CAAC,MAAc,EAAE,QAAQ,GAAG,KAAK,EAAE,MAAM,GAAG,OAAO;IAC5E,IAAI,CAAC;QACH,OAAO,IAAI,IAAI,CAAC,YAAY,CAAC,MAAM,EAAE,EAAE,KAAK,EAAE,UAAU,EAAE,QAAQ,EAAE,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,CAAA;IACtF,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,GAAG,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,QAAQ,EAAE,CAAA;IAC3C,CAAC;AACH,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,SAAS,CAAC,GAAW,EAAE,GAAW;IAChD,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/number.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=number.test.d.ts.map

package/dist/number.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"number.test.d.ts","sourceRoot":"","sources":["../src/number.test.ts"],"names":[],"mappings":""}

package/dist/number.test.js

@@ -0,0 +1,56 @@
+import { describe, it, expect } from 'vitest';
+import { formatSize, formatCount, clamp, formatPercent, formatPrice, randomInt } from './number';
+describe('formatSize', () => {
+    it('formats bytes in French', () => {
+        expect(formatSize(500)).toBe('500 o');
+        expect(formatSize(1536)).toBe('1.5 Ko');
+    });
+    it('formats bytes in English', () => {
+        expect(formatSize(500, 'en')).toBe('500 B');
+        expect(formatSize(1536, 'en')).toBe('1.5 KB');
+    });
+    it('handles large sizes', () => {
+        expect(formatSize(1_073_741_824)).toBe('1.0 Go');
+    });
+});
+describe('formatCount', () => {
+    it('formats with French separators by default', () => {
+        const result = formatCount(12345);
+        // French uses non-breaking space or narrow no-break space
+        expect(result.replace(/\s/g, ' ')).toContain('12');
+        expect(result.replace(/\s/g, ' ')).toContain('345');
+    });
+});
+describe('clamp', () => {
+    it('clamps value between min and max', () => {
+        expect(clamp(5, 0, 10)).toBe(5);
+        expect(clamp(-5, 0, 10)).toBe(0);
+        expect(clamp(15, 0, 10)).toBe(10);
+    });
+});
+describe('formatPercent', () => {
+    it('formats ratio as percentage', () => {
+        expect(formatPercent(0.856)).toBe('85.6%');
+        expect(formatPercent(1)).toBe('100.0%');
+    });
+    it('supports custom decimals', () => {
+        expect(formatPercent(0.856, 0)).toBe('86%');
+    });
+});
+describe('formatPrice', () => {
+    it('formats in French EUR by default', () => {
+        const result = formatPrice(29.99);
+        expect(result).toContain('29');
+        expect(result).toContain('99');
+    });
+});
+describe('randomInt', () => {
+    it('returns value within range', () => {
+        for (let i = 0; i < 100; i++) {
+            const val = randomInt(1, 10);
+            expect(val).toBeGreaterThanOrEqual(1);
+            expect(val).toBeLessThanOrEqual(10);
+        }
+    });
+});
+//# sourceMappingURL=number.test.js.map

package/dist/number.test.js.map

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

package/dist/string.d.ts

@@ -0,0 +1,55 @@
+/**
+ * Truncate text to `len` characters with "..."
+ */
+export declare function truncate(text: string, len: number, suffix?: string): string;
+/**
+ * Generate a URL-safe slug from text.
+ * "Mon Super Article !" → "mon-super-article"
+ */
+export declare function slugify(text: string): string;
+/**
+ * Capitalize first letter.
+ */
+export declare function capitalize(text: string): string;
+/**
+ * Simple pluralization.
+ * pluralize(3, "article") → "3 articles"
+ * pluralize(1, "article") → "1 article"
+ */
+export declare function pluralize(count: number, word: string, plural?: string): string;
+/**
+ * Strip HTML tags from a string.
+ * For untrusted HTML, prefer a proper sanitizer (DOMPurify).
+ */
+export declare function stripHtml(html: string): string;
+/**
+ * Get initials from a name (first 2 letters, uppercased).
+ */
+export declare function initials(name: string): string;
+/**
+ * Deterministic hash-based color index from a string.
+ * Same string always returns the same index.
+ * Use with your own color palette.
+ */
+export declare function hashColorIndex(name: string, paletteSize: number): number;
+/**
+ * Escape HTML entities to prevent XSS.
+ */
+export declare function escapeHtml(text: string): string;
+/**
+ * Convert a string to camelCase.
+ * "my-variable-name" → "myVariableName"
+ */
+export declare function camelCase(str: string): string;
+/**
+ * Convert a string to kebab-case.
+ * "myVariableName" → "my-variable-name"
+ */
+export declare function kebabCase(str: string): string;
+/**
+ * Check if a filename or URL points to an image.
+ * isImage("photo.jpg") → true
+ * isImage("doc.pdf") → false
+ */
+export declare function isImage(filename: string): boolean;
+//# sourceMappingURL=string.d.ts.map

package/dist/string.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"string.d.ts","sourceRoot":"","sources":["../src/string.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,wBAAgB,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,MAAM,SAAQ,GAAG,MAAM,CAE1E;AAED;;;GAGG;AACH,wBAAgB,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAO5C;AAED;;GAEG;AACH,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAG/C;AAED;;;;GAIG;AACH,wBAAgB,SAAS,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,MAAM,CAG9E;AAED;;;GAGG;AACH,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAE9C;AAED;;GAEG;AACH,wBAAgB,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAE7C;AAED;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,MAAM,CAKxE;AAED;;GAEG;AACH,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAO/C;AAED;;;GAGG;AACH,wBAAgB,SAAS,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAE7C;AAED;;;GAGG;AACH,wBAAgB,SAAS,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAE7C;AAID;;;;GAIG;AACH,wBAAgB,OAAO,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAGjD"}

package/dist/string.js

@@ -0,0 +1,97 @@
+/**
+ * Truncate text to `len` characters with "..."
+ */
+export function truncate(text, len, suffix = '...') {
+    return text.length > len ? text.slice(0, len) + suffix : text;
+}
+/**
+ * Generate a URL-safe slug from text.
+ * "Mon Super Article !" → "mon-super-article"
+ */
+export function slugify(text) {
+    return text
+        .toLowerCase()
+        .normalize('NFD')
+        .replace(/[\u0300-\u036f]/g, '')
+        .replace(/[^a-z0-9]+/g, '-')
+        .replace(/(^-|-$)/g, '');
+}
+/**
+ * Capitalize first letter.
+ */
+export function capitalize(text) {
+    if (!text)
+        return '';
+    return text.charAt(0).toUpperCase() + text.slice(1);
+}
+/**
+ * Simple pluralization.
+ * pluralize(3, "article") → "3 articles"
+ * pluralize(1, "article") → "1 article"
+ */
+export function pluralize(count, word, plural) {
+    const form = count > 1 ? (plural ?? word + 's') : word;
+    return `${count} ${form}`;
+}
+/**
+ * Strip HTML tags from a string.
+ * For untrusted HTML, prefer a proper sanitizer (DOMPurify).
+ */
+export function stripHtml(html) {
+    return html.replace(/<[^>]*?>/g, '').replace(/</g, '&lt;');
+}
+/**
+ * Get initials from a name (first 2 letters, uppercased).
+ */
+export function initials(name) {
+    return (name ?? 'A').slice(0, 2).toUpperCase();
+}
+/**
+ * Deterministic hash-based color index from a string.
+ * Same string always returns the same index.
+ * Use with your own color palette.
+ */
+export function hashColorIndex(name, paletteSize) {
+    if (paletteSize <= 0)
+        return 0;
+    let hash = 0;
+    for (let i = 0; i < name.length; i++)
+        hash = name.charCodeAt(i) + ((hash << 5) - hash);
+    return Math.abs(hash) % paletteSize;
+}
+/**
+ * Escape HTML entities to prevent XSS.
+ */
+export function escapeHtml(text) {
+    return text
+        .replace(/&/g, '&amp;')
+        .replace(/</g, '&lt;')
+        .replace(/>/g, '&gt;')
+        .replace(/"/g, '&quot;')
+        .replace(/'/g, '&#039;');
+}
+/**
+ * Convert a string to camelCase.
+ * "my-variable-name" → "myVariableName"
+ */
+export function camelCase(str) {
+    return str.replace(/[-_]+(.)?/g, (_, c) => (c ? c.toUpperCase() : ''));
+}
+/**
+ * Convert a string to kebab-case.
+ * "myVariableName" → "my-variable-name"
+ */
+export function kebabCase(str) {
+    return str.replace(/([a-z])([A-Z])/g, '$1-$2').replace(/[\s_]+/g, '-').toLowerCase();
+}
+const IMAGE_EXTENSIONS = new Set(['jpg', 'jpeg', 'png', 'gif', 'webp', 'avif', 'svg', 'bmp', 'ico']);
+/**
+ * Check if a filename or URL points to an image.
+ * isImage("photo.jpg") → true
+ * isImage("doc.pdf") → false
+ */
+export function isImage(filename) {
+    const ext = filename.split('.').pop()?.toLowerCase() ?? '';
+    return IMAGE_EXTENSIONS.has(ext);
+}
+//# sourceMappingURL=string.js.map

package/dist/string.js.map

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

package/dist/string.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=string.test.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"string.test.d.ts","sourceRoot":"","sources":["../src/string.test.ts"],"names":[],"mappings":""}

package/dist/string.test.js

@@ -0,0 +1,102 @@
+import { describe, it, expect } from 'vitest';
+import { truncate, slugify, capitalize, pluralize, stripHtml, initials, hashColorIndex, escapeHtml, camelCase, kebabCase, isImage } from './string';
+describe('truncate', () => {
+    it('returns short text unchanged', () => {
+        expect(truncate('hello', 10)).toBe('hello');
+    });
+    it('truncates long text with suffix', () => {
+        expect(truncate('hello world', 5)).toBe('hello...');
+    });
+    it('supports custom suffix', () => {
+        expect(truncate('hello world', 5, '…')).toBe('hello…');
+    });
+});
+describe('slugify', () => {
+    it('converts text to slug', () => {
+        expect(slugify('Mon Super Article !')).toBe('mon-super-article');
+    });
+    it('handles accents', () => {
+        expect(slugify('Éléphant à la crème')).toBe('elephant-a-la-creme');
+    });
+    it('handles empty string', () => {
+        expect(slugify('')).toBe('');
+    });
+});
+describe('capitalize', () => {
+    it('capitalizes first letter', () => {
+        expect(capitalize('hello')).toBe('Hello');
+    });
+    it('handles empty string', () => {
+        expect(capitalize('')).toBe('');
+    });
+});
+describe('pluralize', () => {
+    it('returns singular for 1', () => {
+        expect(pluralize(1, 'article')).toBe('1 article');
+    });
+    it('returns plural for > 1', () => {
+        expect(pluralize(3, 'article')).toBe('3 articles');
+    });
+    it('supports custom plural', () => {
+        expect(pluralize(2, 'child', 'children')).toBe('2 children');
+    });
+});
+describe('stripHtml', () => {
+    it('removes HTML tags', () => {
+        expect(stripHtml('<p>Hello <b>world</b></p>')).toBe('Hello world');
+    });
+});
+describe('initials', () => {
+    it('returns first 2 letters uppercase', () => {
+        expect(initials('david')).toBe('DA');
+    });
+});
+describe('hashColorIndex', () => {
+    it('returns consistent index', () => {
+        const idx = hashColorIndex('test', 10);
+        expect(hashColorIndex('test', 10)).toBe(idx);
+    });
+    it('returns index within palette size', () => {
+        expect(hashColorIndex('anything', 5)).toBeLessThan(5);
+        expect(hashColorIndex('anything', 5)).toBeGreaterThanOrEqual(0);
+    });
+});
+describe('escapeHtml', () => {
+    it('escapes HTML entities', () => {
+        expect(escapeHtml('<script>"a" & \'b\'</script>')).toBe('&lt;script&gt;&quot;a&quot; &amp; &#039;b&#039;&lt;/script&gt;');
+    });
+});
+describe('camelCase', () => {
+    it('converts kebab to camel', () => {
+        expect(camelCase('my-variable-name')).toBe('myVariableName');
+    });
+    it('converts snake to camel', () => {
+        expect(camelCase('my_variable_name')).toBe('myVariableName');
+    });
+});
+describe('kebabCase', () => {
+    it('converts camelCase to kebab', () => {
+        expect(kebabCase('myVariableName')).toBe('my-variable-name');
+    });
+});
+describe('isImage', () => {
+    it('detects image extensions', () => {
+        expect(isImage('photo.jpg')).toBe(true);
+        expect(isImage('photo.jpeg')).toBe(true);
+        expect(isImage('photo.png')).toBe(true);
+        expect(isImage('photo.gif')).toBe(true);
+        expect(isImage('photo.webp')).toBe(true);
+        expect(isImage('photo.avif')).toBe(true);
+        expect(isImage('photo.svg')).toBe(true);
+    });
+    it('rejects non-image extensions', () => {
+        expect(isImage('doc.pdf')).toBe(false);
+        expect(isImage('file.txt')).toBe(false);
+        expect(isImage('archive.zip')).toBe(false);
+    });
+    it('is case-insensitive', () => {
+        expect(isImage('photo.JPG')).toBe(true);
+        expect(isImage('photo.PNG')).toBe(true);
+    });
+});
+//# sourceMappingURL=string.test.js.map

package/dist/string.test.js.map

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

package/package.json

@@ -0,0 +1,38 @@
+{
+  "name": "@karbonjs/utils",
+  "version": "0.1.0",
+  "description": "Utility functions for date, string, number formatting and more",
+  "type": "module",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "license": "MIT",
+  "keywords": [
+    "karbon",
+    "utils",
+    "date",
+    "string",
+    "number",
+    "formatting"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/YOUR_USER/karbonjs",
+    "directory": "packages/utils"
+  },
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsc --watch"
+  }
+}