@proyecto-viviana/solidaria 0.2.4 → 0.2.8

package/src/i18n/createCollator.ts

@@ -1,79 +1,79 @@
-/**
- * createCollator hook for solidaria
- *
- * Provides localized string comparison/collation with caching.
- *
- * Port of @react-aria/i18n useCollator.
- */
-
-import { createMemo } from 'solid-js';
-import { useLocale } from './locale';
-import { createCacheKey } from './utils';
-
-// ============================================
-// CACHE
-// ============================================
-
-const collatorCache = new Map<string, Intl.Collator>();
-
-/**
- * Gets or creates a cached collator.
- */
-function getCachedCollator(
-  locale: string,
-  options?: Intl.CollatorOptions
-): Intl.Collator {
-  const cacheKey = createCacheKey(locale, options as Record<string, unknown>);
-
-  if (collatorCache.has(cacheKey)) {
-    return collatorCache.get(cacheKey)!;
-  }
-
-  const collator = new Intl.Collator(locale, options);
-  collatorCache.set(cacheKey, collator);
-  return collator;
-}
-
-// ============================================
-// HOOK
-// ============================================
-
-/**
- * Provides localized string collation for the current locale.
- * Useful for sorting strings according to locale-specific rules.
- *
- * @example
- * ```tsx
- * function SortedList(props: { items: string[] }) {
- *   const collator = createCollator();
- *
- *   const sortedItems = () =>
- *     [...props.items].sort((a, b) => collator().compare(a, b));
- *
- *   return (
- *     <ul>
- *       <For each={sortedItems()}>
- *         {(item) => <li>{item}</li>}
- *       </For>
- *     </ul>
- *   );
- * }
- * ```
- *
- * @example
- * ```tsx
- * // Case-insensitive sorting
- * const collator = createCollator({ sensitivity: 'base' });
- *
- * // Numeric sorting
- * const numericCollator = createCollator({ numeric: true });
- * // ['a1', 'a10', 'a2'].sort(numericCollator().compare) -> ['a1', 'a2', 'a10']
- * ```
- */
-export function createCollator(
-  options?: Intl.CollatorOptions
-): () => Intl.Collator {
-  const locale = useLocale();
-
-  return createMemo(() => getCachedCollator(locale().locale, options));
-}
+/**
+ * createCollator hook for solidaria
+ *
+ * Provides localized string comparison/collation with caching.
+ *
+ * Port of @react-aria/i18n useCollator.
+ */
+
+import { createMemo } from 'solid-js';
+import { useLocale } from './locale';
+import { createCacheKey } from './utils';
+
+// ============================================
+// CACHE
+// ============================================
+
+const collatorCache = new Map<string, Intl.Collator>();
+
+/**
+ * Gets or creates a cached collator.
+ */
+function getCachedCollator(
+  locale: string,
+  options?: Intl.CollatorOptions
+): Intl.Collator {
+  const cacheKey = createCacheKey(locale, options as Record<string, unknown>);
+
+  if (collatorCache.has(cacheKey)) {
+    return collatorCache.get(cacheKey)!;
+  }
+
+  const collator = new Intl.Collator(locale, options);
+  collatorCache.set(cacheKey, collator);
+  return collator;
+}
+
+// ============================================
+// HOOK
+// ============================================
+
+/**
+ * Provides localized string collation for the current locale.
+ * Useful for sorting strings according to locale-specific rules.
+ *
+ * @example
+ * ```tsx
+ * function SortedList(props: { items: string[] }) {
+ *   const collator = createCollator();
+ *
+ *   const sortedItems = () =>
+ *     [...props.items].sort((a, b) => collator().compare(a, b));
+ *
+ *   return (
+ *     <ul>
+ *       <For each={sortedItems()}>
+ *         {(item) => <li>{item}</li>}
+ *       </For>
+ *     </ul>
+ *   );
+ * }
+ * ```
+ *
+ * @example
+ * ```tsx
+ * // Case-insensitive sorting
+ * const collator = createCollator({ sensitivity: 'base' });
+ *
+ * // Numeric sorting
+ * const numericCollator = createCollator({ numeric: true });
+ * // ['a1', 'a10', 'a2'].sort(numericCollator().compare) -> ['a1', 'a2', 'a10']
+ * ```
+ */
+export function createCollator(
+  options?: Intl.CollatorOptions
+): () => Intl.Collator {
+  const locale = useLocale();
+
+  return createMemo(() => getCachedCollator(locale().locale, options));
+}

package/src/i18n/createDateFormatter.ts

@@ -1,83 +1,83 @@
-/**
- * createDateFormatter hook for solidaria
- *
- * Provides localized date formatting with caching.
- *
- * Port of @react-aria/i18n useDateFormatter.
- */
-
-import { createMemo } from 'solid-js';
-import { useLocale } from './locale';
-import { createCacheKey } from './utils';
-
-// ============================================
-// CACHE
-// ============================================
-
-const dateFormatterCache = new Map<string, Intl.DateTimeFormat>();
-
-/**
- * Gets or creates a cached date formatter.
- */
-function getCachedDateFormatter(
-  locale: string,
-  options?: Intl.DateTimeFormatOptions
-): Intl.DateTimeFormat {
-  const cacheKey = createCacheKey(locale, options as Record<string, unknown>);
-
-  if (dateFormatterCache.has(cacheKey)) {
-    return dateFormatterCache.get(cacheKey)!;
-  }
-
-  const formatter = new Intl.DateTimeFormat(locale, options);
-  dateFormatterCache.set(cacheKey, formatter);
-  return formatter;
-}
-
-// ============================================
-// HOOK
-// ============================================
-
-/**
- * Provides localized date and time formatting for the current locale.
- * Automatically updates when the locale changes.
- *
- * @example
- * ```tsx
- * function DateDisplay(props: { date: Date }) {
- *   const formatter = createDateFormatter({
- *     year: 'numeric',
- *     month: 'long',
- *     day: 'numeric',
- *   });
- *
- *   return <span>{formatter().format(props.date)}</span>;
- * }
- * ```
- *
- * @example
- * ```tsx
- * // Short date
- * const shortDate = createDateFormatter({ dateStyle: 'short' });
- * shortDate().format(new Date()); // '1/19/26' (US) or '19/01/26' (UK)
- *
- * // Full date with time
- * const fullDateTime = createDateFormatter({
- *   dateStyle: 'full',
- *   timeStyle: 'short',
- * });
- *
- * // Time only
- * const timeFormatter = createDateFormatter({
- *   hour: 'numeric',
- *   minute: '2-digit',
- * });
- * ```
- */
-export function createDateFormatter(
-  options?: Intl.DateTimeFormatOptions
-): () => Intl.DateTimeFormat {
-  const locale = useLocale();
-
-  return createMemo(() => getCachedDateFormatter(locale().locale, options));
-}
+/**
+ * createDateFormatter hook for solidaria
+ *
+ * Provides localized date formatting with caching.
+ *
+ * Port of @react-aria/i18n useDateFormatter.
+ */
+
+import { createMemo } from 'solid-js';
+import { useLocale } from './locale';
+import { createCacheKey } from './utils';
+
+// ============================================
+// CACHE
+// ============================================
+
+const dateFormatterCache = new Map<string, Intl.DateTimeFormat>();
+
+/**
+ * Gets or creates a cached date formatter.
+ */
+function getCachedDateFormatter(
+  locale: string,
+  options?: Intl.DateTimeFormatOptions
+): Intl.DateTimeFormat {
+  const cacheKey = createCacheKey(locale, options as Record<string, unknown>);
+
+  if (dateFormatterCache.has(cacheKey)) {
+    return dateFormatterCache.get(cacheKey)!;
+  }
+
+  const formatter = new Intl.DateTimeFormat(locale, options);
+  dateFormatterCache.set(cacheKey, formatter);
+  return formatter;
+}
+
+// ============================================
+// HOOK
+// ============================================
+
+/**
+ * Provides localized date and time formatting for the current locale.
+ * Automatically updates when the locale changes.
+ *
+ * @example
+ * ```tsx
+ * function DateDisplay(props: { date: Date }) {
+ *   const formatter = createDateFormatter({
+ *     year: 'numeric',
+ *     month: 'long',
+ *     day: 'numeric',
+ *   });
+ *
+ *   return <span>{formatter().format(props.date)}</span>;
+ * }
+ * ```
+ *
+ * @example
+ * ```tsx
+ * // Short date
+ * const shortDate = createDateFormatter({ dateStyle: 'short' });
+ * shortDate().format(new Date()); // '1/19/26' (US) or '19/01/26' (UK)
+ *
+ * // Full date with time
+ * const fullDateTime = createDateFormatter({
+ *   dateStyle: 'full',
+ *   timeStyle: 'short',
+ * });
+ *
+ * // Time only
+ * const timeFormatter = createDateFormatter({
+ *   hour: 'numeric',
+ *   minute: '2-digit',
+ * });
+ * ```
+ */
+export function createDateFormatter(
+  options?: Intl.DateTimeFormatOptions
+): () => Intl.DateTimeFormat {
+  const locale = useLocale();
+
+  return createMemo(() => getCachedDateFormatter(locale().locale, options));
+}

package/src/i18n/createFilter.ts

@@ -1,131 +1,131 @@
-/**
- * createFilter hook for solidaria
- *
- * Provides localized string filtering with collation support.
- *
- * Port of @react-aria/i18n useFilter.
- */
-
-import { createMemo } from 'solid-js';
-import { createCollator } from './createCollator';
-
-// ============================================
-// TYPES
-// ============================================
-
-export interface Filter {
-  /** Returns whether a string starts with a given substring. */
-  startsWith(string: string, substring: string): boolean;
-  /** Returns whether a string ends with a given substring. */
-  endsWith(string: string, substring: string): boolean;
-  /** Returns whether a string contains a given substring. */
-  contains(string: string, substring: string): boolean;
-}
-
-// ============================================
-// HOOK
-// ============================================
-
-/**
- * Provides localized string search functionality for filtering or matching items.
- * Respects locale-specific collation rules for case and diacritic sensitivity.
- *
- * @example
- * ```tsx
- * function SearchableList(props: { items: { name: string }[] }) {
- *   const [query, setQuery] = createSignal('');
- *   const filter = createFilter({ sensitivity: 'base' });
- *
- *   const filteredItems = () =>
- *     props.items.filter((item) =>
- *       filter().contains(item.name, query())
- *     );
- *
- *   return (
- *     <>
- *       <input
- *         value={query()}
- *         onInput={(e) => setQuery(e.target.value)}
- *         placeholder="Search..."
- *       />
- *       <ul>
- *         <For each={filteredItems()}>
- *           {(item) => <li>{item.name}</li>}
- *         </For>
- *       </ul>
- *     </>
- *   );
- * }
- * ```
- *
- * @example
- * ```tsx
- * // Case-insensitive, diacritic-insensitive filtering
- * const filter = createFilter({ sensitivity: 'base' });
- * filter().contains('Café', 'cafe'); // true
- * filter().startsWith('Hello', 'hello'); // true
- * ```
- */
-export function createFilter(options?: Intl.CollatorOptions): () => Filter {
-  const collator = createCollator({
-    usage: 'search',
-    ...options,
-  });
-
-  return createMemo(() => {
-    const coll = collator();
-
-    const startsWith = (str: string, substring: string): boolean => {
-      if (substring.length === 0) {
-        return true;
-      }
-
-      // Normalize both strings for safe slicing
-      const normalizedStr = str.normalize('NFC');
-      const normalizedSub = substring.normalize('NFC');
-
-      return (
-        coll.compare(normalizedStr.slice(0, normalizedSub.length), normalizedSub) ===
-        0
-      );
-    };
-
-    const endsWith = (str: string, substring: string): boolean => {
-      if (substring.length === 0) {
-        return true;
-      }
-
-      const normalizedStr = str.normalize('NFC');
-      const normalizedSub = substring.normalize('NFC');
-
-      return (
-        coll.compare(normalizedStr.slice(-normalizedSub.length), normalizedSub) === 0
-      );
-    };
-
-    const contains = (str: string, substring: string): boolean => {
-      if (substring.length === 0) {
-        return true;
-      }
-
-      const normalizedStr = str.normalize('NFC');
-      const normalizedSub = substring.normalize('NFC');
-      const sliceLen = normalizedSub.length;
-
-      for (let scan = 0; scan + sliceLen <= normalizedStr.length; scan++) {
-        const slice = normalizedStr.slice(scan, scan + sliceLen);
-        if (coll.compare(normalizedSub, slice) === 0) {
-          return true;
-        }
-      }
-
-      return false;
-    };
-
-    return {
-      startsWith,
-      endsWith,
-      contains,
-    };
-  });
-}
+/**
+ * createFilter hook for solidaria
+ *
+ * Provides localized string filtering with collation support.
+ *
+ * Port of @react-aria/i18n useFilter.
+ */
+
+import { createMemo } from 'solid-js';
+import { createCollator } from './createCollator';
+
+// ============================================
+// TYPES
+// ============================================
+
+export interface Filter {
+  /** Returns whether a string starts with a given substring. */
+  startsWith(string: string, substring: string): boolean;
+  /** Returns whether a string ends with a given substring. */
+  endsWith(string: string, substring: string): boolean;
+  /** Returns whether a string contains a given substring. */
+  contains(string: string, substring: string): boolean;
+}
+
+// ============================================
+// HOOK
+// ============================================
+
+/**
+ * Provides localized string search functionality for filtering or matching items.
+ * Respects locale-specific collation rules for case and diacritic sensitivity.
+ *
+ * @example
+ * ```tsx
+ * function SearchableList(props: { items: { name: string }[] }) {
+ *   const [query, setQuery] = createSignal('');
+ *   const filter = createFilter({ sensitivity: 'base' });
+ *
+ *   const filteredItems = () =>
+ *     props.items.filter((item) =>
+ *       filter().contains(item.name, query())
+ *     );
+ *
+ *   return (
+ *     <>
+ *       <input
+ *         value={query()}
+ *         onInput={(e) => setQuery(e.target.value)}
+ *         placeholder="Search..."
+ *       />
+ *       <ul>
+ *         <For each={filteredItems()}>
+ *           {(item) => <li>{item.name}</li>}
+ *         </For>
+ *       </ul>
+ *     </>
+ *   );
+ * }
+ * ```
+ *
+ * @example
+ * ```tsx
+ * // Case-insensitive, diacritic-insensitive filtering
+ * const filter = createFilter({ sensitivity: 'base' });
+ * filter().contains('Café', 'cafe'); // true
+ * filter().startsWith('Hello', 'hello'); // true
+ * ```
+ */
+export function createFilter(options?: Intl.CollatorOptions): () => Filter {
+  const collator = createCollator({
+    usage: 'search',
+    ...options,
+  });
+
+  return createMemo(() => {
+    const coll = collator();
+
+    const startsWith = (str: string, substring: string): boolean => {
+      if (substring.length === 0) {
+        return true;
+      }
+
+      // Normalize both strings for safe slicing
+      const normalizedStr = str.normalize('NFC');
+      const normalizedSub = substring.normalize('NFC');
+
+      return (
+        coll.compare(normalizedStr.slice(0, normalizedSub.length), normalizedSub) ===
+        0
+      );
+    };
+
+    const endsWith = (str: string, substring: string): boolean => {
+      if (substring.length === 0) {
+        return true;
+      }
+
+      const normalizedStr = str.normalize('NFC');
+      const normalizedSub = substring.normalize('NFC');
+
+      return (
+        coll.compare(normalizedStr.slice(-normalizedSub.length), normalizedSub) === 0
+      );
+    };
+
+    const contains = (str: string, substring: string): boolean => {
+      if (substring.length === 0) {
+        return true;
+      }
+
+      const normalizedStr = str.normalize('NFC');
+      const normalizedSub = substring.normalize('NFC');
+      const sliceLen = normalizedSub.length;
+
+      for (let scan = 0; scan + sliceLen <= normalizedStr.length; scan++) {
+        const slice = normalizedStr.slice(scan, scan + sliceLen);
+        if (coll.compare(normalizedSub, slice) === 0) {
+          return true;
+        }
+      }
+
+      return false;
+    };
+
+    return {
+      startsWith,
+      endsWith,
+      contains,
+    };
+  });
+}