@jetta/blocks-allocator 0.2.1-3 → 0.2.1-4

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@jetta/blocks-allocator",
-    "version": "0.2.1-3",
+    "version": "0.2.1-4",
     "description": "Blocks wall allocation library",
     "main": "src/index.js",
     "exports": {
@@ -41,7 +41,7 @@
     "license": "ISC",
     "dependencies": {
         "@jetta/axle-load-calculator": "^0.4.1",
-        "@jetta/empty-spaces-manager": "^0.1.1-0",
+        "@jetta/empty-spaces-manager": "^0.1.2-1",
         "@jetta/item-amount-controller": "0.1.0-0",
         "@jetta/logger": "^2.0.1",
         "@jetta/lp-framework": "2.1.0-6",

package/src/space_and_block_chooser/build_allocated_item_snapshots.js

@@ -1,19 +1,108 @@
 /**
- * Maps allocated container items to empty-space chooser snapshots.
- * @param {object} container - Container with get_allocated_items().
- * @returns {Array<{ x: number, y: number, z: number, width: number, height: number, length: number }>}
+ * @param {object} item - Allocated item.
+ * @param {string} reader_name - Accessor name.
+ * @returns {string|undefined} Non-empty text when the accessor returns one.
  */
-function build_allocated_item_snapshots(container)
+function optional_identity(item, reader_name)
 {
-    const allocated_items = container.get_allocated_items?.() ?? []
-    return allocated_items.map(item => ({
+    const reader = item[reader_name]
+    if (typeof reader !== 'function')
+    {
+        return undefined
+    }
+    const value = reader.call(item)
+    if (typeof value !== 'string' || value.length === 0)
+    {
+        return undefined
+    }
+    return value
+}
+
+/**
+ * @param {object} snapshot - Geometry snapshot.
+ * @param {object} item - Allocated item.
+ * @returns {object} Snapshot with identity fields when the item exposes them.
+ */
+function assign_identity(snapshot, item)
+{
+    const item_id = optional_identity(item, 'get_id')
+    const tie_ratio_orientation = optional_identity(item, 'get_tie_ratio_orientation')
+    if (item_id !== undefined)
+    {
+        snapshot.item_id = item_id
+    }
+    if (tie_ratio_orientation !== undefined)
+    {
+        snapshot.tie_ratio_orientation = tie_ratio_orientation
+    }
+    return assign_stacking(snapshot, item)
+}
+
+/**
+ * @param {object} item - Allocated item.
+ * @returns {object|undefined} Stacking info from the item or its source.
+ */
+function read_stacking_info(item)
+{
+    const source = typeof item.get_stacking_source_item === 'function'
+        ? item.get_stacking_source_item()
+        : item
+    if (typeof source.get_stacking_info !== 'function')
+    {
+        return undefined
+    }
+    return source.get_stacking_info()
+}
+
+/**
+ * @param {object} snapshot - Geometry snapshot.
+ * @param {object} item - Allocated item.
+ * @returns {object} Snapshot with stacking fields when present.
+ */
+function assign_stacking(snapshot, item)
+{
+    const info = read_stacking_info(item)
+    if (!info)
+    {
+        return snapshot
+    }
+    if (typeof info.stacking_family === 'string' && info.stacking_family.length > 0)
+    {
+        snapshot.stacking_family = info.stacking_family
+    }
+    if (Array.isArray(info.supported_families) && info.supported_families.length > 0)
+    {
+        snapshot.supported_families = info.supported_families
+    }
+    return snapshot
+}
+
+/**
+ * @param {object} item - Allocated item.
+ * @returns {object} Chooser snapshot.
+ */
+function snapshot_from_item(item)
+{
+    const snapshot = {
         x: item.get_x(),
         y: item.get_y(),
         z: item.get_z(),
         width: item.get_width(),
         height: item.get_height(),
         length: item.get_length()
-    }))
+    }
+    return assign_identity(snapshot, item)
+}
+
+/**
+ * Maps allocated container items to empty-space chooser snapshots.
+ * @param {object} container - Container with get_allocated_items().
+ * @returns {Array<object>} Geometry plus optional identity and stacking fields.
+ */
+function build_allocated_item_snapshots(container)
+{
+    const allocated_items = container.get_allocated_items?.() ?? []
+    return allocated_items.map(snapshot_from_item)
 }
 
 module.exports = build_allocated_item_snapshots