@augment-vir/common 28.2.3 → 29.0.0

package/dist/cjs/augments/object/typed-has-property.js

@@ -1,6 +1,7 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.typedHasProperties = exports.typedHasProperty = void 0;
+exports.typedHasProperty = typedHasProperty;
+exports.typedHasProperties = typedHasProperties;
 const hasPropertyAttempts = [
     (object, key) => {
         return key in object;
@@ -23,8 +24,6 @@ function typedHasProperty(inputObject, inputKey) {
         }
     });
 }
-exports.typedHasProperty = typedHasProperty;
 function typedHasProperties(inputObject, inputKeys) {
     return inputObject && inputKeys.every((key) => typedHasProperty(inputObject, key));
 }
-exports.typedHasProperties = typedHasProperties;

package/dist/cjs/augments/promise/deferred-promise.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.createDeferredPromiseWrapper = void 0;
+exports.createDeferredPromiseWrapper = createDeferredPromiseWrapper;
 function createDeferredPromiseWrapper() {
     let resolve;
     let reject;
@@ -29,4 +29,3 @@ function createDeferredPromiseWrapper() {
         },
     };
 }
-exports.createDeferredPromiseWrapper = createDeferredPromiseWrapper;

package/dist/cjs/augments/promise/promise.js

@@ -1,6 +1,10 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.executeWithRetries = exports.callAsynchronously = exports.wrapPromiseInTimeout = exports.PromiseTimeoutError = exports.isPromiseLike = void 0;
+exports.PromiseTimeoutError = void 0;
+exports.isPromiseLike = isPromiseLike;
+exports.wrapPromiseInTimeout = wrapPromiseInTimeout;
+exports.callAsynchronously = callAsynchronously;
+exports.executeWithRetries = executeWithRetries;
 const typed_has_property_1 = require("../object/typed-has-property");
 function isPromiseLike(input) {
     if ((0, typed_has_property_1.typedHasProperty)(input, 'then') && typeof input.then === 'function') {
@@ -10,7 +14,6 @@ function isPromiseLike(input) {
         return false;
     }
 }
-exports.isPromiseLike = isPromiseLike;
 class PromiseTimeoutError extends Error {
     constructor(durationMs, message = `Promised timed out after ${durationMs} ms.`) {
         super(message);
@@ -54,7 +57,6 @@ function wrapPromiseInTimeout(durationMs, originalPromise) {
         }
     });
 }
-exports.wrapPromiseInTimeout = wrapPromiseInTimeout;
 /**
  * Call a function asynchronously without interrupting current synchronous execution, even if the
  * function was originally synchronous.
@@ -62,7 +64,6 @@ exports.wrapPromiseInTimeout = wrapPromiseInTimeout;
 async function callAsynchronously(callback) {
     return await Promise.resolve().then(() => callback());
 }
-exports.callAsynchronously = callAsynchronously;
 async function executeWithRetries(retryCount, callback) {
     let currentRetry = 0;
     while (currentRetry < retryCount) {
@@ -76,4 +77,3 @@ async function executeWithRetries(retryCount, callback) {
     }
     throw new Error('Retry max reached.');
 }
-exports.executeWithRetries = executeWithRetries;

package/dist/cjs/augments/promise/wait.js

@@ -1,6 +1,9 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.waitUntilTruthy = exports.defaultWaitUntilDefinedOptions = exports.waitValue = exports.wait = void 0;
+exports.defaultWaitUntilDefinedOptions = void 0;
+exports.wait = wait;
+exports.waitValue = waitValue;
+exports.waitUntilTruthy = waitUntilTruthy;
 const error_1 = require("../error");
 const deferred_promise_1 = require("./deferred-promise");
 function wait(delayMs) {
@@ -12,11 +15,9 @@ function wait(delayMs) {
     }
     return deferredPromiseWrapper.promise;
 }
-exports.wait = wait;
 async function waitValue(delayMs, returnValue) {
     return wait(delayMs).then(() => returnValue);
 }
-exports.waitValue = waitValue;
 exports.defaultWaitUntilDefinedOptions = {
     interval: {
         milliseconds: 100,
@@ -63,4 +64,3 @@ async function waitUntilTruthy(predicate, failureMessage, optionsInput = {}) {
     }
     return lastValue;
 }
-exports.waitUntilTruthy = waitUntilTruthy;

package/dist/cjs/augments/random.js

@@ -1,6 +1,9 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.randomString = exports.createUuid = exports.randomBoolean = exports.randomInteger = void 0;
+exports.randomInteger = randomInteger;
+exports.randomBoolean = randomBoolean;
+exports.createUuid = createUuid;
+exports.randomString = randomString;
 const common_number_1 = require("./common-number");
 function accessCrypto() {
     if (globalThis.crypto) {
@@ -32,7 +35,6 @@ function randomInteger({ min: rawMin, max: rawMax }) {
     } while (value >= cutoff);
     return min + (value % range);
 }
-exports.randomInteger = randomInteger;
 /**
  * Returns true at rate of the percentLikelyToBeTrue input. Inputs should be whole numbers which
  * will be treated like percents. Anything outside of 0-100 inclusively will be clamped. An input 0
@@ -61,12 +63,10 @@ function randomBoolean(percentLikelyToBeTrue = 50) {
             max: 100,
         }));
 }
-exports.randomBoolean = randomBoolean;
 /** Creates a cryptographically secure uuid. */
 function createUuid() {
     return crypto.randomUUID();
 }
-exports.createUuid = createUuid;
 const validStringCharacters = [
     'a',
     'b',
@@ -121,4 +121,3 @@ function randomString(inputLength = 16) {
     }
     return stringBuilder;
 }
-exports.randomString = randomString;

package/dist/cjs/augments/regexp.js

@@ -1,20 +1,19 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.safeMatch = exports.addRegExpFlags = exports.deDupeRegExFlags = void 0;
+exports.deDupeRegExFlags = deDupeRegExFlags;
+exports.addRegExpFlags = addRegExpFlags;
+exports.safeMatch = safeMatch;
 function deDupeRegExFlags(flags) {
     const deDuped = new Set(Array.from(flags.toLowerCase()));
     return Array.from(deDuped).join('');
 }
-exports.deDupeRegExFlags = deDupeRegExFlags;
 function addRegExpFlags(originalRegExp, flags) {
     return new RegExp(originalRegExp.source, deDupeRegExFlags([
         originalRegExp.flags,
         flags,
     ].join('')));
 }
-exports.addRegExpFlags = addRegExpFlags;
 function safeMatch(input, regExp) {
     const match = input.match(regExp);
     return match ?? [];
 }
-exports.safeMatch = safeMatch;

package/dist/cjs/augments/string/prefixes.js

@@ -1,6 +1,7 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.removePrefix = exports.addPrefix = void 0;
+exports.addPrefix = addPrefix;
+exports.removePrefix = removePrefix;
 function addPrefix({ value, prefix, }) {
     if (String(value).startsWith(prefix)) {
         return String(value);
@@ -9,7 +10,6 @@ function addPrefix({ value, prefix, }) {
         return `${prefix}${String(value)}`;
     }
 }
-exports.addPrefix = addPrefix;
 function removePrefix({ value, prefix, }) {
     if (value.startsWith(prefix)) {
         return value.substring(prefix.length);
@@ -18,4 +18,3 @@ function removePrefix({ value, prefix, }) {
         return value;
     }
 }
-exports.removePrefix = removePrefix;

package/dist/cjs/augments/string/suffixes.js

@@ -1,25 +1,27 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.removeSuffix = exports.addSuffix = exports.removePercent = exports.addPercent = exports.removePx = exports.addPx = exports.pxSuffix = exports.percentSuffix = void 0;
+exports.pxSuffix = exports.percentSuffix = void 0;
+exports.addPx = addPx;
+exports.removePx = removePx;
+exports.addPercent = addPercent;
+exports.removePercent = removePercent;
+exports.addSuffix = addSuffix;
+exports.removeSuffix = removeSuffix;
 const common_number_1 = require("../common-number");
 exports.percentSuffix = '%';
 exports.pxSuffix = 'px';
 function addPx(input) {
     return addSuffix({ value: input, suffix: exports.pxSuffix });
 }
-exports.addPx = addPx;
 function removePx(input) {
     return (0, common_number_1.toEnsuredNumber)(removeSuffix({ value: input, suffix: exports.pxSuffix }));
 }
-exports.removePx = removePx;
 function addPercent(input) {
     return addSuffix({ value: input, suffix: exports.percentSuffix });
 }
-exports.addPercent = addPercent;
 function removePercent(input) {
     return (0, common_number_1.toEnsuredNumber)(removeSuffix({ value: input, suffix: exports.percentSuffix }));
 }
-exports.removePercent = removePercent;
 function addSuffix({ value, suffix, }) {
     if (String(value).endsWith(suffix)) {
         return String(value);
@@ -28,7 +30,6 @@ function addSuffix({ value, suffix, }) {
         return `${String(value)}${suffix}`;
     }
 }
-exports.addSuffix = addSuffix;
 function removeSuffix({ value, suffix, }) {
     if (value.endsWith(suffix)) {
         return value.substring(0, value.length - suffix.length);
@@ -37,4 +38,3 @@ function removeSuffix({ value, suffix, }) {
         return value;
     }
 }
-exports.removeSuffix = removeSuffix;

package/dist/cjs/augments/string/uuid.js

@@ -1,8 +1,7 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.isUuid = void 0;
+exports.isUuid = isUuid;
 const uuidRegExp = /[\d\w]{8}-[\d\w]{4}-[\d\w]{4}-[\d\w]{4}-[\d\w]{12}/;
 function isUuid(maybeUuid) {
     return !!maybeUuid.match(uuidRegExp);
 }
-exports.isUuid = isUuid;

package/dist/cjs/augments/time.js

@@ -1,6 +1,7 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.measureCallbackDuration = exports.timeCallback = void 0;
+exports.measureCallbackDuration = void 0;
+exports.timeCallback = timeCallback;
 /**
  * Measures how long (in milliseconds) the given callback takes to run to completion. Automatically
  * switches to async mode and awaits callbacks if they return a promise (otherwise this function is
@@ -24,7 +25,6 @@ function timeCallback(callback) {
     const endTime = Date.now();
     return (endTime - startTime);
 }
-exports.timeCallback = timeCallback;
 /**
  * Measures how long (in milliseconds) the given callback takes to run to completion. Automatically
  * switches to async mode and awaits callbacks if they return a promise (otherwise this function is

package/dist/cjs/augments/truncate-number.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.truncateNumber = void 0;
+exports.truncateNumber = truncateNumber;
 const common_number_1 = require("./common-number");
 const common_string_1 = require("./common-string");
 const regexp_1 = require("./regexp");
@@ -151,4 +151,3 @@ function truncateNumber(originalValue, { customSuffixes = defaultTruncationSuffi
     }
     return truncateBigNumber(numberAsString, customSuffixes, maxLength);
 }
-exports.truncateNumber = truncateNumber;

package/dist/cjs/augments/tuple.js

@@ -1,6 +1,7 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.assertLengthAtLeast = exports.isLengthAtLeast = void 0;
+exports.isLengthAtLeast = isLengthAtLeast;
+exports.assertLengthAtLeast = assertLengthAtLeast;
 function isLengthAtLeast(array, length) {
     try {
         assertLengthAtLeast(array, length);
@@ -10,7 +11,6 @@ function isLengthAtLeast(array, length) {
         return false;
     }
 }
-exports.isLengthAtLeast = isLengthAtLeast;
 function assertLengthAtLeast(array, length, arrayName) {
     if (array.length < length) {
         throw new Error(arrayName
@@ -18,4 +18,3 @@ function assertLengthAtLeast(array, length, arrayName) {
             : `Array is not at least '${length}' in length.`);
     }
 }
-exports.assertLengthAtLeast = assertLengthAtLeast;

package/dist/cjs/augments/type.js

@@ -1,14 +1,15 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.ensureType = exports.wrapNarrowTypeWithTypeCheck = exports.makeReadonly = exports.makeWritable = void 0;
+exports.makeWritable = makeWritable;
+exports.makeReadonly = makeReadonly;
+exports.wrapNarrowTypeWithTypeCheck = wrapNarrowTypeWithTypeCheck;
+exports.ensureType = ensureType;
 function makeWritable(input) {
     return input;
 }
-exports.makeWritable = makeWritable;
 function makeReadonly(input) {
     return input;
 }
-exports.makeReadonly = makeReadonly;
 /**
  * This function returns another function that simply returns whatever input it's given. However, it
  * also checks that the input matches the original wrapNarrowTypeWithTypeCheck's generic, while
@@ -23,7 +24,6 @@ function wrapNarrowTypeWithTypeCheck() {
         return input;
     };
 }
-exports.wrapNarrowTypeWithTypeCheck = wrapNarrowTypeWithTypeCheck;
 /**
  * This is a type helper that ensures the given input matches the given generic type. The generic is
  * setup in such a way that if it is omitted (which is typically allowed in TypeScript, resulting in
@@ -34,4 +34,3 @@ exports.wrapNarrowTypeWithTypeCheck = wrapNarrowTypeWithTypeCheck;
 function ensureType(input) {
     return input;
 }
-exports.ensureType = ensureType;

package/dist/cjs/augments/union.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/cjs/augments/wrap-in-try.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.wrapInTry = void 0;
+exports.wrapInTry = wrapInTry;
 const run_time_assertions_1 = require("run-time-assertions");
 const error_1 = require("./error");
 function wrapInTry(callback, options = {}) {
@@ -35,4 +35,3 @@ function wrapInTry(callback, options = {}) {
         }
     }
 }
-exports.wrapInTry = wrapInTry;

package/dist/cjs/index.js

@@ -34,14 +34,14 @@ __exportStar(require("./augments/object/filter-object"), exports);
 __exportStar(require("./augments/object/get-or-set"), exports);
 __exportStar(require("./augments/object/has-key"), exports);
 __exportStar(require("./augments/object/jsonify"), exports);
+__exportStar(require("./augments/object/key-count"), exports);
 __exportStar(require("./augments/object/map-object"), exports);
 __exportStar(require("./augments/object/merge-deep"), exports);
 __exportStar(require("./augments/object/merge-property-arrays"), exports);
-__exportStar(require("./augments/object/nested-keys"), exports);
 __exportStar(require("./augments/object/object"), exports);
 __exportStar(require("./augments/object/object-entries"), exports);
-__exportStar(require("./augments/object/old-union-to-intersection"), exports);
 __exportStar(require("./augments/object/pick-deep"), exports);
+__exportStar(require("./augments/object/selection-set"), exports);
 __exportStar(require("./augments/object/typed-has-property"), exports);
 __exportStar(require("./augments/promise/deferred-promise"), exports);
 __exportStar(require("./augments/promise/promise"), exports);
@@ -56,4 +56,5 @@ __exportStar(require("./augments/truncate-number"), exports);
 __exportStar(require("./augments/tuple"), exports);
 __exportStar(require("./augments/type"), exports);
 __exportStar(require("./augments/type-recursion"), exports);
+__exportStar(require("./augments/union"), exports);
 __exportStar(require("./augments/wrap-in-try"), exports);

package/dist/esm/augments/object/selection-set.js

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

package/dist/esm/augments/union.js

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

package/dist/esm/index.js

@@ -18,14 +18,14 @@ export * from './augments/object/filter-object';
 export * from './augments/object/get-or-set';
 export * from './augments/object/has-key';
 export * from './augments/object/jsonify';
+export * from './augments/object/key-count';
 export * from './augments/object/map-object';
 export * from './augments/object/merge-deep';
 export * from './augments/object/merge-property-arrays';
-export * from './augments/object/nested-keys';
 export * from './augments/object/object';
 export * from './augments/object/object-entries';
-export * from './augments/object/old-union-to-intersection';
 export * from './augments/object/pick-deep';
+export * from './augments/object/selection-set';
 export * from './augments/object/typed-has-property';
 export * from './augments/promise/deferred-promise';
 export * from './augments/promise/promise';
@@ -40,4 +40,5 @@ export * from './augments/truncate-number';
 export * from './augments/tuple';
 export * from './augments/type';
 export * from './augments/type-recursion';
+export * from './augments/union';
 export * from './augments/wrap-in-try';

package/dist/types/augments/object/key-count.d.ts

@@ -0,0 +1,13 @@
+import { UnionToIntersection } from '../union';
+import { AnyObject } from './any-object';
+/**
+ * This is not exported because its order is not stable but it's okay for our simple use case where
+ * we simply want to count the size of the union.
+ */
+type UnionToTuple<T> = UnionToIntersection<T extends any ? (t: T) => T : never> extends (args: any) => infer W ? [...UnionToTuple<Exclude<T, W>>, W] : [];
+/**
+ * Counts the number of unique keys in an object type. Note that a key of just `string` will count
+ * as 1.
+ */
+export type KeyCount<T extends AnyObject> = UnionToTuple<keyof T>['length'];
+export {};

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

@@ -12,7 +12,7 @@ export type MappedValues<EntireInputGeneric extends object, MappedValueGeneric>
  * @example
  *     mapObjectValuesSync({objectToIterateOver: 'initial value'})(callback);
  */
-export declare function mapObjectValuesSync<EntireInputGeneric extends object>(inputObject: EntireInputGeneric): <OutputObjectGeneric extends object>(mapCallback: (inputKey: keyof EntireInputGeneric, keyValue: EntireInputGeneric[keyof EntireInputGeneric], fullObject: EntireInputGeneric) => never extends PropertyValueType<OutputObjectGeneric> ? any : PropertyValueType<OutputObjectGeneric>) => OutputObjectGeneric;
+export declare function mapObjectValuesSync<EntireInputGeneric extends object>(inputObject: EntireInputGeneric): <OutputObjectGeneric extends object>(mapCallback: (inputKey: keyof EntireInputGeneric, keyValue: EntireInputGeneric[typeof inputKey], fullObject: EntireInputGeneric) => never extends PropertyValueType<OutputObjectGeneric> ? any : PropertyValueType<OutputObjectGeneric>) => OutputObjectGeneric;
 /**
  * Creates a new object with the same properties as the input object, but with values set to the
  * result of mapCallback for each property.

package/dist/types/augments/object/pick-deep.d.ts

@@ -3,18 +3,12 @@ import { AnyFunction } from '../function';
 import { ArrayElement } from '../type';
 import { TsRecurse, TsRecursionStart, TsRecursionTracker } from '../type-recursion';
 import { AnyObject } from './any-object';
-import { NestedKeys } from './nested-keys';
 export type InnerPickDeep<OriginalObject extends AnyObject, DeepKeys extends any[], Depth extends TsRecursionTracker> = DeepKeys extends [infer CurrentLevelPick, ...infer RemainingKeys] ? Extract<CurrentLevelPick, keyof OriginalObject> extends never ? OriginalObject : {
     [CurrentProp in Extract<CurrentLevelPick, RequiredKeysOf<OriginalObject>>]: InnerPickDeepValue<OriginalObject, CurrentProp, RemainingKeys, Depth>;
 } & {
     [CurrentProp in Extract<CurrentLevelPick, OptionalKeysOf<OriginalObject>>]?: InnerPickDeepValue<OriginalObject, CurrentProp, RemainingKeys, Depth>;
 } : DeepKeys extends [] ? OriginalObject : DeepKeys extends [infer CurrentLevelPick] ? CurrentLevelPick extends keyof OriginalObject ? Pick<OriginalObject, CurrentLevelPick> : never : never;
 type InnerPickDeepValue<OriginalObject, CurrentProp extends keyof OriginalObject, RemainingKeys extends any[], Depth extends TsRecursionTracker> = AnyFunction extends Extract<OriginalObject[CurrentProp], AnyFunction> ? OriginalObject[CurrentProp] | Exclude<OriginalObject[CurrentProp], AnyFunction> : Array<any> extends Extract<OriginalObject[CurrentProp], Array<any>> ? Array<InnerPickDeep<ArrayElement<Extract<OriginalObject[CurrentProp], Array<any>>>, RemainingKeys, TsRecurse<Depth>>> | Exclude<OriginalObject[CurrentProp], Array<any>> : ReadonlyArray<any> extends Extract<OriginalObject[CurrentProp], ReadonlyArray<any>> ? ReadonlyArray<InnerPickDeep<ArrayElement<Extract<OriginalObject[CurrentProp], ReadonlyArray<any>>>, RemainingKeys, TsRecurse<Depth>>> | Exclude<OriginalObject[CurrentProp], ReadonlyArray<any>> : Extract<OriginalObject[CurrentProp], Record<any, any>> extends never ? OriginalObject[CurrentProp] : InnerPickDeep<Extract<OriginalObject[CurrentProp], Record<any, any>>, RemainingKeys, TsRecurse<Depth>> | Exclude<OriginalObject[CurrentProp], Record<any, any>>;
-/**
- * Pick nested keys with more strict type parameter requirements. However, these stricter type
- * parameter requirements often lead to "excessively deep" TS compiler errors.
- */
-export type PickDeepStrict<OriginalObject extends object, DeepKeys extends NestedKeys<OriginalObject>> = InnerPickDeep<OriginalObject, DeepKeys, TsRecursionStart>;
 /** Pick nested keys. */
 export type PickDeep<OriginalObject extends object, DeepKeys extends PropertyKey[]> = InnerPickDeep<OriginalObject, DeepKeys, TsRecursionStart>;
 export {};

package/dist/types/augments/object/selection-set.d.ts

@@ -0,0 +1,25 @@
+import { IsNever, Primitive } from 'type-fest';
+import { TsRecurse, TsRecursionStart, TsRecursionTracker, TsTooMuchRecursion } from '../type-recursion';
+import { UnionToIntersection } from '../union';
+import { AnyObject } from './any-object';
+import { KeyCount } from './key-count';
+import { PropertyValueType } from './object';
+/** All types that won't be recursed into when defining a {@link SelectionSet}. */
+export type SelectionTypesToPreserve = Primitive | RegExp;
+/** A generic selection set without specific keys. */
+export type GenericSelectionSet = {
+    [Key in PropertyKey]: boolean | GenericSelectionSet;
+};
+/** Masks an object value with the given {@link SelectionSet}. */
+export type PickSelection<Full extends Readonly<AnyObject>, Selection extends GenericSelectionSet, Depth extends TsRecursionTracker = TsRecursionStart> = Depth extends TsTooMuchRecursion ? ['Error: recursive object depth is too deep.'] : Full extends ReadonlyArray<infer Element extends any> ? (PickSelection<Extract<Element, AnyObject>, Selection, TsRecurse<Depth>> | Exclude<Element, AnyObject>)[] : {
+    [Key in keyof Selection as Selection[Key] extends false ? never : Key extends keyof Full ? Key : never]: (Selection[Key] extends GenericSelectionSet ? PickSelection<NonNullable<Extract<Full[Key], AnyObject>>, Selection[Key], TsRecurse<Depth>> : Full[Key]) | Exclude<Full[Key], AnyObject>;
+};
+/**
+ * Collapses a selected value to the first part of the selection that contains more than 1 key or
+ * that is not an object.
+ */
+export type FirstSelectedValue<Full extends Readonly<AnyObject>, Selection extends GenericSelectionSet, Depth extends TsRecursionTracker = TsRecursionStart> = Depth extends TsTooMuchRecursion ? 'Error: recursive object depth is too deep.' : KeyCount<PickSelection<Full, Selection, Depth>> extends 1 ? Selection[keyof PickSelection<Full, Selection, Depth>] extends GenericSelectionSet ? FirstSelectedValue<Full[keyof PickSelection<Full, Selection, Depth>], Selection[keyof PickSelection<Full, Selection, Depth>], TsRecurse<Depth>> : PropertyValueType<PickSelection<Full, Selection, Depth>> : PickSelection<Full, Selection, Depth>;
+/** Defines a selection set for the given object. */
+export type SelectionSet<Full extends Readonly<AnyObject>, Depth extends TsRecursionTracker = TsRecursionStart> = Depth extends TsTooMuchRecursion ? ['Error: recursive object depth is too deep.'] : Full extends ReadonlyArray<infer FullChild extends AnyObject> ? SelectionSet<FullChild, TsRecurse<Depth>> : Partial<{
+    [Key in keyof Full]: IsNever<Exclude<Full[Key], SelectionTypesToPreserve>> extends true ? boolean : boolean | UnionToIntersection<SelectionSet<Full[Key], TsRecurse<Depth>>>;
+}>;

package/dist/types/index.d.ts

@@ -18,14 +18,14 @@ export * from './augments/object/filter-object';
 export * from './augments/object/get-or-set';
 export * from './augments/object/has-key';
 export * from './augments/object/jsonify';
+export * from './augments/object/key-count';
 export * from './augments/object/map-object';
 export * from './augments/object/merge-deep';
 export * from './augments/object/merge-property-arrays';
-export * from './augments/object/nested-keys';
 export * from './augments/object/object';
 export * from './augments/object/object-entries';
-export * from './augments/object/old-union-to-intersection';
 export * from './augments/object/pick-deep';
+export * from './augments/object/selection-set';
 export * from './augments/object/typed-has-property';
 export * from './augments/promise/deferred-promise';
 export * from './augments/promise/promise';
@@ -40,4 +40,5 @@ export * from './augments/truncate-number';
 export * from './augments/tuple';
 export * from './augments/type';
 export * from './augments/type-recursion';
+export * from './augments/union';
 export * from './augments/wrap-in-try';

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@augment-vir/common",
-    "version": "28.2.3",
+    "version": "29.0.0",
     "homepage": "https://github.com/electrovir/augment-vir/tree/main/packages/common",
     "bugs": {
         "url": "https://github.com/electrovir/augment-vir/issues"
@@ -29,7 +29,7 @@
         "type-fest": "^4.20.1"
     },
     "devDependencies": {
-        "typescript": "5.4.5"
+        "typescript": "5.5.2"
     },
     "publishConfig": {
         "access": "public"

package/dist/cjs/augments/object/nested-keys.js

@@ -1,61 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.getValueFromNestedKeys = exports.setValueWithNestedKeys = void 0;
-const run_time_assertions_1 = require("run-time-assertions");
-const tuple_1 = require("../tuple");
-const object_1 = require("./object");
-const typed_has_property_1 = require("./typed-has-property");
-/** This mutates the {@link originalObject} input. */
-function setValueWithNestedKeys(originalObject, nestedKeys, value) {
-    /**
-     * Lots of as any casts in here because these types are, under the hood, pretty complex. Since
-     * the inputs and outputs of this function are well typed, these internal as any casts do not
-     * affect the external API of this function.
-     */
-    const nestedKeysInput = nestedKeys;
-    const inputObject = originalObject;
-    if ((0, run_time_assertions_1.isRunTimeType)(inputObject, 'array')) {
-        inputObject.forEach((entry) => {
-            if ((0, object_1.isObject)(entry)) {
-                setValueWithNestedKeys(entry, nestedKeysInput, value);
-            }
-        });
-    }
-    else if ((0, tuple_1.isLengthAtLeast)(nestedKeysInput, 2)) {
-        /** If there are more keys to traverse into. */
-        const nextKey = nestedKeysInput[0];
-        if (!(nextKey in inputObject)) {
-            inputObject[nextKey] = {};
-        }
-        const nextParent = inputObject[nextKey];
-        setValueWithNestedKeys(nextParent, nestedKeysInput.slice(1), value);
-    }
-    else if ((0, tuple_1.isLengthAtLeast)(nestedKeysInput, 1)) {
-        inputObject[nestedKeysInput[0]] = value;
-    }
-}
-exports.setValueWithNestedKeys = setValueWithNestedKeys;
-function getValueFromNestedKeys(originalObject, nestedKeys) {
-    /**
-     * Lots of as any casts in here because these types are, under the hood, pretty complex. Since
-     * the inputs and outputs of this function are well typed, these internal as any casts do not
-     * affect the external API of this function.
-     */
-    const nestedKeysInput = nestedKeys;
-    const inputObject = originalObject;
-    if ((0, run_time_assertions_1.isRunTimeType)(inputObject, 'array')) {
-        return inputObject.map((entry) => getValueFromNestedKeys(entry, nestedKeys));
-    }
-    const keyToAccess = nestedKeysInput[0];
-    if (!(0, typed_has_property_1.typedHasProperty)(inputObject, keyToAccess)) {
-        return undefined;
-    }
-    const currentValue = inputObject[keyToAccess];
-    if (nestedKeysInput.length > 1) {
-        return getValueFromNestedKeys(currentValue, nestedKeysInput.slice(1));
-    }
-    else {
-        return currentValue;
-    }
-}
-exports.getValueFromNestedKeys = getValueFromNestedKeys;

package/dist/esm/augments/object/nested-keys.js

@@ -1,56 +0,0 @@
-import { isRunTimeType } from 'run-time-assertions';
-import { isLengthAtLeast } from '../tuple';
-import { isObject } from './object';
-import { typedHasProperty } from './typed-has-property';
-/** This mutates the {@link originalObject} input. */
-export function setValueWithNestedKeys(originalObject, nestedKeys, value) {
-    /**
-     * Lots of as any casts in here because these types are, under the hood, pretty complex. Since
-     * the inputs and outputs of this function are well typed, these internal as any casts do not
-     * affect the external API of this function.
-     */
-    const nestedKeysInput = nestedKeys;
-    const inputObject = originalObject;
-    if (isRunTimeType(inputObject, 'array')) {
-        inputObject.forEach((entry) => {
-            if (isObject(entry)) {
-                setValueWithNestedKeys(entry, nestedKeysInput, value);
-            }
-        });
-    }
-    else if (isLengthAtLeast(nestedKeysInput, 2)) {
-        /** If there are more keys to traverse into. */
-        const nextKey = nestedKeysInput[0];
-        if (!(nextKey in inputObject)) {
-            inputObject[nextKey] = {};
-        }
-        const nextParent = inputObject[nextKey];
-        setValueWithNestedKeys(nextParent, nestedKeysInput.slice(1), value);
-    }
-    else if (isLengthAtLeast(nestedKeysInput, 1)) {
-        inputObject[nestedKeysInput[0]] = value;
-    }
-}
-export function getValueFromNestedKeys(originalObject, nestedKeys) {
-    /**
-     * Lots of as any casts in here because these types are, under the hood, pretty complex. Since
-     * the inputs and outputs of this function are well typed, these internal as any casts do not
-     * affect the external API of this function.
-     */
-    const nestedKeysInput = nestedKeys;
-    const inputObject = originalObject;
-    if (isRunTimeType(inputObject, 'array')) {
-        return inputObject.map((entry) => getValueFromNestedKeys(entry, nestedKeys));
-    }
-    const keyToAccess = nestedKeysInput[0];
-    if (!typedHasProperty(inputObject, keyToAccess)) {
-        return undefined;
-    }
-    const currentValue = inputObject[keyToAccess];
-    if (nestedKeysInput.length > 1) {
-        return getValueFromNestedKeys(currentValue, nestedKeysInput.slice(1));
-    }
-    else {
-        return currentValue;
-    }
-}