@sme.up/ketchup 6.0.0 → 6.2.0

package/dist/esm/kup-form.entry.js

@@ -0,0 +1,476 @@
+import { r as registerInstance, f as forceUpdate, h, H as Host, g as getElement } from './index-ad6ab214.js';
+import { k as kupManagerInstance, _ as FCellTypes, h as KupLanguageGeneric } from './kup-manager-22a475e6.js';
+import { i as identify, g as getProps, s as setProps } from './utils-2c1f4122.js';
+import { c as componentWrapperId } from './GenericVariables-665de00a.js';
+import { F as FCell } from './f-cell-7b159a22.js';
+import { F as FTextFieldMDC } from './f-text-field-mdc-d42d3f9e.js';
+import './cell-utils-cb5d4149.js';
+import './f-checkbox-c51c4a75.js';
+import './f-text-field-41c575eb.js';
+import './f-image-2ab4b9aa.js';
+import './f-chip-c2e4c522.js';
+import './tslib.es6-3eea2234.js';
+import './component-b1bedf1d.js';
+
+/**
+ * Props of the kup-form component.
+ * Used to export every prop in an object.
+ */
+var KupFormProps;
+(function (KupFormProps) {
+  KupFormProps["customStyle"] = "Custom style of the component.";
+  KupFormProps["data"] = "Actual data of the form.";
+  KupFormProps["layout"] = "How the form will arrange its content.";
+})(KupFormProps || (KupFormProps = {}));
+var KupFormLabelAlignment;
+(function (KupFormLabelAlignment) {
+  KupFormLabelAlignment["CENTER"] = "center";
+  KupFormLabelAlignment["LEFT"] = "left";
+  KupFormLabelAlignment["RIGHT"] = "right";
+})(KupFormLabelAlignment || (KupFormLabelAlignment = {}));
+var KupFormLabelPlacement;
+(function (KupFormLabelPlacement) {
+  KupFormLabelPlacement["BOTTOM"] = "bottom";
+  KupFormLabelPlacement["LEFT"] = "left";
+  KupFormLabelPlacement["HIDDEN"] = "hidden";
+  KupFormLabelPlacement["PLACEHOLDER"] = "placeholder";
+  KupFormLabelPlacement["RIGHT"] = "right";
+  KupFormLabelPlacement["TOP"] = "top";
+})(KupFormLabelPlacement || (KupFormLabelPlacement = {}));
+
+const kupFormCss = ":host{--kup_form_background_color:var(\n    --kup-form-background-color,\n    var(--kup-background-color)\n  );--kup_form_color:var(--kup-form-color, var(--kup-text-color));--kup_form_font_family:var(--kup-form-font-family, var(--kup-font-family));--kup_form_font_size:var(--kup-form-font-size, var(--kup-font-size));--kup_form_label_alignment:var(--kup-form-label-alignment);--kup_form_label_width:var(--kup-form-label-width);display:block;font-family:var(--kup_form_font_family);font-size:var(--kup_form_font_size)}.form{background:var(--kup_form_background_color);color:var(--kup_form_color);display:flex;flex-grow:1;overflow:auto;position:relative}.form--column{flex-direction:column}.form__section{display:flex;flex:1 1 1%;flex-direction:row;flex-wrap:wrap}.form__section--column{flex-direction:column;flex-wrap:unset}.form__section--column>.form__section{flex:0 0 auto}.form__section--grid{display:grid}.form__section--titled{border:1px solid var(--kup-border-color);padding-top:5px;position:relative;margin:10px}.form__section--titled>h3{background:var(--kup-background-color);font-size:calc(var(--kup-font-size) * 1.15);position:absolute;margin:0px;padding:0 8px;top:-11px;left:5px;transition:background-color 0.25s ease}.form__section--left .form__label{width:var(--kup_form_label_width, 0)}.form__section--right .form__field{min-width:200px;width:0}.form__label{-webkit-font-smoothing:antialiased;box-sizing:border-box;font-size:0.875em;letter-spacing:0.0178571429em;white-space:nowrap;width:var(--kup_form_label_width)}.form__label--center{text-align:var(--kup_form_label_alignment, center)}.form__label--left{text-align:var(--kup_form_label_alignment, left)}.form__label--right{text-align:var(--kup_form_label_alignment, right)}.form__field{min-height:16px}.form__field img{height:auto}.form .f-cell.c-right-aligned:not(.c-centered) .f-cell__content{justify-content:flex-start}";
+
+const dom = document.documentElement;
+const KupForm = class {
+  constructor(hostRef) {
+    registerInstance(this, hostRef);
+    /*-------------------------------------------------*/
+    /*                    P r o p s                    */
+    /*-------------------------------------------------*/
+    /**
+     * Custom style of the component.
+     * @default ""
+     * @see https://ketchup.smeup.com/ketchup-showcase/#/customization
+     */
+    this.customStyle = '';
+    /**
+     * Actual data of the form.
+     * @default null
+     */
+    this.data = null;
+    /**
+     * How the form will arrange its content.
+     * @default null
+     */
+    this.layout = null;
+    /*-------------------------------------------------*/
+    /*       I n t e r n a l   V a r i a b l e s       */
+    /*-------------------------------------------------*/
+    this.kupManager = kupManagerInstance();
+    this.visibleColumns = [];
+  }
+  /*-------------------------------------------------*/
+  /*                  W a t c h e r s                */
+  /*-------------------------------------------------*/
+  onDataChanged() {
+    identify(this.getRows());
+    this.initVisibleColumns();
+    this.checkLayout();
+  }
+  onLayoutChanged() {
+    this.checkLayout();
+  }
+  /*-------------------------------------------------*/
+  /*           P u b l i c   M e t h o d s           */
+  /*-------------------------------------------------*/
+  /**
+   * Used to retrieve component's props values.
+   * @param {boolean} descriptions - When provided and true, the result will be the list of props with their description.
+   * @returns {Promise<GenericObject>} List of props as object, each key will be a prop.
+   */
+  async getProps(descriptions) {
+    return getProps(this, KupFormProps, descriptions);
+  }
+  /**
+   * This method is used to trigger a new render of the component.
+   */
+  async refresh() {
+    forceUpdate(this);
+  }
+  /**
+   * Sets the focus on an editable table cell.
+   * @param {string} column - Name of the column.
+   * @param {string} rowId - Id of the row.
+   */
+  async setFocus(column, rowId) {
+    const cells = this.rootElement.shadowRoot.querySelectorAll('td[data-column="' + column + '"]');
+    for (let index = 0; cells && index < cells.length; index++) {
+      const cell = cells[index];
+      if (cell['data-row'] && cell['data-row'].id == rowId) {
+        const input = cell.querySelector('input');
+        if (input) {
+          input.focus();
+        }
+        else {
+          const kupInput = cell.querySelector('.hydrated');
+          if (kupInput) {
+            try {
+              kupInput.setFocus();
+            }
+            catch (error) { }
+          }
+        }
+      }
+    }
+  }
+  /**
+   * Sets the props to the component.
+   * @param {GenericObject} props - Object containing props that will be set to the component.
+   */
+  async setProps(props) {
+    setProps(this, KupFormProps, props);
+  }
+  /*-------------------------------------------------*/
+  /*           P r i v a t e   M e t h o d s         */
+  /*-------------------------------------------------*/
+  getColumns() {
+    return this.data && this.data.columns
+      ? this.data.columns
+      : [{ title: '', name: '', size: undefined }];
+  }
+  initVisibleColumns() {
+    this.visibleColumns = this.getColumns().filter((column) => {
+      if (column.hasOwnProperty('visible')) {
+        return column.visible;
+      }
+      return true;
+    });
+  }
+  getRows() {
+    return this.data && this.data.rows ? this.data.rows : [];
+  }
+  checkLayout() {
+    if (this.layout) {
+      this.formLayout = this.layout;
+      return;
+    }
+    const section = {
+      horizontal: false,
+      sections: [],
+    };
+    const visibleColumns = this.visibleColumns;
+    let size = visibleColumns.length;
+    const content = [];
+    let cnt = 0;
+    while (size-- > 0) {
+      content.push({
+        column: visibleColumns[cnt++].name,
+      });
+    }
+    section.content = content;
+    this.formLayout = {
+      sections: [section],
+    };
+  }
+  renderRow(row) {
+    const visibleColumns = [...this.visibleColumns];
+    let formContent = null;
+    let rowLayout = row.layout;
+    if (!rowLayout) {
+      rowLayout = this.formLayout;
+    }
+    let horizontal = false;
+    if (rowLayout) {
+      if (rowLayout.horizontal) {
+        horizontal = true;
+      }
+      const sections = rowLayout.sections;
+      let size = sections.length;
+      let cnt = 0;
+      if (size > 0) {
+        formContent = [];
+      }
+      const parent = {
+        horizontal: horizontal,
+      };
+      while (size-- > 0) {
+        formContent.push(this.renderSection(sections[cnt++], parent, row, visibleColumns));
+      }
+    }
+    const classObj = {
+      form: true,
+      'form--column': !horizontal,
+    };
+    return h("form", { class: classObj }, formContent);
+  }
+  renderSection(section, parent, row, visibleColumns) {
+    var _a;
+    let sectionContent = null;
+    if (section.sections && section.sections.length > 0) {
+      const sections = section.sections;
+      let size = sections.length;
+      let cnt = 0;
+      if (size > 0) {
+        sectionContent = [];
+      }
+      while (size-- > 0) {
+        sectionContent.push(this.renderSection(sections[cnt++], section, row, visibleColumns));
+      }
+    }
+    else if (section.content) {
+      const content = section.content;
+      let size = content.length;
+      let cnt = 0;
+      if (size > 0) {
+        sectionContent = [];
+      }
+      while (size-- > 0) {
+        const formField = this.renderFormField({
+          formField: content[cnt++],
+          row,
+          visibleColumns,
+        }, section);
+        let field = formField;
+        if (!section.horizontal) {
+          field = h("tr", null, formField);
+        }
+        sectionContent.push(field);
+      }
+    }
+    else if (visibleColumns.length > 0) {
+      const column = visibleColumns[0];
+      sectionContent = this.renderFormField({
+        formField: { column: column.name },
+        row,
+        visibleColumns,
+      });
+    }
+    const isGrid = !!section.columns;
+    const labelPlacement = ((_a = section === null || section === void 0 ? void 0 : section.label) === null || _a === void 0 ? void 0 : _a.placement) || KupFormLabelPlacement.LEFT;
+    const sectionClass = {
+      form__section: true,
+      'form__section--column': !isGrid && !section.horizontal,
+      'form__section--grid': isGrid,
+      'form__section--titled': !!section.title,
+      'form__section--last': !section.sections || section.sections.length === 0,
+      [`form__section--${labelPlacement}`]: true,
+    };
+    const sectionStyle = section.style || {};
+    if (section.dim && parent) {
+      sectionStyle.flex = `0 0 ${section.dim}`;
+      if (parent.horizontal) {
+        sectionStyle.maxWidth = section.dim;
+      }
+      else {
+        sectionStyle.maxHeight = section.dim;
+      }
+    }
+    if (isGrid) {
+      sectionStyle['grid-template-columns'] = `repeat(${section.columns}, 1fr)`;
+    }
+    return (h("div", { class: sectionClass, style: sectionStyle }, section.title ? h("h3", null, section.title) : null, h("table", null, h("tbody", null, section.horizontal ? (h("tr", null, sectionContent)) : (sectionContent)))));
+  }
+  renderFormField({ formField, row, visibleColumns, }, section) {
+    var _a;
+    const classObj = {
+      form__field: true,
+    };
+    const styleObj = {};
+    let column = null;
+    let index = -1;
+    for (let i = 0; i < visibleColumns.length; i++) {
+      const c = visibleColumns[i];
+      if (c.name === formField.column) {
+        index = i;
+        break;
+      }
+    }
+    if (index >= 0) {
+      column = visibleColumns[index];
+      visibleColumns.splice(index, 1);
+    }
+    else if (section) {
+      column = this.data.columns.find((x) => x.name === formField.column);
+    }
+    const cell = row.cells[formField.column];
+    let title = undefined;
+    if (cell) {
+      cell.isEditable = true;
+      if (!this.kupManager.objects.isEmptyKupObj(cell.obj)) {
+        if (this.kupManager.debug.isDebug()) {
+          title =
+            cell.obj.t +
+              '; ' +
+              cell.obj.p +
+              '; ' +
+              cell.obj.k +
+              ';';
+        }
+      }
+    }
+    else {
+      return null;
+    }
+    const cellProps = {
+      cell: formField.data ? Object.assign(Object.assign({}, cell), { data: formField.data }) : cell,
+      column: column,
+      component: this,
+      editable: true,
+      renderKup: true,
+      row: row,
+      setSizes: true,
+      shape: formField.shape,
+    };
+    const label = formField.label || column.title;
+    resetLabel();
+    switch ((_a = section.label) === null || _a === void 0 ? void 0 : _a.placement) {
+      case KupFormLabelPlacement.BOTTOM:
+        return [h("tr", null, fieldCell()), h("tr", null, labelCell(label))];
+      case KupFormLabelPlacement.PLACEHOLDER:
+        setPlaceholderLabel();
+      case KupFormLabelPlacement.HIDDEN: {
+        if (section) {
+          return [fieldCell()];
+        }
+        else {
+          return [h("tr", null, fieldCell())];
+        }
+      }
+      case KupFormLabelPlacement.RIGHT: {
+        if (section) {
+          return [fieldCell(), labelCell(label)];
+        }
+        else {
+          return [
+            h("tr", null, fieldCell(), labelCell(label)),
+          ];
+        }
+      }
+      case KupFormLabelPlacement.TOP:
+        return [h("tr", null, labelCell(label)), h("tr", null, fieldCell())];
+      default: {
+        if (section) {
+          return [labelCell(label), fieldCell()];
+        }
+        else {
+          return [
+            h("tr", null, labelCell(label), fieldCell()),
+          ];
+        }
+      }
+    }
+    function fieldCell() {
+      return (h("td", { "data-cell": cell, "data-row": row, "data-column": formField.column, class: classObj, style: styleObj, title: title }, cell && column ? (h(FCell, Object.assign({}, cellProps))) : (h("span", null, formField.value))));
+    }
+    function labelCell(label) {
+      var _a, _b, _c;
+      const alignment = ((_a = section === null || section === void 0 ? void 0 : section.label) === null || _a === void 0 ? void 0 : _a.alignment) || KupFormLabelAlignment.LEFT;
+      const style = {
+        width: ((_b = section === null || section === void 0 ? void 0 : section.label) === null || _b === void 0 ? void 0 : _b.width) ? (_c = section === null || section === void 0 ? void 0 : section.label) === null || _c === void 0 ? void 0 : _c.width : '',
+      };
+      return (h("td", { class: `form__label form__label--${alignment}`, style: style }, h("span", null, label)));
+    }
+    function resetLabel() {
+      if (!cell.data) {
+        cell.data = {};
+      }
+      try {
+        delete cell.data.label;
+      }
+      catch (_a) { }
+      try {
+        delete cell.data.data['kup-text-field'].label;
+      }
+      catch (_b) { }
+    }
+    function setPlaceholderLabel() {
+      switch (dom.ketchup.data.cell.getType(cell, cell.shape || column.shape || null)) {
+        case FCellTypes.AUTOCOMPLETE:
+        case FCellTypes.COLOR_PICKER:
+        case FCellTypes.COMBOBOX:
+        case FCellTypes.DATE:
+        case FCellTypes.DATETIME:
+        case FCellTypes.TIME:
+          if (cell.data.data) {
+            if (cell.data.data['kup-text-field']) {
+              cell.data.data['kup-text-field'].label =
+                column.title;
+            }
+            else {
+              cell.data.data = {
+                'kup-text-field': {
+                  label: column.title,
+                },
+              };
+            }
+          }
+          else {
+            cell.data.data = {
+              'kup-text-field': {
+                label: column.title,
+              },
+            };
+          }
+          break;
+        case FCellTypes.CHECKBOX:
+        case FCellTypes.NUMBER:
+        case FCellTypes.STRING:
+        case FCellTypes.SWITCH:
+          cell.data.label = column.title;
+      }
+    }
+  }
+  /*-------------------------------------------------*/
+  /*          L i f e c y c l e   H o o k s          */
+  /*-------------------------------------------------*/
+  componentWillLoad() {
+    this.kupManager.debug.logLoad(this, false);
+    this.kupManager.language.register(this);
+    this.kupManager.theme.register(this);
+    this.onDataChanged();
+  }
+  componentDidLoad() {
+    this.kupManager.debug.logLoad(this, true);
+  }
+  componentWillRender() {
+    this.kupManager.debug.logRender(this, false);
+  }
+  componentDidRender() {
+    const root = this.rootElement.shadowRoot;
+    if (root) {
+      const fs = root.querySelectorAll('.f-text-field');
+      for (let index = 0; index < fs.length; index++) {
+        FTextFieldMDC(fs[index]);
+      }
+    }
+    this.kupManager.debug.logRender(this, true);
+  }
+  render() {
+    let formContent = null;
+    if (this.data.rows.length === 0) {
+      formContent = (h("p", null, this.kupManager.language.translate(KupLanguageGeneric.EMPTY_DATA)));
+    }
+    else {
+      const rows = this.data.rows;
+      let size = rows.length;
+      let cnt = 0;
+      formContent = [];
+      while (size-- > 0) {
+        formContent.push(this.renderRow(rows[cnt++]));
+      }
+    }
+    return (h(Host, null, h("style", null, this.kupManager.theme.setKupStyle(this.rootElement)), h("div", { id: componentWrapperId }, formContent)));
+  }
+  disconnectedCallback() {
+    this.kupManager.language.unregister(this);
+    this.kupManager.theme.unregister(this);
+  }
+  get rootElement() { return getElement(this); }
+  static get watchers() { return {
+    "data": ["onDataChanged"],
+    "layout": ["onLayoutChanged"]
+  }; }
+};
+KupForm.style = kupFormCss;
+
+export { KupForm as kup_form };

package/dist/esm/kup-iframe.entry.js

@@ -1,6 +1,6 @@
-import { r as registerInstance, c as createEvent, f as forceUpdate, h, H as Host, g as getElement } from './index-baeab1ac.js';
-import { k as kupManagerInstance, c as KupDebugCategory } from './kup-manager-58b075b4.js';
-import { g as getProps, s as setProps } from './utils-d7e4b3c2.js';
+import { r as registerInstance, c as createEvent, f as forceUpdate, h, H as Host, g as getElement } from './index-ad6ab214.js';
+import { k as kupManagerInstance, c as KupDebugCategory } from './kup-manager-22a475e6.js';
+import { g as getProps, s as setProps } from './utils-2c1f4122.js';
 
 /**
  * Props of the kup-iframe component.

package/dist/esm/kup-image-list.entry.js

@@ -1,15 +1,16 @@
-import { r as registerInstance, c as createEvent, f as forceUpdate, h, H as Host, g as getElement } from './index-baeab1ac.js';
-import { k as kupManagerInstance, h as KupLanguageGeneric } from './kup-manager-58b075b4.js';
-import { g as getProps, s as setProps } from './utils-d7e4b3c2.js';
+import { r as registerInstance, c as createEvent, f as forceUpdate, h, H as Host, g as getElement } from './index-ad6ab214.js';
+import { k as kupManagerInstance, h as KupLanguageGeneric, F as FCellPadding } from './kup-manager-22a475e6.js';
+import { g as getProps, s as setProps } from './utils-2c1f4122.js';
 import { c as componentWrapperId } from './GenericVariables-665de00a.js';
-import { F as FImage } from './f-image-c468d8ae.js';
-import { F as FButton } from './f-button-871a544b.js';
+import { F as FImage } from './f-image-2ab4b9aa.js';
+import { F as FButton } from './f-button-fd44ef70.js';
 import { F as FButtonStyling } from './f-button-declarations-b1b4cac4.js';
-import { a as FCellPadding, b as FCell } from './f-cell-521ef17a.js';
+import { F as FCell } from './f-cell-7b159a22.js';
 import { M as MDCRipple } from './component-b1bedf1d.js';
-import './cell-utils-964da6b5.js';
-import './f-text-field-d6c61c73.js';
-import './f-chip-1dda722f.js';
+import './cell-utils-cb5d4149.js';
+import './f-checkbox-c51c4a75.js';
+import './f-text-field-41c575eb.js';
+import './f-chip-c2e4c522.js';
 import './tslib.es6-3eea2234.js';
 
 /**
@@ -23,7 +24,17 @@ var KupImageListProps;
   KupImageListProps["ripple"] = "When enabled displays Material's ripple effect on clicked items.";
 })(KupImageListProps || (KupImageListProps = {}));
 
-const kupImageListCss = ":host{--kup_imagelist_background_color:var(\n    --kup-imagelist-background-color,\n    transparent\n  );--kup_imagelist_columns:var(--kup-imagelist-columns, 4);--kup_imagelist_grid_gap:var(--kup-imagelist-grid-gap, 0.5em);--kup_imagelist_image_margin:var(--kup-imagelist-image-margin, 1em auto);--kup_imagelist_image_min_height:var(--kup-imagelist-image-min-height, 64px);--kup_imagelist_item_border_radius:var(\n    --kup-imagelist-item-border-radius,\n    8px\n  );--kup_imagelist_item_height:var(--kup-imagelist-item-height, auto);--kup_imagelist_item_padding:var(--kup-imagelist-item-padding, 0);--kup_imagelist_item_width:var(--kup-imagelist-item-width, auto);--kup_imagelist_label_margin:var(\n    --kup-imagelist-label-margin,\n    0 auto 1em auto\n  );--kup_imagelist_navbar_background_color:var(\n    --kup-imagelist-navbar-background-color,\n    transparent\n  );--kup_imagelist_primary_color:var(\n    --kup-imagelist-primary-color,\n    var(--kup-primary-color)\n  );--kup_imagelist_primary_color_rgb:var(\n    --kup-imagelist-primary-color-rgb,\n    var(--kup-primary-color-rgb)\n  );--kup_imagelist_text_color:var(\n    --kup-imagelist-text-color,\n    var(--kup-text-color)\n  );display:block}.navigation-bar{align-items:center;background-color:var(--kup_imagelist_navbar_background_color);display:flex;justify-content:center}.navigation-bar__wrapper{align-items:center;display:flex;flex-wrap:wrap;justify-content:center;max-width:100%;position:relative}.navigation-bar__wrapper--active .navigation-bar__title{background-color:rgba(var(--kup_imagelist_primary_color_rgb), 0.15);color:var(--kup_imagelist_primary_color)}.navigation-bar__wrapper--active .navigation-bar__back,.navigation-bar__wrapper--active .navigation-bar__top{display:block}.navigation-bar__back,.navigation-bar__top{--kup-button-primary-color-rgb:0;animation:fade-in 0.375s ease-in;display:none}.navigation-bar__title{border-radius:16px;box-sizing:border-box;cursor:pointer;display:flex;justify-content:center;padding:0.75em 1em;user-select:none;transition:background-color 125ms, color 125ms;width:100%}.navigation-bar__title__image.f-image{margin:0}.navigation-bar__title__label{font-size:1.2em;font-weight:bold;letter-spacing:0.12em;overflow:hidden;padding:0 0.5em;text-overflow:ellipsis;text-transform:uppercase;white-space:nowrap}.image-list{background-color:var(--kup_imagelist_background_color);display:grid;grid-gap:var(--kup_imagelist_grid_gap);grid-template-columns:repeat(var(--kup_imagelist_columns, 4), minmax(0px, 1fr));margin-top:1em;width:100%}.image-list .f-cell{height:100%;width:100%}.image-list__item{border-radius:var(--kup_imagelist_item_border_radius);cursor:pointer;height:var(--kup_imagelist_item_height);padding:var(--kup_imagelist_item_padding);width:var(--kup_imagelist_item_width)}.image-list__image.f-image{margin:var(--kup_imagelist_image_margin)}.image-list__image.f-image .f-image__icon{min-height:var(--kup_imagelist_image_min_height)}.image-list__label{color:var(--kup_imagelist_text_color);letter-spacing:0.12em;margin:var(--kup_imagelist_label_margin);overflow:hidden;text-align:center;text-overflow:ellipsis}.image-list .mdc-ripple-surface{--mdc-ripple-fg-opacity:0.24}.image-list .mdc-ripple-surface:before,.image-list .mdc-ripple-surface:after{background-color:var(--kup_imagelist_primary_color)}:host(.kup-full-height){height:100%}:host(.kup-full-width){width:100%}:host(.kup-horizontal) .image-list{display:flex}:host(.kup-auto-grid) .image-list{display:flex;flex-wrap:wrap;justify-content:center}";
+class KupImageListState {
+  constructor() {
+    this.load = false;
+  }
+  toDebugString() {
+    // TODO
+    return 'image-list state';
+  }
+}
+
+const kupImageListCss = ":host{--kup_imagelist_background_color:var(\n    --kup-imagelist-background-color,\n    transparent\n  );--kup_imagelist_columns:var(--kup-imagelist-columns, 4);--kup_imagelist_grid_gap:var(--kup-imagelist-grid-gap, 0.5em);--kup_imagelist_image_margin:var(--kup-imagelist-image-margin, 1em auto);--kup_imagelist_image_min_height:var(--kup-imagelist-image-min-height, 64px);--kup_imagelist_item_border_radius:var(\n    --kup-imagelist-item-border-radius,\n    8px\n  );--kup_imagelist_item_height:var(--kup-imagelist-item-height, auto);--kup_imagelist_item_padding:var(--kup-imagelist-item-padding, 0);--kup_imagelist_item_width:var(--kup-imagelist-item-width, auto);--kup_imagelist_label_margin:var(\n    --kup-imagelist-label-margin,\n    0 auto 1em auto\n  );--kup_imagelist_navbar_background_color:var(\n    --kup-imagelist-navbar-background-color,\n    transparent\n  );--kup_imagelist_primary_color:var(\n    --kup-imagelist-primary-color,\n    var(--kup-primary-color)\n  );--kup_imagelist_primary_color_rgb:var(\n    --kup-imagelist-primary-color-rgb,\n    var(--kup-primary-color-rgb)\n  );--kup_imagelist_text_color:var(\n    --kup-imagelist-text-color,\n    var(--kup-text-color)\n  );display:block}.navigation-bar{align-items:center;background-color:var(--kup_imagelist_navbar_background_color);display:flex;justify-content:center}.navigation-bar__wrapper{align-items:center;display:flex;flex-wrap:wrap;justify-content:center;max-width:100%;position:relative}.navigation-bar__wrapper--active .navigation-bar__title{background-color:rgba(var(--kup_imagelist_primary_color_rgb), 0.15);color:var(--kup_imagelist_primary_color)}.navigation-bar__back,.navigation-bar__top{--kup-button-primary-color-rgb:0}.navigation-bar__title{border-radius:16px;box-sizing:border-box;cursor:pointer;display:flex;justify-content:center;padding:0.75em 1em;user-select:none;transition:background-color 125ms, color 125ms;width:100%}.navigation-bar__title__image.f-image{margin:0}.navigation-bar__title__label{font-size:1.2em;font-weight:bold;letter-spacing:0.12em;overflow:hidden;padding:0 0.5em;text-overflow:ellipsis;text-transform:uppercase;white-space:nowrap}.image-list{background-color:var(--kup_imagelist_background_color);display:grid;grid-gap:var(--kup_imagelist_grid_gap);grid-template-columns:repeat(var(--kup_imagelist_columns, 4), minmax(0px, 1fr));margin-top:1em;width:100%}.image-list .f-cell{height:100%;width:100%}.image-list__item{border-radius:var(--kup_imagelist_item_border_radius);cursor:pointer;height:var(--kup_imagelist_item_height);padding:var(--kup_imagelist_item_padding);width:var(--kup_imagelist_item_width)}.image-list__image.f-image{margin:var(--kup_imagelist_image_margin)}.image-list__image.f-image .f-image__icon{min-height:var(--kup_imagelist_image_min_height)}.image-list__label{color:var(--kup_imagelist_text_color);letter-spacing:0.12em;margin:var(--kup_imagelist_label_margin);overflow:hidden;text-align:center;text-overflow:ellipsis}.image-list .mdc-ripple-surface{--mdc-ripple-fg-opacity:0.24}.image-list .mdc-ripple-surface:before,.image-list .mdc-ripple-surface:after{background-color:var(--kup_imagelist_primary_color)}:host(.kup-full-height){height:100%}:host(.kup-full-width){width:100%}:host(.kup-horizontal) .image-list{display:flex}:host(.kup-auto-grid) .image-list{display:flex;flex-wrap:wrap;justify-content:center}";
 
 var __classPrivateFieldGet = (undefined && undefined.__classPrivateFieldGet) || function (receiver, state, kind, f) {
   if (kind === "a" && !f)
@@ -52,6 +63,7 @@ const KupImageList = class {
     /*-------------------------------------------------*/
     /*                   S t a t e s                   */
     /*-------------------------------------------------*/
+    this.state = new KupImageListState();
     this.currentNode = null;
     this.navigationBarToggled = false;
     /*-------------------------------------------------*/
@@ -73,9 +85,18 @@ const KupImageList = class {
      * @default true
      */
     this.ripple = true;
+    /**
+     * An array of integers containing the path to a selected child.\
+     */
+    this.selectedNode = [];
+    this.stateId = '';
     /*-------------------------------------------------*/
     /*       I n t e r n a l   V a r i a b l e s       */
     /*-------------------------------------------------*/
+    /**
+     * Instance of the KupManager class.
+     */
+    this.kupManager = kupManagerInstance();
     _KupImageList_clickTimeout.set(this, []);
     _KupImageList_kupManager.set(this, kupManagerInstance());
     _KupImageList_backProps.set(this, {
@@ -99,6 +120,32 @@ const KupImageList = class {
       wrapperClass: 'navigation-bar__top',
     });
   }
+  initWithPersistedState() {
+    if (this.store && this.stateId) {
+      const state = this.store.getState(this.stateId);
+      if (state != null) {
+        this.currentNode =
+          this.kupManager.data.node.findByStrTreeNodePath(this.data, state.selectedTreeNodePath);
+      }
+    }
+  }
+  persistState() {
+    if (this.store && this.stateId) {
+      let somethingChanged = false;
+      let cNodeRowId = this.currentNode ? this.currentNode.id : '';
+      if (!this.kupManager.objects.deepEqual(this.state.selectedTreeNodePath, cNodeRowId)) {
+        this.state.selectedTreeNodePath = cNodeRowId;
+        somethingChanged = true;
+      }
+      if (!this.state.load) {
+        this.state.load = true;
+        return;
+      }
+      if (somethingChanged) {
+        this.store.persistState(this.stateId, this.state);
+      }
+    }
+  }
   onKupClick(node) {
     if (node.children && node.children.length > 0) {
       this.currentNode = node;
@@ -129,6 +176,15 @@ const KupImageList = class {
     });
   }
   /*-------------------------------------------------*/
+  /*                  W a t c h e r s                */
+  /*-------------------------------------------------*/
+  selectNode(newData) {
+    if (!newData || newData.length == 0) {
+      return;
+    }
+    this.currentNode = this.kupManager.data.node.find(this.data, newData);
+  }
+  /*-------------------------------------------------*/
   /*           P u b l i c   M e t h o d s           */
   /*-------------------------------------------------*/
   /**
@@ -176,6 +232,9 @@ const KupImageList = class {
         }
       }
     }
+    // *** Store
+    this.persistState();
+    // ***
     __classPrivateFieldGet(this, _KupImageList_kupManager, "f").debug.logRender(this, true);
   }
   render() {
@@ -192,6 +251,9 @@ const KupImageList = class {
     __classPrivateFieldGet(this, _KupImageList_kupManager, "f").theme.unregister(this);
   }
   get rootElement() { return getElement(this); }
+  static get watchers() { return {
+    "selectedNode": ["selectNode"]
+  }; }
 };
 _KupImageList_clickTimeout = new WeakMap(), _KupImageList_kupManager = new WeakMap(), _KupImageList_backProps = new WeakMap(), _KupImageList_topProps = new WeakMap(), _KupImageList_instances = new WeakSet(), _KupImageList_createItem = function _KupImageList_createItem(node) {
   const props = {

package/dist/esm/kup-lazy.entry.js

@@ -1,6 +1,6 @@
-import { r as registerInstance, c as createEvent, f as forceUpdate, h, H as Host, g as getElement } from './index-baeab1ac.js';
-import { k as kupManagerInstance } from './kup-manager-58b075b4.js';
-import { g as getProps, s as setProps } from './utils-d7e4b3c2.js';
+import { r as registerInstance, c as createEvent, f as forceUpdate, h, H as Host, g as getElement } from './index-ad6ab214.js';
+import { k as kupManagerInstance } from './kup-manager-22a475e6.js';
+import { g as getProps, s as setProps } from './utils-2c1f4122.js';
 import { c as componentWrapperId } from './GenericVariables-665de00a.js';
 
 /**
@@ -24,7 +24,7 @@ var KupLazyRender;
   KupLazyRender["BOTH"] = "both";
 })(KupLazyRender || (KupLazyRender = {}));
 
-const kupLazyCss = ":host{--kup_lazy_hor_alignment:var(--kup-lazy-hor-alignment, center);--kup_lazy_ver_alignment:var(--kup-lazy-ver-alignment, center);--kup_lazy_animation_time:var(--kup-lazy-animation-time, 2s);--kup_lazy_placeholder_color:var(\n    --kup-lazy-placeholder-color,\n    var(--kup-icon-color)\n  );display:block;height:100%;width:100%;position:relative}#kup-component{align-items:var(--kup_lazy_ver_alignment);display:flex;justify-content:var(--kup_lazy_hor_alignment);height:100%;width:100%}#kup-component kup-data-table{min-width:100%}svg{fill:var(--kup_lazy_placeholder_color);animation:shine ease var(--kup_lazy_animation_time) infinite}@keyframes shine{0%{opacity:0.4}50%{opacity:0.8}100%{opacity:0.4}}:host(.kup-bottom-aligned){--kup-lazy-ver-alignment:flex-end}:host(.kup-left-aligned){--kup-lazy-hor-alignment:flex-start}:host(.kup-right-aligned){--kup-lazy-hor-alignment:flex-end}:host(.kup-top-aligned){--kup-lazy-ver-alignment:flex-start}:host(.kup-to-be-loaded) #kup-component{position:absolute}:host(.kup-to-be-loaded) #kup-component>*{margin:auto}";
+const kupLazyCss = ":host{--kup_lazy_animation_time:var(--kup-lazy-animation-time, 2s);--kup_lazy_hor_alignment:var(--kup-lazy-hor-alignment, center);--kup_lazy_placeholder_color:var(\n    --kup-lazy-placeholder-color,\n    var(--kup-icon-color)\n  );--kup_lazy_ver_alignment:var(--kup-lazy-ver-alignment, center);--kup_lazy_width:var(--kup-lazy-width, 100%);display:block;height:100%;width:var(--kup_lazy_width);position:relative}#kup-component{align-items:var(--kup_lazy_ver_alignment);display:flex;justify-content:var(--kup_lazy_hor_alignment);height:100%;width:var(--kup_lazy_width)}#kup-component kup-data-table{min-width:100%}.kup-loaded,.kup-to-be-loaded{width:var(--kup_lazy_width)}svg{fill:var(--kup_lazy_placeholder_color);animation:shine ease var(--kup_lazy_animation_time) infinite}@keyframes shine{0%{opacity:0.4}50%{opacity:0.8}100%{opacity:0.4}}:host(.kup-bottom-aligned){--kup-lazy-ver-alignment:flex-end}:host(.kup-left-aligned){--kup-lazy-hor-alignment:flex-start}:host(.kup-right-aligned){--kup-lazy-hor-alignment:flex-end}:host(.kup-top-aligned){--kup-lazy-ver-alignment:flex-start}:host(.kup-to-be-loaded) #kup-component{position:absolute}:host(.kup-to-be-loaded) #kup-component>*{margin:auto}";
 
 const KupLazy = class {
   constructor(hostRef) {

package/dist/esm/kup-magic-box.entry.js

@@ -1,8 +1,8 @@
-import { r as registerInstance, f as forceUpdate, h, H as Host, g as getElement } from './index-baeab1ac.js';
-import { k as kupManagerInstance, h as KupLanguageGeneric, c as KupDebugCategory, _ as kupDropEvent, z as kupDraggableColumnAttr, $ as kupDraggableRowAttr, D as KupDropEventTypes, b as KupThemeColorValues } from './kup-manager-58b075b4.js';
+import { r as registerInstance, f as forceUpdate, h, H as Host, g as getElement } from './index-ad6ab214.js';
+import { k as kupManagerInstance, h as KupLanguageGeneric, c as KupDebugCategory, a7 as kupDropEvent, z as kupDraggableColumnAttr, a8 as kupDraggableRowAttr, D as KupDropEventTypes, b as KupThemeColorValues } from './kup-manager-22a475e6.js';
 import { F as FButtonStyling } from './f-button-declarations-b1b4cac4.js';
-import { F as FImage } from './f-image-c468d8ae.js';
-import { g as getProps, s as setProps } from './utils-d7e4b3c2.js';
+import { F as FImage } from './f-image-2ab4b9aa.js';
+import { g as getProps, s as setProps } from './utils-2c1f4122.js';
 import { c as componentWrapperId } from './GenericVariables-665de00a.js';
 
 /**