atomic-fns 0.4.3 → 1.1.2

package/dist/i18n/currency.d.ts

@@ -1,12 +1,12 @@
-import { Decimal } from '../globals/decimal.js';
+import { Decimal } from '../decimal/index.js';
 /**
  * Currency represents a local currency amount that can be formatted using the `Intl` apis.
  */
 export declare class Currency extends Decimal {
-    locale: string;
-    currency: string;
-    numberFormat: Intl.NumberFormat;
-    options: Intl.NumberFormatOptions;
+    private readonly locale;
+    private readonly currency;
+    private readonly numberFormat;
+    private readonly options;
     constructor(amount: any, currency: string, locale?: string, opts?: Intl.NumberFormatOptions);
     clone(n: any): Currency;
     negated(): Currency;

package/dist/i18n/currency.js

@@ -1,6 +1,6 @@
 import { defaults } from '../collections/index.js';
 import { isObject } from '../globals/index.js';
-import { Decimal } from '../globals/decimal.js';
+import { Decimal } from '../decimal/index.js';
 /**
  * Currency represents a local currency amount that can be formatted using the `Intl` apis.
  */

package/dist/i18n/date/format.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Returns a new Date from the given arguments.
+ * @param {string | number | Date} date The date value
+ * @param {?boolean} [utc=false] Interprets the given value as a UTC date
+ * @returns {Date} The new date object
+ */
+export declare function getDate(date: string | number | Date, utc?: boolean): Date;
+/**
+ * Formats a date using a formatting string in the {@link https://strftime.org/ strftime} format, in any given locale.
+ * @param {string} fmt The format string to apply
+ * @param {number | Date} date The date value
+ * @param {?string} locale The locale to use when formatting (default is system locale).
+ * @returns {string} The string representation of date
+ * @see {@link https://strftime.org/ strftime format}
+ */
+export declare function format(fmt: string, date: number | Date, locale?: any): string;

package/dist/i18n/date/format.js

@@ -0,0 +1,313 @@
+const NATIVE_DATE = /^(\d{4})[-/]?(\d{1,2})?[-/]?(\d{0,2})[Tt\s]*(\d{1,2})?:?(\d{1,2})?:?(\d{1,2})?[.:]?(\d+)?$/;
+/**
+ * Returns a new Date from the given arguments.
+ * @param {string | number | Date} date The date value
+ * @param {?boolean} [utc=false] Interprets the given value as a UTC date
+ * @returns {Date} The new date object
+ */
+export function getDate(date, utc = false) {
+    if (date === null)
+        return new Date(NaN);
+    if (!date)
+        return new Date();
+    if (date instanceof Date)
+        return new Date(date);
+    if (typeof date === 'string' && !/Z$/i.test(date)) {
+        const d = date.match(NATIVE_DATE);
+        if (d) {
+            const m = d[2] - 1 || 0;
+            const ms = (d[7] || '0').slice(0, 3);
+            if (utc) {
+                return new Date(Date.UTC(d[1], m, d[3] || 1, d[4] || 0, d[5] || 0, d[6] || 0, ms));
+            }
+            return new Date(d[1], m, d[3] || 1, d[4] || 0, d[5] || 0, d[6] || 0, ms);
+        }
+    }
+    return new Date(date);
+}
+const n = 'numeric';
+const s = 'short';
+const l = 'long';
+const dd = '2-digit';
+const TOKEN_MAP = {
+    // weekday
+    '%A': { weekday: l },
+    '%a': { weekday: s },
+    '%aa': { weekday: n },
+    // day
+    '%d': { day: dd },
+    '%-d': { day: n },
+    // month
+    '%m': { month: dd },
+    '%-m': { month: n },
+    '%B': { month: l },
+    '%b': { month: s },
+    '%bb': { month: n },
+    // year
+    '%y': { year: n },
+    '%Y': { year: dd },
+    // hour
+    '%K': { hourCycle: 'h11', hour: dd },
+    '%I': { hourCycle: 'h12', hour: dd },
+    '%-I': { hourCycle: 'h12', hour: n },
+    '%H': { hourCycle: 'h23', hour: dd },
+    '%-H': { hourCycle: 'h23', hour: n },
+    '%k': { hourCycle: 'h24', hour: n },
+    // minutes
+    '%M': { minute: dd },
+    '%-M': { minute: n },
+    // seconds
+    '%S': { second: dd },
+    '%-S': { second: n },
+    // day period
+    '%P': { dayPeriod: l },
+    '%p': { dayPeriod: s },
+    '%pp': { dayPeriod: 'narrow' },
+    // era
+    '%N': { era: l, year: dd },
+    '%n': { era: s, year: dd },
+    '%nn': { era: n, year: 'narrow' },
+    // timeZoneName
+    '%Z': { timeZoneName: 'longGeneric', year: dd },
+    '%-Z': { timeZoneName: 'shortGeneric', year: dd },
+    '%z': { timeZoneName: 'longOffset', year: dd },
+    '%-z': { timeZoneName: 'shortOffset', year: dd },
+    '%ZZ': { timeZoneName: l, year: dd },
+    '%-ZZ': { timeZoneName: s, year: dd }
+};
+const HOUR_PARTS = { '%I': 1, '%-I': 1, '%K': 1, '%k': 1 };
+const ERA_PARTS = { '%n': 1, '%N': 1, '%nn': 1 };
+const TZ_PARTS = { '%ZZ': 1, '%-ZZ': 1, '%-z': 1, '%z': 1, '%-Z': 1, '%Z': 1 };
+const formatter = (locale, opts) => new Intl.DateTimeFormat(locale, opts);
+/**
+ * Formats a date using a formatting string in the {@link https://strftime.org/ strftime} format, in any given locale.
+ * @param {string} fmt The format string to apply
+ * @param {number | Date} date The date value
+ * @param {?string} locale The locale to use when formatting (default is system locale).
+ * @returns {string} The string representation of date
+ * @see {@link https://strftime.org/ strftime format}
+ */
+export function format(fmt, date, locale) {
+    const results = [];
+    let dayPeriod = '';
+    let dayPeriodIndex = -1;
+    for (let i = 0; i < fmt.length; i++) {
+        let part = fmt[i];
+        if (part === '%') {
+            // check for escaped '%'
+            if (fmt[++i] === '%') {
+                results.push('%');
+                continue;
+            }
+            if (fmt[i] === '-') {
+                part += fmt[i++];
+            }
+            part += fmt[i];
+            // add any repeated characters that come after
+            while (i < fmt.length - 1 && fmt[i + 1] === fmt[i])
+                part += fmt[++i];
+            if (HOUR_PARTS[part]) {
+                const res = formatter(locale, TOKEN_MAP[part]).format(date).split(' ');
+                // save the AM/PM for the correct spot
+                results.push(res[0]);
+                dayPeriod = res[1];
+                continue;
+            }
+            if (part === '%P' || part === '%p') {
+                // leave this flag in place for later
+                dayPeriodIndex = results.length;
+                results.push(part);
+                continue;
+            }
+            if (ERA_PARTS[part] || TZ_PARTS[part]) {
+                // the formatting includes the date/year so we take what comes after
+                const res = formatter(locale, TOKEN_MAP[part]).format(date).split(' ');
+                results.push(res.slice(1).join(' '));
+                continue;
+            }
+            // format any other parts
+            let res = formatter(locale, TOKEN_MAP[part]).format(date);
+            if (part === '%S' && res.length === 1)
+                res = '0' + res;
+            results.push(res);
+        }
+        else {
+            // output as literal
+            results.push(part);
+        }
+    }
+    // insert the AM/PM at the correct spot
+    if (dayPeriodIndex >= 0)
+        results[dayPeriodIndex] = dayPeriod || '';
+    return results.join('');
+}
+const DATETIME_DEFAULT = {};
+/** 10/14/1983 */
+const DATE_SHORT = {
+    year: n,
+    month: n,
+    day: n
+};
+/** Oct 14, 1983 */
+const DATE_MED = {
+    year: n,
+    month: s,
+    day: n
+};
+/** Fri, Oct 14, 1983 */
+const DATE_MED_WITH_WEEKDAY = {
+    year: n,
+    month: s,
+    day: n,
+    weekday: s
+};
+/** October 14, 1983 */
+const DATE_FULL = {
+    year: n,
+    month: l,
+    day: n
+};
+/** Tuesday, October 14, 1983 */
+const DATE_HUGE = {
+    year: n,
+    month: l,
+    day: n,
+    weekday: l
+};
+/** 09:30 AM */
+const TIME_SIMPLE = {
+    hour: n,
+    minute: n
+};
+/** 09:30:23 AM */
+const TIME_WITH_SECONDS = {
+    hour: n,
+    minute: n,
+    second: n
+};
+/** 09:30:23 AM EDT */
+const TIME_WITH_SHORT_OFFSET = {
+    hour: n,
+    minute: n,
+    second: n,
+    timeZoneName: s
+};
+/** 09:30:23 AM Eastern Daylight Time */
+const TIME_WITH_LONG_OFFSET = {
+    hour: n,
+    minute: n,
+    second: n,
+    timeZoneName: l
+};
+/** 09:30 */
+const TIME_24_SIMPLE = {
+    hour: n,
+    minute: n,
+    hourCycle: 'h23'
+};
+/** 09:30:23 */
+const TIME_24_WITH_SECONDS = {
+    hour: n,
+    minute: n,
+    second: n,
+    hourCycle: 'h23'
+};
+/** 09:30:23 EDT */
+const TIME_24_WITH_SHORT_OFFSET = {
+    hour: n,
+    minute: n,
+    second: n,
+    hourCycle: 'h23',
+    timeZoneName: s
+};
+/** 09:30:23 Eastern Daylight Time */
+const TIME_24_WITH_LONG_OFFSET = {
+    hour: n,
+    minute: n,
+    second: n,
+    hourCycle: 'h23',
+    timeZoneName: l
+};
+/** 10/14/1983, 9:30 AM */
+const DATETIME_SHORT = {
+    year: n,
+    month: n,
+    day: n,
+    hour: n,
+    minute: n
+};
+/** 10/14/1983, 9:30:33 AM */
+const DATETIME_SHORT_WITH_SECONDS = {
+    year: n,
+    month: n,
+    day: n,
+    hour: n,
+    minute: n,
+    second: n
+};
+/** Oct 14, 1983, 9:30 AM */
+const DATETIME_MED = {
+    year: n,
+    month: s,
+    day: n,
+    hour: n,
+    minute: n
+};
+/** Oct 14, 1983, 9:30:33 AM */
+const DATETIME_MED_WITH_SECONDS = {
+    year: n,
+    month: s,
+    day: n,
+    hour: n,
+    minute: n,
+    second: n
+};
+/** Fri, 14 Oct 1983, 9:30 AM */
+const DATETIME_MED_WITH_WEEKDAY = {
+    year: n,
+    month: s,
+    day: n,
+    weekday: s,
+    hour: n,
+    minute: n
+};
+/** October 14, 1983, 9:30 AM EDT */
+const DATETIME_FULL = {
+    year: n,
+    month: l,
+    day: n,
+    hour: n,
+    minute: n,
+    timeZoneName: s
+};
+/** October 14, 1983, 9:30:33 AM EDT */
+const DATETIME_FULL_WITH_SECONDS = {
+    year: n,
+    month: l,
+    day: n,
+    hour: n,
+    minute: n,
+    second: n,
+    timeZoneName: s
+};
+/** Friday, October 14, 1983, 9:30 AM Eastern Daylight Time */
+const DATETIME_HUGE = {
+    year: n,
+    month: l,
+    day: n,
+    weekday: l,
+    hour: n,
+    minute: n,
+    timeZoneName: l
+};
+/** Friday, October 14, 1983, 9:30:33 AM Eastern Daylight Time */
+const DATETIME_HUGE_WITH_SECONDS = {
+    year: n,
+    month: l,
+    day: n,
+    weekday: l,
+    hour: n,
+    minute: n,
+    second: n,
+    timeZoneName: l
+};

package/dist/i18n/date/test.html

@@ -0,0 +1,72 @@
+<script type="module">
+  import { IntlDate } from './index.js'
+  window.IntlDate = IntlDate
+
+  let d = IntlDate.now()
+  console.log('toString', d.toString())
+
+  console.log('%A', d.format('%A'))
+  console.log('%a', d.format('%a'))
+
+  console.log('%%d', d.format('%d'))
+  console.log('%-d', d.format('%-d'))
+
+  console.log('%m', d.format('%m'))
+  console.log('%-m', d.format('%-m'))
+  console.log('%B', d.format('%B'))
+  console.log('%b', d.format('%b'))
+  console.log('%bb', d.format('%bb'))
+
+  console.log('%Y', d.format('%Y'))
+  console.log('%y', d.format('%y'))
+
+  console.log('%N', d.format('%N'))
+  console.log('%n', d.format('%n'))
+
+  console.log('%I', d.format('%I'))
+  console.log('%-I', d.format('%-I'))
+  console.log('%H', d.format('%H'))
+  console.log('%-H', d.format('%-H'))
+  console.log('%K', d.format('%K'))
+  console.log('%k', d.format('%k'))
+
+  console.log('%M', d.format('%M'))
+  console.log('%-M', d.format('%-M'))
+
+  console.log('%S', d.format('%S'))
+  console.log('%-S', d.format('%-S'))
+
+  console.log('%P', d.format('%P'))
+  console.log('%p', d.format('%p'))
+  console.log('%pp', d.format('%pp'))
+
+  console.log('%Z', d.format('%Z'))
+  console.log('%-Z', d.format('%-Z'))
+  console.log('%z', d.format('%z'))
+  console.log('%-z', d.format('%-z'))
+  console.log('%ZZ', d.format('%ZZ'))
+  console.log('%-ZZ', d.format('%-ZZ'))
+
+  console.log('Z', d.format('Z'))
+  console.log('ZZ', d.format('ZZ'))
+  console.log('z', d.format('z'))
+  console.log('zzz', d.format('zzz'))
+
+  console.log(d.toObject())
+  console.log(d.zoneName())
+  console.log(d.offset())
+  console.log(d.offsetInMinutes())
+
+  console.log('month starts', d.startOf('month').toDate())
+  console.log('month ends', d.endOf('month').toDate())
+  console.log('1 day', d.add({ days: 1 }).toDate())
+  console.log('60 days', d.add({ days: 60 }).toDate())
+  console.log('2 months', d.add({ months: 2 }).toDate())
+  console.log('4 months', d.add({ months: 4, weeks: 2 }).toDate())
+  console.log('14 days', d.add({ days: 14 }).toDate())
+  console.log('2 week', d.add({ weeks: 2 }).toDate())
+  console.log('1 month', d.add({ months: 1 }).toDate())
+  console.log('1 year', d.add({ years: 1 }).toDate())
+
+  console.log('-30 years', d.subtract({ years: 30 }, true).toDate())
+</script>

package/dist/index.d.ts

@@ -1,4 +1,5 @@
 export * from './collections/index.js';
+export * from './decimal/index.js';
 export * from './functools/index.js';
 export * from './globals/index.js';
 export * from './i18n/index.js';

package/dist/index.js

@@ -1,4 +1,5 @@
 export * from './collections/index.js';
+export * from './decimal/index.js';
 export * from './functools/index.js';
 export * from './globals/index.js';
 export * from './i18n/index.js';

package/dist/itertools/index.d.ts

@@ -1,10 +1,10 @@
 /**
  * This module includes functions that deal with or produce iterators.
  *
- * @module Iterators
+ * @module itertools
  */
-import { Function, Iteratee, Predicate } from '../globals/index.js';
 import { add, Comparer } from '../operators/index.js';
+import { Function, Iteratee, Predicate } from '../types';
 /**
  * Make an iterator that returns accumulated sums, or accumulated results of other binary functions (specified via the optional `func` argument).
  * @param iterable The iterable to accumulate
@@ -72,7 +72,7 @@ contains('abcd', 'bc')
 // true
 ```
  *
- * @see {@link Collections.find}
+ * @see {@link collections.find}
  */
 export declare function contains(collection: Iterable<any>, value: any): any;
 /**

package/dist/itertools/index.js

@@ -1,7 +1,7 @@
 /**
  * This module includes functions that deal with or produce iterators.
  *
- * @module Iterators
+ * @module itertools
  */
 import { call, isEmpty, isObject, notNull, ValueError } from '../globals/index.js';
 import { add, bool, compare, eq, id } from '../operators/index.js';
@@ -99,7 +99,7 @@ contains('abcd', 'bc')
 // true
 ```
  *
- * @see {@link Collections.find}
+ * @see {@link collections.find}
  */
 export function contains(collection, value) {
     if (!collection)

package/dist/math/index.d.ts

@@ -1,9 +1,9 @@
 /**
  * Math and algebraic operations.
  *
- * @module Math
+ * @module math
  */
-import { Predicate } from '../globals/index.js';
+import { Predicate } from '../types.js';
 /**
  * Returns the absolute value of a number. The argument may be a number or an object implementing the `abs()`.
  * @param x The value.

package/dist/math/index.js

@@ -1,7 +1,7 @@
 /**
  * Math and algebraic operations.
  *
- * @module Math
+ * @module math
  */
 import { call } from '../globals/index.js';
 import { reduce } from '../itertools/index.js';

package/dist/operators/index.d.ts

@@ -1,7 +1,7 @@
 /**
  * Generic operations for both values and objects.
  *
- * @module Operators
+ * @module operators
  */
 /** This is the identity function. It always returns the same value that was passed in */
 export declare const id: (x: any) => any;
@@ -35,8 +35,8 @@ export declare type Comparer<T = any> = (x: T, y: T) => number;
  * @param {*} y Other value to compare
  * @returns {number} The comparison result
  * @see {@link https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Array/sort#parameters Array.sort()}
- * @see {@link Operators.eq}
- * @see {@link Operators.lt}
+ * @see {@link operators.eq}
+ * @see {@link operators.lt}
  */
 export declare function compare(x: any, y: any): number;
 /**

package/dist/operators/index.js

@@ -1,7 +1,7 @@
 /**
  * Generic operations for both values and objects.
  *
- * @module Operators
+ * @module operators
  */
 import { call, isObject } from '../globals/index.js';
 /** This is the identity function. It always returns the same value that was passed in */
@@ -36,8 +36,8 @@ export const isinstance = (x, y) => x instanceof y;
  * @param {*} y Other value to compare
  * @returns {number} The comparison result
  * @see {@link https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Array/sort#parameters Array.sort()}
- * @see {@link Operators.eq}
- * @see {@link Operators.lt}
+ * @see {@link operators.eq}
+ * @see {@link operators.lt}
  */
 export function compare(x, y) {
     if (x === y || eq(x, y))

package/dist/random/index.d.ts

@@ -1,7 +1,7 @@
 /**
  * This module implements pseudo-random generators for various distributions.
  *
- * @module Random
+ * @module random
  */
 /**
  * Returns a random float between a [min, max) value (max exclusive).

package/dist/random/index.js

@@ -1,7 +1,7 @@
 /**
  * This module implements pseudo-random generators for various distributions.
  *
- * @module Random
+ * @module random
  */
 import { isObject } from '../globals/index.js';
 /**

package/dist/types.d.ts

@@ -0,0 +1,19 @@
+/**
+ * A generic function type with arbitrary arguments and return.
+ */
+export declare type Function<TReturn = any> = (...args: any) => TReturn;
+/**
+ * An iteratee function used for collection methods.
+ * @see {@link collections.filter}
+ * @see {@link collections.find}
+ * @see {@link collections.forEach}
+ * @see {@link collections.index}
+ * @see {@link collections.map}
+ * @see {@link collections.pick}
+ * @see {@link collections.omit}
+ * @see {@link collections.uniq}
+ * @see {@link collections.sortedUniq}
+ * @see {@link collections.groupBy}
+ */
+export declare type Iteratee<T = any, K = any, TResult = any> = (value: T, key?: K, arr?: any) => TResult;
+export declare type Predicate<T = any, TReturn = any> = (value: T) => TReturn;

package/dist/types.js

@@ -0,0 +1 @@
+export {};

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "atomic-fns",
   "description": "Like Lodash, but for ESNext and with types. Stop shipping code built for browsers from 2015.",
-  "version": "0.4.3",
+  "version": "1.1.2",
   "files": [
     "dist/*"
   ],
@@ -67,5 +67,5 @@
   "bugs": {
     "url": "https://github.com/adrian2x/atomic-fns/issues"
   },
-  "homepage": "https://github.com/adrian2x/atomic-fns#readme"
+  "homepage": "https://atomic-fns.dev"
 }