In this release, new concept of multi structure is introduce. This multi structure enables snapper/entry to have nested same-classification children. For example, a multi bay has 2 sub bay children. In order to support this structure, there are few behaviors and engine functions added to handle these multi cases separately from the normal structure.

class MhStorageSpawnerSelector

Updated logic and method to find best matched spawner by including the minimum numbers of non-matched symbols.

Removed:
    /**
     * Find best match spawner.
     */
    extend public SnapperSpawner findBestMatchSpawner(LayerSet classification, SnapperSpawner current, MhAssortment assortment, bool &exactMatch) {
        if (MhSpawnerStore spawnerStore = assortment.?spawnerStore) {
            int maxMatchCount;
            // use all sorted to ensure consistency.
            for (_, spawner in spawnerStore.allSorted()) {
                if (!accepts(classification, spawner)) continue;

                // prioritize exact match
                if (classification.equal(spawner.classification)) {
                    current = spawner;
                    exactMatch = true;
                    break;
                }

                LayerSet intersect = classification*spawner.classification;
                int layerMatchCount = intersect.count;
                if (layerMatchCount > maxMatchCount) {
                    current = spawner;
                    maxMatchCount = layerMatchCount;
                }
            }
        }

        return current;
    }


Added:
    /**
     * Find best match spawner.
     */
    extend public SnapperSpawner findBestMatchSpawner(LayerSet classification, MhSnapperSpawner[] spawners) {
        SnapperSpawner res = null;
        int maxMatchCount = -maxInt;
        int minRemainder = maxInt;

        // use all sorted to ensure consistency.
        for (spawner in spawners) {
            if (!accepts(classification, spawner)) continue;
            
            // prioritize exact match
            LayerSet ls = spawner.classification;
            if (classification.equal(ls)) {
                res = spawner;
                break;
            }
            
            LayerSet intersect = classification*ls;
            if (!intersect) continue;

            int layerMatchCount = intersect.count;
            int remainder = (ls - intersect).count;

            if (layerMatchCount > maxMatchCount or remainder < minRemainder) {
                res = spawner;
                maxMatchCount = layerMatchCount;
                minRemainder = remainder;
            }
        }
        
        return res;
    }

class MhBayEditorItem

The method forceRebuildProps(MhStorageEditorDialog dialog) has been moved into the parent class MhStorageEditorItem.

Frame editor changes

Function mhFrameEditorReinsertFrames has been made public.

Old: package void mhFrameEditorReinsertFrames(MhStorageEditorSpace space) {
New: public void mhFrameEditorReinsertFrames(MhStorageEditorSpace space) {

class MhStorageConfiguration

Removed deprecated method unitLoadCountX().

public class MhStorageConfiguration extends MhSystemConfiguration {

Removed:
    extend public int unitLoadCountX() : deprecated {
        return getValue(cMhNoOfUnitLoadsPK).?int;
    }
}

class MhSingleUprightFrameShape

The class MhSingleUprightFrameShape is removed.

Removed: public class MhSingleUprightFrameShape extends MhFrameShape {

class MhUpdateImportPrimsFunction

The class MhUpdateImportPrimsFunction has been removed as it is not used in the abstract.

Removed: public class MhUpdateImportPrimsFunction extends MhSystemEngineFunction : deprecated {

class MhRowChildrenUnlinkFunction

The class MhRowChildrenUnlinkFunction has been removed as it is not used in the abstract.

Removed: public class MhRowChildrenUnlinkFunction extends MhSystemEngineFunction : deprecated {

MhRowPickUpFrameVessel changes

This vessel has a new field addSelection which acts as a flag to add snapper's selection to the list of selection.

public class MhRowPickUpFrameVessel extends MhApplyColorFrameVessel {
    /**
     * Add Selection.
     */
    public bool addSelection;

    /**
     * Constructor.
     */
    public constructor(str key, bool active=true, CoreObject owner=null, str->Object args=null,
    Object env=null, symbol{} tags=null, color c=color(224, 32, 32)|, bool addSelection=true) {
            super(..|);
            this.addSelection = addSelection;
    }

    /**
     * Add to selection.
     */
    public Snapper{} addToSelection(Snapper s) {
            if (addSelection) return super(..);
            return null;
    }
}

MhStorageSelectionBehavior changes

Renamed the following method:

public class MhStorageSelectionBehavior extends MhSelectionBehavior {

Old: extend public void addtionalSnapperInSelection(MhSnapper snapper, SnapperSelection sel, Line mouseLine) { }
New: extend public void additionalSnapperInSelection(MhSnapper snapper, SnapperSelection sel, Line mouseLine) { }
}

MhRowChildSelectionBehavior changes

Renamed the following methods:

public class MhRowChildSelectionBehavior extends MhStorageSelectionBehavior {

Old: extend public bool addtionalLinkedSnappers(MhSnapper snapper, SnapperSelection sel, Line mouseLine) {
New: extend public bool additionalLinkedSnappers(MhSnapper snapper, SnapperSelection sel, Line mouseLine) {


Old: extend public void addtionalFilteredSnappers(MhSnapper snapper, SnapperSelection sel, Line mouseLine) {
New: extend public void additionalFilteredSnappers(MhSnapper snapper, SnapperSelection sel, Line mouseLine) {
}

MhBayEntryLayout changes

Removed the following fields and methods as well as renamed levelsEntries to levelEntries.

With the removal of getLevelEntry(bool first, bool last), replace it with getLevelEntry(bool first, bool last, int idx=-1).

We have undeprecated constructor(MhEngineConstructionEntry levelEntry, MhEngineConstructionEntry botLevelEntry=null, MhEngineConstructionEntry topLevelEntry=null) and updated it to work with the field levelEntries.

public class MhBayEntryLayout extends MhEntryLayout {

Removed: public MhEngineConstructionEntry levelEntry : deprecated;


Old: public MhEngineEntry[] levelsEntries;
New: public MhEngineEntry[] levelEntries;


Removed:
    extend public MhEngineConstructionEntry getLevelEntry(bool first, bool last) : deprecated {
        return getLevelEntry(.., idx=-1).MhEngineConstructionEntry;
    }
}

Constants changes

cPredefinedConfig has been renamed to cPredefinedBayConfigDefVal and its value has been modified from _predefinedConfig to _predefinedBayConfigDefault to better reflect its usage.

Old: 
/**
 * Predefine key.
 */
public const str cPredefinedConfig = "_predefinedConfig";


New:
/**
 * Predefined bay config default value.
 */
public const str cPredefinedBayConfigDefVal = "_predefinedBayConfigDefault";

A constant mhFrameHeighDiffKey was moved from abstract.materialHandling to abstract.materialHandling.storage.

public const str mhFrameHeighDiffKey = "frameHeightDiff";

Few unit load functions are moved

The functions removeUniqueName, unitLoadEq, and findEqualUnitLoad are moved to cm/abstract/unitLoad/functions.cm from cm/abstract/materialHandling/storage/unitLoadFunctions.cm.

Moved:
    public str removeUniqueName(Object o) {
    public bool unitLoadEq(UnitLoad unitLoad, UnitLoad l) {
    public UnitLoad findEqualUnitLoad(UnitLoad unitLoad, World w=null) {

MhBayUpdateFramesFunction changes

MhBayUpdateFramesFunction now include children to framesToUpdate to get updated if the classification is eval to its parent.

MhLevelArrangeFunction changes

MhLevelArrangeFunction now only sort children that are levels.

MhBayShape changes

MhBayShape will now adjust to its owner's parent if it is also a bay.

    public bool adjustTo(Snapper toSnapper, Object env=null) {
        ...
            } else if (isBay(owner) and toSnapper.isBay) {
                box b = owner.shapeBound([sBay]);
                box lb = toSnapper.shapeBound([sBay]);

                if (adjustWidth(owner, toSnapper, b, lb, env)) adjusted = true;
            }
        ...
    }

MhShuttleRailShape changes

Shuttle rail's shape will now only add front beam if the classification is not the rootParent row is not front row and inner.

Old:
    extend public bool shoudAddFrontBeam() { return true; }
New:
    extend public bool shoudAddFrontBeam() {
        if (?MhSnapper root = owner.?rootParent) {
            if (root.classification.isFrontRow and root.classification.isInner)
            return false;
        }
        return true;
    }

MhAnimRowConstructionalFunction changes

In createRowEntry(MhEngineEntryBlock block, MhEngineConstructionEntry e) method, if entry is in visited, it will also copy the visited entry's classification when we copy the visited entry's children. This is due to the visited entry's classification might get updated during runEntryFunctions, so the entry should get the same classification as well as we assume visited entry and entry would be exactly the same.

    extend public MhEngineConstructionEntry createRowEntry(MhEngineEntryBlock block, MhEngineConstructionEntry e) {
        ...
                for (MhEngineConstructionEntry ce in children) {
                str k = entryCacheKey(ce);
                if (k in visited) {
                    ?MhEngineConstructionEntry ee = visited.get(k);
                    for (MhEngineConstructionEntry c in ee.children(null)) ce << c.toConstructionEntry();
                    ce.classification = ee.classification; //copy the classification too
                }
        ...
    }

Bay/Frame editor undo changes

Introduced some new interfaces in MhStorageEditorConfiguration to use non-serious undo when changing property values in a configuration item. This can be used in conjunction with a new UndoOp MhStorageEditorConfigPropModifyUndoOp that can restore a configuration property value, used when a configuration value is not pushed to the snappers.

public class MhStorageEditorConfiguration extends MhSystemConfiguration {

    /**
     * Property uses serious undo?
     */
    extend public bool propertyUsesSeriousUndo(MhStorageEditorItem item, CoreProperty property) {
        return true;
    }


    /**
     * Before property changed.
     */
    extend public void beforePropertyChange(MhStorageEditorItem item, CoreProperty property) {
        ...
                    if (propertyUsesSeriousUndo(item, property)) {
                        space.beginSeriousUndoStep(undoSnappers, space);
                    } else {
                        space.beginUndoStep();
                        space.beginUndoRecording();
                        for (s in undoSnappers) space.recordForUndo(s);
                    }
        ...
    }


    /**
     * After property changed.
     */
    extend public void afterPropertyChanged(MhStorageEditorItem item, CoreProperty property) {
        ...
            if (propertyChangeLevel == 0) {
                if (propertyUsesSeriousUndo(item, property)) {
                    if (space.seriousUndoMode) {
                        space.?endSeriousUndoStep(undoSnappers, description=$editorItemChanged);
                    }
                } else {
                    space.endUndoRecording();
                    space.endUndoStep();
                }
        ...
    }
}

To support non-serious undo, MhFrameEditConfiguration.pushPropToPreview() no longer disables undo. This is so that non-serious undo also records changes made to MhFrameEditConfiguration.refSpace snappers by the engine within pushPropToPreview(). This change was made earlier for MhBayEditConfiguration.pushPropToPreview() but we are now making them work similarly. This should not affect you unless you are calling pushPropToPreview in your code while recording for non-serious undo.

Bay spawner changes

The behavior mhBaySelectionBehavior has been added to MhBaySpawner default behaviors. If your class that extends from MhBaySpawner is adding the same behavior, you can now remove it. If your class already adds a different selection behavior and you want to retain that instead, you should override customOtherBehaviors() and exclude mhBaySelectionBehavior after super(), e.g. behaviors.exclude(mhBaySelectionBehavior);.

Additionally, the behaviors mhBaySpreadPatternBehavior and mhBayEditorMeasurementsBehavior were previously added in gatherBehaviors(MhBehavior[] behaviors). They have now been moved to customOtherBehaviors() instead.

public class MhBaySpawner extends MhStorageSpawner {

     /**
     * CustomOtherBehaviors.
     */
    public MhBehavior[] customOtherBehaviors() {
        ...
        behaviors << mhBaySelectionBehavior;
        behaviors << mhBaySpreadPatternBehavior;
        behaviors << mhBayEditorMeasurementsBehavior;
    }
}

MhUnitLoadShape changes

Instead of putting unit load as a MemoryStream into the propData, we now directly put the unit load object itself.

Old:
    extend public void streamUnitLoad(ObjectFormatter formatter) {
        str key = unitLoadKey.?v;
        Object o = null;
        for (Str t, v in formatter.tempData) if (t and t.v == key) { o = v; break; }

        if (!o) {
            o = objectToMemoryStream(unitLoad);
            ...

New:
    extend public void streamUnitLoad(ObjectFormatter formatter) {
        str key = unitLoadKey.?v;
        Object o = null;
        for (Str t, v in formatter.tempData) if (t and t.v == key) { o = v; break; }

        if (!o) {
            o = unitLoad;
            ...

Double Deep check changes

As we are moving towards the multi layout concept, we change double deep checking to check for the child depth now instead of the classification. For example, these few places are

at MhLevelConstructionalPopulateFunction :

Old:
    extend public double addStaticLevels(double z) {   
            MhEngineEntry rowEntry = parent.rootParent(engine.MhEngine);
            if (rowEntry.?isDoubleDeep) return z;
        ...

New:
    extend public double addStaticLevels(double z) {  
        if (parent.childDepth(engine.MhEngine) > 1) return z;
        ...

at MhFrameConfigBehavior :

Old:
    public bool shouldPutConfigToManager(MhSnapper z) {
            Snapper root = z.rootParent;
            if (root.isDoubleDeep) return !root.isBackRow;
        ...
New:
    public bool shouldPutConfigToManager(MhSnapper z) {
        if (z.childDepth > 1) return false; //TODO revisit this, handle multi deep config properly
        ...

class MhRowChildCopyPasteBehavior

MhRowChildCopyPasteBehavior has been updated to also with with cut-paste actions. This class is meant to work together with the MhRowChildFavoriteAnimationG2 animation that will generate new rows for the pasted row-child snappers. It has now been updated to also work with cut-paste, you can now cut row-child snappers and pasting should generate new row snappers for them.

Below are the updates done to support this:

public class MhRowChildCopyPasteBehavior extends MhBehavior {

    /**
     * Selected.
     * Put mhParentGid on selected so we can use it with userCut.
     */
    public void selected(MhSnapper snapper) {
        if (Snapper parent = snapper.parent) snapper.fastPut("mhParentGid", parent.gid.hex, mhParentGidDef);
    }


    /**
     * Deselected.
     */
    public void deselected(MhSnapper snapper) {
        snapper.fastRemove("mhParentGid");
    }


    /**
     * User cut.
     */
    public void userCut(MhSnapper snapper, SpaceSelection selection) {
        snapper.fastRemove("mhParentGid");
    }
}