@sme.up/ketchup 6.1.0-SNAPSHOT → 6.3.0

package/dist/types/f-components/f-cell/f-cell-declarations.d.ts

@@ -1,7 +1,8 @@
 import type { VNode } from '../../stencil-public-runtime';
 import { KupDataCell, KupDataColumn, KupDataRow } from '../../managers/kup-data/kup-data-declarations';
 import { FComponent, KupEventPayload, KupTagNames } from '../../types/GenericTypes';
-export declare const autoAlignComps: KupTagNames[];
+export declare const autoCenterComps: KupTagNames[];
+export declare const fullWidthFieldsComps: KupTagNames[];
 /**
  * Props of the f-cell component.
  */
@@ -110,6 +111,7 @@ export declare enum FCellShapes {
   PROGRESS_BAR = "PGB",
   RADIO = "RAD",
   RATING = "RTG",
+  SWITCH = "SWT",
   TEXT_FIELD = "ITX"
 }
 /**
@@ -138,6 +140,7 @@ export declare enum FCellTypes {
   RADIO = "radio",
   RATING = "rating",
   STRING = "string",
+  SWITCH = "switch",
   TIME = "time"
 }
 export declare const editableTypes: FCellTypes[];

package/dist/types/f-components/f-text-field/f-text-field-declarations.d.ts

@@ -3,6 +3,7 @@ import type { FComponent } from '../../types/GenericTypes';
  * Props of the f-text-field component.
  */
 export interface FTextFieldProps extends FComponent {
+  decimals?: number;
   disabled?: boolean;
   fullHeight?: boolean;
   fullWidth?: boolean;
@@ -17,6 +18,7 @@ export interface FTextFieldProps extends FComponent {
   isClearable?: boolean;
   label?: string;
   leadingLabel?: boolean;
+  name?: string;
   outlined?: boolean;
   readOnly?: boolean;
   shaped?: boolean;

package/dist/types/managers/kup-data/kup-data-cell-helper.d.ts

@@ -1,4 +1,6 @@
-import { KupDataCell, KupDataDataset, KupDataFindCellFilters } from './kup-data-declarations';
+import { ValueDisplayedValue } from '../../utils/filters/filters-declarations';
+import { KupObj } from '../kup-objects/kup-objects-declarations';
+import { KupDataCell, KupDataColumn, KupDataDataset, KupDataFindCellFilters } from './kup-data-declarations';
 /**
  * Finds all the cells matching the filters criteria in the input dataset.
  * @param {KupDataDataset} dataset - Input dataset.
@@ -7,12 +9,17 @@ import { KupDataCell, KupDataDataset, KupDataFindCellFilters } from './kup-data-
  */
 export declare function findCell(dataset: KupDataDataset, filters: KupDataFindCellFilters): KupDataCell[];
 /**
- * Returns all the cells values of the specified columns.
- * @param {KupDataDataset} dataset - Input dataset.
- * @param {string[]} columns - Columns included in the search. When missing, searches all columns.
- * @returns {string[]} Values of the cells.
+ * Returns all the cells values of the specified column, sorted if required.
+ * @param {Array<KupDataRow>} dataset - Input dataset.
+ * @param {KupDataColumn} column - Column included in the search. When missing, returns empty array.
+ * @returns {ValueDisplayedValue[]} Values of the cells, sorted.
  */
-export declare function getCellValue(dataset: KupDataDataset, columns?: string[]): string[];
+export declare function getCellValue(dataset: KupDataDataset, column: KupDataColumn, sorted?: boolean): ValueDisplayedValue[];
+export declare function addColumnValueFromRow(values: {
+  value: string;
+  displayedValue?: string;
+  obj?: KupObj;
+}[], column: KupDataColumn, cell: KupDataCell): void;
 /**
  * Overrides the given cell attributes for the specified columns.
  * If no columns are provided, the value will be applied to every column of the dataset.

package/dist/types/managers/kup-data/kup-data-declarations.d.ts

@@ -105,6 +105,7 @@ export interface KupDataColumnOperations {
  * Interface related to nodes operations.
  */
 export interface KupDataNodeOperations {
+  getDrilldownInfo: (nodes: KupDataNode[]) => KupDataNodeDrilldownInfo;
   getParent: (nodes: KupDataNode[], child: KupDataNode) => KupDataNode;
   remove: (nodes: KupDataNode[], node2remove: KupDataNode) => KupDataNode;
   setProperties: (nodes: KupDataNode[], properties: Partial<KupDataNode>, recursively?: boolean, exclude?: KupDataNode[]) => KupDataNode[];
@@ -152,6 +153,13 @@ export interface KupDataNewColumnOptions {
   operation?: string;
   separator?: string;
 }
+/**
+ * Interface containing the options related to column creation when invoking column.new.
+ */
+export interface KupDataNodeDrilldownInfo {
+  maxChildren?: number;
+  maxDepth?: number;
+}
 /**
  * Types of column creation when invoking column.new.
  */

package/dist/types/managers/kup-data/kup-data-node-helper.d.ts

@@ -1,4 +1,5 @@
-import { KupDataNode } from './kup-data-declarations';
+import { TreeNodePath } from '../../components/kup-tree/kup-tree-declarations';
+import { KupDataNode, KupDataNodeDrilldownInfo } from './kup-data-declarations';
 /**
  * Removes the given node from the input array, by searching even children.
  * @param {KupDataNode[]} nodes - Input array of nodes.
@@ -21,6 +22,12 @@ export declare function setPropertiesNode(nodes: KupDataNode[], properties: Part
  * @returns {KupDataNode[]} Streamlined array of every node and their children.
  */
 export declare function toStreamNode(nodes: KupDataNode[]): KupDataNode[];
+/**
+ * Gets information about the tree depth, such as max number of children and max depth.
+ * @param {KupDataNode[]} nodes - Input array of nodes.
+ * @returns {KupDataNodeDrilldownInfo} Information about the tree depth.
+ */
+export declare function getDrilldownInfoNode(nodes: KupDataNode[]): KupDataNodeDrilldownInfo;
 /**
  * Returns the parent of the given node.
  * @param {KupDataNode[]} nodes - Input array of nodes.
@@ -28,3 +35,10 @@ export declare function toStreamNode(nodes: KupDataNode[]): KupDataNode[];
  * @returns {KupDataNode} Parent node.
  */
 export declare function getParentNode(nodes: KupDataNode[], child: KupDataNode): KupDataNode;
+/**
+ * Returns the node with id equal to the given value.
+ * @param {KupDataNode[]} nodes - Input array of nodes.
+ * @param {string} treeNodePath - Tree node path.
+ * @returns {KupDataNode} Node.
+ */
+export declare function getNodeByPath(nodes: KupDataNode[], treeNodePath: TreeNodePath): KupDataNode;

package/dist/types/managers/kup-data/kup-data.d.ts

@@ -1,4 +1,7 @@
-import { KupDataCell, KupDataColumn, KupDataDataset, KupDataDatasetSort, KupDataFindCellFilters, KupDataNewColumn, KupDataNewColumnOptions, KupDataNewColumnTypes, KupDataNode, KupDataRow } from './kup-data-declarations';
+import { KupDataCell, KupDataColumn, KupDataDataset, KupDataDatasetSort, KupDataFindCellFilters, KupDataNewColumn, KupDataNewColumnOptions, KupDataNewColumnTypes, KupDataNode, KupDataNodeDrilldownInfo, KupDataRow } from './kup-data-declarations';
+import { FCellShapes, FCellTypes } from '../../f-components/f-cell/f-cell-declarations';
+import { TreeNodePath } from '../../components/kup-tree/kup-tree-declarations';
+import { ValueDisplayedValue } from '../../utils/filters/filters-declarations';
 /**
  * Handles data operations.
  * @module KupData
@@ -6,8 +9,9 @@ import { KupDataCell, KupDataColumn, KupDataDataset, KupDataDatasetSort, KupData
 export declare class KupData {
   cell: {
     find(dataset: KupDataDataset, filters: KupDataFindCellFilters): KupDataCell[];
-    getValue(dataset: KupDataDataset, columns?: string[]): string[];
+    getValue(dataset: KupDataDataset, column: KupDataColumn, sorted?: boolean): ValueDisplayedValue[];
     replace(dataset: KupDataDataset, cell: KupDataCell, columns?: string[]): KupDataCell[];
+    getType(cell: KupDataCell, shape?: FCellShapes): FCellTypes;
   };
   column: {
     find(dataset: KupDataDataset | KupDataColumn[], filters: Partial<KupDataColumn>): KupDataColumn[];
@@ -15,7 +19,10 @@ export declare class KupData {
     new(dataset: KupDataDataset, type: KupDataNewColumnTypes, options: KupDataNewColumnOptions): string | KupDataColumn;
   };
   node: {
+    getDrilldownInfo(nodes: KupDataNode[]): KupDataNodeDrilldownInfo;
     getParent(nodes: KupDataNode[], child: KupDataNode): KupDataNode;
+    find(nodes: KupDataNode[], treeNodePath: TreeNodePath): KupDataNode;
+    findByStrTreeNodePath(nodes: KupDataNode[], treeNodePath: string): KupDataNode;
     remove(nodes: KupDataNode[], node2remove: KupDataNode): KupDataNode;
     setProperties(nodes: KupDataNode[], properties: Partial<KupDataNode>, recursively?: boolean, exclude?: KupDataNode[]): KupDataNode[];
     toStream(nodes: KupDataNode[]): KupDataNode[];

package/dist/types/managers/kup-language/kup-language-declarations.d.ts

@@ -3,7 +3,7 @@ import type { GenericObject } from '../../types/GenericTypes';
  * Master type extending all subtypes of keys.
  * Remember to edit "languages.json"
  */
-export declare type KupLanguageKey = KupLanguageCheckbox | KupLanguageColumn | KupLanguageDebug | KupLanguageDensity | KupLanguageFontsize | KupLanguageGeneric | KupLanguageGrid | KupLanguageGrouping | KupLanguagePage | KupLanguageRow | KupLanguageSearch | KupLanguageTotals;
+export declare type KupLanguageKey = KupLanguageCheckbox | KupLanguageColumn | KupLanguageDashboard | KupLanguageDebug | KupLanguageDensity | KupLanguageFontsize | KupLanguageGeneric | KupLanguageGrid | KupLanguageGrouping | KupLanguagePage | KupLanguageRow | KupLanguageSearch | KupLanguageTotals;
 /**
  * Interface of the languages JSON.
  */
@@ -61,6 +61,16 @@ export declare enum KupLanguageColumn {
   NON_NUMERICAL_IN_TABLE = "columnNonNumericalInTable",
   SWAP = "columnSwap"
 }
+/**
+ * Dashboard related decodes.
+ */
+export declare enum KupLanguageDashboard {
+  DIMENSION = "dashboardDimension",
+  LOADED = "dashboardLoaded",
+  RESET = "dashboardReset",
+  SAVE = "dashboardSave",
+  VERTICAL = "dashboardVertical"
+}
 /**
  * Debug widget decodes.
  */

package/dist/types/managers/kup-objects/kup-objects.d.ts

@@ -126,6 +126,12 @@ export declare class KupObjects {
    * @returns {boolean} True when the object can be considered as a string.
    */
   isStringObject(obj: any): boolean;
+  /**
+   * Checks whether the object represents a switch or not.
+   * @param {KupObj} obj - Object to check.
+   * @returns {boolean} True when the object is a switch.
+   */
+  isSwitch(obj: KupObj): boolean;
   /**
    * Checks whether the object represents a text field or not.
    * @param {KupObj} obj - Object to check.

package/dist/types/managers/kup-scroll-on-hover/kup-scroll-on-hover-declarations.d.ts

@@ -5,15 +5,23 @@ export interface KupScrollOnHoverElement extends HTMLElement {
   scrollOnHover: {
     active: boolean;
     children: NodeListOf<HTMLElement>;
+    percentages: KupScrollOnHoverPercentages;
     rect: DOMRect;
+    vertical: boolean;
     x: number;
     y: number;
   };
 }
+export interface KupScrollOnHoverPercentages {
+  back: number;
+  forward: number;
+}
 /**
  * The direction to which ScollableElement can be scrolled.
  */
 export declare enum ScrollOnHoverDirection {
+  BOTTOM = "bottom",
   LEFT = "left",
-  RIGHT = "right"
+  RIGHT = "right",
+  TOP = "top"
 }

package/dist/types/managers/kup-scroll-on-hover/kup-scroll-on-hover.d.ts

@@ -1,4 +1,4 @@
-import { KupScrollOnHoverElement, ScrollOnHoverDirection } from './kup-scroll-on-hover-declarations';
+import { KupScrollOnHoverElement, KupScrollOnHoverPercentages, ScrollOnHoverDirection } from './kup-scroll-on-hover-declarations';
 /**
  * Lets the user scroll an element's overflow by hovering with the mouse on its left/right edge.
  * @module KupScrollOnHover
@@ -19,8 +19,10 @@ export declare class KupScrollOnHover {
    * Watches the given element in order to trigger the scroll on hover when conditions are met.
    * Children nodes with the "hover-scrolling-child" will be watched and scrolled when el scrolls.
    * @param {KupScrollOnHoverElement} el - Element to watch.
+   * @param {boolean} vertical - Enables vertical scroll.
+   * @param {KupScrollOnHoverPercentages} percentages - Sets how big is the area in which the scroll is enabled.
    */
-  register(el: KupScrollOnHoverElement): void;
+  register(el: KupScrollOnHoverElement, vertical?: boolean, percentages?: KupScrollOnHoverPercentages): void;
   /**
    * Removes the given element from ScrollOnHover watchlist.
    * @param {KupScrollOnHoverElement} el - Element to unregister.
@@ -46,11 +48,11 @@ export declare class KupScrollOnHover {
    * The actual recursive scroll function.
    * @param {KupScrollOnHoverElement} el - The scrolled element.
    * @param {number} maxScrollLeft - Left coordinates to which the recursiveness must be stopped.
-   * @param {number} percRight - Range of the right scrollable area.
-   * @param {number} percLeft - Range of the left scrollable area.
+   * @param {number} percForward - Range of the right (or bottom) area.
+   * @param {number} percBack - Range of the left (or top) scrollable area.
    * @param {ScrollOnHoverDirection} direction - Direction of the scroll.
    */
-  run(el: KupScrollOnHoverElement, maxScrollLeft: number, percRight: number, percLeft: number, direction: ScrollOnHoverDirection): void;
+  run(el: KupScrollOnHoverElement, maxScrollLeft: number, percForward: number, percBack: number, direction: ScrollOnHoverDirection): void;
   /**
    * Scrolls children of the element having the "hover-scrolling-child" class
    * @param {KupScrollOnHoverElement} el - The scrolled element.

package/dist/types/types/GenericTypes.d.ts

@@ -75,12 +75,13 @@ export declare enum KupTagNames {
   COMBOBOX = "KUP-COMBOBOX",
   DASH = "KUP-DASH",
   DASH_LIST = "KUP-DASH-LIST",
+  DASHBOARD = "KUP-DASHBOARD",
   DATA_TABLE = "KUP-DATA-TABLE",
   DATE_PICKER = "KUP-DATE-PICKER",
   DRAWER = "KUP-DRAWER",
   DROPDOWN_BUTTON = "KUP-DROPDOWN-BUTTON",
-  FIELD = "KUP-FIELD",
-  FORM_EDITOR = "KUP-FORM-EDITOR",
+  FAMILY_TREE = "KUP-FAMILY-TREE",
+  FORM = "KUP-FORM",
   GAUGE = "KUP-GAUGE",
   GRID = "KUP-GRID",
   IFRAME = "KUP-IFRAME",

package/dist/types/utils/filters/filters-rows.d.ts

@@ -27,6 +27,4 @@ export declare class FiltersRows extends Filters {
    */
   filterRows(rows?: Array<KupDataRow>, filters?: GenericFilter, globalFilter?: string, columns?: KupDataColumn[], columnFilters?: FiltersColumnMenu): Array<KupDataRow>;
   getColumnValues(comp: KupDataTable | KupTree, column: KupDataColumn, globalFilterValue: string, columnFilters?: FiltersColumnMenu): ValueDisplayedValue[];
-  extractColumnValues(rows: Array<KupDataRow>, column: KupDataColumn, values: ValueDisplayedValue[]): ValueDisplayedValue[];
-  addColumnValueFromRow(values: ValueDisplayedValue[], column: KupDataColumn, cell: KupDataCell): void;
 }

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@sme.up/ketchup",
-    "version": "6.1.0-SNAPSHOT",
+    "version": "6.3.0",
     "keywords": [
         "smeup",
         "KetchUP",
@@ -56,7 +56,7 @@
         "vanilla-picker": "^2.12.1"
     },
     "devDependencies": {
-        "@stencil/core": "^2.15.2",
+        "@stencil/core": "^2.17.3",
         "@stencil/sass": "^1.4.1",
         "@types/d3-shape": "^3.0.2",
         "@types/geojson": "^7946.0.8",

package/dist/cjs/cell-utils-a78d6fac.js

@@ -1,168 +0,0 @@
-'use strict';
-
-const utils = require('./utils-6287d878.js');
-const kupManager = require('./kup-manager-7a941909.js');
-
-const dom = document.documentElement;
-// -------------
-// COMMONS
-// -------------
-function getCellValueForDisplay(column, cell) {
-  if (cell != null) {
-    if (cell.displayedValue != null) {
-      return cell.displayedValue;
-    }
-  }
-  let formattedValue = _getCellValueForDisplay(cell.value, column, cell);
-  if (cell != null) {
-    cell.displayedValue = formattedValue;
-  }
-  return formattedValue;
-}
-function getValueForDisplay2(values, column) {
-  if (values == null) {
-    return '';
-  }
-  if (values.displayedValue == null || values.displayedValue.trim() == '') {
-    values.displayedValue = _getCellValueForDisplay(values.value, column, null);
-  }
-  return values.displayedValue;
-}
-function formatToNumber(cell) {
-  if (cell.obj) {
-    return dom.ketchup.math.numberify(cell.obj.k);
-  }
-  return dom.ketchup.math.numberify(cell.value);
-}
-function _getCellValueForDisplay(value, column, cell) {
-  let obj = column != null ? column.obj : null;
-  if (cell != null) {
-    obj = cell.obj ? cell.obj : obj;
-  }
-  return getValueForDisplay(value, obj, column != null ? column.decimals : null);
-}
-function getValueForDisplay(value, obj, decimals) {
-  if (value == null || value.trim() == '') {
-    return value;
-  }
-  if (dom.ketchup.objects.isNumber(obj)) {
-    return utils.unformattedStringToFormattedStringNumber(value, decimals ? decimals : -1, obj ? obj.p : '');
-  }
-  if (dom.ketchup.objects.isDate(obj) &&
-    dom.ketchup.dates.isValid(value, kupManager.KupDatesFormats.ISO_DATE)) {
-    return dom.ketchup.dates.format(value);
-  }
-  if (dom.ketchup.objects.isTime(obj)) {
-    return utils.unformattedStringToFormattedStringTime(value, dom.ketchup.objects.isTimeWithSeconds(obj), obj.t + obj.p);
-  }
-  if (dom.ketchup.objects.isTimestamp(obj)) {
-    return utils.unformattedStringToFormattedStringTimestamp(value);
-  }
-  return value;
-}
-function getColumnByName(columns, name) {
-  if (columns == null) {
-    return null;
-  }
-  for (let column of columns) {
-    if (column.name === name) {
-      return column;
-    }
-  }
-  return null;
-}
-function compareCell(cell1, cell2, sortMode) {
-  return compareValues(cell1.obj, cell1.value, cell2.obj, cell2.value, sortMode);
-}
-function compareValues(obj1, value1, obj2, value2, sortMode) {
-  const sm = sortMode === 'A' ? 1 : -1;
-  if (obj1 == null || obj2 == null) {
-    return sm * localCompareAsInJava(value1, value2);
-  }
-  // If either the type or the parameter of the current object are not equal.
-  if (!(obj1.t === obj2.t && obj1.p === obj2.p)) {
-    let compare = localCompareAsInJava(obj1.t, obj2.t);
-    if (compare === 0) {
-      compare = localCompareAsInJava(obj1.p, obj2.p);
-    }
-    return compare * sm;
-  }
-  let s1 = value1;
-  let s2 = value2;
-  if (s1 == s2) {
-    return 0;
-  }
-  if (s1 == '') {
-    return sm * -1;
-  }
-  if (s2 == '') {
-    return sm * 1;
-  }
-  let v1 = s1;
-  let v2 = s2;
-  if (dom.ketchup.objects.isNumber(obj1)) {
-    v1 = utils.stringToNumber(s1);
-    v2 = utils.stringToNumber(s2);
-  }
-  else if (dom.ketchup.objects.isDate(obj1)) {
-    v1 = dom.ketchup.dates.toDate(dom.ketchup.dates.format(s1, kupManager.KupDatesFormats.ISO_DATE));
-    v2 = dom.ketchup.dates.toDate(dom.ketchup.dates.format(s2, kupManager.KupDatesFormats.ISO_DATE));
-  }
-  else if (dom.ketchup.objects.isTime(obj1)) {
-    let manageSeconds = dom.ketchup.objects.isTimeWithSeconds(obj1);
-    v1 = dom.ketchup.dates.toDate(dom.ketchup.dates.format(s1, manageSeconds
-      ? kupManager.KupDatesFormats.ISO_TIME
-      : kupManager.KupDatesFormats.ISO_TIME_WITHOUT_SECONDS));
-    v2 = dom.ketchup.dates.toDate(dom.ketchup.dates.format(s2, manageSeconds
-      ? kupManager.KupDatesFormats.ISO_TIME
-      : kupManager.KupDatesFormats.ISO_TIME_WITHOUT_SECONDS));
-  }
-  else if (dom.ketchup.objects.isTimestamp(obj1)) {
-    v1 = dom.ketchup.dates.toDate(dom.ketchup.dates.format(s1, kupManager.KupDatesFormats.ISO_DATE_TIME));
-    v2 = dom.ketchup.dates.toDate(dom.ketchup.dates.format(s2, kupManager.KupDatesFormats.ISO_DATE_TIME));
-  }
-  if (v1 > v2) {
-    return sm * 1;
-  }
-  if (v1 < v2) {
-    return sm * -1;
-  }
-  return 0;
-}
-/**
- * Given two strings to compare, the functions decides which string comes before the other or if they are equal.
- * This is meant as a replacement for the JavaScript function localCompare() which produces a slightly different result from
- * the Java version of compareTo().
- *
- * Re-implemented from java source method compareTo() of java.lang.String
- * @param t1 firstString the first string to be compared
- * @param t2 anotherString the another string to be compared to the first one
- * @returns the value 0 if the anotherString is equal to
- *          firstString; a value less than 0 if firstString
- *          is lexicographically less than the anotherString; and a
- *          value greater than 0 if firstString is
- *          lexicographically greater than the anotherString.
- */
-function localCompareAsInJava(t1, t2) {
-  let t1Length = t1 == null ? 0 : t1.length;
-  let t2Length = t2 == null ? 0 : t2.length;
-  const lim = Math.min(t1Length, t2Length);
-  let k = 0;
-  while (k < lim) {
-    const c1 = t1[k];
-    const c2 = t2[k];
-    if (c1 !== c2) {
-      return c1.charCodeAt(0) - c2.charCodeAt(0);
-    }
-    k++;
-  }
-  return t1Length - t2Length;
-}
-
-exports.compareCell = compareCell;
-exports.compareValues = compareValues;
-exports.formatToNumber = formatToNumber;
-exports.getCellValueForDisplay = getCellValueForDisplay;
-exports.getColumnByName = getColumnByName;
-exports.getValueForDisplay = getValueForDisplay;
-exports.getValueForDisplay2 = getValueForDisplay2;