@alextheman/utility 3.5.4 → 3.5.5

package/dist/index.cjs

@@ -46,6 +46,18 @@ var appendSemicolon_default = appendSemicolon;
 
 //#endregion
 //#region src/functions/arrayHelpers/fillArray.ts
+/**
+* Creates a new array where each element is the result of the provided callback.
+*
+* If the callback returns at least one Promise, the entire result will be wrapped
+* in a `Promise` and resolved with `Promise.all`. Otherwise, a plain array is returned.
+*
+* @template ItemType
+* @param callback - A function invoked with the current index. May return a value or a Promise.
+* @param [length=1] - The desired length of the resulting array.
+*
+* @returns An array of the callback results, or a Promise resolving to one if the callback is async.
+*/
 function fillArray(callback, length = 1) {
 	const outputArray = new Array(length).fill(null).map((_, index) => {
 		return callback(index);
@@ -59,6 +71,20 @@ var fillArray_default = fillArray;
 
 //#endregion
 //#region src/functions/arrayHelpers/paralleliseArrays.ts
+/**
+* Creates a new array of tuples, each containing the item at the given index from both arrays.
+*
+* If `secondArray` is shorter than `firstArray`, the second position in the tuple
+* will be `undefined`. Iteration always uses the length of the first array.
+*
+* @template FirstArrayItem
+* @template SecondArrayItem
+*
+* @param firstArray - The first array. Each item in this will take up the first tuple spot.
+* @param secondArray - The second array. Each item in this will take up the second tuple spot.
+*
+* @returns An array of `[firstItem, secondItem]` tuples for each index in `firstArray`.
+*/
 function paralleliseArrays(firstArray, secondArray) {
 	const outputArray = [];
 	for (let i = 0; i < firstArray.length; i++) outputArray.push([firstArray[i], secondArray[i]]);

package/dist/index.d.cts

@@ -7,12 +7,50 @@ declare const NAMESPACE_EXPORT_REGEX = "export\\s+\\*\\s+from";
 declare function appendSemicolon(stringToAppendTo: string): string;
 //#endregion
 //#region src/functions/arrayHelpers/fillArray.d.ts
-declare function fillArray<T>(callback: (index: number) => Promise<T>, length?: number): Promise<T[]>;
-declare function fillArray<T>(callback: (index: number) => T, length?: number): T[];
+/**
+ * Creates a new array where each element is the resolved result of the provided asynchronous callback.
+ *
+ * The callback will be invoked once for each index from `0` to `length - 1`.
+ * If no length is provided, a single-element array will be produced.
+ *
+ * @template ItemType
+ * @param callback - An asynchronous function invoked with the current index.
+ * @param [length=1] - The desired length of the resulting array.
+ *
+ * @returns A Promise resolving to an array of the callback results.
+ */
+declare function fillArray<ItemType$1>(callback: (index: number) => Promise<ItemType$1>, length?: number): Promise<ItemType$1[]>;
+/**
+ * Creates a new array where each element is the result of the provided synchronous callback.
+ *
+ * The callback will be invoked once for each index from `0` to `length - 1`.
+ * If no length is provided, a single-element array will be produced.
+ *
+ * @template ItemType
+ * @param callback - A synchronous function invoked with the current index.
+ * @param [length=1] - The desired length of the resulting array.
+ *
+ * @returns An array of the callback results.
+ */
+declare function fillArray<ItemType$1>(callback: (index: number) => ItemType$1, length?: number): ItemType$1[];
 //#endregion
 //#region src/functions/arrayHelpers/paralleliseArrays.d.ts
 type ParallelTuple<A, B> = [A, B | undefined];
-declare function paralleliseArrays<FirstArrayItem, SecondArrayItem>(firstArray: FirstArrayItem[] | readonly FirstArrayItem[], secondArray: SecondArrayItem[] | readonly SecondArrayItem[]): ParallelTuple<FirstArrayItem, SecondArrayItem>[];
+/**
+ * Creates a new array of tuples, each containing the item at the given index from both arrays.
+ *
+ * If `secondArray` is shorter than `firstArray`, the second position in the tuple
+ * will be `undefined`. Iteration always uses the length of the first array.
+ *
+ * @template FirstArrayItem
+ * @template SecondArrayItem
+ *
+ * @param firstArray - The first array. Each item in this will take up the first tuple spot.
+ * @param secondArray - The second array. Each item in this will take up the second tuple spot.
+ *
+ * @returns An array of `[firstItem, secondItem]` tuples for each index in `firstArray`.
+ */
+declare function paralleliseArrays<FirstArrayItem, SecondArrayItem>(firstArray: readonly FirstArrayItem[], secondArray: readonly SecondArrayItem[]): ParallelTuple<FirstArrayItem, SecondArrayItem>[];
 //#endregion
 //#region src/functions/arrayHelpers/randomiseArray.d.ts
 declare function randomiseArray<T>(array: T[]): T[];

package/dist/index.d.ts

@@ -7,12 +7,50 @@ declare const NAMESPACE_EXPORT_REGEX = "export\\s+\\*\\s+from";
 declare function appendSemicolon(stringToAppendTo: string): string;
 //#endregion
 //#region src/functions/arrayHelpers/fillArray.d.ts
-declare function fillArray<T>(callback: (index: number) => Promise<T>, length?: number): Promise<T[]>;
-declare function fillArray<T>(callback: (index: number) => T, length?: number): T[];
+/**
+ * Creates a new array where each element is the resolved result of the provided asynchronous callback.
+ *
+ * The callback will be invoked once for each index from `0` to `length - 1`.
+ * If no length is provided, a single-element array will be produced.
+ *
+ * @template ItemType
+ * @param callback - An asynchronous function invoked with the current index.
+ * @param [length=1] - The desired length of the resulting array.
+ *
+ * @returns A Promise resolving to an array of the callback results.
+ */
+declare function fillArray<ItemType$1>(callback: (index: number) => Promise<ItemType$1>, length?: number): Promise<ItemType$1[]>;
+/**
+ * Creates a new array where each element is the result of the provided synchronous callback.
+ *
+ * The callback will be invoked once for each index from `0` to `length - 1`.
+ * If no length is provided, a single-element array will be produced.
+ *
+ * @template ItemType
+ * @param callback - A synchronous function invoked with the current index.
+ * @param [length=1] - The desired length of the resulting array.
+ *
+ * @returns An array of the callback results.
+ */
+declare function fillArray<ItemType$1>(callback: (index: number) => ItemType$1, length?: number): ItemType$1[];
 //#endregion
 //#region src/functions/arrayHelpers/paralleliseArrays.d.ts
 type ParallelTuple<A, B> = [A, B | undefined];
-declare function paralleliseArrays<FirstArrayItem, SecondArrayItem>(firstArray: FirstArrayItem[] | readonly FirstArrayItem[], secondArray: SecondArrayItem[] | readonly SecondArrayItem[]): ParallelTuple<FirstArrayItem, SecondArrayItem>[];
+/**
+ * Creates a new array of tuples, each containing the item at the given index from both arrays.
+ *
+ * If `secondArray` is shorter than `firstArray`, the second position in the tuple
+ * will be `undefined`. Iteration always uses the length of the first array.
+ *
+ * @template FirstArrayItem
+ * @template SecondArrayItem
+ *
+ * @param firstArray - The first array. Each item in this will take up the first tuple spot.
+ * @param secondArray - The second array. Each item in this will take up the second tuple spot.
+ *
+ * @returns An array of `[firstItem, secondItem]` tuples for each index in `firstArray`.
+ */
+declare function paralleliseArrays<FirstArrayItem, SecondArrayItem>(firstArray: readonly FirstArrayItem[], secondArray: readonly SecondArrayItem[]): ParallelTuple<FirstArrayItem, SecondArrayItem>[];
 //#endregion
 //#region src/functions/arrayHelpers/randomiseArray.d.ts
 declare function randomiseArray<T>(array: T[]): T[];

package/dist/index.js

@@ -17,6 +17,18 @@ var appendSemicolon_default = appendSemicolon;
 
 //#endregion
 //#region src/functions/arrayHelpers/fillArray.ts
+/**
+* Creates a new array where each element is the result of the provided callback.
+*
+* If the callback returns at least one Promise, the entire result will be wrapped
+* in a `Promise` and resolved with `Promise.all`. Otherwise, a plain array is returned.
+*
+* @template ItemType
+* @param callback - A function invoked with the current index. May return a value or a Promise.
+* @param [length=1] - The desired length of the resulting array.
+*
+* @returns An array of the callback results, or a Promise resolving to one if the callback is async.
+*/
 function fillArray(callback, length = 1) {
 	const outputArray = new Array(length).fill(null).map((_, index) => {
 		return callback(index);
@@ -30,6 +42,20 @@ var fillArray_default = fillArray;
 
 //#endregion
 //#region src/functions/arrayHelpers/paralleliseArrays.ts
+/**
+* Creates a new array of tuples, each containing the item at the given index from both arrays.
+*
+* If `secondArray` is shorter than `firstArray`, the second position in the tuple
+* will be `undefined`. Iteration always uses the length of the first array.
+*
+* @template FirstArrayItem
+* @template SecondArrayItem
+*
+* @param firstArray - The first array. Each item in this will take up the first tuple spot.
+* @param secondArray - The second array. Each item in this will take up the second tuple spot.
+*
+* @returns An array of `[firstItem, secondItem]` tuples for each index in `firstArray`.
+*/
 function paralleliseArrays(firstArray, secondArray) {
 	const outputArray = [];
 	for (let i = 0; i < firstArray.length; i++) outputArray.push([firstArray[i], secondArray[i]]);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@alextheman/utility",
-  "version": "3.5.4",
+  "version": "3.5.5",
   "description": "Helpful utility functions",
   "repository": {
     "type": "git",
@@ -21,6 +21,7 @@
   "devDependencies": {
     "@alextheman/eslint-plugin": "^4.3.0",
     "@types/node": "^24.10.1",
+    "dotenv-cli": "^11.0.0",
     "eslint": "^9.39.1",
     "globals": "^16.5.0",
     "husky": "^9.1.7",
@@ -48,10 +49,12 @@
     "lint-prettier-javascript": "prettier --check \"./**/*.js\"",
     "lint-prettier-typescript": "prettier --check --parser typescript \"./**/*.ts\"",
     "lint-tsc": "tsc --noEmit",
+    "prepare-live-eslint-plugin": "pnpm uninstall @alextheman/eslint-plugin && pnpm install --save-dev @alextheman/eslint-plugin",
+    "prepare-local-eslint-plugin": "dotenv -e .env -- sh -c 'ESLINT_PLUGIN_PATH=${LOCAL_ESLINT_PLUGIN_PATH:-../eslint-plugin}; pnpm --prefix \"$ESLINT_PLUGIN_PATH\" run build && pnpm uninstall @alextheman/eslint-plugin && pnpm install --save-dev -w file:\"$ESLINT_PLUGIN_PATH\"'",
     "test": "vitest run",
     "test-watch": "vitest",
     "update-dependencies": "pnpm update --latest && pnpm update",
-    "use-live-eslint-plugin": "pnpm uninstall @alextheman/eslint-plugin && pnpm install --save-dev @alextheman/eslint-plugin",
-    "use-local-eslint-plugin": "npm --prefix ../eslint-plugin run create-local-package && pnpm uninstall @alextheman/eslint-plugin && pnpm install --save-dev ../eslint-plugin/alextheman-eslint-plugin-*.tgz"
+    "use-live-eslint-plugin": "pnpm run prepare-live-eslint-plugin && pnpm run lint",
+    "use-local-eslint-plugin": "pnpm run prepare-local-eslint-plugin && pnpm run lint"
   }
 }