@proyecto-viviana/solidaria 0.2.0 → 0.2.1

package/dist/i18n/createDateFormatter.d.ts

@@ -0,0 +1,45 @@
+/**
+ * createDateFormatter hook for solidaria
+ *
+ * Provides localized date formatting with caching.
+ *
+ * Port of @react-aria/i18n useDateFormatter.
+ */
+/**
+ * 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 declare function createDateFormatter(options?: Intl.DateTimeFormatOptions): () => Intl.DateTimeFormat;
+//# sourceMappingURL=createDateFormatter.d.ts.map

package/dist/i18n/createDateFormatter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"createDateFormatter.d.ts","sourceRoot":"","sources":["../../src/i18n/createDateFormatter.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAkCH;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAmCG;AACH,wBAAgB,mBAAmB,CACjC,OAAO,CAAC,EAAE,IAAI,CAAC,qBAAqB,GACnC,MAAM,IAAI,CAAC,cAAc,CAI3B"}

package/dist/i18n/createFilter.d.ts

@@ -0,0 +1,57 @@
+/**
+ * createFilter hook for solidaria
+ *
+ * Provides localized string filtering with collation support.
+ *
+ * Port of @react-aria/i18n useFilter.
+ */
+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;
+}
+/**
+ * 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 declare function createFilter(options?: Intl.CollatorOptions): () => Filter;
+//# sourceMappingURL=createFilter.d.ts.map

package/dist/i18n/createFilter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"createFilter.d.ts","sourceRoot":"","sources":["../../src/i18n/createFilter.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AASH,MAAM,WAAW,MAAM;IACrB,8DAA8D;IAC9D,UAAU,CAAC,MAAM,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC;IACvD,4DAA4D;IAC5D,QAAQ,CAAC,MAAM,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC;IACrD,2DAA2D;IAC3D,QAAQ,CAAC,MAAM,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC;CACtD;AAMD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAuCG;AACH,wBAAgB,YAAY,CAAC,OAAO,CAAC,EAAE,IAAI,CAAC,eAAe,GAAG,MAAM,MAAM,CA8DzE"}

package/dist/i18n/createNumberFormatter.d.ts

@@ -0,0 +1,43 @@
+/**
+ * createNumberFormatter hook for solidaria
+ *
+ * Provides localized number formatting with automatic locale updates.
+ *
+ * Port of @react-aria/i18n useNumberFormatter.
+ */
+import { NumberFormatter, type NumberFormatOptions } from './NumberFormatter';
+/**
+ * Provides localized number formatting for the current locale.
+ * Automatically updates when the locale changes.
+ *
+ * @example
+ * ```tsx
+ * function PriceDisplay(props: { value: number }) {
+ *   const formatter = createNumberFormatter({
+ *     style: 'currency',
+ *     currency: 'USD',
+ *   });
+ *
+ *   return <span>{formatter().format(props.value)}</span>;
+ * }
+ * ```
+ *
+ * @example
+ * ```tsx
+ * // Percent formatting
+ * const percentFormatter = createNumberFormatter({
+ *   style: 'percent',
+ *   minimumFractionDigits: 1,
+ * });
+ * percentFormatter().format(0.125); // '12.5%'
+ *
+ * // Unit formatting
+ * const tempFormatter = createNumberFormatter({
+ *   style: 'unit',
+ *   unit: 'celsius',
+ * });
+ * tempFormatter().format(25); // '25°C'
+ * ```
+ */
+export declare function createNumberFormatter(options?: NumberFormatOptions): () => NumberFormatter;
+//# sourceMappingURL=createNumberFormatter.d.ts.map

package/dist/i18n/createNumberFormatter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"createNumberFormatter.d.ts","sourceRoot":"","sources":["../../src/i18n/createNumberFormatter.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAIH,OAAO,EAAE,eAAe,EAAE,KAAK,mBAAmB,EAAE,MAAM,mBAAmB,CAAC;AAE9E;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgCG;AACH,wBAAgB,qBAAqB,CACnC,OAAO,GAAE,mBAAwB,GAChC,MAAM,eAAe,CAIvB"}

package/dist/i18n/createStringFormatter.d.ts

@@ -0,0 +1,42 @@
+/**
+ * String formatter for localized strings with ICU MessageFormat support.
+ * Port of @react-aria/i18n useLocalizedStringFormatter.
+ */
+import { LocalizedString, LocalizedStringDictionary, LocalizedStringFormatter, type LocalizedStrings } from '@internationalized/string';
+import { type Accessor } from 'solid-js';
+/**
+ * Returns a cached LocalizedStringDictionary for the given strings.
+ */
+export declare function createStringDictionary<K extends string = string, T extends LocalizedString = string>(strings: LocalizedStrings<K, T>, packageName?: string): LocalizedStringDictionary<K, T>;
+/**
+ * Provides localized string formatting for the current locale.
+ * Supports interpolating variables, selecting the correct pluralization,
+ * and formatting numbers. Automatically updates when the locale changes.
+ *
+ * @param strings - A mapping of languages to localized strings by key.
+ * @param packageName - Optional package name for global dictionary lookup.
+ *
+ * @example
+ * ```tsx
+ * const strings = {
+ *   'en-US': {
+ *     greeting: 'Hello, {name}!',
+ *     count: '{count, plural, one {# item} other {# items}}'
+ *   }
+ * };
+ *
+ * function MyComponent() {
+ *   const stringFormatter = createStringFormatter(strings);
+ *
+ *   return (
+ *     <div>
+ *       {stringFormatter().format('greeting', { name: 'World' })}
+ *       {stringFormatter().format('count', { count: 5 })}
+ *     </div>
+ *   );
+ * }
+ * ```
+ */
+export declare function createStringFormatter<K extends string = string, T extends LocalizedString = string>(strings: LocalizedStrings<K, T>, packageName?: string): Accessor<LocalizedStringFormatter<K, T>>;
+export type { LocalizedString, LocalizedStringDictionary, LocalizedStringFormatter, LocalizedStrings, };
+//# sourceMappingURL=createStringFormatter.d.ts.map

package/dist/i18n/createStringFormatter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"createStringFormatter.d.ts","sourceRoot":"","sources":["../../src/i18n/createStringFormatter.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EACL,eAAe,EACf,yBAAyB,EACzB,wBAAwB,EACxB,KAAK,gBAAgB,EACtB,MAAM,2BAA2B,CAAC;AACnC,OAAO,EAAc,KAAK,QAAQ,EAAE,MAAM,UAAU,CAAC;AAiBrD;;GAEG;AACH,wBAAgB,sBAAsB,CAAC,CAAC,SAAS,MAAM,GAAG,MAAM,EAAE,CAAC,SAAS,eAAe,GAAG,MAAM,EAClG,OAAO,EAAE,gBAAgB,CAAC,CAAC,EAAE,CAAC,CAAC,EAC/B,WAAW,CAAC,EAAE,MAAM,GACnB,yBAAyB,CAAC,CAAC,EAAE,CAAC,CAAC,CAKjC;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AACH,wBAAgB,qBAAqB,CAAC,CAAC,SAAS,MAAM,GAAG,MAAM,EAAE,CAAC,SAAS,eAAe,GAAG,MAAM,EACjG,OAAO,EAAE,gBAAgB,CAAC,CAAC,EAAE,CAAC,CAAC,EAC/B,WAAW,CAAC,EAAE,MAAM,GACnB,QAAQ,CAAC,wBAAwB,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAK1C;AAGD,YAAY,EACV,eAAe,EACf,yBAAyB,EACzB,wBAAwB,EACxB,gBAAgB,GACjB,CAAC"}

package/dist/i18n/index.d.ts

@@ -0,0 +1,9 @@
+export { I18nProvider, useLocale, createDefaultLocale, getDefaultLocale, type Direction, type Locale, type I18nProviderProps, } from './locale';
+export { isRTL, createCacheKey } from './utils';
+export { NumberFormatter, type NumberFormatOptions, } from './NumberFormatter';
+export { createNumberFormatter } from './createNumberFormatter';
+export { createDateFormatter } from './createDateFormatter';
+export { createCollator } from './createCollator';
+export { createFilter, type Filter } from './createFilter';
+export { createStringFormatter, createStringDictionary, type LocalizedString, type LocalizedStringDictionary, type LocalizedStringFormatter, type LocalizedStrings, } from './createStringFormatter';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/i18n/index.ts"],"names":[],"mappings":"AACA,OAAO,EACL,YAAY,EACZ,SAAS,EACT,mBAAmB,EACnB,gBAAgB,EAChB,KAAK,SAAS,EACd,KAAK,MAAM,EACX,KAAK,iBAAiB,GACvB,MAAM,UAAU,CAAC;AAGlB,OAAO,EAAE,KAAK,EAAE,cAAc,EAAE,MAAM,SAAS,CAAC;AAGhD,OAAO,EACL,eAAe,EACf,KAAK,mBAAmB,GACzB,MAAM,mBAAmB,CAAC;AAE3B,OAAO,EAAE,qBAAqB,EAAE,MAAM,yBAAyB,CAAC;AAGhE,OAAO,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AAG5D,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAGlD,OAAO,EAAE,YAAY,EAAE,KAAK,MAAM,EAAE,MAAM,gBAAgB,CAAC;AAG3D,OAAO,EACL,qBAAqB,EACrB,sBAAsB,EACtB,KAAK,eAAe,EACpB,KAAK,yBAAyB,EAC9B,KAAK,wBAAwB,EAC7B,KAAK,gBAAgB,GACtB,MAAM,yBAAyB,CAAC"}

package/dist/i18n/locale.d.ts

@@ -0,0 +1,66 @@
+/**
+ * Locale context and provider for solidaria
+ *
+ * Provides locale and text direction to the component tree.
+ *
+ * Port of @react-aria/i18n context and useDefaultLocale.
+ */
+import { type Accessor, type JSX, type ParentProps } from 'solid-js';
+/** Text direction: left-to-right or right-to-left. */
+export type Direction = 'ltr' | 'rtl';
+/** Locale information including language code and text direction. */
+export interface Locale {
+    /** The BCP47 language code for the locale (e.g., 'en-US', 'ar-SA'). */
+    locale: string;
+    /** The writing direction for the locale. */
+    direction: Direction;
+}
+export interface I18nProviderProps extends ParentProps {
+    /** The locale to apply to the children. If not provided, uses browser default. */
+    locale?: string;
+}
+/**
+ * Gets the default locale from the browser/system.
+ */
+export declare function getDefaultLocale(): Locale;
+/**
+ * Returns the current browser/system locale, and updates when it changes.
+ *
+ * @example
+ * ```tsx
+ * const locale = createDefaultLocale();
+ * console.log(locale().locale); // 'en-US'
+ * console.log(locale().direction); // 'ltr'
+ * ```
+ */
+export declare function createDefaultLocale(): Accessor<Locale>;
+/**
+ * Returns the current locale and layout direction from context or browser default.
+ *
+ * @example
+ * ```tsx
+ * function MyComponent() {
+ *   const locale = useLocale();
+ *   return <div dir={locale().direction}>{locale().locale}</div>;
+ * }
+ * ```
+ */
+export declare function useLocale(): Accessor<Locale>;
+/**
+ * Provides the locale for the application to all child components.
+ *
+ * @example
+ * ```tsx
+ * // Use browser default locale
+ * <I18nProvider>
+ *   <App />
+ * </I18nProvider>
+ *
+ * // Override with specific locale
+ * <I18nProvider locale="ar-SA">
+ *   <App /> // Will have RTL direction
+ * </I18nProvider>
+ * ```
+ */
+export declare function I18nProvider(props: I18nProviderProps): JSX.Element;
+//# sourceMappingURL=locale.d.ts.map

package/dist/i18n/locale.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"locale.d.ts","sourceRoot":"","sources":["../../src/i18n/locale.tsx"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EACL,KAAK,QAAQ,EACb,KAAK,GAAG,EACR,KAAK,WAAW,EAOjB,MAAM,UAAU,CAAC;AAOlB,sDAAsD;AACtD,MAAM,MAAM,SAAS,GAAG,KAAK,GAAG,KAAK,CAAC;AAEtC,qEAAqE;AACrE,MAAM,WAAW,MAAM;IACrB,uEAAuE;IACvE,MAAM,EAAE,MAAM,CAAC;IACf,4CAA4C;IAC5C,SAAS,EAAE,SAAS,CAAC;CACtB;AAED,MAAM,WAAW,iBAAkB,SAAQ,WAAW;IACpD,kFAAkF;IAClF,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAYD;;GAEG;AACH,wBAAgB,gBAAgB,IAAI,MAAM,CAoBzC;AAmBD;;;;;;;;;GASG;AACH,wBAAgB,mBAAmB,IAAI,QAAQ,CAAC,MAAM,CAAC,CA2BtD;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,SAAS,IAAI,QAAQ,CAAC,MAAM,CAAC,CAI5C;AAMD;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,iBAAiB,GAAG,GAAG,CAAC,OAAO,CAkBlE"}

package/dist/i18n/utils.d.ts

@@ -0,0 +1,17 @@
+/**
+ * i18n utilities for solidaria
+ *
+ * RTL detection and locale utilities.
+ *
+ * Port of @react-aria/i18n utils.
+ */
+/**
+ * Determines if a locale is read right to left.
+ * Uses Intl.Locale API when available for accurate detection.
+ */
+export declare function isRTL(localeString: string): boolean;
+/**
+ * Creates a cache key for formatter options.
+ */
+export declare function createCacheKey(locale: string, options?: Record<string, unknown>): string;
+//# sourceMappingURL=utils.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../../src/i18n/utils.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAsCH;;;GAGG;AACH,wBAAgB,KAAK,CAAC,YAAY,EAAE,MAAM,GAAG,OAAO,CAgCnD;AAED;;GAEG;AACH,wBAAgB,cAAc,CAC5B,MAAM,EAAE,MAAM,EACd,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAChC,MAAM,CAUR"}