voodoojs 0.4.6

package/dist/utils.cjs

@@ -0,0 +1,397 @@
+'use strict';
+
+/**
+ * Voodoo.js v0.4.6
+ * JavaScript feels like magic.
+ * (c) 2026 Voodoo.js contributors. MIT License.
+ */
+
+// src/utils/index.ts
+function uuid() {
+  const c = globalThis.crypto;
+  if (c?.randomUUID) return c.randomUUID();
+  if (c?.getRandomValues) {
+    const bytes = c.getRandomValues(new Uint8Array(16));
+    bytes[6] = bytes[6] & 15 | 64;
+    bytes[8] = bytes[8] & 63 | 128;
+    const hex = Array.from(bytes, (b) => b.toString(16).padStart(2, "0")).join("");
+    return `${hex.slice(0, 8)}-${hex.slice(8, 12)}-${hex.slice(12, 16)}-${hex.slice(16, 20)}-${hex.slice(20)}`;
+  }
+  return "xxxxxxxx-xxxx-4xxx-yxxx-xxxxxxxxxxxx".replace(/[xy]/g, (ch) => {
+    const r = Math.random() * 16 | 0;
+    return (ch === "x" ? r : r & 3 | 8).toString(16);
+  });
+}
+function uid(prefix = "v") {
+  return `${prefix}${Math.random().toString(36).slice(2, 9)}`;
+}
+function sleep(ms) {
+  return new Promise((resolve) => setTimeout(resolve, ms));
+}
+function parseDuration(value, fallback = 0) {
+  if (value == null || value === "") return fallback;
+  if (typeof value === "number") return value;
+  const match = /^\s*([\d.]+)\s*(ms|s|m|h)?\s*$/i.exec(String(value));
+  if (!match) return fallback;
+  const amount = parseFloat(match[1]);
+  switch ((match[2] || "ms").toLowerCase()) {
+    case "s":
+      return amount * 1e3;
+    case "m":
+      return amount * 6e4;
+    case "h":
+      return amount * 36e5;
+    default:
+      return amount;
+  }
+}
+function debounce(fn, wait = 250, immediate = false) {
+  let timer = null;
+  let lastArgs = null;
+  let lastThis;
+  const debounced = function(...args) {
+    lastArgs = args;
+    lastThis = this;
+    const callNow = immediate && timer === null;
+    if (timer) clearTimeout(timer);
+    timer = setTimeout(() => {
+      timer = null;
+      if (!immediate && lastArgs) fn.apply(lastThis, lastArgs);
+    }, wait);
+    if (callNow) fn.apply(this, args);
+  };
+  debounced.cancel = () => {
+    if (timer) clearTimeout(timer);
+    timer = null;
+    lastArgs = null;
+  };
+  debounced.flush = () => {
+    if (timer && lastArgs) {
+      clearTimeout(timer);
+      timer = null;
+      fn.apply(lastThis, lastArgs);
+    }
+  };
+  return debounced;
+}
+function throttle(fn, wait = 250) {
+  let last = 0;
+  let timer = null;
+  let lastArgs = null;
+  const throttled = function(...args) {
+    const now = Date.now();
+    lastArgs = args;
+    const remaining = wait - (now - last);
+    if (remaining <= 0) {
+      if (timer) {
+        clearTimeout(timer);
+        timer = null;
+      }
+      last = now;
+      fn.apply(this, args);
+    } else if (!timer) {
+      timer = setTimeout(() => {
+        last = Date.now();
+        timer = null;
+        if (lastArgs) fn.apply(this, lastArgs);
+      }, remaining);
+    }
+  };
+  throttled.cancel = () => {
+    if (timer) clearTimeout(timer);
+    timer = null;
+  };
+  throttled.flush = () => {
+    if (timer && lastArgs) {
+      clearTimeout(timer);
+      timer = null;
+      fn.apply(null, lastArgs);
+    }
+  };
+  return throttled;
+}
+function once(fn) {
+  let called = false;
+  let result;
+  return function(...args) {
+    if (!called) {
+      called = true;
+      result = fn.apply(this, args);
+    }
+    return result;
+  };
+}
+function memoize(fn, keyFn = (...args) => JSON.stringify(args)) {
+  const cache = /* @__PURE__ */ new Map();
+  const memoized = function(...args) {
+    const key = keyFn(...args);
+    if (cache.has(key)) return cache.get(key);
+    const value = fn.apply(this, args);
+    cache.set(key, value);
+    return value;
+  };
+  memoized.cache = cache;
+  return memoized;
+}
+function clone(value) {
+  if (value === null || typeof value !== "object") return value;
+  if (typeof structuredClone === "function") {
+    try {
+      return structuredClone(value);
+    } catch {
+    }
+  }
+  if (Array.isArray(value)) return value.map((v) => clone(v));
+  if (value instanceof Date) return new Date(value.getTime());
+  if (value instanceof Map) return new Map([...value].map(([k, v]) => [k, clone(v)]));
+  if (value instanceof Set) return new Set([...value].map((v) => clone(v)));
+  const out = {};
+  for (const [k, v] of Object.entries(value)) out[k] = clone(v);
+  return out;
+}
+function merge(target, ...sources) {
+  for (const source of sources) {
+    if (!source) continue;
+    for (const [key, value] of Object.entries(source)) {
+      const current = target[key];
+      if (value && typeof value === "object" && !Array.isArray(value) && current && typeof current === "object" && !Array.isArray(current)) {
+        target[key] = merge({ ...current }, value);
+      } else {
+        target[key] = value;
+      }
+    }
+  }
+  return target;
+}
+function groupBy(list, key) {
+  const out = {};
+  const getKey = typeof key === "function" ? key : (item) => item?.[key];
+  for (const item of list) {
+    const k = String(getKey(item));
+    (out[k] || (out[k] = [])).push(item);
+  }
+  return out;
+}
+function unique(list, key) {
+  if (!key) return [...new Set(list)];
+  const getKey = typeof key === "function" ? key : (item) => item?.[key];
+  const seen = /* @__PURE__ */ new Set();
+  const out = [];
+  for (const item of list) {
+    const k = getKey(item);
+    if (seen.has(k)) continue;
+    seen.add(k);
+    out.push(item);
+  }
+  return out;
+}
+function chunk(list, size = 10) {
+  if (size < 1) return [list];
+  const out = [];
+  for (let i = 0; i < list.length; i += size) out.push(list.slice(i, i + size));
+  return out;
+}
+function sortBy(list, key, direction = "asc") {
+  const getKey = typeof key === "function" ? key : (item) => item?.[key];
+  const factor = direction === "desc" ? -1 : 1;
+  return [...list].sort((a, b) => {
+    const va = getKey(a);
+    const vb = getKey(b);
+    if (va == null && vb == null) return 0;
+    if (va == null) return 1;
+    if (vb == null) return -1;
+    if (typeof va === "string" && typeof vb === "string") {
+      return va.localeCompare(vb, void 0, { numeric: true }) * factor;
+    }
+    return (va > vb ? 1 : va < vb ? -1 : 0) * factor;
+  });
+}
+function get(object, path, fallback) {
+  const parts = path.split(".");
+  let current = object;
+  for (const part of parts) {
+    if (current == null) return fallback;
+    current = current[part];
+  }
+  return current ?? fallback;
+}
+function set(object, path, value) {
+  const parts = path.split(".");
+  let current = object;
+  for (let i = 0; i < parts.length - 1; i++) {
+    const key = parts[i];
+    if (typeof current[key] !== "object" || current[key] === null) {
+      current[key] = /^\d+$/.test(parts[i + 1]) ? [] : {};
+    }
+    current = current[key];
+  }
+  current[parts[parts.length - 1]] = value;
+}
+function random(min = 0, max = 1) {
+  return Math.floor(Math.random() * (max - min + 1)) + min;
+}
+function sample(list) {
+  return list[Math.floor(Math.random() * list.length)];
+}
+function slugify(text, separator = "-") {
+  return String(text).normalize("NFD").replace(/[̀-ͯ]/g, "").toLowerCase().trim().replace(/[^a-z0-9]+/g, separator).replace(new RegExp(`\\${separator}{2,}`, "g"), separator).replace(new RegExp(`^\\${separator}|\\${separator}$`, "g"), "");
+}
+function truncate(text, length = 100, suffix = "...") {
+  const value = String(text ?? "");
+  if (value.length <= length) return value;
+  return value.slice(0, Math.max(0, length - suffix.length)).trimEnd() + suffix;
+}
+function capitalize(text) {
+  const value = String(text ?? "");
+  return value.charAt(0).toUpperCase() + value.slice(1);
+}
+function titleCase(text) {
+  return String(text ?? "").replace(/\w\S*/g, (word) => capitalize(word.toLowerCase()));
+}
+function escapeHtml(text) {
+  return String(text ?? "").replace(/&/g, "&amp;").replace(/</g, "&lt;").replace(/>/g, "&gt;").replace(/"/g, "&quot;").replace(/'/g, "&#39;");
+}
+function stripTags(html) {
+  return String(html ?? "").replace(/<\/?[^>]+(>|$)/g, "");
+}
+var defaultLocale = "pt-BR";
+var defaultCurrency = "BRL";
+function setFormatDefaults(locale, currency) {
+  if (locale) defaultLocale = locale;
+  if (currency) defaultCurrency = currency;
+}
+function formatCurrency(value, options = {}) {
+  const n = typeof value === "string" ? parseFloat(value) : value;
+  if (n == null || Number.isNaN(n)) return "";
+  return new Intl.NumberFormat(options.locale ?? defaultLocale, {
+    style: "currency",
+    currency: options.currency ?? defaultCurrency
+  }).format(n);
+}
+function formatNumber(value, options = {}) {
+  const n = typeof value === "string" ? parseFloat(value) : value;
+  if (n == null || Number.isNaN(n)) return "";
+  const { locale, ...rest } = options;
+  return new Intl.NumberFormat(locale ?? defaultLocale, rest).format(n);
+}
+function formatDate(value, format = "short", locale) {
+  const date = value instanceof Date ? value : new Date(value);
+  if (Number.isNaN(date.getTime())) return "";
+  const loc = locale ?? defaultLocale;
+  if (typeof format === "object") return new Intl.DateTimeFormat(loc, format).format(date);
+  const presets = {
+    short: { day: "2-digit", month: "2-digit", year: "numeric" },
+    long: { day: "2-digit", month: "long", year: "numeric" },
+    full: { dateStyle: "full" },
+    time: { hour: "2-digit", minute: "2-digit" },
+    datetime: { day: "2-digit", month: "2-digit", year: "numeric", hour: "2-digit", minute: "2-digit" }
+  };
+  if (presets[format]) return new Intl.DateTimeFormat(loc, presets[format]).format(date);
+  const pad = (n) => String(n).padStart(2, "0");
+  return format.replace(/YYYY/g, String(date.getFullYear())).replace(/YY/g, String(date.getFullYear()).slice(-2)).replace(/MM/g, pad(date.getMonth() + 1)).replace(/DD/g, pad(date.getDate())).replace(/HH/g, pad(date.getHours())).replace(/mm/g, pad(date.getMinutes())).replace(/ss/g, pad(date.getSeconds()));
+}
+function relativeTime(value, locale) {
+  const date = value instanceof Date ? value : new Date(value);
+  if (Number.isNaN(date.getTime())) return "";
+  const diff = date.getTime() - Date.now();
+  const abs = Math.abs(diff);
+  const units = [
+    ["year", 31536e6],
+    ["month", 2592e6],
+    ["week", 6048e5],
+    ["day", 864e5],
+    ["hour", 36e5],
+    ["minute", 6e4],
+    ["second", 1e3]
+  ];
+  const rtf = new Intl.RelativeTimeFormat(locale ?? defaultLocale, { numeric: "auto" });
+  for (const [unit, ms] of units) {
+    if (abs >= ms || unit === "second") {
+      return rtf.format(Math.round(diff / ms), unit);
+    }
+  }
+  return "";
+}
+function formatFileSize(bytes, decimals = 1) {
+  const n = Number(bytes);
+  if (!n || Number.isNaN(n)) return "0 B";
+  const units = ["B", "KB", "MB", "GB", "TB", "PB"];
+  const i = Math.min(Math.floor(Math.log(Math.abs(n)) / Math.log(1024)), units.length - 1);
+  return `${(n / 1024 ** i).toFixed(i === 0 ? 0 : decimals)} ${units[i]}`;
+}
+function formatPercent(value, decimals = 0, locale) {
+  return new Intl.NumberFormat(locale ?? defaultLocale, {
+    style: "percent",
+    minimumFractionDigits: decimals,
+    maximumFractionDigits: decimals
+  }).format(value);
+}
+var isBrowser = typeof window !== "undefined" && typeof window.document !== "undefined";
+function matchesMedia(query) {
+  if (!isBrowser || typeof window.matchMedia !== "function") return false;
+  try {
+    return window.matchMedia(query).matches;
+  } catch {
+    return false;
+  }
+}
+var device = {
+  get touch() {
+    return isBrowser && ("ontouchstart" in window || navigator.maxTouchPoints > 0);
+  },
+  get mobile() {
+    return matchesMedia("(max-width: 767px)");
+  },
+  get tablet() {
+    return matchesMedia("(min-width: 768px) and (max-width: 1023px)");
+  },
+  get desktop() {
+    return matchesMedia("(min-width: 1024px)");
+  },
+  get online() {
+    return !isBrowser || navigator.onLine;
+  },
+  get reducedMotion() {
+    return matchesMedia("(prefers-reduced-motion: reduce)");
+  },
+  get darkMode() {
+    return matchesMedia("(prefers-color-scheme: dark)");
+  }
+};
+
+exports.capitalize = capitalize;
+exports.chunk = chunk;
+exports.clone = clone;
+exports.debounce = debounce;
+exports.device = device;
+exports.escapeHtml = escapeHtml;
+exports.formatCurrency = formatCurrency;
+exports.formatDate = formatDate;
+exports.formatFileSize = formatFileSize;
+exports.formatNumber = formatNumber;
+exports.formatPercent = formatPercent;
+exports.get = get;
+exports.groupBy = groupBy;
+exports.isBrowser = isBrowser;
+exports.matchesMedia = matchesMedia;
+exports.memoize = memoize;
+exports.merge = merge;
+exports.once = once;
+exports.parseDuration = parseDuration;
+exports.random = random;
+exports.relativeTime = relativeTime;
+exports.sample = sample;
+exports.set = set;
+exports.setFormatDefaults = setFormatDefaults;
+exports.sleep = sleep;
+exports.slugify = slugify;
+exports.sortBy = sortBy;
+exports.stripTags = stripTags;
+exports.throttle = throttle;
+exports.titleCase = titleCase;
+exports.truncate = truncate;
+exports.uid = uid;
+exports.unique = unique;
+exports.uuid = uuid;
+//# sourceMappingURL=utils.cjs.map
+//# sourceMappingURL=utils.cjs.map

package/dist/utils.d.cts

@@ -0,0 +1,111 @@
+/**
+ * @module utils
+ *
+ * Pure utilities. None of them touch the DOM, so the module works the same in
+ * browser, Node, Bun, and Deno. Everything here is tree-shakeable.
+ */
+/** UUID v4. Uses `crypto.randomUUID` when available. */
+declare function uuid(): string;
+/** Short identifier, useful for element ids. */
+declare function uid(prefix?: string): string;
+/** Pauses execution. `await V.sleep(500)`. */
+declare function sleep(ms: number): Promise<void>;
+/**
+ * Converts `"300"`, `"300ms"`, `"1.5s"`, and `"2m"` to milliseconds.
+ * Accepts `null` because the most common source is `getAttribute`, which returns null.
+ */
+declare function parseDuration(value: string | number | null | undefined, fallback?: number): number;
+interface DebouncedFunction<T extends (...args: any[]) => any> {
+    (...args: Parameters<T>): void;
+    cancel(): void;
+    flush(): void;
+}
+/**
+ * Delays execution until it stops being called for `wait` ms.
+ *
+ * ```js
+ * const search = V.debounce(fetchProducts, 300)
+ * ```
+ */
+declare function debounce<T extends (...args: any[]) => any>(fn: T, wait?: number, immediate?: boolean): DebouncedFunction<T>;
+/** Limits to at most one execution every `wait` ms. */
+declare function throttle<T extends (...args: any[]) => any>(fn: T, wait?: number): DebouncedFunction<T>;
+/** Executes the function once and memoizes the return value. */
+declare function once<T extends (...args: any[]) => any>(fn: T): T;
+/** Result cache by argument. */
+declare function memoize<T extends (...args: any[]) => any>(fn: T, keyFn?: (...args: Parameters<T>) => string): T & {
+    cache: Map<string, ReturnType<T>>;
+};
+/** Deep copy. Uses `structuredClone` when available. */
+declare function clone<T>(value: T): T;
+/** Deep merges objects. Arrays are replaced, not concatenated. */
+declare function merge<T extends Record<string, any>>(target: T, ...sources: Array<Partial<T>>): T;
+/** Groups by key or by function. */
+declare function groupBy<T>(list: T[], key: string | ((item: T) => string | number)): Record<string, T[]>;
+/** Removes duplicates. Accepts key for objects. */
+declare function unique<T>(list: T[], key?: string | ((item: T) => unknown)): T[];
+/** Divides into fixed-size chunks. */
+declare function chunk<T>(list: T[], size?: number): T[][];
+/** Sorts by key without altering the original array. */
+declare function sortBy<T>(list: T[], key: string | ((item: T) => any), direction?: 'asc' | 'desc'): T[];
+/** Safely reads a nested path: `get(obj, 'a.b.0.c')`. */
+declare function get<T = unknown>(object: unknown, path: string, fallback?: T): T | undefined;
+/** Writes to a nested path, creating intermediate objects. */
+declare function set(object: Record<string, any>, path: string, value: unknown): void;
+/** Random integer between min and max, inclusive. */
+declare function random(min?: number, max?: number): number;
+/** Randomly picks an item from a list. */
+declare function sample<T>(list: T[]): T | undefined;
+/** Converts text to URL slug, removing accents. */
+declare function slugify(text: string, separator?: string): string;
+/** Truncates text at limit and adds ellipsis. */
+declare function truncate(text: string, length?: number, suffix?: string): string;
+/** First letter uppercase. */
+declare function capitalize(text: string): string;
+/** First letter of each word uppercase. */
+declare function titleCase(text: string): string;
+/** Escapes dangerous characters for interpolating text in HTML. */
+declare function escapeHtml(text: string): string;
+/** Removes all tags from HTML, leaving only text. */
+declare function stripTags(html: string): string;
+interface FormatOptions {
+    locale?: string;
+    currency?: string;
+}
+/** Sets the locale and currency used by formatters. */
+declare function setFormatDefaults(locale?: string, currency?: string): void;
+/** Formats as currency: `formatCurrency(1234.5)` returns `R$ 1.234,50`. */
+declare function formatCurrency(value: number | string, options?: FormatOptions): string;
+/** Formats number with locale separators. */
+declare function formatNumber(value: number | string, options?: Intl.NumberFormatOptions & FormatOptions): string;
+/** Formats dates accepting Date, timestamp, or ISO string. */
+declare function formatDate(value: Date | string | number, format?: string | Intl.DateTimeFormatOptions, locale?: string): string;
+/** Human-readable relative time: `5 minutes ago`, `in 2 days`. */
+declare function relativeTime(value: Date | string | number, locale?: string): string;
+/** Human-readable file size: `1.4 MB`. */
+declare function formatFileSize(bytes: number, decimals?: number): string;
+/** Formatted percentage. */
+declare function formatPercent(value: number, decimals?: number, locale?: string): string;
+/** `true` when DOM is available. */
+declare const isBrowser: boolean;
+/**
+ * Safely queries a media query.
+ *
+ * `matchMedia` doesn't exist everywhere: it's missing in jsdom and old webviews.
+ * Without this guard, reading `device.reducedMotion` would throw TypeError, and since
+ * UI directives read this property while opening and closing panels, the exception
+ * would interrupt the method and leave `aria-expanded` and focus in the wrong state.
+ */
+declare function matchesMedia(query: string): boolean;
+/** Device information, calculated on demand. */
+declare const device: {
+    readonly touch: boolean;
+    readonly mobile: boolean;
+    readonly tablet: boolean;
+    readonly desktop: boolean;
+    readonly online: boolean;
+    readonly reducedMotion: boolean;
+    readonly darkMode: boolean;
+};
+
+export { type DebouncedFunction, type FormatOptions, capitalize, chunk, clone, debounce, device, escapeHtml, formatCurrency, formatDate, formatFileSize, formatNumber, formatPercent, get, groupBy, isBrowser, matchesMedia, memoize, merge, once, parseDuration, random, relativeTime, sample, set, setFormatDefaults, sleep, slugify, sortBy, stripTags, throttle, titleCase, truncate, uid, unique, uuid };

package/dist/utils.d.ts

@@ -0,0 +1,111 @@
+/**
+ * @module utils
+ *
+ * Pure utilities. None of them touch the DOM, so the module works the same in
+ * browser, Node, Bun, and Deno. Everything here is tree-shakeable.
+ */
+/** UUID v4. Uses `crypto.randomUUID` when available. */
+declare function uuid(): string;
+/** Short identifier, useful for element ids. */
+declare function uid(prefix?: string): string;
+/** Pauses execution. `await V.sleep(500)`. */
+declare function sleep(ms: number): Promise<void>;
+/**
+ * Converts `"300"`, `"300ms"`, `"1.5s"`, and `"2m"` to milliseconds.
+ * Accepts `null` because the most common source is `getAttribute`, which returns null.
+ */
+declare function parseDuration(value: string | number | null | undefined, fallback?: number): number;
+interface DebouncedFunction<T extends (...args: any[]) => any> {
+    (...args: Parameters<T>): void;
+    cancel(): void;
+    flush(): void;
+}
+/**
+ * Delays execution until it stops being called for `wait` ms.
+ *
+ * ```js
+ * const search = V.debounce(fetchProducts, 300)
+ * ```
+ */
+declare function debounce<T extends (...args: any[]) => any>(fn: T, wait?: number, immediate?: boolean): DebouncedFunction<T>;
+/** Limits to at most one execution every `wait` ms. */
+declare function throttle<T extends (...args: any[]) => any>(fn: T, wait?: number): DebouncedFunction<T>;
+/** Executes the function once and memoizes the return value. */
+declare function once<T extends (...args: any[]) => any>(fn: T): T;
+/** Result cache by argument. */
+declare function memoize<T extends (...args: any[]) => any>(fn: T, keyFn?: (...args: Parameters<T>) => string): T & {
+    cache: Map<string, ReturnType<T>>;
+};
+/** Deep copy. Uses `structuredClone` when available. */
+declare function clone<T>(value: T): T;
+/** Deep merges objects. Arrays are replaced, not concatenated. */
+declare function merge<T extends Record<string, any>>(target: T, ...sources: Array<Partial<T>>): T;
+/** Groups by key or by function. */
+declare function groupBy<T>(list: T[], key: string | ((item: T) => string | number)): Record<string, T[]>;
+/** Removes duplicates. Accepts key for objects. */
+declare function unique<T>(list: T[], key?: string | ((item: T) => unknown)): T[];
+/** Divides into fixed-size chunks. */
+declare function chunk<T>(list: T[], size?: number): T[][];
+/** Sorts by key without altering the original array. */
+declare function sortBy<T>(list: T[], key: string | ((item: T) => any), direction?: 'asc' | 'desc'): T[];
+/** Safely reads a nested path: `get(obj, 'a.b.0.c')`. */
+declare function get<T = unknown>(object: unknown, path: string, fallback?: T): T | undefined;
+/** Writes to a nested path, creating intermediate objects. */
+declare function set(object: Record<string, any>, path: string, value: unknown): void;
+/** Random integer between min and max, inclusive. */
+declare function random(min?: number, max?: number): number;
+/** Randomly picks an item from a list. */
+declare function sample<T>(list: T[]): T | undefined;
+/** Converts text to URL slug, removing accents. */
+declare function slugify(text: string, separator?: string): string;
+/** Truncates text at limit and adds ellipsis. */
+declare function truncate(text: string, length?: number, suffix?: string): string;
+/** First letter uppercase. */
+declare function capitalize(text: string): string;
+/** First letter of each word uppercase. */
+declare function titleCase(text: string): string;
+/** Escapes dangerous characters for interpolating text in HTML. */
+declare function escapeHtml(text: string): string;
+/** Removes all tags from HTML, leaving only text. */
+declare function stripTags(html: string): string;
+interface FormatOptions {
+    locale?: string;
+    currency?: string;
+}
+/** Sets the locale and currency used by formatters. */
+declare function setFormatDefaults(locale?: string, currency?: string): void;
+/** Formats as currency: `formatCurrency(1234.5)` returns `R$ 1.234,50`. */
+declare function formatCurrency(value: number | string, options?: FormatOptions): string;
+/** Formats number with locale separators. */
+declare function formatNumber(value: number | string, options?: Intl.NumberFormatOptions & FormatOptions): string;
+/** Formats dates accepting Date, timestamp, or ISO string. */
+declare function formatDate(value: Date | string | number, format?: string | Intl.DateTimeFormatOptions, locale?: string): string;
+/** Human-readable relative time: `5 minutes ago`, `in 2 days`. */
+declare function relativeTime(value: Date | string | number, locale?: string): string;
+/** Human-readable file size: `1.4 MB`. */
+declare function formatFileSize(bytes: number, decimals?: number): string;
+/** Formatted percentage. */
+declare function formatPercent(value: number, decimals?: number, locale?: string): string;
+/** `true` when DOM is available. */
+declare const isBrowser: boolean;
+/**
+ * Safely queries a media query.
+ *
+ * `matchMedia` doesn't exist everywhere: it's missing in jsdom and old webviews.
+ * Without this guard, reading `device.reducedMotion` would throw TypeError, and since
+ * UI directives read this property while opening and closing panels, the exception
+ * would interrupt the method and leave `aria-expanded` and focus in the wrong state.
+ */
+declare function matchesMedia(query: string): boolean;
+/** Device information, calculated on demand. */
+declare const device: {
+    readonly touch: boolean;
+    readonly mobile: boolean;
+    readonly tablet: boolean;
+    readonly desktop: boolean;
+    readonly online: boolean;
+    readonly reducedMotion: boolean;
+    readonly darkMode: boolean;
+};
+
+export { type DebouncedFunction, type FormatOptions, capitalize, chunk, clone, debounce, device, escapeHtml, formatCurrency, formatDate, formatFileSize, formatNumber, formatPercent, get, groupBy, isBrowser, matchesMedia, memoize, merge, once, parseDuration, random, relativeTime, sample, set, setFormatDefaults, sleep, slugify, sortBy, stripTags, throttle, titleCase, truncate, uid, unique, uuid };

package/dist/utils.js

@@ -0,0 +1,4 @@
+export { capitalize, chunk, clone, debounce, device, escapeHtml, formatCurrency, formatDate, formatFileSize, formatNumber, formatPercent, get, groupBy, isBrowser, matchesMedia, memoize, merge, once, parseDuration, random, relativeTime, sample, set, setFormatDefaults, sleep, slugify, sortBy, stripTags, throttle, titleCase, truncate, uid, unique, uuid } from './chunk-234ZLC6W.js';
+import './chunk-E27NRARW.js';
+//# sourceMappingURL=utils.js.map
+//# sourceMappingURL=utils.js.map