qstd 0.2.10 → 0.2.12

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/react/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAKH,OAAO,gCAAgC,CAAC;AAKxC,OAAO,EAAE,OAAO,EAAE,MAAM,gBAAgB,CAAC;AAGzC,YAAY,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAMlD,MAAM,MAAM,UAAU,GAAG,MAAM,EAAE,CAAC;AAClC,MAAM,MAAM,YAAY,GAAG,OAAO,EAAE,CAAC;AAErC;;;;;GAKG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,GAAE,MAAY,UAe7D;AAED;;;;;GAKG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,MAAM,EAAE,QAAQ,GAAE,MAAY,UAkChE;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,aAAa,CAC3B,OAAO,EAAE,UAAU,EACnB,aAAa,GAAE,YAAiB,GAC/B,YAAY,CAkCd;AAED,cAAc,aAAa,CAAC"}

package/dist/react/index.js

@@ -8,11 +8,11 @@ import { BeatLoader } from 'react-spinners';
 import { Oval, ThreeDots, TailSpin, RotatingLines } from 'react-loader-spinner';
 import { jsx, jsxs, Fragment } from 'react/jsx-runtime';
 import { nanoid } from 'nanoid';
-import { fas } from '@fortawesome/free-solid-svg-icons';
 import { FontAwesomeIcon } from '@fortawesome/react-fontawesome';
 import { library } from '@fortawesome/fontawesome-svg-core';
 import { far } from '@fortawesome/free-regular-svg-icons';
 import { fab } from '@fortawesome/free-brands-svg-icons';
+import { fas } from '@fortawesome/free-solid-svg-icons';
 import { useImmer } from 'use-immer';
 
 // src/react/index.ts
@@ -892,9 +892,9 @@ var extractAudioMetadata = async (f) => {
     const ext = f.name.split(".").pop();
     const id = `${ext}_${nanoid()}.${ext}`;
     const [cover] = meta.common.picture ?? [];
-    const preview = URL.createObjectURL(
+    const preview = cover ? URL.createObjectURL(
       new Blob([cover.data], { type: cover.format })
-    );
+    ) : "";
     const audioMetadata = {
       id,
       preview,
@@ -2227,6 +2227,7 @@ function useResizeObserver(opts = {}) {
             round,
             instance: new ResizeObserver((entries) => {
               const entry = entries[0];
+              if (!entry) return;
               const boxProp = opts.box === "border-box" ? "borderBoxSize" : opts.box === "device-pixel-content-box" ? "devicePixelContentBoxSize" : "contentBoxSize";
               const reportedWidth = extractSize(entry, boxProp, "inlineSize");
               const reportedHeight = extractSize(entry, boxProp, "blockSize");

package/dist/react/use-theme/fns.d.ts

@@ -0,0 +1,5 @@
+import * as _t from "./types";
+export declare const getInitialTheme: () => _t.Theme;
+export declare const getInitialStore: () => _t.ThemeStore;
+export declare const saveStore: (store: _t.ThemeStore) => void;
+//# sourceMappingURL=fns.d.ts.map

package/dist/react/use-theme/fns.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fns.d.ts","sourceRoot":"","sources":["../../../src/react/use-theme/fns.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,SAAS,CAAC;AAI9B,eAAO,MAAM,eAAe,QAAO,EAAE,CAAC,KAGrC,CAAC;AAGF,eAAO,MAAM,eAAe,QAAO,EAAE,CAAC,UAiBrC,CAAC;AAGF,eAAO,MAAM,SAAS,GAAI,OAAO,EAAE,CAAC,UAAU,SAW7C,CAAC"}

package/dist/react/use-theme/index.d.ts

@@ -0,0 +1,13 @@
+import * as _t from "./types";
+export type { Theme, ThemeStore } from "./types";
+/**
+ * Hook to manage light/dark theme
+ * Syncs with localStorage and across components using events
+ */
+export declare function useTheme(): {
+    update: (updates: Partial<_t.ThemeStore>) => void;
+    toggle: (theme?: "light" | "dark") => void;
+    value: _t.Theme;
+    isManual: boolean;
+};
+//# sourceMappingURL=index.d.ts.map

package/dist/react/use-theme/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/react/use-theme/index.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,MAAM,SAAS,CAAC;AAI9B,YAAY,EAAE,KAAK,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AAEjD;;;GAGG;AACH,wBAAgB,QAAQ;sBA8CG,OAAO,CAAC,EAAE,CAAC,UAAU,CAAC;qBAOvB,OAAO,GAAG,MAAM;;;EAWzC"}

package/dist/react/use-theme/literals.d.ts

@@ -0,0 +1,4 @@
+export declare const THEME_STORAGE_KEY = "theme";
+export declare const THEME_STORE_STORAGE_KEY = "themeStore";
+export declare const THEME_CHANGE_EVENT = "qstd:theme-change";
+//# sourceMappingURL=literals.d.ts.map

package/dist/react/use-theme/literals.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"literals.d.ts","sourceRoot":"","sources":["../../../src/react/use-theme/literals.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,iBAAiB,UAAU,CAAC;AACzC,eAAO,MAAM,uBAAuB,eAAe,CAAC;AACpD,eAAO,MAAM,kBAAkB,sBAAsB,CAAC"}

package/dist/react/use-theme/types.d.ts

@@ -0,0 +1,6 @@
+export type Theme = "light" | "dark";
+export type ThemeStore = {
+    value: Theme;
+    isManual: boolean;
+};
+//# sourceMappingURL=types.d.ts.map

package/dist/react/use-theme/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/react/use-theme/types.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,KAAK,GAAG,OAAO,GAAG,MAAM,CAAC;AAErC,MAAM,MAAM,UAAU,GAAG;IACvB,KAAK,EAAE,KAAK,CAAC;IACb,QAAQ,EAAE,OAAO,CAAC;CACnB,CAAC"}

package/dist/server/file.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Read file contents as string
+ * @param filePath
+ * @param encoding
+ * @returns
+ */
+export declare const readFile: (filePath: string, encoding?: BufferEncoding) => string;
+//# sourceMappingURL=file.d.ts.map

package/dist/server/file.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"file.d.ts","sourceRoot":"","sources":["../../src/server/file.ts"],"names":[],"mappings":"AAKA;;;;;GAKG;AACH,eAAO,MAAM,QAAQ,GACnB,UAAU,MAAM,EAChB,WAAU,cAAwB,KACjC,MAEF,CAAC"}

package/dist/server/index.cjs

@@ -552,11 +552,18 @@ var hexColor = () => {
 var log_exports = {};
 __export(log_exports, {
   error: () => error,
+  header: () => header,
   info: () => info,
+  label: () => label,
   log: () => log,
+  startTimer: () => startTimer,
   warn: () => warn
 });
 var stringify = (value) => JSON.stringify(value, null, 2);
+var startTimer = () => {
+  const start = Date.now();
+  return () => Date.now() - start;
+};
 var log = (...values) => {
   console.log(...values.map(stringify));
 };
@@ -569,6 +576,27 @@ var warn = (...values) => {
 var error = (...values) => {
   console.log("[error]", ...values.map(stringify));
 };
+var header = (message) => {
+  console.log(`========== ${message} ==========`);
+};
+var label = (name) => ({
+  /** Logs values with [label] prefix. Output: `[label] "value"` */
+  info: (...values) => {
+    console.log(`[${name}]`, ...values.map(stringify));
+  },
+  /** Logs values with [label] [warn] prefix. Output: `[label] [warn] "value"` */
+  warn: (...values) => {
+    console.log(`[${name}]`, "[warn]", ...values.map(stringify));
+  },
+  /** Logs values with [label] [error] prefix. Output: `[label] [error] "value"` */
+  error: (...values) => {
+    console.log(`[${name}]`, "[error]", ...values.map(stringify));
+  },
+  /** Logs a header message with [label] prefix. Output: `[label] ========== MESSAGE ==========` */
+  header: (message) => {
+    console.log(`[${name}] ========== ${message} ==========`);
+  }
+});
 
 // src/server/file.ts
 var file_exports = {};

package/dist/server/index.d.ts

@@ -1,17 +1,11 @@
-export { d as Dict, f as Flow, i as Int, l as List, a as Log, m as Money, r as Random, s as Str, t as Time } from '../log-DlaF8tUZ.js';
-import 'date-fns';
-
-/**
- * Read file contents as string
- * @param filePath
- * @param encoding
- * @returns
- */
-declare const readFile: (filePath: string, encoding?: BufferEncoding) => string;
-
-declare const file_readFile: typeof readFile;
-declare namespace file {
-  export { file_readFile as readFile };
-}
-
-export { file as File };
+export * as List from "../shared/list";
+export * as Dict from "../shared/dict";
+export * as Str from "../shared/str";
+export * as Int from "../shared/int";
+export * as Money from "../shared/money";
+export * as Time from "../shared/time";
+export * as Flow from "../shared/flow";
+export * as Random from "../shared/random";
+export * as Log from "../shared/log";
+export * as File from "./file";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/server/index.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,IAAI,MAAM,gBAAgB,CAAC;AACvC,OAAO,KAAK,IAAI,MAAM,gBAAgB,CAAC;AACvC,OAAO,KAAK,GAAG,MAAM,eAAe,CAAC;AACrC,OAAO,KAAK,GAAG,MAAM,eAAe,CAAC;AACrC,OAAO,KAAK,KAAK,MAAM,iBAAiB,CAAC;AACzC,OAAO,KAAK,IAAI,MAAM,gBAAgB,CAAC;AACvC,OAAO,KAAK,IAAI,MAAM,gBAAgB,CAAC;AACvC,OAAO,KAAK,MAAM,MAAM,kBAAkB,CAAC;AAC3C,OAAO,KAAK,GAAG,MAAM,eAAe,CAAC;AAGrC,OAAO,KAAK,IAAI,MAAM,QAAQ,CAAC"}

package/dist/server/index.js

@@ -546,11 +546,18 @@ var hexColor = () => {
 var log_exports = {};
 __export(log_exports, {
   error: () => error,
+  header: () => header,
   info: () => info,
+  label: () => label,
   log: () => log,
+  startTimer: () => startTimer,
   warn: () => warn
 });
 var stringify = (value) => JSON.stringify(value, null, 2);
+var startTimer = () => {
+  const start = Date.now();
+  return () => Date.now() - start;
+};
 var log = (...values) => {
   console.log(...values.map(stringify));
 };
@@ -563,6 +570,27 @@ var warn = (...values) => {
 var error = (...values) => {
   console.log("[error]", ...values.map(stringify));
 };
+var header = (message) => {
+  console.log(`========== ${message} ==========`);
+};
+var label = (name) => ({
+  /** Logs values with [label] prefix. Output: `[label] "value"` */
+  info: (...values) => {
+    console.log(`[${name}]`, ...values.map(stringify));
+  },
+  /** Logs values with [label] [warn] prefix. Output: `[label] [warn] "value"` */
+  warn: (...values) => {
+    console.log(`[${name}]`, "[warn]", ...values.map(stringify));
+  },
+  /** Logs values with [label] [error] prefix. Output: `[label] [error] "value"` */
+  error: (...values) => {
+    console.log(`[${name}]`, "[error]", ...values.map(stringify));
+  },
+  /** Logs a header message with [label] prefix. Output: `[label] ========== MESSAGE ==========` */
+  header: (message) => {
+    console.log(`[${name}] ========== ${message} ==========`);
+  }
+});
 
 // src/server/file.ts
 var file_exports = {};

package/dist/shared/dict.d.ts

@@ -0,0 +1,57 @@
+/**
+ * dicts are homogeneous- their values must be of the same type
+ * records can hold values of different types
+ */
+type t = Record<string, unknown> | object;
+/**
+ * Calculate the byte size of an object
+ * @param o
+ * @returns
+ */
+export declare function byteSizeOfObj(o: any): number;
+/**
+ * Return an object filter with a subset of properties.
+ * @param r
+ * @param predicate
+ */
+export declare const filter: <R extends t>(r: R, predicate: (value: R[keyof R]) => boolean) => R;
+/**
+ * Transform the values on an object
+ * @param r
+ * @param transformFn
+ */
+export declare const transform: <R extends t>(r: R, transformFn: (key: keyof R, value: R[keyof R]) => Record<string, any>) => R;
+/**
+ * First object contains key/value pairs that pass the predicate.
+ * Second object contains key/value pairs that failed.
+ * @param r
+ * @param predicate
+ * @returns
+ */
+export declare const partition: <R extends t>(r: R, predicate: (key: keyof R) => boolean) => readonly [R, R];
+/**
+ * Check if an object exists and has keys
+ * @param obj
+ * @returns
+ */
+export declare const exists: <O>(obj: O) => boolean;
+/**
+ * Determine if an object is empty.
+ * @param obj
+ * @returns
+ */
+export declare const isEmpty: <T extends t>(obj: T) => boolean;
+/**
+ * Return an object with a subset of properties.
+ * @param r
+ * @param paths
+ */
+export declare const pick: <R extends t, U extends keyof R>(r: R, paths: Array<U>) => Pick<R, U>;
+/**
+ * Return an object with a subset of properties omitted.
+ * @param r
+ * @param paths
+ */
+export declare const omit: <R extends Record<string, any>, U extends keyof R>(r: R, paths: Array<U>) => Omit<R, U>;
+export {};
+//# sourceMappingURL=dict.d.ts.map

package/dist/shared/dict.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dict.d.ts","sourceRoot":"","sources":["../../src/shared/dict.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,KAAK,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,CAAC;AAE1C;;;;GAIG;AACH,wBAAgB,aAAa,CAAC,CAAC,EAAE,GAAG,UAwBnC;AAED;;;;GAIG;AACH,eAAO,MAAM,MAAM,GAAI,CAAC,SAAS,CAAC,EAChC,GAAG,CAAC,EACJ,WAAW,CAAC,KAAK,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,KAAK,OAAO,MAMxC,CAAC;AAEJ;;;;GAIG;AACH,eAAO,MAAM,SAAS,GAAI,CAAC,SAAS,CAAC,EACnC,GAAG,CAAC,EACJ,aAAa,CAAC,GAAG,EAAE,MAAM,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,KAAK,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,MAQpE,CAAC;AAEJ;;;;;;GAMG;AACH,eAAO,MAAM,SAAS,GAAI,CAAC,SAAS,CAAC,EACnC,GAAG,CAAC,EACJ,WAAW,CAAC,GAAG,EAAE,MAAM,CAAC,KAAK,OAAO,oBASrC,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,MAAM,GAAI,CAAC,EAAE,KAAK,CAAC,YAE/B,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,OAAO,GAAI,CAAC,SAAS,CAAC,EAAE,KAAK,CAAC,YAK1C,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,IAAI,GAAI,CAAC,SAAS,CAAC,EAAE,CAAC,SAAS,MAAM,CAAC,EACjD,GAAG,CAAC,EACJ,OAAO,KAAK,CAAC,CAAC,CAAC,KACd,IAAI,CAAC,CAAC,EAAE,CAAC,CAKT,CAAC;AAEJ;;;;GAIG;AACH,eAAO,MAAM,IAAI,GAAI,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EAAE,CAAC,SAAS,MAAM,CAAC,EACnE,GAAG,CAAC,EACJ,OAAO,KAAK,CAAC,CAAC,CAAC,KACd,IAAI,CAAC,CAAC,EAAE,CAAC,CAYX,CAAC"}

package/dist/shared/flow.d.ts

@@ -0,0 +1,36 @@
+/**
+ * Throttle a function call
+ * @param fn
+ * @param ms
+ * @returns
+ */
+export declare const throttle: (fn: any, ms: number) => (...args: any[]) => void;
+/**
+ * Ensure code is only triggered once per user input.
+ * The debounce forces another function to wait a certain amount of time before running again.
+ * Its purpose is to prevent a function from being called several times in succession.
+ * @param fn
+ * @param timeout
+ * @returns
+ */
+export declare const debounce: <T extends any[]>(fn: (...args: T) => any, timeout: number) => ((...args: T) => void);
+/**
+ * Sleep for x milliseconds.
+ * @param ms
+ * @returns
+ */
+export declare const sleep: (ms: number) => Promise<void>;
+/**
+ * Async pool for concurrent iteration with concurrency limit
+ * @example
+ * ```
+ * for await (const ms of asyncPool(2, [1000, 5000, 3000, 2000], ms => sleep(ms))) {
+ *   console.log(ms);
+ * }
+ * ```
+ * @param concurrency
+ * @param iterable
+ * @param iterator_fn
+ */
+export declare function asyncPool<T>(concurrency: number, iterable: T[], iterator_fn: (x: T, xs: T[]) => any): AsyncGenerator<any, void, unknown>;
+//# sourceMappingURL=flow.d.ts.map

package/dist/shared/flow.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"flow.d.ts","sourceRoot":"","sources":["../../src/shared/flow.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,eAAO,MAAM,QAAQ,GAAI,IAAI,GAAG,EAAE,IAAI,MAAM,MAElC,GAAG,MAAM,GAAG,EAAE,SAMvB,CAAC;AAEF;;;;;;;GAOG;AACH,eAAO,MAAM,QAAQ,GAAI,CAAC,SAAS,GAAG,EAAE,EACtC,IAAI,CAAC,GAAG,IAAI,EAAE,CAAC,KAAK,GAAG,EACvB,SAAS,MAAM,KACd,CAAC,CAAC,GAAG,IAAI,EAAE,CAAC,KAAK,IAAI,CAUvB,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,KAAK,GAAI,IAAI,MAAM,KAAG,OAAO,CAAC,IAAI,CACJ,CAAC;AAE5C;;;;;;;;;;;GAWG;AACH,wBAAuB,SAAS,CAAC,CAAC,EAChC,WAAW,EAAE,MAAM,EACnB,QAAQ,EAAE,CAAC,EAAE,EACb,WAAW,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,EAAE,CAAC,EAAE,KAAK,GAAG,sCAyBpC"}

package/dist/shared/int.d.ts

@@ -0,0 +1,49 @@
+type Range = {
+    min: number;
+    max: number;
+};
+/**
+ * Clamp a number within a range
+ * @param num
+ * @param range
+ * @returns
+ */
+export declare const clamp: (num: number, range: Range) => number;
+/**
+ * Format a number with comma-separated thousandths
+ * @param n
+ * @returns
+ */
+export declare const commaSeparateThousandths: (n: number | string) => string;
+/**
+ * Convert bytes to other units.
+ * @param bytes
+ * @param decimals
+ * @param binaryUnits
+ * @example
+ * ```js
+ * formatBytes(293489203947847, 1);    // 293.5 TB
+ * formatBytes(1234, 0);   // 1 KB
+ * formatBytes(4534634523453678343456, 2); // 4.53 ZB
+ * formatBytes(4534634523453678343456, 2, true));  // 3.84 ZiB
+ * formatBytes(4566744, 1);    // 4.6 MB
+ * formatBytes(534, 0);    // 534 Bytes
+ * formatBytes(273403407, 0);  // 273 MB
+ * ```
+ * @returns
+ */
+export declare const formatBytes: (bytes?: number, decimals?: number, binaryUnits?: boolean) => {
+    value?: undefined;
+    unit?: undefined;
+    display?: undefined;
+} | {
+    value: number;
+    unit: string;
+    display?: undefined;
+} | {
+    value: number;
+    unit: string | undefined;
+    display: string;
+};
+export {};
+//# sourceMappingURL=int.d.ts.map

package/dist/shared/int.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"int.d.ts","sourceRoot":"","sources":["../../src/shared/int.ts"],"names":[],"mappings":"AAAA,KAAK,KAAK,GAAG;IAAE,GAAG,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,MAAM,CAAA;CAAE,CAAC;AAE1C;;;;;GAKG;AACH,eAAO,MAAM,KAAK,GAAI,KAAK,MAAM,EAAE,OAAO,KAAK,WACA,CAAC;AAWhD;;;;GAIG;AACH,eAAO,MAAM,wBAAwB,GAAI,GAAG,MAAM,GAAG,MAAM,WAK1D,CAAC;AAEF;;;;;;;;;;;;;;;;GAgBG;AACH,eAAO,MAAM,WAAW,GACtB,QAAQ,MAAM,EACd,iBAAY,EACZ,qBAAmB;;;;;;;;;;;;CAgBpB,CAAC"}

package/dist/shared/list.d.ts

@@ -0,0 +1,29 @@
+/**
+ * Robust variadic zipWith with full type inference
+ */
+export declare function zipWith<T extends readonly any[], R>(fn: (...args: T) => R, ...arrays: {
+    [K in keyof T]: T[K][];
+}): R[];
+/**
+ * Create an array of x length filled with items of type y.
+ * @param size
+ * @param fn
+ * @returns
+ */
+export declare const create: <T>(size: number, fn?: (_: unknown, x: number) => T) => T[];
+/**
+ * First list includes items that pass the predicate.
+ * Second list includes items that failed.
+ * @param xs
+ * @param predicate
+ * @returns
+ */
+export declare const partition: <T>(xs: T[], predicate: (x: T) => boolean) => [T[], T[]];
+/**
+ * Split an array into chunks of a specific size
+ * @param list
+ * @param chunkSize
+ * @returns
+ */
+export declare const chunk: <T>(list: T[], chunkSize: number) => T[][];
+//# sourceMappingURL=list.d.ts.map

package/dist/shared/list.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"list.d.ts","sourceRoot":"","sources":["../../src/shared/list.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,wBAAgB,OAAO,CAAC,CAAC,SAAS,SAAS,GAAG,EAAE,EAAE,CAAC,EACjD,EAAE,EAAE,CAAC,GAAG,IAAI,EAAE,CAAC,KAAK,CAAC,EACrB,GAAG,MAAM,EAAE;KAAG,CAAC,IAAI,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE;CAAE,GACpC,CAAC,EAAE,CAYL;AAED;;;;;GAKG;AACH,eAAO,MAAM,MAAM,GAAI,CAAC,EACtB,MAAM,MAAM,EACZ,KAAK,CAAC,CAAC,EAAE,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC,KAChC,CAAC,EAAoE,CAAC;AAEzE;;;;;;GAMG;AACH,eAAO,MAAM,SAAS,GAAI,CAAC,EAAE,IAAI,CAAC,EAAE,EAAE,WAAW,CAAC,CAAC,EAAE,CAAC,KAAK,OAAO,eAS/D,CAAC;AAEJ;;;;;GAKG;AACH,eAAO,MAAM,KAAK,GAAI,CAAC,EAAE,MAAM,CAAC,EAAE,EAAE,WAAW,MAAM,UAQpD,CAAC"}

package/dist/shared/log.d.ts

@@ -0,0 +1,98 @@
+/**
+ * Usage Examples:
+ *
+ * ```typescript // Basic logging
+ * Log.info("stuff");              // [info] "stuff"
+ * Log.warn("uh oh");              // [warn] "uh oh"
+ * Log.error("bad");               // [error] "bad"
+ *
+ * // Standalone header
+ * Log.header("STARTING");         // ========== STARTING ==========
+ *
+ * // Scoped logger
+ * const log = Log.label("audio-processor");
+ * log.info("something");          // [audio-processor] "something"
+ * log.warn("hmm");                // [audio-processor] [warn] "hmm"
+ * log.error("failed");            // [audio-processor] [error] "failed"
+ * log.header("HANDLER START");    // [audio-processor] ========== HANDLER START ==========
+ *
+ */
+/**
+ * Starts a timer and returns a function that returns elapsed milliseconds.
+ * @returns A function that returns the elapsed time in ms since the timer started
+ * @example
+ * ```typescript // Timer
+ * const elapsed = Log.startTimer();
+ * // ... do work ...
+ * log.header(`COMPLETE (${elapsed()}ms)`);  // ========== COMPLETE (123ms) ==========```
+ */
+export declare const startTimer: () => () => number;
+/**
+ * Logs values to the console (no prefix).
+ * @param values - Values to log (will be JSON stringified)
+ * @example
+ * ```typescript
+ * log("hello"); // "hello"
+ * ```
+ */
+export declare const log: (...values: unknown[]) => void;
+/**
+ * Logs values with [info] prefix.
+ * @param values - Values to log (will be JSON stringified)
+ * @example
+ * ```typescript
+ * info("stuff"); // [info] "stuff"
+ * ```
+ */
+export declare const info: (...values: unknown[]) => void;
+/**
+ * Logs values with [warn] prefix.
+ * @param values - Values to log (will be JSON stringified)
+ * @example
+ * ```typescript
+ * warn("uh oh"); // [warn] "uh oh"
+ * ```
+ */
+export declare const warn: (...values: unknown[]) => void;
+/**
+ * Logs values with [error] prefix.
+ * @param values - Values to log (will be JSON stringified)
+ * @example
+ * ```typescript
+ * error("bad"); // [error] "bad"
+ * ```
+ */
+export declare const error: (...values: unknown[]) => void;
+/**
+ * Logs a message wrapped in header decoration.
+ * @param message - The header message
+ * @example
+ * ```typescript
+ * header("STARTING"); // ========== STARTING ==========
+ * ```
+ */
+export declare const header: (message: string) => void;
+/**
+ * Creates a scoped logger with a label prefix.
+ * @param name - The label to prefix all log messages with
+ * @returns A logger object with info, warn, error, and header methods
+ * @example
+ * ```typescript
+ * const log = label("audio-processor");
+ * log.info("something");        // [audio-processor] "something"
+ * log.warn("hmm");              // [audio-processor] [warn] "hmm"
+ * log.error("failed");          // [audio-processor] [error] "failed"
+ * log.header("HANDLER START");  // [audio-processor] ========== HANDLER START ==========
+ * ```
+ */
+export declare const label: (name: string) => {
+    /** Logs values with [label] prefix. Output: `[label] "value"` */
+    info: (...values: unknown[]) => void;
+    /** Logs values with [label] [warn] prefix. Output: `[label] [warn] "value"` */
+    warn: (...values: unknown[]) => void;
+    /** Logs values with [label] [error] prefix. Output: `[label] [error] "value"` */
+    error: (...values: unknown[]) => void;
+    /** Logs a header message with [label] prefix. Output: `[label] ========== MESSAGE ==========` */
+    header: (message: string) => void;
+};
+//# sourceMappingURL=log.d.ts.map

package/dist/shared/log.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"log.d.ts","sourceRoot":"","sources":["../../src/shared/log.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAIH;;;;;;;;GAQG;AACH,eAAO,MAAM,UAAU,oBAGtB,CAAC;AAEF;;;;;;;GAOG;AACH,eAAO,MAAM,GAAG,GAAI,GAAG,QAAQ,OAAO,EAAE,SAEvC,CAAC;AAEF;;;;;;;GAOG;AACH,eAAO,MAAM,IAAI,GAAI,GAAG,QAAQ,OAAO,EAAE,SAExC,CAAC;AAEF;;;;;;;GAOG;AACH,eAAO,MAAM,IAAI,GAAI,GAAG,QAAQ,OAAO,EAAE,SAExC,CAAC;AAEF;;;;;;;GAOG;AACH,eAAO,MAAM,KAAK,GAAI,GAAG,QAAQ,OAAO,EAAE,SAEzC,CAAC;AAEF;;;;;;;GAOG;AACH,eAAO,MAAM,MAAM,GAAI,SAAS,MAAM,SAErC,CAAC;AAEF;;;;;;;;;;;;GAYG;AACH,eAAO,MAAM,KAAK,GAAI,MAAM,MAAM;IAChC,iEAAiE;sBAC/C,OAAO,EAAE;IAG3B,+EAA+E;sBAC7D,OAAO,EAAE;IAG3B,iFAAiF;uBAC9D,OAAO,EAAE;IAG5B,iGAAiG;sBAC/E,MAAM;CAGxB,CAAC"}

package/dist/shared/money.d.ts

@@ -0,0 +1,18 @@
+type Opts = {
+    symbol?: boolean;
+};
+/**
+ * Convert cents to USD currency string
+ * @param cents
+ * @param opts
+ * @returns
+ */
+export declare const convertToUsd: (cents?: number | string, opts?: Opts) => string | undefined;
+/**
+ * Convert dollars to cents
+ * @param dollars
+ * @returns
+ */
+export declare const convertToCents: (dollars: string | number) => number;
+export {};
+//# sourceMappingURL=money.d.ts.map

package/dist/shared/money.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"money.d.ts","sourceRoot":"","sources":["../../src/shared/money.ts"],"names":[],"mappings":"AAAA,KAAK,IAAI,GAAG;IACV,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB,CAAC;AAEF;;;;;GAKG;AACH,eAAO,MAAM,YAAY,GAAI,QAAQ,MAAM,GAAG,MAAM,EAAE,OAAM,IAAS,uBASpE,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,cAAc,GAAI,SAAS,MAAM,GAAG,MAAM,WAGtD,CAAC"}

package/dist/shared/random.d.ts

@@ -0,0 +1,41 @@
+/**
+ * Randomly pick an item from an array.
+ * @param xs
+ * @returns
+ */
+export declare const item: <T>(xs: T[]) => T | undefined;
+type RandProps = {
+    min?: number;
+    max?: number;
+};
+/**
+ * Generate a random number (supposedly more random than v1)
+ * @param props
+ * @returns
+ */
+export declare const num: (props?: RandProps) => number;
+/**
+ * The Fisher-Yates shuffle is the most efficient algorithm for that purpose.
+ * @param xs
+ * @returns
+ */
+export declare const shuffle: <T>(xs: T[]) => T[];
+/**
+ * Randomly return true or false.
+ * @returns
+ */
+export declare const coinFlip: () => boolean;
+/**
+ * Generate a random date.
+ * 10000000000 keeps the date to within the current year.
+ * The more 0s, the greater the range.
+ * @returns
+ */
+export declare const date: () => Date;
+/**
+ * Generate a random hex color.
+ * @returns
+ */
+export declare const hexColor: () => string;
+export {};
+//# sourceMappingURL=random.d.ts.map

package/dist/shared/random.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"random.d.ts","sourceRoot":"","sources":["../../src/shared/random.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,eAAO,MAAM,IAAI,GAAI,CAAC,EAAE,IAAI,CAAC,EAAE,kBAI9B,CAAC;AAEF,KAAK,SAAS,GAAG;IACf,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,GAAG,CAAC,EAAE,MAAM,CAAC;CACd,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,GAAG,GAAI,QAAO,SAAc,WAOxC,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,OAAO,GAAI,CAAC,EAAE,IAAI,CAAC,EAAE,QAKjC,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,QAAQ,eAEpB,CAAC;AAEF;;;;;GAKG;AACH,eAAO,MAAM,IAAI,YAEhB,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,QAAQ,QAAO,MAO3B,CAAC"}