@sme.up/ketchup 5.2.1-SNAPSHOT → 6.2.0-SNAPSHOT

package/dist/collection/components/kup-form/kup-form.js

@@ -0,0 +1,668 @@
+import { Component, Element, forceUpdate, h, Host, Method, Prop, Watch, } from '@stencil/core';
+import { KupFormProps, KupFormLabelPlacement, } from './kup-form-declarations';
+import { kupManagerInstance, } from '../../managers/kup-manager/kup-manager';
+import { getProps, identify, setProps } from '../../utils/utils';
+import { KupLanguageGeneric } from '../../managers/kup-language/kup-language-declarations';
+import { componentWrapperId } from '../../variables/GenericVariables';
+import { FCell } from '../../f-components/f-cell/f-cell';
+import { FCellTypes, } from '../../f-components/f-cell/f-cell-declarations';
+import { FTextFieldMDC } from '../../f-components/f-text-field/f-text-field-mdc';
+const dom = document.documentElement;
+export class KupForm {
+  constructor() {
+    /*-------------------------------------------------*/
+    /*                    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;
+    /**
+     * Placement of fields' labels.
+     * @default KupFormLabelPlacement.LEFT
+     */
+    this.labelPlacement = KupFormLabelPlacement.LEFT;
+    /**
+     * 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) {
+    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,
+        }, true);
+        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 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,
+    };
+    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, }, fromSection) {
+    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 (fromSection) {
+      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: cell,
+      column: column,
+      component: this,
+      editable: true,
+      renderKup: true,
+      row: row,
+      setSizes: true,
+      shape: formField.shape,
+    };
+    resetLabel();
+    switch (this.labelPlacement) {
+      case KupFormLabelPlacement.BOTTOM:
+        return [h("tr", null, fieldCell()), h("tr", null, labelCell())];
+      case KupFormLabelPlacement.PLACEHOLDER:
+        setPlaceholderLabel();
+      case KupFormLabelPlacement.HIDDEN: {
+        if (fromSection) {
+          return [fieldCell()];
+        }
+        else {
+          return [h("tr", null, fieldCell())];
+        }
+      }
+      case KupFormLabelPlacement.RIGHT: {
+        if (fromSection) {
+          return [fieldCell(), labelCell()];
+        }
+        else {
+          return [
+            h("tr", null,
+              fieldCell(),
+              labelCell()),
+          ];
+        }
+      }
+      case KupFormLabelPlacement.TOP:
+        return [h("tr", null, labelCell()), h("tr", null, fieldCell())];
+      default: {
+        if (fromSection) {
+          return [labelCell(), fieldCell()];
+        }
+        else {
+          return [
+            h("tr", null,
+              labelCell(),
+              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() {
+      return (h("td", { class: "form__label" },
+        h("span", null, column.title)));
+    }
+    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);
+  }
+  static get is() { return "kup-form"; }
+  static get encapsulation() { return "shadow"; }
+  static get originalStyleUrls() { return {
+    "$": ["kup-form.scss"]
+  }; }
+  static get styleUrls() { return {
+    "$": ["kup-form.css"]
+  }; }
+  static get properties() { return {
+    "customStyle": {
+      "type": "string",
+      "mutable": false,
+      "complexType": {
+        "original": "string",
+        "resolved": "string",
+        "references": {}
+      },
+      "required": false,
+      "optional": false,
+      "docs": {
+        "tags": [{
+            "name": "default",
+            "text": "\"\""
+          }, {
+            "name": "see",
+            "text": "https://ketchup.smeup.com/ketchup-showcase/#/customization"
+          }],
+        "text": "Custom style of the component."
+      },
+      "attribute": "custom-style",
+      "reflect": false,
+      "defaultValue": "''"
+    },
+    "data": {
+      "type": "unknown",
+      "mutable": false,
+      "complexType": {
+        "original": "KupFormData",
+        "resolved": "KupFormData",
+        "references": {
+          "KupFormData": {
+            "location": "import",
+            "path": "./kup-form-declarations"
+          }
+        }
+      },
+      "required": false,
+      "optional": false,
+      "docs": {
+        "tags": [{
+            "name": "default",
+            "text": "null"
+          }],
+        "text": "Actual data of the form."
+      },
+      "defaultValue": "null"
+    },
+    "labelPlacement": {
+      "type": "string",
+      "mutable": false,
+      "complexType": {
+        "original": "KupFormLabelPlacement",
+        "resolved": "KupFormLabelPlacement.BOTTOM | KupFormLabelPlacement.HIDDEN | KupFormLabelPlacement.LEFT | KupFormLabelPlacement.PLACEHOLDER | KupFormLabelPlacement.RIGHT | KupFormLabelPlacement.TOP",
+        "references": {
+          "KupFormLabelPlacement": {
+            "location": "import",
+            "path": "./kup-form-declarations"
+          }
+        }
+      },
+      "required": false,
+      "optional": false,
+      "docs": {
+        "tags": [{
+            "name": "default",
+            "text": "KupFormLabelPlacement.LEFT"
+          }],
+        "text": "Placement of fields' labels."
+      },
+      "attribute": "label-placement",
+      "reflect": true,
+      "defaultValue": "KupFormLabelPlacement.LEFT"
+    },
+    "layout": {
+      "type": "unknown",
+      "mutable": false,
+      "complexType": {
+        "original": "KupFormLayout",
+        "resolved": "KupFormLayout",
+        "references": {
+          "KupFormLayout": {
+            "location": "import",
+            "path": "./kup-form-declarations"
+          }
+        }
+      },
+      "required": false,
+      "optional": false,
+      "docs": {
+        "tags": [{
+            "name": "default",
+            "text": "null"
+          }],
+        "text": "How the form will arrange its content."
+      },
+      "defaultValue": "null"
+    }
+  }; }
+  static get methods() { return {
+    "getProps": {
+      "complexType": {
+        "signature": "(descriptions?: boolean) => Promise<GenericObject>",
+        "parameters": [{
+            "tags": [{
+                "name": "param",
+                "text": "descriptions - When provided and true, the result will be the list of props with their description."
+              }],
+            "text": "- When provided and true, the result will be the list of props with their description."
+          }],
+        "references": {
+          "Promise": {
+            "location": "global"
+          },
+          "GenericObject": {
+            "location": "import",
+            "path": "../../types/GenericTypes"
+          }
+        },
+        "return": "Promise<GenericObject>"
+      },
+      "docs": {
+        "text": "Used to retrieve component's props values.",
+        "tags": [{
+            "name": "param",
+            "text": "descriptions - When provided and true, the result will be the list of props with their description."
+          }, {
+            "name": "returns",
+            "text": "List of props as object, each key will be a prop."
+          }]
+      }
+    },
+    "refresh": {
+      "complexType": {
+        "signature": "() => Promise<void>",
+        "parameters": [],
+        "references": {
+          "Promise": {
+            "location": "global"
+          }
+        },
+        "return": "Promise<void>"
+      },
+      "docs": {
+        "text": "This method is used to trigger a new render of the component.",
+        "tags": []
+      }
+    },
+    "setFocus": {
+      "complexType": {
+        "signature": "(column: string, rowId: string) => Promise<void>",
+        "parameters": [{
+            "tags": [{
+                "name": "param",
+                "text": "column - Name of the column."
+              }],
+            "text": "- Name of the column."
+          }, {
+            "tags": [{
+                "name": "param",
+                "text": "rowId - Id of the row."
+              }],
+            "text": "- Id of the row."
+          }],
+        "references": {
+          "Promise": {
+            "location": "global"
+          }
+        },
+        "return": "Promise<void>"
+      },
+      "docs": {
+        "text": "Sets the focus on an editable table cell.",
+        "tags": [{
+            "name": "param",
+            "text": "column - Name of the column."
+          }, {
+            "name": "param",
+            "text": "rowId - Id of the row."
+          }]
+      }
+    },
+    "setProps": {
+      "complexType": {
+        "signature": "(props: GenericObject) => Promise<void>",
+        "parameters": [{
+            "tags": [{
+                "name": "param",
+                "text": "props - Object containing props that will be set to the component."
+              }],
+            "text": "- Object containing props that will be set to the component."
+          }],
+        "references": {
+          "Promise": {
+            "location": "global"
+          },
+          "GenericObject": {
+            "location": "import",
+            "path": "../../types/GenericTypes"
+          }
+        },
+        "return": "Promise<void>"
+      },
+      "docs": {
+        "text": "Sets the props to the component.",
+        "tags": [{
+            "name": "param",
+            "text": "props - Object containing props that will be set to the component."
+          }]
+      }
+    }
+  }; }
+  static get elementRef() { return "rootElement"; }
+  static get watchers() { return [{
+      "propName": "data",
+      "methodName": "onDataChanged"
+    }, {
+      "propName": "layout",
+      "methodName": "onLayoutChanged"
+    }]; }
+}

package/dist/collection/components/kup-grid/kup-grid.js

@@ -86,10 +86,7 @@ export class KupGrid {
         el = h("slot", { name: `${i}` });
       }
       else {
-        let span = 1;
-        if (slots[i]['span']) {
-          span = slots[i]['span'];
-        }
+        const span = slots[i]['span'] || slots[i].getAttribute('span') || 1;
         el = (h("div", { class: `layout-grid__cell layout-grid__cell--span-${span}` },
           h("slot", { name: `${i}` })));
       }

package/dist/collection/components/kup-image-list/kup-image-list-declarations.js

@@ -0,0 +1,10 @@
+/**
+ * Props of the kup-image-list component.
+ * Used to export every prop in an object.
+ */
+export var KupImageListProps;
+(function (KupImageListProps) {
+  KupImageListProps["customStyle"] = "Custom style of the component.";
+  KupImageListProps["data"] = "Actual data of the component";
+  KupImageListProps["ripple"] = "When enabled displays Material's ripple effect on clicked items.";
+})(KupImageListProps || (KupImageListProps = {}));