typescript-ds-lib 0.4.6 → 0.4.7

package/README.md

@@ -1,7 +1,7 @@
-# TypeScript Data Structure Library
+# TypeScript Data Structure & Algorithm Library
 [![NPM](https://img.shields.io/npm/v/typescript-ds-lib?label=npm%20package&color=limegreen)](https://www.npmjs.com/package/typescript-ds-lib)
 
-TypeScript data structure and algorithm implementations without external dependencies.
+TypeScript data structure and algorithm implementations with no external dependencies.
 
 **Why to use this library?**  
 - Fully Tested
@@ -57,6 +57,7 @@ See the [documentation](https://github.com/baloian/typescript-ds-lib/blob/master
 
 ## Algorithms
 - Binary Search (with custom comparator)
+- Levenshtein Distance (calculates the edit distance between two strings)
 - Shuffle (shuffles the array in-place)
 
 ## `Map-Set` vs Native JavaScript `Map-Set`

package/dist/algorithms/levenshtein-distance.d.ts

@@ -0,0 +1,25 @@
+/**
+ * Calculates the Levenshtein distance (edit distance) between two strings.
+ *
+ * The Levenshtein distance is the minimum number of single-character edits
+ * (insertions, deletions, or substitutions) required to transform one string into another.
+ *
+ * This implementation uses space-optimized dynamic programming with O(min(m, n)) space complexity
+ * instead of the naive O(m * n) approach, where m and n are the lengths of the input strings.
+ *
+ * Time complexity: O(m * n)
+ * Space complexity: O(min(m, n))
+ *
+ * @param str1 - The first string to compare.
+ * @param str2 - The second string to compare.
+ * @returns The Levenshtein distance between the two strings (a non-negative integer).
+ *
+ * @example
+ * ```typescript
+ * levenshteinDistance('kitten', 'sitting'); // Returns 3
+ * levenshteinDistance('hello', 'hello'); // Returns 0
+ * levenshteinDistance('', 'abc'); // Returns 3
+ * levenshteinDistance('abc', ''); // Returns 3
+ * ```
+ */
+export declare function levenshteinDistance(str1: string, str2: string): number;

package/dist/algorithms/levenshtein-distance.js

@@ -0,0 +1,73 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.levenshteinDistance = levenshteinDistance;
+/**
+ * Calculates the Levenshtein distance (edit distance) between two strings.
+ *
+ * The Levenshtein distance is the minimum number of single-character edits
+ * (insertions, deletions, or substitutions) required to transform one string into another.
+ *
+ * This implementation uses space-optimized dynamic programming with O(min(m, n)) space complexity
+ * instead of the naive O(m * n) approach, where m and n are the lengths of the input strings.
+ *
+ * Time complexity: O(m * n)
+ * Space complexity: O(min(m, n))
+ *
+ * @param str1 - The first string to compare.
+ * @param str2 - The second string to compare.
+ * @returns The Levenshtein distance between the two strings (a non-negative integer).
+ *
+ * @example
+ * ```typescript
+ * levenshteinDistance('kitten', 'sitting'); // Returns 3
+ * levenshteinDistance('hello', 'hello'); // Returns 0
+ * levenshteinDistance('', 'abc'); // Returns 3
+ * levenshteinDistance('abc', ''); // Returns 3
+ * ```
+ */
+function levenshteinDistance(str1, str2) {
+    // Early termination: if strings are identical, distance is 0
+    if (str1 === str2) {
+        return 0;
+    }
+    // Early termination: if one string is empty, distance is the length of the other
+    if (str1.length === 0) {
+        return str2.length;
+    }
+    if (str2.length === 0) {
+        return str1.length;
+    }
+    // Use the shorter string for the inner dimension to minimize space
+    const [longer, shorter] = str1.length >= str2.length ? [str1, str2] : [str2, str1];
+    const m = longer.length;
+    const n = shorter.length;
+    // Initialize two rows: previous and current
+    // prevRow represents the distances for the previous character of the longer string
+    let prevRow = Array.from({ length: n + 1 }, (_, i) => i);
+    let currRow = new Array(n + 1);
+    // Fill the DP table row by row
+    for (let i = 1; i <= m; i++) {
+        currRow[0] = i; // Cost of deleting all characters up to i in longer string
+        for (let j = 1; j <= n; j++) {
+            // If characters match, no operation needed (take diagonal value)
+            if (longer[i - 1] === shorter[j - 1]) {
+                currRow[j] = prevRow[j - 1];
+            }
+            else {
+                // Take minimum of three operations:
+                // 1. Deletion: prevRow[j] + 1
+                // 2. Insertion: currRow[j - 1] + 1
+                // 3. Substitution: prevRow[j - 1] + 1
+                currRow[j] = Math.min(prevRow[j] + 1, // deletion
+                currRow[j - 1] + 1, // insertion
+                prevRow[j - 1] + 1 // substitution
+                );
+            }
+        }
+        // Swap rows for next iteration
+        [prevRow, currRow] = [currRow, prevRow];
+    }
+    // The result is in prevRow[n] (since we swapped at the end)
+    return prevRow[n];
+}
+//# sourceMappingURL=levenshtein-distance.js.map

package/dist/algorithms/levenshtein-distance.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"levenshtein-distance.js","sourceRoot":"","sources":["../../algorithms/levenshtein-distance.ts"],"names":[],"mappings":";;AAwBA,kDA4CC;AApED;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,SAAgB,mBAAmB,CAAC,IAAY,EAAE,IAAY;IAC5D,6DAA6D;IAC7D,IAAI,IAAI,KAAK,IAAI,EAAE,CAAC;QAClB,OAAO,CAAC,CAAC;IACX,CAAC;IACD,iFAAiF;IACjF,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACtB,OAAO,IAAI,CAAC,MAAM,CAAC;IACrB,CAAC;IACD,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACtB,OAAO,IAAI,CAAC,MAAM,CAAC;IACrB,CAAC;IACD,mEAAmE;IACnE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC,MAAM,IAAI,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;IACnF,MAAM,CAAC,GAAG,MAAM,CAAC,MAAM,CAAC;IACxB,MAAM,CAAC,GAAG,OAAO,CAAC,MAAM,CAAC;IACzB,4CAA4C;IAC5C,mFAAmF;IACnF,IAAI,OAAO,GAAa,KAAK,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC,GAAG,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC;IACnE,IAAI,OAAO,GAAa,IAAI,KAAK,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;IACzC,+BAA+B;IAC/B,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC;QAC5B,OAAO,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,2DAA2D;QAC3E,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC;YAC5B,iEAAiE;YACjE,IAAI,MAAM,CAAC,CAAC,GAAG,CAAC,CAAC,KAAK,OAAO,CAAC,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC;gBACrC,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;YAC9B,CAAC;iBAAM,CAAC;gBACN,oCAAoC;gBACpC,8BAA8B;gBAC9B,mCAAmC;gBACnC,sCAAsC;gBACtC,OAAO,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,GAAG,CACnB,OAAO,CAAC,CAAC,CAAC,GAAG,CAAC,EAAO,WAAW;gBAChC,OAAO,CAAC,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,EAAG,YAAY;gBACjC,OAAO,CAAC,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,CAAG,eAAe;iBACrC,CAAC;YACJ,CAAC;QACH,CAAC;QACD,+BAA+B;QAC/B,CAAC,OAAO,EAAE,OAAO,CAAC,GAAG,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;IAC1C,CAAC;IACD,4DAA4D;IAC5D,OAAO,OAAO,CAAC,CAAC,CAAC,CAAC;AACpB,CAAC"}

package/dist/index.d.ts

@@ -14,4 +14,5 @@ export { RedBlackTree } from './lib/red-black-tree';
 export { Set } from './lib/set';
 export { Stack } from './lib/stack';
 export { binarySearch } from './algorithms/binary-search';
+export { levenshteinDistance } from './algorithms/levenshtein-distance';
 export { shuffle } from './algorithms/shuffle';

package/dist/index.js

@@ -14,7 +14,7 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
     for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.shuffle = exports.binarySearch = exports.Stack = exports.Set = exports.RedBlackTree = exports.Queue = exports.PriorityQueue = exports.Matrix = exports.Map = exports.LinkedList = exports.Heap = exports.HashTable = exports.LinkedListGraph = exports.MatrixGraph = exports.Deque = exports.BinarySearchTree = void 0;
+exports.shuffle = exports.levenshteinDistance = exports.binarySearch = exports.Stack = exports.Set = exports.RedBlackTree = exports.Queue = exports.PriorityQueue = exports.Matrix = exports.Map = exports.LinkedList = exports.Heap = exports.HashTable = exports.LinkedListGraph = exports.MatrixGraph = exports.Deque = exports.BinarySearchTree = void 0;
 __exportStar(require("./types"), exports);
 var binary_search_tree_1 = require("./lib/binary-search-tree");
 Object.defineProperty(exports, "BinarySearchTree", { enumerable: true, get: function () { return binary_search_tree_1.BinarySearchTree; } });
@@ -46,6 +46,8 @@ var stack_1 = require("./lib/stack");
 Object.defineProperty(exports, "Stack", { enumerable: true, get: function () { return stack_1.Stack; } });
 var binary_search_1 = require("./algorithms/binary-search");
 Object.defineProperty(exports, "binarySearch", { enumerable: true, get: function () { return binary_search_1.binarySearch; } });
+var levenshtein_distance_1 = require("./algorithms/levenshtein-distance");
+Object.defineProperty(exports, "levenshteinDistance", { enumerable: true, get: function () { return levenshtein_distance_1.levenshteinDistance; } });
 var shuffle_1 = require("./algorithms/shuffle");
 Object.defineProperty(exports, "shuffle", { enumerable: true, get: function () { return shuffle_1.shuffle; } });
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;AAAA,0CAAwB;AACxB,+DAA4D;AAAnD,sHAAA,gBAAgB,OAAA;AACzB,qCAAoC;AAA3B,8FAAA,KAAK,OAAA;AACd,yDAAuD;AAA9C,2GAAA,WAAW,OAAA;AACpB,mEAAgE;AAAvD,oHAAA,eAAe,OAAA;AACxB,+CAA6C;AAApC,uGAAA,SAAS,OAAA;AAClB,mCAAkC;AAAzB,4FAAA,IAAI,OAAA;AACb,iDAA+C;AAAtC,yGAAA,UAAU,OAAA;AACnB,iCAAgC;AAAvB,0FAAA,GAAG,OAAA;AACZ,uCAAsC;AAA7B,gGAAA,MAAM,OAAA;AACf,uDAAqD;AAA5C,+GAAA,aAAa,OAAA;AACtB,qCAAoC;AAA3B,8FAAA,KAAK,OAAA;AACd,uDAAoD;AAA3C,8GAAA,YAAY,OAAA;AACrB,iCAAgC;AAAvB,0FAAA,GAAG,OAAA;AACZ,qCAAoC;AAA3B,8FAAA,KAAK,OAAA;AACd,4DAA0D;AAAjD,6GAAA,YAAY,OAAA;AACrB,gDAA+C;AAAtC,kGAAA,OAAO,OAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;AAAA,0CAAwB;AACxB,+DAA4D;AAAnD,sHAAA,gBAAgB,OAAA;AACzB,qCAAoC;AAA3B,8FAAA,KAAK,OAAA;AACd,yDAAuD;AAA9C,2GAAA,WAAW,OAAA;AACpB,mEAAgE;AAAvD,oHAAA,eAAe,OAAA;AACxB,+CAA6C;AAApC,uGAAA,SAAS,OAAA;AAClB,mCAAkC;AAAzB,4FAAA,IAAI,OAAA;AACb,iDAA+C;AAAtC,yGAAA,UAAU,OAAA;AACnB,iCAAgC;AAAvB,0FAAA,GAAG,OAAA;AACZ,uCAAsC;AAA7B,gGAAA,MAAM,OAAA;AACf,uDAAqD;AAA5C,+GAAA,aAAa,OAAA;AACtB,qCAAoC;AAA3B,8FAAA,KAAK,OAAA;AACd,uDAAoD;AAA3C,8GAAA,YAAY,OAAA;AACrB,iCAAgC;AAAvB,0FAAA,GAAG,OAAA;AACZ,qCAAoC;AAA3B,8FAAA,KAAK,OAAA;AACd,4DAA0D;AAAjD,6GAAA,YAAY,OAAA;AACrB,0EAAwE;AAA/D,2HAAA,mBAAmB,OAAA;AAC5B,gDAA+C;AAAtC,kGAAA,OAAO,OAAA"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "typescript-ds-lib",
-  "version": "0.4.6",
+  "version": "0.4.7",
   "description": "A collection of TypeScript data structure implementations",
   "author": "Artiom Baloian <artiom.baloian@gmail.com>",
   "license": "MIT",