@teo-garcia/react-shared 1.0.0 → 1.2.0

package/dist/hooks/use-copy-to-clipboard.js

@@ -0,0 +1,23 @@
+import { useCallback, useState } from 'react';
+/**
+ * Returns `[copied, copy]`.
+ * `copy(text)` writes to the clipboard and returns a boolean indicating success.
+ * `copied` resets to `false` after `resetDelay` ms.
+ */
+export function useCopyToClipboard(resetDelay = 2000) {
+    const [copied, setCopied] = useState(false);
+    const copy = useCallback(async (text) => {
+        if (!navigator.clipboard)
+            return false;
+        try {
+            await navigator.clipboard.writeText(text);
+            setCopied(true);
+            setTimeout(() => setCopied(false), resetDelay);
+            return true;
+        }
+        catch {
+            return false;
+        }
+    }, [resetDelay]);
+    return [copied, copy];
+}

package/dist/hooks/use-event-listener.d.ts

@@ -0,0 +1,4 @@
+export declare function useEventListener<K extends keyof WindowEventMap>(target: Window | null, event: K, handler: (event: WindowEventMap[K]) => void, options?: AddEventListenerOptions): void;
+export declare function useEventListener<K extends keyof DocumentEventMap>(target: Document | null, event: K, handler: (event: DocumentEventMap[K]) => void, options?: AddEventListenerOptions): void;
+export declare function useEventListener<K extends keyof HTMLElementEventMap, T extends HTMLElement>(target: T | null, event: K, handler: (event: HTMLElementEventMap[K]) => void, options?: AddEventListenerOptions): void;
+//# sourceMappingURL=use-event-listener.d.ts.map

package/dist/hooks/use-event-listener.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-event-listener.d.ts","sourceRoot":"","sources":["../../src/hooks/use-event-listener.ts"],"names":[],"mappings":"AAKA,wBAAgB,gBAAgB,CAAC,CAAC,SAAS,MAAM,cAAc,EAC7D,MAAM,EAAE,MAAM,GAAG,IAAI,EACrB,KAAK,EAAE,CAAC,EACR,OAAO,EAAE,CAAC,KAAK,EAAE,cAAc,CAAC,CAAC,CAAC,KAAK,IAAI,EAC3C,OAAO,CAAC,EAAE,uBAAuB,GAChC,IAAI,CAAA;AACP,wBAAgB,gBAAgB,CAAC,CAAC,SAAS,MAAM,gBAAgB,EAC/D,MAAM,EAAE,QAAQ,GAAG,IAAI,EACvB,KAAK,EAAE,CAAC,EACR,OAAO,EAAE,CAAC,KAAK,EAAE,gBAAgB,CAAC,CAAC,CAAC,KAAK,IAAI,EAC7C,OAAO,CAAC,EAAE,uBAAuB,GAChC,IAAI,CAAA;AACP,wBAAgB,gBAAgB,CAC9B,CAAC,SAAS,MAAM,mBAAmB,EACnC,CAAC,SAAS,WAAW,EAErB,MAAM,EAAE,CAAC,GAAG,IAAI,EAChB,KAAK,EAAE,CAAC,EACR,OAAO,EAAE,CAAC,KAAK,EAAE,mBAAmB,CAAC,CAAC,CAAC,KAAK,IAAI,EAChD,OAAO,CAAC,EAAE,uBAAuB,GAChC,IAAI,CAAA"}

package/dist/hooks/use-event-listener.js

@@ -0,0 +1,13 @@
+import { useEffect } from 'react';
+import { useLatest } from './use-latest.js';
+export function useEventListener(target, event, handler, options) {
+    const handlerRef = useLatest(handler);
+    useEffect(() => {
+        if (!target)
+            return;
+        const listener = (e) => handlerRef.current(e);
+        target.addEventListener(event, listener, options);
+        return () => target.removeEventListener(event, listener, options);
+        // eslint-disable-next-line react-hooks/exhaustive-deps
+    }, [target, event, JSON.stringify(options)]);
+}

package/dist/hooks/use-idle.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Returns `true` when the user has been inactive for longer than `timeout` ms.
+ * Resets on any mouse, keyboard, touch, or scroll event.
+ * Use for session-expiry warnings, pausing background work, or screensaver effects.
+ */
+export declare function useIdle(timeout: number): boolean;
+//# sourceMappingURL=use-idle.d.ts.map

package/dist/hooks/use-idle.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-idle.d.ts","sourceRoot":"","sources":["../../src/hooks/use-idle.ts"],"names":[],"mappings":"AAWA;;;;GAIG;AACH,wBAAgB,OAAO,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAyBhD"}

package/dist/hooks/use-idle.js

@@ -0,0 +1,35 @@
+import { useEffect, useState } from 'react';
+const ACTIVITY_EVENTS = [
+    'mousemove',
+    'keydown',
+    'mousedown',
+    'touchstart',
+    'scroll',
+    'wheel',
+];
+/**
+ * Returns `true` when the user has been inactive for longer than `timeout` ms.
+ * Resets on any mouse, keyboard, touch, or scroll event.
+ * Use for session-expiry warnings, pausing background work, or screensaver effects.
+ */
+export function useIdle(timeout) {
+    const [idle, setIdle] = useState(false);
+    useEffect(() => {
+        let timer = setTimeout(() => setIdle(true), timeout);
+        function handleActivity() {
+            clearTimeout(timer);
+            setIdle(false);
+            timer = setTimeout(() => setIdle(true), timeout);
+        }
+        for (const event of ACTIVITY_EVENTS) {
+            window.addEventListener(event, handleActivity, { passive: true });
+        }
+        return () => {
+            clearTimeout(timer);
+            for (const event of ACTIVITY_EVENTS) {
+                window.removeEventListener(event, handleActivity);
+            }
+        };
+    }, [timeout]);
+    return idle;
+}

package/dist/hooks/use-intersection-observer.d.ts

@@ -0,0 +1,15 @@
+import { type RefObject } from 'react';
+interface UseIntersectionObserverOptions extends IntersectionObserverInit {
+    /**
+     * Once the element is visible, stop observing and keep the entry frozen.
+     * Useful for lazy-load triggers that should fire only once.
+     */
+    freezeOnceVisible?: boolean;
+}
+/**
+ * Tracks whether an element is within the viewport (or a custom root).
+ * Returns the latest `IntersectionObserverEntry`, or `null` before first observation.
+ */
+export declare function useIntersectionObserver(ref: RefObject<Element | null>, { threshold, root, rootMargin, freezeOnceVisible, }?: UseIntersectionObserverOptions): IntersectionObserverEntry | null;
+export {};
+//# sourceMappingURL=use-intersection-observer.d.ts.map

package/dist/hooks/use-intersection-observer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-intersection-observer.d.ts","sourceRoot":"","sources":["../../src/hooks/use-intersection-observer.ts"],"names":[],"mappings":"AAAA,OAAO,EAAuB,KAAK,SAAS,EAAE,MAAM,OAAO,CAAA;AAE3D,UAAU,8BAA+B,SAAQ,wBAAwB;IACvE;;;OAGG;IACH,iBAAiB,CAAC,EAAE,OAAO,CAAA;CAC5B;AAED;;;GAGG;AACH,wBAAgB,uBAAuB,CACrC,GAAG,EAAE,SAAS,CAAC,OAAO,GAAG,IAAI,CAAC,EAC9B,EACE,SAAa,EACb,IAAW,EACX,UAAiB,EACjB,iBAAyB,GAC1B,GAAE,8BAAmC,GACrC,yBAAyB,GAAG,IAAI,CAoBlC"}

package/dist/hooks/use-intersection-observer.js

@@ -0,0 +1,22 @@
+import { useEffect, useState } from 'react';
+/**
+ * Tracks whether an element is within the viewport (or a custom root).
+ * Returns the latest `IntersectionObserverEntry`, or `null` before first observation.
+ */
+export function useIntersectionObserver(ref, { threshold = 0, root = null, rootMargin = '0%', freezeOnceVisible = false, } = {}) {
+    const [entry, setEntry] = useState(null);
+    const frozen = entry?.isIntersecting && freezeOnceVisible;
+    useEffect(() => {
+        const el = ref.current;
+        if (!el || frozen || typeof IntersectionObserver === 'undefined')
+            return;
+        const observer = new IntersectionObserver(([e]) => setEntry(e ?? null), {
+            threshold,
+            root,
+            rootMargin,
+        });
+        observer.observe(el);
+        return () => observer.disconnect();
+    }, [ref, threshold, root, rootMargin, frozen]);
+    return entry;
+}

package/dist/hooks/use-latest.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Returns a ref always pointing to the latest value.
+ * Breaks stale closures in event listeners, intervals, and callbacks
+ * without requiring them to re-subscribe on every render.
+ */
+export declare function useLatest<T>(value: T): import("react").RefObject<T>;
+//# sourceMappingURL=use-latest.d.ts.map

package/dist/hooks/use-latest.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-latest.d.ts","sourceRoot":"","sources":["../../src/hooks/use-latest.ts"],"names":[],"mappings":"AAEA;;;;GAIG;AACH,wBAAgB,SAAS,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,gCAIpC"}

package/dist/hooks/use-latest.js

@@ -0,0 +1,11 @@
+import { useRef } from 'react';
+/**
+ * Returns a ref always pointing to the latest value.
+ * Breaks stale closures in event listeners, intervals, and callbacks
+ * without requiring them to re-subscribe on every render.
+ */
+export function useLatest(value) {
+    const ref = useRef(value);
+    ref.current = value;
+    return ref;
+}

package/dist/hooks/use-network-status.d.ts

@@ -0,0 +1,10 @@
+interface NetworkStatus {
+    online: boolean;
+}
+/**
+ * Tracks browser online/offline status.
+ * SSR-safe: defaults to `true` on the server.
+ */
+export declare function useNetworkStatus(): NetworkStatus;
+export {};
+//# sourceMappingURL=use-network-status.d.ts.map

package/dist/hooks/use-network-status.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-network-status.d.ts","sourceRoot":"","sources":["../../src/hooks/use-network-status.ts"],"names":[],"mappings":"AAEA,UAAU,aAAa;IACrB,MAAM,EAAE,OAAO,CAAA;CAChB;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,IAAI,aAAa,CAmBhD"}

package/dist/hooks/use-network-status.js

@@ -0,0 +1,19 @@
+import { useEffect, useState } from 'react';
+/**
+ * Tracks browser online/offline status.
+ * SSR-safe: defaults to `true` on the server.
+ */
+export function useNetworkStatus() {
+    const [online, setOnline] = useState(typeof navigator !== 'undefined' ? navigator.onLine : true);
+    useEffect(() => {
+        const handleOnline = () => setOnline(true);
+        const handleOffline = () => setOnline(false);
+        window.addEventListener('online', handleOnline);
+        window.addEventListener('offline', handleOffline);
+        return () => {
+            window.removeEventListener('online', handleOnline);
+            window.removeEventListener('offline', handleOffline);
+        };
+    }, []);
+    return { online };
+}

package/dist/hooks/use-render-count.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Returns the number of times the component has rendered.
+ * Dev-only: logs to console when a label is provided.
+ * Use this to spot unexpected re-render loops before reaching for the profiler.
+ */
+export declare function useRenderCount(label?: string): number;
+//# sourceMappingURL=use-render-count.d.ts.map

package/dist/hooks/use-render-count.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-render-count.d.ts","sourceRoot":"","sources":["../../src/hooks/use-render-count.ts"],"names":[],"mappings":"AAEA;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,KAAK,CAAC,EAAE,MAAM,GAAG,MAAM,CAUrD"}

package/dist/hooks/use-render-count.js

@@ -0,0 +1,15 @@
+import { useRef } from 'react';
+/**
+ * Returns the number of times the component has rendered.
+ * Dev-only: logs to console when a label is provided.
+ * Use this to spot unexpected re-render loops before reaching for the profiler.
+ */
+export function useRenderCount(label) {
+    const count = useRef(0);
+    count.current += 1;
+    if (process.env.NODE_ENV !== 'production' && label) {
+        // eslint-disable-next-line no-console
+        console.log(`[renders] ${label}: ${count.current}`);
+    }
+    return count.current;
+}

package/dist/hooks/use-toggle.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Boolean state with stable toggle, setOn, and setOff callbacks.
+ * Returns `[value, toggle, setOn, setOff]`.
+ */
+export declare function useToggle(initialValue?: boolean): [boolean, () => void, () => void, () => void];
+//# sourceMappingURL=use-toggle.d.ts.map

package/dist/hooks/use-toggle.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-toggle.d.ts","sourceRoot":"","sources":["../../src/hooks/use-toggle.ts"],"names":[],"mappings":"AAEA;;;GAGG;AACH,wBAAgB,SAAS,CACvB,YAAY,UAAQ,GACnB,CAAC,OAAO,EAAE,MAAM,IAAI,EAAE,MAAM,IAAI,EAAE,MAAM,IAAI,CAAC,CAQ/C"}

package/dist/hooks/use-toggle.js

@@ -0,0 +1,12 @@
+import { useCallback, useState } from 'react';
+/**
+ * Boolean state with stable toggle, setOn, and setOff callbacks.
+ * Returns `[value, toggle, setOn, setOff]`.
+ */
+export function useToggle(initialValue = false) {
+    const [value, setValue] = useState(initialValue);
+    const toggle = useCallback(() => setValue((v) => !v), []);
+    const setOn = useCallback(() => setValue(true), []);
+    const setOff = useCallback(() => setValue(false), []);
+    return [value, toggle, setOn, setOff];
+}

package/dist/hooks/use-why-did-you-render.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Logs which props changed between renders.
+ * Dev-only (no-ops in production).
+ * Use before reaching for the React DevTools profiler — shows changed props
+ * inline in the console with before/after values.
+ */
+export declare function useWhyDidYouRender(name: string, props: Record<string, unknown>): void;
+//# sourceMappingURL=use-why-did-you-render.d.ts.map

package/dist/hooks/use-why-did-you-render.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-why-did-you-render.d.ts","sourceRoot":"","sources":["../../src/hooks/use-why-did-you-render.ts"],"names":[],"mappings":"AAEA;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAChC,IAAI,EAAE,MAAM,EACZ,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC7B,IAAI,CAmCN"}

package/dist/hooks/use-why-did-you-render.js

@@ -0,0 +1,38 @@
+import { useEffect, useRef } from 'react';
+/**
+ * Logs which props changed between renders.
+ * Dev-only (no-ops in production).
+ * Use before reaching for the React DevTools profiler — shows changed props
+ * inline in the console with before/after values.
+ */
+export function useWhyDidYouRender(name, props) {
+    const hasMounted = useRef(false);
+    const previousProps = useRef({});
+    useEffect(() => {
+        if (process.env.NODE_ENV === 'production')
+            return;
+        // Skip first render — nothing to diff against
+        if (!hasMounted.current) {
+            hasMounted.current = true;
+            previousProps.current = { ...props };
+            return;
+        }
+        const changed = {};
+        for (const key of Object.keys(props)) {
+            if (previousProps.current[key] !== props[key]) {
+                changed[key] = {
+                    from: previousProps.current[key],
+                    to: props[key],
+                };
+            }
+        }
+        if (Object.keys(changed).length > 0) {
+            console.group(`[why-render] ${name}`);
+            for (const [key, diff] of Object.entries(changed)) {
+                console.log(`  ${key}:`, diff);
+            }
+            console.groupEnd();
+        }
+        previousProps.current = { ...props };
+    });
+}

package/dist/types.d.ts

@@ -1,6 +1,21 @@
+import type { ComponentType, ReactNode, ErrorInfo } from 'react';
+export interface FallbackProps {
+    error: Error;
+    resetError: () => void;
+}
 export interface ErrorBoundaryProps {
-    children: React.ReactNode;
-    fallback?: React.ReactNode | ((error: Error) => React.ReactNode);
-    onError?: (error: Error, errorInfo: React.ErrorInfo) => void;
+    children: ReactNode;
+    /** A React component receiving `{ error, resetError }` — highest priority fallback */
+    FallbackComponent?: ComponentType<FallbackProps>;
+    /** Render prop receiving `{ error, resetError }` */
+    fallbackRender?: (props: FallbackProps) => ReactNode;
+    /** Static element or function `(error) => ReactNode` — lower priority than the two above */
+    fallback?: ReactNode | ((error: Error) => ReactNode);
+    /** Called after every caught error — use for logging/reporting */
+    onError?: (error: Error, errorInfo: ErrorInfo) => void;
+    /** Called whenever the boundary resets */
+    onReset?: () => void;
+    /** When any value in this array changes the boundary resets automatically */
+    resetKeys?: Array<unknown>;
 }
 //# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,kBAAkB;IACjC,QAAQ,EAAE,KAAK,CAAC,SAAS,CAAA;IACzB,QAAQ,CAAC,EAAE,KAAK,CAAC,SAAS,GAAG,CAAC,CAAC,KAAK,EAAE,KAAK,KAAK,KAAK,CAAC,SAAS,CAAC,CAAA;IAChE,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,KAAK,EAAE,SAAS,EAAE,KAAK,CAAC,SAAS,KAAK,IAAI,CAAA;CAC7D"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM,OAAO,CAAA;AAEhE,MAAM,WAAW,aAAa;IAC5B,KAAK,EAAE,KAAK,CAAA;IACZ,UAAU,EAAE,MAAM,IAAI,CAAA;CACvB;AAED,MAAM,WAAW,kBAAkB;IACjC,QAAQ,EAAE,SAAS,CAAA;IACnB,sFAAsF;IACtF,iBAAiB,CAAC,EAAE,aAAa,CAAC,aAAa,CAAC,CAAA;IAChD,oDAAoD;IACpD,cAAc,CAAC,EAAE,CAAC,KAAK,EAAE,aAAa,KAAK,SAAS,CAAA;IACpD,4FAA4F;IAC5F,QAAQ,CAAC,EAAE,SAAS,GAAG,CAAC,CAAC,KAAK,EAAE,KAAK,KAAK,SAAS,CAAC,CAAA;IACpD,kEAAkE;IAClE,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,KAAK,EAAE,SAAS,EAAE,SAAS,KAAK,IAAI,CAAA;IACtD,0CAA0C;IAC1C,OAAO,CAAC,EAAE,MAAM,IAAI,CAAA;IACpB,6EAA6E;IAC7E,SAAS,CAAC,EAAE,KAAK,CAAC,OAAO,CAAC,CAAA;CAC3B"}

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

@@ -0,0 +1,11 @@
+/**
+ * Thin wrapper around `Intl.DateTimeFormat` with sensible defaults.
+ * Covers the 80% case — reach for `date-fns` for complex scheduling logic.
+ *
+ * @example
+ * formatDate(new Date())                          // "March 22, 2026"
+ * formatDate(new Date(), 'en-US', { dateStyle: 'short' })  // "3/22/26"
+ * formatDate('2026-01-01', 'es-ES')               // "1 de enero de 2026"
+ */
+export declare function formatDate(date: Date | string | number, locale?: string, options?: Intl.DateTimeFormatOptions): string;
+//# sourceMappingURL=format-date.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"format-date.d.ts","sourceRoot":"","sources":["../../src/utils/format-date.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,wBAAgB,UAAU,CACxB,IAAI,EAAE,IAAI,GAAG,MAAM,GAAG,MAAM,EAC5B,MAAM,CAAC,EAAE,MAAM,EACf,OAAO,GAAE,IAAI,CAAC,qBAA6C,GAC1D,MAAM,CAER"}

package/dist/utils/format-date.js

@@ -0,0 +1,12 @@
+/**
+ * Thin wrapper around `Intl.DateTimeFormat` with sensible defaults.
+ * Covers the 80% case — reach for `date-fns` for complex scheduling logic.
+ *
+ * @example
+ * formatDate(new Date())                          // "March 22, 2026"
+ * formatDate(new Date(), 'en-US', { dateStyle: 'short' })  // "3/22/26"
+ * formatDate('2026-01-01', 'es-ES')               // "1 de enero de 2026"
+ */
+export function formatDate(date, locale, options = { dateStyle: 'long' }) {
+    return new Intl.DateTimeFormat(locale, options).format(new Date(date));
+}

package/dist/utils/format-number.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Thin wrapper around `Intl.NumberFormat` with sensible defaults.
+ *
+ * @example
+ * formatNumber(1234567)                                      // "1,234,567"
+ * formatNumber(0.1234, 'en-US', { style: 'percent' })       // "12%"
+ * formatNumber(9900, 'en-US', { style: 'currency', currency: 'USD' })  // "$9,900.00"
+ * formatNumber(1200000, 'en-US', { notation: 'compact' })   // "1.2M"
+ */
+export declare function formatNumber(value: number, locale?: string, options?: Intl.NumberFormatOptions): string;
+//# sourceMappingURL=format-number.d.ts.map

package/dist/utils/format-number.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"format-number.d.ts","sourceRoot":"","sources":["../../src/utils/format-number.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,wBAAgB,YAAY,CAC1B,KAAK,EAAE,MAAM,EACb,MAAM,CAAC,EAAE,MAAM,EACf,OAAO,CAAC,EAAE,IAAI,CAAC,mBAAmB,GACjC,MAAM,CAER"}

package/dist/utils/format-number.js

@@ -0,0 +1,12 @@
+/**
+ * Thin wrapper around `Intl.NumberFormat` with sensible defaults.
+ *
+ * @example
+ * formatNumber(1234567)                                      // "1,234,567"
+ * formatNumber(0.1234, 'en-US', { style: 'percent' })       // "12%"
+ * formatNumber(9900, 'en-US', { style: 'currency', currency: 'USD' })  // "$9,900.00"
+ * formatNumber(1200000, 'en-US', { notation: 'compact' })   // "1.2M"
+ */
+export function formatNumber(value, locale, options) {
+    return new Intl.NumberFormat(locale, options).format(value);
+}

package/dist/utils/index.d.ts

@@ -1,2 +1,5 @@
 export { cn } from './cn.js';
+export { formatDate } from './format-date.js';
+export { formatNumber } from './format-number.js';
+export { truncate } from './truncate.js';
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/utils/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,EAAE,EAAE,MAAM,SAAS,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/utils/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,EAAE,EAAE,MAAM,SAAS,CAAA;AAC5B,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAA;AAC7C,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAA;AACjD,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAA"}

package/dist/utils/index.js

@@ -1 +1,4 @@
 export { cn } from './cn.js';
+export { formatDate } from './format-date.js';
+export { formatNumber } from './format-number.js';
+export { truncate } from './truncate.js';

package/dist/utils/truncate.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Truncates a string to `maxLength` characters, appending `suffix` if truncated.
+ * The total length of the result never exceeds `maxLength`.
+ *
+ * @example
+ * truncate('Hello world', 8)         // "Hello…"
+ * truncate('Short', 10)              // "Short"
+ * truncate('Hello world', 8, '...')  // "Hello..."
+ */
+export declare function truncate(str: string, maxLength: number, suffix?: string): string;
+//# sourceMappingURL=truncate.d.ts.map

package/dist/utils/truncate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"truncate.d.ts","sourceRoot":"","sources":["../../src/utils/truncate.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,wBAAgB,QAAQ,CAAC,GAAG,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,MAAM,SAAM,GAAG,MAAM,CAG7E"}

package/dist/utils/truncate.js

@@ -0,0 +1,14 @@
+/**
+ * Truncates a string to `maxLength` characters, appending `suffix` if truncated.
+ * The total length of the result never exceeds `maxLength`.
+ *
+ * @example
+ * truncate('Hello world', 8)         // "Hello…"
+ * truncate('Short', 10)              // "Short"
+ * truncate('Hello world', 8, '...')  // "Hello..."
+ */
+export function truncate(str, maxLength, suffix = '…') {
+    if (str.length <= maxLength)
+        return str;
+    return str.slice(0, maxLength - suffix.length) + suffix;
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@teo-garcia/react-shared",
-  "version": "1.0.0",
+  "version": "1.2.0",
   "description": "Shared React hooks, utilities, and test helpers for the teo-garcia template portfolio",
   "type": "module",
   "main": "./dist/index.js",
@@ -18,6 +18,42 @@
       "import": "./dist/components/error-boundary/index.js",
       "types": "./dist/components/error-boundary/index.d.ts"
     },
+    "./components/focus-trap": {
+      "import": "./dist/components/focus-trap/index.js",
+      "types": "./dist/components/focus-trap/index.d.ts"
+    },
+    "./components/portal": {
+      "import": "./dist/components/portal/index.js",
+      "types": "./dist/components/portal/index.d.ts"
+    },
+    "./components/skeleton": {
+      "import": "./dist/components/skeleton/index.js",
+      "types": "./dist/components/skeleton/index.d.ts"
+    },
+    "./components/visually-hidden": {
+      "import": "./dist/components/visually-hidden/index.js",
+      "types": "./dist/components/visually-hidden/index.d.ts"
+    },
+    "./components/aspect-ratio": {
+      "import": "./dist/components/aspect-ratio/index.js",
+      "types": "./dist/components/aspect-ratio/index.d.ts"
+    },
+    "./components/debug-json": {
+      "import": "./dist/components/debug-json/index.js",
+      "types": "./dist/components/debug-json/index.d.ts"
+    },
+    "./components/dev-panel": {
+      "import": "./dist/components/dev-panel/index.js",
+      "types": "./dist/components/dev-panel/index.d.ts"
+    },
+    "./components/separator": {
+      "import": "./dist/components/separator/index.js",
+      "types": "./dist/components/separator/index.d.ts"
+    },
+    "./components/skip-link": {
+      "import": "./dist/components/skip-link/index.js",
+      "types": "./dist/components/skip-link/index.d.ts"
+    },
     "./hooks": {
       "import": "./dist/hooks/index.js",
       "types": "./dist/hooks/index.d.ts"
@@ -46,6 +82,42 @@
       "import": "./dist/hooks/use-previous.js",
       "types": "./dist/hooks/use-previous.d.ts"
     },
+    "./hooks/use-copy-to-clipboard": {
+      "import": "./dist/hooks/use-copy-to-clipboard.js",
+      "types": "./dist/hooks/use-copy-to-clipboard.d.ts"
+    },
+    "./hooks/use-event-listener": {
+      "import": "./dist/hooks/use-event-listener.js",
+      "types": "./dist/hooks/use-event-listener.d.ts"
+    },
+    "./hooks/use-idle": {
+      "import": "./dist/hooks/use-idle.js",
+      "types": "./dist/hooks/use-idle.d.ts"
+    },
+    "./hooks/use-intersection-observer": {
+      "import": "./dist/hooks/use-intersection-observer.js",
+      "types": "./dist/hooks/use-intersection-observer.d.ts"
+    },
+    "./hooks/use-latest": {
+      "import": "./dist/hooks/use-latest.js",
+      "types": "./dist/hooks/use-latest.d.ts"
+    },
+    "./hooks/use-network-status": {
+      "import": "./dist/hooks/use-network-status.js",
+      "types": "./dist/hooks/use-network-status.d.ts"
+    },
+    "./hooks/use-render-count": {
+      "import": "./dist/hooks/use-render-count.js",
+      "types": "./dist/hooks/use-render-count.d.ts"
+    },
+    "./hooks/use-toggle": {
+      "import": "./dist/hooks/use-toggle.js",
+      "types": "./dist/hooks/use-toggle.d.ts"
+    },
+    "./hooks/use-why-did-you-render": {
+      "import": "./dist/hooks/use-why-did-you-render.js",
+      "types": "./dist/hooks/use-why-did-you-render.d.ts"
+    },
     "./utils": {
       "import": "./dist/utils/index.js",
       "types": "./dist/utils/index.d.ts"
@@ -54,6 +126,18 @@
       "import": "./dist/utils/cn.js",
       "types": "./dist/utils/cn.d.ts"
     },
+    "./utils/format-date": {
+      "import": "./dist/utils/format-date.js",
+      "types": "./dist/utils/format-date.d.ts"
+    },
+    "./utils/format-number": {
+      "import": "./dist/utils/format-number.js",
+      "types": "./dist/utils/format-number.d.ts"
+    },
+    "./utils/truncate": {
+      "import": "./dist/utils/truncate.js",
+      "types": "./dist/utils/truncate.d.ts"
+    },
     "./test-utils": {
       "import": "./dist/test-utils/index.js",
       "types": "./dist/test-utils/index.d.ts"