cx 25.10.1 → 25.11.1

package/dist/ui.js

@@ -979,7 +979,7 @@ var ArrayAdapter = /*#__PURE__*/ (function (_DataAdapter) {
 				var record = _this.mapRecord(context, instance, data, parentStore, recordsAccessor, index);
 				result.push(record);
 			});
-		if (this.sorter) result = this.sorter(result);
+		if (this.sorter && !this.preserveOrder) result = this.sorter(result);
 		return result;
 	};
 	_proto.mapRecord = function mapRecord(context, instance, data, parentStore, recordsAccessor, index) {
@@ -4286,6 +4286,7 @@ var GroupAdapter = /*#__PURE__*/ (function (_ArrayAdapter) {
 		var level = keys.length;
 		var inverseLevel = this.groupings.length - level;
 		if (inverseLevel == 0) {
+			if (this.preserveOrder && this.sorter) records = this.sorter(records);
 			for (var i = 0; i < records.length; i++) {
 				records[i].store.setStore(parentStore);
 				result.push(records[i]);
@@ -4297,7 +4298,7 @@ var GroupAdapter = /*#__PURE__*/ (function (_ArrayAdapter) {
 		grouper.reset();
 		grouper.processAll(records);
 		var results = grouper.getResults();
-		if (grouping.comparer) results.sort(grouping.comparer);
+		if (grouping.comparer && !this.preserveOrder) results.sort(grouping.comparer);
 		results.forEach(function (gr) {
 			var _data;
 			keys.push(gr.key);
@@ -4386,6 +4387,7 @@ var GroupAdapter = /*#__PURE__*/ (function (_ArrayAdapter) {
 	return GroupAdapter;
 })(ArrayAdapter);
 GroupAdapter.prototype.groupName = "$group";
+GroupAdapter.prototype.preserveOrder = false;
 function serializeKey(data) {
 	var _data$toString;
 	if (isObject(data))

package/dist/widgets.js

@@ -15826,6 +15826,7 @@ var Grid = /*#__PURE__*/ (function (_Container) {
 				indexName: this.indexName,
 				sortOptions: this.sortOptions,
 				groupings: grouping,
+				preserveOrder: this.preserveGroupOrder,
 			},
 			this.dataAdapter,
 		);
@@ -16860,6 +16861,7 @@ Grid.prototype.preciseMeasurements = false;
 Grid.prototype.hoverChannel = "default";
 Grid.prototype.focusable = null; // automatically resolved
 Grid.prototype.allowsFileDrops = false;
+Grid.prototype.preserveGroupOrder = false;
 Widget.alias("grid", Grid);
 Localization.registerPrototype("cx/widgets/Grid", Grid);
 var GridComponent = /*#__PURE__*/ (function (_VDOM$Component) {

package/package.json

@@ -1,6 +1,6 @@
 {
    "name": "cx",
-   "version": "25.10.1",
+   "version": "25.11.1",
    "description": "Advanced JavaScript UI framework for admin and dashboard applications with ready to use grid, form and chart components.",
    "main": "index.js",
    "jsnext:main": "src/index.js",

package/src/charts/Bar.d.ts

@@ -1,28 +1,28 @@
-import * as Cx from '../core';
-import { ColumnBarBaseProps } from './ColumnBarBase';
-
-interface BarProps extends ColumnBarBaseProps {
-   
-   /** Base value. Default value is `0`.  */
-   x0?: Cx.NumberProp,
-   
-   /** Size (width) of the column in axis units. */
-   size?: Cx.NumberProp,
-
-   /** Set to true to auto calculate size and offset. Available only if the x axis is a category axis. */
-   autoSize?: Cx.BooleanProp,
-   
-   height?: Cx.NumberProp,
- 
-   /** Base CSS class to be applied to the element. Defaults to `bar`. */
-   baseClass?: string,
-
-   /** Tooltip configuration. For more info see Tooltips. */
-   tooltip?: Cx.StringProp | Cx.StructuredProp,
-
-   /** Selection configuration. */
-   selection?: Cx.Config
-
-}
-
+import * as Cx from '../core';
+import { ColumnBarBaseProps } from './ColumnBarBase';
+
+interface BarProps extends ColumnBarBaseProps {
+   
+   /** Base value. Default value is `0`.  */
+   x0?: Cx.NumberProp,
+   
+   /** Size (width) of the column in axis units. */
+   size?: Cx.NumberProp,
+
+   /** Set to true to auto calculate size and offset. Available only if the x axis is a category axis. */
+   autoSize?: Cx.BooleanProp,
+   
+   height?: Cx.NumberProp,
+ 
+   /** Base CSS class to be applied to the element. Defaults to `bar`. */
+   baseClass?: string,
+
+   /** Tooltip configuration. For more info see Tooltips. */
+   tooltip?: Cx.StringProp | Cx.StructuredProp,
+
+   /** Selection configuration. */
+   selection?: Cx.Config
+
+}
+
 export class Bar extends Cx.Widget<BarProps> {}

package/src/charts/BarGraph.d.ts

@@ -1,15 +1,15 @@
-import * as Cx from "../core";
-import { ColumnBarGraphBaseProps } from "./ColumnBarGraphBase";
-
-interface BarGraphProps extends ColumnBarGraphBaseProps {
-   /** Base CSS class to be applied to the element. Defaults to `bargraph`. */
-   baseClass?: string;
-
-   /**
-    * Name of the property which holds the base value.
-    * Default value is `false`, which means x0 value is not read from the data array.
-    */
-   x0Field?: string | false;
-}
-
-export class BarGraph extends Cx.Widget<BarGraphProps> {}
+import * as Cx from "../core";
+import { ColumnBarGraphBaseProps } from "./ColumnBarGraphBase";
+
+interface BarGraphProps extends ColumnBarGraphBaseProps {
+   /** Base CSS class to be applied to the element. Defaults to `bargraph`. */
+   baseClass?: string;
+
+   /**
+    * Name of the property which holds the base value.
+    * Default value is `false`, which means x0 value is not read from the data array.
+    */
+   x0Field?: string | false;
+}
+
+export class BarGraph extends Cx.Widget<BarGraphProps> {}

package/src/charts/Chart.d.ts

@@ -1,12 +1,12 @@
-import * as Cx from "../core";
-import { BoundedObject, BoundedObjectProps } from "../svg/BoundedObject";
-
-interface ChartProps extends BoundedObjectProps {
-   /** Axis definition. Each key represent an axis, and each value hold axis configuration. */
-   axes?: Cx.Config;
-
-   /** Put axes over data series.  */
-   axesOnTop?: boolean;
-}
-
-export class Chart extends Cx.Widget<ChartProps> {}
+import * as Cx from "../core";
+import { BoundedObject, BoundedObjectProps } from "../svg/BoundedObject";
+
+interface ChartProps extends BoundedObjectProps {
+   /** Axis definition. Each key represent an axis, and each value hold axis configuration. */
+   axes?: Cx.Config;
+
+   /** Put axes over data series.  */
+   axesOnTop?: boolean;
+}
+
+export class Chart extends Cx.Widget<ChartProps> {}

package/src/charts/ColorMap.d.ts

@@ -1,21 +1,21 @@
-import * as Cx from "../core";
-import { PureContainer } from "../ui/PureContainer";
-
-interface ColorMapProps extends Cx.WidgetProps {
-   onGetCache?: string | (() => Cx.Record);
-   names?: Cx.Prop<string[]>;
-   step?: Cx.NumberProp;
-   offset?: Cx.NumberProp;
-   size?: Cx.NumberProp;
-}
-
-export class ColorMap extends Cx.Widget<ColorMapProps> {
-   static Scope: ColorMapScope;
-}
-
-export class ColorMapScope extends PureContainer {}
-
-export class ColorIndex {
-   acknowledge(name: string);
-   map(name: string): number;
-}
+import * as Cx from "../core";
+import { PureContainer } from "../ui/PureContainer";
+
+interface ColorMapProps extends Cx.WidgetProps {
+   onGetCache?: string | (() => Cx.Record);
+   names?: Cx.Prop<string[]>;
+   step?: Cx.NumberProp;
+   offset?: Cx.NumberProp;
+   size?: Cx.NumberProp;
+}
+
+export class ColorMap extends Cx.Widget<ColorMapProps> {
+   static Scope: ColorMapScope;
+}
+
+export class ColorMapScope extends PureContainer {}
+
+export class ColorIndex {
+   acknowledge(name: string);
+   map(name: string): number;
+}

package/src/charts/Column.d.ts

@@ -1,29 +1,29 @@
-import * as Cx from "../core";
-import { ColumnBarBaseProps } from "./ColumnBarBase";
-
-interface ColumnProps extends ColumnBarBaseProps {
-   /** Column base value. Default value is `0`. */
-   y0?: Cx.NumberProp;
-
-   /** Size (width) of the column in axis units. */
-   size?: Cx.NumberProp;
-
-   /** Set to true to auto calculate size and offset. Available only if the x axis is a category axis. */
-   autoSize?: Cx.BooleanProp;
-
-   /** Base CSS class to be applied to the element. Defaults to `column`. */
-   baseClass?: boolean;
-
-   width?: number;
-
-   /** Selection configuration. */
-   selection?: Config;
-
-   /** Tooltip configuration. For more info see Tooltips. */
-   tooltip?: Cx.StringProp | Cx.StructuredProp;
-
-   /** Minimum column size in pixels. Useful for indicating very small values. Default value is 0.5. */
-   minPixelHeight?: number;
-}
-
-export class Column extends Cx.Widget<ColumnProps> {}
+import * as Cx from "../core";
+import { ColumnBarBaseProps } from "./ColumnBarBase";
+
+interface ColumnProps extends ColumnBarBaseProps {
+   /** Column base value. Default value is `0`. */
+   y0?: Cx.NumberProp;
+
+   /** Size (width) of the column in axis units. */
+   size?: Cx.NumberProp;
+
+   /** Set to true to auto calculate size and offset. Available only if the x axis is a category axis. */
+   autoSize?: Cx.BooleanProp;
+
+   /** Base CSS class to be applied to the element. Defaults to `column`. */
+   baseClass?: boolean;
+
+   width?: number;
+
+   /** Selection configuration. */
+   selection?: Config;
+
+   /** Tooltip configuration. For more info see Tooltips. */
+   tooltip?: Cx.StringProp | Cx.StructuredProp;
+
+   /** Minimum column size in pixels. Useful for indicating very small values. Default value is 0.5. */
+   minPixelHeight?: number;
+}
+
+export class Column extends Cx.Widget<ColumnProps> {}

package/src/charts/ColumnBarBase.d.ts

@@ -1,64 +1,64 @@
-import * as Cx from "../core";
-
-interface ColumnBarBaseProps extends Cx.StyledContainerProps {
-   /** The `x` value binding or expression. */
-   x?: Cx.Prop<string | number>;
-
-   /** The `y` value binding or expression. */
-   y?: Cx.Prop<string | number>;
-
-   disabled?: Cx.BooleanProp;
-
-   /** Index of a color from the standard palette of colors. 0-15. */
-   colorIndex?: Cx.NumberProp;
-
-   /** Used to automatically assign a color based on the `name` and the contextual `ColorMap` widget. */
-   colorMap?: Cx.StringProp;
-
-   /** Name used to resolve the color. If not provided, `name` is used instead. */
-   colorName?: Cx.StringProp;
-
-   /** Name of the item as it will appear in the legend. */
-   name?: Cx.StringProp;
-
-   /** Used to indicate if an item is active or not. Inactive items are shown only in the legend. */
-   active?: Cx.BooleanProp;
-
-   /** Indicate that columns should be stacked on top of the other columns. Default value is `false`. */
-   stacked?: Cx.BooleanProp;
-
-   /** Name of the stack. If multiple stacks are used, each should have a unique name. Default value is `stack`. */
-   stack?: Cx.StringProp;
-
-   /** Of center offset of the column. Use this in combination with `size` to align multiple series on the same chart. */
-   offset?: Cx.NumberProp;
-
-   /** Border radius of the column/bar. */
-   borderRadius?: Cx.NumberProp;
-
-   /**
-    * Name of the horizontal axis. The value should match one of the horizontal axes set
-    * in the `axes` configuration of the parent `Chart` component. Default value is `x`.
-    */
-   xAxis?: string;
-
-   /**
-    * Name of the vertical axis. The value should match one of the vertical axes set
-    *  in the `axes` configuration if the parent `Chart` component. Default value is `y`.
-    */
-   yAxis?: string;
-
-   /** Name of the legend to be used. Default is `legend`. Set to `false` to hide the legend entry. */
-   legend?: string | false;
-
-   legendAction?: string;
-   legendShape?: string;
-
-   /** A value used to identify the group of components participating in hover effect synchronization. */
-   hoverChannel?: string;
-
-   /** A value used to uniquely identify the record within the hover sync group. */
-   hoverId?: Cx.StringProp;
-}
-
-export class ColumnBarBase extends Cx.Widget<ColumnBarBaseProps> {}
+import * as Cx from "../core";
+
+interface ColumnBarBaseProps extends Cx.StyledContainerProps {
+   /** The `x` value binding or expression. */
+   x?: Cx.Prop<string | number>;
+
+   /** The `y` value binding or expression. */
+   y?: Cx.Prop<string | number>;
+
+   disabled?: Cx.BooleanProp;
+
+   /** Index of a color from the standard palette of colors. 0-15. */
+   colorIndex?: Cx.NumberProp;
+
+   /** Used to automatically assign a color based on the `name` and the contextual `ColorMap` widget. */
+   colorMap?: Cx.StringProp;
+
+   /** Name used to resolve the color. If not provided, `name` is used instead. */
+   colorName?: Cx.StringProp;
+
+   /** Name of the item as it will appear in the legend. */
+   name?: Cx.StringProp;
+
+   /** Used to indicate if an item is active or not. Inactive items are shown only in the legend. */
+   active?: Cx.BooleanProp;
+
+   /** Indicate that columns should be stacked on top of the other columns. Default value is `false`. */
+   stacked?: Cx.BooleanProp;
+
+   /** Name of the stack. If multiple stacks are used, each should have a unique name. Default value is `stack`. */
+   stack?: Cx.StringProp;
+
+   /** Of center offset of the column. Use this in combination with `size` to align multiple series on the same chart. */
+   offset?: Cx.NumberProp;
+
+   /** Border radius of the column/bar. */
+   borderRadius?: Cx.NumberProp;
+
+   /**
+    * Name of the horizontal axis. The value should match one of the horizontal axes set
+    * in the `axes` configuration of the parent `Chart` component. Default value is `x`.
+    */
+   xAxis?: string;
+
+   /**
+    * Name of the vertical axis. The value should match one of the vertical axes set
+    *  in the `axes` configuration if the parent `Chart` component. Default value is `y`.
+    */
+   yAxis?: string;
+
+   /** Name of the legend to be used. Default is `legend`. Set to `false` to hide the legend entry. */
+   legend?: string | false;
+
+   legendAction?: string;
+   legendShape?: string;
+
+   /** A value used to identify the group of components participating in hover effect synchronization. */
+   hoverChannel?: string;
+
+   /** A value used to uniquely identify the record within the hover sync group. */
+   hoverId?: Cx.StringProp;
+}
+
+export class ColumnBarBase extends Cx.Widget<ColumnBarBaseProps> {}

package/src/charts/ColumnBarGraphBase.d.ts

@@ -1,73 +1,73 @@
-import * as Cx from "../core";
-import { KeySelection, PropertySelection } from "../ui/selection";
-
-interface ColumnBarGraphBaseProps extends Cx.WidgetProps {
-   /**
-    * Data for the graph. Each entry should be an object with at least two properties
-    *  whose names should match the `xField` and `yField` values.
-    */
-   data?: Cx.RecordsProp;
-
-   /** Index of a color from the standard palette of colors. 0-15. */
-   colorIndex?: Cx.NumberProp;
-
-   /** Used to automatically assign a color based on the `name` and the contextual `ColorMap` widget. */
-   colorMap?: Cx.StringProp;
-
-   /** Name used to resolve the color. If not provided, `name` is used instead. */
-   colorName?: Cx.StringProp;
-
-   /** Name of the item as it will appear in the legend. */
-   name?: Cx.StringProp;
-
-   /** Size (width) of the column in axis units. */
-   size?: Cx.NumberProp;
-
-   /** Of center offset of the column. Use this in combination with `size` to align multiple series on the same chart. */
-   offset?: Cx.NumberProp;
-
-   /** Set to true to auto-calculate size and offset. Available only if the x axis is a category axis. */
-   autoSize?: Cx.BooleanProp;
-
-   /** Used to indicate if an item is active or not. Inactive items are shown only in the legend. */
-   active?: Cx.BooleanProp;
-
-   /** Indicate that columns should be stacked on top of the other columns. Default value is `false`. */
-   stacked?: Cx.BooleanProp;
-
-   /** Border radius of the column/bar. */
-   borderRadius?: Cx.NumberProp;
-
-   /** Name of the stack. If multiple stacks are used, each should have a unique name. Default value is `stack`. */
-   stack?: Cx.StringProp;
-
-   /** Name of the horizontal axis. The value should match one of the horizontal axes set
-    *  in the `axes` configuration of the parent `Chart` component. Default value is `x`.
-    */
-   xAxis?: string;
-
-   /**
-    *  Name of the vertical axis. The value should match one of the vertical axes set
-    * in the `axes` configuration if the parent `Chart` component. Default value is `y`.
-    */
-   yAxis?: string;
-
-   /** Name of the property which holds the x value. Default value is `x`. */
-   xField?: string;
-
-   /** Name of the property which holds the y value. Default value is `y`. */
-   yField?: string;
-
-   colorIndexField?: boolean;
-
-   /** Name of the legend to be used. Default is `legend`. Set to `false` to hide the legend entry. */
-   legend?: string | false;
-
-   legendAction?: string;
-   legendShape?: string;
-
-   /** Selection configuration. */
-   selection?: { type: typeof PropertySelection | typeof KeySelection; [prop: string]: any };
-}
-
-export class ColumnBarGraphBase extends Cx.Widget<ColumnBarGraphBaseProps> {}
+import * as Cx from "../core";
+import { KeySelection, PropertySelection } from "../ui/selection";
+
+interface ColumnBarGraphBaseProps extends Cx.WidgetProps {
+   /**
+    * Data for the graph. Each entry should be an object with at least two properties
+    *  whose names should match the `xField` and `yField` values.
+    */
+   data?: Cx.RecordsProp;
+
+   /** Index of a color from the standard palette of colors. 0-15. */
+   colorIndex?: Cx.NumberProp;
+
+   /** Used to automatically assign a color based on the `name` and the contextual `ColorMap` widget. */
+   colorMap?: Cx.StringProp;
+
+   /** Name used to resolve the color. If not provided, `name` is used instead. */
+   colorName?: Cx.StringProp;
+
+   /** Name of the item as it will appear in the legend. */
+   name?: Cx.StringProp;
+
+   /** Size (width) of the column in axis units. */
+   size?: Cx.NumberProp;
+
+   /** Of center offset of the column. Use this in combination with `size` to align multiple series on the same chart. */
+   offset?: Cx.NumberProp;
+
+   /** Set to true to auto-calculate size and offset. Available only if the x axis is a category axis. */
+   autoSize?: Cx.BooleanProp;
+
+   /** Used to indicate if an item is active or not. Inactive items are shown only in the legend. */
+   active?: Cx.BooleanProp;
+
+   /** Indicate that columns should be stacked on top of the other columns. Default value is `false`. */
+   stacked?: Cx.BooleanProp;
+
+   /** Border radius of the column/bar. */
+   borderRadius?: Cx.NumberProp;
+
+   /** Name of the stack. If multiple stacks are used, each should have a unique name. Default value is `stack`. */
+   stack?: Cx.StringProp;
+
+   /** Name of the horizontal axis. The value should match one of the horizontal axes set
+    *  in the `axes` configuration of the parent `Chart` component. Default value is `x`.
+    */
+   xAxis?: string;
+
+   /**
+    *  Name of the vertical axis. The value should match one of the vertical axes set
+    * in the `axes` configuration if the parent `Chart` component. Default value is `y`.
+    */
+   yAxis?: string;
+
+   /** Name of the property which holds the x value. Default value is `x`. */
+   xField?: string;
+
+   /** Name of the property which holds the y value. Default value is `y`. */
+   yField?: string;
+
+   colorIndexField?: boolean;
+
+   /** Name of the legend to be used. Default is `legend`. Set to `false` to hide the legend entry. */
+   legend?: string | false;
+
+   legendAction?: string;
+   legendShape?: string;
+
+   /** Selection configuration. */
+   selection?: { type: typeof PropertySelection | typeof KeySelection; [prop: string]: any };
+}
+
+export class ColumnBarGraphBase extends Cx.Widget<ColumnBarGraphBaseProps> {}

package/src/charts/ColumnGraph.d.ts

@@ -1,18 +1,18 @@
-import * as Cx from "../core";
-import { ColumnBarGraphBaseProps } from "./ColumnBarGraphBase";
-
-interface ColumnGraphProps extends ColumnBarGraphBaseProps {
-   /** Base CSS class to be applied to the element. Defaults to `columngraph`. */
-   baseClass?: string;
-
-   /**
-    * Name of the property which holds the base value.
-    * Default value is `false`, which means y0 value is not read from the data array.
-    */
-   y0Field?: string | false;
-
-   /** Column base value. Default value is `0`. */
-   y0?: Cx.NumberProp;
-}
-
-export class ColumnGraph extends Cx.Widget<ColumnGraphProps> {}
+import * as Cx from "../core";
+import { ColumnBarGraphBaseProps } from "./ColumnBarGraphBase";
+
+interface ColumnGraphProps extends ColumnBarGraphBaseProps {
+   /** Base CSS class to be applied to the element. Defaults to `columngraph`. */
+   baseClass?: string;
+
+   /**
+    * Name of the property which holds the base value.
+    * Default value is `false`, which means y0 value is not read from the data array.
+    */
+   y0Field?: string | false;
+
+   /** Column base value. Default value is `0`. */
+   y0?: Cx.NumberProp;
+}
+
+export class ColumnGraph extends Cx.Widget<ColumnGraphProps> {}

package/src/charts/Gridlines.d.ts

@@ -1,25 +1,25 @@
-import * as Cx from '../core';
-import { BoundedObject, BoundedObjectProps } from '../svg/BoundedObject';
-
-interface GridlinesProps extends BoundedObjectProps {
-   
-   /** 
-    * Name of the horizontal axis. The value should match one of the horizontal axes set 
-    * in the `axes` configuration of the parent `Chart` component. Default value is `x`.
-    * Set to `false` to hide the grid lines in x direction.
-    */
-   xAxis?: string | boolean,
-
-   /** 
-    * Name of the vertical axis. The value should match one of the vertical axes set
-    * in the `axes` configuration if the parent `Chart` component. Default value is `y`.
-    * Set to `false` to hide the grid lines in y direction.
-    */
-   yAxis?: string | boolean,
-   
-   /** Base CSS class to be applied to the element. Defaults to `gridlines`. */
-   baseClass?: string
-
-}
-
+import * as Cx from '../core';
+import { BoundedObject, BoundedObjectProps } from '../svg/BoundedObject';
+
+interface GridlinesProps extends BoundedObjectProps {
+   
+   /** 
+    * Name of the horizontal axis. The value should match one of the horizontal axes set 
+    * in the `axes` configuration of the parent `Chart` component. Default value is `x`.
+    * Set to `false` to hide the grid lines in x direction.
+    */
+   xAxis?: string | boolean,
+
+   /** 
+    * Name of the vertical axis. The value should match one of the vertical axes set
+    * in the `axes` configuration if the parent `Chart` component. Default value is `y`.
+    * Set to `false` to hide the grid lines in y direction.
+    */
+   yAxis?: string | boolean,
+   
+   /** Base CSS class to be applied to the element. Defaults to `gridlines`. */
+   baseClass?: string
+
+}
+
 export class Gridlines extends Cx.Widget<GridlinesProps> {}