@elyukai/utils 0.2.9 → 0.3.0

package/CHANGELOG.md

@@ -2,6 +2,19 @@
 
 All notable changes to this project will be documented in this file. See [commit-and-tag-version](https://github.com/absolute-version/commit-and-tag-version) for commit guidelines.
 
+## [0.3.0](https://github.com/elyukai/ts-utils/compare/v0.2.9...v0.3.0) (2026-03-06)
+
+
+### ⚠ BREAKING CHANGES
+
+* intersperse as old intercalate
+* add array intercalate and rename module
+
+### Features
+
+* add array intercalate and rename module ([2495638](https://github.com/elyukai/ts-utils/commit/24956389cb0fe6e867a985ab760d295cced4ba6b))
+* intersperse as old intercalate ([2d39540](https://github.com/elyukai/ts-utils/commit/2d39540f502415f7db4d5e9227aaab4802e16148))
+
 ## [0.2.9](https://github.com/elyukai/ts-utils/compare/v0.2.8...v0.2.9) (2026-03-02)
 
 

package/dist/src/array/transformations.d.ts

@@ -0,0 +1,27 @@
+/**
+ * Utility functions for transforming arrays.
+ * @module
+ */
+/**
+ * Returns a new array with the given value interspersed between each element of the given array. An empty array is returned if the given array is empty.
+ * @param arr The array to intersperse.
+ * @param value The value to intersperse between each element of the array.
+ * @returns A new array with the given value interspersed between each element of the given array.
+ */
+export declare const intersperse: <T>(arr: T[], value: T) => T[];
+/**
+ * Returns a new array with the given values intercalated between each element of the given array. An empty array is returned if the given array is empty.
+ * @param arr The array to intercalate.
+ * @param values The values to intercalate between each element of the array.
+ * @returns A new array with the given values intercalated between each element of the given array.
+ */
+export declare const intercalate: <T>(arr: T[][], values: T[]) => T[];
+/**
+ * Returns the possibilities of all the combinations of nested array values.
+ *
+ * @example
+ *
+ * flatCombine([["a", "b"], ["c"]]) // [["a", "c"], ["b", "c"]]
+ * flatCombine([["a", "b"], ["c", "d"]]) // [["a", "c"], ["b", "c"], ["a", "d"], ["b", "d"]]
+ */
+export declare const flatCombine: <T>(arr: T[][]) => T[][];

package/dist/src/array/transformations.js

@@ -0,0 +1,34 @@
+/**
+ * Utility functions for transforming arrays.
+ * @module
+ */
+import { isNotEmpty } from "./nonEmpty.js";
+/**
+ * Returns a new array with the given value interspersed between each element of the given array. An empty array is returned if the given array is empty.
+ * @param arr The array to intersperse.
+ * @param value The value to intersperse between each element of the array.
+ * @returns A new array with the given value interspersed between each element of the given array.
+ */
+export const intersperse = (arr, value) => !isNotEmpty(arr) ? [] : arr.slice(1).reduce((acc, elem) => [...acc, value, elem], [arr[0]]);
+/**
+ * Returns a new array with the given values intercalated between each element of the given array. An empty array is returned if the given array is empty.
+ * @param arr The array to intercalate.
+ * @param values The values to intercalate between each element of the array.
+ * @returns A new array with the given values intercalated between each element of the given array.
+ */
+export const intercalate = (arr, values) => !isNotEmpty(arr)
+    ? []
+    : arr.slice(1).reduce((acc, elem) => [...acc, ...values, ...elem], arr[0]);
+/**
+ * Returns the possibilities of all the combinations of nested array values.
+ *
+ * @example
+ *
+ * flatCombine([["a", "b"], ["c"]]) // [["a", "c"], ["b", "c"]]
+ * flatCombine([["a", "b"], ["c", "d"]]) // [["a", "c"], ["b", "c"], ["a", "d"], ["b", "d"]]
+ */
+export const flatCombine = (arr) => arr.length === 0
+    ? []
+    : arr.slice(1).reduce((acc, elem) => elem.flatMap(elemInner => acc.map(accElem => [...accElem, elemInner])), 
+    // eslint-disable-next-line @typescript-eslint/no-non-null-assertion -- it is checked before if the array is empty
+    arr[0].map(elem => [elem]));

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@elyukai/utils",
-  "version": "0.2.9",
+  "version": "0.3.0",
   "description": "A set of JavaScript helper functions.",
   "files": [
     "dist",
@@ -9,7 +9,7 @@
     "CHANGELOG.md"
   ],
   "exports": {
-    "./*": "./dist/*.js"
+    "./*": "./dist/src/*.js"
   },
   "scripts": {
     "build": "tsc -b",

package/dist/array/generators.d.ts

@@ -1,13 +0,0 @@
-/**
- * Utility functions for generating new arrays.
- * @module
- */
-/**
- * Returns the possibilities of all the combinations of nested array values.
- *
- * @example
- *
- * flatCombine([["a", "b"], ["c"]]) // [["a", "c"], ["b", "c"]]
- * flatCombine([["a", "b"], ["c", "d"]]) // [["a", "c"], ["b", "c"], ["a", "d"], ["b", "d"]]
- */
-export declare const flatCombine: <T>(arr: T[][]) => T[][];

package/dist/array/generators.js

@@ -1,17 +0,0 @@
-/**
- * Utility functions for generating new arrays.
- * @module
- */
-/**
- * Returns the possibilities of all the combinations of nested array values.
- *
- * @example
- *
- * flatCombine([["a", "b"], ["c"]]) // [["a", "c"], ["b", "c"]]
- * flatCombine([["a", "b"], ["c", "d"]]) // [["a", "c"], ["b", "c"], ["a", "d"], ["b", "d"]]
- */
-export const flatCombine = (arr) => arr.length === 0
-    ? []
-    : arr.slice(1).reduce((acc, elem) => elem.flatMap(elemInner => acc.map(accElem => [...accElem, elemInner])), 
-    // eslint-disable-next-line @typescript-eslint/no-non-null-assertion -- it is checked before if the array is empty
-    arr[0].map(elem => [elem]));