cx 25.10.1 → 26.0.1

package/src/ui/Widget.js

@@ -1,184 +0,0 @@
-import { Component } from "../util/Component";
-import { CSSHelper } from "./CSSHelper";
-import "./CSS";
-import { StructuredSelector } from "../data/StructuredSelector";
-import { parseStyle } from "../util/parseStyle";
-import { isString } from "../util/isString";
-import { isDefined } from "../util/isDefined";
-import { isArray } from "../util/isArray";
-import { Console } from "../util/Console";
-
-import { VDOM as vdom } from "./VDOM";
-export const VDOM = vdom;
-
-let widgetId = 100;
-
-export class Widget extends Component {
-   constructor(config) {
-      super(config);
-      this.widgetId = widgetId++;
-
-      if (isArray(this.jsxSpread)) {
-         if (!this.jsxAttributes) this.jsxAttributes = [];
-
-         this.jsxSpread.forEach((spread) => {
-            for (var key in spread) {
-               this[key] = spread[key];
-               this.jsxAttributes.push(key);
-            }
-         });
-      }
-   }
-
-   init() {
-      if (this.styles) this.style = this.styles;
-
-      if (this.styled) this.style = parseStyle(this.style);
-      else if (this.style) {
-         Console.warn(
-            "Components that allow use of the style attribute should set styled = true on their prototype. This will be an error in future versions.",
-         );
-         this.style = parseStyle(this.style);
-         this.styled = true;
-      }
-
-      if (typeof this.if !== "undefined") this.visible = this.if;
-
-      this.declareData();
-
-      if (this.outerLayout) {
-         if (isArray(this.outerLayout)) throw new Error("Only single element outer layout is supported.");
-         //TODO: better handle the case when outer layout is an array. How to get around circular dependency to PureContainer
-         this.outerLayout = Widget.create(this.outerLayout);
-      }
-
-      if (this.contentFor) this.putInto = this.contentFor;
-
-      if (this.putInto) this.isContent = true;
-
-      if (isString(this.CSS)) this.CSS = CSSHelper.get(this.CSS);
-
-      this.initHelpers();
-      this.initComponents();
-
-      this.initialized = true;
-   }
-
-   initComponents() {
-      if (arguments.length > 0) {
-         this.components = Object.assign(...arguments);
-         for (var k in this.components) if (!this.components[k]) delete this.components[k];
-      }
-   }
-
-   initHelpers() {
-      if (arguments.length > 0) {
-         this.helpers = Object.assign(...arguments);
-      }
-   }
-
-   declareData() {
-      let options = {};
-
-      if (this.styled) options.class = options.className = options.style = { structured: true };
-
-      var props = {
-         visible: undefined,
-         mod: {
-            structured: true,
-         },
-         ...options,
-      };
-
-      Object.assign(props, ...arguments);
-      this.selector = new StructuredSelector({ props: props, values: this });
-      this.nameMap = this.selector.nameMap;
-   }
-
-   prepareCSS(context, { data }) {
-      data.classNames = this.CSS.expand(
-         this.CSS.block(this.baseClass, data.mod, data.stateMods),
-         data.class,
-         data.className,
-      );
-      data.style = parseStyle(data.style);
-   }
-
-   prepareData(context, instance) {
-      if (this.styled) this.prepareCSS(context, instance);
-   }
-
-   initInstance(context, instance) {}
-
-   initState(context, instance) {}
-
-   checkVisible(context, instance, data) {
-      return data.visible;
-   }
-
-   explore(context, instance) {
-      if (this.components) instance.components = {};
-      for (let cmp in this.components) {
-         let ins = instance.getChild(context, this.components[cmp], "cmp-" + cmp, instance.store);
-         if (ins.scheduleExploreIfVisible(context)) instance.components[cmp] = ins;
-      }
-   }
-
-   render(context, instance, key) {
-      Console.log(this);
-      throw new Error(
-         'Widget\'s render method should be overridden. This error usually happens if with incorrect imports, i.e. import { TextField } from "cx/data". Please check the console for details about the component configuration.',
-      );
-   }
-
-   update() {
-      this.version = (this.version || 0) + 1;
-   }
-
-   applyParentStore(instance) {
-      instance.store = instance.parentStore;
-
-      // check when this is actually needed, perhaps this is needed only for tables and repeated elements
-      // if (instance.cached) delete instance.cached.rawData; // force prepareData to execute again
-   }
-
-   static resetCounter() {
-      widgetId = 100;
-   }
-}
-
-Widget.prototype.visible = true;
-Widget.prototype.memoize = true; //cache rendered content and use it if possible
-Widget.prototype.CSS = "cx";
-Widget.prototype.styled = false;
-
-Widget.namespace = "ui.";
-Widget.optimizePrepare = true;
-
-Widget.factory = (type, config, more) => {
-   throw new Error(`Invalid widget type: ${type}.`);
-};
-
-export function contentAppend(result, w, prependSpace) {
-   if (w == null || w === false) return false;
-   if (isArray(w)) w.forEach((c) => contentAppend(result, c));
-   else if (isDefined(w.content) && !w.atomic) return contentAppend(result, w.content);
-   else {
-      if (prependSpace) result.push(" ");
-      result.push(w);
-   }
-   return true;
-}
-
-export function getContentArray(x) {
-   let result = [];
-   contentAppend(result, x);
-   return result;
-}
-
-export function getContent(x) {
-   let result = getContentArray(x);
-   if (result.length == 0) return null;
-   if (result.length == 1) return result[0];
-   return result;
-}

package/src/ui/ZIndexManager.d.ts

@@ -1,7 +0,0 @@
-import * as Cx from '../core';
-
-export class ZIndexManager {
-    static next() : number;
-
-    static reset(zIndex: number);
-}

package/src/ui/ZIndexManager.js

@@ -1,11 +0,0 @@
-let lastZIndex = 10000;
-
-export class ZIndexManager {
-   static next() {
-      return ++lastZIndex;
-   }
-
-   static reset(zIndex) {
-      lastZIndex = zIndex;
-   }
-}

package/src/ui/adapter/ArrayAdapter.d.ts

@@ -1,17 +0,0 @@
-import { AccessorChain, Prop } from "../../core";
-import { Accessor } from "../../data/getAccessor";
-import { DataAdapter } from "./DataAdapter";
-
-interface ArrayAdapterConfig {
-   immutable?: boolean;
-   sealed?: boolean;
-   recordsBinding?: Prop<any[]>;
-   recordsAccessor?: Accessor;
-   recordName: string | AccessorChain<any>;
-   indexName: string | AccessorChain<any>;
-   keyField?: string;
-}
-
-export class ArrayAdapter extends DataAdapter {
-   constructor(config: ArrayAdapterConfig);
-}

package/src/ui/adapter/ArrayAdapter.js

@@ -1,152 +0,0 @@
-import { DataAdapter } from "./DataAdapter";
-import { ReadOnlyDataView } from "../../data/ReadOnlyDataView";
-import { sorter } from "../../data/comparer";
-import { isArray } from "../../util/isArray";
-import { ArrayElementView } from "../../data/ArrayElementView";
-import { getAccessor } from "../../data/getAccessor";
-import { Culture } from "../Culture";
-import { isDefined, isObject } from "../../util";
-
-export class ArrayAdapter extends DataAdapter {
-   init() {
-      this.recordsAccessor = getAccessor(this.recordsBinding ? this.recordsBinding : this.recordsAccessor);
-
-      //resolve accessor chains
-      this.recordName = this.recordName.toString();
-      this.indexName = this.indexName.toString();
-   }
-
-   initInstance(context, instance) {
-      if (!instance.recordStoreCache) {
-         instance.recordStoreCache = new WeakMap();
-         instance.cacheByKey = {};
-      }
-
-      if (!instance.recordsAccessor && this.recordsAccessor) {
-         instance.recordsAccessor = this.recordsAccessor.bindInstance
-            ? this.recordsAccessor.bindInstance(instance)
-            : this.recordsAccessor;
-      }
-   }
-
-   getRecords(context, instance, records, parentStore) {
-      if (!instance.recordStoreCache) this.initInstance(context, instance);
-
-      return this.mapRecords(context, instance, records, parentStore, instance.recordsAccessor);
-   }
-
-   mapRecords(context, instance, records, parentStore, recordsAccessor) {
-      let result = [];
-
-      if (!instance.recordStoreCache) this.initInstance(context, instance);
-
-      if (isArray(records))
-         records.forEach((data, index) => {
-            if (this.filterFn && !this.filterFn(data)) return;
-
-            let record = this.mapRecord(context, instance, data, parentStore, recordsAccessor, index);
-
-            result.push(record);
-         });
-
-      if (this.sorter) result = this.sorter(result);
-
-      return result;
-   }
-
-   mapRecord(context, instance, data, parentStore, recordsAccessor, index) {
-      let key = this.cacheByKeyField && this.keyField ? data[this.keyField] : null;
-      let recordStore = key != null ? instance.cacheByKey[key] : instance.recordStoreCache.get(data);
-
-      if (recordsAccessor) {
-         if (!recordStore)
-            recordStore = new ArrayElementView({
-               store: parentStore,
-               arrayAccessor: recordsAccessor,
-               itemIndex: index,
-               recordAlias: this.recordName,
-               indexAlias: this.indexName,
-               immutable: this.immutable,
-               sealed: this.sealed,
-            });
-         else {
-            recordStore.setStore(parentStore);
-            recordStore.setIndex(index);
-         }
-      } else {
-         if (!recordStore)
-            recordStore = new ReadOnlyDataView({
-               store: parentStore,
-               data: {
-                  [this.recordName]: data,
-                  [this.indexName]: index,
-               },
-               immutable: this.immutable,
-               sealed: this.sealed,
-            });
-         else {
-            recordStore.setStore(parentStore);
-            recordStore.setData(data);
-         }
-      }
-
-      // cache by the key or by data reference
-      if (key != null) instance.cacheByKey[key] = recordStore;
-      else if (isObject(data)) instance.recordStoreCache.set(data, recordStore);
-
-      return {
-         store: recordStore,
-         index: index,
-         data: data,
-         type: "data",
-         key: this.keyField ? data[this.keyField] : index,
-      };
-   }
-
-   setFilter(filterFn) {
-      this.filterFn = filterFn;
-   }
-
-   getComparer(sortOptions) {
-      return sortOptions ? Culture.getComparer(sortOptions) : null;
-   }
-
-   buildSorter(sorters) {
-      if (isArray(sorters) && sorters.length > 0) {
-         let fieldValueMapper;
-         let dataAccessor;
-
-         //if all sorters are based on record fields access data directly (faster)
-         if (sorters.every((x) => x.field && x.value == null)) {
-            dataAccessor = (x) => x.data;
-            fieldValueMapper = (x) => ({ bind: x.field });
-         } else {
-            dataAccessor = (x) => x.store.getData();
-            fieldValueMapper = (x) => ({ bind: this.recordName + "." + x.field });
-         }
-         this.sorter = sorter(
-            sorters.map((x) => {
-               let s = Object.assign({}, x);
-               if (s.field && s.value == null) s.value = fieldValueMapper(s);
-               if (!s.comparer)
-                  s.comparer = this.getComparer(isDefined(s.sortOptions) ? s.sortOptions : this.sortOptions);
-               return s;
-            }),
-            dataAccessor,
-         );
-      } else {
-         this.sorter = null;
-      }
-   }
-
-   sort(sorters) {
-      this.buildSorter(sorters);
-   }
-}
-
-ArrayAdapter.prototype.immutable = false;
-ArrayAdapter.prototype.sealed = false;
-ArrayAdapter.prototype.keyField = null;
-ArrayAdapter.prototype.cacheByKeyField = true;
-
-ArrayAdapter.autoInit = true;

package/src/ui/adapter/ArrayAdapter.spec.js

@@ -1,55 +0,0 @@
-import { RenderingContext } from "../RenderingContext";
-import { Instance } from "../Instance";
-import { TreeAdapter } from "./TreeAdapter";
-import assert from "assert";
-import { Store } from "../../data";
-import { ArrayAdapter } from "./ArrayAdapter";
-
-describe("ArrayAdapter", () => {
-   it("maps data into records", () => {
-      let adapter = new ArrayAdapter();
-      let data = [
-         {
-            id: 1,
-            text: "1",
-         },
-         {
-            id: 2,
-            text: "2",
-         },
-      ];
-
-      let store = new Store();
-
-      let records = adapter.mapRecords(new RenderingContext(), new Instance(null, 1, null, store), data, store, null);
-
-      assert.equal(records.length, 2);
-      assert.equal(records[0].data, records[0].store.get("$record"));
-      assert.equal(records[1].data, records[1].store.get("$record"));
-   });
-
-   it("can sort data", () => {
-      let adapter = new ArrayAdapter();
-
-      adapter.sort([{ field: "id", direction: "DESC" }]);
-
-      let data = [
-         {
-            id: 1,
-            text: "1",
-         },
-         {
-            id: 2,
-            text: "2",
-         },
-      ];
-
-      let store = new Store();
-
-      let records = adapter.mapRecords(new RenderingContext(), new Instance(null, 1, null, store), data, store, null);
-
-      assert.equal(records.length, 2);
-      assert.equal(data[1], records[0].store.get("$record"));
-      assert.equal(data[0], records[1].store.get("$record"));
-   });
-});

package/src/ui/adapter/DataAdapter.d.ts

@@ -1,31 +0,0 @@
-import * as Cx from "../../core";
-import { Instance } from "../Instance";
-import { View } from "../../data/View";
-import { RenderingContext } from "../RenderingContext";
-
-export interface DataAdapterRecord<T> {
-   data: T;
-   index: number;
-   key: string | number;
-   store: View;
-   type: "data" | "group-header" | "group-footer";
-}
-
-export class DataAdapter<T = unknown> {
-   getRecords(
-      context?: RenderingContext,
-      instance?: Instance,
-      records?: T[],
-      parentStore?: View,
-   ): DataAdapterRecord<T>[];
-
-   setFilter(filterFn: (data: any) => boolean): void;
-
-   sort(sorters?: Cx.Sorter[]): void;
-
-   /** Indicate that data in the parent store should not be mutated. */
-   immutable?: boolean;
-
-   /** Indicate that data in record stores should not be mutated. */
-   sealed?: boolean;
-}

package/src/ui/adapter/DataAdapter.js

@@ -1,15 +0,0 @@
-import { Component } from "../../util/Component";
-
-export class DataAdapter extends Component {
-   getRecords() {
-      throw new Error("Abstract method");
-   }
-
-   setFilter() {}
-
-   sort() {}
-}
-
-DataAdapter.prototype.recordName = "$record";
-DataAdapter.prototype.indexName = "$index";
-DataAdapter.prototype.immutable = false;

package/src/ui/adapter/GroupAdapter.d.ts

@@ -1,23 +0,0 @@
-import { ArrayAdapter } from './ArrayAdapter';
-import { AccessorChain, Prop, CollatorOptions, StructuredProp } from "../../core";
-import { Accessor } from "../../data/getAccessor";
-
-interface GroupAdapterConfig {
-    immutable?: boolean;
-    sealed?: boolean;
-    recordsBinding?: Prop<any[]>;
-    recordsAccessor?: Accessor;
-    recordName: string | AccessorChain<any>;
-    indexName: string | AccessorChain<any>;
-    keyField?: string;
-    aggregates?: StructuredProp;
-    groupRecordsAlias?: string;
-    groupRecordsName?: string;
-    groupings?: any[] | null;
-    groupName?: string;
-    sortOptions?: CollatorOptions;
-}
-
-export class GroupAdapter extends ArrayAdapter {
-    constructor(config: GroupAdapterConfig);
-}

package/src/ui/adapter/GroupAdapter.js

@@ -1,140 +0,0 @@
-import { ArrayAdapter } from "./ArrayAdapter";
-import { ReadOnlyDataView } from "../../data/ReadOnlyDataView";
-import { Grouper } from "../../data/Grouper";
-import { isArray } from "../../util/isArray";
-import { isDefined } from "../../util/isDefined";
-import { getComparer } from "../../data/comparer";
-import { Culture } from "../Culture";
-import { isObject } from "../../util/isObject";
-
-export class GroupAdapter extends ArrayAdapter {
-   init() {
-      super.init();
-
-      if (this.groupRecordsAlias) this.groupRecordsName = this.groupRecordsAlias;
-
-      if (this.groupings) this.groupBy(this.groupings);
-   }
-
-   getRecords(context, instance, records, parentStore) {
-      let result = super.getRecords(context, instance, records, parentStore);
-
-      if (this.groupings) {
-         let groupedResults = [];
-         this.processLevel([], result, groupedResults, parentStore);
-         result = groupedResults;
-      }
-
-      return result;
-   }
-
-   processLevel(keys, records, result, parentStore) {
-      let level = keys.length;
-      let inverseLevel = this.groupings.length - level;
-
-      if (inverseLevel == 0) {
-         for (let i = 0; i < records.length; i++) {
-            records[i].store.setStore(parentStore);
-            result.push(records[i]);
-         }
-         return;
-      }
-
-      let grouping = this.groupings[level];
-      let { grouper } = grouping;
-      grouper.reset();
-      grouper.processAll(records);
-      let results = grouper.getResults();
-      if (grouping.comparer) results.sort(grouping.comparer);
-
-      results.forEach((gr) => {
-         keys.push(gr.key);
-
-         let key = keys.map(serializeKey).join("|");
-
-         let $group = {
-            ...gr.key,
-            ...gr.aggregates,
-            $name: gr.name,
-            $level: inverseLevel,
-            $records: gr.records || [],
-            $key: key,
-         };
-
-         let data = {
-            [this.recordName]: gr.records.length > 0 ? gr.records[0].data : null,
-            [this.groupName]: $group,
-         };
-
-         let groupStore = new ReadOnlyDataView({
-            store: parentStore,
-            data,
-            immutable: this.immutable,
-         });
-
-         let group = {
-            key,
-            data,
-            group: $group,
-            grouping,
-            store: groupStore,
-            level: inverseLevel,
-         };
-
-         if (grouping.includeHeader !== false)
-            result.push({
-               ...group,
-               type: "group-header",
-               key: "header:" + group.key,
-            });
-
-         this.processLevel(keys, gr.records, result, groupStore);
-
-         if (grouping.includeFooter !== false)
-            result.push({
-               ...group,
-               type: "group-footer",
-               key: "footer:" + group.key,
-            });
-
-         keys.pop();
-      });
-   }
-
-   groupBy(groupings) {
-      if (!groupings) this.groupings = null;
-      else if (isArray(groupings)) {
-         this.groupings = groupings;
-         this.groupings.forEach((g) => {
-            let groupSorters = [];
-            let key = {};
-            for (let name in g.key) {
-               if (!g.key[name] || !isDefined(g.key[name].direction) || !isDefined(g.key[name].value))
-                  g.key[name] = { value: g.key[name], direction: "ASC" };
-               key[name] = g.key[name].value;
-               groupSorters.push({
-                  field: name,
-                  direction: g.key[name].direction,
-               });
-            }
-            g.grouper = new Grouper(key, { ...this.aggregates, ...g.aggregates }, (r) => r.store.getData(), g.text);
-            if (g.comparer == null && groupSorters.length > 0)
-               g.comparer = getComparer(
-                  groupSorters,
-                  (x) => x.key,
-                  this.sortOptions ? Culture.getComparer(this.sortOptions) : null,
-               );
-         });
-      } else throw new Error("Invalid grouping provided.");
-   }
-}
-
-GroupAdapter.prototype.groupName = "$group";
-
-function serializeKey(data) {
-   if (isObject(data))
-      return Object.keys(data)
-         .map((k) => serializeKey(data[k]))
-         .join(":");
-   return data?.toString() ?? "";
-}

package/src/ui/adapter/TreeAdapter.d.ts

@@ -1,24 +0,0 @@
-import { Prop, StringProp } from "../../core";
-import { ArrayAdapter } from "./ArrayAdapter";
-
-interface TreeAdapterConfig {
-   immutable?: boolean;
-   sealed?: boolean;
-   recordsBinding?: Prop<any[]>;
-   recordName?: StringProp;
-   indexName?: StringProp;
-   keyField?: string;
-   childrenField?: string;
-   expandedField?: string;
-   leafField?: string;
-   loadingField?: string;
-   loadedField?: string;
-   onLoadError?: (response: any) => void;
-   foldersFirst?: boolean;
-   hideRootNodes?: boolean;
-   restoreExpandedNodesOnLoad?: boolean;
-}
-
-export class TreeAdapter extends ArrayAdapter {
-   constructor(config: TreeAdapterConfig);
-}