@rainersoft/utils 1.0.0

package/README.md

@@ -0,0 +1,176 @@
+# @rainersoft/utils
+
+> Biblioteca universal de utilitários para formatação, conversão e manipulação de dados.
+
+[![npm version](https://badge.fury.io/js/@rainersoft%2Futils.svg)](https://www.npmjs.com/package/@rainersoft/utils)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+
+## 🎯 Características
+
+- ✅ **Universal**: Funciona em Web, Desktop e Mobile
+- ✅ **TypeScript**: Totalmente tipado
+- ✅ **Tree-shakeable**: Importações otimizadas
+- ✅ **Zero dependências**: Leve e rápido
+- ✅ **Multi-idioma**: Suporte para pt-BR, en-US, es-ES
+- ✅ **Helpers pt-BR**: Funções pré-configuradas para português
+- ✅ **Modular**: Importe apenas o que precisa
+
+## 📦 Instalação
+
+```bash
+npm install @rainersoft/utils
+# ou
+pnpm add @rainersoft/utils
+# ou
+yarn add @rainersoft/utils
+```
+
+## 🚀 Uso
+
+### String Utilities
+
+```typescript
+import { textToSlug, capitalize, truncate, getInitials } from '@rainersoft/utils/string';
+
+textToSlug('Meu Post Incrível!'); // 'meu-post-incrivel'
+capitalize('rainer teixeira'); // 'Rainer Teixeira'
+truncate('Texto muito longo', 10); // 'Texto muit...'
+getInitials('Rainer Teixeira'); // 'RT'
+```
+
+### Date Utilities
+
+```typescript
+import { formatDate, formatDateTime, formatRelativeDate } from '@rainersoft/utils/date';
+
+formatDate('2025-11-26'); // '26 de novembro de 2025'
+formatDate('2025-11-26', 'short'); // '26/11/2025'
+formatDateTime('2025-11-26T14:30:00'); // '26 de novembro de 2025 às 14:30'
+formatRelativeDate(yesterday); // 'há 1 dia'
+```
+
+### Number Utilities
+
+```typescript
+import { formatCurrency, formatPercent, formatNumber, formatCompact } from '@rainersoft/utils/number';
+
+formatCurrency(1234.56); // 'R$ 1.234,56'
+formatPercent(0.1234, 2); // '12,34%'
+formatNumber(1234567); // '1.234.567'
+formatCompact(1234567); // '1,2 mi'
+```
+
+### Status Utilities
+
+```typescript
+import { translateStatus, getStatusColor, getStatusVariant } from '@rainersoft/utils/status';
+
+translateStatus('DRAFT'); // 'Rascunho'
+translateStatus('PUBLISHED'); // 'Publicado'
+getStatusColor('PUBLISHED'); // 'text-green-600'
+getStatusVariant('DRAFT'); // 'secondary'
+```
+
+### Import Tudo
+
+```typescript
+import {
+  textToSlug,
+  formatDate,
+  formatCurrency,
+  translateStatus
+} from '@rainersoft/utils';
+```
+
+### Helpers pt-BR (Recomendado para Português)
+
+```typescript
+// Importação simplificada - já vem em pt-BR
+import { ptBR } from '@rainersoft/utils';
+
+ptBR.formatDate('2025-11-26'); // '26 de novembro de 2025'
+ptBR.formatCurrency(1234.56); // 'R$ 1.234,56'
+ptBR.translateStatus('DRAFT'); // 'Rascunho'
+
+// Ou importe funções individuais
+import { formatDate, formatCurrency } from '@rainersoft/utils/pt-br';
+```
+
+### Suporte Multi-idioma
+
+```typescript
+import { formatDate, formatCurrency, translateStatus } from '@rainersoft/utils';
+
+// Português (padrão)
+formatDate('2025-11-26'); // '26 de novembro de 2025'
+formatCurrency(1234.56); // 'R$ 1.234,56'
+
+// Inglês
+formatDate('2025-11-26', 'long', 'en-US'); // 'November 26, 2025'
+formatCurrency(1234.56, 'en-US'); // '$1,234.56'
+
+// Espanhol
+formatDate('2025-11-26', 'long', 'es-ES'); // '26 de noviembre de 2025'
+formatCurrency(1234.56, 'es-ES'); // '1.234,56 €'
+```
+
+## 📚 Módulos
+
+### String (`@rainersoft/utils/string`)
+- `textToSlug()` - Converte texto para slug
+- `capitalize()` - Capitaliza palavras
+- `truncate()` - Trunca texto
+- `removeAccents()` - Remove acentos
+- `getInitials()` - Extrai iniciais
+- `isEmpty()` - Valida string vazia
+- `wordCount()` - Conta palavras
+
+### Date (`@rainersoft/utils/date`)
+- `formatDate()` - Formata data (pt-BR)
+- `formatDateTime()` - Formata data e hora
+- `formatRelativeDate()` - Data relativa (há X dias)
+- `toISOString()` - Converte para ISO
+- `isValidDate()` - Valida data
+
+### Number (`@rainersoft/utils/number`)
+- `formatCurrency()` - Formata moeda (BRL)
+- `formatPercent()` - Formata percentual
+- `formatNumber()` - Formata número
+- `formatCompact()` - Formato compacto (1K, 1M)
+- `parseCurrency()` - Parse de moeda
+- `round()` - Arredondamento
+- `clamp()` - Limita valor
+
+### Status (`@rainersoft/utils/status`)
+- `translateStatus()` - Traduz status
+- `getStatusColor()` - Cor do status
+- `getStatusVariant()` - Variant do badge
+
+## 🛠️ Desenvolvimento
+
+```bash
+# Instalar dependências
+pnpm install
+
+# Desenvolvimento com watch
+pnpm dev
+
+# Build
+pnpm build
+
+# Testes
+pnpm test
+
+# Lint
+pnpm lint
+```
+
+## 📄 Licença
+
+MIT © Rainer Teixeira
+
+## 🔗 Ecossistema Rainersoft
+
+- [@rainersoft/design-tokens](https://www.npmjs.com/package/@rainersoft/design-tokens) - Sistema de design tokens
+- [@rainersoft/ui](https://www.npmjs.com/package/@rainersoft/ui) - Componentes UI
+- [@rainersoft/utils](https://www.npmjs.com/package/@rainersoft/utils) - Utilitários universais

package/dist/date/index.d.mts

@@ -0,0 +1,9 @@
+import { L as Locale } from '../types-tUMATEGI.mjs';
+
+declare function formatDate(date: string | Date, format?: 'short' | 'long' | 'full', locale?: Locale): string;
+declare function formatDateTime(date: string | Date, locale?: Locale): string;
+declare function formatRelativeDate(date: string | Date, locale?: Locale): string;
+declare function toISOString(date: Date): string;
+declare function isValidDate(date: unknown): date is Date;
+
+export { formatDate, formatDateTime, formatRelativeDate, isValidDate, toISOString };

package/dist/date/index.d.ts

@@ -0,0 +1,9 @@
+import { L as Locale } from '../types-tUMATEGI.js';
+
+declare function formatDate(date: string | Date, format?: 'short' | 'long' | 'full', locale?: Locale): string;
+declare function formatDateTime(date: string | Date, locale?: Locale): string;
+declare function formatRelativeDate(date: string | Date, locale?: Locale): string;
+declare function toISOString(date: Date): string;
+declare function isValidDate(date: unknown): date is Date;
+
+export { formatDate, formatDateTime, formatRelativeDate, isValidDate, toISOString };

package/dist/date/index.js

@@ -0,0 +1,105 @@
+'use strict';
+
+// src/types.ts
+var DEFAULT_LOCALE = "pt-BR";
+
+// src/date/index.ts
+var RELATIVE_TEXTS = {
+  "pt-BR": {
+    now: "agora",
+    minute: (n) => `h\xE1 ${n} ${n === 1 ? "minuto" : "minutos"}`,
+    hour: (n) => `h\xE1 ${n} ${n === 1 ? "hora" : "horas"}`,
+    day: (n) => `h\xE1 ${n} ${n === 1 ? "dia" : "dias"}`,
+    month: (n) => `h\xE1 ${n} ${n === 1 ? "m\xEAs" : "meses"}`,
+    year: (n) => `h\xE1 ${n} ${n === 1 ? "ano" : "anos"}`
+  },
+  "en-US": {
+    now: "now",
+    minute: (n) => `${n} ${n === 1 ? "minute" : "minutes"} ago`,
+    hour: (n) => `${n} ${n === 1 ? "hour" : "hours"} ago`,
+    day: (n) => `${n} ${n === 1 ? "day" : "days"} ago`,
+    month: (n) => `${n} ${n === 1 ? "month" : "months"} ago`,
+    year: (n) => `${n} ${n === 1 ? "year" : "years"} ago`
+  },
+  "es-ES": {
+    now: "ahora",
+    minute: (n) => `hace ${n} ${n === 1 ? "minuto" : "minutos"}`,
+    hour: (n) => `hace ${n} ${n === 1 ? "hora" : "horas"}`,
+    day: (n) => `hace ${n} ${n === 1 ? "d\xEDa" : "d\xEDas"}`,
+    month: (n) => `hace ${n} ${n === 1 ? "mes" : "meses"}`,
+    year: (n) => `hace ${n} ${n === 1 ? "a\xF1o" : "a\xF1os"}`
+  }
+};
+function formatDate(date, format = "long", locale = DEFAULT_LOCALE) {
+  const d = typeof date === "string" ? new Date(date) : date;
+  const options = {
+    day: "numeric",
+    month: format === "short" ? "2-digit" : "long",
+    year: "numeric",
+    ...format === "full" && { weekday: "long" }
+  };
+  if (format === "short") {
+    return d.toLocaleDateString(locale, { day: "2-digit", month: "2-digit", year: "numeric" });
+  }
+  return d.toLocaleDateString(locale, options);
+}
+function formatDateTime(date, locale = DEFAULT_LOCALE) {
+  const d = typeof date === "string" ? new Date(date) : date;
+  return d.toLocaleString(locale, {
+    day: "numeric",
+    month: "long",
+    year: "numeric",
+    hour: "2-digit",
+    minute: "2-digit"
+  });
+}
+function formatRelativeDate(date, locale = DEFAULT_LOCALE) {
+  const d = typeof date === "string" ? new Date(date) : date;
+  if (!(d instanceof Date) || Number.isNaN(d.getTime())) {
+    return "";
+  }
+  const now = /* @__PURE__ */ new Date();
+  const diffMs = now.getTime() - d.getTime();
+  const diffSec = Math.floor(diffMs / 1e3);
+  const diffMin = Math.floor(diffSec / 60);
+  const diffHour = Math.floor(diffMin / 60);
+  const diffDay = Math.floor(diffHour / 24);
+  const diffMonth = Math.floor(diffDay / 30.4375);
+  const diffYear = Math.floor(diffDay / 365);
+  const texts = RELATIVE_TEXTS[locale];
+  if (diffSec < 10) {
+    if (locale === "pt-BR") return "agora mesmo";
+    if (locale === "en-US") return "just now";
+    if (locale === "es-ES") return "ahora mismo";
+  }
+  if (diffSec < 60) return texts.now;
+  if (diffMin < 60) return texts.minute(diffMin);
+  if (diffHour < 24) return texts.hour(diffHour);
+  if (diffDay === 1) {
+    if (locale === "pt-BR") return "ontem";
+    if (locale === "en-US") return "yesterday";
+    if (locale === "es-ES") return "ayer";
+  }
+  if (diffDay === 2) {
+    if (locale === "pt-BR") return "anteontem";
+    if (locale === "en-US") return "the day before yesterday";
+    if (locale === "es-ES") return "anteayer";
+  }
+  if (diffDay < 30) return texts.day(diffDay);
+  if (diffMonth < 12) return texts.month(diffMonth);
+  return texts.year(diffYear);
+}
+function toISOString(date) {
+  return date.toISOString();
+}
+function isValidDate(date) {
+  return date instanceof Date && !isNaN(date.getTime());
+}
+
+exports.formatDate = formatDate;
+exports.formatDateTime = formatDateTime;
+exports.formatRelativeDate = formatRelativeDate;
+exports.isValidDate = isValidDate;
+exports.toISOString = toISOString;
+//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.js.map

package/dist/date/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/types.ts","../../src/date/index.ts"],"names":[],"mappings":"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","file":"index.js","sourcesContent":["/**\r\n * Types & Constants\r\n *\r\n * Tipos e constantes compartilhadas entre módulos.\r\n *\r\n * @module @rainersoft/utils/types\r\n * @author Rainer Teixeira\r\n */\r\n\r\n/**\r\n * Idiomas suportados\r\n */\r\nexport type Locale = 'pt-BR' | 'en-US' | 'es-ES';\r\n\r\n/**\r\n * Configuração de localização\r\n */\r\nexport interface LocaleConfig {\r\n  locale: Locale;\r\n  currency?: string;\r\n  dateFormat?: 'short' | 'long' | 'full';\r\n}\r\n\r\n/**\r\n * Locale padrão\r\n */\r\nexport const DEFAULT_LOCALE: Locale = 'pt-BR';\r\n\r\n/**\r\n * Mapeamento de moedas por locale\r\n */\r\nexport const CURRENCY_MAP: Record<Locale, string> = {\r\n  'pt-BR': 'BRL',\r\n  'en-US': 'USD',\r\n  'es-ES': 'EUR',\r\n} as const;\r\n","/**\r\n * Date Utilities\r\n *\r\n * Utilitários para formatação e manipulação de datas.\r\n * Suporte para múltiplos idiomas: pt-BR, en-US, es-ES.\r\n *\r\n * @module @rainersoft/utils/date\r\n * @author Rainer Teixeira\r\n */\r\n\r\nimport type { Locale } from '../types';\r\nimport { DEFAULT_LOCALE } from '../types';\r\n\r\n/**\r\n * Textos relativos por idioma\r\n */\r\nconst RELATIVE_TEXTS = {\r\n  'pt-BR': {\r\n    now: 'agora',\r\n    minute: (n: number) => `há ${n} ${n === 1 ? 'minuto' : 'minutos'}`,\r\n    hour: (n: number) => `há ${n} ${n === 1 ? 'hora' : 'horas'}`,\r\n    day: (n: number) => `há ${n} ${n === 1 ? 'dia' : 'dias'}`,\r\n    month: (n: number) => `há ${n} ${n === 1 ? 'mês' : 'meses'}`,\r\n    year: (n: number) => `há ${n} ${n === 1 ? 'ano' : 'anos'}`,\r\n  },\r\n  'en-US': {\r\n    now: 'now',\r\n    minute: (n: number) => `${n} ${n === 1 ? 'minute' : 'minutes'} ago`,\r\n    hour: (n: number) => `${n} ${n === 1 ? 'hour' : 'hours'} ago`,\r\n    day: (n: number) => `${n} ${n === 1 ? 'day' : 'days'} ago`,\r\n    month: (n: number) => `${n} ${n === 1 ? 'month' : 'months'} ago`,\r\n    year: (n: number) => `${n} ${n === 1 ? 'year' : 'years'} ago`,\r\n  },\r\n  'es-ES': {\r\n    now: 'ahora',\r\n    minute: (n: number) => `hace ${n} ${n === 1 ? 'minuto' : 'minutos'}`,\r\n    hour: (n: number) => `hace ${n} ${n === 1 ? 'hora' : 'horas'}`,\r\n    day: (n: number) => `hace ${n} ${n === 1 ? 'día' : 'días'}`,\r\n    month: (n: number) => `hace ${n} ${n === 1 ? 'mes' : 'meses'}`,\r\n    year: (n: number) => `hace ${n} ${n === 1 ? 'año' : 'años'}`,\r\n  },\r\n} as const;\r\n\r\n/**\r\n * Formata data com suporte a múltiplos idiomas\r\n *\r\n * @param date - Data (string ISO ou Date)\r\n * @param format - Formato ('short' | 'long' | 'full')\r\n * @param locale - Idioma (padrão: 'pt-BR')\r\n * @returns Data formatada\r\n *\r\n * @example\r\n * formatDate('2025-11-26') // '26 de novembro de 2025' (pt-BR)\r\n * formatDate('2025-11-26', 'short') // '26/11/2025'\r\n * formatDate('2025-11-26', 'long', 'en-US') // 'November 26, 2025'\r\n * formatDate('2025-11-26', 'long', 'es-ES') // '26 de noviembre de 2025'\r\n */\r\nexport function formatDate(\r\n  date: string | Date,\r\n  format: 'short' | 'long' | 'full' = 'long',\r\n  locale: Locale = DEFAULT_LOCALE\r\n): string {\r\n  const d = typeof date === 'string' ? new Date(date) : date;\r\n  \r\n  // Usar Intl.DateTimeFormat para suporte multi-idioma\r\n  const options: Intl.DateTimeFormatOptions = {\r\n    day: 'numeric',\r\n    month: format === 'short' ? '2-digit' : 'long',\r\n    year: 'numeric',\r\n    ...(format === 'full' && { weekday: 'long' }),\r\n  };\r\n\r\n  if (format === 'short') {\r\n    return d.toLocaleDateString(locale, { day: '2-digit', month: '2-digit', year: 'numeric' });\r\n  }\r\n\r\n  return d.toLocaleDateString(locale, options);\r\n}\r\n\r\n/**\r\n * Formata data e hora com suporte a múltiplos idiomas\r\n *\r\n * @param date - Data (string ISO ou Date)\r\n * @param locale - Idioma (padrão: 'pt-BR')\r\n * @returns Data e hora formatadas\r\n *\r\n * @example\r\n * formatDateTime('2025-11-26T14:30:00') // '26 de novembro de 2025, 14:30' (pt-BR)\r\n * formatDateTime('2025-11-26T14:30:00', 'en-US') // 'November 26, 2025, 2:30 PM'\r\n */\r\nexport function formatDateTime(date: string | Date, locale: Locale = DEFAULT_LOCALE): string {\r\n  const d = typeof date === 'string' ? new Date(date) : date;\r\n  \r\n  return d.toLocaleString(locale, {\r\n    day: 'numeric',\r\n    month: 'long',\r\n    year: 'numeric',\r\n    hour: '2-digit',\r\n    minute: '2-digit',\r\n  });\r\n}\r\n\r\n/**\r\n * Formata data relativa (há X dias/horas) com suporte a idiomas\r\n *\r\n * @param date - Data (string ISO ou Date)\r\n * @param locale - Idioma (padrão: 'pt-BR')\r\n * @returns Texto relativo\r\n *\r\n * @example\r\n * formatRelativeDate(new Date()) // 'agora' (pt-BR)\r\n * formatRelativeDate(yesterday, 'en-US') // '1 day ago'\r\n * formatRelativeDate(yesterday, 'es-ES') // 'hace 1 día'\r\n */\r\nexport function formatRelativeDate(date: string | Date, locale: Locale = DEFAULT_LOCALE): string {\r\n  const d = typeof date === 'string' ? new Date(date) : date;\r\n\r\n  // Proteger contra datas inválidas (evita 'há NaN anos')\r\n  if (!(d instanceof Date) || Number.isNaN(d.getTime())) {\r\n    return '';\r\n  }\r\n  const now = new Date();\r\n  const diffMs = now.getTime() - d.getTime();\r\n  const diffSec = Math.floor(diffMs / 1000);\r\n  const diffMin = Math.floor(diffSec / 60);\r\n  const diffHour = Math.floor(diffMin / 60);\r\n  const diffDay = Math.floor(diffHour / 24);\r\n  // Usar média de dias por mês mais próxima da realidade para não arredondar cedo demais para 1 ano\r\n  const diffMonth = Math.floor(diffDay / 30.4375); // 365 / 12\r\n  const diffYear = Math.floor(diffDay / 365);\r\n\r\n  const texts = RELATIVE_TEXTS[locale];\r\n\r\n  // Regras especiais por idioma (mais naturais)\r\n  if (diffSec < 10) {\r\n    if (locale === 'pt-BR') return 'agora mesmo';\r\n    if (locale === 'en-US') return 'just now';\r\n    if (locale === 'es-ES') return 'ahora mismo';\r\n  }\r\n\r\n  if (diffSec < 60) return texts.now;\r\n  if (diffMin < 60) return texts.minute(diffMin);\r\n  if (diffHour < 24) return texts.hour(diffHour);\r\n\r\n  // Dias específicos\r\n  if (diffDay === 1) {\r\n    if (locale === 'pt-BR') return 'ontem';\r\n    if (locale === 'en-US') return 'yesterday';\r\n    if (locale === 'es-ES') return 'ayer';\r\n  }\r\n\r\n  if (diffDay === 2) {\r\n    if (locale === 'pt-BR') return 'anteontem';\r\n    if (locale === 'en-US') return 'the day before yesterday';\r\n    if (locale === 'es-ES') return 'anteayer';\r\n  }\r\n\r\n  if (diffDay < 30) return texts.day(diffDay);\r\n  if (diffMonth < 12) return texts.month(diffMonth);\r\n  return texts.year(diffYear);\r\n}\r\n\r\n/**\r\n * Converte data para ISO string\r\n *\r\n * @param date - Data\r\n * @returns String ISO\r\n */\r\nexport function toISOString(date: Date): string {\r\n  return date.toISOString();\r\n}\r\n\r\n/**\r\n * Verifica se data é válida\r\n *\r\n * @param date - Data para validar\r\n * @returns true se válida\r\n */\r\nexport function isValidDate(date: unknown): date is Date {\r\n  return date instanceof Date && !isNaN(date.getTime());\r\n}\r\n"]}

package/dist/date/index.mjs

@@ -0,0 +1,99 @@
+// src/types.ts
+var DEFAULT_LOCALE = "pt-BR";
+
+// src/date/index.ts
+var RELATIVE_TEXTS = {
+  "pt-BR": {
+    now: "agora",
+    minute: (n) => `h\xE1 ${n} ${n === 1 ? "minuto" : "minutos"}`,
+    hour: (n) => `h\xE1 ${n} ${n === 1 ? "hora" : "horas"}`,
+    day: (n) => `h\xE1 ${n} ${n === 1 ? "dia" : "dias"}`,
+    month: (n) => `h\xE1 ${n} ${n === 1 ? "m\xEAs" : "meses"}`,
+    year: (n) => `h\xE1 ${n} ${n === 1 ? "ano" : "anos"}`
+  },
+  "en-US": {
+    now: "now",
+    minute: (n) => `${n} ${n === 1 ? "minute" : "minutes"} ago`,
+    hour: (n) => `${n} ${n === 1 ? "hour" : "hours"} ago`,
+    day: (n) => `${n} ${n === 1 ? "day" : "days"} ago`,
+    month: (n) => `${n} ${n === 1 ? "month" : "months"} ago`,
+    year: (n) => `${n} ${n === 1 ? "year" : "years"} ago`
+  },
+  "es-ES": {
+    now: "ahora",
+    minute: (n) => `hace ${n} ${n === 1 ? "minuto" : "minutos"}`,
+    hour: (n) => `hace ${n} ${n === 1 ? "hora" : "horas"}`,
+    day: (n) => `hace ${n} ${n === 1 ? "d\xEDa" : "d\xEDas"}`,
+    month: (n) => `hace ${n} ${n === 1 ? "mes" : "meses"}`,
+    year: (n) => `hace ${n} ${n === 1 ? "a\xF1o" : "a\xF1os"}`
+  }
+};
+function formatDate(date, format = "long", locale = DEFAULT_LOCALE) {
+  const d = typeof date === "string" ? new Date(date) : date;
+  const options = {
+    day: "numeric",
+    month: format === "short" ? "2-digit" : "long",
+    year: "numeric",
+    ...format === "full" && { weekday: "long" }
+  };
+  if (format === "short") {
+    return d.toLocaleDateString(locale, { day: "2-digit", month: "2-digit", year: "numeric" });
+  }
+  return d.toLocaleDateString(locale, options);
+}
+function formatDateTime(date, locale = DEFAULT_LOCALE) {
+  const d = typeof date === "string" ? new Date(date) : date;
+  return d.toLocaleString(locale, {
+    day: "numeric",
+    month: "long",
+    year: "numeric",
+    hour: "2-digit",
+    minute: "2-digit"
+  });
+}
+function formatRelativeDate(date, locale = DEFAULT_LOCALE) {
+  const d = typeof date === "string" ? new Date(date) : date;
+  if (!(d instanceof Date) || Number.isNaN(d.getTime())) {
+    return "";
+  }
+  const now = /* @__PURE__ */ new Date();
+  const diffMs = now.getTime() - d.getTime();
+  const diffSec = Math.floor(diffMs / 1e3);
+  const diffMin = Math.floor(diffSec / 60);
+  const diffHour = Math.floor(diffMin / 60);
+  const diffDay = Math.floor(diffHour / 24);
+  const diffMonth = Math.floor(diffDay / 30.4375);
+  const diffYear = Math.floor(diffDay / 365);
+  const texts = RELATIVE_TEXTS[locale];
+  if (diffSec < 10) {
+    if (locale === "pt-BR") return "agora mesmo";
+    if (locale === "en-US") return "just now";
+    if (locale === "es-ES") return "ahora mismo";
+  }
+  if (diffSec < 60) return texts.now;
+  if (diffMin < 60) return texts.minute(diffMin);
+  if (diffHour < 24) return texts.hour(diffHour);
+  if (diffDay === 1) {
+    if (locale === "pt-BR") return "ontem";
+    if (locale === "en-US") return "yesterday";
+    if (locale === "es-ES") return "ayer";
+  }
+  if (diffDay === 2) {
+    if (locale === "pt-BR") return "anteontem";
+    if (locale === "en-US") return "the day before yesterday";
+    if (locale === "es-ES") return "anteayer";
+  }
+  if (diffDay < 30) return texts.day(diffDay);
+  if (diffMonth < 12) return texts.month(diffMonth);
+  return texts.year(diffYear);
+}
+function toISOString(date) {
+  return date.toISOString();
+}
+function isValidDate(date) {
+  return date instanceof Date && !isNaN(date.getTime());
+}
+
+export { formatDate, formatDateTime, formatRelativeDate, isValidDate, toISOString };
+//# sourceMappingURL=index.mjs.map
+//# sourceMappingURL=index.mjs.map

package/dist/date/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/types.ts","../../src/date/index.ts"],"names":[],"mappings":"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","file":"index.mjs","sourcesContent":["/**\r\n * Types & Constants\r\n *\r\n * Tipos e constantes compartilhadas entre módulos.\r\n *\r\n * @module @rainersoft/utils/types\r\n * @author Rainer Teixeira\r\n */\r\n\r\n/**\r\n * Idiomas suportados\r\n */\r\nexport type Locale = 'pt-BR' | 'en-US' | 'es-ES';\r\n\r\n/**\r\n * Configuração de localização\r\n */\r\nexport interface LocaleConfig {\r\n  locale: Locale;\r\n  currency?: string;\r\n  dateFormat?: 'short' | 'long' | 'full';\r\n}\r\n\r\n/**\r\n * Locale padrão\r\n */\r\nexport const DEFAULT_LOCALE: Locale = 'pt-BR';\r\n\r\n/**\r\n * Mapeamento de moedas por locale\r\n */\r\nexport const CURRENCY_MAP: Record<Locale, string> = {\r\n  'pt-BR': 'BRL',\r\n  'en-US': 'USD',\r\n  'es-ES': 'EUR',\r\n} as const;\r\n","/**\r\n * Date Utilities\r\n *\r\n * Utilitários para formatação e manipulação de datas.\r\n * Suporte para múltiplos idiomas: pt-BR, en-US, es-ES.\r\n *\r\n * @module @rainersoft/utils/date\r\n * @author Rainer Teixeira\r\n */\r\n\r\nimport type { Locale } from '../types';\r\nimport { DEFAULT_LOCALE } from '../types';\r\n\r\n/**\r\n * Textos relativos por idioma\r\n */\r\nconst RELATIVE_TEXTS = {\r\n  'pt-BR': {\r\n    now: 'agora',\r\n    minute: (n: number) => `há ${n} ${n === 1 ? 'minuto' : 'minutos'}`,\r\n    hour: (n: number) => `há ${n} ${n === 1 ? 'hora' : 'horas'}`,\r\n    day: (n: number) => `há ${n} ${n === 1 ? 'dia' : 'dias'}`,\r\n    month: (n: number) => `há ${n} ${n === 1 ? 'mês' : 'meses'}`,\r\n    year: (n: number) => `há ${n} ${n === 1 ? 'ano' : 'anos'}`,\r\n  },\r\n  'en-US': {\r\n    now: 'now',\r\n    minute: (n: number) => `${n} ${n === 1 ? 'minute' : 'minutes'} ago`,\r\n    hour: (n: number) => `${n} ${n === 1 ? 'hour' : 'hours'} ago`,\r\n    day: (n: number) => `${n} ${n === 1 ? 'day' : 'days'} ago`,\r\n    month: (n: number) => `${n} ${n === 1 ? 'month' : 'months'} ago`,\r\n    year: (n: number) => `${n} ${n === 1 ? 'year' : 'years'} ago`,\r\n  },\r\n  'es-ES': {\r\n    now: 'ahora',\r\n    minute: (n: number) => `hace ${n} ${n === 1 ? 'minuto' : 'minutos'}`,\r\n    hour: (n: number) => `hace ${n} ${n === 1 ? 'hora' : 'horas'}`,\r\n    day: (n: number) => `hace ${n} ${n === 1 ? 'día' : 'días'}`,\r\n    month: (n: number) => `hace ${n} ${n === 1 ? 'mes' : 'meses'}`,\r\n    year: (n: number) => `hace ${n} ${n === 1 ? 'año' : 'años'}`,\r\n  },\r\n} as const;\r\n\r\n/**\r\n * Formata data com suporte a múltiplos idiomas\r\n *\r\n * @param date - Data (string ISO ou Date)\r\n * @param format - Formato ('short' | 'long' | 'full')\r\n * @param locale - Idioma (padrão: 'pt-BR')\r\n * @returns Data formatada\r\n *\r\n * @example\r\n * formatDate('2025-11-26') // '26 de novembro de 2025' (pt-BR)\r\n * formatDate('2025-11-26', 'short') // '26/11/2025'\r\n * formatDate('2025-11-26', 'long', 'en-US') // 'November 26, 2025'\r\n * formatDate('2025-11-26', 'long', 'es-ES') // '26 de noviembre de 2025'\r\n */\r\nexport function formatDate(\r\n  date: string | Date,\r\n  format: 'short' | 'long' | 'full' = 'long',\r\n  locale: Locale = DEFAULT_LOCALE\r\n): string {\r\n  const d = typeof date === 'string' ? new Date(date) : date;\r\n  \r\n  // Usar Intl.DateTimeFormat para suporte multi-idioma\r\n  const options: Intl.DateTimeFormatOptions = {\r\n    day: 'numeric',\r\n    month: format === 'short' ? '2-digit' : 'long',\r\n    year: 'numeric',\r\n    ...(format === 'full' && { weekday: 'long' }),\r\n  };\r\n\r\n  if (format === 'short') {\r\n    return d.toLocaleDateString(locale, { day: '2-digit', month: '2-digit', year: 'numeric' });\r\n  }\r\n\r\n  return d.toLocaleDateString(locale, options);\r\n}\r\n\r\n/**\r\n * Formata data e hora com suporte a múltiplos idiomas\r\n *\r\n * @param date - Data (string ISO ou Date)\r\n * @param locale - Idioma (padrão: 'pt-BR')\r\n * @returns Data e hora formatadas\r\n *\r\n * @example\r\n * formatDateTime('2025-11-26T14:30:00') // '26 de novembro de 2025, 14:30' (pt-BR)\r\n * formatDateTime('2025-11-26T14:30:00', 'en-US') // 'November 26, 2025, 2:30 PM'\r\n */\r\nexport function formatDateTime(date: string | Date, locale: Locale = DEFAULT_LOCALE): string {\r\n  const d = typeof date === 'string' ? new Date(date) : date;\r\n  \r\n  return d.toLocaleString(locale, {\r\n    day: 'numeric',\r\n    month: 'long',\r\n    year: 'numeric',\r\n    hour: '2-digit',\r\n    minute: '2-digit',\r\n  });\r\n}\r\n\r\n/**\r\n * Formata data relativa (há X dias/horas) com suporte a idiomas\r\n *\r\n * @param date - Data (string ISO ou Date)\r\n * @param locale - Idioma (padrão: 'pt-BR')\r\n * @returns Texto relativo\r\n *\r\n * @example\r\n * formatRelativeDate(new Date()) // 'agora' (pt-BR)\r\n * formatRelativeDate(yesterday, 'en-US') // '1 day ago'\r\n * formatRelativeDate(yesterday, 'es-ES') // 'hace 1 día'\r\n */\r\nexport function formatRelativeDate(date: string | Date, locale: Locale = DEFAULT_LOCALE): string {\r\n  const d = typeof date === 'string' ? new Date(date) : date;\r\n\r\n  // Proteger contra datas inválidas (evita 'há NaN anos')\r\n  if (!(d instanceof Date) || Number.isNaN(d.getTime())) {\r\n    return '';\r\n  }\r\n  const now = new Date();\r\n  const diffMs = now.getTime() - d.getTime();\r\n  const diffSec = Math.floor(diffMs / 1000);\r\n  const diffMin = Math.floor(diffSec / 60);\r\n  const diffHour = Math.floor(diffMin / 60);\r\n  const diffDay = Math.floor(diffHour / 24);\r\n  // Usar média de dias por mês mais próxima da realidade para não arredondar cedo demais para 1 ano\r\n  const diffMonth = Math.floor(diffDay / 30.4375); // 365 / 12\r\n  const diffYear = Math.floor(diffDay / 365);\r\n\r\n  const texts = RELATIVE_TEXTS[locale];\r\n\r\n  // Regras especiais por idioma (mais naturais)\r\n  if (diffSec < 10) {\r\n    if (locale === 'pt-BR') return 'agora mesmo';\r\n    if (locale === 'en-US') return 'just now';\r\n    if (locale === 'es-ES') return 'ahora mismo';\r\n  }\r\n\r\n  if (diffSec < 60) return texts.now;\r\n  if (diffMin < 60) return texts.minute(diffMin);\r\n  if (diffHour < 24) return texts.hour(diffHour);\r\n\r\n  // Dias específicos\r\n  if (diffDay === 1) {\r\n    if (locale === 'pt-BR') return 'ontem';\r\n    if (locale === 'en-US') return 'yesterday';\r\n    if (locale === 'es-ES') return 'ayer';\r\n  }\r\n\r\n  if (diffDay === 2) {\r\n    if (locale === 'pt-BR') return 'anteontem';\r\n    if (locale === 'en-US') return 'the day before yesterday';\r\n    if (locale === 'es-ES') return 'anteayer';\r\n  }\r\n\r\n  if (diffDay < 30) return texts.day(diffDay);\r\n  if (diffMonth < 12) return texts.month(diffMonth);\r\n  return texts.year(diffYear);\r\n}\r\n\r\n/**\r\n * Converte data para ISO string\r\n *\r\n * @param date - Data\r\n * @returns String ISO\r\n */\r\nexport function toISOString(date: Date): string {\r\n  return date.toISOString();\r\n}\r\n\r\n/**\r\n * Verifica se data é válida\r\n *\r\n * @param date - Data para validar\r\n * @returns true se válida\r\n */\r\nexport function isValidDate(date: unknown): date is Date {\r\n  return date instanceof Date && !isNaN(date.getTime());\r\n}\r\n"]}

package/dist/index.d.mts

@@ -0,0 +1,108 @@
+import { L as Locale } from './types-tUMATEGI.mjs';
+export { C as CURRENCY_MAP, D as DEFAULT_LOCALE, a as LocaleConfig } from './types-tUMATEGI.mjs';
+export { textToSlug } from './string/index.mjs';
+export { formatDate, formatDateTime, formatRelativeDate, isValidDate, toISOString } from './date/index.mjs';
+export { formatCurrency } from './number/index.mjs';
+export { GenericStatus, getStatusColor, getStatusVariant, translateStatus } from './status/index.mjs';
+
+declare function extractInitials(name: string | null | undefined, maxChars?: number): string;
+declare function generateUniqueId(text: string, prefix?: string, suffix?: string): string;
+declare function truncateText(text: string, maxLength: number, suffix?: string): string;
+declare function capitalize(text: string, options?: {
+    firstWordOnly?: boolean;
+    lowerRest?: boolean;
+}): string;
+declare function cleanText(text: string, allowSpaces?: boolean): string;
+declare function countWords(text: string): number;
+declare function isEmpty(text: string | null | undefined): boolean;
+declare function normalizeSpaces(text: string, options?: {
+    newlines?: boolean;
+}): string;
+
+interface ValidationResult {
+    isValid: boolean;
+    errors?: string[];
+}
+declare function validateEmail(email: string, locale?: Locale): ValidationResult;
+declare function validatePassword(password: string, options?: {
+    minLength?: number;
+    requireUppercase?: boolean;
+    requireLowercase?: boolean;
+    requireNumbers?: boolean;
+    requireSpecialChars?: boolean;
+}, locale?: Locale): ValidationResult;
+declare function validateUrl(url: string, locale?: Locale): ValidationResult;
+declare function validatePhone(phone: string, locale?: Locale): ValidationResult;
+declare function validateUsername(username: string, options?: {
+    minLength?: number;
+    maxLength?: number;
+    allowSpecialChars?: boolean;
+}, locale?: Locale): ValidationResult;
+declare function validateSlug(slug: string, options?: {
+    minLength?: number;
+    maxLength?: number;
+}, locale?: Locale): ValidationResult;
+declare function validateText(text: string, options?: {
+    minLength?: number;
+    maxLength?: number;
+    fieldName?: string;
+}, locale?: Locale): ValidationResult;
+
+declare function prefersReducedMotion(): boolean;
+declare function onReducedMotionChange(callback: (prefersReduced: boolean) => void): () => void;
+declare function scrollToPosition(x?: number, y?: number, options?: {
+    smooth?: boolean;
+    behavior?: ScrollBehavior;
+}): void;
+declare function scrollToTop(smooth?: boolean): void;
+declare function smoothScrollTo(x: number, y: number, duration?: number): void;
+declare function scrollToElement(element: string | Element, options?: {
+    smooth?: boolean;
+    offset?: number;
+    behavior?: ScrollBehavior;
+}): void;
+declare function isElementVisible(element: string | Element, threshold?: number): boolean;
+declare function getElementPosition(element: string | Element): {
+    x: number;
+    y: number;
+} | null;
+declare function isMobile(): boolean;
+declare function isDarkMode(): boolean;
+declare function onDarkModeChange(callback: (isDark: boolean) => void): () => void;
+declare function copyToClipboard(text: string): Promise<boolean>;
+declare function downloadFile(blob: Blob, filename: string): void;
+
+declare function formatNumber$1(num: number): string;
+declare function calculateChange(current: number, previous: number): number;
+declare function formatPercentage(value: number, options?: {
+    showSign?: boolean;
+    decimals?: number;
+}): string;
+declare function generateMockChartData(days: number, locale?: string): Array<Record<string, any>>;
+declare function groupDataByPeriod<T extends Record<string, any>>(data: T[]): T[];
+declare function calculateMovingAverage(data: number[], window: number): number[];
+declare function findMinMax<T extends Record<string, any>>(data: T[], field: keyof T): {
+    min: number;
+    max: number;
+};
+
+declare function formatDate(date: string | Date, format?: 'short' | 'long' | 'full'): string;
+declare function formatDateTime(date: string | Date): string;
+declare function formatRelativeDate(date: string | Date): string;
+declare function formatCurrency(value: number, options?: Intl.NumberFormatOptions): string;
+declare function formatNumber(value: number, decimals?: number): string;
+declare function formatCompact(value: number, decimals?: number): string;
+declare function translateStatus(status: string): string;
+
+declare const ptBr_formatCompact: typeof formatCompact;
+declare const ptBr_formatCurrency: typeof formatCurrency;
+declare const ptBr_formatDate: typeof formatDate;
+declare const ptBr_formatDateTime: typeof formatDateTime;
+declare const ptBr_formatNumber: typeof formatNumber;
+declare const ptBr_formatRelativeDate: typeof formatRelativeDate;
+declare const ptBr_translateStatus: typeof translateStatus;
+declare namespace ptBr {
+  export { ptBr_formatCompact as formatCompact, ptBr_formatCurrency as formatCurrency, ptBr_formatDate as formatDate, ptBr_formatDateTime as formatDateTime, ptBr_formatNumber as formatNumber, ptBr_formatRelativeDate as formatRelativeDate, ptBr_translateStatus as translateStatus };
+}
+
+export { Locale, type ValidationResult, calculateChange, calculateMovingAverage, capitalize, cleanText, copyToClipboard, countWords, downloadFile, extractInitials, findMinMax, formatNumber$1 as formatNumber, formatPercentage, generateMockChartData, generateUniqueId, getElementPosition, groupDataByPeriod, isDarkMode, isElementVisible, isEmpty, isMobile, normalizeSpaces, onDarkModeChange, onReducedMotionChange, prefersReducedMotion, ptBr as ptBR, scrollToElement, scrollToPosition, scrollToTop, smoothScrollTo, truncateText, validateEmail, validatePassword, validatePhone, validateSlug, validateText, validateUrl, validateUsername };