@darajs/core 0.4.8

package/dist/shared/utils/use-action.js

@@ -0,0 +1,314 @@
+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());
+    });
+};
+import { nanoid } from 'nanoid';
+import { useContext, useLayoutEffect, useRef } from 'react';
+import { useHistory, useLocation } from 'react-router-dom';
+import { useRecoilCallback } from 'recoil';
+import { concatMap, takeWhile } from 'rxjs/operators';
+import { useNotifications } from '@darajs/ui-notifications';
+import { HTTP_METHOD, Status, validateResponse } from '@darajs/ui-utils';
+import { fetchTaskResult, handleAuthErrors } from '../../api';
+import { request } from '../../api/http';
+import { ImportersCtx, WebSocketCtx, useRequestExtras, useTaskContext } from '../../shared/context';
+import { isActionImpl } from '../../types/utils';
+import { useEventBus } from '../event-bus/event-bus';
+import { useVariable } from '../interactivity';
+import { getOrRegisterPlainVariable } from '../interactivity/plain-variable';
+import { resolveVariable } from '../interactivity/resolve-variable';
+import { normalizeRequest } from './normalization';
+import useActionRegistry from './use-action-registry';
+/**
+ * Invoke a server-side action.
+ * This is used for annotated actions, sends a POST request to the server to start an action execution.
+ *
+ * @param input input value for the action
+ * @param executionId unique id for the action execution; this should be used to subscribe to action messages **before** calling fetchAction
+ * @param annotatedAction annotated action instance
+ * @param actionCtx action context
+ */
+function invokeAction(input, executionId, annotatedAction, actionCtx) {
+    return __awaiter(this, void 0, void 0, function* () {
+        // resolve kwargs to primitives, this registers variables if not already registered
+        const resolvedKwargs = Object.keys(annotatedAction.dynamic_kwargs).reduce((acc, k) => {
+            const value = annotatedAction.dynamic_kwargs[k];
+            acc[k] = resolveVariable(value, actionCtx.wsClient, actionCtx.taskCtx, actionCtx.extras, (v) => 
+            // This is only called for primitive variables so it should always resolve successfully
+            // hence not using a promise
+            actionCtx.snapshot.getLoadable(v).getValue());
+            return acc;
+        }, {});
+        const ws_channel = yield actionCtx.wsClient.getChannel();
+        const res = yield request(`/api/core/action/${annotatedAction.definition_uid}`, {
+            body: JSON.stringify({
+                execution_id: executionId,
+                input,
+                uid: annotatedAction.uid,
+                values: normalizeRequest(resolvedKwargs, annotatedAction.dynamic_kwargs),
+                ws_channel,
+            }),
+            method: HTTP_METHOD.POST,
+        }, actionCtx.extras);
+        yield handleAuthErrors(res, true);
+        yield validateResponse(res, `Failed to fetch the action value with uid: ${annotatedAction.uid}`);
+        const resContent = yield res.json();
+        // for tasks, wait for it to finish and fetch the result
+        // this is only used to pick up errors in the task execution
+        if ('task_id' in resContent) {
+            const taskId = resContent.task_id;
+            actionCtx.taskCtx.startTask(taskId);
+            yield actionCtx.wsClient.waitForTask(taskId);
+            actionCtx.taskCtx.endTask(taskId);
+            // We don't need the result as the MetaTask will send WS messages with actions as per usual
+            // fetchTaskResult will pick up on errors and raise them
+            yield fetchTaskResult(taskId, actionCtx.extras);
+        }
+    });
+}
+/**
+ * Global cache of action handlers by name. Used for perf so each action will only have to be
+ * resolved once.
+ */
+const ACTION_HANDLER_BY_NAME = {};
+/**
+ * Clear the global action handler cache.
+ * This is only used for testing.
+ */
+export function clearActionHandlerCache_TEST() {
+    Object.keys(ACTION_HANDLER_BY_NAME).forEach((k) => delete ACTION_HANDLER_BY_NAME[k]);
+}
+/**
+ * Error thrown when an action is not handled by the app.
+ */
+class UnhandledActionError extends Error {
+    constructor(message, actionImpl) {
+        super(message);
+        this.actionImpl = actionImpl;
+    }
+}
+/**
+ * Resolve an action implementation into an action handler function.
+ *
+ * @param actionImpl action implementation
+ * @param getAction callback to get the action definition from the action implementation
+ * @param importers importers available in the app
+ */
+function resolveActionImpl(actionImpl, getAction, importers, actionCtx) {
+    return __awaiter(this, void 0, void 0, function* () {
+        let actionHandler;
+        // resolve action handler function by name
+        // cache action handler globally for performance, they are pure functions so it's safe to do so
+        if (!ACTION_HANDLER_BY_NAME[actionImpl.name]) {
+            try {
+                const actionDef = getAction(actionImpl);
+                const moduleContent = yield importers[actionDef.py_module]();
+                actionHandler = moduleContent[actionImpl.name];
+                // only cache if we successfully resolved a built-in action handler
+                ACTION_HANDLER_BY_NAME[actionImpl.name] = actionHandler;
+            }
+            catch (_a) {
+                // if we failed to resolve the action handler, use the catch-all handler if defined
+                if (actionCtx.onUnhandledAction) {
+                    // this one is explicitly not cached since it's an arbitrary user-defined handler
+                    actionHandler = actionCtx.onUnhandledAction;
+                }
+                else {
+                    throw new UnhandledActionError(`Action definition for impl "${actionImpl.name}" not found`, actionImpl);
+                }
+            }
+        }
+        else {
+            actionHandler = ACTION_HANDLER_BY_NAME[actionImpl.name];
+        }
+        return actionHandler;
+    });
+}
+/**
+ * Execute a given action.
+ *
+ * @param input component input value
+ * @param action action implementation or annotated action
+ * @param actionCtx action execution context
+ * @param getAction callback to get the action definition from the action implementation
+ * @param importers available importers in the app
+ */
+function executeAction(input, action, actionCtx, getAction, importers) {
+    return __awaiter(this, void 0, void 0, function* () {
+        // if it's a simple action implementation, run the handler directly
+        if (isActionImpl(action)) {
+            const handler = yield resolveActionImpl(action, getAction, importers, actionCtx);
+            const result = handler(actionCtx, action);
+            // handle async handlers
+            if (result instanceof Promise) {
+                yield result;
+            }
+            return;
+        }
+        // otherwise call back to the server to execute the annotated action
+        // subscribe to action messages before even calling the action to avoid races
+        const executionId = nanoid();
+        const observable = actionCtx.wsClient.actionMessages$(executionId);
+        return new Promise((resolve, reject) => {
+            let activeTasks = 0; // Counter to keep track of active tasks
+            let streamCompleted = false; // Flag to check if the stream is completed
+            let isSettled = false;
+            let sub;
+            const checkForCompletion = () => {
+                if (!isSettled && streamCompleted && activeTasks === 0) {
+                    isSettled = true;
+                    sub.unsubscribe();
+                    resolve();
+                }
+            };
+            const onError = (error) => {
+                if (!isSettled) {
+                    isSettled = true;
+                    sub.unsubscribe();
+                    reject(error);
+                }
+            };
+            sub = observable
+                .pipe(concatMap((actionImpl) => __awaiter(this, void 0, void 0, function* () {
+                if (actionImpl) {
+                    const handler = yield resolveActionImpl(actionImpl, getAction, importers, actionCtx);
+                    return [handler, actionImpl];
+                }
+                return null;
+            })), takeWhile((res) => !!res) // stop when falsy is returned from concatMap
+            )
+                .subscribe({
+                complete: () => {
+                    streamCompleted = true; // Set the flag when the stream is complete
+                    checkForCompletion();
+                },
+                error: onError, // Reject the promise if there's an error in the stream
+                next: (_a) => __awaiter(this, [_a], void 0, function* ([handler, actionImpl]) {
+                    try {
+                        activeTasks += 1;
+                        const result = handler(actionCtx, actionImpl);
+                        // If it's a promise, await it to ensure sequential execution
+                        if (result instanceof Promise) {
+                            yield result;
+                        }
+                    }
+                    catch (error) {
+                        onError(error);
+                    }
+                    finally {
+                        if (activeTasks > 0) {
+                            activeTasks -= 1;
+                        }
+                        checkForCompletion();
+                    }
+                }),
+            });
+            // now request the action to be executed
+            invokeAction(input, executionId, action, actionCtx).catch(onError);
+        });
+    });
+}
+const noop = () => Promise.resolve();
+/**
+ * The useActionIsLoading hook returns a boolean indicating whether the action is currently in progress. This is
+ * currently only supported for single AnnotatedAction instances of actions and will return false in all other cases
+ * due to the lack of loading variable to use as a source of truth.
+ *
+ * @param action - the action to check the loading state of
+ * @returns the loading state of the action
+ */
+export function useActionIsLoading(action) {
+    // We allow conditional logic with hooks here under the assumption that the action will never change during the
+    // component lifetime. As ActionImpls have no loading variable we return false. As we expect to deprecate array's
+    // of actions in the near future as all the functionality then we return false as well due to the complexity of
+    // extracting potentially multiple annotated actions out of the array and resolving all their loading states
+    if (!action || isActionImpl(action) || Array.isArray(action)) {
+        return false;
+    }
+    // eslint-disable-next-line react-hooks/rules-of-hooks
+    return useVariable(action.loading)[0];
+}
+/**
+ * Consume an action def from the framework and return a callback function that can be used to trigger it
+ * and a loading state boolean indicating whether an action is currently in progress
+ *
+ * @param action the action passed in
+ * @param options optional extra options for the hook
+ */
+export default function useAction(action, options) {
+    const { client: wsClient } = useContext(WebSocketCtx);
+    const importers = useContext(ImportersCtx);
+    const { get: getAction } = useActionRegistry();
+    const notificationCtx = useNotifications();
+    const extras = useRequestExtras();
+    const history = useHistory();
+    const taskCtx = useTaskContext();
+    const location = useLocation();
+    const eventBus = useEventBus();
+    // keep actionCtx in a ref to avoid re-creating the callbacks
+    const actionCtx = useRef();
+    const optionsRef = useRef(options);
+    useLayoutEffect(() => {
+        actionCtx.current = {
+            extras,
+            history,
+            location,
+            notificationCtx,
+            taskCtx,
+            wsClient,
+            eventBus,
+        };
+        optionsRef.current = options;
+    });
+    const callback = useRecoilCallback((cbInterface) => (input) => __awaiter(this, void 0, void 0, function* () {
+        var _a;
+        const actionsToExecute = Array.isArray(action) ? action : [action];
+        // execute actions sequentially
+        for (const actionToExecute of actionsToExecute) {
+            const loadingVariable = !isActionImpl(actionToExecute) ?
+                getOrRegisterPlainVariable(actionToExecute.loading, wsClient, taskCtx, extras)
+                : null;
+            if (loadingVariable) {
+                cbInterface.set(loadingVariable, true);
+            }
+            // this is redefined for each action to have up-to-date snapshot
+            const fullActionContext = Object.assign(Object.assign({}, actionCtx.current), { input, onUnhandledAction: (_a = optionsRef.current) === null || _a === void 0 ? void 0 : _a.onUnhandledAction, 
+                // Recoil callback interface cannot be spread as it is a Proxy
+                gotoSnapshot: cbInterface.gotoSnapshot, refresh: cbInterface.refresh, reset: cbInterface.reset, set: cbInterface.set, snapshot: cbInterface.snapshot, transact_UNSTABLE: cbInterface.transact_UNSTABLE });
+            try {
+                // eslint-disable-next-line no-await-in-loop
+                yield executeAction(input, actionToExecute, fullActionContext, getAction, importers);
+            }
+            catch (error) {
+                // Display for easier debugging
+                // eslint-disable-next-line no-console
+                console.error(error);
+                let message = 'Try again or contact the application owner';
+                // Display the unhandled action directly as it might be helpful for developers
+                if (error instanceof UnhandledActionError) {
+                    message = error.message;
+                }
+                actionCtx.current.notificationCtx.pushNotification({
+                    key: '_actionError', // same key so action errors don't stack
+                    message,
+                    status: Status.ERROR,
+                    title: 'Error executing action',
+                });
+            }
+            if (loadingVariable) {
+                cbInterface.set(loadingVariable, false);
+            }
+        }
+    }), [action, getAction, importers]);
+    // return a noop if no action is passed
+    if (!action) {
+        return noop;
+    }
+    return callback;
+}
+//# sourceMappingURL=use-action.js.map

package/dist/shared/utils/use-action.js.map

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

package/dist/shared/utils/use-component-registry.d.ts

@@ -0,0 +1,11 @@
+import { Component, ComponentInstance } from '../../types/core';
+interface ComponentRegistryInterface {
+    get: (instance: ComponentInstance) => Promise<Component>;
+}
+/**
+ * The component registry pulls the full list of components from the backend and then returns a function that allows a
+ * specific component to be requested using it's instance.
+ */
+declare function useComponentRegistry(maxRetries?: number): ComponentRegistryInterface;
+export default useComponentRegistry;
+//# sourceMappingURL=use-component-registry.d.ts.map

package/dist/shared/utils/use-component-registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-component-registry.d.ts","sourceRoot":"","sources":["../../../js/shared/utils/use-component-registry.tsx"],"names":[],"mappings":"AAUA,OAAO,EAAE,SAAS,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAC;AAE5D,UAAU,0BAA0B;IAChC,GAAG,EAAE,CAAC,QAAQ,EAAE,iBAAiB,KAAK,OAAO,CAAC,SAAS,CAAC,CAAC;CAC5D;AAED;;;GAGG;AACH,iBAAS,oBAAoB,CAAC,UAAU,SAAI,GAAG,0BAA0B,CA2CxE;AAED,eAAe,oBAAoB,CAAC"}

package/dist/shared/utils/use-component-registry.js

@@ -0,0 +1,57 @@
+/* eslint-disable no-await-in-loop */
+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 { useCallback, useContext } from 'react';
+import { HTTP_METHOD, validateResponse } from '@darajs/ui-utils';
+import { request } from '../../api';
+import { handleAuthErrors } from '../../auth/auth';
+import { RegistriesCtx, useRequestExtras } from '../../shared/context';
+/**
+ * The component registry pulls the full list of components from the backend and then returns a function that allows a
+ * specific component to be requested using it's instance.
+ */
+function useComponentRegistry(maxRetries = 5) {
+    const { componentRegistry: components, refetchComponents } = useContext(RegistriesCtx);
+    const extras = useRequestExtras();
+    const get = useCallback((instance) => __awaiter(this, void 0, void 0, function* () {
+        let component = null;
+        let registry = Object.assign({}, components);
+        let i = 0;
+        while (i < maxRetries) {
+            if (registry && registry[instance.name]) {
+                component = registry[instance.name];
+                break;
+            }
+            if (i === 0) {
+                const res = yield request(`/api/core/components?name=${instance.name}`, { method: HTTP_METHOD.GET }, extras);
+                yield handleAuthErrors(res, true);
+                yield validateResponse(res, 'Failed to fetch the config for this app');
+                registry = yield res.json();
+            }
+            else {
+                // If component has not been found, it could be a nested py_component, so we refetch the registry
+                // to see if the component might have been added to the registry in the meantime
+                // But first wait for 0,5s before retrying, to give time for backend to update the registry
+                yield new Promise((resolve) => setTimeout(resolve, 500));
+                const { data } = yield refetchComponents();
+                registry = data;
+            }
+            i++;
+        }
+        if (!component) {
+            throw new Error(`Attempted to load a component (${instance.name}) that is not in the registry`);
+        }
+        return component;
+    }), [components]);
+    return { get };
+}
+export default useComponentRegistry;
+//# sourceMappingURL=use-component-registry.js.map

package/dist/shared/utils/use-component-registry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-component-registry.js","sourceRoot":"","sources":["../../../js/shared/utils/use-component-registry.tsx"],"names":[],"mappings":"AAAA,qCAAqC;;;;;;;;;;AAErC,gDAAgD;AAChD,OAAO,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,OAAO,CAAC;AAEhD,OAAO,EAAE,WAAW,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AAEjE,OAAO,EAAE,OAAO,EAAE,MAAM,OAAO,CAAC;AAChC,OAAO,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAC/C,OAAO,EAAE,aAAa,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AAOnE;;;GAGG;AACH,SAAS,oBAAoB,CAAC,UAAU,GAAG,CAAC;IACxC,MAAM,EAAE,iBAAiB,EAAE,UAAU,EAAE,iBAAiB,EAAE,GAAG,UAAU,CAAC,aAAa,CAAC,CAAC;IACvF,MAAM,MAAM,GAAG,gBAAgB,EAAE,CAAC;IAClC,MAAM,GAAG,GAAG,WAAW,CACnB,CAAO,QAA2B,EAAsB,EAAE;QACtD,IAAI,SAAS,GAAc,IAAI,CAAC;QAChC,IAAI,QAAQ,qBAAQ,UAAU,CAAE,CAAC;QACjC,IAAI,CAAC,GAAG,CAAC,CAAC;QACV,OAAO,CAAC,GAAG,UAAU,EAAE,CAAC;YACpB,IAAI,QAAQ,IAAI,QAAQ,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC;gBACtC,SAAS,GAAG,QAAQ,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;gBACpC,MAAM;YACV,CAAC;YACD,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC;gBACV,MAAM,GAAG,GAAG,MAAM,OAAO,CACrB,6BAA6B,QAAQ,CAAC,IAAI,EAAE,EAC5C,EAAE,MAAM,EAAE,WAAW,CAAC,GAAG,EAAE,EAC3B,MAAM,CACT,CAAC;gBACF,MAAM,gBAAgB,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC;gBAClC,MAAM,gBAAgB,CAAC,GAAG,EAAE,yCAAyC,CAAC,CAAC;gBACvE,QAAQ,GAAG,MAAM,GAAG,CAAC,IAAI,EAAE,CAAC;YAChC,CAAC;iBAAM,CAAC;gBACJ,iGAAiG;gBACjG,gFAAgF;gBAChF,2FAA2F;gBAC3F,MAAM,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,UAAU,CAAC,OAAO,EAAE,GAAG,CAAC,CAAC,CAAC;gBACzD,MAAM,EAAE,IAAI,EAAE,GAAG,MAAM,iBAAiB,EAAE,CAAC;gBAC3C,QAAQ,GAAG,IAAI,CAAC;YACpB,CAAC;YACD,CAAC,EAAE,CAAC;QACR,CAAC;QAED,IAAI,CAAC,SAAS,EAAE,CAAC;YACb,MAAM,IAAI,KAAK,CAAC,kCAAkC,QAAQ,CAAC,IAAI,+BAA+B,CAAC,CAAC;QACpG,CAAC;QAED,OAAO,SAAS,CAAC;IACrB,CAAC,CAAA,EACD,CAAC,UAAU,CAAC,CACf,CAAC;IAEF,OAAO,EAAE,GAAG,EAAE,CAAC;AACnB,CAAC;AAED,eAAe,oBAAoB,CAAC"}

package/dist/shared/utils/use-component-styles.d.ts

@@ -0,0 +1,24 @@
+import * as React from 'react';
+import { StyledComponentProps } from '../../types';
+/**
+ * Type containing CSSProperties which extends to those that are missing React's defined list
+ */
+interface CustomCSSProperties extends React.CSSProperties {
+    gap?: string;
+}
+/**
+ * Parse a raw_css property into styles and css
+ *
+ * @param rawCss raw css property to parse
+ */
+export declare function parseRawCss(rawCss: string | CustomCSSProperties | React.CSSProperties): [rawStyles: CustomCSSProperties, rawCss: string];
+/**
+ * Styling utility hook which takes in base styling props and raw_css
+ * Outputs `style` and `css` properties to inject into the top-level component
+ *
+ * @param props props to get styles from
+ * @param useDisplayContext whether or not to use the display context, for some components such as Modal, these do not care for the context of their parent
+ */
+export default function useComponentStyles(props: StyledComponentProps, useDisplayContext?: boolean): [CustomCSSProperties, string];
+export {};
+//# sourceMappingURL=use-component-styles.d.ts.map

package/dist/shared/utils/use-component-styles.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-component-styles.d.ts","sourceRoot":"","sources":["../../../js/shared/utils/use-component-styles.tsx"],"names":[],"mappings":"AAEA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAK/B,OAAO,EAAE,oBAAoB,EAAE,MAAM,SAAS,CAAC;AAQ/C;;GAEG;AACH,UAAU,mBAAoB,SAAQ,KAAK,CAAC,aAAa;IACrD,GAAG,CAAC,EAAE,MAAM,CAAC;CAChB;AAsCD;;;;GAIG;AACH,wBAAgB,WAAW,CACvB,MAAM,EAAE,MAAM,GAAG,mBAAmB,GAAG,KAAK,CAAC,aAAa,GAC3D,CAAC,SAAS,EAAE,mBAAmB,EAAE,MAAM,EAAE,MAAM,CAAC,CAOlD;AAED;;;;;;GAMG;AACH,MAAM,CAAC,OAAO,UAAU,kBAAkB,CACtC,KAAK,EAAE,oBAAoB,EAC3B,iBAAiB,UAAO,GACzB,CAAC,mBAAmB,EAAE,MAAM,CAAC,CAoC/B"}

package/dist/shared/utils/use-component-styles.js

@@ -0,0 +1,69 @@
+/* eslint-disable react-hooks/exhaustive-deps */
+import { useContext, useMemo } from 'react';
+import { useDeepCompare } from '@darajs/ui-utils';
+import { default as DisplayCtx } from '../../shared/context/display-context';
+/**
+ * Sets the flex property of a component based on props passed to it
+ *
+ * @param props the props passed to the component
+ * @param displayCtx the display context of the component, contains the parent layout context
+ * @param useDisplayContext whether or not to consider width/height in conjunction with displayCtx for some components such as Modal, these do not care for the context of their parent
+ */
+function flexStyles(props, displayCtx, useDisplayContext) {
+    let flexBasis = props.basis;
+    let flexShrink = props.shrink;
+    let flexGrow = props.grow;
+    if (useDisplayContext) {
+        // In a horizontal Stack setting the width should also set the flex-basis
+        if (props.width && displayCtx.direction === 'horizontal') {
+            flexBasis !== null && flexBasis !== void 0 ? flexBasis : (flexBasis = props.width);
+            flexShrink !== null && flexShrink !== void 0 ? flexShrink : (flexShrink = '0');
+            flexGrow !== null && flexGrow !== void 0 ? flexGrow : (flexGrow = '0');
+        }
+        // In a vertical Stack setting the height should also set the flex-basis
+        if (props.height && displayCtx.direction === 'vertical') {
+            flexBasis !== null && flexBasis !== void 0 ? flexBasis : (flexBasis = props.height);
+            flexShrink !== null && flexShrink !== void 0 ? flexShrink : (flexShrink = '0');
+            flexGrow !== null && flexGrow !== void 0 ? flexGrow : (flexGrow = '0');
+        }
+    }
+    // If hug is set, then the flex-basis should be set to content
+    // Otherwise we check if the parent is a component that has hug set to true, and its children should inherit
+    if (props.hug || (props.hug !== false && displayCtx.hug)) {
+        flexBasis !== null && flexBasis !== void 0 ? flexBasis : (flexBasis = 'content');
+        flexShrink !== null && flexShrink !== void 0 ? flexShrink : (flexShrink = '1');
+        flexGrow !== null && flexGrow !== void 0 ? flexGrow : (flexGrow = '0');
+    }
+    return { flexBasis, flexGrow, flexShrink };
+}
+/**
+ * Parse a raw_css property into styles and css
+ *
+ * @param rawCss raw css property to parse
+ */
+export function parseRawCss(rawCss) {
+    const isRawObject = typeof rawCss === 'object' && rawCss !== null && rawCss !== undefined;
+    const componentCss = !isRawObject && typeof rawCss === 'string' ? rawCss : '';
+    const styles = isRawObject ? rawCss : {};
+    return [styles, componentCss];
+}
+/**
+ * Styling utility hook which takes in base styling props and raw_css
+ * Outputs `style` and `css` properties to inject into the top-level component
+ *
+ * @param props props to get styles from
+ * @param useDisplayContext whether or not to use the display context, for some components such as Modal, these do not care for the context of their parent
+ */
+export default function useComponentStyles(props, useDisplayContext = true) {
+    const [rawStyles, rawCss] = parseRawCss(props.raw_css);
+    const displayCtx = useContext(DisplayCtx);
+    const flexProps = flexStyles(props, displayCtx, useDisplayContext);
+    const styles = useMemo(() => {
+        var _a;
+        const stylesObj = Object.assign(Object.assign(Object.assign({ backgroundColor: props.background, border: props.border, borderRadius: props.border_radius, color: props.color, fontFamily: props.font, fontSize: props.font_size, fontStyle: props.italic ? 'italic' : 'normal', fontWeight: props.bold ? 'bold' : 'normal', gap: props.gap, height: props.height, margin: props.margin, maxHeight: props.max_height, maxWidth: props.max_width, minHeight: props.min_height, minWidth: props.min_width, overflow: props.overflow, padding: props.padding, position: props.position, textDecoration: props.underline ? 'underline' : 'none', width: props.width }, flexProps), rawStyles), ((_a = props.style) !== null && _a !== void 0 ? _a : {}));
+        // Filter out null/undefined values so they don't end up accidentally overriding other style properties
+        return Object.fromEntries(Object.entries(stylesObj).filter(([, v]) => v !== null && v !== undefined));
+    }, [useDeepCompare(props)]);
+    return [styles, rawCss];
+}
+//# sourceMappingURL=use-component-styles.js.map

package/dist/shared/utils/use-component-styles.js.map

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

package/dist/shared/utils/use-defer-loadable.d.ts

@@ -0,0 +1,8 @@
+import { Loadable } from 'recoil';
+/**
+ * A hook that allows you to defer the loading of a loadable depending on the suspend setting in FallbackCtx.
+ *
+ * @param loadable The loadable to defer
+ */
+export default function useDeferLoadable<T>(loadable: Loadable<T>): T;
+//# sourceMappingURL=use-defer-loadable.d.ts.map

package/dist/shared/utils/use-defer-loadable.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-defer-loadable.d.ts","sourceRoot":"","sources":["../../../js/shared/utils/use-defer-loadable.tsx"],"names":[],"mappings":"AACA,OAAO,EAAE,QAAQ,EAAE,MAAM,QAAQ,CAAC;AAIlC;;;;GAIG;AACH,MAAM,CAAC,OAAO,UAAU,gBAAgB,CAAC,CAAC,EAAE,QAAQ,EAAE,QAAQ,CAAC,CAAC,CAAC,GAAG,CAAC,CA0CpE"}

package/dist/shared/utils/use-defer-loadable.js

@@ -0,0 +1,44 @@
+import { useContext, useEffect, useRef, useState } from 'react';
+import { FallbackCtx } from '../../shared/context';
+/**
+ * A hook that allows you to defer the loading of a loadable depending on the suspend setting in FallbackCtx.
+ *
+ * @param loadable The loadable to defer
+ */
+export default function useDeferLoadable(loadable) {
+    const { suspend } = useContext(FallbackCtx);
+    // Suspend on first render with getValue()
+    const [availableState, setAvailableState] = useState(() => loadable.getValue());
+    const timerId = useRef(null);
+    const isFirstRender = useRef(true);
+    const [showFallback, setShowFallback] = useState(false);
+    useEffect(() => {
+        // Skip the first render, as we're suspending anyway
+        if (isFirstRender.current) {
+            isFirstRender.current = false;
+            return;
+        }
+        // when the selector becomes loading, set a timeout if suspend is a number to switch to suspend mode
+        if (loadable.state === 'loading' && typeof suspend === 'number') {
+            timerId.current = setTimeout(() => {
+                setShowFallback(true);
+            }, suspend);
+        }
+        return () => {
+            clearTimeout(timerId.current);
+        };
+    }, [loadable.state, suspend]);
+    useEffect(() => {
+        if (loadable.state === 'hasValue') {
+            clearTimeout(timerId.current);
+            setShowFallback(false);
+            setAvailableState(loadable.valueOrThrow());
+        }
+    }, [loadable]);
+    // Suspend
+    if (suspend === true || showFallback) {
+        return loadable.getValue();
+    }
+    return availableState;
+}
+//# sourceMappingURL=use-defer-loadable.js.map

package/dist/shared/utils/use-defer-loadable.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-defer-loadable.js","sourceRoot":"","sources":["../../../js/shared/utils/use-defer-loadable.tsx"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,OAAO,CAAC;AAGhE,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAE/C;;;;GAIG;AACH,MAAM,CAAC,OAAO,UAAU,gBAAgB,CAAI,QAAqB;IAC7D,MAAM,EAAE,OAAO,EAAE,GAAG,UAAU,CAAC,WAAW,CAAC,CAAC;IAC5C,0CAA0C;IAC1C,MAAM,CAAC,cAAc,EAAE,iBAAiB,CAAC,GAAG,QAAQ,CAAC,GAAG,EAAE,CAAC,QAAQ,CAAC,QAAQ,EAAE,CAAC,CAAC;IAEhF,MAAM,OAAO,GAAG,MAAM,CAAiB,IAAI,CAAC,CAAC;IAC7C,MAAM,aAAa,GAAG,MAAM,CAAC,IAAI,CAAC,CAAC;IACnC,MAAM,CAAC,YAAY,EAAE,eAAe,CAAC,GAAG,QAAQ,CAAC,KAAK,CAAC,CAAC;IAExD,SAAS,CAAC,GAAG,EAAE;QACX,oDAAoD;QACpD,IAAI,aAAa,CAAC,OAAO,EAAE,CAAC;YACxB,aAAa,CAAC,OAAO,GAAG,KAAK,CAAC;YAC9B,OAAO;QACX,CAAC;QAED,oGAAoG;QACpG,IAAI,QAAQ,CAAC,KAAK,KAAK,SAAS,IAAI,OAAO,OAAO,KAAK,QAAQ,EAAE,CAAC;YAC9D,OAAO,CAAC,OAAO,GAAG,UAAU,CAAC,GAAG,EAAE;gBAC9B,eAAe,CAAC,IAAI,CAAC,CAAC;YAC1B,CAAC,EAAE,OAAO,CAAC,CAAC;QAChB,CAAC;QAED,OAAO,GAAG,EAAE;YACR,YAAY,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;QAClC,CAAC,CAAC;IACN,CAAC,EAAE,CAAC,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC,CAAC;IAE9B,SAAS,CAAC,GAAG,EAAE;QACX,IAAI,QAAQ,CAAC,KAAK,KAAK,UAAU,EAAE,CAAC;YAChC,YAAY,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;YAC9B,eAAe,CAAC,KAAK,CAAC,CAAC;YACvB,iBAAiB,CAAC,QAAQ,CAAC,YAAY,EAAE,CAAC,CAAC;QAC/C,CAAC;IACL,CAAC,EAAE,CAAC,QAAQ,CAAC,CAAC,CAAC;IAEf,UAAU;IACV,IAAI,OAAO,KAAK,IAAI,IAAI,YAAY,EAAE,CAAC;QACnC,OAAO,QAAQ,CAAC,QAAQ,EAAE,CAAC;IAC/B,CAAC;IAED,OAAO,cAAc,CAAC;AAC1B,CAAC"}

package/dist/shared/utils/use-interval.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Helper hook that runs a function after given intervals
+ *
+ * @param callback the function to run after each interval
+ * @param delay the delay in seconds between each interval
+ */
+declare function useInterval(callback: () => void, delay: number): void;
+export default useInterval;
+//# sourceMappingURL=use-interval.d.ts.map

package/dist/shared/utils/use-interval.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-interval.d.ts","sourceRoot":"","sources":["../../../js/shared/utils/use-interval.tsx"],"names":[],"mappings":"AAKA;;;;;GAKG;AACH,iBAAS,WAAW,CAAC,QAAQ,EAAE,MAAM,IAAI,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI,CAU9D;AAED,eAAe,WAAW,CAAC"}

package/dist/shared/utils/use-interval.js

@@ -0,0 +1,19 @@
+/* eslint-disable react-hooks/exhaustive-deps */
+import { useEffect } from 'react';
+import { useDeepCompare } from '@darajs/ui-utils';
+/**
+ * Helper hook that runs a function after given intervals
+ *
+ * @param callback the function to run after each interval
+ * @param delay the delay in seconds between each interval
+ */
+function useInterval(callback, delay) {
+    useEffect(() => {
+        if (delay) {
+            const id = setInterval(callback, delay * 1000);
+            return () => clearInterval(id);
+        }
+    }, useDeepCompare([delay, callback]));
+}
+export default useInterval;
+//# sourceMappingURL=use-interval.js.map

package/dist/shared/utils/use-interval.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-interval.js","sourceRoot":"","sources":["../../../js/shared/utils/use-interval.tsx"],"names":[],"mappings":"AAAA,gDAAgD;AAChD,OAAO,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAElC,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAElD;;;;;GAKG;AACH,SAAS,WAAW,CAAC,QAAoB,EAAE,KAAa;IACpD,SAAS,CACL,GAAG,EAAE;QACD,IAAI,KAAK,EAAE,CAAC;YACR,MAAM,EAAE,GAAG,WAAW,CAAC,QAAQ,EAAE,KAAK,GAAG,IAAI,CAAC,CAAC;YAC/C,OAAO,GAAG,EAAE,CAAC,aAAa,CAAC,EAAE,CAAC,CAAC;QACnC,CAAC;IACL,CAAC,EACD,cAAc,CAAC,CAAC,KAAK,EAAE,QAAQ,CAAC,CAAC,CACpC,CAAC;AACN,CAAC;AAED,eAAe,WAAW,CAAC"}

package/dist/shared/utils/use-previous.d.ts

@@ -0,0 +1,10 @@
+/**
+ * A helper hook to keep track of the previous value of a variable.
+ * Uses a `ref` underneath so does not cause additional re-renders.
+ *
+ * @param value value to keep track of
+ * @param initialValue initial value
+ */
+declare function usePrevious<T>(value: T, initialValue: T): T;
+export default usePrevious;
+//# sourceMappingURL=use-previous.d.ts.map

package/dist/shared/utils/use-previous.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-previous.d.ts","sourceRoot":"","sources":["../../../js/shared/utils/use-previous.tsx"],"names":[],"mappings":"AAEA;;;;;;GAMG;AACH,iBAAS,WAAW,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,YAAY,EAAE,CAAC,GAAG,CAAC,CAMpD;AAED,eAAe,WAAW,CAAC"}