@augment-vir/common 31.14.1 → 31.15.0

package/dist/augments/array/array-map.d.ts

@@ -1,5 +1,5 @@
-import type { ArrayElement } from '@augment-vir/core';
-import { Writable } from '../type/writable.js';
+import { type ArrayElement } from '@augment-vir/core';
+import { type Writable } from '../type/writable.js';
 /**
  * Performs
  * [`[].map()`](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Array/map)

package/dist/augments/array/create-array.d.ts

@@ -1,4 +1,4 @@
-import type { Tuple } from '@augment-vir/core';
+import { type Tuple } from '@augment-vir/core';
 /**
  * Creates an array of size `size` and calls the given `callback` for each entry in the array and
  * fills the array with the results. The returned array is typed to exactly fit the given size.

package/dist/augments/enum/enum-value-check.d.ts

@@ -1,4 +1,4 @@
-import type { EnumBaseType } from '@augment-vir/core';
+import { type EnumBaseType } from '@augment-vir/core';
 /**
  * Filters the input array to all valid values from the given enum.
  *

package/dist/augments/function/debounce.d.ts

@@ -1,5 +1,5 @@
 import { type MaybePromise } from '@augment-vir/core';
-import { AnyDuration } from '@date-vir/duration';
+import { type AnyDuration } from '@date-vir/duration';
 /**
  * Different types of debouncing for the {@link Debounce} class.
  *

package/dist/augments/function/execution-duration.d.ts

@@ -1,4 +1,4 @@
-import { Duration, DurationUnit } from '@date-vir/duration';
+import { type Duration, type DurationUnit } from '@date-vir/duration';
 /**
  * Measures how long (in milliseconds) the given callback takes to run to completion. By default
  * this is synchronous, but it will automatically switch to async and await the callback if it

package/dist/augments/json/append-json.d.ts

@@ -1,5 +1,4 @@
-import type { JsonCompatibleArray, JsonCompatibleObject, JsonCompatibleValue } from '@augment-vir/core';
-import { JsonCompatiblePrimitive } from '@augment-vir/core';
+import { type JsonCompatibleArray, type JsonCompatibleObject, type JsonCompatiblePrimitive, type JsonCompatibleValue } from '@augment-vir/core';
 export declare function appendJson(entry: JsonCompatibleArray | JsonCompatiblePrimitive, ...entries: ReadonlyArray<JsonCompatibleValue | undefined>): JsonCompatibleArray;
 export declare function appendJson(entry: JsonCompatibleObject, ...entries: ReadonlyArray<JsonCompatibleObject | JsonCompatibleArray | undefined>): JsonCompatibleObject;
 export declare function appendJson(...entries: ReadonlyArray<JsonCompatibleValue | undefined>): JsonCompatibleObject | JsonCompatibleArray;

package/dist/augments/json/copy-through-json.d.ts

@@ -1,4 +1,4 @@
-import { Jsonify, Writable } from 'type-fest';
+import { type Jsonify, type Writable } from 'type-fest';
 /**
  * Deeply copy an object through JSON. This is the fastest deep copy, but the input must already be
  * JSON serializable otherwise the copy will not match the original.

package/dist/augments/json/jsonify.d.ts

@@ -1,4 +1,4 @@
-import { Jsonify } from 'type-fest';
+import { type Jsonify } from 'type-fest';
 /**
  * Creates a JSON compatible version of the value given. Under the hood this is actually the same as
  * {@link copyThroughJson}.

package/dist/augments/log/log-string.d.ts

@@ -1,5 +1,5 @@
 import { LogColorKey, type LogColorConfig } from './log-colors.js';
-import { LogWriterParams } from './log-writer.js';
+import { type LogWriterParams } from './log-writer.js';
 /**
  * Options for a custom Logger.
  *

package/dist/augments/log/log.d.ts

@@ -1,6 +1,6 @@
 import { type PartialWithUndefined } from '@augment-vir/core';
-import { LoggerOptions } from './log-string.js';
-import { LogWriters } from './log-writer.js';
+import { type LoggerOptions } from './log-string.js';
+import { type LogWriters } from './log-writer.js';
 import { type Logger } from './logger.js';
 /**
  * Default implementation of {@link LogWriters} that is dependent on the current runtime environment.

package/dist/augments/log/logger.d.ts

@@ -1,4 +1,4 @@
-import type { PartialWithUndefined } from '@augment-vir/core';
+import { type PartialWithUndefined } from '@augment-vir/core';
 import { LogColorKey } from './log-colors.js';
 import { type LoggerOptions } from './log-string.js';
 import { type LogWriters } from './log-writer.js';

package/dist/augments/number/clamp.d.ts

@@ -1,4 +1,4 @@
-import { MinMax } from '@augment-vir/core';
+import { type MinMax } from '@augment-vir/core';
 /**
  * Clamp's the given value to within the min and max bounds, inclusive.
  *

package/dist/augments/number/wrap-number.d.ts

@@ -1,4 +1,4 @@
-import { MinMax } from '@augment-vir/core';
+import { type MinMax } from '@augment-vir/core';
 /**
  * If the given value is outside the given min/max bounds, instead of clamping the number (as the
  * `clamp` function does), this function wraps the value around to the next bound (inclusive).

package/dist/augments/object/diff.d.ts

@@ -1,4 +1,4 @@
-import { PartialDeep } from 'type-fest';
+import { type PartialDeep } from 'type-fest';
 /**
  * Extract all nested object keys and values that are different between the two given objects.
  *

package/dist/augments/object/empty.d.ts

@@ -1,4 +1,4 @@
-import { IsEmptyObject } from 'type-fest';
+import { type IsEmptyObject } from 'type-fest';
 /**
  * Excludes empty objects from a union.
  *

package/dist/augments/object/get-or-set.d.ts

@@ -1,4 +1,4 @@
-import { MaybePromise, type AnyObject } from '@augment-vir/core';
+import { type AnyObject, type MaybePromise } from '@augment-vir/core';
 export declare function getOrSetFromMap<MapKey extends object, MapValue>(map: WeakMap<MapKey, MapValue>, key: MapKey, createCallback: () => MapValue): MapValue;
 export declare function getOrSetFromMap<MapKey, MapValue>(map: Map<MapKey, MapValue>, key: MapKey, createCallback: () => MapValue): MapValue;
 export declare function getOrSetFromMap<MapKey extends object, MapValue>(map: WeakMap<MapKey, MapValue>, key: MapKey, createCallback: () => Promise<MapValue>): Promise<MapValue>;

package/dist/augments/object/map-entries.d.ts

@@ -1,4 +1,4 @@
-import { Values, type MaybePromise } from '@augment-vir/core';
+import { type MaybePromise, type Values } from '@augment-vir/core';
 export declare function mapObject<const OriginalObject, const NewKey extends PropertyKey, const NewValue>(inputObject: OriginalObject, mapCallback: (originalKey: keyof OriginalObject, originalValue: Values<OriginalObject>, originalObject: OriginalObject) => Promise<{
     key: NewKey;
     value: NewValue;

package/dist/augments/object/map-enum.d.ts

@@ -1,4 +1,4 @@
-import type { EnumBaseType, MaybePromise, Values } from '@augment-vir/core';
+import { type EnumBaseType, type MaybePromise, type Values } from '@augment-vir/core';
 /**
  * Creates an object that maps all values of an enum to the provided `Values` type.
  *

package/dist/augments/object/merge-deep.d.ts

@@ -1,4 +1,4 @@
-import { PartialDeep } from 'type-fest';
+import { type PartialDeep } from 'type-fest';
 /**
  * Accepts multiple objects and merges their key-value pairs recursively. Any values set to
  * undefined will be removed.

package/dist/augments/object/merge-defined-properties.d.ts

@@ -1,4 +1,4 @@
-import type { AnyObject, PartialWithNullable } from '@augment-vir/core';
+import { type AnyObject, type PartialWithNullable } from '@augment-vir/core';
 /**
  * Merge all objects together but ignore any override values that are `undefined` or `null` or
  * missing. This only merges objects at the top level, it is not a deep merge.

package/dist/augments/object/object-entries.d.ts

@@ -1,4 +1,4 @@
-import { CompleteRequire } from '@augment-vir/core';
+import { type CompleteRequire } from '@augment-vir/core';
 /**
  * Gets an object's entries. This is the same as
  * [`Object.entries`](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Object/entries)

package/dist/augments/object/object-values.d.ts

@@ -1,4 +1,4 @@
-import { CompleteRequire } from '@augment-vir/core';
+import { type CompleteRequire } from '@augment-vir/core';
 /**
  * Gets an object's values. This is the same as
  * [`Object.values`](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Object/values)

package/dist/augments/prisma/base-prisma-types.d.ts

@@ -1,4 +1,4 @@
-import { AnyObject, type AnyFunction } from '@augment-vir/core';
+import { type AnyFunction, type AnyObject } from '@augment-vir/core';
 /**
  * A base type for Prisma model payloads because Prisma doesn't give us one. This currently only
  * includes the properties that are used within this package.

package/dist/augments/prisma/prisma-basic-model.d.ts

@@ -1,5 +1,5 @@
-import type { BasePrismaClient } from './base-prisma-types.js';
-import type { PrismaModelName } from './prisma-model-name.js';
+import { type BasePrismaClient } from './base-prisma-types.js';
+import { type PrismaModelName } from './prisma-model-name.js';
 /**
  * A basic model entry with only its immediate properties.
  *
@@ -8,8 +8,8 @@ import type { PrismaModelName } from './prisma-model-name.js';
  * @example
  *
  * ```ts
- * import type {PrismaClient} from '@prisma/client';
- * import type {PrismaBasicModel} from '@augment-vir/common';
+ * import {type PrismaClient} from '@prisma/client';
+ * import {type PrismaBasicModel} from '@augment-vir/common';
  *
  * function doThing(fullModel: PrismaBasicModel<PrismaClient, 'user'>) {}
  * ```

package/dist/augments/prisma/prisma-full-model.d.ts

@@ -1,5 +1,5 @@
 import { type BasePrismaClient, type BasePrismaPayload } from './base-prisma-types.js';
-import type { PrismaModelName } from './prisma-model-name.js';
+import { type PrismaModelName } from './prisma-model-name.js';
 /**
  * A full model entry with all relations from the given Prisma type map and model name.
  *
@@ -8,8 +8,8 @@ import type { PrismaModelName } from './prisma-model-name.js';
  * @example
  *
  * ```ts
- * import type {Prisma} from '@prisma/client';
- * import type {FullPrismaModel} from '@augment-vir/common';
+ * import {type Prisma} from '@prisma/client';
+ * import {type FullPrismaModel} from '@augment-vir/common';
  *
  * function doThing(fullModel: FullModel<Prisma.TypeMap, 'User'>) {}
  * ```

package/dist/augments/prisma/prisma-model-create.d.ts

@@ -1,5 +1,5 @@
-import type { BasePrismaClient } from './base-prisma-types.js';
-import type { PrismaModelName } from './prisma-model-name.js';
+import { type BasePrismaClient } from './base-prisma-types.js';
+import { type PrismaModelName } from './prisma-model-name.js';
 /**
  * Use this to define mock entries that _shouldn't_ be saved to the database so that we can easily
  * write tests for missing data.
@@ -9,7 +9,7 @@ import type { PrismaModelName } from './prisma-model-name.js';
  * @example
  *
  * ```ts
- * import type {PrismaClient} from '@prisma/client';
+ * import {type PrismaClient} from '@prisma/client';
  * import {prismaModelCreateExclude, PrismaKeyedModelCreate} from '@augment-vir/common';
  *
  * export const mockUsers = {
@@ -38,7 +38,7 @@ export declare const prismaModelCreateExclude: unique symbol;
  * @example
  *
  * ```ts
- * import type {PrismaClient} from '@prisma/client';
+ * import {type PrismaClient} from '@prisma/client';
  * import {prismaModelCreateOmitId, PrismaKeyedModelCreate} from '@augment-vir/common';
  *
  * export const mockUsers = {
@@ -66,8 +66,8 @@ export declare const prismaModelCreateOmitId: unique symbol;
  * @example
  *
  * ```ts
- * import type {PrismaClient} from '@prisma/client';
- * import type {PrismaModelCreate} from '@augment-vir/common';
+ * import {type PrismaClient} from '@prisma/client';
+ * import {type PrismaModelCreate} from '@augment-vir/common';
  *
  * function doThing(entry: PrismaModelCreate<PrismaClient, 'User'>) {}
  * ```
@@ -89,7 +89,7 @@ export type PrismaModelCreate<PrismaClient extends BasePrismaClient, Model exten
  *
  * ```ts
  * import {PrismaKeyedModelCreate} from '@augment-vir/common';
- * import type {PrismaClient} from '@prisma/client';
+ * import {type PrismaClient} from '@prisma/client';
  *
  * const mockUsers = {
  *     mockUser1: {
@@ -121,7 +121,7 @@ export type PrismaKeyedModelCreate<PrismaClient extends BasePrismaClient, Model
  *
  * ```ts
  * import {PrismaKeyedModelCreate} from '@augment-vir/common';
- * import type {PrismaClient} from '@prisma/client';
+ * import {type PrismaClient} from '@prisma/client';
  *
  * const mockData: ModelCreateData<PrismaClient> = {
  *     user: {

package/dist/augments/prisma/prisma-model-create.js

@@ -7,7 +7,7 @@
  * @example
  *
  * ```ts
- * import type {PrismaClient} from '@prisma/client';
+ * import {type PrismaClient} from '@prisma/client';
  * import {prismaModelCreateExclude, PrismaKeyedModelCreate} from '@augment-vir/common';
  *
  * export const mockUsers = {
@@ -36,7 +36,7 @@ export const prismaModelCreateExclude = Symbol('prisma-model-create-exclude');
  * @example
  *
  * ```ts
- * import type {PrismaClient} from '@prisma/client';
+ * import {type PrismaClient} from '@prisma/client';
  * import {prismaModelCreateOmitId, PrismaKeyedModelCreate} from '@augment-vir/common';
  *
  * export const mockUsers = {

package/dist/augments/prisma/prisma-model-name.d.ts

@@ -1,4 +1,4 @@
-import { BasePrismaClient } from './base-prisma-types.js';
+import { type BasePrismaClient } from './base-prisma-types.js';
 /**
  * Extracts all model names from a generated `PrismaClient`.
  *
@@ -7,8 +7,8 @@ import { BasePrismaClient } from './base-prisma-types.js';
  * @example
  *
  * ```ts
- * import type {PrismaClient} from '@prisma/client';
- * import type {PrismaModelName} from '@augment-vir/common';
+ * import {type PrismaClient} from '@prisma/client';
+ * import {type PrismaModelName} from '@augment-vir/common';
  *
  * function doThing(modelName: PrismaModelName<PrismaClient>) {}
  * ```

package/dist/augments/promise/promise-object.d.ts

@@ -1,4 +1,4 @@
-import type { AnyObject } from '@augment-vir/core';
+import { type AnyObject } from '@augment-vir/core';
 /**
  * Awaits all Promise properties inside of the given object and wraps them all in a single promise.
  * This is akin to `Promise.all` but for an object instead of an array.

package/dist/augments/promise/promise-queue.d.ts

@@ -1,5 +1,5 @@
 import { DeferredPromise, type MaybePromise } from '@augment-vir/core';
-import type { RequireExactlyOne } from 'type-fest';
+import { type RequireExactlyOne } from 'type-fest';
 import { ListenTarget } from 'typed-event-target';
 /**
  * An individual item in a {@link PromiseQueue} instance.

package/dist/augments/promise/timed-promise.d.ts

@@ -1,5 +1,5 @@
 import { type MaybePromise } from '@augment-vir/core';
-import { AnyDuration } from '@date-vir/duration';
+import { type AnyDuration } from '@date-vir/duration';
 /**
  * An error thrown by {@link wrapPromiseInTimeout} when the timeout is reached.
  *

package/dist/augments/random/seeded-random.d.ts

@@ -0,0 +1,57 @@
+/**
+ * A class that produces deterministic, pseudo random numbers based on a given seed. This uses the
+ * Alea v0.9 algorithm from Johannes Baagøe.
+ *
+ * @category Random : Util
+ * @category Package : @augment-vir/common
+ * @package [`@augment-vir/common`](https://www.npmjs.com/package/@augment-vir/common)
+ */
+export type SeededRandomState = [number, number, number, number];
+/**
+ * A class that produces deterministic, pseudo random numbers based on a given seed. This uses the
+ * Alea v0.9 algorithm from Johannes Baagøe.
+ *
+ * @category Random
+ * @category Package : @augment-vir/common
+ * @example
+ *
+ * ```ts
+ * import {SeededRandom} from '@augment-vir/common';
+ *
+ * const random = SeededRandom.fromSeed('hello there');
+ * console.info(random.next()); // this value will always be the same
+ *
+ * const random2 = SeededRandom.fromState(random.exportState());
+ * console.info(random.next(), random2.next()); // both of these values will always be identical
+ *
+ * const random3 = random2.clone();
+ * console.info(random.next(), random2.next(), random3.next()); // all of these values will always be identical
+ * ```
+ *
+ * @package [`@augment-vir/common`](https://www.npmjs.com/package/@augment-vir/common)
+ */
+export declare class SeededRandom {
+    private readonly alea;
+    /** Generate a new {@link SeededRandom} instance from a seed. */
+    static fromSeed(seed: string | number): SeededRandom;
+    /** Generate a new {@link SeededRandom} instance from a specific state. */
+    static fromState(state: SeededRandomState): SeededRandom;
+    /**
+     * Exports the current state of the seeded random number generator so it can be cloned to
+     * another instance. Use {@link SeededRandom.fromState} to consume this state.
+     */
+    exportState(): SeededRandomState;
+    /**
+     * This constructor is private. Use {@link SeededRandom.fromSeed} or
+     * {@link SeededRandom.fromState} instead.
+     */
+    private constructor();
+    /** Generates the next deterministic pseudo random number. */
+    next(): number;
+    /**
+     * Create a {@link SeededRandom} copy with the same state as this one. This is the same as
+     * calling {@link SeededRandom.exportState} and passing it directly into
+     * {@link SeededRandom.fromState}.
+     */
+    clone(): SeededRandom;
+}

package/dist/augments/random/seeded-random.js

@@ -0,0 +1,140 @@
+/**
+ * A class that produces deterministic, pseudo random numbers based on a given seed. This uses the
+ * Alea v0.9 algorithm from Johannes Baagøe.
+ *
+ * @category Random
+ * @category Package : @augment-vir/common
+ * @example
+ *
+ * ```ts
+ * import {SeededRandom} from '@augment-vir/common';
+ *
+ * const random = SeededRandom.fromSeed('hello there');
+ * console.info(random.next()); // this value will always be the same
+ *
+ * const random2 = SeededRandom.fromState(random.exportState());
+ * console.info(random.next(), random2.next()); // both of these values will always be identical
+ *
+ * const random3 = random2.clone();
+ * console.info(random.next(), random2.next(), random3.next()); // all of these values will always be identical
+ * ```
+ *
+ * @package [`@augment-vir/common`](https://www.npmjs.com/package/@augment-vir/common)
+ */
+export class SeededRandom {
+    alea;
+    /** Generate a new {@link SeededRandom} instance from a seed. */
+    static fromSeed(seed) {
+        return new SeededRandom(new AleaRandom(seed));
+    }
+    /** Generate a new {@link SeededRandom} instance from a specific state. */
+    static fromState(state) {
+        const alea = new AleaRandom('');
+        alea.importState(state);
+        return new SeededRandom(alea);
+    }
+    /**
+     * Exports the current state of the seeded random number generator so it can be cloned to
+     * another instance. Use {@link SeededRandom.fromState} to consume this state.
+     */
+    exportState() {
+        return this.alea.exportState();
+    }
+    /**
+     * This constructor is private. Use {@link SeededRandom.fromSeed} or
+     * {@link SeededRandom.fromState} instead.
+     */
+    constructor(alea) {
+        this.alea = alea;
+    }
+    /** Generates the next deterministic pseudo random number. */
+    next() {
+        return this.alea.next();
+    }
+    /**
+     * Create a {@link SeededRandom} copy with the same state as this one. This is the same as
+     * calling {@link SeededRandom.exportState} and passing it directly into
+     * {@link SeededRandom.fromState}.
+     */
+    clone() {
+        return SeededRandom.fromState(this.exportState());
+    }
+}
+/**
+ * Alea algorithm has the following license from http://baagoe.com/en/RandomMusings/javascript. The
+ * code has been modified to fit into a class structure and simplify code flow and arguments. The
+ * algorithm itself has not changed.
+ *
+ * Copyright (C) 2010 by Johannes Baagøe (baagoe@baagoe.org)
+ *
+ * Permission is hereby granted, free of charge, to any person obtaining a copy of this software and
+ * associated documentation files (the "Software"), to deal in the Software without restriction,
+ * including without limitation the rights to use, copy, modify, merge, publish, distribute,
+ * sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is
+ * furnished to do so, subject to the following conditions:
+ *
+ * The above copyright notice and this permission notice shall be included in all copies or
+ * substantial portions of the Software.
+ *
+ * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT
+ * NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
+ * NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM,
+ * DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+ * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
+ */
+/** Alea v0.9 */
+class AleaRandom {
+    n = 0xef_c8_24_9d;
+    s = [
+        this.mash(' '),
+        this.mash(' '),
+        this.mash(' '),
+        1,
+    ];
+    /** Mash v0.9. */
+    mash(input) {
+        const data = input.toString();
+        for (let i = 0; i < data.length; i++) {
+            // eslint-disable-next-line @typescript-eslint/no-non-null-assertion
+            this.n += data.codePointAt(i);
+            let h = 0.025_196_032_824_169_38 * this.n;
+            this.n = h >>> 0;
+            h -= this.n;
+            h *= this.n;
+            this.n = h >>> 0;
+            h -= this.n;
+            this.n += h * 0x1_00_00_00_00; // 2^32
+        }
+        return (this.n >>> 0) * 2.328_306_436_538_696_3e-10; // 2^-32
+    }
+    constructor(seed) {
+        this.s[0] -= this.mash(seed);
+        if (this.s[0] < 0) {
+            this.s[0] += 1;
+        }
+        this.s[1] -= this.mash(seed);
+        if (this.s[1] < 0) {
+            this.s[1] += 1;
+        }
+        this.s[2] -= this.mash(seed);
+        /* node:coverage ignore next 3: I don't care if we don't cover this */
+        if (this.s[2] < 0) {
+            this.s[2] += 1;
+        }
+    }
+    next() {
+        const t = 2_091_639 * this.s[0] + this.s[3] * 2.328_306_436_538_696_3e-10; // 2^-32
+        this.s[0] = this.s[1];
+        this.s[1] = this.s[2];
+        // eslint-disable-next-line sonarjs/no-nested-assignment
+        return (this.s[2] = t - (this.s[3] = t | 0));
+    }
+    importState(state) {
+        this.s = state;
+    }
+    exportState() {
+        return [
+            ...this.s,
+        ];
+    }
+}

package/dist/augments/selection-set/select-collapsed.d.ts

@@ -1,8 +1,8 @@
-import type { AnyObject, Values } from '@augment-vir/core';
-import { ExcludeEmpty } from '../object/empty.js';
-import { KeyCount } from '../object/key-count.js';
-import { TsRecurse, TsRecursionStart, TsRecursionTracker, TsTooMuchRecursion } from '../type/type-recursion.js';
-import { GenericSelectionSet, SelectFrom, SelectionSet } from './selection-set.js';
+import { type AnyObject, type Values } from '@augment-vir/core';
+import { type ExcludeEmpty } from '../object/empty.js';
+import { type KeyCount } from '../object/key-count.js';
+import { type TsRecurse, type TsRecursionStart, type TsRecursionTracker, type TsTooMuchRecursion } from '../type/type-recursion.js';
+import { type GenericSelectionSet, type SelectFrom, type SelectionSet } from './selection-set.js';
 /**
  * The same as {@link selectFrom} except that the final output is collapsed until the first nested
  * value that has more than 1 key or that is not an object.

package/dist/augments/selection-set/select-from.d.ts

@@ -1,5 +1,5 @@
-import type { AnyObject } from '@augment-vir/core';
-import { SelectFrom, SelectionSet } from './selection-set.js';
+import { type AnyObject } from '@augment-vir/core';
+import { type SelectFrom, type SelectionSet } from './selection-set.js';
 /**
  * Determine if the given input should be preserved in the selection output, meaning it won't be
  * recursed into.

package/dist/augments/string/casing/capitalization.d.ts

@@ -1,4 +1,4 @@
-import { CasingOptions } from './casing.js';
+import { type CasingOptions } from './casing.js';
 /**
  * Capitalize the first letter of the input _only if_ the given options specifies doing so.
  *

package/dist/augments/string/casing/casing.d.ts

@@ -1,4 +1,4 @@
-import { PartialWithUndefined } from '@augment-vir/core';
+import { type PartialWithUndefined } from '@augment-vir/core';
 /**
  * Options for casing functions in `@augment-vir/common`.
  *

package/dist/augments/string/casing/kebab-and-camel.d.ts

@@ -1,4 +1,4 @@
-import { CasingOptions } from './casing.js';
+import { type CasingOptions } from './casing.js';
 /**
  * Converts a kebab-case string to CamelCase.
  *

package/dist/augments/string/split.d.ts

@@ -1,4 +1,4 @@
-import type { AtLeastTuple } from '@augment-vir/core';
+import { type AtLeastTuple } from '@augment-vir/core';
 /**
  * Same as *
  * [`''.split`](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/String/split)

package/dist/augments/string/white-space.d.ts

@@ -1,4 +1,4 @@
-import { PartialWithUndefined } from '@augment-vir/core';
+import { type PartialWithUndefined } from '@augment-vir/core';
 /**
  * Collapse all consecutive white space into just one space and trim surrounding whitespace.
  * Optionally, collapsed newlines can be preserved.

package/dist/augments/type/type-recursion.d.ts

@@ -160,11 +160,11 @@ type TsRecursionArray = [
  * @example
  *
  * ```ts
- * import type {
- *     TsRecursionTracker,
- *     TsRecursionStart,
- *     TsRecurse,
- *     TsTooMuchRecursion,
+ * import {
+ *     type TsRecursionTracker,
+ *     type TsRecursionStart,
+ *     type TsRecurse,
+ *     type TsTooMuchRecursion,
  * } from '@augment-vir/common';
  *
  * export type SomeType<Depth extends TsRecursionTracker = TsRecursionStart> =
@@ -185,11 +185,11 @@ export type TsRecursionTracker = keyof TsRecursionArray;
  * @example
  *
  * ```ts
- * import type {
- *     TsRecursionTracker,
- *     TsRecursionStart,
- *     TsRecurse,
- *     TsTooMuchRecursion,
+ * import {
+ *     type TsRecursionTracker,
+ *     type TsRecursionStart,
+ *     type TsRecurse,
+ *     type TsTooMuchRecursion,
  * } from '@augment-vir/common';
  *
  * export type SomeType<Depth extends TsRecursionTracker = TsRecursionStart> =
@@ -210,11 +210,11 @@ export type TsTooMuchRecursion = 91;
  * @example
  *
  * ```ts
- * import type {
- *     TsRecursionTracker,
- *     TsRecursionStart,
- *     TsRecurse,
- *     TsTooMuchRecursion,
+ * import {
+ *     type TsRecursionTracker,
+ *     type TsRecursionStart,
+ *     type TsRecurse,
+ *     type TsTooMuchRecursion,
  * } from '@augment-vir/common';
  *
  * export type SomeType<Depth extends TsRecursionTracker = TsRecursionStart> =
@@ -234,11 +234,11 @@ export type TsRecursionStart = 0;
  * @example
  *
  * ```ts
- * import type {
- *     TsRecursionTracker,
- *     TsRecursionStart,
- *     TsRecurse,
- *     TsTooMuchRecursion,
+ * import {
+ *     type TsRecursionTracker,
+ *     type TsRecursionStart,
+ *     type TsRecurse,
+ *     type TsTooMuchRecursion,
  * } from '@augment-vir/common';
  *
  * export type SomeType<Depth extends TsRecursionTracker = TsRecursionStart> =

package/dist/augments/type/writable.d.ts

@@ -1,4 +1,4 @@
-import type { Writable } from 'type-fest';
+import { type Writable } from 'type-fest';
 export type { Writable, WritableDeep } from 'type-fest';
 /**
  * This function does nothing but return the input as a writable typed version of itself.

package/dist/index.d.ts

@@ -61,6 +61,7 @@ export * from './augments/promise/timed-promise.js';
 export * from './augments/random/random-boolean.js';
 export * from './augments/random/random-integer.js';
 export * from './augments/random/random-string.js';
+export * from './augments/random/seeded-random.js';
 export * from './augments/regexp/match.js';
 export * from './augments/regexp/regexp-flags.js';
 export * from './augments/regexp/regexp-string.js';

package/dist/index.js

@@ -61,6 +61,7 @@ export * from './augments/promise/timed-promise.js';
 export * from './augments/random/random-boolean.js';
 export * from './augments/random/random-integer.js';
 export * from './augments/random/random-string.js';
+export * from './augments/random/seeded-random.js';
 export * from './augments/regexp/match.js';
 export * from './augments/regexp/regexp-flags.js';
 export * from './augments/regexp/regexp-string.js';

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@augment-vir/common",
-    "version": "31.14.1",
+    "version": "31.15.0",
     "description": "A collection of augments, helpers types, functions, and classes for any JavaScript environment.",
     "keywords": [
         "augment",
@@ -40,8 +40,8 @@
         "test:web": "virmator --no-deps test web"
     },
     "dependencies": {
-        "@augment-vir/assert": "^31.14.1",
-        "@augment-vir/core": "^31.14.1",
+        "@augment-vir/assert": "^31.15.0",
+        "@augment-vir/core": "^31.15.0",
         "@date-vir/duration": "^7.3.1",
         "ansi-styles": "^6.2.1",
         "json5": "^2.2.3",