refactor(v4.0.0-alpha): beginning of a new era

libs/utils/src/namespaces/array.ts

@@ -0,0 +1,76 @@
+import { LayoutLocator } from "./types";
+
+type CombinationsInput<T> = {
+  [K in keyof T]: T[K][];
+};
+
+export const generateCombinations = <T>(obj: CombinationsInput<T>): Array<T> => {
+  const keys = Object.keys(obj) as (keyof T)[];
+
+  const results: Array<T> = [];
+
+  function backtrack(combination: Partial<T>, index: number): void {
+    if (index === keys.length) {
+      results.push(combination as T);
+      return;
+    }
+
+    const key = keys[index];
+    const values = obj[key];
+
+    for (const value of values) {
+      backtrack({ ...combination, [key]: value }, index + 1);
+    }
+  }
+
+  backtrack({}, 0);
+
+  return results;
+};
+
+// Function to find a specific item in a layout
+export const findItemInLayout = (item: string, layout: string[][][]): LayoutLocator | null => {
+  for (let page = 0; page < layout.length; page++) {
+    for (let column = 0; column < layout[page].length; column++) {
+      for (let section = 0; section < layout[page][column].length; section++) {
+        if (layout[page][column][section] === item) {
+          return { page, column, section };
+        }
+      }
+    }
+  }
+
+  return null;
+};
+
+// Function to remove a specific item in a layout
+export const removeItemInLayout = (item: string, layout: string[][][]): LayoutLocator | null => {
+  const locator = findItemInLayout(item, layout);
+
+  if (locator) {
+    layout[locator.page][locator.column].splice(locator.section, 1);
+  }
+
+  return locator;
+};
+
+// Function to move an item within a layout
+export const moveItemInLayout = (
+  current: LayoutLocator,
+  target: LayoutLocator,
+  layout: string[][][],
+): string[][][] => {
+  // Create a deep copy of the layout to avoid mutating the original array
+  const newLayout = JSON.parse(JSON.stringify(layout)) as string[][][];
+
+  // Get the item from the current location
+  const item = newLayout[current.page][current.column][current.section];
+
+  // Remove the item from the current location
+  newLayout[current.page][current.column].splice(current.section, 1);
+
+  // Insert the item at the target location
+  newLayout[target.page][target.column].splice(target.section, 0, item);
+
+  return newLayout;
+};