Merge pull request #158 from BrianLusina/feat/algorithms-dynamic-programming-interleaving-string

feat(algorithms, dynamic-programming): interleaving string

Author: BrianLusina

DIRECTORY.md

@@ -67,6 +67,8 @@
       * [Test Max Duffle Bag Value](https://github.com/BrianLusina/PythonSnips/blob/master/algorithms/dynamic_programming/duffle_bug_value/test_max_duffle_bag_value.py)
     * House Robber
       * [Test House Robber](https://github.com/BrianLusina/PythonSnips/blob/master/algorithms/dynamic_programming/house_robber/test_house_robber.py)
+    * Interleaving String
+      * [Test Interleaving String](https://github.com/BrianLusina/PythonSnips/blob/master/algorithms/dynamic_programming/interleaving_string/test_interleaving_string.py)
     * Knapsack 01
       * [Test Knapsack 01](https://github.com/BrianLusina/PythonSnips/blob/master/algorithms/dynamic_programming/knapsack_01/test_knapsack_01.py)
     * Longest Common Subsequence

algorithms/dynamic_programming/interleaving_string/README.md

@@ -0,0 +1,118 @@
+# Interleaving String
+
+You’re given three strings: s1, s2, and s3. Your task is to determine whether s3 can be formed by interleaving s1 and s2.
+
+Interleaving means you take both strings and break them into smaller pieces (substrings), then merge those pieces while
+preserving the left-to-right order of characters within each original string.
+
+- s = s1 + s2 + ... + sn
+- t = t1 + t2 + ... + tm
+- |n - m| <= 1
+
+The final mixed string might look like any of the following:
+
+1. s1 + t1 + s2 + t2 + s3 + t3 + ... or 
+2. t1 + s1 + t2 + s2 + t3 + s3 + ...
+
+The pieces from s1 and s2 must appear in alternating segments, although either one is allowed to start first. The number
+of segments taken from each string should differ by at most one.
+
+## Constraints
+
+- 0 <= s1.length, s2.length <= 100
+- 0 <= s3.length <= 200
+- s1, s2, and s3 consist of lowercase English letters.
+
+## Topics
+
+- Strings
+- Dynamic Programming
+
+## Examples
+
+![Example 1](./images/examples/interleaving_string_example_1.png)
+![Example 2](./images/examples/interleaving_string_example_2.png)
+![Example 3](./images/examples/interleaving_string_example_3.png)
+![Example 4](./images/examples/interleaving_string_example_4.png)
+![Example 5](./images/examples/interleaving_string_example_5.png)
+![Example 6](./images/examples/interleaving_string_example_6.png)
+![Example 7](./images/examples/interleaving_string_example_7.png)
+
+> Input: s1 = "aabcc", s2 = "dbbca", s3 = "aadbbcbcac"
+> Output: true 
+> Explanation: One way to obtain s3 is:
+> Split s1 into s1 = "aa" + "bc" + "c", and s2 into s2 = "dbbc" + "a". 
+> Interleaving the two splits, we get "aa" + "dbbc" + "bc" + "a" + "c" = "aadbbcbcac". 
+> Since s3 can be obtained by interleaving s1 and s2, we return true.
+
+## Solution
+
+The goal is to determine whether the string s3 can be formed by interleaving the characters of s1 and s2 while
+preserving the original character order of both strings. This problem naturally lends itself to a dynamic programming
+approach because whether a prefix of s3 is valid depends on whether smaller prefixes were valid before it.
+
+Instead of building a full 2D DP table, we use a 1D DP array to save space. In this array, dp[j] represents whether the
+prefix s3[:i + j] can be formed by interleaving s1[:i] and s2[:j]. Although this 1D array conceptually corresponds to the
+(i, j)-cell of a 2D grid, we will reuse the same array row by row, updating values in place as it progresses through the
+characters of s1 and s2.
+
+We start from the simplest case, two empty strings forming an empty string, and work our way up. For each character in
+s3, we check if it could have come from the next available character in s1 or s2.
+
+A state is considered possible only if:
+
+- The previous state was valid. 
+- The character we take (from s1 or s2) matches the next character in s3.
+
+The computation continues until all combinations of prefixes have been evaluated. The final answer resides in dp[len(s2)],
+which indicates whether all of s1 and s2 can interleave to form all of s3.
+
+The algorithm can be broken down into the following steps:
+
+1. We first check if the length of s3 is equal to the sum of the lengths of s1 and s2. If not, a valid interleaving is
+   impossible, so we immediately return FALSE.
+2. Next, we create a 1D array, dp, of size len(s2) + 1, initially filled with FALSE values. This array represents a
+   compressed version of the conceptual DP table, where dp[j] indicates whether s3[:i + j] can be formed using s1[:i] and
+   s2[:j]. As the array is reused for each row, dp[j] always holds the result for the current (i, j) state.
+3. We iterate through all prefixes of s1 and s2 using two loops, i goes from 0 to len(s1), and j goes from 0 to len(s2):
+   - For each pair (i, j), dp[j] is updated according to one of four cases:
+     - If i == 0 and j == 0, we are matching empty prefixes. We set dp[0] to TRUE because two empty strings always form
+       an empty string.
+     - Else if i == 0 (we are in the first row), we can only use characters from s2. dp[j] becomes TRUE only if dp[j − 1]
+       was TRUE and s2[j − 1] matches s3[j − 1].
+     - Else if j == 0 (we are in the first column), we can only use characters from s1. Because dp is a 1D array, dp[0]
+       still holds the result from the previous row (i − 1). We update dp[0] to TRUE only if its previous value was TRUE
+       and s1[i − 1] matches s3[i − 1].
+     - Otherwise, i > 0 and j > 0, we evaluate the general case, dp[j] becomes TRUE if either of the following is possible:
+       - Taking the next character from s1: dp[j] must have been TRUE (its old value from the previous row), and s1[i − 1]
+         must match s3[i + j − 1].
+       - Taking the next character from s2: dp[j − 1] must be TRUE (already updated for the current row), and s2[j − 1]
+         must match s3[i + j − 1].
+       - If either option is valid, dp[j] is set to TRUE.
+4. After all iterations are complete, return dp[len(s2)] containing the final answer, telling all of s1 and s2 can
+   interleave to form all of s3.
+
+![Solution 1](./images/solutions/interleaving_string_solution_1.png)
+![Solution 2](./images/solutions/interleaving_string_solution_2.png)
+![Solution 3](./images/solutions/interleaving_string_solution_3.png)
+![Solution 4](./images/solutions/interleaving_string_solution_4.png)
+![Solution 5](./images/solutions/interleaving_string_solution_5.png)
+![Solution 6](./images/solutions/interleaving_string_solution_6.png)
+![Solution 7](./images/solutions/interleaving_string_solution_7.png)
+![Solution 8](./images/solutions/interleaving_string_solution_8.png)
+![Solution 9](./images/solutions/interleaving_string_solution_9.png)
+![Solution 10](./images/solutions/interleaving_string_solution_10.png)
+![Solution 11](./images/solutions/interleaving_string_solution_11.png)
+
+### Time Complexity
+
+The solution’s time complexity is O(m×n), where m is the length of string s1 and n is the length of string s2. The
+algorithm iterates through every combination of prefixes of s1 and s2. Specifically, the outer loop runs len(s1) + 1
+times and the inner loop runs len(s2) + 1 times, resulting in a total of m+1×n+1 iterations. Each iteration performs
+constant-time operations, so the total time is quadratic in the lengths of the input strings.
+
+### Space Complexity
+
+The solution’s space complexity is O(n) because instead of storing a full 2D DP table, it uses a 1D array of size
+len(s2) + 1. This array is updated in place for each row, and no additional data structures are used that are
+proportional to the input size.

algorithms/dynamic_programming/interleaving_string/__init__.py

@@ -0,0 +1,83 @@
+from functools import cache
+
+
+def is_interleave_dp_top_down(s1: str, s2: str, s3: str) -> bool:
+    """
+    Checks if it is possible to form string 3 from s1 and s2 by interleaving them such that either characters from s1
+    start or characters from s2 start.
+    Args:
+        s1(str): first string
+        s2(str): second string
+        s3(string): potentially interleaved string
+    Returns:
+        bool: True if it is possible to interleave s1 and s2 to form s3, False otherwise
+    """
+    len_s1, len_s2, len_s3 = len(s1), len(s2), len(s3)
+
+    # If the length of s1 and s2 sum up to a value less than s3, we cannot interleave them to form s3
+    if (len_s1 + len_s2) != len_s3:
+        return False
+
+    @cache
+    def dfs(p1: int, p2: int) -> bool:
+        """
+        Recursively check if can form the remaining part of s3 from s1 and s2
+        Args:
+            p1(int): current index at s1
+            p2(int): current index at s2
+        Returns:
+            bool: True if characters at (p1 + p2) can form the remaining part of s3
+        """
+        # base case, if we have used all the characters from both strings, we return True
+        if p1 >= len_s1 and p2 >= len_s2:
+            return True
+
+        # Get the current position in s3
+        p3 = p1 + p2
+
+        # If we can still iterate through s1 and the character at the current position at s3 equals s1, we can take the
+        # character from s1
+        if p1 < len_s1 and s1[p1] == s3[p3]:
+            # Recursively call dfs to check if the rest can form a valid interleaving string
+            if dfs(p1 + 1, p2):
+                return True
+        if p2 < len_s2 and s2[p2] == s3[p3]:
+            # Recursively call dfs to check if the rest can form a valid interleaving string
+            if dfs(p1, p2 + 1):
+                return True
+        return False
+
+    return dfs(0, 0)
+
+
+def is_interleave_dp_bottom_up(s1, s2, s3):
+    len_s1, len_s2, len_s3 = len(s1), len(s2), len(s3)
+    # If lengths don't add up, interleaving is impossible
+    if len_s3 != len_s1 + len_s2:
+        return False
+
+    # 1D DP array; dp[j] represents using s1[:i] and s2[:j]
+    dp = [False] * (len_s2 + 1)
+
+    # Iterate over prefixes of s1 (i) and s2 (j)
+    for i in range(len_s1 + 1):
+        for j in range(len_s2 + 1):
+            if i == 0 and j == 0:
+                # Empty + empty = empty → valid
+                dp[j] = True
+
+            elif i == 0:
+                # First row: can only use s2's characters
+                dp[j] = dp[j - 1] and s2[j - 1] == s3[j - 1]
+
+            elif j == 0:
+                # First column: can only use s1's characters
+                dp[j] = dp[j] and s1[i - 1] == s3[i - 1]
+
+            else:
+                # General case: take from s1 or s2 if they match s3
+                take_from_s1 = dp[j] and s1[i - 1] == s3[i + j - 1]
+                take_from_s2 = dp[j - 1] and s2[j - 1] == s3[i + j - 1]
+                dp[j] = take_from_s1 or take_from_s2
+
+    return dp[len(s2)]