complete-common 2.27.1 → 2.29.0

package/dist/functions/array.d.cts

@@ -160,8 +160,8 @@ export declare function newArray<T>(length: number, value: T): readonly T[];
 /** Helper function to sum every value in an array together. */
 export declare function sumArray(array: readonly number[]): number;
 /**
- * Helper function to filter out non-unique elements from an array. Under the hood, this converts
- * the array to a `Set` and then back to an array.
+ * Helper function to filter out non-unique elements from an array and sort it. Under the hood, this
+ * converts the array to a `Set` and then back to an sorted array.
  */
 export declare function unique<T>(array: readonly T[]): readonly T[];
 //# sourceMappingURL=array.d.ts.map

package/dist/functions/array.d.mts

@@ -160,8 +160,8 @@ export declare function newArray<T>(length: number, value: T): readonly T[];
 /** Helper function to sum every value in an array together. */
 export declare function sumArray(array: readonly number[]): number;
 /**
- * Helper function to filter out non-unique elements from an array. Under the hood, this converts
- * the array to a `Set` and then back to an array.
+ * Helper function to filter out non-unique elements from an array and sort it. Under the hood, this
+ * converts the array to a `Set` and then back to an sorted array.
  */
 export declare function unique<T>(array: readonly T[]): readonly T[];
 //# sourceMappingURL=array.d.ts.map

package/dist/functions/array.d.ts

@@ -160,8 +160,8 @@ export declare function newArray<T>(length: number, value: T): readonly T[];
 /** Helper function to sum every value in an array together. */
 export declare function sumArray(array: readonly number[]): number;
 /**
- * Helper function to filter out non-unique elements from an array. Under the hood, this converts
- * the array to a `Set` and then back to an array.
+ * Helper function to filter out non-unique elements from an array and sort it. Under the hood, this
+ * converts the array to a `Set` and then back to an sorted array.
  */
 export declare function unique<T>(array: readonly T[]): readonly T[];
 //# sourceMappingURL=array.d.ts.map

package/dist/functions/array.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"array.d.ts","sourceRoot":"","sources":["../../src/functions/array.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"array.d.ts","sourceRoot":"","sources":["../../src/functions/array.ts"],"names":[],"mappings":"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"}

package/dist/index.cjs

@@ -302,7 +302,10 @@ function sumArray(array) {
   return array.reduce((accumulator, element) => accumulator + element, 0);
 }
 function unique(array) {
-  return [...new Set(array)];
+  const uniqueElements = [...new Set(array)];
+  return uniqueElements.toSorted(
+    (a, b) => typeof a === "number" && typeof b === "number" ? a - b : String(a).localeCompare(String(b))
+  );
 }
 
 function mapFilter(map, predicate) {

package/dist/index.d.cts

@@ -17,8 +17,10 @@ export type * from "./interfaces/SemanticVersion.js";
 export type * from "./types/AddSubtract.js";
 export type * from "./types/CompositionTypeSatisfiesEnum.js";
 export type * from "./types/ERange.js";
+export type * from "./types/Expect.js";
 export type * from "./types/Immutable.js";
 export type * from "./types/IRange.js";
+export type * from "./types/KeysMatch.js";
 export type * from "./types/NaturalNumbersLessThan.js";
 export type * from "./types/NaturalNumbersLessThanOrEqualTo.js";
 export type * from "./types/ObjectValues.js";

package/dist/index.d.mts

@@ -17,8 +17,10 @@ export type * from "./interfaces/SemanticVersion.js";
 export type * from "./types/AddSubtract.js";
 export type * from "./types/CompositionTypeSatisfiesEnum.js";
 export type * from "./types/ERange.js";
+export type * from "./types/Expect.js";
 export type * from "./types/Immutable.js";
 export type * from "./types/IRange.js";
+export type * from "./types/KeysMatch.js";
 export type * from "./types/NaturalNumbersLessThan.js";
 export type * from "./types/NaturalNumbersLessThanOrEqualTo.js";
 export type * from "./types/ObjectValues.js";

package/dist/index.d.ts

@@ -17,8 +17,10 @@ export type * from "./interfaces/SemanticVersion.js";
 export type * from "./types/AddSubtract.js";
 export type * from "./types/CompositionTypeSatisfiesEnum.js";
 export type * from "./types/ERange.js";
+export type * from "./types/Expect.js";
 export type * from "./types/Immutable.js";
 export type * from "./types/IRange.js";
+export type * from "./types/KeysMatch.js";
 export type * from "./types/NaturalNumbersLessThan.js";
 export type * from "./types/NaturalNumbersLessThanOrEqualTo.js";
 export type * from "./types/ObjectValues.js";

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,gBAAgB,CAAC;AAC/B,cAAc,sBAAsB,CAAC;AACrC,cAAc,uBAAuB,CAAC;AACtC,cAAc,sBAAsB,CAAC;AACrC,cAAc,oBAAoB,CAAC;AACnC,cAAc,qBAAqB,CAAC;AACpC,cAAc,uBAAuB,CAAC;AACtC,cAAc,uBAAuB,CAAC;AACtC,cAAc,oBAAoB,CAAC;AACnC,cAAc,qBAAqB,CAAC;AACpC,cAAc,uBAAuB,CAAC;AACtC,cAAc,qBAAqB,CAAC;AACpC,cAAc,sBAAsB,CAAC;AACrC,cAAc,sBAAsB,CAAC;AACrC,cAAc,sBAAsB,CAAC;AACrC,mBAAmB,iCAAiC,CAAC;AACrD,mBAAmB,wBAAwB,CAAC;AAC5C,mBAAmB,yCAAyC,CAAC;AAC7D,mBAAmB,mBAAmB,CAAC;AACvC,mBAAmB,sBAAsB,CAAC;AAC1C,mBAAmB,mBAAmB,CAAC;AACvC,mBAAmB,mCAAmC,CAAC;AACvD,mBAAmB,4CAA4C,CAAC;AAChE,mBAAmB,yBAAyB,CAAC;AAC7C,cAAc,wBAAwB,CAAC;AACvC,mBAAmB,2BAA2B,CAAC;AAC/C,cAAc,wBAAwB,CAAC;AACvC,mBAAmB,2BAA2B,CAAC;AAC/C,mBAAmB,kBAAkB,CAAC;AACtC,mBAAmB,yBAAyB,CAAC;AAC7C,mBAAmB,sBAAsB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,gBAAgB,CAAC;AAC/B,cAAc,sBAAsB,CAAC;AACrC,cAAc,uBAAuB,CAAC;AACtC,cAAc,sBAAsB,CAAC;AACrC,cAAc,oBAAoB,CAAC;AACnC,cAAc,qBAAqB,CAAC;AACpC,cAAc,uBAAuB,CAAC;AACtC,cAAc,uBAAuB,CAAC;AACtC,cAAc,oBAAoB,CAAC;AACnC,cAAc,qBAAqB,CAAC;AACpC,cAAc,uBAAuB,CAAC;AACtC,cAAc,qBAAqB,CAAC;AACpC,cAAc,sBAAsB,CAAC;AACrC,cAAc,sBAAsB,CAAC;AACrC,cAAc,sBAAsB,CAAC;AACrC,mBAAmB,iCAAiC,CAAC;AACrD,mBAAmB,wBAAwB,CAAC;AAC5C,mBAAmB,yCAAyC,CAAC;AAC7D,mBAAmB,mBAAmB,CAAC;AACvC,mBAAmB,mBAAmB,CAAC;AACvC,mBAAmB,sBAAsB,CAAC;AAC1C,mBAAmB,mBAAmB,CAAC;AACvC,mBAAmB,sBAAsB,CAAC;AAC1C,mBAAmB,mCAAmC,CAAC;AACvD,mBAAmB,4CAA4C,CAAC;AAChE,mBAAmB,yBAAyB,CAAC;AAC7C,cAAc,wBAAwB,CAAC;AACvC,mBAAmB,2BAA2B,CAAC;AAC/C,cAAc,wBAAwB,CAAC;AACvC,mBAAmB,2BAA2B,CAAC;AAC/C,mBAAmB,kBAAkB,CAAC;AACtC,mBAAmB,yBAAyB,CAAC;AAC7C,mBAAmB,sBAAsB,CAAC"}

package/dist/index.mjs

@@ -300,7 +300,10 @@ function sumArray(array) {
   return array.reduce((accumulator, element) => accumulator + element, 0);
 }
 function unique(array) {
-  return [...new Set(array)];
+  const uniqueElements = [...new Set(array)];
+  return uniqueElements.toSorted(
+    (a, b) => typeof a === "number" && typeof b === "number" ? a - b : String(a).localeCompare(String(b))
+  );
 }
 
 function mapFilter(map, predicate) {

package/dist/types/Expect.d.cts

@@ -0,0 +1,6 @@
+/**
+ * Helper type used for testing other interfaces/types. Only `true` is assignable, anything else
+ * errors.
+ */
+export type Expect<T extends true> = T;
+//# sourceMappingURL=Expect.d.ts.map

package/dist/types/Expect.d.mts

@@ -0,0 +1,6 @@
+/**
+ * Helper type used for testing other interfaces/types. Only `true` is assignable, anything else
+ * errors.
+ */
+export type Expect<T extends true> = T;
+//# sourceMappingURL=Expect.d.ts.map

package/dist/types/Expect.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Helper type used for testing other interfaces/types. Only `true` is assignable, anything else
+ * errors.
+ */
+export type Expect<T extends true> = T;
+//# sourceMappingURL=Expect.d.ts.map

package/dist/types/Expect.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Expect.d.ts","sourceRoot":"","sources":["../../src/types/Expect.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,MAAM,MAAM,MAAM,CAAC,CAAC,SAAS,IAAI,IAAI,CAAC,CAAC"}

package/dist/types/KeysMatch.d.cts

@@ -0,0 +1,25 @@
+/**
+ * Helper type to ensure that an array of keys matches an interface.
+ *
+ * For example:
+ *
+ * ```ts
+ * interface Foo {
+ *   arg1: string;
+ *   arg2: string;
+ * }
+ *
+ * const FOO_KEYS = ["arg1", "arg2"] as const;
+ * type _ = Expect<KeysMatch<Foo, typeof FOO_KEYS>>;
+ * ```
+ */
+export type KeysMatch<T, Keys extends readonly PropertyKey[]> = [
+    keyof T
+] extends [Keys[number]] ? [Keys[number]] extends [keyof T] ? true : {
+    error: "Extra keys not in interface";
+    extra: Exclude<Keys[number], keyof T>;
+} : {
+    error: "Missing keys from interface";
+    missing: Exclude<keyof T, Keys[number]>;
+};
+//# sourceMappingURL=KeysMatch.d.ts.map

package/dist/types/KeysMatch.d.mts

@@ -0,0 +1,25 @@
+/**
+ * Helper type to ensure that an array of keys matches an interface.
+ *
+ * For example:
+ *
+ * ```ts
+ * interface Foo {
+ *   arg1: string;
+ *   arg2: string;
+ * }
+ *
+ * const FOO_KEYS = ["arg1", "arg2"] as const;
+ * type _ = Expect<KeysMatch<Foo, typeof FOO_KEYS>>;
+ * ```
+ */
+export type KeysMatch<T, Keys extends readonly PropertyKey[]> = [
+    keyof T
+] extends [Keys[number]] ? [Keys[number]] extends [keyof T] ? true : {
+    error: "Extra keys not in interface";
+    extra: Exclude<Keys[number], keyof T>;
+} : {
+    error: "Missing keys from interface";
+    missing: Exclude<keyof T, Keys[number]>;
+};
+//# sourceMappingURL=KeysMatch.d.ts.map

package/dist/types/KeysMatch.d.ts

@@ -0,0 +1,25 @@
+/**
+ * Helper type to ensure that an array of keys matches an interface.
+ *
+ * For example:
+ *
+ * ```ts
+ * interface Foo {
+ *   arg1: string;
+ *   arg2: string;
+ * }
+ *
+ * const FOO_KEYS = ["arg1", "arg2"] as const;
+ * type _ = Expect<KeysMatch<Foo, typeof FOO_KEYS>>;
+ * ```
+ */
+export type KeysMatch<T, Keys extends readonly PropertyKey[]> = [
+    keyof T
+] extends [Keys[number]] ? [Keys[number]] extends [keyof T] ? true : {
+    error: "Extra keys not in interface";
+    extra: Exclude<Keys[number], keyof T>;
+} : {
+    error: "Missing keys from interface";
+    missing: Exclude<keyof T, Keys[number]>;
+};
+//# sourceMappingURL=KeysMatch.d.ts.map

package/dist/types/KeysMatch.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"KeysMatch.d.ts","sourceRoot":"","sources":["../../src/types/KeysMatch.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AACH,MAAM,MAAM,SAAS,CAAC,CAAC,EAAE,IAAI,SAAS,SAAS,WAAW,EAAE,IAAI;IAC9D,MAAM,CAAC;CACR,SAAS,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,GACpB,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC,GAC9B,IAAI,GACJ;IACE,KAAK,EAAE,6BAA6B,CAAC;IACrC,KAAK,EAAE,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC,CAAC,CAAC;CACvC,GACH;IACE,KAAK,EAAE,6BAA6B,CAAC;IACrC,OAAO,EAAE,OAAO,CAAC,MAAM,CAAC,EAAE,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC;CACzC,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "complete-common",
-  "version": "2.27.1",
+  "version": "2.29.0",
   "description": "Helper functions for TypeScript projects.",
   "homepage": "https://complete-ts.github.io/",
   "bugs": {
@@ -32,11 +32,11 @@
     "test": "bun test ./tests"
   },
   "devDependencies": {
-    "@types/node": "25.5.2",
+    "@types/node": "25.6.0",
     "complete-node": "16.4.1",
-    "typedoc": "0.28.18",
+    "typedoc": "0.28.19",
     "typedoc-plugin-markdown": "4.11.0",
-    "typescript": "6.0.2",
+    "typescript": "6.0.3",
     "unbuild": "3.6.1"
   }
 }

package/src/functions/array.ts

@@ -383,9 +383,14 @@ export function sumArray(array: readonly number[]): number {
 }
 
 /**
- * Helper function to filter out non-unique elements from an array. Under the hood, this converts
- * the array to a `Set` and then back to an array.
+ * Helper function to filter out non-unique elements from an array and sort it. Under the hood, this
+ * converts the array to a `Set` and then back to an sorted array.
  */
 export function unique<T>(array: readonly T[]): readonly T[] {
-  return [...new Set(array)];
+  const uniqueElements = [...new Set(array)];
+  return uniqueElements.toSorted((a, b) =>
+    typeof a === "number" && typeof b === "number"
+      ? a - b
+      : String(a).localeCompare(String(b)),
+  );
 }

package/src/functions/object.ts

@@ -18,7 +18,7 @@ export function getWidenedObjectValue<T extends Record<string, unknown>>(
   key: WidenLiteral<keyof T>,
 ): T[keyof T] | undefined {
   const widenedObject = object as Record<PropertyKey, T[keyof T]>;
-  return widenedObject[key as PropertyKey];
+  return widenedObject[key];
 }
 
 /**

package/src/index.ts

@@ -17,8 +17,10 @@ export type * from "./interfaces/SemanticVersion.js";
 export type * from "./types/AddSubtract.js";
 export type * from "./types/CompositionTypeSatisfiesEnum.js";
 export type * from "./types/ERange.js";
+export type * from "./types/Expect.js";
 export type * from "./types/Immutable.js";
 export type * from "./types/IRange.js";
+export type * from "./types/KeysMatch.js";
 export type * from "./types/NaturalNumbersLessThan.js";
 export type * from "./types/NaturalNumbersLessThanOrEqualTo.js";
 export type * from "./types/ObjectValues.js";

package/src/types/Expect.ts

@@ -0,0 +1,5 @@
+/**
+ * Helper type used for testing other interfaces/types. Only `true` is assignable, anything else
+ * errors.
+ */
+export type Expect<T extends true> = T;

package/src/types/KeysMatch.ts

@@ -0,0 +1,28 @@
+/**
+ * Helper type to ensure that an array of keys matches an interface.
+ *
+ * For example:
+ *
+ * ```ts
+ * interface Foo {
+ *   arg1: string;
+ *   arg2: string;
+ * }
+ *
+ * const FOO_KEYS = ["arg1", "arg2"] as const;
+ * type _ = Expect<KeysMatch<Foo, typeof FOO_KEYS>>;
+ * ```
+ */
+export type KeysMatch<T, Keys extends readonly PropertyKey[]> = [
+  keyof T,
+] extends [Keys[number]]
+  ? [Keys[number]] extends [keyof T]
+    ? true
+    : {
+        error: "Extra keys not in interface";
+        extra: Exclude<Keys[number], keyof T>;
+      }
+  : {
+      error: "Missing keys from interface";
+      missing: Exclude<keyof T, Keys[number]>;
+    };