shelving 1.47.3 → 1.49.1

package/package.json

@@ -11,7 +11,7 @@
 		"state-management",
 		"query-builder"
 	],
-	"version": "1.47.3",
+	"version": "1.49.1",
 	"repository": "https://github.com/dhoulb/shelving",
 	"author": "Dave Houlbrooke <dave@shax.com>",
 	"license": "0BSD",
@@ -63,19 +63,19 @@
 		"@types/jest": "^27.4.0",
 		"@types/react": "^17.0.38",
 		"@types/react-dom": "^17.0.11",
-		"@typescript-eslint/eslint-plugin": "^5.9.0",
-		"@typescript-eslint/parser": "^5.9.0",
-		"eslint": "^8.6.0",
+		"@typescript-eslint/eslint-plugin": "^5.9.1",
+		"@typescript-eslint/parser": "^5.9.1",
+		"eslint": "^8.7.0",
 		"eslint-config-prettier": "^8.3.0",
 		"eslint-plugin-import": "^2.25.4",
 		"eslint-plugin-prettier": "^4.0.0",
-		"firebase": "^9.6.2",
+		"firebase": "^9.6.3",
 		"jest": "^27.4.7",
 		"jest-ts-webcompat-resolver": "^1.0.0",
 		"prettier": "^2.5.1",
 		"react": "^17.0.2",
 		"react-dom": "^17.0.2",
-		"ts-jest": "^27.1.2",
+		"ts-jest": "^27.1.3",
 		"typescript": "^4.5.4"
 	},
 	"peerDependencies": {

package/query/Filters.d.ts

@@ -9,8 +9,8 @@ export declare class Filters<T extends Data> extends Rules<T, Filter<T>> impleme
     filter(props: FilterProps<T>): this;
     filter(key: "id" | "!id" | "id>" | "id>=" | "id<" | "id<=", value: string): this;
     filter(key: "id" | "!id", value: ImmutableArray<string>): this;
-    filter<K extends Key<T>>(key: K | `!${K}` | `${K}>` | `${K}>=` | `${K}<` | `${K}<=`, value: T[K]): this;
-    filter<K extends Key<T>>(key: K | `!${K}`, value: ImmutableArray<string>): this;
+    filter<K extends Key<T>>(key: `${K}` | `!${K}` | `${K}>` | `${K}>=` | `${K}<` | `${K}<=`, value: T[K]): this;
+    filter<K extends Key<T>>(key: `${K}` | `!${K}`, value: ImmutableArray<string>): this;
     filter<K extends Key<T>>(key: `${K}[]`, value: T[K] extends ImmutableArray ? ArrayType<T[K]> : never): this;
     match(entry: Entry<T>): boolean;
     transform(iterable: Entries<T>): Entries<T>;

package/query/Query.d.ts

@@ -14,8 +14,8 @@ export declare class Query<T extends Data> extends Rule<T> implements Queryable<
     filter(props: FilterProps<T>): this;
     filter(key: "id" | "!id" | "id>" | "id>=" | "id<" | "id<=", value: string): this;
     filter(key: "id" | "!id", value: ImmutableArray<string>): this;
-    filter<K extends Key<T>>(key: K | `!${K}` | `${K}>` | `${K}>=` | `${K}<` | `${K}<=`, value: T[K]): this;
-    filter<K extends Key<T>>(key: K | `!${K}`, value: ImmutableArray<T[K]>): this;
+    filter<K extends Key<T>>(key: `${K}` | `!${K}` | `${K}>` | `${K}>=` | `${K}<` | `${K}<=`, value: T[K]): this;
+    filter<K extends Key<T>>(key: `${K}` | `!${K}`, value: ImmutableArray<T[K]>): this;
     filter<K extends Key<T>>(key: `${K}[]`, value: T[K] extends ImmutableArray ? ArrayType<T[K]> : never): this;
     get unfilter(): this;
     match(entry: Entry<T>): boolean;

package/query/types.d.ts

@@ -2,7 +2,7 @@ import type { Data, Key, Matchable, Entry, Rankable, ImmutableArray, ArrayType }
 /** Possible operator references. */
 export declare type FilterOperator = "IS" | "NOT" | "IN" | "OUT" | "CONTAINS" | "LT" | "LTE" | "GT" | "GTE";
 /** Format that allows filters to be specified as a string, e.g. `!name` means `name is not` and `age>` means `age is more than` and `tags[]` means `tags array contains` */
-export declare type FilterKey<T extends Data> = "id" | "!id" | "id>" | "id>=" | "id<" | "id<=" | Key<T> | `!${Key<T>}` | `${Key<T>}[]` | `${Key<T>}<` | `${Key<T>}<=` | `${Key<T>}>` | `${Key<T>}>=`;
+export declare type FilterKey<T extends Data> = "id" | "!id" | "id>" | "id>=" | "id<" | "id<=" | Key<T> | `${Key<T>}` | `!${Key<T>}` | `${Key<T>}[]` | `${Key<T>}<` | `${Key<T>}<=` | `${Key<T>}>` | `${Key<T>}>=`;
 /** Format that allows multiple filters to be specified as a plain object. */
 export declare type FilterProps<T extends Data> = {
     "id"?: string | ImmutableArray<string>;
@@ -12,7 +12,7 @@ export declare type FilterProps<T extends Data> = {
     "id<"?: string;
     "id<="?: string;
 } & {
-    [K in Key<T> as K | `!${K}`]?: T[K] | ImmutableArray<T[K]>;
+    [K in Key<T> as `${K}` | `!${K}`]?: T[K] | ImmutableArray<T[K]>;
 } & {
     [K in Key<T> as `${K}[]`]?: T[K] extends ImmutableArray ? ArrayType<T[K]> : never;
 } & {
@@ -27,14 +27,14 @@ export interface Filterable<T extends Data> extends Matchable<Entry<T>, void> {
     filter(props: FilterProps<T>): this;
     filter(key: "id" | "!id" | "id>" | "id>=" | "id<" | "id<=", value: string): this;
     filter(key: "id" | "!id", value: ImmutableArray<string>): this;
-    filter<K extends Key<T>>(key: K | `!${K}` | `${K}>` | `${K}>=` | `${K}<` | `${K}<=`, value: T[K]): this;
-    filter<K extends Key<T>>(key: K | `!${K}`, value: ImmutableArray<string>): this;
+    filter<K extends Key<T>>(key: `${K}` | `!${K}` | `${K}>` | `${K}>=` | `${K}<` | `${K}<=`, value: T[K]): this;
+    filter<K extends Key<T>>(key: `${K}` | `!${K}`, value: ImmutableArray<string>): this;
     filter<K extends Key<T>>(key: `${K}[]`, value: T[K] extends ImmutableArray ? ArrayType<T[K]> : never): this;
     /** Match an entry against the filters specified for this object. */
     match(entry: Entry<T>): boolean;
 }
 /** Format that allows sorts to be set as a plain string, e.g. `name` sorts by name in ascending order and `!date` sorts by date in descending order. */
-export declare type SortKey<T extends Data> = "id" | "!id" | Key<T> | `!${Key<T>}`;
+export declare type SortKey<T extends Data> = "id" | "!id" | Key<T> | `${Key<T>}` | `!${Key<T>}`;
 /** One or more sort keys. */
 export declare type SortKeys<T extends Data> = SortKey<T> | ImmutableArray<SortKey<T>>;
 /** Possible operator references. */

package/util/date.d.ts

@@ -1,17 +1,3 @@
-/** One second in millseconds. */
-export declare const SECOND = 1000;
-/** One minute in millseconds. */
-export declare const MINUTE: number;
-/** One hour in millseconds. */
-export declare const HOUR: number;
-/** One day in millseconds. */
-export declare const DAY: number;
-/** One week in millseconds. */
-export declare const WEEK: number;
-/** One month in millseconds. */
-export declare const MONTH: number;
-/** One year in millseconds. */
-export declare const YEAR: number;
 /** Is a value a date? */
 export declare const isDate: (v: unknown) => v is Date;
 /** Value that can possibly be converted to a `Date` instance. */
@@ -77,9 +63,9 @@ export declare const getWeeksUntil: (target: PossibleDate, current?: PossibleDat
 /** Count the number of weeks ago a date was. */
 export declare const getWeeksAgo: (target: PossibleDate, current?: PossibleDate | undefined) => number;
 /** Format a full description of a duration of time using the most reasonable units e.g. `5 years` or `1 week` or `4 minutes` or `12 milliseconds`. */
-export declare function formatFullDuration(ms: number): string;
+export declare const formatFullDuration: (ms: number, maxPrecision?: number | undefined, minPrecision?: number | undefined) => string;
 /** Format a description of a duration of time using the most reasonable units e.g. `5y` or `4m` or `12ms`. */
-export declare function formatDuration(ms: number): string;
+export declare const formatDuration: (ms: number, maxPrecision?: number | undefined, minPrecision?: number | undefined) => string;
 /**
  * Return full description of the gap between two dates, e.g. `in 10 days` or `2 hours ago`
  *
@@ -87,13 +73,6 @@ export declare function formatDuration(ms: number): string;
  * @param current Today's date (or a different date to measure from).
  */
 export declare function formatFullWhen(target: PossibleDate, current?: PossibleDate): string;
-/**
- * Return full description of when a date happened, e.g. `10 days` or `2 hours` or `-1 week`
- *
- * @param target The date when the thing will happen.
- * @param current Today's date (or a different date to measure from).
- */
-export declare const formatFullUntil: (target: PossibleDate, current?: PossibleDate | undefined) => string;
 /**
  * Return full description of when a date will happen, e.g. `10 days` or `2 hours` or `-1 week`
  *
@@ -128,3 +107,5 @@ export declare const formatDate: (date: PossibleDate) => string;
 export declare const isPast: (target: PossibleDate, current?: PossibleDate | undefined) => boolean;
 /** Is a date in the future? */
 export declare const isFuture: (target: PossibleDate, current?: PossibleDate | undefined) => boolean;
+/** Is a date today (taking into account midnight). */
+export declare const isToday: (target: PossibleDate, current?: PossibleDate | undefined) => boolean;

package/util/date.js

@@ -1,19 +1,5 @@
 import { AssertionError } from "../error/index.js";
-import { formatFullQuantity, formatQuantity } from "./number.js";
-/** One second in millseconds. */
-export const SECOND = 1000;
-/** One minute in millseconds. */
-export const MINUTE = 60 * SECOND;
-/** One hour in millseconds. */
-export const HOUR = 60 * MINUTE;
-/** One day in millseconds. */
-export const DAY = 24 * HOUR;
-/** One week in millseconds. */
-export const WEEK = 7 * DAY;
-/** One month in millseconds. */
-export const MONTH = 30 * DAY;
-/** One year in millseconds. */
-export const YEAR = 365 * DAY;
+import { DAY, HOUR, MINUTE, MONTH, SECOND, WEEK, YEAR, formatUnits, formatFullUnits } from "./units.js";
 /** Is a value a date? */
 export const isDate = (v) => v instanceof Date;
 /**
@@ -124,40 +110,26 @@ export const getDaysAgo = (target, current) => 0 - getDaysUntil(target, current)
 export const getWeeksUntil = (target, current) => Math.floor(getDaysUntil(target, current) / 7);
 /** Count the number of weeks ago a date was. */
 export const getWeeksAgo = (target, current) => 0 - getWeeksUntil(target, current);
-/** Format a full description of a duration of time using the most reasonable units e.g. `5 years` or `1 week` or `4 minutes` or `12 milliseconds`. */
-export function formatFullDuration(ms) {
+function _formatDuration(formatter, ms, maxPrecision = 0, minPrecision) {
     const abs = Math.abs(ms);
     if (abs <= 99 * SECOND)
-        return formatFullQuantity(ms, "second", "seconds", 0); // Up to 99 seconds, e.g. '22 seconds ago'
+        return formatter(ms, "second", maxPrecision, minPrecision); // Up to 99 seconds, e.g. '22 seconds ago'
     if (abs <= HOUR)
-        return formatFullQuantity(ms / MINUTE, "minute", "minutes", 0); // Up to one hour  — show minutes, e.g. '18 minutes ago'
+        return formatter(ms / MINUTE, "minute", maxPrecision, minPrecision); // Up to one hour  — show minutes, e.g. '18 minutes ago'
     if (abs <= DAY)
-        return formatFullQuantity(ms / HOUR, "hour", "hours", 0); // Up to one day — show hours, e.g. '23 hours ago'
+        return formatter(ms / HOUR, "hour", maxPrecision, minPrecision); // Up to one day — show hours, e.g. '23 hours ago'
     if (abs <= 2 * WEEK)
-        return formatFullQuantity(ms / DAY, "day", "days", 0); // Up to 2 weeks — show days, e.g. '13 days ago'
+        return formatter(ms / DAY, "day", maxPrecision, minPrecision); // Up to 2 weeks — show days, e.g. '13 days ago'
     if (abs <= 10 * WEEK)
-        return formatFullQuantity(ms / WEEK, "week", "weeks", 0); // Up to 2 months — show weeks, e.g. '6 weeks ago'
+        return formatter(ms / WEEK, "week", maxPrecision, minPrecision); // Up to 2 months — show weeks, e.g. '6 weeks ago'
     if (abs <= 18 * MONTH)
-        return formatFullQuantity(ms / MONTH, "month", "months", 0); // Up to 18 months — show months, e.g. '6 months ago'
-    return formatFullQuantity(ms / YEAR, "year", "years", 0); // Above 18 months — show years, e.g. '2 years ago'
+        return formatter(ms / MONTH, "month", maxPrecision, minPrecision); // Up to 18 months — show months, e.g. '6 months ago'
+    return formatter(ms / YEAR, "year", maxPrecision, minPrecision); // Above 18 months — show years, e.g. '2 years ago'
 }
+/** Format a full description of a duration of time using the most reasonable units e.g. `5 years` or `1 week` or `4 minutes` or `12 milliseconds`. */
+export const formatFullDuration = (ms, maxPrecision, minPrecision) => _formatDuration(formatFullUnits, ms, maxPrecision, minPrecision);
 /** Format a description of a duration of time using the most reasonable units e.g. `5y` or `4m` or `12ms`. */
-export function formatDuration(ms) {
-    const abs = Math.abs(ms);
-    if (abs <= 99 * SECOND)
-        return formatQuantity(ms, "s", 0); // Up to 99 seconds, e.g. '22 seconds ago'
-    if (abs <= HOUR)
-        return formatQuantity(ms / MINUTE, "m", 0); // Up to one hour  — show minutes, e.g. '18 minutes ago'
-    if (abs <= DAY)
-        return formatQuantity(ms / HOUR, "h", 0); // Up to one day — show hours, e.g. '23 hours ago'
-    if (abs <= 2 * WEEK)
-        return formatQuantity(ms / DAY, "d", 0); // Up to 2 weeks — show days, e.g. '13 days ago'
-    if (abs <= 10 * WEEK)
-        return formatQuantity(ms / WEEK, "w", 0); // Up to 2 months — show weeks, e.g. '6 weeks ago'
-    if (abs <= 18 * MONTH)
-        return formatQuantity(ms / MONTH, "m", 0); // Up to 18 months — show months, e.g. '6 months ago'
-    return formatQuantity(ms / YEAR, "y", 0); // Above 18 months — show years, e.g. '2 years ago'
-}
+export const formatDuration = (ms, maxPrecision, minPrecision) => _formatDuration(formatUnits, ms, maxPrecision, minPrecision);
 /**
  * Return full description of the gap between two dates, e.g. `in 10 days` or `2 hours ago`
  *
@@ -170,13 +142,6 @@ export function formatFullWhen(target, current) {
     const duration = formatFullDuration(abs);
     return abs < 10 * SECOND ? "just now" : ms > 0 ? `in ${duration}` : `${duration} ago`;
 }
-/**
- * Return full description of when a date happened, e.g. `10 days` or `2 hours` or `-1 week`
- *
- * @param target The date when the thing will happen.
- * @param current Today's date (or a different date to measure from).
- */
-export const formatFullUntil = (target, current) => formatFullDuration(getDuration(target, current));
 /**
  * Return full description of when a date will happen, e.g. `10 days` or `2 hours` or `-1 week`
  *
@@ -217,3 +182,5 @@ const _formatter = new Intl.DateTimeFormat(undefined, {});
 export const isPast = (target, current) => getDate(target) < getDate(current);
 /** Is a date in the future? */
 export const isFuture = (target, current) => getDate(target) > getDate(current);
+/** Is a date today (taking into account midnight). */
+export const isToday = (target, current) => getMidnight(target) === getMidnight(current);

package/util/function.d.ts

@@ -10,9 +10,11 @@ export declare const PASSTHROUGH: <T>(value: T) => T;
 export declare const BLACKHOLE: (...args: Arguments) => void | undefined;
 /** Function that receives a dispatched value. */
 export declare type Dispatcher<T extends Arguments = []> = (...value: T) => void;
+/** Function that receives a dispatched value. */
+export declare type AsyncDispatcher<T extends Arguments = []> = (...value: T) => void | PromiseLike<void>;
 /** Safely dispatch a value to a dispatcher function. */
-export declare function dispatch<T extends Arguments>(dispatcher: Dispatcher<T>, ...value: T): void;
+export declare function dispatch<T extends Arguments>(dispatcher: Dispatcher<T> | AsyncDispatcher<T>, ...value: T): void;
 /** Safely dispatch a value to a dispatcher method on an object. */
 export declare function dispatchMethod<T extends Arguments, M extends string | symbol>(obj: {
-    [K in M]: Dispatcher<T>;
+    [K in M]: Dispatcher<T> | AsyncDispatcher<T>;
 }, key: M, ...value: T): void;

package/util/function.js

@@ -1,3 +1,4 @@
+import { isAsync } from "./async.js";
 import { logError } from "./error.js";
 /** Is a value a function? */
 export const isFunction = (v) => typeof v === "function";
@@ -8,7 +9,9 @@ export const BLACKHOLE = () => undefined;
 /** Safely dispatch a value to a dispatcher function. */
 export function dispatch(dispatcher, ...value) {
     try {
-        dispatcher(...value);
+        const result = dispatcher(...value);
+        if (isAsync(result))
+            result.then(BLACKHOLE, logError);
     }
     catch (thrown) {
         logError(thrown);
@@ -17,7 +20,9 @@ export function dispatch(dispatcher, ...value) {
 /** Safely dispatch a value to a dispatcher method on an object. */
 export function dispatchMethod(obj, key, ...value) {
     try {
-        obj[key](...value);
+        const result = obj[key](...value);
+        if (isAsync(result))
+            result.then(BLACKHOLE, logError);
     }
     catch (thrown) {
         logError(thrown);

package/util/number.d.ts

@@ -59,9 +59,9 @@ export declare const truncateNumber: (num: number, precision?: number) => number
  * @returns The number formatted as a string in the browser's current locale.
  */
 export declare const formatNumber: (num: number, maxPrecision?: number, minPrecision?: number) => string;
-/** Format a number with a short suffix (number and suffix are separated by a non-breaking narrow space). */
+/** Format a number with a short suffix. */
 export declare const formatQuantity: (num: number, suffix: string, maxPrecision?: number | undefined, minPrecision?: number | undefined) => string;
-/** Format a number with a longer full-word suffix (number and suffix are separated by a non-breaking space). */
+/** Format a number with a longer full-word suffix. */
 export declare function formatFullQuantity(num: number, singular: string, plural: string, maxPrecision?: number, minPrecision?: number): string;
 /**
  * Cram a large whole numbers into a space efficient format, e.g. `14.7M`
@@ -103,6 +103,13 @@ export declare const isBetween: (num: number, start: number, end: number) => boo
  * @param end The end of the range, e.g. `20`
  */
 export declare const getBetween: (num: number, start: number, end: number) => number;
+/**
+ * Get a number as a percentage of another number.
+ *
+ * @param numerator Number representing the amount of progress.
+ * @param denumerator The number representing the whole amount.
+ */
+export declare const getPercent: (numerator: number, denumerator: number) => number;
 /** Sum an iterable set of numbers and return the total. */
 export declare function sumNumbers(nums: Iterable<number>): number;
 /** Find the number that's closest to a target in an iterable set of numbers. */

package/util/number.js

@@ -1,5 +1,4 @@
 import { AssertionError } from "../error/index.js";
-import { NBSP, NNBSP } from "./string.js";
 // Constants.
 export const TRILLION = 1000000000000;
 export const BILLION = 1000000000;
@@ -76,12 +75,12 @@ export const truncateNumber = (num, precision = 0) => Math.trunc(num * 10 ** pre
  * @returns The number formatted as a string in the browser's current locale.
  */
 export const formatNumber = (num, maxPrecision = 4, minPrecision = 0) => new Intl.NumberFormat(undefined, { maximumFractionDigits: maxPrecision, minimumFractionDigits: minPrecision }).format(num);
-/** Format a number with a short suffix (number and suffix are separated by a non-breaking narrow space). */
-export const formatQuantity = (num, suffix, maxPrecision, minPrecision) => `${formatNumber(num, maxPrecision, minPrecision)}${NNBSP}${suffix}`;
-/** Format a number with a longer full-word suffix (number and suffix are separated by a non-breaking space). */
+/** Format a number with a short suffix. */
+export const formatQuantity = (num, suffix, maxPrecision, minPrecision) => `${formatNumber(num, maxPrecision, minPrecision)}${suffix}`;
+/** Format a number with a longer full-word suffix. */
 export function formatFullQuantity(num, singular, plural, maxPrecision, minPrecision) {
     const qty = formatNumber(num, maxPrecision, minPrecision);
-    return `${qty}${NBSP}${qty === "1" ? singular : plural}`;
+    return `${qty} ${qty === "1" ? singular : plural}`;
 }
 /**
  * Cram a large whole numbers into a space efficient format, e.g. `14.7M`
@@ -138,6 +137,13 @@ export const isBetween = (num, start, end) => num >= start && num <= end;
  * @param end The end of the range, e.g. `20`
  */
 export const getBetween = (num, start, end) => Math.max(start, Math.min(end, num));
+/**
+ * Get a number as a percentage of another number.
+ *
+ * @param numerator Number representing the amount of progress.
+ * @param denumerator The number representing the whole amount.
+ */
+export const getPercent = (numerator, denumerator) => Math.max(0, Math.min(100, (100 / denumerator) * numerator));
 /** Sum an iterable set of numbers and return the total. */
 export function sumNumbers(nums) {
     let sum = 0;

package/util/units.d.ts

@@ -1,9 +1,25 @@
+/** One second in millseconds. */
+export declare const SECOND = 1000;
+/** One minute in millseconds. */
+export declare const MINUTE: number;
+/** One hour in millseconds. */
+export declare const HOUR: number;
+/** One day in millseconds. */
+export declare const DAY: number;
+/** One week in millseconds. */
+export declare const WEEK: number;
+/** One month in millseconds. */
+export declare const MONTH: number;
+/** One year in millseconds. */
+export declare const YEAR: number;
 /** Valid information about a unit of measure. */
 export declare type UnitData = {
-    /** Plural name for a unit, e.g. `feet` */
-    readonly plural?: string;
     /** Type of a unit. */
     readonly type: UnitType;
+    /** Singular name for a unit, e.g. `foot` (only needed if different from reference). */
+    readonly singular?: string;
+    /** Plural name for a unit, e.g. `feet` */
+    readonly plural?: string;
     /** Short suffix for this unit, e.g. `km` */
     readonly suffix: string;
     /** All units must specify their 'base' unit, e.g. `meter` for for distance units and `liter` for volume units. */
@@ -14,7 +30,7 @@ export declare type UnitData = {
 /** Valid system of measurement reference. */
 export declare type UnitType = "percentage" | "angle" | "temperature" | "length" | "speed" | "pace" | "mass" | "time" | "volume";
 /** Valid unit of measurement reference (correspond to units allowed in `Intl.NumberFormat`, but not all). */
-export declare type UnitReference = "percent" | "degree" | "millimeter" | "centimeter" | "meter" | "kilometer" | "mile" | "yard" | "foot" | "inch" | "liter" | "milliliter" | "gallon" | "fluid-ounce" | "milligram" | "gram" | "kilogram" | "pound" | "stone" | "ounce" | "millisecond" | "second" | "minute" | "day" | "hour" | "week" | "month" | "year";
+export declare type UnitReference = "percent" | "permille" | "permyriad" | "ppm" | "percentage-point" | "basis-point" | "degree" | "millimeter" | "centimeter" | "meter" | "kilometer" | "mile" | "yard" | "foot" | "inch" | "liter" | "milliliter" | "gallon" | "fluid-ounce" | "milligram" | "gram" | "kilogram" | "pound" | "stone" | "ounce" | "millisecond" | "second" | "minute" | "day" | "hour" | "week" | "month" | "year";
 /** List of units. */
 export declare const UNITS: {
     [K in UnitReference]: UnitData;

package/util/units.js

@@ -1,37 +1,55 @@
 import { AssertionError } from "../error/index.js";
-import { DAY, HOUR, MINUTE, MONTH, SECOND, WEEK, YEAR } from "./date.js";
-import { formatFullQuantity, formatQuantity } from "./number.js";
+import { formatFullQuantity, formatQuantity, MILLION } from "./number.js";
 import { NNBSP } from "./string.js";
+/** One second in millseconds. */
+export const SECOND = 1000;
+/** One minute in millseconds. */
+export const MINUTE = 60 * SECOND;
+/** One hour in millseconds. */
+export const HOUR = 60 * MINUTE;
+/** One day in millseconds. */
+export const DAY = 24 * HOUR;
+/** One week in millseconds. */
+export const WEEK = 7 * DAY;
+/** One month in millseconds. */
+export const MONTH = 30 * DAY;
+/** One year in millseconds. */
+export const YEAR = 365 * DAY;
 /** List of units. */
 export const UNITS = {
     "percent": { type: "percentage", base: 1, suffix: "%" },
-    "degree": { type: "angle", base: 1, suffix: "deg" },
-    "millimeter": { type: "length", base: 1, suffix: "mm" },
-    "centimeter": { type: "length", base: 10, suffix: "cm" },
-    "meter": { type: "length", base: 1000, centimeter: 100, millimeter: 1000, suffix: "m" },
-    "kilometer": { type: "length", base: 1000000, centimeter: 100000, millimeter: 1000000, suffix: "km" },
-    "inch": { type: "length", base: 25.4, suffix: "in" },
-    "foot": { type: "length", base: 304.8, inch: 12, suffix: "ft", plural: "feet" },
-    "yard": { type: "length", base: 914.4, inch: 36, foot: 3, suffix: "yd" },
-    "mile": { type: "length", base: 1609344, yard: 1760, foot: 5280, inch: 63360, suffix: "mi" },
-    "milliliter": { type: "volume", base: 1, suffix: "ml" },
-    "liter": { type: "volume", base: 1000, suffix: "l" },
-    "fluid-ounce": { type: "volume", base: 29.5735295625, gallon: 128, suffix: `fl${NNBSP}oz` },
-    "gallon": { type: "volume", base: 3785.411784, suffix: "gal" },
-    "milligram": { type: "mass", base: 1, suffix: "mg" },
-    "gram": { type: "mass", base: 1000, suffix: "g" },
-    "kilogram": { type: "mass", base: 1000000, suffix: "kg" },
-    "ounce": { type: "mass", base: 28349.523125, pound: 0.0625, suffix: "oz" },
-    "pound": { type: "mass", base: 453592.37, ounce: 16, suffix: "lb" },
-    "stone": { type: "mass", base: 6350293.18, pound: 14, ounce: 224, suffix: "st", plural: "stone" },
-    "millisecond": { type: "time", base: 1, suffix: "ms" },
-    "second": { type: "time", base: SECOND, suffix: "s" },
-    "minute": { type: "time", base: MINUTE, suffix: "m" },
-    "hour": { type: "time", base: HOUR, suffix: "h" },
-    "day": { type: "time", base: DAY, suffix: "d" },
-    "week": { type: "time", base: WEEK, suffix: "w" },
-    "month": { type: "time", base: MONTH, suffix: "m" },
-    "year": { type: "time", base: YEAR, suffix: "y" },
+    "permille": { type: "percentage", base: 10, suffix: `${NNBSP}‰` },
+    "permyriad": { type: "percentage", base: 100, suffix: `${NNBSP}‱` },
+    "ppm": { type: "percentage", base: MILLION, suffix: `${NNBSP}ppm`, singular: "part per million", plural: "parts per million" },
+    "percentage-point": { type: "percentage", base: 1, suffix: `${NNBSP}pp`, singular: "percentage point", plural: "percentage points" },
+    "basis-point": { type: "percentage", base: 10000, suffix: `${NNBSP}bp`, singular: "basis point", plural: "basis points" },
+    "degree": { type: "angle", base: 1, suffix: `${NNBSP}deg` },
+    "millimeter": { type: "length", base: 1, suffix: `${NNBSP}mm` },
+    "centimeter": { type: "length", base: 10, suffix: `${NNBSP}cm` },
+    "meter": { type: "length", base: 1000, centimeter: 100, millimeter: 1000, suffix: `${NNBSP}m` },
+    "kilometer": { type: "length", base: 1000000, centimeter: 100000, millimeter: 1000000, suffix: `${NNBSP}km` },
+    "inch": { type: "length", base: 25.4, suffix: `${NNBSP}in` },
+    "foot": { type: "length", base: 304.8, inch: 12, suffix: `${NNBSP}ft`, plural: "feet" },
+    "yard": { type: "length", base: 914.4, inch: 36, foot: 3, suffix: `${NNBSP}yd` },
+    "mile": { type: "length", base: 1609344, yard: 1760, foot: 5280, inch: 63360, suffix: `${NNBSP}mi` },
+    "milliliter": { type: "volume", base: 1, suffix: `${NNBSP}ml` },
+    "liter": { type: "volume", base: 1000, suffix: `${NNBSP}l` },
+    "fluid-ounce": { type: "volume", base: 29.5735295625, gallon: 128, suffix: `${NNBSP}fl${NNBSP}oz`, singular: "fluid ounce", plural: "fluid ounces" },
+    "gallon": { type: "volume", base: 3785.411784, suffix: `${NNBSP}gal` },
+    "milligram": { type: "mass", base: 1, suffix: `${NNBSP}mg` },
+    "gram": { type: "mass", base: 1000, suffix: `${NNBSP}g` },
+    "kilogram": { type: "mass", base: 1000000, suffix: `${NNBSP}kg` },
+    "ounce": { type: "mass", base: 28349.523125, pound: 0.0625, suffix: `${NNBSP}oz` },
+    "pound": { type: "mass", base: 453592.37, ounce: 16, suffix: `${NNBSP}lb` },
+    "stone": { type: "mass", base: 6350293.18, pound: 14, ounce: 224, suffix: `${NNBSP}st`, plural: "stone" },
+    "millisecond": { type: "time", base: 1, suffix: `${NNBSP}ms` },
+    "second": { type: "time", base: SECOND, suffix: `${NNBSP}s` },
+    "minute": { type: "time", base: MINUTE, suffix: `${NNBSP}m` },
+    "hour": { type: "time", base: HOUR, suffix: `${NNBSP}h` },
+    "day": { type: "time", base: DAY, suffix: `${NNBSP}d` },
+    "week": { type: "time", base: WEEK, suffix: `${NNBSP}w` },
+    "month": { type: "time", base: MONTH, suffix: `${NNBSP}m` },
+    "year": { type: "time", base: YEAR, suffix: `${NNBSP}y` },
 };
 /** Convert between two units of the same type. */
 export function convertUnits(num, from, to) {
@@ -61,4 +79,4 @@ export const formatUnits = (num, unit, maxPrecision, minPrecision) => formatQuan
  * @param unit String reference for a unit of measure e.g. `kilometer`
  * @param maxPrecision Number of decimal places to round the number to e.g. `2`
  */
-export const formatFullUnits = (num, unit, maxPrecision, minPrecision) => formatFullQuantity(num, unit, UNITS[unit].plural || `${unit}s`, maxPrecision, minPrecision);
+export const formatFullUnits = (num, unit, maxPrecision, minPrecision) => formatFullQuantity(num, UNITS[unit].singular || unit, UNITS[unit].plural || `${unit}s`, maxPrecision, minPrecision);