@darajs/core 0.4.8

package/dist/shared/interactivity/resolve-variable.js

@@ -0,0 +1,46 @@
+import { isDataVariable, isDerivedDataVariable, isDerivedVariable, isUrlVariable, } from '../../types';
+// eslint-disable-next-line import/no-cycle
+import { getOrRegisterDerivedVariable, getOrRegisterPlainVariable, getOrRegisterUrlVariable, resolveDataVariable, } from './internal';
+/**
+ * Resolve a variable to a value (for non-derived variables using provided resolver)
+ * or a ResolvedDerivedVariable (if it's a derived variable).
+ * Registers all encountered variables which aren't yet in registry.
+ *
+ * @param variable variable to resolve
+ * @param client websocket client from context
+ * @param taskContext global task context
+ * @param extras request extras to be merged into the options
+ * @param resolver function to run the value through (for non-derived variables)
+ */
+export function resolveVariable(variable, client, taskContext, extras, resolver = (val) => val) {
+    if (isDerivedVariable(variable) || isDerivedDataVariable(variable)) {
+        getOrRegisterDerivedVariable(variable, client, taskContext, extras);
+        // For derived variable, recursively resolve the dependencies
+        const values = variable.variables.map((v) => resolveVariable(v, client, taskContext, extras, resolver));
+        // Store indexes of values which are in deps
+        const deps = variable.deps.map((dep) => variable.variables.findIndex((v) => v.uid === dep.uid));
+        if (isDerivedDataVariable(variable)) {
+            return {
+                deps,
+                filters: variable.filters,
+                type: 'derived-data',
+                uid: variable.uid,
+                values,
+            };
+        }
+        return {
+            deps,
+            type: 'derived',
+            uid: variable.uid,
+            values,
+        };
+    }
+    if (isDataVariable(variable)) {
+        return resolveDataVariable(variable);
+    }
+    if (isUrlVariable(variable)) {
+        return resolver(getOrRegisterUrlVariable(variable));
+    }
+    return resolver(getOrRegisterPlainVariable(variable, client, taskContext, extras));
+}
+//# sourceMappingURL=resolve-variable.js.map

package/dist/shared/interactivity/resolve-variable.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolve-variable.js","sourceRoot":"","sources":["../../../js/shared/interactivity/resolve-variable.tsx"],"names":[],"mappings":"AAKA,OAAO,EAKH,cAAc,EACd,qBAAqB,EACrB,iBAAiB,EACjB,aAAa,GAChB,MAAM,SAAS,CAAC;AAEjB,2CAA2C;AAC3C,OAAO,EACH,4BAA4B,EAC5B,0BAA0B,EAC1B,wBAAwB,EACxB,mBAAmB,GACtB,MAAM,YAAY,CAAC;AAEpB;;;;;;;;;;GAUG;AACH,MAAM,UAAU,eAAe,CAC3B,QAAmC,EACnC,MAAgC,EAChC,WAA8B,EAC9B,MAAqB,EACrB,WAAmH,CAC/G,GAA8B,EAChC,EAAE,CAAC,GAAG;IAOR,IAAI,iBAAiB,CAAC,QAAQ,CAAC,IAAI,qBAAqB,CAAC,QAAQ,CAAC,EAAE,CAAC;QACjE,4BAA4B,CAAC,QAAQ,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,CAAC,CAAC;QAEpE,6DAA6D;QAC7D,MAAM,MAAM,GAAG,QAAQ,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,eAAe,CAAC,CAAC,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,EAAE,QAAQ,CAAC,CAAC,CAAC;QAExG,4CAA4C;QAC5C,MAAM,IAAI,GAAG,QAAQ,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,QAAQ,CAAC,SAAS,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,GAAG,KAAK,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC;QAEhG,IAAI,qBAAqB,CAAC,QAAQ,CAAC,EAAE,CAAC;YAClC,OAAO;gBACH,IAAI;gBACJ,OAAO,EAAE,QAAQ,CAAC,OAAO;gBACzB,IAAI,EAAE,cAAc;gBACpB,GAAG,EAAE,QAAQ,CAAC,GAAG;gBACjB,MAAM;aACsB,CAAC;QACrC,CAAC;QAED,OAAO;YACH,IAAI;YACJ,IAAI,EAAE,SAAS;YACf,GAAG,EAAE,QAAQ,CAAC,GAAG;YACjB,MAAM;SACkB,CAAC;IACjC,CAAC;IAED,IAAI,cAAc,CAAC,QAAQ,CAAC,EAAE,CAAC;QAC3B,OAAO,mBAAmB,CAAC,QAAQ,CAAC,CAAC;IACzC,CAAC;IAED,IAAI,aAAa,CAAC,QAAQ,CAAC,EAAE,CAAC;QAC1B,OAAO,QAAQ,CAAC,wBAAwB,CAAC,QAAQ,CAAC,CAAC,CAAC;IACxD,CAAC;IAED,OAAO,QAAQ,CAAC,0BAA0B,CAAC,QAAQ,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,CAAC,CAAC,CAAC;AACvF,CAAC"}

package/dist/shared/interactivity/store.d.ts

@@ -0,0 +1,76 @@
+import { RecoilState, RecoilValue } from 'recoil';
+import { RequestExtrasSerializable } from '../../api/http';
+import { AnyVariable } from '../../types';
+/**
+ * Selector family type which constructs a selector from a given set of extras.
+ */
+export type SelectorFamily = (P: RequestExtrasSerializable) => RecoilValue<any>;
+/**
+ * Atom family type which constructs an atom from a given set of extras.
+ */
+export type AtomFamily = (P: RequestExtrasSerializable) => RecoilState<any>;
+/**
+ * Key -> trigger atom
+ */
+export declare const dataRegistry: Map<string, RecoilState<TriggerIndexValue>>;
+/**
+ * Key -> atom
+ */
+export declare const atomRegistry: Map<string, RecoilState<any>>;
+/**
+ * Key -> atom family
+ */
+export declare const atomFamilyRegistry: Map<string, AtomFamily>;
+/**
+ * Atom family function => {extras => atom}
+ *
+ * Stores all instances of a given atom family, as a map of seriailzed extras to atom.
+ */
+export declare const atomFamilyMembersRegistry: Map<AtomFamily, Map<string, RecoilState<any>>>;
+/**
+ * Key -> selector
+ */
+export declare const selectorRegistry: Map<string, RecoilValue<any>>;
+/**
+ * Key -> selector family
+ */
+export declare const selectorFamilyRegistry: Map<string, SelectorFamily>;
+/**
+ * Selector family function => {extras => selector}
+ *
+ * Stores all instances of a given selector family, as a map of seriailzed extras to selector.
+ */
+export declare const selectorFamilyMembersRegistry: Map<SelectorFamily, Map<string, RecoilValue<any>>>;
+/**
+ * Key -> dependencies data for a selector
+ */
+export declare const depsRegistry: Map<string, {
+    args: any[];
+    cacheKey: string;
+    result: any;
+}>;
+export type TriggerIndexValue = {
+    force: boolean;
+    inc: number;
+};
+type RegistryKeyType = 'selector' | 'derived-selector' | 'trigger' | 'filters';
+/**
+ * Get a unique registry key of a given type for a given variable.
+ *
+ * @param variable variable to get the key for
+ * @param type type of the registry entry
+ */
+export declare function getRegistryKey<T>(variable: AnyVariable<T>, type: RegistryKeyType): string;
+/**
+ * Clear registries - to be used in tests only.
+ */
+export declare function clearRegistries_TEST(): void;
+/**
+ * Check whether a given variable is registered within the application
+ * (More strictly, under the current RecoilRoot)
+ *
+ * @param variable variable to check
+ */
+export declare function isRegistered<T>(variable: AnyVariable<T>): boolean;
+export {};
+//# sourceMappingURL=store.d.ts.map

package/dist/shared/interactivity/store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"store.d.ts","sourceRoot":"","sources":["../../../js/shared/interactivity/store.tsx"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,WAAW,EAAE,MAAM,QAAQ,CAAC;AAElD,OAAO,EAAE,yBAAyB,EAAE,MAAM,YAAY,CAAC;AAEvD,OAAO,EAAE,WAAW,EAAc,MAAM,SAAS,CAAC;AAElD;;GAEG;AACH,MAAM,MAAM,cAAc,GAAG,CAAC,CAAC,EAAE,yBAAyB,KAAK,WAAW,CAAC,GAAG,CAAC,CAAC;AAEhF;;GAEG;AACH,MAAM,MAAM,UAAU,GAAG,CAAC,CAAC,EAAE,yBAAyB,KAAK,WAAW,CAAC,GAAG,CAAC,CAAC;AAE5E;;GAEG;AACH,eAAO,MAAM,YAAY,6CAAoD,CAAC;AAC9E;;GAEG;AACH,eAAO,MAAM,YAAY,+BAAsC,CAAC;AAChE;;GAEG;AACH,eAAO,MAAM,kBAAkB,yBAAgC,CAAC;AAChE;;;;GAIG;AACH,eAAO,MAAM,yBAAyB,gDAAuD,CAAC;AAC9F;;GAEG;AACH,eAAO,MAAM,gBAAgB,+BAAsC,CAAC;AACpE;;GAEG;AACH,eAAO,MAAM,sBAAsB,6BAAoC,CAAC;AACxE;;;;GAIG;AACH,eAAO,MAAM,6BAA6B,oDAA2D,CAAC;AACtG;;GAEG;AACH,eAAO,MAAM,YAAY;UAGX,GAAG,EAAE;cACD,MAAM;YACR,GAAG;EAEhB,CAAC;AAEJ,MAAM,MAAM,iBAAiB,GAAG;IAC5B,KAAK,EAAE,OAAO,CAAC;IACf,GAAG,EAAE,MAAM,CAAC;CACf,CAAC;AAEF,KAAK,eAAe,GAAG,UAAU,GAAG,kBAAkB,GAAG,SAAS,GAAG,SAAS,CAAC;AAE/E;;;;;GAKG;AACH,wBAAgB,cAAc,CAAC,CAAC,EAAE,QAAQ,EAAE,WAAW,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,eAAe,GAAG,MAAM,CAEzF;AAED;;GAEG;AACH,wBAAgB,oBAAoB,IAAI,IAAI,CAa3C;AAED;;;;;GAKG;AACH,wBAAgB,YAAY,CAAC,CAAC,EAAE,QAAQ,EAAE,WAAW,CAAC,CAAC,CAAC,GAAG,OAAO,CA+BjE"}

package/dist/shared/interactivity/store.js

@@ -0,0 +1,99 @@
+import { getUniqueIdentifier } from '../../shared/utils/hashing';
+import { isVariable } from '../../types';
+/**
+ * Key -> trigger atom
+ */
+export const dataRegistry = new Map();
+/**
+ * Key -> atom
+ */
+export const atomRegistry = new Map();
+/**
+ * Key -> atom family
+ */
+export const atomFamilyRegistry = new Map();
+/**
+ * Atom family function => {extras => atom}
+ *
+ * Stores all instances of a given atom family, as a map of seriailzed extras to atom.
+ */
+export const atomFamilyMembersRegistry = new Map();
+/**
+ * Key -> selector
+ */
+export const selectorRegistry = new Map();
+/**
+ * Key -> selector family
+ */
+export const selectorFamilyRegistry = new Map();
+/**
+ * Selector family function => {extras => selector}
+ *
+ * Stores all instances of a given selector family, as a map of seriailzed extras to selector.
+ */
+export const selectorFamilyMembersRegistry = new Map();
+/**
+ * Key -> dependencies data for a selector
+ */
+export const depsRegistry = new Map();
+/**
+ * Get a unique registry key of a given type for a given variable.
+ *
+ * @param variable variable to get the key for
+ * @param type type of the registry entry
+ */
+export function getRegistryKey(variable, type) {
+    return `${getUniqueIdentifier(variable)}-${type}`;
+}
+/**
+ * Clear registries - to be used in tests only.
+ */
+export function clearRegistries_TEST() {
+    for (const registry of [
+        dataRegistry,
+        atomRegistry,
+        atomFamilyRegistry,
+        atomFamilyMembersRegistry,
+        selectorRegistry,
+        depsRegistry,
+        selectorFamilyRegistry,
+        selectorFamilyMembersRegistry,
+    ]) {
+        registry.clear();
+    }
+}
+/**
+ * Check whether a given variable is registered within the application
+ * (More strictly, under the current RecoilRoot)
+ *
+ * @param variable variable to check
+ */
+export function isRegistered(variable) {
+    var _a;
+    if (!isVariable(variable)) {
+        return false;
+    }
+    switch (variable.__typename) {
+        case 'Variable': {
+            if (atomRegistry.has(variable.uid)) {
+                return true;
+            }
+            const family = atomFamilyRegistry.get(variable.uid);
+            return ((_a = atomFamilyMembersRegistry.get(family)) === null || _a === void 0 ? void 0 : _a.size) > 0;
+        }
+        case 'UrlVariable':
+        case 'DataVariable':
+            return atomRegistry.has(variable.uid);
+        case 'DerivedVariable': {
+            const key = getRegistryKey(variable, 'selector');
+            return selectorFamilyRegistry.has(key);
+        }
+        case 'DerivedDataVariable': {
+            const key = getRegistryKey(variable, 'selector');
+            return selectorFamilyRegistry.has(key);
+        }
+        default:
+            return false;
+    }
+}
+//# sourceMappingURL=store.js.map

package/dist/shared/interactivity/store.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"store.js","sourceRoot":"","sources":["../../../js/shared/interactivity/store.tsx"],"names":[],"mappings":"AAGA,OAAO,EAAE,mBAAmB,EAAE,MAAM,wBAAwB,CAAC;AAC7D,OAAO,EAAe,UAAU,EAAE,MAAM,SAAS,CAAC;AAYlD;;GAEG;AACH,MAAM,CAAC,MAAM,YAAY,GAAG,IAAI,GAAG,EAA0C,CAAC;AAC9E;;GAEG;AACH,MAAM,CAAC,MAAM,YAAY,GAAG,IAAI,GAAG,EAA4B,CAAC;AAChE;;GAEG;AACH,MAAM,CAAC,MAAM,kBAAkB,GAAG,IAAI,GAAG,EAAsB,CAAC;AAChE;;;;GAIG;AACH,MAAM,CAAC,MAAM,yBAAyB,GAAG,IAAI,GAAG,EAA6C,CAAC;AAC9F;;GAEG;AACH,MAAM,CAAC,MAAM,gBAAgB,GAAG,IAAI,GAAG,EAA4B,CAAC;AACpE;;GAEG;AACH,MAAM,CAAC,MAAM,sBAAsB,GAAG,IAAI,GAAG,EAA0B,CAAC;AACxE;;;;GAIG;AACH,MAAM,CAAC,MAAM,6BAA6B,GAAG,IAAI,GAAG,EAAiD,CAAC;AACtG;;GAEG;AACH,MAAM,CAAC,MAAM,YAAY,GAAG,IAAI,GAAG,EAOhC,CAAC;AASJ;;;;;GAKG;AACH,MAAM,UAAU,cAAc,CAAI,QAAwB,EAAE,IAAqB;IAC7E,OAAO,GAAG,mBAAmB,CAAC,QAAQ,CAAC,IAAI,IAAI,EAAE,CAAC;AACtD,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,oBAAoB;IAChC,KAAK,MAAM,QAAQ,IAAI;QACnB,YAAY;QACZ,YAAY;QACZ,kBAAkB;QAClB,yBAAyB;QACzB,gBAAgB;QAChB,YAAY;QACZ,sBAAsB;QACtB,6BAA6B;KAChC,EAAE,CAAC;QACA,QAAQ,CAAC,KAAK,EAAE,CAAC;IACrB,CAAC;AACL,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,YAAY,CAAI,QAAwB;;IACpD,IAAI,CAAC,UAAU,CAAC,QAAQ,CAAC,EAAE,CAAC;QACxB,OAAO,KAAK,CAAC;IACjB,CAAC;IAED,QAAQ,QAAQ,CAAC,UAAU,EAAE,CAAC;QAC1B,KAAK,UAAU,CAAC,CAAC,CAAC;YACd,IAAI,YAAY,CAAC,GAAG,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC;gBACjC,OAAO,IAAI,CAAC;YAChB,CAAC;YACD,MAAM,MAAM,GAAG,kBAAkB,CAAC,GAAG,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC;YACpD,OAAO,CAAA,MAAA,yBAAyB,CAAC,GAAG,CAAC,MAAM,CAAC,0CAAE,IAAI,IAAG,CAAC,CAAC;QAC3D,CAAC;QAED,KAAK,aAAa,CAAC;QACnB,KAAK,cAAc;YACf,OAAO,YAAY,CAAC,GAAG,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC;QAE1C,KAAK,iBAAiB,CAAC,CAAC,CAAC;YACrB,MAAM,GAAG,GAAG,cAAc,CAAC,QAAQ,EAAE,UAAU,CAAC,CAAC;YACjD,OAAO,sBAAsB,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QAC3C,CAAC;QAED,KAAK,qBAAqB,CAAC,CAAC,CAAC;YACzB,MAAM,GAAG,GAAG,cAAc,CAAC,QAAQ,EAAE,UAAU,CAAC,CAAC;YACjD,OAAO,sBAAsB,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QAC3C,CAAC;QAED;YACI,OAAO,KAAK,CAAC;IACrB,CAAC;AACL,CAAC"}

package/dist/shared/interactivity/triggers.d.ts

@@ -0,0 +1,31 @@
+import { RecoilState } from 'recoil';
+import { WebSocketClientInterface } from '../../api';
+import { AnyVariable, DataVariable, DerivedDataVariable, DerivedVariable } from '../../types';
+import { TriggerIndexValue } from './store';
+/**
+ * Get a trigger index for a variable from the atom registry, registering it if not already registered
+ *
+ * @param variable variable to register trigger for
+ */
+export declare function getOrRegisterTrigger(variable: DerivedVariable | DerivedDataVariable): RecoilState<TriggerIndexValue>;
+/**
+ * Get the data variable server trigger atom if it exists, otherwise create it
+ */
+export declare function getOrRegisterDataVariableTrigger(variable: DataVariable, wsClient: WebSocketClientInterface): RecoilState<TriggerIndexValue>;
+/**
+ * Recursively register triggers as dependencies by calling the registerFunc on all nested derived variables
+ *
+ * @param variable variable to register triggers for
+ * @param wsClient websocket client
+ * @param registerFunc register function to run
+ */
+export declare function registerTriggers(variable: DerivedVariable | DerivedDataVariable, wsClient: WebSocketClientInterface, registerFunc?: (state: RecoilState<any>) => TriggerIndexValue): Array<TriggerIndexValue>;
+/**
+ * Recursively register triggers in the list of dependant variables
+ *
+ * @param variable variable to register triggers for
+ * @param wsClient websocket client
+ * @param registerFunc register function to run
+ */
+export declare function registerChildTriggers(variables: AnyVariable<any>[], wsClient: WebSocketClientInterface, registerFunc?: (state: RecoilState<any>) => TriggerIndexValue): Array<TriggerIndexValue>;
+//# sourceMappingURL=triggers.d.ts.map

package/dist/shared/interactivity/triggers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"triggers.d.ts","sourceRoot":"","sources":["../../../js/shared/interactivity/triggers.tsx"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAwB,MAAM,QAAQ,CAAC;AAE3D,OAAO,EAAE,wBAAwB,EAAE,MAAM,OAAO,CAAC;AACjD,OAAO,EACH,WAAW,EACX,YAAY,EACZ,mBAAmB,EACnB,eAAe,EAIlB,MAAM,SAAS,CAAC;AAEjB,OAAO,EAAE,iBAAiB,EAA8C,MAAM,SAAS,CAAC;AAExF;;;;GAIG;AACH,wBAAgB,oBAAoB,CAAC,QAAQ,EAAE,eAAe,GAAG,mBAAmB,GAAG,WAAW,CAAC,iBAAiB,CAAC,CAiBpH;AAED;;GAEG;AACH,wBAAgB,gCAAgC,CAC5C,QAAQ,EAAE,YAAY,EACtB,QAAQ,EAAE,wBAAwB,GACnC,WAAW,CAAC,iBAAiB,CAAC,CAwChC;AAED;;;;;;GAMG;AACH,wBAAgB,gBAAgB,CAC5B,QAAQ,EAAE,eAAe,GAAG,mBAAmB,EAC/C,QAAQ,EAAE,wBAAwB,EAClC,YAAY,GAAE,CAAC,KAAK,EAAE,WAAW,CAAC,GAAG,CAAC,KAAK,iBAAkC,GAC9E,KAAK,CAAC,iBAAiB,CAAC,CAmB1B;AAED;;;;;;GAMG;AACH,wBAAgB,qBAAqB,CACjC,SAAS,EAAE,WAAW,CAAC,GAAG,CAAC,EAAE,EAC7B,QAAQ,EAAE,wBAAwB,EAClC,YAAY,GAAE,CAAC,KAAK,EAAE,WAAW,CAAC,GAAG,CAAC,KAAK,iBAAkC,GAC9E,KAAK,CAAC,iBAAiB,CAAC,CAc1B"}

package/dist/shared/interactivity/triggers.js

@@ -0,0 +1,105 @@
+import { atom, useRecoilValue } from 'recoil';
+import { isDataVariable, isDerivedDataVariable, isDerivedVariable, } from '../../types';
+import { atomRegistry, dataRegistry, getRegistryKey } from './store';
+/**
+ * Get a trigger index for a variable from the atom registry, registering it if not already registered
+ *
+ * @param variable variable to register trigger for
+ */
+export function getOrRegisterTrigger(variable) {
+    const triggerKey = getRegistryKey(variable, 'trigger');
+    if (!atomRegistry.has(triggerKey)) {
+        atomRegistry.set(triggerKey, atom({
+            default: {
+                force: false,
+                inc: 0,
+            },
+            key: triggerKey,
+        }));
+    }
+    return atomRegistry.get(triggerKey);
+}
+/**
+ * Get the data variable server trigger atom if it exists, otherwise create it
+ */
+export function getOrRegisterDataVariableTrigger(variable, wsClient) {
+    // get or create an observable for the data variable
+    const key = `${variable.uid}-data`;
+    if (!dataRegistry.has(key)) {
+        dataRegistry.set(key, atom({
+            default: {
+                force: true,
+                inc: 0,
+            },
+            effects: [
+                // synchronize with server triggers - increment when the variable is triggered on the server side
+                ({ setSelf }) => {
+                    const subscription = wsClient.serverTriggers$(variable.uid).subscribe(() => {
+                        setSelf((v) => {
+                            if (typeof v === 'object' && 'inc' in v) {
+                                return {
+                                    force: true,
+                                    inc: v.inc + 1,
+                                };
+                            }
+                            return {
+                                force: true,
+                                inc: 1,
+                            };
+                        });
+                    });
+                    return () => {
+                        subscription === null || subscription === void 0 ? void 0 : subscription.unsubscribe();
+                    };
+                },
+            ],
+            key,
+        }));
+    }
+    return dataRegistry.get(key);
+}
+/**
+ * Recursively register triggers as dependencies by calling the registerFunc on all nested derived variables
+ *
+ * @param variable variable to register triggers for
+ * @param wsClient websocket client
+ * @param registerFunc register function to run
+ */
+export function registerTriggers(variable, wsClient, registerFunc = useRecoilValue) {
+    const triggers = [];
+    // Register the variable itself
+    const triggerIndex = getOrRegisterTrigger(variable);
+    triggers.push(registerFunc(triggerIndex));
+    // Register nested derived and data variables triggers recursively
+    variable.variables.forEach((v) => {
+        if (isDerivedVariable(v) || isDerivedDataVariable(v)) {
+            triggers.push(...registerTriggers(v, wsClient, registerFunc));
+        }
+        if (isDataVariable(v)) {
+            const serverTrigger = getOrRegisterDataVariableTrigger(v, wsClient);
+            triggers.push(registerFunc(serverTrigger));
+        }
+    });
+    return triggers;
+}
+/**
+ * Recursively register triggers in the list of dependant variables
+ *
+ * @param variable variable to register triggers for
+ * @param wsClient websocket client
+ * @param registerFunc register function to run
+ */
+export function registerChildTriggers(variables, wsClient, registerFunc = useRecoilValue) {
+    const triggers = [];
+    variables.forEach((v) => {
+        if (isDerivedVariable(v) || isDerivedDataVariable(v)) {
+            triggers.push(...registerTriggers(v, wsClient, registerFunc));
+        }
+        if (isDataVariable(v)) {
+            const serverTrigger = getOrRegisterDataVariableTrigger(v, wsClient);
+            triggers.push(registerFunc(serverTrigger));
+        }
+    });
+    return triggers;
+}
+//# sourceMappingURL=triggers.js.map

package/dist/shared/interactivity/triggers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"triggers.js","sourceRoot":"","sources":["../../../js/shared/interactivity/triggers.tsx"],"names":[],"mappings":"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"}

package/dist/shared/interactivity/url-variable.d.ts

@@ -0,0 +1,12 @@
+import { RecoilState } from 'recoil';
+import { UrlVariable } from '../../types';
+/**
+ * Get a URL variable from the atom registry, registering it if not already registered
+ * TODO: once persist_value is unified with url sync, this can be moved into the same function as getOrRegisterPlainVariable
+ *
+ * @param variable variable to register
+ * @param searchString URL search string
+ */
+export declare function getOrRegisterUrlVariable<T>(variable: UrlVariable<T>): RecoilState<T>;
+export declare function useUrlVariable<T>(variable: UrlVariable<T>): [T, (value: T) => void];
+//# sourceMappingURL=url-variable.d.ts.map

package/dist/shared/interactivity/url-variable.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"url-variable.d.ts","sourceRoot":"","sources":["../../../js/shared/interactivity/url-variable.tsx"],"names":[],"mappings":"AACA,OAAO,EAAE,WAAW,EAAwB,MAAM,QAAQ,CAAC;AAG3D,OAAO,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC;AAItC;;;;;;GAMG;AACH,wBAAgB,wBAAwB,CAAC,CAAC,EAAE,QAAQ,EAAE,WAAW,CAAC,CAAC,CAAC,GAAG,WAAW,CAAC,CAAC,CAAC,CAcpF;AAED,wBAAgB,cAAc,CAAC,CAAC,EAAE,QAAQ,EAAE,WAAW,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC,KAAK,EAAE,CAAC,KAAK,IAAI,CAAC,CAEnF"}

package/dist/shared/interactivity/url-variable.js

@@ -0,0 +1,27 @@
+import { mixed } from '@recoiljs/refine';
+import { atom, useRecoilState } from 'recoil';
+import { urlSyncEffect } from 'recoil-sync';
+import { atomRegistry } from './store';
+/**
+ * Get a URL variable from the atom registry, registering it if not already registered
+ * TODO: once persist_value is unified with url sync, this can be moved into the same function as getOrRegisterPlainVariable
+ *
+ * @param variable variable to register
+ * @param searchString URL search string
+ */
+export function getOrRegisterUrlVariable(variable) {
+    if (!atomRegistry.has(variable.uid)) {
+        atomRegistry.set(variable.uid, atom({
+            default: variable.default,
+            effects: [
+                urlSyncEffect({ history: 'push', itemKey: variable.query, refine: mixed(), syncDefault: true }),
+            ],
+            key: variable.uid,
+        }));
+    }
+    return atomRegistry.get(variable.uid);
+}
+export function useUrlVariable(variable) {
+    return useRecoilState(getOrRegisterUrlVariable(variable));
+}
+//# sourceMappingURL=url-variable.js.map

package/dist/shared/interactivity/url-variable.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"url-variable.js","sourceRoot":"","sources":["../../../js/shared/interactivity/url-variable.tsx"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,kBAAkB,CAAC;AACzC,OAAO,EAAe,IAAI,EAAE,cAAc,EAAE,MAAM,QAAQ,CAAC;AAC3D,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAI5C,OAAO,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AAEvC;;;;;;GAMG;AACH,MAAM,UAAU,wBAAwB,CAAI,QAAwB;IAChE,IAAI,CAAC,YAAY,CAAC,GAAG,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC;QAClC,YAAY,CAAC,GAAG,CACZ,QAAQ,CAAC,GAAG,EACZ,IAAI,CAAC;YACD,OAAO,EAAE,QAAQ,CAAC,OAAO;YACzB,OAAO,EAAE;gBACL,aAAa,CAAC,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,QAAQ,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,EAAE,WAAW,EAAE,IAAI,EAAE,CAAC;aAClG;YACD,GAAG,EAAE,QAAQ,CAAC,GAAG;SACpB,CAAC,CACL,CAAC;IACN,CAAC;IACD,OAAO,YAAY,CAAC,GAAG,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC;AAC1C,CAAC;AAED,MAAM,UAAU,cAAc,CAAI,QAAwB;IACtD,OAAO,cAAc,CAAI,wBAAwB,CAAC,QAAQ,CAAC,CAAC,CAAC;AACjE,CAAC"}

package/dist/shared/interactivity/use-any-variable.d.ts

@@ -0,0 +1,8 @@
+import { AnyDataVariable, AnyVariable, DataFrame } from '../../types';
+/**
+ * A helper hook to retrieve value of any variable.
+ * For the rare occassions where a component can accept both a DataVariable and a non-DataVariable.
+ */
+export declare function useAnyVariable(variable: AnyDataVariable): DataFrame;
+export declare function useAnyVariable<T = any>(variable: AnyVariable<T>): T;
+//# sourceMappingURL=use-any-variable.d.ts.map

package/dist/shared/interactivity/use-any-variable.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-any-variable.d.ts","sourceRoot":"","sources":["../../../js/shared/interactivity/use-any-variable.tsx"],"names":[],"mappings":"AAMA,OAAO,EAAE,eAAe,EAAE,WAAW,EAAE,SAAS,EAAyC,MAAM,SAAS,CAAC;AAKzG;;;GAGG;AACH,wBAAgB,cAAc,CAAC,QAAQ,EAAE,eAAe,GAAG,SAAS,CAAC;AACrE,wBAAgB,cAAc,CAAC,CAAC,GAAG,GAAG,EAAE,QAAQ,EAAE,WAAW,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC"}

package/dist/shared/interactivity/use-any-variable.js

@@ -0,0 +1,39 @@
+/* eslint-disable react-hooks/rules-of-hooks */
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+/* eslint-disable react-hooks/exhaustive-deps */
+import { useQuery } from '@tanstack/react-query';
+import { useEffect } from 'react';
+import { isDataVariable, isDerivedDataVariable } from '../../types';
+import { useDataVariable } from './use-data-variable';
+import { useVariable } from './use-variable';
+export function useAnyVariable(variable) {
+    if (isDataVariable(variable) || isDerivedDataVariable(variable)) {
+        const getData = useDataVariable(variable);
+        const { data, refetch } = useQuery({
+            // ideally would be 0 but that causes infinite loops, see https://github.com/TanStack/query/issues/2367
+            cacheTime: 1,
+            queryFn: () => __awaiter(this, void 0, void 0, function* () {
+                const dataResponse = yield getData();
+                return dataResponse.data;
+            }),
+            queryKey: ['any-variable-data', variable.uid],
+            refetchOnWindowFocus: false,
+            suspense: true,
+        });
+        useEffect(() => {
+            // Refetch when getData changes
+            refetch();
+        }, [getData]);
+        return data;
+    }
+    return useVariable(variable)[0];
+}
+//# sourceMappingURL=use-any-variable.js.map

package/dist/shared/interactivity/use-any-variable.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-any-variable.js","sourceRoot":"","sources":["../../../js/shared/interactivity/use-any-variable.tsx"],"names":[],"mappings":"AAAA,+CAA+C;;;;;;;;;;AAE/C,gDAAgD;AAChD,OAAO,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AACjD,OAAO,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAElC,OAAO,EAA2C,cAAc,EAAE,qBAAqB,EAAE,MAAM,SAAS,CAAC;AAEzG,OAAO,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AACtD,OAAO,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAQ7C,MAAM,UAAU,cAAc,CAAU,QAAwB;IAC5D,IAAI,cAAc,CAAC,QAAQ,CAAC,IAAI,qBAAqB,CAAC,QAAQ,CAAC,EAAE,CAAC;QAC9D,MAAM,OAAO,GAAG,eAAe,CAAC,QAAQ,CAAC,CAAC;QAE1C,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,GAAG,QAAQ,CAAC;YAC/B,uGAAuG;YACvG,SAAS,EAAE,CAAC;YACZ,OAAO,EAAE,GAAS,EAAE;gBAChB,MAAM,YAAY,GAAG,MAAM,OAAO,EAAE,CAAC;gBACrC,OAAO,YAAY,CAAC,IAAI,CAAC;YAC7B,CAAC,CAAA;YACD,QAAQ,EAAE,CAAC,mBAAmB,EAAE,QAAQ,CAAC,GAAG,CAAC;YAC7C,oBAAoB,EAAE,KAAK;YAC3B,QAAQ,EAAE,IAAI;SACjB,CAAC,CAAC;QAEH,SAAS,CAAC,GAAG,EAAE;YACX,+BAA+B;YAC/B,OAAO,EAAE,CAAC;QACd,CAAC,EAAE,CAAC,OAAO,CAAC,CAAC,CAAC;QAEd,OAAO,IAAI,CAAC;IAChB,CAAC;IAED,OAAO,WAAW,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC;AACpC,CAAC"}

package/dist/shared/interactivity/use-data-variable.d.ts

@@ -0,0 +1,18 @@
+import { AnyDataVariable, FilterQuery, Pagination } from '../../types';
+import { DataResponse } from './internal';
+/**
+ * Helper hook which turns a (Derived)DataVariable into a callback to return DataFrame.
+ * Can be used in components that only work with data variables.
+ *
+ * Optionally pass in filters, pagination, and other options to fetch data.
+ * Other options include:
+ * -     schema: boolean - whether to include schema in the response. Default = false.
+ *
+ * The callback identity changes whenever a refetch should be triggered.
+ *
+ * @param variable data variable
+ */
+export declare function useDataVariable(variable: AnyDataVariable): (filters?: FilterQuery, pagination?: Pagination, options?: {
+    schema: boolean;
+}) => Promise<DataResponse>;
+//# sourceMappingURL=use-data-variable.d.ts.map

package/dist/shared/interactivity/use-data-variable.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-data-variable.d.ts","sourceRoot":"","sources":["../../../js/shared/interactivity/use-data-variable.tsx"],"names":[],"mappings":"AAQA,OAAO,EAAE,eAAe,EAAE,WAAW,EAAE,UAAU,EAAkB,MAAM,SAAS,CAAC;AAEnF,OAAO,EACH,YAAY,EAMf,MAAM,YAAY,CAAC;AAEpB;;;;;;;;;;;GAWG;AACH,wBAAgB,eAAe,CAC3B,QAAQ,EAAE,eAAe,GAC1B,CAAC,OAAO,CAAC,EAAE,WAAW,EAAE,UAAU,CAAC,EAAE,UAAU,EAAE,OAAO,CAAC,EAAE;IAAE,MAAM,EAAE,OAAO,CAAA;CAAE,KAAK,OAAO,CAAC,YAAY,CAAC,CA8C1G"}

package/dist/shared/interactivity/use-data-variable.js

@@ -0,0 +1,58 @@
+/* eslint-disable react-hooks/rules-of-hooks */
+/* eslint-disable react-hooks/exhaustive-deps */
+import { useContext, useEffect, useMemo, useState } from 'react';
+import { useRecoilValueLoadable } from 'recoil';
+// eslint-disable-next-line import/no-cycle
+import { VariableCtx, WebSocketCtx, useRequestExtras, useTaskContext } from '../../shared/context';
+import { isDataVariable } from '../../types';
+import { registerDataVariable, useDerivedVariable, useFetchDataVariable, useFetchDerivedDataVariable, } from './internal';
+/**
+ * Helper hook which turns a (Derived)DataVariable into a callback to return DataFrame.
+ * Can be used in components that only work with data variables.
+ *
+ * Optionally pass in filters, pagination, and other options to fetch data.
+ * Other options include:
+ * -     schema: boolean - whether to include schema in the response. Default = false.
+ *
+ * The callback identity changes whenever a refetch should be triggered.
+ *
+ * @param variable data variable
+ */
+export function useDataVariable(variable) {
+    const extras = useRequestExtras();
+    const { client: wsClient } = useContext(WebSocketCtx);
+    if (isDataVariable(variable)) {
+        registerDataVariable(variable);
+        const serverTriggers$ = useMemo(() => wsClient.serverTriggers$(variable.uid), []);
+        const [serverTriggerCounter, setServerTriggerCounter] = useState(0);
+        useEffect(() => {
+            const sub = serverTriggers$.subscribe(() => setServerTriggerCounter((c) => c + 1));
+            return () => sub.unsubscribe();
+        }, [serverTriggers$]);
+        const fetchDataVariable = useFetchDataVariable(variable, serverTriggerCounter);
+        return fetchDataVariable;
+    }
+    // Synchronously register subscription to the underlying DV, clean up on unmount
+    const variablesContext = useContext(VariableCtx);
+    variablesContext.variables.current.add(variable.uid);
+    useEffect(() => {
+        return () => {
+            variablesContext.variables.current.delete(variable.uid);
+        };
+    }, []);
+    const taskContext = useTaskContext();
+    const dvSelector = useDerivedVariable(variable, wsClient, taskContext, extras);
+    const dvLoadable = useRecoilValueLoadable(dvSelector);
+    // We can't directly use the loadable as the callback's dependency because the loadable identity
+    // changes whenever it also changes state; we only want to update it when there is a new value
+    const [dvValue, setDvValue] = useState(dvLoadable.toPromise());
+    useEffect(() => {
+        // Whenever loadable becomes loading update the promise stored
+        if (dvLoadable.state === 'loading') {
+            setDvValue(dvLoadable.toPromise());
+        }
+    }, [dvLoadable]);
+    const fetchDerivedDataVariable = useFetchDerivedDataVariable(variable, taskContext, wsClient, dvValue);
+    return fetchDerivedDataVariable;
+}
+//# sourceMappingURL=use-data-variable.js.map

package/dist/shared/interactivity/use-data-variable.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-data-variable.js","sourceRoot":"","sources":["../../../js/shared/interactivity/use-data-variable.tsx"],"names":[],"mappings":"AAAA,+CAA+C;AAE/C,gDAAgD;AAChD,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,OAAO,CAAC;AACjE,OAAO,EAAE,sBAAsB,EAAE,MAAM,QAAQ,CAAC;AAEhD,2CAA2C;AAC3C,OAAO,EAAE,WAAW,EAAE,YAAY,EAAE,gBAAgB,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAC/F,OAAO,EAA4C,cAAc,EAAE,MAAM,SAAS,CAAC;AAEnF,OAAO,EAGH,oBAAoB,EACpB,kBAAkB,EAClB,oBAAoB,EACpB,2BAA2B,GAC9B,MAAM,YAAY,CAAC;AAEpB;;;;;;;;;;;GAWG;AACH,MAAM,UAAU,eAAe,CAC3B,QAAyB;IAEzB,MAAM,MAAM,GAAG,gBAAgB,EAAE,CAAC;IAClC,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,GAAG,UAAU,CAAC,YAAY,CAAC,CAAC;IAEtD,IAAI,cAAc,CAAC,QAAQ,CAAC,EAAE,CAAC;QAC3B,oBAAoB,CAAC,QAAQ,CAAC,CAAC;QAC/B,MAAM,eAAe,GAAG,OAAO,CAAC,GAAG,EAAE,CAAC,QAAQ,CAAC,eAAe,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,EAAE,CAAC,CAAC;QAClF,MAAM,CAAC,oBAAoB,EAAE,uBAAuB,CAAC,GAAG,QAAQ,CAAC,CAAC,CAAC,CAAC;QACpE,SAAS,CAAC,GAAG,EAAE;YACX,MAAM,GAAG,GAAG,eAAe,CAAC,SAAS,CAAC,GAAG,EAAE,CAAC,uBAAuB,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;YAEnF,OAAO,GAAG,EAAE,CAAC,GAAG,CAAC,WAAW,EAAE,CAAC;QACnC,CAAC,EAAE,CAAC,eAAe,CAAC,CAAC,CAAC;QAEtB,MAAM,iBAAiB,GAAG,oBAAoB,CAAC,QAAQ,EAAE,oBAAoB,CAAC,CAAC;QAE/E,OAAO,iBAAiB,CAAC;IAC7B,CAAC;IAED,gFAAgF;IAChF,MAAM,gBAAgB,GAAG,UAAU,CAAC,WAAW,CAAC,CAAC;IACjD,gBAAgB,CAAC,SAAS,CAAC,OAAO,CAAC,GAAG,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC;IACrD,SAAS,CAAC,GAAG,EAAE;QACX,OAAO,GAAG,EAAE;YACR,gBAAgB,CAAC,SAAS,CAAC,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC;QAC5D,CAAC,CAAC;IACN,CAAC,EAAE,EAAE,CAAC,CAAC;IAEP,MAAM,WAAW,GAAG,cAAc,EAAE,CAAC;IAErC,MAAM,UAAU,GAAG,kBAAkB,CAAC,QAAQ,EAAE,QAAQ,EAAE,WAAW,EAAE,MAAM,CAAC,CAAC;IAC/E,MAAM,UAAU,GAAG,sBAAsB,CAAC,UAAU,CAAC,CAAC;IAEtD,gGAAgG;IAChG,8FAA8F;IAC9F,MAAM,CAAC,OAAO,EAAE,UAAU,CAAC,GAAG,QAAQ,CAA6C,UAAU,CAAC,SAAS,EAAE,CAAC,CAAC;IAC3G,SAAS,CAAC,GAAG,EAAE;QACX,8DAA8D;QAC9D,IAAI,UAAU,CAAC,KAAK,KAAK,SAAS,EAAE,CAAC;YACjC,UAAU,CAAC,UAAU,CAAC,SAAS,EAAE,CAAC,CAAC;QACvC,CAAC;IACL,CAAC,EAAE,CAAC,UAAU,CAAC,CAAC,CAAC;IAEjB,MAAM,wBAAwB,GAAG,2BAA2B,CAAC,QAAQ,EAAE,WAAW,EAAE,QAAQ,EAAE,OAAO,CAAC,CAAC;IAEvG,OAAO,wBAAwB,CAAC;AACpC,CAAC"}

package/dist/shared/interactivity/use-refresh-selector.d.ts

@@ -0,0 +1,5 @@
+/**
+ * Helper hook to refresh a selector by its key
+ */
+export default function useRefreshSelector(): (key: string, extras: string) => void;
+//# sourceMappingURL=use-refresh-selector.d.ts.map

package/dist/shared/interactivity/use-refresh-selector.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-refresh-selector.d.ts","sourceRoot":"","sources":["../../../js/shared/interactivity/use-refresh-selector.tsx"],"names":[],"mappings":"AAIA;;GAEG;AACH,MAAM,CAAC,OAAO,UAAU,kBAAkB,IAAI,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,KAAK,IAAI,CAclF"}

package/dist/shared/interactivity/use-refresh-selector.js

@@ -0,0 +1,20 @@
+import { useRecoilCallback } from 'recoil';
+import { selectorFamilyMembersRegistry, selectorFamilyRegistry } from './store';
+/**
+ * Helper hook to refresh a selector by its key
+ */
+export default function useRefreshSelector() {
+    return useRecoilCallback(({ refresh }) => {
+        return (key, extras) => {
+            var _a;
+            const family = selectorFamilyRegistry.get(key);
+            if (family) {
+                const selector = (_a = selectorFamilyMembersRegistry.get(family)) === null || _a === void 0 ? void 0 : _a.get(extras);
+                if (selector) {
+                    refresh(selector);
+                }
+            }
+        };
+    });
+}
+//# sourceMappingURL=use-refresh-selector.js.map

package/dist/shared/interactivity/use-refresh-selector.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-refresh-selector.js","sourceRoot":"","sources":["../../../js/shared/interactivity/use-refresh-selector.tsx"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,QAAQ,CAAC;AAE3C,OAAO,EAAE,6BAA6B,EAAE,sBAAsB,EAAE,MAAM,SAAS,CAAC;AAEhF;;GAEG;AACH,MAAM,CAAC,OAAO,UAAU,kBAAkB;IACtC,OAAO,iBAAiB,CAAC,CAAC,EAAE,OAAO,EAAE,EAAE,EAAE;QACrC,OAAO,CAAC,GAAW,EAAE,MAAc,EAAE,EAAE;;YACnC,MAAM,MAAM,GAAG,sBAAsB,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;YAE/C,IAAI,MAAM,EAAE,CAAC;gBACT,MAAM,QAAQ,GAAG,MAAA,6BAA6B,CAAC,GAAG,CAAC,MAAM,CAAC,0CAAE,GAAG,CAAC,MAAM,CAAC,CAAC;gBAExE,IAAI,QAAQ,EAAE,CAAC;oBACX,OAAO,CAAC,QAAQ,CAAC,CAAC;gBACtB,CAAC;YACL,CAAC;QACL,CAAC,CAAC;IACN,CAAC,CAAC,CAAC;AACP,CAAC"}

package/dist/shared/interactivity/use-server-component.d.ts

@@ -0,0 +1,24 @@
+import { AnyVariable, ComponentInstance } from '../../types';
+/**
+ * Claan value to a format understood by the backend.
+ * Removes `deps`, appends `force` to resolved derived(data)variables.
+ *
+ * @param value a value to clean
+ * @param force whether to force a derived variable recalculation
+ */
+export declare function cleanValue(value: unknown, force: boolean): any;
+/**
+ * A hook to fetch a server component
+ *
+ * @param name component name - specific to a given py_component
+ * @param uid component uid - specific to a given *instance* of a py_component
+ * @param dynamicKwargs kwargs passed into the component
+ */
+export default function useServerComponent(name: string, uid: string, dynamicKwargs: Record<string, AnyVariable<any>>): ComponentInstance;
+/**
+ * A helper hook that returns a function to force a refresh of a server component
+ *
+ * @param name component uid
+ */
+export declare function useRefreshServerComponent(uid: string): () => void;
+//# sourceMappingURL=use-server-component.d.ts.map