cx 26.7.1 → 26.7.3

package/src/ui/Restate.tsx

@@ -1,226 +1,217 @@
-/** @jsxImportSource react */
-import { PureContainer, PureContainerBase, PureContainerConfig } from "./PureContainer";
-import { Store } from "../data/Store";
-import { View } from "../data/View";
-import { Cx } from "./Cx";
-import { VDOM } from "./VDOM";
-import { isObject } from "../util/isObject";
-import { isUndefined } from "../util/isUndefined";
-import { Binding } from "../data/Binding";
-import { StructuredSelector } from "../data/StructuredSelector";
-import { getCurrentCulture, CultureInfo } from "./Culture";
-import { BooleanProp, NumberProp, StringProp, StructuredProp } from "./Prop";
-import { Instance } from "./Instance";
-
-let persistenceCache: any = {};
-
-export interface RestateConfig extends PureContainerConfig {
-   /** Data object to be exposed in the local store. */
-   data?: StructuredProp;
-
-   /** Set to `true` to render the content in a separate, detached rendering context. */
-   detached?: boolean;
-
-   /** Set to `true` to defer updates until the browser is idle. */
-   deferredUntilIdle?: BooleanProp;
-
-   /** Timeout in milliseconds for idle updates. */
-   idleTimeout?: NumberProp;
-
-   /** Key used to cache and persist the local store data. */
-   cacheKey?: StringProp;
-
-   /** Set to `true` to disable batching of updates. */
-   immediate?: boolean;
-
-   /** Cap re-entrant synchronous updates on the detached `Cx` this Restate renders: once a burst of
-    *  back-to-back updates gets too deep, defer the excess to the coalesced branch instead of updating
-    *  synchronously. Avoids React's "Maximum update depth exceeded" on very large synchronous render bursts.
-    *  Only applies in `detached` mode (a non-detached Restate has no `Cx` of its own). Off by default. */
-   limitSyncBursts?: boolean;
-
-   /** Error handler callback. */
-   onError?: (error: Error, instance: Instance) => void;
-
-   /** Culture info to be used for formatting. */
-   culture?: CultureInfo;
-}
-
-// Legacy alias for backward compatibility
-export interface RestateProps extends RestateConfig {}
-
-export class Restate<Config extends RestateConfig = RestateConfig> extends PureContainerBase<Config> {
-   declare container: any;
-   declare privateDataSelector: any;
-   declare detached: boolean;
-   declare data?: any;
-   declare culture?: any;
-   declare options?: any;
-   declare onError?: (error: Error, instance: Instance) => void;
-   declare waitForIdle: boolean;
-   declare immediate: boolean;
-   declare limitSyncBursts: boolean;
-
-   declareData(...args: any[]) {
-      return super.declareData(...args, {
-         deferredUntilIdle: undefined,
-         idleTimeout: undefined,
-         cacheKey: undefined,
-      });
-   }
-
-   init() {
-      this.container = PureContainer.create({
-         items: this.children || this.items,
-         layout: this.layout,
-         controller: this.controller,
-         outerLayout: this.outerLayout,
-         useParentLayout: !this.detached,
-         ws: this.ws,
-      });
-      this.privateDataSelector = new StructuredSelector({
-         props: this.data || {},
-         values: this.data,
-      });
-      this.items = [];
-      delete this.children;
-      delete this.controller;
-      delete this.outerLayout;
-      delete this.layout;
-      if (this.useParentLayout == null) this.useParentLayout = !this.detached;
-      super.init();
-   }
-
-   initSubStore(context: any, instance: any) {
-      let { cacheKey } = instance.data;
-      this.privateDataSelector.init(instance.store);
-      instance.subStore = new RestateStore({
-         store: instance.store,
-         detached: this.detached,
-         privateData: this.data || {},
-         data: cacheKey ? persistenceCache[cacheKey] || {} : {},
-         dataSelector: this.privateDataSelector.create(),
-         onSet: (path: string, value: any) => instance.nestedDataSet(path, value, this.data),
-      });
-
-      if (cacheKey) {
-         instance.subscribeOnDestroy(() => {
-            persistenceCache[cacheKey] = instance.subStore.getData();
-         });
-      }
-   }
-
-   applyParentStore(instance: any) {
-      if (instance.subStore) instance.subStore.setStore(instance.parentStore);
-   }
-
-   explore(context: any, instance: any) {
-      if (!instance.subStore) this.initSubStore(context, instance);
-      if (instance.subStore.parentDataCheck()) instance.markShouldUpdate();
-      instance.cultureInfo = this.culture ?? getCurrentCulture();
-      if (instance.cache("cultureInfo", instance.culture)) instance.markShouldUpdate();
-      super.explore(context, instance);
-   }
-
-   exploreItems(context: any, instance: any, items: any) {
-      if (!this.detached) {
-         instance.container = instance.getChild(context, this.container, "container", instance.subStore);
-         instance.container.scheduleExploreIfVisible(context);
-         instance.children = [instance.container];
-      }
-   }
-
-   render(context: any, instance: any, key: string) {
-      if (!this.detached) return instance.container.render(context);
-
-      return (
-         <Cx
-            key={key}
-            widget={this.container}
-            parentInstance={instance}
-            store={instance.subStore}
-            subscribe
-            options={this.options}
-            onError={this.onError}
-            deferredUntilIdle={instance.data.deferredUntilIdle}
-            idleTimeout={instance.data.idleTimeout}
-            immediate={this.immediate}
-            limitSyncBursts={this.limitSyncBursts}
-            cultureInfo={instance.cultureInfo}
-         />
-      );
-   }
-}
-
-Restate.prototype.detached = false;
-Restate.prototype.waitForIdle = false;
-Restate.prototype.immediate = false;
-Restate.prototype.limitSyncBursts = false;
-Restate.prototype.culture = null;
-
-export const PrivateStore = Restate;
-
-class RestateStore extends Store {
-   declare parentDataVersion: number;
-   declare parentData: any;
-   declare dataSelector: any;
-   declare privateData: any;
-   declare onSet: any;
-   declare detached: any;
-   declare store: View; // Parent store reference
-
-   constructor(config: any) {
-      super(config);
-      this.parentDataVersion = -1;
-   }
-
-   getData() {
-      this.silently(() => {
-         this.parentDataCheck();
-      });
-      return super.getData();
-   }
-
-   parentDataCheck() {
-      if (this.parentDataVersion == this.store.meta.version) return false;
-      this.parentDataVersion = this.store.meta.version;
-      this.parentData = this.dataSelector(this.store.getData());
-      return this.batch(() => {
-         for (let key in this.parentData) {
-            super.setItem(key, this.parentData[key]);
-         }
-      });
-   }
-
-   setItem(path: string, value: any) {
-      let binding = Binding.get(path);
-      let bindingRoot = binding.parts[0];
-      if (!isObject(this.privateData) || !this.privateData.hasOwnProperty(bindingRoot)) {
-         let changed = isUndefined(value) ? super.deleteItem(path) : super.setItem(path, value);
-         return changed;
-      }
-
-      let newValue = value;
-      if (binding.parts.length > 1) newValue = binding.set(this.getData(), value)[bindingRoot];
-      this.onSet(bindingRoot, newValue);
-      this.batch(() => {
-         super.setItem(bindingRoot, newValue);
-         this.parentDataCheck();
-      });
-      return true;
-   }
-
-   deleteItem(path: string) {
-      return this.setItem(path, undefined);
-   }
-
-   doNotify() {
-      if (!this.detached) this.store.notify(undefined!);
-      super.doNotify(undefined!);
-   }
-
-   // override the default implementation to avoid meta overwrites
-   setStore(store: any) {
-      this.store = store;
-   }
-}
+/** @jsxImportSource react */
+import { PureContainer, PureContainerBase, PureContainerConfig } from "./PureContainer";
+import { Store } from "../data/Store";
+import { View } from "../data/View";
+import { Cx } from "./Cx";
+import { VDOM } from "./VDOM";
+import { isObject } from "../util/isObject";
+import { isUndefined } from "../util/isUndefined";
+import { Binding } from "../data/Binding";
+import { StructuredSelector } from "../data/StructuredSelector";
+import { getCurrentCulture, CultureInfo } from "./Culture";
+import { BooleanProp, NumberProp, StringProp, StructuredProp } from "./Prop";
+import { Instance } from "./Instance";
+
+let persistenceCache: any = {};
+
+export interface RestateConfig extends PureContainerConfig {
+   /** Data object to be exposed in the local store. */
+   data?: StructuredProp;
+
+   /** Set to `true` to render the content in a separate, detached rendering context. */
+   detached?: boolean;
+
+   /** Set to `true` to defer updates until the browser is idle. */
+   deferredUntilIdle?: BooleanProp;
+
+   /** Timeout in milliseconds for idle updates. */
+   idleTimeout?: NumberProp;
+
+   /** Key used to cache and persist the local store data. */
+   cacheKey?: StringProp;
+
+   /** Set to `true` to disable batching of updates. */
+   immediate?: boolean;
+
+   /** Error handler callback. */
+   onError?: (error: Error, instance: Instance) => void;
+
+   /** Culture info to be used for formatting. */
+   culture?: CultureInfo;
+}
+
+// Legacy alias for backward compatibility
+export interface RestateProps extends RestateConfig {}
+
+export class Restate<Config extends RestateConfig = RestateConfig> extends PureContainerBase<Config> {
+   declare container: any;
+   declare privateDataSelector: any;
+   declare detached: boolean;
+   declare data?: any;
+   declare culture?: any;
+   declare options?: any;
+   declare onError?: (error: Error, instance: Instance) => void;
+   declare waitForIdle: boolean;
+   declare immediate: boolean;
+
+   declareData(...args: any[]) {
+      return super.declareData(...args, {
+         deferredUntilIdle: undefined,
+         idleTimeout: undefined,
+         cacheKey: undefined,
+      });
+   }
+
+   init() {
+      this.container = PureContainer.create({
+         items: this.children || this.items,
+         layout: this.layout,
+         controller: this.controller,
+         outerLayout: this.outerLayout,
+         useParentLayout: !this.detached,
+         ws: this.ws,
+      });
+      this.privateDataSelector = new StructuredSelector({
+         props: this.data || {},
+         values: this.data,
+      });
+      this.items = [];
+      delete this.children;
+      delete this.controller;
+      delete this.outerLayout;
+      delete this.layout;
+      if (this.useParentLayout == null) this.useParentLayout = !this.detached;
+      super.init();
+   }
+
+   initSubStore(context: any, instance: any) {
+      let { cacheKey } = instance.data;
+      this.privateDataSelector.init(instance.store);
+      instance.subStore = new RestateStore({
+         store: instance.store,
+         detached: this.detached,
+         privateData: this.data || {},
+         data: cacheKey ? persistenceCache[cacheKey] || {} : {},
+         dataSelector: this.privateDataSelector.create(),
+         onSet: (path: string, value: any) => instance.nestedDataSet(path, value, this.data),
+      });
+
+      if (cacheKey) {
+         instance.subscribeOnDestroy(() => {
+            persistenceCache[cacheKey] = instance.subStore.getData();
+         });
+      }
+   }
+
+   applyParentStore(instance: any) {
+      if (instance.subStore) instance.subStore.setStore(instance.parentStore);
+   }
+
+   explore(context: any, instance: any) {
+      if (!instance.subStore) this.initSubStore(context, instance);
+      if (instance.subStore.parentDataCheck()) instance.markShouldUpdate();
+      instance.cultureInfo = this.culture ?? getCurrentCulture();
+      if (instance.cache("cultureInfo", instance.culture)) instance.markShouldUpdate();
+      super.explore(context, instance);
+   }
+
+   exploreItems(context: any, instance: any, items: any) {
+      if (!this.detached) {
+         instance.container = instance.getChild(context, this.container, "container", instance.subStore);
+         instance.container.scheduleExploreIfVisible(context);
+         instance.children = [instance.container];
+      }
+   }
+
+   render(context: any, instance: any, key: string) {
+      if (!this.detached) return instance.container.render(context);
+
+      return (
+         <Cx
+            key={key}
+            widget={this.container}
+            parentInstance={instance}
+            store={instance.subStore}
+            subscribe
+            options={this.options}
+            onError={this.onError}
+            deferredUntilIdle={instance.data.deferredUntilIdle}
+            idleTimeout={instance.data.idleTimeout}
+            immediate={this.immediate}
+            cultureInfo={instance.cultureInfo}
+         />
+      );
+   }
+}
+
+Restate.prototype.detached = false;
+Restate.prototype.waitForIdle = false;
+Restate.prototype.immediate = false;
+Restate.prototype.culture = null;
+
+export const PrivateStore = Restate;
+
+class RestateStore extends Store {
+   declare parentDataVersion: number;
+   declare parentData: any;
+   declare dataSelector: any;
+   declare privateData: any;
+   declare onSet: any;
+   declare detached: any;
+   declare store: View; // Parent store reference
+
+   constructor(config: any) {
+      super(config);
+      this.parentDataVersion = -1;
+   }
+
+   getData() {
+      this.silently(() => {
+         this.parentDataCheck();
+      });
+      return super.getData();
+   }
+
+   parentDataCheck() {
+      if (this.parentDataVersion == this.store.meta.version) return false;
+      this.parentDataVersion = this.store.meta.version;
+      this.parentData = this.dataSelector(this.store.getData());
+      return this.batch(() => {
+         for (let key in this.parentData) {
+            super.setItem(key, this.parentData[key]);
+         }
+      });
+   }
+
+   setItem(path: string, value: any) {
+      let binding = Binding.get(path);
+      let bindingRoot = binding.parts[0];
+      if (!isObject(this.privateData) || !this.privateData.hasOwnProperty(bindingRoot)) {
+         let changed = isUndefined(value) ? super.deleteItem(path) : super.setItem(path, value);
+         return changed;
+      }
+
+      let newValue = value;
+      if (binding.parts.length > 1) newValue = binding.set(this.getData(), value)[bindingRoot];
+      this.onSet(bindingRoot, newValue);
+      this.batch(() => {
+         super.setItem(bindingRoot, newValue);
+         this.parentDataCheck();
+      });
+      return true;
+   }
+
+   deleteItem(path: string) {
+      return this.setItem(path, undefined);
+   }
+
+   doNotify() {
+      if (!this.detached) this.store.notify(undefined!);
+      super.doNotify(undefined!);
+   }
+
+   // override the default implementation to avoid meta overwrites
+   setStore(store: any) {
+      this.store = store;
+   }
+}