@zayne-labs/toolkit-type-helpers 0.8.38 → 0.8.45

package/dist/esm/index.d.ts

@@ -8,14 +8,10 @@ type PrettyOmit<TObject, Key extends keyof TObject> = Prettify<Omit<TObject, Key
 type PrettyPick<TObject, Key extends keyof TObject> = Prettify<Pick<TObject, Key>>;
 type CallbackFn<in TParams, out TResult = void> = (...params: TParams[]) => TResult;
 type SelectorFn<TStore, TResult> = (state: TStore) => TResult;
-type ExtractUnion<TEnum extends Record<string, unknown> | unknown[]> = TEnum extends unknown[] ? TEnum[number] : TEnum[keyof TEnum];
-type WriteableLevel = "deep" | "shallow";
-type Writeable<TObject, TType extends WriteableLevel = "shallow"> = {
-    -readonly [key in keyof TObject]: TType extends "shallow" ? TObject[key] : TType extends "deep" ? TObject[key] extends object ? Writeable<TObject[key], TType> : TObject[key] : never;
-};
-type InferEnum<TObject, TVariant extends "keys" | "values" = "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 NonEmptyArray<TArrayItem> = [TArrayItem, ...TArrayItem[]];
-type AnyObject = UnmaskType<Record<string, unknown>>;
+type UnknownObject = UnmaskType<Record<string, unknown>>;
+type UnknownObjectWithAnyKey = UnmaskType<Record<keyof any, unknown>>;
+type AnyObject = UnmaskType<Record<keyof any, any>>;
 type AnyFunction<TResult = any> = UnmaskType<(...args: any[]) => TResult>;
 type AnyAsyncFunction<TResult = any> = UnmaskType<(...args: any[]) => Promise<TResult>>;
 /**
@@ -32,14 +28,60 @@ 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 WriteableVariantUnion = "deep" | "shallow";
+/**
+ * Makes all properties in an object type writeable (removes readonly modifiers).
+ * Supports both shallow and deep modes, and handles special cases like arrays, tuples, and unions.
+ * @template TObject - The object type to make writeable
+ * @template TVariant - The level of writeable transformation ("shallow" | "deep")
+ */
+type Writeable<TObject, TVariant extends WriteableVariantUnion = "shallow"> = TObject extends readonly [...infer TTupleItems] ? TVariant extends "deep" ? [
+    ...{
+        [Key in keyof TTupleItems]: TTupleItems[Key] extends object ? Writeable<TTupleItems[Key], TVariant> : TTupleItems[Key];
+    }
+] : [...TTupleItems] : TObject extends ReadonlyArray<infer TArrayItem> ? TVariant extends "deep" ? Array<TArrayItem extends object ? Writeable<TArrayItem, TVariant> : TArrayItem> : TArrayItem[] : TObject extends object ? {
+    -readonly [Key in keyof TObject]: TVariant extends "shallow" ? TObject[Key] : TVariant extends "deep" ? TObject[Key] extends object ? Writeable<TObject[Key], TVariant> : TObject[Key] : never;
+} : TObject;
+
+type AllowOnlyFirst<TFirstType, TSecondType, TExclusionValue = never> = Prettify<TFirstType & Partial<Record<keyof Omit<TSecondType, keyof TFirstType>, TExclusionValue>>>;
+type AllowOnlyFirstRequired<TFirstType, TSecondType, TExclusionValue = never> = Prettify<TFirstType & Record<keyof Omit<TSecondType, keyof TFirstType>, TExclusionValue>>;
+type MergeTypes<TArrayOfTypes extends unknown[], TAccumulator = NonNullable<unknown>> = TArrayOfTypes extends [infer TFirstType, ...infer TRest] ? MergeTypes<TRest, TAccumulator & TFirstType> : TAccumulator;
+/**
+ * Type utility that extracts discriminated properties from a union of types.
+ * Takes an array of types and returns a union of types where each type has unique properties.
+ *
+ * @template TArrayOfTypes Array of types to process
+ * @template TExclusionValue Value to exclude from the resulting union
+ * @template TAccumulator Accumulator for the resulting union
+ * @template TMergedProperties Merged properties from all types
+ */
+type UnionDiscriminator<TArrayOfTypes extends unknown[], TExclusionValue = never, TAccumulator = never, TMergedProperties = MergeTypes<TArrayOfTypes>> = TArrayOfTypes extends [infer TFirstType, ...infer TRest] ? UnionDiscriminator<TRest, TExclusionValue, TAccumulator | AllowOnlyFirst<TFirstType, TMergedProperties, TExclusionValue>, TMergedProperties> : TAccumulator;
+/**
+ * Type utility that extracts discriminated properties from a union of types.
+ * Takes an array of types and returns a union of types where each type has unique properties.
+ *
+ * @template TArrayOfTypes - Array of types to process
+ * @template TExclusionValue - Value to exclude from the resulting union
+ * @template TAccumulator - Accumulator for the resulting union
+ * @template TMergedProperties - Merged properties from all types
+ */
+type UnionDiscriminatorRequired<TArrayOfTypes extends unknown[], TExclusionValue = never, TAccumulator = never, TMergedProperties = MergeTypes<TArrayOfTypes>> = TArrayOfTypes extends [infer TFirstType, ...infer TRest] ? UnionDiscriminatorRequired<TRest, TExclusionValue, TAccumulator | AllowOnlyFirstRequired<TFirstType, TMergedProperties, TExclusionValue>, TMergedProperties> : TAccumulator;
+type ExtractUnion<TObject, TVariant extends "keys" | "values" = "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;
+
 declare const isString: (value: unknown) => value is string;
 declare const isNumber: (value: unknown) => value is number;
+declare const isSymbol: (value: unknown) => value is symbol;
 declare const isBoolean: (value: unknown) => value is boolean;
 declare const isArray: <TArray>(value: unknown) => value is TArray[];
 declare const isFormData: (value: unknown) => value is FormData;
 declare const isObject: (value: unknown) => value is object;
-declare const isObjectAndNotArray: <TObject = Record<string, unknown>>(value: unknown) => value is TObject;
-declare const isPlainObject: <TObject extends AnyObject>(value: unknown) => value is TObject;
+declare const isObjectAndNotArray: <TObject = UnknownObject>(value: unknown) => value is TObject;
+declare const hasObjectPrototype: (value: unknown) => boolean;
+/**
+ * @description Copied from TanStack Query's isPlainObject
+ * @see https://github.com/TanStack/query/blob/main/packages/query-core/src/utils.ts#L321
+ */
+declare const isPlainObject: <TPlainObject extends UnknownObjectWithAnyKey = UnknownObject>(value: unknown) => value is TPlainObject;
 declare const isFunction: <TFunction extends AnyFunction>(value: unknown) => value is TFunction;
 declare const isAsyncFunction: <TAsyncFunction extends AnyAsyncFunction>(value: unknown) => value is TAsyncFunction;
 declare const isFile: (value: unknown) => value is File;
@@ -60,6 +102,6 @@ type AssertFn = {
 };
 declare const assert: AssertFn;
 
-declare const defineEnum: <const TValue, TWriteableLevel extends WriteableLevel = "shallow">(value: TValue) => Prettify<Writeable<TValue, TWriteableLevel>>;
+declare const defineEnum: <const TValue, TVariant extends WriteableVariantUnion = "shallow">(value: TValue) => Prettify<Writeable<TValue, TVariant>>;
 
-export { type AnyAsyncFunction, type AnyFunction, type AnyNumber, type AnyObject, type AnyString, AssertionError, type CallbackFn, type ExtractUnion, type InferEnum, type LiteralUnion, type NonEmptyArray, type Prettify, type PrettyOmit, type PrettyPick, type SelectorFn, type UnmaskType, type Writeable, type WriteableLevel, assert, assertDefined, assertENV, defineEnum, isArray, isAsyncFunction, isBoolean, isFile, isFormData, isFunction, isIterable, isNumber, isObject, isObjectAndNotArray, isPlainObject, isString };
+export { type AnyAsyncFunction, type AnyFunction, type AnyNumber, type AnyObject, type AnyString, AssertionError, type CallbackFn, type ExtractUnion, type LiteralUnion, type NonEmptyArray, type Prettify, type PrettyOmit, type PrettyPick, type SelectorFn, type UnionDiscriminator, type UnionDiscriminatorRequired, type UnknownObject, type UnknownObjectWithAnyKey, type UnmaskType, type Writeable, type WriteableVariantUnion, assert, assertDefined, assertENV, defineEnum, hasObjectPrototype, isArray, isAsyncFunction, isBoolean, isFile, isFormData, isFunction, isIterable, isNumber, isObject, isObjectAndNotArray, isPlainObject, isString, isSymbol };

package/dist/esm/index.js

@@ -1,6 +1,7 @@
 // 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;
@@ -8,12 +9,28 @@ var isObject = (value) => typeof value === "object" && value !== null;
 var isObjectAndNotArray = (value) => {
   return isObject(value) && !isArray(value);
 };
+var hasObjectPrototype = (value) => {
+  return Object.prototype.toString.call(value) === "[object Object]";
+};
 var isPlainObject = (value) => {
-  if (!isObject(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;
   }
-  const prototype = Object.getPrototypeOf(value);
-  return (prototype == null || prototype === Object.prototype || Object.getPrototypeOf(prototype) === null) && !(Symbol.toStringTag in value);
+  return true;
 };
 var isFunction = (value) => {
   return typeof value === "function";
@@ -39,7 +56,7 @@ var assertDefined = (value) => {
   return value;
 };
 var assertENV = (variable, message) => {
-  if (variable === undefined) {
+  if (variable === void 0) {
     throw new AssertionError(message);
   }
   return variable;
@@ -52,8 +69,10 @@ var assert = (input, messageOrOptions) => {
 };
 
 // src/common.ts
-var defineEnum = (value) => value;
+var defineEnum = (value) => {
+  return value;
+};
 
-export { AssertionError, assert, assertDefined, assertENV, defineEnum, isArray, isAsyncFunction, isBoolean, isFile, isFormData, isFunction, isIterable, isNumber, isObject, isObjectAndNotArray, isPlainObject, isString };
+export { AssertionError, assert, assertDefined, assertENV, defineEnum, 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/common.ts"],"names":[],"mappings":";AAEO,IAAM,QAAW,GAAA,CAAC,KAAmB,KAAA,OAAO,KAAU,KAAA;AAEtD,IAAM,QAAW,GAAA,CAAC,KAAmB,KAAA,OAAO,KAAU,KAAA;AAEtD,IAAM,SAAY,GAAA,CAAC,KAAmB,KAAA,OAAO,KAAU,KAAA;AAEvD,IAAM,OAAU,GAAA,CAAS,KAAsC,KAAA,KAAA,CAAM,QAAQ,KAAK;AAE5E,IAAA,UAAA,GAAa,CAAC,KAAA,KAAmB,KAAiB,YAAA;AAExD,IAAM,WAAW,CAAC,KAAA,KAAmB,OAAO,KAAA,KAAU,YAAY,KAAU,KAAA;AAEtE,IAAA,mBAAA,GAAsB,CAClC,KACsB,KAAA;AACtB,EAAA,OAAO,QAAS,CAAA,KAAK,CAAK,IAAA,CAAC,QAAQ,KAAK,CAAA;AACzC;AAEa,IAAA,aAAA,GAAgB,CAA4B,KAAqC,KAAA;AAC7F,EAAI,IAAA,CAAC,QAAS,CAAA,KAAK,CAAG,EAAA;AACrB,IAAO,OAAA,KAAA;AAAA;AAGR,EAAM,MAAA,SAAA,GAAY,MAAO,CAAA,cAAA,CAAe,KAAK,CAAA;AAG7C,EAAA,OAAA,CACE,SAAa,IAAA,IAAA,IAAQ,SAAc,KAAA,MAAA,CAAO,SAAa,IAAA,MAAA,CAAO,cAAe,CAAA,SAAS,CAAM,KAAA,IAAA,KAC7F,EAAE,MAAA,CAAO,WAAe,IAAA,KAAA,CAAA;AAE1B;AAEa,IAAA,UAAA,GAAa,CAAgC,KAAuC,KAAA;AAChG,EAAA,OAAO,OAAO,KAAU,KAAA,UAAA;AACzB;AAEa,IAAA,eAAA,GAAkB,CAC9B,KAC6B,KAAA;AAC7B,EAAA,OAAO,UAAW,CAAA,KAAK,CAAK,IAAA,KAAA,CAAM,YAAY,IAAS,KAAA,eAAA;AACxD;AAEa,IAAA,MAAA,GAAS,CAAC,KAAA,KAAkC,KAAiB,YAAA;AAEnE,IAAM,UAAa,GAAA,CAAY,GAA4C,KAAA,MAAA,CAAO,QAAY,IAAA;;;AC5CxF,IAAA,cAAA,GAAN,cAA6B,KAAM,CAAA;AAAA,EAChC,IAAO,GAAA,gBAAA;AAAA,EAEhB,YAAY,OAAkB,EAAA;AAC7B,IAAA,MAAM,MAAS,GAAA,kBAAA;AAEf,IAAA,KAAA,CAAM,UAAU,CAAG,EAAA,MAAM,CAAK,EAAA,EAAA,OAAO,KAAK,OAAO,CAAA;AAAA;AAEnD;AAEa,IAAA,aAAA,GAAgB,CAAS,KAAkB,KAAA;AACvD,EAAA,IAAI,SAAS,IAAM,EAAA;AAClB,IAAA,MAAM,IAAI,cAAA,CAAe,CAAwB,qBAAA,EAAA,KAAyB,CAAI,EAAA,CAAA,CAAA;AAAA;AAG/E,EAAO,OAAA,KAAA;AACR;AAEa,IAAA,SAAA,GAAY,CAAC,QAAA,EAA8B,OAAqB,KAAA;AAC5E,EAAA,IAAI,aAAa,SAAW,EAAA;AAC3B,IAAM,MAAA,IAAI,eAAe,OAAO,CAAA;AAAA;AAGjC,EAAO,OAAA,QAAA;AACR;AAea,IAAA,MAAA,GAAmB,CAAC,KAAA,EAAgB,gBAA8C,KAAA;AAC9F,EAAI,IAAA,KAAA,KAAU,KAAS,IAAA,KAAA,IAAS,IAAM,EAAA;AACrC,IAAA,MAAM,OAAU,GAAA,QAAA,CAAS,gBAAgB,CAAA,GAAI,mBAAmB,gBAAkB,EAAA,OAAA;AAElF,IAAM,MAAA,IAAI,eAAe,OAAO,CAAA;AAAA;AAElC;;;AC7Ca,IAAA,UAAA,GAAa,CACzB,KACI,KAAA","file":"index.js","sourcesContent":["import type { AnyAsyncFunction, AnyFunction, AnyObject } from \"./type-utils\";\n\nexport const isString = (value: unknown) => typeof value === \"string\";\n\nexport const isNumber = (value: unknown) => typeof value === \"number\";\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 = Record<string, unknown>>(\n\tvalue: unknown\n): value is TObject => {\n\treturn isObject(value) && !isArray(value);\n};\n\nexport const isPlainObject = <TObject extends AnyObject>(value: unknown): value is TObject => {\n\tif (!isObject(value)) {\n\t\treturn false;\n\t}\n\n\tconst prototype = Object.getPrototypeOf(value) as unknown;\n\n\t// == Check if it's a plain object\n\treturn (\n\t\t(prototype == null || prototype === Object.prototype || Object.getPrototypeOf(prototype) === null) &&\n\t\t!(Symbol.toStringTag in value)\n\t);\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 { Prettify, Writeable, WriteableLevel } from \"./type-utils\";\n\nexport const defineEnum = <const TValue, TWriteableLevel extends WriteableLevel = \"shallow\">(\n\tvalue: TValue\n) => value as Prettify<Writeable<TValue, TWriteableLevel>>;\n"]}
+{"version":3,"sources":["../../src/guard.ts","../../src/assert.ts","../../src/common.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 { Prettify, Writeable, WriteableVariantUnion } from \"./type-utils\";\n\nexport const defineEnum = <const TValue, TVariant extends WriteableVariantUnion = \"shallow\">(\n\tvalue: TValue\n) => {\n\treturn value as Prettify<Writeable<TValue, TVariant>>;\n};\n"]}

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@zayne-labs/toolkit-type-helpers",
   "type": "module",
-  "version": "0.8.38",
+  "version": "0.8.45",
   "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",
@@ -32,21 +32,22 @@
     "node": ">=18.x"
   },
   "devDependencies": {
-    "@arethetypeswrong/cli": "^0.17.3",
+    "@arethetypeswrong/cli": "^0.17.4",
     "@changesets/cli": "^2.28.1",
     "@size-limit/esbuild-why": "^11.2.0",
     "@size-limit/preset-small-lib": "^11.2.0",
     "@total-typescript/ts-reset": "^0.6.1",
-    "@types/node": "^22.13.4",
+    "@types/node": "^22.13.6",
     "@zayne-labs/tsconfig": "0.2.1",
     "clsx": "^2.1.1",
     "concurrently": "^9.1.2",
     "cross-env": "^7.0.3",
-    "publint": "^0.3.6",
+    "publint": "^0.3.7",
     "size-limit": "^11.2.0",
     "terser": "^5.39.0",
-    "tsup": "^8.3.6",
-    "typescript": "5.7.3"
+    "tsup": "^8.4.0",
+    "typescript": "5.8.2",
+    "vitest": "3.0.7"
   },
   "publishConfig": {
     "access": "public",
@@ -63,11 +64,14 @@
     "build": "tsup",
     "build:dev": "cross-env NODE_ENV=development tsup",
     "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",
-    "lint:check-types": "tsc --pretty --incremental -p tsconfig.json",
     "lint:publint": "publint --strict .",
     "lint:size": "size-limit",
+    "lint:type-check": "tsc --pretty  -p tsconfig.json",
     "release": "pnpm publish --no-git-checks",
-    "test:release": "pnpx pkg-pr-new publish"
+    "release:test": "pnpx pkg-pr-new publish",
+    "test": "vitest run",
+    "test:dev": "vitest dev"
   }
 }