smsmslib 1.0.87 → 1.0.88

package/javascr/util/matnew.js

@@ -40,11 +40,101 @@ import
 }
 from "./tree.js";
 
+import
+{
+  sj_deep_set_own,
+}
+from "./deep.js";
+
+import
+{
+  sj_deepwalk,
+  sj_deepwalk_path,
+}
+from "./deepwalk.js";
+
 
 /** ---------------------------------------------------------------------------
  * Functions.
  * --------------------------------------------------------------------------- */
 
+/**
+ * Creates a deep copy of a matrix.
+ *
+ * @param {any} a_src [in]
+ * The source matrix to be copied. This must be a matrix structure previously 
+ * created using `sj_mat_new`.
+ *
+ * @param {number[]} a_dim [in]
+ * An array of integers representing the dimensions of the matrix. 
+ * This must be identical to the dimensions used to create `a_src` (though the 
+ * actual instance may differ). For example, if `a_src` is a 2x3 matrix, 
+ * `a_dim` must be [2, 3].
+ *
+ * @returns {any|null}
+ * A new deep-copied matrix if successful; otherwise, null if allocation or 
+ * traversal fails.
+ */
+export function sj_mat_new_copy(a_src, a_dim)
+{
+  let i_ret = go_tree_walk_ret.i_fatal;
+  let a_dst = sj_mat_new(a_dim, 0);
+
+  if (a_dst)
+  {
+    i_ret = sj_deepwalk(a_src, a_dim.length + 1, mat_new_copy_cb, a_dst);
+  }
+
+  if (i_ret !== go_tree_walk_ret.i_ok)
+  {
+    a_dst = null;
+  }
+
+  return a_dst;
+}
+
+
+/**
+ * Callback function for deeply copying matrix elements during a deep walk.
+ * This function is intended to be used as a callback for `sj_deepwalk`. 
+ *
+ * @param {Object[]} ao_TreeStack [in]
+ * The current traversal stack from `sj_deepwalk`, containing node information. 
+ *
+ * @param {number} i_depth [in]
+ * The current depth of the traversal.
+ * - 1 indicates the root element.
+ * - In a 2D matrix (array of arrays), 3 represents a leaf node (the actual value).
+ *
+ * @param {any} a_dst [in,out]
+ * The destination matrix (object or array) where values will be copied. 
+ * The structure must be pre-allocated.
+ *
+ * @returns {boolean}
+ * true to continue the traversal; false if a path could not be resolved.
+ */
+function mat_new_copy_cb(ao_TreeStack, i_depth, a_dst)
+{
+  let b_continue = true;
+
+  if (i_depth === ao_TreeStack.length)
+  {
+    const o_TreeStack = ao_TreeStack.at(- 1); /* tail */
+    const src         = o_TreeStack.node.value;
+    const as_path     = sj_deepwalk_path(ao_TreeStack);
+
+    b_continue = !!as_path;
+
+    if (b_continue)
+    {
+      b_continue = sj_deep_set_own(a_dst, as_path, src);
+    }
+  }
+
+  return b_continue;
+}
+
+
 /**
  * Creates a multi-dimensional array (matrix) with specified dimensions.
  * This function constructs a nested array structure based on the provided 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "smsmslib",
-  "version": "1.0.87",
+  "version": "1.0.88",
   "description": "Reusable functions for me.",
   "files": [
     "javascr/**/*.js",
@@ -19,6 +19,6 @@
   "author": "",
   "license": "ISC",
   "dependencies": {
-    "smsmslib": "^1.0.87"
+    "smsmslib": "^1.0.88"
   }
 }