cx 25.3.1 → 25.4.0

package/src/ui/Repeater.d.ts

@@ -1,61 +1,61 @@
-import {
-   RecordsProp,
-   RecordAlias,
-   StringProp,
-   SortersProp,
-   StructuredProp,
-   CollatorOptions,
-   Widget,
-   PureContainerProps,
-   Prop,
-   SortDirection,
-} from "../core";
-import { DataAdapterRecord } from "./adapter";
-import { Instance } from "./Instance";
-
-interface RepeaterProps<T = unknown> extends PureContainerProps {
-   records: Prop<T[]>;
-   recordName?: RecordAlias;
-   recordAlias?: RecordAlias;
-   indexName?: RecordAlias;
-   indexAlias?: RecordAlias;
-   cached?: boolean;
-
-   /** Indicate that parent store data should not be mutated. */
-   immutable?: boolean;
-
-   /** Indicate that record stores should not be mutated. */
-   sealed?: boolean;
-
-   sorters?: SortersProp;
-
-   /** A binding used to store the name of the field used for sorting the collection. Available only if `sorters` are not used. */
-   sortField?: StringProp;
-
-   /** A binding used to store the sort direction. Available only if `sorters` are not used. Possible values are `"ASC"` and `"DESC"`. Defaults to `"ASC"`. */
-   sortDirection?: Prop<SortDirection>;
-
-   /** Parameters that affect filtering */
-   filterParams?: StructuredProp;
-
-   /** Callback to create a filter function for given filter params. */
-   onCreateFilter?: (filterParams: any, instance: Instance) => (record: T) => boolean;
-
-   /**
-    * Callback function to track and retrieve displayed records.
-    * Accepts new records as a first argument.
-    * If onCreateFilter callback is defined, filtered records can be retrieved using this callback.
-    */
-   onTrackMappedRecords?: string | ((records: DataAdapterRecord<T>[], instance: Instance) => void);
-
-   /** Options for data sorting. See: https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Collator */
-   sortOptions?: CollatorOptions;
-
-   /** A field used to get the unique identifier of the record. Setting keyField improves performance on sort operations as the widget is able to movement of records inside the collection.  */
-   keyField?: StringProp;
-
-   /** Data adapter used to convert data in the list of records. Used for manipulation of records, e.g flattening the tree records. */
-   dataAdapter?: any;
-}
-
-export class Repeater<T = unknown> extends Widget<RepeaterProps<T>> {}
+import {
+   RecordsProp,
+   RecordAlias,
+   StringProp,
+   SortersProp,
+   StructuredProp,
+   CollatorOptions,
+   Widget,
+   PureContainerProps,
+   Prop,
+   SortDirection,
+} from "../core";
+import { DataAdapterRecord } from "./adapter";
+import { Instance } from "./Instance";
+
+interface RepeaterProps<T = unknown> extends PureContainerProps {
+   records: Prop<T[]>;
+   recordName?: RecordAlias;
+   recordAlias?: RecordAlias;
+   indexName?: RecordAlias;
+   indexAlias?: RecordAlias;
+   cached?: boolean;
+
+   /** Indicate that parent store data should not be mutated. */
+   immutable?: boolean;
+
+   /** Indicate that record stores should not be mutated. */
+   sealed?: boolean;
+
+   sorters?: SortersProp;
+
+   /** A binding used to store the name of the field used for sorting the collection. Available only if `sorters` are not used. */
+   sortField?: StringProp;
+
+   /** A binding used to store the sort direction. Available only if `sorters` are not used. Possible values are `"ASC"` and `"DESC"`. Defaults to `"ASC"`. */
+   sortDirection?: Prop<SortDirection>;
+
+   /** Parameters that affect filtering */
+   filterParams?: StructuredProp;
+
+   /** Callback to create a filter function for given filter params. */
+   onCreateFilter?: (filterParams: any, instance: Instance) => (record: T) => boolean;
+
+   /**
+    * Callback function to track and retrieve displayed records.
+    * Accepts new records as a first argument.
+    * If onCreateFilter callback is defined, filtered records can be retrieved using this callback.
+    */
+   onTrackMappedRecords?: string | ((records: DataAdapterRecord<T>[], instance: Instance) => void);
+
+   /** Options for data sorting. See: https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Collator */
+   sortOptions?: CollatorOptions;
+
+   /** A field used to get the unique identifier of the record. Setting keyField improves performance on sort operations as the widget is able to movement of records inside the collection.  */
+   keyField?: StringProp;
+
+   /** Data adapter used to convert data in the list of records. Used for manipulation of records, e.g flattening the tree records. */
+   dataAdapter?: any;
+}
+
+export class Repeater<T = unknown> extends Widget<RepeaterProps<T>> {}

package/src/ui/index.d.ts

@@ -1,42 +1,42 @@
-export * from "./Controller";
-export * from "./Widget";
-export * from "./Container";
-export * from "./PureContainer";
-export * from "./Repeater";
-export * from "./Rescope";
-export * from "./StaticText";
-export * from "./Text";
-export * from "./CSS";
-export * from "./CSSHelper";
-export * from "./FocusManager";
-export * from "./ResizeManager";
-export * from "./ZIndexManager";
-export * from "./Format";
-export * from "./Culture";
-export * from "./Localization";
-export * from "./Cx";
-export * from "./Instance";
-export * from "./RenderingContext";
-export * from "./ContentResolver";
-export * from "./batchUpdates";
-export * from "./IsolatedScope";
-export * from "./DetachedScope";
-export * from "./Restate";
-export * from "./DataProxy";
-export * from "./keyboardShortcuts";
-export * from "./createFunctionalComponent";
-export * from "./StructuredInstanceDataAccessor";
-export * from "./HoverSync";
-
-export * from "./selection/index";
-export * from "./layout/index";
-export * from "./app/index";
-export * from "./adapter/index";
-
-export * from "./bind";
-export * from "./tpl";
-export * from "./expr";
-
-//re-export computable here
-import { computable } from "../data/computable";
-export { computable };
+export * from "./Controller";
+export * from "./Widget";
+export * from "./Container";
+export * from "./PureContainer";
+export * from "./Repeater";
+export * from "./Rescope";
+export * from "./StaticText";
+export * from "./Text";
+export * from "./CSS";
+export * from "./CSSHelper";
+export * from "./FocusManager";
+export * from "./ResizeManager";
+export * from "./ZIndexManager";
+export * from "./Format";
+export * from "./Culture";
+export * from "./Localization";
+export * from "./Cx";
+export * from "./Instance";
+export * from "./RenderingContext";
+export * from "./ContentResolver";
+export * from "./batchUpdates";
+export * from "./IsolatedScope";
+export * from "./DetachedScope";
+export * from "./Restate";
+export * from "./DataProxy";
+export * from "./keyboardShortcuts";
+export * from "./createFunctionalComponent";
+export * from "./StructuredInstanceDataAccessor";
+export * from "./HoverSync";
+
+export * from "./selection/index";
+export * from "./layout/index";
+export * from "./app/index";
+export * from "./adapter/index";
+
+export * from "./bind";
+export * from "./tpl";
+export * from "./expr";
+
+//re-export computable here
+import { computable } from "../data/computable";
+export { computable };

package/src/ui/layout/ContentPlaceholder.d.ts

@@ -1,19 +1,19 @@
-import * as Cx from "../../core";
-import { RenderingContext } from "../RenderingContext";
-
-interface ContentPlaceholderProps extends Cx.PureContainerProps {
-   name?: Cx.StringProp;
-
-   scoped?: boolean;
-
-   /* Set to true to allow all registered content elements to render inside the placeholder. Otherwise only one element is rendered. */
-   allowMultiple?: boolean;
-}
-
-export class ContentPlaceholder extends Cx.Widget<ContentPlaceholderProps> {}
-
-interface ContentPlaceholderScopeProps extends Cx.PureContainerProps {
-   name?: string | string[];
-}
-
-export class ContentPlaceholderScope extends Cx.Widget<ContentPlaceholderScopeProps> {}
+import * as Cx from "../../core";
+import { RenderingContext } from "../RenderingContext";
+
+interface ContentPlaceholderProps extends Cx.PureContainerProps {
+   name?: Cx.StringProp;
+
+   scoped?: boolean;
+
+   /* Set to true to allow all registered content elements to render inside the placeholder. Otherwise only one element is rendered. */
+   allowMultiple?: boolean;
+}
+
+export class ContentPlaceholder extends Cx.Widget<ContentPlaceholderProps> {}
+
+interface ContentPlaceholderScopeProps extends Cx.PureContainerProps {
+   name?: string | string[];
+}
+
+export class ContentPlaceholderScope extends Cx.Widget<ContentPlaceholderScopeProps> {}

package/src/ui/layout/ContentPlaceholder.js

@@ -1,105 +1,105 @@
-import { Widget } from "../Widget";
-import { PureContainer } from "../PureContainer";
-import { isString } from "../../util/isString";
-import { isNonEmptyArray } from "../../util/isNonEmptyArray";
-
-export class ContentPlaceholder extends PureContainer {
-   declareData() {
-      super.declareData(...arguments, {
-         name: undefined,
-      });
-   }
-
-   explore(context, instance) {
-      instance.content = null;
-      let { data } = instance;
-
-      if (this.allowMultiple) {
-         const contentList = context.contentList && context.contentList[data.name];
-         if (isNonEmptyArray(contentList) && !this.scoped)
-            for (let i = 0; i < contentList.length; i++) this.setContent(context, instance, contentList[i]);
-
-         // in multi mode register a callback to allow for more entries to be added
-         context.pushNamedValue("contentPlaceholder", data.name, (content) => {
-            this.setContent(context, instance, content);
-         });
-      } else {
-         const content = context.content && context.content[data.name];
-         if (content && !this.scoped) this.setContent(context, instance, content);
-         else
-            context.pushNamedValue("contentPlaceholder", data.name, (content) => {
-               this.setContent(context, instance, content);
-            });
-      }
-
-      if (this.scoped)
-         instance.unregisterContentPlaceholder = () => {
-            context.popNamedValue("contentPlaceholder", data.name);
-         };
-
-      super.explore(context, instance);
-   }
-
-   prepare(context, instance) {
-      let { content } = instance;
-      if (this.allowMultiple) {
-         let contentId = "";
-         let shouldUpdate = false;
-         if (content) {
-            for (let i = 0; i < content.length; i++) {
-               let c = content[i];
-               contentId += c.id + "+";
-               shouldUpdate = shouldUpdate || c.shouldUpdate;
-            }
-         }
-         if (instance.cache("content", contentId) || shouldUpdate) instance.markShouldUpdate(context);
-      } else if (instance.cache("content", content) || (content && content.shouldUpdate))
-         instance.markShouldUpdate(context);
-   }
-
-   setContent(context, instance, content) {
-      if (this.allowMultiple) {
-         if (instance.content == null) instance.content = [];
-         instance.content.push(content);
-      } else instance.content = content;
-      content.contentPlaceholder = instance;
-   }
-
-   render(context, instance, key) {
-      const { content } = instance;
-      if (!content) return super.render(context, instance, key);
-      if (this.allowMultiple) return content.map((x) => x.contentVDOM);
-      return content.contentVDOM;
-   }
-}
-
-ContentPlaceholder.prototype.name = "body";
-ContentPlaceholder.prototype.scoped = false;
-ContentPlaceholder.prototype.allowMultiple = false;
-
-Widget.alias("content-placeholder", ContentPlaceholder);
-
-export class ContentPlaceholderScope extends PureContainer {
-   init() {
-      super.init();
-
-      if (isString(this.name)) this.name = [this.name];
-   }
-
-   explore(context, instance) {
-      this.name.forEach((name) => {
-         context.pushNamedValue("contentPlaceholder", name, null);
-         context.pushNamedValue("content", name, null);
-         context.pushNamedValue("contentList", name, []);
-      });
-      super.explore(context, instance);
-   }
-
-   exploreCleanup(context, instance) {
-      this.name.forEach((name) => {
-         context.popNamedValue("contentPlaceholder", name);
-         context.popNamedValue("content", name);
-         context.popNamedValue("contentList", name);
-      });
-   }
-}
+import { Widget } from "../Widget";
+import { PureContainer } from "../PureContainer";
+import { isString } from "../../util/isString";
+import { isNonEmptyArray } from "../../util/isNonEmptyArray";
+
+export class ContentPlaceholder extends PureContainer {
+   declareData() {
+      super.declareData(...arguments, {
+         name: undefined,
+      });
+   }
+
+   explore(context, instance) {
+      instance.content = null;
+      let { data } = instance;
+
+      if (this.allowMultiple) {
+         const contentList = context.contentList && context.contentList[data.name];
+         if (isNonEmptyArray(contentList) && !this.scoped)
+            for (let i = 0; i < contentList.length; i++) this.setContent(context, instance, contentList[i]);
+
+         // in multi mode register a callback to allow for more entries to be added
+         context.pushNamedValue("contentPlaceholder", data.name, (content) => {
+            this.setContent(context, instance, content);
+         });
+      } else {
+         const content = context.content && context.content[data.name];
+         if (content && !this.scoped) this.setContent(context, instance, content);
+         else
+            context.pushNamedValue("contentPlaceholder", data.name, (content) => {
+               this.setContent(context, instance, content);
+            });
+      }
+
+      if (this.scoped)
+         instance.unregisterContentPlaceholder = () => {
+            context.popNamedValue("contentPlaceholder", data.name);
+         };
+
+      super.explore(context, instance);
+   }
+
+   prepare(context, instance) {
+      let { content } = instance;
+      if (this.allowMultiple) {
+         let contentId = "";
+         let shouldUpdate = false;
+         if (content) {
+            for (let i = 0; i < content.length; i++) {
+               let c = content[i];
+               contentId += c.id + "+";
+               shouldUpdate = shouldUpdate || c.shouldUpdate;
+            }
+         }
+         if (instance.cache("content", contentId) || shouldUpdate) instance.markShouldUpdate(context);
+      } else if (instance.cache("content", content) || (content && content.shouldUpdate))
+         instance.markShouldUpdate(context);
+   }
+
+   setContent(context, instance, content) {
+      if (this.allowMultiple) {
+         if (instance.content == null) instance.content = [];
+         instance.content.push(content);
+      } else instance.content = content;
+      content.contentPlaceholder = instance;
+   }
+
+   render(context, instance, key) {
+      const { content } = instance;
+      if (!content) return super.render(context, instance, key);
+      if (this.allowMultiple) return content.map((x) => x.contentVDOM);
+      return content.contentVDOM;
+   }
+}
+
+ContentPlaceholder.prototype.name = "body";
+ContentPlaceholder.prototype.scoped = false;
+ContentPlaceholder.prototype.allowMultiple = false;
+
+Widget.alias("content-placeholder", ContentPlaceholder);
+
+export class ContentPlaceholderScope extends PureContainer {
+   init() {
+      super.init();
+
+      if (isString(this.name)) this.name = [this.name];
+   }
+
+   explore(context, instance) {
+      this.name.forEach((name) => {
+         context.pushNamedValue("contentPlaceholder", name, null);
+         context.pushNamedValue("content", name, null);
+         context.pushNamedValue("contentList", name, []);
+      });
+      super.explore(context, instance);
+   }
+
+   exploreCleanup(context, instance) {
+      this.name.forEach((name) => {
+         context.popNamedValue("contentPlaceholder", name);
+         context.popNamedValue("content", name);
+         context.popNamedValue("contentList", name);
+      });
+   }
+}