smsmslib 1.0.74 → 1.0.76

package/javascr/av_controller/HtmlControl_t.js

@@ -16,7 +16,7 @@
  * Imports.
  * --------------------------------------------------------------------------- */
 
-import {HtmlElement_t} from "../system/index.js";
+import {HtmlElement_t} from "smsmslib/javascr/core/index.js";
 
 
 /** ---------------------------------------------------------------------------

package/javascr/av_controller/HtmlMedia_t.js

@@ -19,12 +19,17 @@ import
   sj_is_number,
   sj_is_object,
   sj_prop_chg_own,
+}
+from "smsmslib/javascr/util/index.js";
+
+import
+{
   HtmlElement_t,
   sj_element_key_get,
   sj_Subject_get,
   Subject_t
 }
-from "../system/index.js";
+from "smsmslib/javascr/core/index.js";
 
 import {AvControllerState_t} from "./AvControllerState_t.js"
 

package/javascr/av_controller/HtmlPlay_t.js

@@ -19,12 +19,17 @@ import
 {
   sj_is_object,
   sj_prop_chg_own,
+}
+from "smsmslib/javascr/util/index.js";
+
+import
+{
   HtmlElement_t,
   sj_element_key_get,
   Subject_t,
   sj_Subject_get,
 }
-from "../system/index.js";
+from "smsmslib/javascr/core/index.js";
 
 import {AvControllerState_t} from "./AvControllerState_t.js"
 

package/javascr/av_controller/HtmlSkipForward_t.js

@@ -18,12 +18,17 @@ import
 {
   sj_is_object,
   sj_prop_chg_own,
+}
+from "smsmslib/javascr/util/index.js";
+
+import
+{
   HtmlElement_t,
   sj_element_key_get,
   Subject_t,
   sj_Subject_get,
 }
-from "../system/index.js";
+from "smsmslib/javascr/core/index.js";
 
 import {AvControllerState_t} from "./AvControllerState_t.js"
 

package/javascr/av_controller/HtmlSkipRewind_t.js

@@ -18,12 +18,17 @@ import
 {
   sj_is_object,
   sj_prop_chg_own,
+}
+from "smsmslib/javascr/util/index.js";
+
+import
+{
   HtmlElement_t,
   sj_element_key_get,
   Subject_t,
   sj_Subject_get,
 }
-from "../system/index.js";
+from "smsmslib/javascr/core/index.js";
 
 import {AvControllerState_t} from "./AvControllerState_t.js"
 

package/javascr/av_controller/HtmlTimerBar_t.js

@@ -8,6 +8,8 @@
  * playback state of a media element. It operates as an observer within 
  * the AV controller system, updating the element's width based on timing 
  * data (start, end, and current time). 
+ *
+ * @module javascr/av_controller/HtmlTimerBar_t
  */
 
 /** ---------------------------------------------------------------------------
@@ -17,9 +19,14 @@
 import
 {
   sj_is_object,
+}
+from "smsmslib/javascr/util/index.js";
+
+import
+{
   HtmlElement_t,
 }
-from "../system/index.js";
+from "smsmslib/javascr/core/index.js";
 
 import {AvControllerState_t} from "./AvControllerState_t.js"
 

package/javascr/av_controller/HtmlTimerDigit_t.js

@@ -21,9 +21,14 @@
 import
 {
   sj_is_object,
+}
+from "smsmslib/javascr/util/index.js";
+
+import
+{
   HtmlElement_t,
 }
-from "../system/index.js";
+from "smsmslib/javascr/core/index.js";
 
 import {AvControllerState_t} from "./AvControllerState_t.js"
 

package/javascr/av_controller/HtmlTimerFrame_t.js

@@ -15,15 +15,20 @@
  * Imports.
  * --------------------------------------------------------------------------- */
 
+import
+{
+  sj_prop_chg_own,
+}
+from "smsmslib/javascr/util/index.js";
+
 import
 {
   HtmlElement_t,
   Subject_t,
   sj_Subject_get,
   sj_element_key_get,
-  sj_prop_chg_own,
 }
-from "../system/index.js";
+from "smsmslib/javascr/core/index.js";
 
 import {AvControllerState_t} from "./AvControllerState_t.js"
 

package/javascr/av_controller/av_controller.js

@@ -18,6 +18,11 @@ import
   sj_is_object,
   sj_prop_chg_own,
   sj_array_push,
+}
+from "smsmslib/javascr/util/index.js";
+
+import
+{
   HtmlElement_t,
   new_HtmlElement,
   HtmlSelect_t,
@@ -26,7 +31,7 @@ import
   Subject_t,
   SubjectSet_t
 }
-from "../system/index.js";
+from "smsmslib/javascr/core/index.js";
 
 import {AvControllerState_t} from "./AvControllerState_t.js";
 import {HtmlMedia_t} from "./HtmlMedia_t.js";

package/javascr/{system → core}/App_t.js

@@ -2,7 +2,7 @@
  * @file App_t.js
  * @brief Application root class providing a central access point for state management.
  *
- * @module javascr/system/App_t
+ * @module javascr/core/App_t
  * --------------------------------------------------------------------------- */
 
 /** ---------------------------------------------------------------------------

package/javascr/{system → core}/HtmlElement_t.js

@@ -8,17 +8,22 @@
  * JavaScript objects and their corresponding HTML elements, providing a 
  * structured way to manage DOM nodes as observer instances.
  *
- * @module javascr/system/HtmlElement_t
+ * @module javascr/core/HtmlElement_t
  */
 
 /** ---------------------------------------------------------------------------
  * Imports.
  * --------------------------------------------------------------------------- */
 
+import
+{
+  sj_document_querySelector,
+  sj_dataset_get_own_climbing,
+  sj_is_element_node,
+}
+from "smsmslib/javascr/util/index.js"
+
 import {Observer_t} from "./Observer_t.js";
-import {sj_document_querySelector} from "./document.js";
-import {sj_dataset_get_own_climbing} from "./dataset.js"
-import {sj_is_element_node} from "./type.js"
 
 
 /** ---------------------------------------------------------------------------

package/javascr/{system → core}/Observer_t.js

@@ -7,7 +7,7 @@
  * should override these methods to implement specific behaviors, such as 
  * updating DOM elements or handling application-level events.
  *
- * @module javascr/system/Observer_t
+ * @module javascr/core/Observer_t
  * --------------------------------------------------------------------------- */
 
 /**

package/javascr/{system → core}/SubjectSet_t.js

@@ -7,14 +7,20 @@
  * to organize various data domains (e.g., user profiles, settings, state) 
  * under unique keys and provides mechanisms for collective operations.
  *
- * @module javascr/system/SubjectSet_t
+ * @module javascr/core/SubjectSet_t
  * --------------------------------------------------------------------------- */
 
 /** ---------------------------------------------------------------------------
  * Imports.
  * --------------------------------------------------------------------------- */
 
-import {sj_prop_add_own_new, sj_prop_delete_own} from "./prop.js";
+import
+{
+  sj_prop_add_own_new,
+  sj_prop_delete_own,
+}
+from "smsmslib/javascr/util/index.js"
+
 import {Subject_t} from "./Subject_t.js";
 
 

package/javascr/{system → core}/Subject_t.js

@@ -18,16 +18,21 @@
  * via `data_get()`, editing it, and then explicitly calling `observer_update()` 
  * to trigger observer synchronization.
  *
- * @module javascr/system/Subject_t
+ * @module javascr/core/Subject_t
  * --------------------------------------------------------------------------- */
 
 /** ---------------------------------------------------------------------------
  * Imports.
  * --------------------------------------------------------------------------- */
 
-import {sj_is_constructor} from "./type.js"
-import {sj_array_push} from "./arraypush.js";
-import {sj_array_concat_new} from "./arrayconcat.js";
+import
+{
+  sj_is_constructor,
+  sj_array_push,
+  sj_array_concat_new,
+}
+from "smsmslib/javascr/util/index.js"
+
 import {Observer_t} from "./Observer_t.js";
 
 

package/javascr/core/index.js

@@ -0,0 +1,14 @@
+/**
+ * @file
+ * Entry point for the core module.
+ *
+ * @module javascr/core/index
+ */
+
+export * from "./App_t.js";
+export * from "./HtmlElement_t.js";
+export * from "./Observer_t.js";
+export * from "./SubjectSet_t.js";
+export * from "./Subject_t.js";
+
+

package/javascr/index.js

@@ -5,6 +5,7 @@
  * @module javascr/index
  */
 
-export * from "./system/index.js";
+export * from "./util/index.js";
+export * from "./core/index.js";
 export * from "./av_controller/index.js";
 

package/javascr/{system → util}/index.js

@@ -1,26 +1,24 @@
 /**
  * @file
- * Entry point for the system module.
+ * Entry point for the util module.
  *
- * @module javascr/system/index
+ * @module javascr/util/index
  */
 
-export * from "./App_t.js";
-export * from "./HtmlElement_t.js";
-export * from "./Observer_t.js";
-export * from "./SubjectSet_t.js";
-export * from "./Subject_t.js";
 export * from "./array.js";
+export * from "./arrayconcat.js";
 export * from "./arraynew.js";
 export * from "./arraypush.js";
 export * from "./arraysplice.js";
-export * from "./arrayconcat.js";
-export * from "./matnew.js";
 export * from "./dataset.js";
 export * from "./document.js";
 export * from "./error.js";
 export * from "./html.js";
+export * from "./matnew.js";
+export * from "./new.js";
 export * from "./prop.js";
+export * from "./set.js";
+export * from "./tree.js";
 export * from "./type.js";
 
 

package/javascr/{system → util}/matnew.js

@@ -67,7 +67,7 @@ from "./tree.js";
  */
 export function sj_mat_new(ai_dim, initial)
 {
-  let   a_root = mat_new_init(ai_dim);
+  const a_root = mat_new_init(ai_dim);
   let   a_mat  = null;
   const o_user = sj_new_lit(() => ({ai_dim, initial}));
 

package/javascr/{system → util}/tree.js

@@ -79,12 +79,41 @@ export const go_tree_walk_ret = Object.freeze(
  * The traversal callback function.
  * It will be called for each node with the following signature:
  * `b_continue = f_cb(ao_TreeStack, from_child, user);`
- * - ao_TreeStack: The current traversal path (stack of `TreeStack_t`).
- *                 The callback typically processes the last element of this
- *                 stack (the current node context).
- * - from_child  : Data passed back from a child node(initially `GI_FROM_CHILD_INI`).
- * - user        : User-defined data.
- * - Returns     : true to continue descending/traversing, false to stop.
+ *
+ * - **ao_TreeStack**: The current traversal path (stack of `TreeStack_t`).
+ *                     The callback typically processes the last element of this
+ *                     stack (the current node context).
+ * - **from_child**  : Data passed back from a child node(initially `GI_FROM_CHILD_INI`).
+ * - **user**        : User-defined data.
+ * - **Returns**     : true to continue descending/traversing, false to stop.
+ *
+ * ### Traversal Orders and Callback Timing
+ * The callback `f_cb` is invoked **(1 + number of children)** times for each node.
+ * It is called once when the node is first visited, and then once after each child
+ * node's traversal is completed.
+ * Let `o_TreeStack = ao_TreeStack.at(-1)`.
+ *
+ * - **`o_TreeStack.child`**:
+ *   Initialized to `null` if `o_TreeStack.i_child` is 0. Otherwise remains as previously
+ *   set. The callback should set the `i_child`-th child node here to drive the descent 
+ *   if one exists; otherwise, set to null.
+ *
+ * - **`o_TreeStack.to_parent`**:
+ *   Data written here will be passed back to the parent as `from_child' during ascent.
+ *
+ * - **Leaf node**:
+ *   When `o_TreeStack.i_child === 0` and o_TreeStack has no child.
+ *
+ * - **Leading Order**:
+ *   Occurs when `o_TreeStack.i_child === 0`. 
+ *
+ * - **Middle Order**:
+ *   Occurs if o_TreeStack is a leaf, or when `o_TreeStack.i_child === 1`.
+ *
+ * - **Trailing Order**:
+ *   Occurs when o_TreeStack has no more children to visit. 
+ *
+ * By checking these conditions, you can implement logic for specific traversal orders.
  *
  * @param {any} root [in]
  * The root node of the tree to start walking from.

package/package.json

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