svelte-date-utils 0.2.0 → 0.3.0

package/dist/getUserLocale.d.ts

@@ -0,0 +1,13 @@
+export interface UserLocaleOptions {
+    /** Add `fallbackLocale` at the end of the list. Defaults to true. */
+    useFallbackLocale?: boolean;
+    /** Defaults to `en-US`. */
+    fallbackLocale?: string;
+}
+/** The locales of the browser, most preferred first, without duplicates. */
+export declare function getUserLocales({ useFallbackLocale, fallbackLocale, }?: UserLocaleOptions): string[];
+/** The most preferred locale of the browser. With `useFallbackLocale: false` there may be none. */
+export declare function getUserLocale(options?: UserLocaleOptions & {
+    useFallbackLocale?: true;
+}): string;
+export declare function getUserLocale(options: UserLocaleOptions): string | undefined;

package/dist/getUserLocale.js

@@ -0,0 +1,39 @@
+// A dependency-free replacement for `get-user-locale` (and its `memoize` dependency).
+const splitCommas = (locale) => (locale.includes(',') ? locale.split(',') : [locale]);
+/** Turns `en-us` into `en-US`, `en-US.UTF-8` and `en-US@posix` into `en-US`, and `C` into `en-US`. */
+function normalizeLocale(locale) {
+    if (!locale)
+        return locale;
+    if (locale === 'C' || locale === 'posix' || locale === 'POSIX')
+        return 'en-US';
+    // "en-US.UTF-8": keep the part before the dot
+    if (locale.includes('.'))
+        return normalizeLocale(locale.split('.')[0] ?? '');
+    // "en-US@posix": keep the part before the at sign
+    if (locale.includes('@'))
+        return normalizeLocale(locale.split('@')[0] ?? '');
+    // already "en-US", or has no region
+    if (!locale.includes('-') || locale.toLowerCase() !== locale)
+        return locale;
+    const [language, region = ''] = locale.split('-');
+    return `${language}-${region.toUpperCase()}`;
+}
+/** The locales of the browser, most preferred first, without duplicates. */
+export function getUserLocales({ useFallbackLocale = true, fallbackLocale = 'en-US', } = {}) {
+    const list = [];
+    if (typeof navigator !== 'undefined') {
+        for (const language of navigator.languages ?? [])
+            list.push(...splitCommas(language));
+        if (navigator.language)
+            list.push(...splitCommas(navigator.language));
+    }
+    if (useFallbackLocale)
+        list.push(fallbackLocale);
+    return list
+        .filter((locale) => typeof locale === 'string')
+        .map(normalizeLocale)
+        .filter((locale, index, all) => all.indexOf(locale) === index);
+}
+export function getUserLocale(options) {
+    return getUserLocales(options)[0];
+}

package/dist/index.d.ts

@@ -3,6 +3,8 @@ export type { AdapterDateOptions } from './AdapterDate.js';
 export { createDateUtils } from './createDateUtils.js';
 export type { DateUtils, TimeLike, YearLike } from './createDateUtils.js';
 export type { DateAdapter } from './types.js';
+export { getUserLocale, getUserLocales } from './getUserLocale.js';
+export type { UserLocaleOptions } from './getUserLocale.js';
 /**
  * The helpers on the native `Date`, with the names and behavior of `@wojtekmaj/date-utils`.
  * For date-fns or Luxon, call `createDateUtils` with `AdapterDateFns` or `AdapterLuxon`

package/dist/index.js

@@ -2,6 +2,7 @@ import { AdapterDate } from './AdapterDate.js';
 import { createDateUtils } from './createDateUtils.js';
 export { AdapterDate } from './AdapterDate.js';
 export { createDateUtils } from './createDateUtils.js';
+export { getUserLocale, getUserLocales } from './getUserLocale.js';
 /**
  * The helpers on the native `Date`, with the names and behavior of `@wojtekmaj/date-utils`.
  * For date-fns or Luxon, call `createDateUtils` with `AdapterDateFns` or `AdapterLuxon`

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "svelte-date-utils",
-  "version": "0.2.0",
+  "version": "0.3.0",
   "description": "Date helpers for calendars and date inputs (start, end, previous, next and range of a century, decade, year, month and day) that work on native Date, date-fns or Luxon through adapters.",
   "keywords": [
     "date",

package/src/getUserLocale.ts

@@ -0,0 +1,50 @@
+// A dependency-free replacement for `get-user-locale` (and its `memoize` dependency).
+
+export interface UserLocaleOptions {
+  /** Add `fallbackLocale` at the end of the list. Defaults to true. */
+  useFallbackLocale?: boolean;
+  /** Defaults to `en-US`. */
+  fallbackLocale?: string;
+}
+
+const splitCommas = (locale: string) => (locale.includes(',') ? locale.split(',') : [locale]);
+
+/** Turns `en-us` into `en-US`, `en-US.UTF-8` and `en-US@posix` into `en-US`, and `C` into `en-US`. */
+function normalizeLocale(locale: string): string {
+  if (!locale) return locale;
+  if (locale === 'C' || locale === 'posix' || locale === 'POSIX') return 'en-US';
+  // "en-US.UTF-8": keep the part before the dot
+  if (locale.includes('.')) return normalizeLocale(locale.split('.')[0] ?? '');
+  // "en-US@posix": keep the part before the at sign
+  if (locale.includes('@')) return normalizeLocale(locale.split('@')[0] ?? '');
+  // already "en-US", or has no region
+  if (!locale.includes('-') || locale.toLowerCase() !== locale) return locale;
+  const [language, region = ''] = locale.split('-');
+  return `${language}-${region.toUpperCase()}`;
+}
+
+/** The locales of the browser, most preferred first, without duplicates. */
+export function getUserLocales({
+  useFallbackLocale = true,
+  fallbackLocale = 'en-US',
+}: UserLocaleOptions = {}): string[] {
+  const list: unknown[] = [];
+
+  if (typeof navigator !== 'undefined') {
+    for (const language of navigator.languages ?? []) list.push(...splitCommas(language));
+    if (navigator.language) list.push(...splitCommas(navigator.language));
+  }
+  if (useFallbackLocale) list.push(fallbackLocale);
+
+  return list
+    .filter((locale): locale is string => typeof locale === 'string')
+    .map(normalizeLocale)
+    .filter((locale, index, all) => all.indexOf(locale) === index);
+}
+
+/** The most preferred locale of the browser. With `useFallbackLocale: false` there may be none. */
+export function getUserLocale(options?: UserLocaleOptions & { useFallbackLocale?: true }): string;
+export function getUserLocale(options: UserLocaleOptions): string | undefined;
+export function getUserLocale(options?: UserLocaleOptions): string | undefined {
+  return getUserLocales(options)[0];
+}

package/src/index.ts

@@ -6,6 +6,8 @@ export type { AdapterDateOptions } from './AdapterDate.js';
 export { createDateUtils } from './createDateUtils.js';
 export type { DateUtils, TimeLike, YearLike } from './createDateUtils.js';
 export type { DateAdapter } from './types.js';
+export { getUserLocale, getUserLocales } from './getUserLocale.js';
+export type { UserLocaleOptions } from './getUserLocale.js';
 
 /**
  * The helpers on the native `Date`, with the names and behavior of `@wojtekmaj/date-utils`.