@ix-xs/node-comfort 1.2.0 → 2.1.0

package/types/src/internal/shared.d.ts

@@ -0,0 +1,123 @@
+/**
+ * Parsed cron fields. `lastDay` is set by `L` in the day-of-month field.
+ */
+export type CronSpec = {
+    seconds: Set<number>;
+    minutes: Set<number>;
+    hours: Set<number>;
+    days: Set<number>;
+    months: Set<number>;
+    weekdays: Set<number>;
+    anyDay: boolean;
+    anyWeekday: boolean;
+    lastDay: boolean;
+};
+/** Keys that must never be copied onto an object: they reach its prototype. */
+export const UNSAFE_KEYS: Set<string>;
+export namespace MS {
+    let ms: number;
+    let s: number;
+    let m: number;
+    let h: number;
+    let d: number;
+    let w: number;
+}
+/**
+ * The defaults set with `time.setLocale()` and `time.setTimezone()`. English
+ * by default, so output never depends on the machine.
+ * @type {{ locale: string, timeZone: string | undefined }}
+ */
+export const timeConfig: {
+    locale: string;
+    timeZone: string | undefined;
+};
+export const ASCII: RegExp;
+/**
+ * @param {unknown} value
+ * @returns {value is Record<string, any>}
+ */
+export function isPlainObject(value: unknown): value is Record<string, any>;
+/**
+ * @param {string} unit
+ * @returns {keyof typeof MS | "M" | "y" | undefined}
+ */
+export function unitOf(unit: string): keyof typeof MS | "M" | "y" | undefined;
+/**
+ * A duration in milliseconds, or `null` when the input isn't one.
+ * @param {unknown} input
+ * @returns {number | null}
+ */
+export function parseDuration(input: unknown): number | null;
+/**
+ * Milliseconds from a number or a duration string.
+ * @param {number | string} value
+ * @param {string} [what="duration"] Names the value in the error message.
+ * @returns {number}
+ * @throws {TypeError} If it can't be read.
+ */
+export function toMs(value: number | string, what?: string): number;
+/**
+ * `setTimeout` that also works past its 24.8-day limit. `Infinity` never fires.
+ * @param {() => void} fn
+ * @param {number} ms
+ * @param {boolean} [unref=false]
+ * @returns {() => void} Cancels the timer.
+ */
+export function setLongTimeout(fn: () => void, ms: number, unref?: boolean): () => void;
+/**
+ * Resolves after `ms`, or rejects with an `AbortError` when the signal fires.
+ * @param {number} ms
+ * @param {AbortSignal} [signal]
+ * @param {boolean} [unref=false]
+ * @returns {Promise<void>}
+ */
+export function sleep(ms: number, signal?: AbortSignal, unref?: boolean): Promise<void>;
+/**
+ * Blocks the thread for a few milliseconds. Only for short retries of
+ * synchronous file operations.
+ * @param {number} ms
+ */
+export function sleepSync(ms: number): void;
+export namespace intl {
+    let number: (locale?: string, options?: object) => Intl.NumberFormat;
+    let dateTime: (locale?: string, options?: object) => Intl.DateTimeFormat;
+    let plural: (locale?: string, options?: object) => Intl.PluralRules;
+    let collator: (locale?: string, options?: object) => Intl.Collator;
+    let relativeTime: (locale?: string, options?: object) => Intl.RelativeTimeFormat;
+    let list: (locale?: string, options?: object) => Intl.ListFormat;
+}
+/** The grapheme segmenter, built on first use. */
+export function segmenter(): Intl.Segmenter;
+/**
+ * Splits text into graphemes, so emoji and accents stay whole.
+ * @param {string} input
+ * @returns {string[]}
+ */
+export function graphemes(input: string): string[];
+/**
+ * Counts graphemes without building an array.
+ * @param {string} input
+ * @returns {number}
+ */
+export function graphemeCount(input: string): number;
+/**
+ * Adds numbers with Neumaier's compensation, so `0.1 + 0.2 + 0.3` is `0.6`.
+ * @param {Iterable<number>} values
+ * @returns {number}
+ */
+export function preciseSum(values: Iterable<number>): number;
+/**
+ * A cache key for a list of arguments. Primitives are compared by value and
+ * type, plain objects and arrays by content, everything else by identity.
+ * @param {readonly unknown[]} args
+ * @returns {unknown} A primitive usable as a `Map` key.
+ */
+export function argsKey(args: readonly unknown[]): unknown;
+/**
+ * Parses a cron expression with 5 fields, or 6 with seconds first.
+ * @param {string} expression
+ * @returns {CronSpec}
+ * @throws {SyntaxError} If the expression is invalid.
+ */
+export function parseCron(expression: string): CronSpec;
+//# sourceMappingURL=shared.d.ts.map

package/types/src/internal/shared.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"shared.d.ts","sourceRoot":"","sources":["../../../src/internal/shared.js"],"names":[],"mappings":";;;uBAmTa;IAAE,OAAO,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;IAAC,OAAO,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;IAAC,KAAK,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;IAAC,IAAI,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;IAAC,MAAM,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;IAAC,QAAQ,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;IAAC,MAAM,EAAE,OAAO,CAAC;IAAC,UAAU,EAAE,OAAO,CAAC;IAAC,OAAO,EAAE,OAAO,CAAA;CAAE;AA7StM,+EAA+E;AAC/E,sCAAuE;;;;;;;;;AAevE;;;;GAIG;AACH,yBAFU;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,GAAG,SAAS,CAAA;CAAE,CAED;AA8KzD,2BAA+B;AAhM/B;;;GAGG;AACH,qCAHW,OAAO,GACL,KAAK,IAAI,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAOxC;AAuBD;;;GAGG;AACH,6BAHW,MAAM,GACJ,MAAM,OAAO,EAAE,GAAG,GAAG,GAAG,GAAG,GAAG,SAAS,CAE2B;AAyC/E;;;;GAIG;AACH,qCAHW,OAAO,GACL,MAAM,GAAG,IAAI,CAazB;AAED;;;;;;GAMG;AACH,4BALW,MAAM,GAAG,MAAM,SACf,MAAM,GACJ,MAAM,CAWlB;AAID;;;;;;GAMG;AACH,mCALW,MAAM,IAAI,MACV,MAAM,UACN,OAAO,GACL,MAAM,IAAI,CAYtB;AAED;;;;;;GAMG;AACH,0BALW,MAAM,WACN,WAAW,UACX,OAAO,GACL,OAAO,CAAC,IAAI,CAAC,CAetB;AAgOJ;;;;GAIG;AACH,8BAFW,MAAM,QAIhB;;0BAhOsB,MAAM,YAAY,MAAM;4BAAxB,MAAM,YAAY,MAAM;0BAAxB,MAAM,YAAY,MAAM;4BAAxB,MAAM,YAAY,MAAM;gCAAxB,MAAM,YAAY,MAAM;wBAAxB,MAAM,YAAY,MAAM;;AA6B/C,kDAAkD;AAClD,4CAAmG;AAInG;;;;GAIG;AACH,iCAHW,MAAM,GACJ,MAAM,EAAE,CAKpB;AAED;;;;GAIG;AACH,qCAHW,MAAM,GACJ,MAAM,CAOlB;AAED;;;;GAIG;AACH,mCAHW,QAAQ,CAAC,MAAM,CAAC,GACd,MAAM,CAYlB;AA+CD;;;;;GAKG;AACH,8BAHW,SAAS,OAAO,EAAE,GAChB,OAAO,CAYnB;AAkBD;;;;;GAKG;AACH,sCAJW,MAAM,GACJ,QAAQ,CA4DpB"}

package/types/index.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../index.js"],"names":[],"mappings":";;;;;;;;;;;;;qBAuCuvF,CAAC;iBAAe,CAAC;;;oBAAy6B,CAAC;iBAAe,CAAC;;;;;;;;;;;;;;;;;gBAAk+M,CAAC;iBAAe,CAAC;oBAAkB,CAAC;;;;;;;;;;;;;;;;;;;;;;;oBAA9uJ,CAAC;kBAAgB,CAAC;eAAc,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;4BALz/K,GAAA;mBAKwE,CAAC;;;;;4BAA+rC,GAAG;oBAAuJ,CAAC;;;;wBAAutC,GAAG;2BAA8oB,GAAG,wCAA+E,GAAG;;;;oBAA88B,CAAC;iBAAsB,CAAC;mBAAwB,CAAC;oBAAyB,CAAC;uBAA4B,CAAC;mBAA8D,CAAC;;;8CAA+rE,GAAG;iDAAgf,GAAG;mBAA0W,GAAG,uCAAuI,GAAG;2BAAkb,GAAG,2BAA0E,GAAG;yBAAoZ,GAAG;uBAAslB,GAAG,wBAAoE,GAAG;wBAA4jB,GAAG,kCAAqE,GAAG;;;;;;;;;;;gBAA5rI,CAAC;iBAAgB,CAAC;kBAAgB,CAAC;;;kBAAk9D,CAAC;mBAAiB,CAAC;;;kBAAuiE,CAAC;oBAAkB,CAAC;;;;;;oBAAo+H,CAAC;;;;;;yBAA8qD,CAAC;;;;;;;;;6BAAjsW,MAAM;qBAAgD,CAAC;oBAAkB,CAAC;;6BAAwe,MAAM,mBAA4C,MAAM;qBAA+C,CAAC;oBAAkB,CAAC;;8BAAwkB,MAAM,cAAuC,MAAM;;;;sCAA3B,MAAM;;;;YAAuZ,MAAM;2BAAiX,MAAM;4BAAo/B,MAAM;+BAA0R,MAAM;4BAAgT,MAAM;6BAAuW,MAAM;6BAAgb,MAAM;8BAA6Z,MAAM;oBAA0T,MAAM;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;kBAA43Y,CAAC;iBAAe,CAAC;;;;;;;qBAA6wE,CAAC;oBAAkB,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;qBAAxyX,CAAC;;;;;;;;;;;;;;;;;;qFAAp6L,CAAC;;;;;;;;;;;;;;;;iFAAD,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAAk6L,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;cAAq/S,CAAC;aAAe,CAAC;;;;;;;iBAA6wE,CAAC;gBAAkB,CAAC;;;;;;;;;;;;;kCAA9hlB,MAAM;;;;QAAuZ,MAAM;uBAAiX,MAAM;wBAAo/B,MAAM;2BAA0R,MAAM;wBAAgT,MAAM;yBAAuW,MAAM;yBAAgb,MAAM;0BAA6Z,MAAM;gBAA0T,MAAM"}