@zayne-labs/toolkit-type-helpers 0.9.46 → 0.9.47

package/dist/esm/index.d.ts

@@ -1,8 +1,7 @@
-type Prettify<TObject> = NonNullable<unknown> & {
-    [Key in keyof TObject]: TObject[Key];
-};
+//#region src/type-utils/common.d.ts
+type Prettify<TObject> = NonNullable<unknown> & { [Key in keyof TObject]: TObject[Key] };
 type UnmaskType<TType> = {
-    _: TType;
+  _: TType;
 }["_"];
 type NonFalsy<TType> = TType extends "" | 0 | 0n | false | null | undefined ? never : TType;
 type PrettyOmit<TObject, Key extends keyof TObject> = Prettify<Omit<TObject, Key>>;
@@ -30,7 +29,12 @@ type AnyString = string & Record<never, never>;
  */
 type AnyNumber = number & Record<never, never>;
 type LiteralUnion<TUnion extends TBase, TBase = string> = TUnion | (TBase & Record<never, never>);
+type Expect<TType extends true> = TType;
+type GetGenericFn<TType> = <TGenericFnParam>() => TGenericFnParam extends TType ? true : false;
+type Equal<TTypeOne, TTypeTwo> = GetGenericFn<TTypeOne> extends GetGenericFn<TTypeTwo> ? true : false;
 
+//#endregion
+//#region src/type-utils/writeable.d.ts
 type ArrayOrObject = Record<number | string | symbol, unknown> | unknown[];
 type WriteableLevel = "deep" | "shallow";
 /**
@@ -39,16 +43,10 @@ type WriteableLevel = "deep" | "shallow";
  * @template TObject - The object type to make writeable
  * @template TVariant - The level of writeable transformation ("shallow" | "deep")
  */
-type Writeable<TObject, TLevel extends WriteableLevel = "shallow"> = TObject extends readonly [
-    ...infer TTupleItems
-] ? [
-    ...{
-        [Index in keyof TTupleItems]: TLevel extends "deep" ? Writeable<TTupleItems[Index], "deep"> : TTupleItems[Index];
-    }
-] : TObject extends ArrayOrObject ? {
-    -readonly [Key in keyof TObject]: TLevel extends "deep" ? Writeable<TObject[Key], "deep"> : TObject[Key];
-} : TObject;
+type Writeable<TObject, TLevel extends WriteableLevel = "shallow"> = TObject extends readonly [...infer TTupleItems] ? [...{ [Index in keyof TTupleItems]: TLevel extends "deep" ? Writeable<TTupleItems[Index], "deep"> : TTupleItems[Index] }] : TObject extends ArrayOrObject ? { -readonly [Key in keyof TObject]: TLevel extends "deep" ? Writeable<TObject[Key], "deep"> : TObject[Key] } : TObject;
 
+//#endregion
+//#region src/type-utils/union.d.ts
 type ErrorMessages<TType extends number | string | symbol = never> = Partial<Record<"$all" | number | symbol | (AnyString | TType), unknown>> | null;
 /**
  * Type utility that takes two types and allows only the properties of the first type. The properties of the second will be disallowed (typed as `never` by default or a custom message).
@@ -57,9 +55,7 @@ type ErrorMessages<TType extends number | string | symbol = never> = Partial<Rec
  * @template TSecondType The second type. Properties of this type will be disallowed.
  * @template TErrorMessages An object of custom messages to display on the properties of the second type that are disallowed.
  */
-type AllowOnlyFirst<TFirstType, TSecondType, TErrorMessages extends ErrorMessages = never> = Prettify<TFirstType & {
-    [Key in keyof Omit<TSecondType, keyof TFirstType>]?: Key extends keyof TErrorMessages ? TErrorMessages[Key] : "$all" extends keyof TErrorMessages ? TErrorMessages["$all"] : TErrorMessages extends null ? TErrorMessages : never;
-}>;
+type AllowOnlyFirst<TFirstType, TSecondType, TErrorMessages extends ErrorMessages = never> = Prettify<TFirstType & { [Key in keyof Omit<TSecondType, keyof TFirstType>]?: Key extends keyof TErrorMessages ? TErrorMessages[Key] : "$all" extends keyof TErrorMessages ? TErrorMessages["$all"] : TErrorMessages extends null ? TErrorMessages : never }>;
 /**
  * Merges all types in an array of types into one type.
  *
@@ -79,8 +75,10 @@ type MergeTypes<TArrayOfTypes extends unknown[], TAccumulator = NonNullable<unkn
 type UnionDiscriminator<TArrayOfTypes extends unknown[], TErrorMessages extends ErrorMessages<keyof MergeTypes<TArrayOfTypes>> = never, TAccumulator = never, TMergedProperties = MergeTypes<TArrayOfTypes>> = TArrayOfTypes extends [infer TFirstType, ...infer TRest] ? UnionDiscriminator<TRest, TErrorMessages, TAccumulator | AllowOnlyFirst<TFirstType, TMergedProperties, TErrorMessages>, TMergedProperties> : TAccumulator;
 type UnionVariant = "keys" | "values";
 type ExtractUnion<TObject, TVariant extends UnionVariant = "values"> = TObject extends Array<infer TUnion> | ReadonlyArray<infer TUnion> | Set<infer TUnion> ? TUnion : TObject extends Record<infer TKeys, infer TValues> ? TVariant extends "keys" ? TKeys : Prettify<Writeable<TValues, "deep">> : never;
-type UnionToIntersection<TUnion> = (TUnion extends unknown ? (param: TUnion) => void : never) extends (param: infer TParam) => void ? TParam : never;
+type UnionToIntersection<TUnion> = (TUnion extends unknown ? (param: TUnion) => void : never) extends ((param: infer TParam) => void) ? TParam : never;
 
+//#endregion
+//#region src/guard.d.ts
 declare const isString: (value: unknown) => value is string;
 declare const isNumber: (value: unknown) => value is number;
 declare const isSymbol: (value: unknown) => value is symbol;
@@ -100,43 +98,49 @@ declare const isAsyncFunction: <TAsyncFunction extends AnyAsyncFunction>(value:
 declare const isFile: (value: unknown) => value is File;
 declare const isIterable: <TIterable>(obj: object) => obj is Iterable<TIterable>;
 
+//#endregion
+//#region src/assert.d.ts
 declare class AssertionError extends Error {
-    name: string;
-    constructor(message?: string);
+  name: string;
+  constructor(message?: string);
 }
 declare const assertDefined: <TValue>(value: TValue) => NonNullable<TValue>;
 declare const assertENV: (variable: string | undefined, message?: string) => string;
 type AssertOptions = {
-    message: string;
+  message: string;
 };
 type AssertFn = {
-    (condition: boolean, messageOrOptions?: string | AssertOptions): asserts condition;
-    <TValue>(value: TValue, messageOrOptions?: string | AssertOptions): asserts value is NonNullable<TValue>;
+  (condition: boolean, messageOrOptions?: string | AssertOptions): asserts condition;
+  <TValue>(value: TValue, messageOrOptions?: string | AssertOptions): asserts value is NonNullable<TValue>;
 };
 declare const assert: AssertFn;
 
+//#endregion
+//#region src/enum.d.ts
 type DefineEnumOptions = {
-    unionVariant?: UnionVariant;
-    writeableLevel?: WriteableLevel;
+  unionVariant?: UnionVariant;
+  writeableLevel?: WriteableLevel;
 };
 declare const defineEnum: <const TValue extends object, TOptions extends DefineEnumOptions = DefineEnumOptions>(value: TValue, _options?: TOptions) => Prettify<Writeable<TValue, TOptions["writeableLevel"] extends WriteableLevel ? TOptions["writeableLevel"] : "shallow">> & {
-    "~inferredUnion": ExtractUnion<TValue, TOptions["unionVariant"] extends UnionVariant ? TOptions["unionVariant"] : "values">;
+  "~inferredUnion": ExtractUnion<TValue, TOptions["unionVariant"] extends UnionVariant ? TOptions["unionVariant"] : "values">;
 };
 type DefineEnumDeepOptions = Pick<DefineEnumOptions, "unionVariant">;
 declare const defineEnumDeep: <const TValue extends object, TOptions extends DefineEnumDeepOptions = DefineEnumDeepOptions>(value: TValue, _options?: TOptions) => (Writeable<TValue, (TOptions & {
-    writeableLevel: "deep";
+  writeableLevel: "deep";
 })["writeableLevel"] extends WriteableLevel ? (TOptions & {
-    writeableLevel: "deep";
+  writeableLevel: "deep";
 })["writeableLevel"] : "shallow"> extends infer T ? { [Key in keyof T]: Writeable<TValue, (TOptions & {
-    writeableLevel: "deep";
+  writeableLevel: "deep";
 })["writeableLevel"] extends WriteableLevel ? (TOptions & {
+  writeableLevel: "deep";
+})["writeableLevel"] : "shallow">[Key] } : never) & {
+  "~inferredUnion": ExtractUnion<TValue, (TOptions & {
+    writeableLevel: "deep";
+  })["unionVariant"] extends UnionVariant ? (TOptions & {
     writeableLevel: "deep";
-})["writeableLevel"] : "shallow">[Key]; } : never) & {
-    "~inferredUnion": ExtractUnion<TValue, (TOptions & {
-        writeableLevel: "deep";
-    })["unionVariant"] extends UnionVariant ? (TOptions & {
-        writeableLevel: "deep";
-    })["unionVariant"] : "values">;
+  })["unionVariant"] : "values">;
 };
 
-export { type AnyAsyncFunction, type AnyFunction, type AnyNumber, type AnyObject, type AnyString, AssertionError, type Awaitable, type CallbackFn, type EmptyObject, type ExtractUnion, type LiteralUnion, type NonEmptyArray, type NonFalsy, type Prettify, type PrettyOmit, type PrettyPick, type SelectorFn, type UnionDiscriminator, type UnionToIntersection, type UnionVariant, type UnknownObject, type UnknownObjectWithAnyKey, type UnmaskType, type Writeable, type WriteableLevel, assert, assertDefined, assertENV, defineEnum, defineEnumDeep, hasObjectPrototype, isArray, isAsyncFunction, isBoolean, isFile, isFormData, isFunction, isIterable, isNumber, isObject, isObjectAndNotArray, isPlainObject, isString, isSymbol };
+//#endregion
+export { AnyAsyncFunction, AnyFunction, AnyNumber, AnyObject, AnyString, AssertionError, Awaitable, CallbackFn, EmptyObject, Equal, Expect, ExtractUnion, LiteralUnion, NonEmptyArray, NonFalsy, Prettify, PrettyOmit, PrettyPick, SelectorFn, UnionDiscriminator, UnionToIntersection, UnionVariant, UnknownObject, UnknownObjectWithAnyKey, UnmaskType, Writeable, WriteableLevel, assert, assertDefined, assertENV, defineEnum, defineEnumDeep, hasObjectPrototype, isArray, isAsyncFunction, isBoolean, isFile, isFormData, isFunction, isIterable, isNumber, isObject, isObjectAndNotArray, isPlainObject, isString, isSymbol };
+//# sourceMappingURL=index.d.ts.map

package/dist/esm/index.js

@@ -1,81 +1,73 @@
-// src/guard.ts
-var isString = (value) => typeof value === "string";
-var isNumber = (value) => typeof value === "number";
-var isSymbol = (value) => typeof value === "symbol";
-var isBoolean = (value) => typeof value === "boolean";
-var isArray = (value) => Array.isArray(value);
-var isFormData = (value) => value instanceof FormData;
-var isObject = (value) => typeof value === "object" && value !== null;
-var isObjectAndNotArray = (value) => {
-  return isObject(value) && !isArray(value);
+//#region src/guard.ts
+const isString = (value) => typeof value === "string";
+const isNumber = (value) => typeof value === "number";
+const isSymbol = (value) => typeof value === "symbol";
+const isBoolean = (value) => typeof value === "boolean";
+const isArray = (value) => Array.isArray(value);
+const isFormData = (value) => value instanceof FormData;
+const isObject = (value) => typeof value === "object" && value !== null;
+const isObjectAndNotArray = (value) => {
+	return isObject(value) && !isArray(value);
 };
-var hasObjectPrototype = (value) => {
-  return Object.prototype.toString.call(value) === "[object Object]";
+const hasObjectPrototype = (value) => {
+	return Object.prototype.toString.call(value) === "[object Object]";
 };
-var isPlainObject = (value) => {
-  if (!hasObjectPrototype(value)) {
-    return false;
-  }
-  const constructor = value?.constructor;
-  if (constructor === void 0) {
-    return true;
-  }
-  const prototype = constructor.prototype;
-  if (!hasObjectPrototype(prototype)) {
-    return false;
-  }
-  if (!Object.hasOwn(prototype, "isPrototypeOf")) {
-    return false;
-  }
-  if (Object.getPrototypeOf(value) !== Object.prototype) {
-    return false;
-  }
-  return true;
+/**
+* @description Copied from TanStack Query's isPlainObject
+* @see https://github.com/TanStack/query/blob/main/packages/query-core/src/utils.ts#L321
+*/
+const isPlainObject = (value) => {
+	if (!hasObjectPrototype(value)) return false;
+	const constructor = value?.constructor;
+	if (constructor === void 0) return true;
+	const prototype = constructor.prototype;
+	if (!hasObjectPrototype(prototype)) return false;
+	if (!Object.hasOwn(prototype, "isPrototypeOf")) return false;
+	if (Object.getPrototypeOf(value) !== Object.prototype) return false;
+	return true;
 };
-var isFunction = (value) => {
-  return typeof value === "function";
+const isFunction = (value) => {
+	return typeof value === "function";
 };
-var isAsyncFunction = (value) => {
-  return isFunction(value) && value.constructor.name === "AsyncFunction";
+const isAsyncFunction = (value) => {
+	return isFunction(value) && value.constructor.name === "AsyncFunction";
 };
-var isFile = (value) => value instanceof File;
-var isIterable = (obj) => Symbol.iterator in obj;
+const isFile = (value) => value instanceof File;
+const isIterable = (obj) => Symbol.iterator in obj;
 
-// src/assert.ts
+//#endregion
+//#region src/assert.ts
 var AssertionError = class extends Error {
-  name = "AssertionError";
-  constructor(message) {
-    const prefix = "Assertion failed";
-    super(message ? `${prefix}: ${message}` : message);
-  }
+	name = "AssertionError";
+	constructor(message) {
+		const prefix = "Assertion failed";
+		super(message ? `${prefix}: ${message}` : message);
+	}
 };
-var assertDefined = (value) => {
-  if (value == null) {
-    throw new AssertionError(`The value passed is "${value}!"`);
-  }
-  return value;
+const assertDefined = (value) => {
+	if (value == null) throw new AssertionError(`The value passed is "${value}!"`);
+	return value;
 };
-var assertENV = (variable, message) => {
-  if (variable === void 0) {
-    throw new AssertionError(message);
-  }
-  return variable;
+const assertENV = (variable, message) => {
+	if (variable === void 0) throw new AssertionError(message);
+	return variable;
 };
-var assert = (input, messageOrOptions) => {
-  if (input === false || input == null) {
-    const message = isString(messageOrOptions) ? messageOrOptions : messageOrOptions?.message;
-    throw new AssertionError(message);
-  }
+const assert = (input, messageOrOptions) => {
+	if (input === false || input == null) {
+		const message = isString(messageOrOptions) ? messageOrOptions : messageOrOptions?.message;
+		throw new AssertionError(message);
+	}
 };
 
-// src/enum.ts
-var defineEnum = (value, _options) => {
-  return value;
+//#endregion
+//#region src/enum.ts
+const defineEnum = (value, _options) => {
+	return value;
 };
-var defineEnumDeep = (value, _options) => {
-  return defineEnum(value);
+const defineEnumDeep = (value, _options) => {
+	return defineEnum(value);
 };
 
+//#endregion
 export { AssertionError, assert, assertDefined, assertENV, defineEnum, defineEnumDeep, hasObjectPrototype, isArray, isAsyncFunction, isBoolean, isFile, isFormData, isFunction, isIterable, isNumber, isObject, isObjectAndNotArray, isPlainObject, isString, isSymbol };
-//# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.js.map

package/dist/esm/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/guard.ts","../../src/assert.ts","../../src/enum.ts"],"names":[],"mappings":"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","file":"index.js","sourcesContent":["import type {\n\tAnyAsyncFunction,\n\tAnyFunction,\n\tUnknownObject,\n\tUnknownObjectWithAnyKey,\n} from \"./type-utils/common\";\n\nexport const isString = (value: unknown) => typeof value === \"string\";\n\nexport const isNumber = (value: unknown) => typeof value === \"number\";\n\nexport const isSymbol = (value: unknown) => typeof value === \"symbol\";\n\nexport const isBoolean = (value: unknown) => typeof value === \"boolean\";\n\nexport const isArray = <TArray>(value: unknown): value is TArray[] => Array.isArray(value);\n\nexport const isFormData = (value: unknown) => value instanceof FormData;\n\nexport const isObject = (value: unknown) => typeof value === \"object\" && value !== null;\n\nexport const isObjectAndNotArray = <TObject = UnknownObject>(value: unknown): value is TObject => {\n\treturn isObject(value) && !isArray(value);\n};\n\nexport const hasObjectPrototype = (value: unknown) => {\n\treturn Object.prototype.toString.call(value) === \"[object Object]\";\n};\n\n/**\n * @description Copied from TanStack Query's isPlainObject\n * @see https://github.com/TanStack/query/blob/main/packages/query-core/src/utils.ts#L321\n */\nexport const isPlainObject = <TPlainObject extends UnknownObjectWithAnyKey = UnknownObject>(\n\tvalue: unknown\n): value is TPlainObject => {\n\tif (!hasObjectPrototype(value)) {\n\t\treturn false;\n\t}\n\n\t// If has no constructor\n\tconst constructor = (value as object | undefined)?.constructor;\n\tif (constructor === undefined) {\n\t\treturn true;\n\t}\n\n\t// If has modified prototype\n\tconst prototype = constructor.prototype as object;\n\tif (!hasObjectPrototype(prototype)) {\n\t\treturn false;\n\t}\n\n\t// If constructor does not have an Object-specific method\n\tif (!Object.hasOwn(prototype, \"isPrototypeOf\")) {\n\t\treturn false;\n\t}\n\n\t// Handles Objects created by Object.create(<arbitrary prototype>)\n\tif (Object.getPrototypeOf(value) !== Object.prototype) {\n\t\treturn false;\n\t}\n\n\t// It's probably a plain object at this point\n\treturn true;\n};\n\nexport const isFunction = <TFunction extends AnyFunction>(value: unknown): value is TFunction => {\n\treturn typeof value === \"function\";\n};\n\nexport const isAsyncFunction = <TAsyncFunction extends AnyAsyncFunction>(\n\tvalue: unknown\n): value is TAsyncFunction => {\n\treturn isFunction(value) && value.constructor.name === \"AsyncFunction\";\n};\n\nexport const isFile = (value: unknown): value is File => value instanceof File;\n\nexport const isIterable = <TIterable>(obj: object): obj is Iterable<TIterable> => Symbol.iterator in obj;\n","import { isString } from \"./guard\";\n\nexport class AssertionError extends Error {\n\toverride name = \"AssertionError\";\n\n\tconstructor(message?: string) {\n\t\tconst prefix = \"Assertion failed\";\n\n\t\tsuper(message ? `${prefix}: ${message}` : message);\n\t}\n}\n\nexport const assertDefined = <TValue>(value: TValue) => {\n\tif (value == null) {\n\t\tthrow new AssertionError(`The value passed is \"${value as null | undefined}!\"`);\n\t}\n\n\treturn value;\n};\n\nexport const assertENV = (variable: string | undefined, message?: string) => {\n\tif (variable === undefined) {\n\t\tthrow new AssertionError(message);\n\t}\n\n\treturn variable;\n};\n\ntype AssertOptions = {\n\tmessage: string;\n};\n\ntype AssertFn = {\n\t(condition: boolean, messageOrOptions?: string | AssertOptions): asserts condition;\n\n\t<TValue>(\n\t\tvalue: TValue,\n\t\tmessageOrOptions?: string | AssertOptions\n\t): asserts value is NonNullable<TValue>;\n};\n\nexport const assert: AssertFn = (input: unknown, messageOrOptions?: string | AssertOptions) => {\n\tif (input === false || input == null) {\n\t\tconst message = isString(messageOrOptions) ? messageOrOptions : messageOrOptions?.message;\n\n\t\tthrow new AssertionError(message);\n\t}\n};\n","import type { ExtractUnion, Prettify, UnionVariant, Writeable, WriteableLevel } from \"./type-utils\";\n\ntype DefineEnumOptions = {\n\tunionVariant?: UnionVariant;\n\twriteableLevel?: WriteableLevel;\n};\n\nexport const defineEnum = <\n\tconst TValue extends object,\n\tTOptions extends DefineEnumOptions = DefineEnumOptions,\n>(\n\tvalue: TValue,\n\t_options?: TOptions\n) => {\n\ttype UnionProp = {\n\t\t\"~inferredUnion\": ExtractUnion<\n\t\t\tTValue,\n\t\t\tTOptions[\"unionVariant\"] extends UnionVariant ? TOptions[\"unionVariant\"] : \"values\"\n\t\t>;\n\t};\n\n\treturn value as Prettify<\n\t\tWriteable<\n\t\t\tTValue,\n\t\t\tTOptions[\"writeableLevel\"] extends WriteableLevel ? TOptions[\"writeableLevel\"] : \"shallow\"\n\t\t>\n\t>\n\t\t& UnionProp;\n};\n\ntype DefineEnumDeepOptions = Pick<DefineEnumOptions, \"unionVariant\">;\n\nexport const defineEnumDeep = <\n\tconst TValue extends object,\n\tTOptions extends DefineEnumDeepOptions = DefineEnumDeepOptions,\n>(\n\tvalue: TValue,\n\t_options?: TOptions\n) => {\n\treturn defineEnum<TValue, TOptions & { writeableLevel: \"deep\" }>(value);\n};\n"]}
+{"version":3,"file":"index.js","names":["value: unknown","obj: object","message?: string","value: TValue","variable: string | undefined","assert: AssertFn","input: unknown","messageOrOptions?: string | AssertOptions","value: TValue","_options?: TOptions"],"sources":["../../src/guard.ts","../../src/assert.ts","../../src/enum.ts"],"sourcesContent":["import type {\n\tAnyAsyncFunction,\n\tAnyFunction,\n\tUnknownObject,\n\tUnknownObjectWithAnyKey,\n} from \"./type-utils/common\";\n\nexport const isString = (value: unknown) => typeof value === \"string\";\n\nexport const isNumber = (value: unknown) => typeof value === \"number\";\n\nexport const isSymbol = (value: unknown) => typeof value === \"symbol\";\n\nexport const isBoolean = (value: unknown) => typeof value === \"boolean\";\n\nexport const isArray = <TArray>(value: unknown): value is TArray[] => Array.isArray(value);\n\nexport const isFormData = (value: unknown) => value instanceof FormData;\n\nexport const isObject = (value: unknown) => typeof value === \"object\" && value !== null;\n\nexport const isObjectAndNotArray = <TObject = UnknownObject>(value: unknown): value is TObject => {\n\treturn isObject(value) && !isArray(value);\n};\n\nexport const hasObjectPrototype = (value: unknown) => {\n\treturn Object.prototype.toString.call(value) === \"[object Object]\";\n};\n\n/**\n * @description Copied from TanStack Query's isPlainObject\n * @see https://github.com/TanStack/query/blob/main/packages/query-core/src/utils.ts#L321\n */\nexport const isPlainObject = <TPlainObject extends UnknownObjectWithAnyKey = UnknownObject>(\n\tvalue: unknown\n): value is TPlainObject => {\n\tif (!hasObjectPrototype(value)) {\n\t\treturn false;\n\t}\n\n\t// If has no constructor\n\tconst constructor = (value as object | undefined)?.constructor;\n\tif (constructor === undefined) {\n\t\treturn true;\n\t}\n\n\t// If has modified prototype\n\tconst prototype = constructor.prototype as object;\n\tif (!hasObjectPrototype(prototype)) {\n\t\treturn false;\n\t}\n\n\t// If constructor does not have an Object-specific method\n\tif (!Object.hasOwn(prototype, \"isPrototypeOf\")) {\n\t\treturn false;\n\t}\n\n\t// Handles Objects created by Object.create(<arbitrary prototype>)\n\tif (Object.getPrototypeOf(value) !== Object.prototype) {\n\t\treturn false;\n\t}\n\n\t// It's probably a plain object at this point\n\treturn true;\n};\n\nexport const isFunction = <TFunction extends AnyFunction>(value: unknown): value is TFunction => {\n\treturn typeof value === \"function\";\n};\n\nexport const isAsyncFunction = <TAsyncFunction extends AnyAsyncFunction>(\n\tvalue: unknown\n): value is TAsyncFunction => {\n\treturn isFunction(value) && value.constructor.name === \"AsyncFunction\";\n};\n\nexport const isFile = (value: unknown): value is File => value instanceof File;\n\nexport const isIterable = <TIterable>(obj: object): obj is Iterable<TIterable> => Symbol.iterator in obj;\n","import { isString } from \"./guard\";\n\nexport class AssertionError extends Error {\n\toverride name = \"AssertionError\";\n\n\tconstructor(message?: string) {\n\t\tconst prefix = \"Assertion failed\";\n\n\t\tsuper(message ? `${prefix}: ${message}` : message);\n\t}\n}\n\nexport const assertDefined = <TValue>(value: TValue) => {\n\tif (value == null) {\n\t\tthrow new AssertionError(`The value passed is \"${value as null | undefined}!\"`);\n\t}\n\n\treturn value;\n};\n\nexport const assertENV = (variable: string | undefined, message?: string) => {\n\tif (variable === undefined) {\n\t\tthrow new AssertionError(message);\n\t}\n\n\treturn variable;\n};\n\ntype AssertOptions = {\n\tmessage: string;\n};\n\ntype AssertFn = {\n\t(condition: boolean, messageOrOptions?: string | AssertOptions): asserts condition;\n\n\t<TValue>(\n\t\tvalue: TValue,\n\t\tmessageOrOptions?: string | AssertOptions\n\t): asserts value is NonNullable<TValue>;\n};\n\nexport const assert: AssertFn = (input: unknown, messageOrOptions?: string | AssertOptions) => {\n\tif (input === false || input == null) {\n\t\tconst message = isString(messageOrOptions) ? messageOrOptions : messageOrOptions?.message;\n\n\t\tthrow new AssertionError(message);\n\t}\n};\n","import type { ExtractUnion, Prettify, UnionVariant, Writeable, WriteableLevel } from \"./type-utils\";\n\ntype DefineEnumOptions = {\n\tunionVariant?: UnionVariant;\n\twriteableLevel?: WriteableLevel;\n};\n\nexport const defineEnum = <\n\tconst TValue extends object,\n\tTOptions extends DefineEnumOptions = DefineEnumOptions,\n>(\n\tvalue: TValue,\n\t_options?: TOptions\n) => {\n\ttype UnionProp = {\n\t\t\"~inferredUnion\": ExtractUnion<\n\t\t\tTValue,\n\t\t\tTOptions[\"unionVariant\"] extends UnionVariant ? TOptions[\"unionVariant\"] : \"values\"\n\t\t>;\n\t};\n\n\treturn value as Prettify<\n\t\tWriteable<\n\t\t\tTValue,\n\t\t\tTOptions[\"writeableLevel\"] extends WriteableLevel ? TOptions[\"writeableLevel\"] : \"shallow\"\n\t\t>\n\t>\n\t\t& UnionProp;\n};\n\ntype DefineEnumDeepOptions = Pick<DefineEnumOptions, \"unionVariant\">;\n\nexport const defineEnumDeep = <\n\tconst TValue extends object,\n\tTOptions extends DefineEnumDeepOptions = DefineEnumDeepOptions,\n>(\n\tvalue: TValue,\n\t_options?: TOptions\n) => {\n\treturn defineEnum<TValue, TOptions & { writeableLevel: \"deep\" }>(value);\n};\n"],"mappings":";AAOA,MAAa,WAAW,CAACA,iBAA0B,UAAU;AAE7D,MAAa,WAAW,CAACA,iBAA0B,UAAU;AAE7D,MAAa,WAAW,CAACA,iBAA0B,UAAU;AAE7D,MAAa,YAAY,CAACA,iBAA0B,UAAU;AAE9D,MAAa,UAAU,CAASA,UAAsC,MAAM,QAAQ,MAAM;AAE1F,MAAa,aAAa,CAACA,UAAmB,iBAAiB;AAE/D,MAAa,WAAW,CAACA,iBAA0B,UAAU,YAAY,UAAU;AAEnF,MAAa,sBAAsB,CAA0BA,UAAqC;AACjG,QAAO,SAAS,MAAM,KAAK,QAAQ,MAAM;AACzC;AAED,MAAa,qBAAqB,CAACA,UAAmB;AACrD,QAAO,OAAO,UAAU,SAAS,KAAK,MAAM,KAAK;AACjD;;;;;AAMD,MAAa,gBAAgB,CAC5BA,UAC2B;AAC3B,MAAK,mBAAmB,MAAM,CAC7B,QAAO;CAIR,MAAM,cAAe,OAA8B;AACnD,KAAI,uBACH,QAAO;CAIR,MAAM,YAAY,YAAY;AAC9B,MAAK,mBAAmB,UAAU,CACjC,QAAO;AAIR,MAAK,OAAO,OAAO,WAAW,gBAAgB,CAC7C,QAAO;AAIR,KAAI,OAAO,eAAe,MAAM,KAAK,OAAO,UAC3C,QAAO;AAIR,QAAO;AACP;AAED,MAAa,aAAa,CAAgCA,UAAuC;AAChG,eAAc,UAAU;AACxB;AAED,MAAa,kBAAkB,CAC9BA,UAC6B;AAC7B,QAAO,WAAW,MAAM,IAAI,MAAM,YAAY,SAAS;AACvD;AAED,MAAa,SAAS,CAACA,UAAkC,iBAAiB;AAE1E,MAAa,aAAa,CAAYC,QAA4C,OAAO,YAAY;;;;AC5ErG,IAAa,iBAAb,cAAoC,MAAM;CACzC,AAAS,OAAO;CAEhB,YAAYC,SAAkB;EAC7B,MAAM,SAAS;AAEf,QAAM,WAAW,EAAE,OAAO,IAAI,QAAQ,IAAI,QAAQ;CAClD;AACD;AAED,MAAa,gBAAgB,CAASC,UAAkB;AACvD,KAAI,SAAS,KACZ,OAAM,IAAI,gBAAgB,uBAAuB,MAA0B;AAG5E,QAAO;AACP;AAED,MAAa,YAAY,CAACC,UAA8BF,YAAqB;AAC5E,KAAI,oBACH,OAAM,IAAI,eAAe;AAG1B,QAAO;AACP;AAeD,MAAaG,SAAmB,CAACC,OAAgBC,qBAA8C;AAC9F,KAAI,UAAU,SAAS,SAAS,MAAM;EACrC,MAAM,UAAU,SAAS,iBAAiB,GAAG,mBAAmB,kBAAkB;AAElF,QAAM,IAAI,eAAe;CACzB;AACD;;;;ACxCD,MAAa,aAAa,CAIzBC,OACAC,aACI;AAQJ,QAAO;AAOP;AAID,MAAa,iBAAiB,CAI7BD,OACAC,aACI;AACJ,QAAO,WAA0D,MAAM;AACvE"}

package/dist/resets/index.js

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

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@zayne-labs/toolkit-type-helpers",
   "type": "module",
-  "version": "0.9.46",
+  "version": "0.9.47",
   "description": "A collection of utility functions, types and composables used by my other projects. Nothing too fancy but can be useful.",
   "author": "Ryan Zayne",
   "license": "MIT",
@@ -42,7 +42,7 @@
     "cross-env": "^7.0.3",
     "publint": "^0.3.12",
     "size-limit": "^11.2.0",
-    "tsup": "^8.5.0",
+    "tsdown": "^0.12.3",
     "typescript": "5.8.3",
     "vitest": "3.1.3"
   },
@@ -58,8 +58,8 @@
     }
   ],
   "scripts": {
-    "build": "tsup",
-    "build:dev": "cross-env NODE_ENV=development tsup",
+    "build": "tsdown",
+    "build:dev": "cross-env NODE_ENV=development tsdown",
     "build:test": "concurrently --prefix-colors \"yellow.bold,#7da4f8.bold,magenta\" --names PUBLINT,TSUP 'pnpm:lint:publint' 'pnpm:build:dev'",
     "dev": "pnpm build:dev --watch",
     "lint:attw": "attw --pack . --ignore-rules=cjs-resolves-to-esm",

package/dist/resets/common.js

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