@darajs/ui-causal-graph-editor 1.0.0-a.1

package/dist/shared/serializer.js

@@ -0,0 +1,131 @@
+/**
+ * Copyright 2023 Impulse Innovations Limited
+ *
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+import { EdgeType, } from '../types';
+const RENDERING_META_PREFIX = 'meta.rendering_properties.';
+function isPrefixed(key) {
+    return key.startsWith(RENDERING_META_PREFIX);
+}
+function removeEdgePrefix(key) {
+    return key.slice(RENDERING_META_PREFIX.length);
+}
+function removeNodePrefix(key) {
+    return key.slice(RENDERING_META_PREFIX.length);
+}
+/**
+ * Serialize a simulation edge into a causal graph edge
+ *
+ * @param attributes simulation edge data
+ * @param source optional source to include in output data
+ * @param destination optional destination to include in output data
+ */
+export function serializeGraphEdge(attributes, source, destination) {
+    const entries = Object.entries(attributes);
+    const unflattenedMeta = Object.fromEntries(entries
+        .filter(([key]) => isPrefixed(key))
+        .map(([key, val]) => {
+        const newKey = removeEdgePrefix(key);
+        return [newKey, val];
+    }));
+    const output = {
+        edge_type: attributes.edge_type,
+        meta: Object.assign(Object.assign({}, attributes.originalMeta), { rendering_properties: unflattenedMeta }),
+    };
+    if (source) {
+        output.source = source;
+    }
+    if (destination) {
+        output.destination = destination;
+    }
+    // Reverse the edge if it is a backwards directed edge
+    if (output.edge_type === EdgeType.BACKWARDS_DIRECTED_EDGE) {
+        output.edge_type = EdgeType.DIRECTED_EDGE;
+        if (output.source) {
+            output.source = destination;
+        }
+        if (output.destination) {
+            output.destination = source;
+        }
+    }
+    return output;
+}
+/**
+ * Serialize a simulation node into a causal graph node
+ *
+ * @param attributes simulation node data
+ * @param includeIdentifier whether to include data to identify the node
+ */
+export function serializeGraphNode(attributes, includeIdentifier = false) {
+    const entries = Object.entries(attributes);
+    const unflattenedMeta = Object.fromEntries(entries
+        .filter(([key]) => isPrefixed(key))
+        .map(([key, val]) => {
+        const newKey = removeNodePrefix(key);
+        return [newKey, val];
+    }));
+    const output = {
+        meta: Object.assign(Object.assign({}, attributes.originalMeta), { rendering_properties: unflattenedMeta }),
+        variable_type: attributes.variable_type,
+    };
+    if (includeIdentifier) {
+        output.identifier = attributes.id;
+    }
+    return output;
+}
+/**
+ * Serialize internal graph representation into a CausalGraph
+ *
+ * @param graph internal graph representation
+ */
+export function causalGraphSerializer(state) {
+    const edges = state.graph.reduceEdges((acc, id, attributes, source, target) => {
+        const serializedEdge = serializeGraphEdge(attributes);
+        // if the edge is backwards, we need to swap the source and target
+        if (attributes.edge_type === EdgeType.BACKWARDS_DIRECTED_EDGE) {
+            if (!(target in acc)) {
+                acc[target] = {};
+            }
+            acc[target][source] = serializedEdge;
+        }
+        else {
+            if (!(source in acc)) {
+                acc[source] = {};
+            }
+            acc[source][target] = serializedEdge;
+        }
+        return acc;
+    }, {});
+    const nodes = state.graph.reduceNodes((acc, id, attributes) => {
+        const entries = Object.entries(attributes);
+        const unflattenedMeta = Object.fromEntries(entries
+            .filter(([key]) => isPrefixed(key))
+            .map(([key, val]) => {
+            const newKey = removeNodePrefix(key);
+            return [newKey, val];
+        }));
+        acc[id] = {
+            meta: Object.assign(Object.assign({}, attributes.originalMeta), { rendering_properties: unflattenedMeta }),
+            variable_type: attributes.variable_type,
+        };
+        return acc;
+    }, {});
+    return {
+        edges,
+        nodes,
+        version: state.graph.getAttribute('version'),
+    };
+}
+//# sourceMappingURL=serializer.js.map

package/dist/shared/serializer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"serializer.js","sourceRoot":"","sources":["../../src/shared/serializer.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AACH,OAAO,EAKH,QAAQ,GAOX,MAAM,UAAU,CAAC;AAElB,MAAM,qBAAqB,GAAG,4BAA4B,CAAC;AAE3D,SAAS,UAAU,CAAmB,GAAW;IAC7C,OAAO,GAAG,CAAC,UAAU,CAAC,qBAAqB,CAAC,CAAC;AACjD,CAAC;AAED,SAAS,gBAAgB,CAAwC,GAAM;IACnE,OAAO,GAAG,CAAC,KAAK,CAAC,qBAAqB,CAAC,MAAM,CAA4B,CAAC;AAC9E,CAAC;AAED,SAAS,gBAAgB,CAAwC,GAAM;IACnE,OAAO,GAAG,CAAC,KAAK,CAAC,qBAAqB,CAAC,MAAM,CAA4B,CAAC;AAC9E,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,kBAAkB,CAAC,UAA0B,EAAE,MAAe,EAAE,WAAoB;IAChG,MAAM,OAAO,GAAG,MAAM,CAAC,OAAO,CAAC,UAAU,CAA4B,CAAC;IACtE,MAAM,eAAe,GAAsB,MAAM,CAAC,WAAW,CACzD,OAAO;SACF,MAAM,CAAC,CAAC,CAAC,GAAG,CAAC,EAAE,EAAE,CAAC,UAAU,CAA8B,GAAG,CAAC,CAAC;SAC/D,GAAG,CAAC,CAAC,CAAC,GAAG,EAAE,GAAG,CAAC,EAAE,EAAE;QAChB,MAAM,MAAM,GAAG,gBAAgB,CAAC,GAAkC,CAAC,CAAC;QACpE,OAAO,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IACzB,CAAC,CAAC,CACT,CAAC;IAEF,MAAM,MAAM,GAAoB;QAC5B,SAAS,EAAE,UAAU,CAAC,SAAS;QAC/B,IAAI,kCACG,UAAU,CAAC,YAAY,KAC1B,oBAAoB,EAAE,eAAe,GACxC;KACJ,CAAC;IAEF,IAAI,MAAM,EAAE;QACR,MAAM,CAAC,MAAM,GAAG,MAAM,CAAC;KAC1B;IAED,IAAI,WAAW,EAAE;QACb,MAAM,CAAC,WAAW,GAAG,WAAW,CAAC;KACpC;IAED,sDAAsD;IACtD,IAAI,MAAM,CAAC,SAAS,KAAK,QAAQ,CAAC,uBAAuB,EAAE;QACvD,MAAM,CAAC,SAAS,GAAG,QAAQ,CAAC,aAAa,CAAC;QAE1C,IAAI,MAAM,CAAC,MAAM,EAAE;YACf,MAAM,CAAC,MAAM,GAAG,WAAW,CAAC;SAC/B;QAED,IAAI,MAAM,CAAC,WAAW,EAAE;YACpB,MAAM,CAAC,WAAW,GAAG,MAAM,CAAC;SAC/B;KACJ;IAED,OAAO,MAAM,CAAC;AAClB,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,kBAAkB,CAAC,UAA0B,EAAE,iBAAiB,GAAG,KAAK;IACpF,MAAM,OAAO,GAAG,MAAM,CAAC,OAAO,CAAC,UAAU,CAA4B,CAAC;IACtE,MAAM,eAAe,GAAsB,MAAM,CAAC,WAAW,CACzD,OAAO;SACF,MAAM,CAAC,CAAC,CAAC,GAAG,CAAC,EAAE,EAAE,CAAC,UAAU,CAA8B,GAAG,CAAC,CAAC;SAC/D,GAAG,CAAC,CAAC,CAAC,GAAG,EAAE,GAAG,CAAC,EAAE,EAAE;QAChB,MAAM,MAAM,GAAG,gBAAgB,CAAC,GAAkC,CAAC,CAAC;QACpE,OAAO,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IACzB,CAAC,CAAC,CACT,CAAC;IAEF,MAAM,MAAM,GAAoB;QAC5B,IAAI,kCACG,UAAU,CAAC,YAAY,KAC1B,oBAAoB,EAAE,eAAe,GACxC;QACD,aAAa,EAAE,UAAU,CAAC,aAAa;KAC1C,CAAC;IAEF,IAAI,iBAAiB,EAAE;QACnB,MAAM,CAAC,UAAU,GAAG,UAAU,CAAC,EAAE,CAAC;KACrC;IAED,OAAO,MAAM,CAAC;AAClB,CAAC;AAMD;;;;GAIG;AACH,MAAM,UAAU,qBAAqB,CAAC,KAAiB;IACnD,MAAM,KAAK,GAAyB,KAAK,CAAC,KAAK,CAAC,WAAW,CACvD,CAAC,GAAyB,EAAE,EAAU,EAAE,UAA0B,EAAE,MAAc,EAAE,MAAc,EAAE,EAAE;QAClG,MAAM,cAAc,GAAG,kBAAkB,CAAC,UAAU,CAAC,CAAC;QAEtD,kEAAkE;QAClE,IAAI,UAAU,CAAC,SAAS,KAAK,QAAQ,CAAC,uBAAuB,EAAE;YAC3D,IAAI,CAAC,CAAC,MAAM,IAAI,GAAG,CAAC,EAAE;gBAClB,GAAG,CAAC,MAAM,CAAC,GAAG,EAAE,CAAC;aACpB;YACD,GAAG,CAAC,MAAM,CAAC,CAAC,MAAM,CAAC,GAAG,cAAc,CAAC;SACxC;aAAM;YACH,IAAI,CAAC,CAAC,MAAM,IAAI,GAAG,CAAC,EAAE;gBAClB,GAAG,CAAC,MAAM,CAAC,GAAG,EAAE,CAAC;aACpB;YACD,GAAG,CAAC,MAAM,CAAC,CAAC,MAAM,CAAC,GAAG,cAAc,CAAC;SACxC;QAED,OAAO,GAAG,CAAC;IACf,CAAC,EACD,EAAE,CACL,CAAC;IAEF,MAAM,KAAK,GAAyB,KAAK,CAAC,KAAK,CAAC,WAAW,CACvD,CAAC,GAAyB,EAAE,EAAU,EAAE,UAA0B,EAAE,EAAE;QAClE,MAAM,OAAO,GAAG,MAAM,CAAC,OAAO,CAAC,UAAU,CAA4B,CAAC;QACtE,MAAM,eAAe,GAAsB,MAAM,CAAC,WAAW,CACzD,OAAO;aACF,MAAM,CAAC,CAAC,CAAC,GAAG,CAAC,EAAE,EAAE,CAAC,UAAU,CAA8B,GAAG,CAAC,CAAC;aAC/D,GAAG,CAAC,CAAC,CAAC,GAAG,EAAE,GAAG,CAAC,EAAE,EAAE;YAChB,MAAM,MAAM,GAAG,gBAAgB,CAAC,GAAkC,CAAC,CAAC;YACpE,OAAO,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;QACzB,CAAC,CAAC,CACT,CAAC;QAEF,GAAG,CAAC,EAAE,CAAC,GAAG;YACN,IAAI,kCACG,UAAU,CAAC,YAAY,KAC1B,oBAAoB,EAAE,eAAe,GACxC;YACD,aAAa,EAAE,UAAU,CAAC,aAAa;SAC1C,CAAC;QAEF,OAAO,GAAG,CAAC;IACf,CAAC,EACD,EAAE,CACL,CAAC;IAEF,OAAO;QACH,KAAK;QACL,KAAK;QACL,OAAO,EAAE,KAAK,CAAC,KAAK,CAAC,YAAY,CAAC,SAAS,CAAC;KAC/C,CAAC;AACN,CAAC"}

package/dist/shared/settings-context.d.ts

@@ -0,0 +1,56 @@
+/**
+ * Copyright 2023 Impulse Innovations Limited
+ *
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+import * as React from 'react';
+import { NotificationPayload } from '@darajs/ui-notifications';
+import { EditorMode } from '../types';
+/**
+ * Common graph settings used inside graph sub-components
+ */
+export interface Settings {
+    /** Whether node dragging is enabled */
+    allowNodeDrag?: boolean;
+    /** Whether to show the details panel when the graph is not editable */
+    allowSelectionWhenNotEditable?: boolean;
+    /** Flag for disabling edge addition */
+    disableEdgeAdd?: boolean;
+    /** Flag for disabling latent node addition */
+    disableLatentNodeAdd?: boolean;
+    /** Flag for disabling node removal */
+    disableNodeRemoval?: boolean;
+    /** Allow editing */
+    editable?: boolean;
+    /** Mode the graph viewer should operate in */
+    editorMode?: EditorMode;
+    /** On notify handler to show a notification */
+    onNotify?: (payload: NotificationPayload) => void | Promise<void>;
+    /** Whether to show verbose descriptions in the editor frame */
+    verboseDescriptions?: boolean;
+}
+interface SettingsProviderProps {
+    children: React.ReactNode;
+    settings: Settings;
+}
+/**
+ * Wrapper around SettingsContext which requires settings to be set
+ */
+export declare function SettingsProvider({ children, settings }: SettingsProviderProps): JSX.Element;
+/**
+ * Helper hook that pulls in Settings from the SettingsContext
+ */
+export declare function useSettings(): Settings;
+export {};
+//# sourceMappingURL=settings-context.d.ts.map

package/dist/shared/settings-context.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"settings-context.d.ts","sourceRoot":"","sources":["../../src/shared/settings-context.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AACH,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAE/B,OAAO,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAC;AAE/D,OAAO,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AAEtC;;GAEG;AACH,MAAM,WAAW,QAAQ;IACrB,uCAAuC;IACvC,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,uEAAuE;IACvE,6BAA6B,CAAC,EAAE,OAAO,CAAC;IACxC,uCAAuC;IACvC,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,8CAA8C;IAC9C,oBAAoB,CAAC,EAAE,OAAO,CAAC;IAC/B,sCAAsC;IACtC,kBAAkB,CAAC,EAAE,OAAO,CAAC;IAC7B,oBAAoB;IACpB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,8CAA8C;IAC9C,UAAU,CAAC,EAAE,UAAU,CAAC;IACxB,+CAA+C;IAC/C,QAAQ,CAAC,EAAE,CAAC,OAAO,EAAE,mBAAmB,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAClE,+DAA+D;IAC/D,mBAAmB,CAAC,EAAE,OAAO,CAAC;CACjC;AAID,UAAU,qBAAqB;IAC3B,QAAQ,EAAE,KAAK,CAAC,SAAS,CAAC;IAC1B,QAAQ,EAAE,QAAQ,CAAC;CACtB;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,EAAE,QAAQ,EAAE,QAAQ,EAAE,EAAE,qBAAqB,GAAG,GAAG,CAAC,OAAO,CAE3F;AAED;;GAEG;AACH,wBAAgB,WAAW,IAAI,QAAQ,CAQtC"}

package/dist/shared/settings-context.js

@@ -0,0 +1,36 @@
+import { jsx as _jsx } from "react/jsx-runtime";
+/**
+ * Copyright 2023 Impulse Innovations Limited
+ *
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+import * as React from 'react';
+const SettingsContext = React.createContext(undefined);
+/**
+ * Wrapper around SettingsContext which requires settings to be set
+ */
+export function SettingsProvider({ children, settings }) {
+    return _jsx(SettingsContext.Provider, { value: settings, children: children });
+}
+/**
+ * Helper hook that pulls in Settings from the SettingsContext
+ */
+export function useSettings() {
+    const settings = React.useContext(SettingsContext);
+    if (settings === undefined) {
+        throw new Error('useSettings must be used within a SettingsProvider');
+    }
+    return settings;
+}
+//# sourceMappingURL=settings-context.js.map

package/dist/shared/settings-context.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"settings-context.js","sourceRoot":"","sources":["../../src/shared/settings-context.tsx"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;GAeG;AACH,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AA8B/B,MAAM,eAAe,GAAG,KAAK,CAAC,aAAa,CAAuB,SAAS,CAAC,CAAC;AAO7E;;GAEG;AACH,MAAM,UAAU,gBAAgB,CAAC,EAAE,QAAQ,EAAE,QAAQ,EAAyB;IAC1E,OAAO,KAAC,eAAe,CAAC,QAAQ,IAAC,KAAK,EAAE,QAAQ,YAAG,QAAQ,GAA4B,CAAC;AAC5F,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,WAAW;IACvB,MAAM,QAAQ,GAAG,KAAK,CAAC,UAAU,CAAC,eAAe,CAAC,CAAC;IAEnD,IAAI,QAAQ,KAAK,SAAS,EAAE;QACxB,MAAM,IAAI,KAAK,CAAC,oDAAoD,CAAC,CAAC;KACzE;IAED,OAAO,QAAQ,CAAC;AACpB,CAAC"}

package/dist/shared/styles.d.ts

@@ -0,0 +1,4 @@
+export declare const Wrapper: import("styled-components").StyledComponent<"div", import("@darajs/styled-components").DefaultTheme, {}, never>;
+export declare const Center: import("styled-components").StyledComponent<"div", import("@darajs/styled-components").DefaultTheme, {}, never>;
+export declare const Graph: import("styled-components").StyledComponent<"div", import("@darajs/styled-components").DefaultTheme, {}, never>;
+//# sourceMappingURL=styles.d.ts.map

package/dist/shared/styles.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"styles.d.ts","sourceRoot":"","sources":["../../src/shared/styles.tsx"],"names":[],"mappings":"AAkBA,eAAO,MAAM,OAAO,iHAOnB,CAAC;AAEF,eAAO,MAAM,MAAM,iHAMlB,CAAC;AAEF,eAAO,MAAM,KAAK,iHAkBjB,CAAC"}

package/dist/shared/styles.js

@@ -0,0 +1,52 @@
+/**
+ * Copyright 2023 Impulse Innovations Limited
+ *
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+import styled from '@darajs/styled-components';
+export const Wrapper = styled.div `
+    overflow: hidden;
+    display: flex;
+    flex: 1 1 auto;
+    flex-direction: column;
+
+    width: 100%;
+`;
+export const Center = styled.div `
+    display: flex;
+    flex: 1 1 auto;
+    flex-direction: column;
+    align-items: center;
+    justify-content: center;
+`;
+export const Graph = styled.div `
+    cursor: grab;
+
+    /* This is a CSS trick for the graph to fill the available space of the flex container */
+    position: absolute;
+    top: 0;
+    right: 0;
+    bottom: 0;
+    left: 0;
+
+    overflow: hidden;
+    flex: 1 1 auto;
+
+    width: 100%;
+    height: 100%;
+
+    border: 1px solid ${(props) => props.theme.colors.grey2};
+    border-radius: 4px;
+`;
+//# sourceMappingURL=styles.js.map

package/dist/shared/styles.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"styles.js","sourceRoot":"","sources":["../../src/shared/styles.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AACH,OAAO,MAAM,MAAM,2BAA2B,CAAC;AAE/C,MAAM,CAAC,MAAM,OAAO,GAAG,MAAM,CAAC,GAAG,CAAA;;;;;;;CAOhC,CAAC;AAEF,MAAM,CAAC,MAAM,MAAM,GAAG,MAAM,CAAC,GAAG,CAAA;;;;;;CAM/B,CAAC;AAEF,MAAM,CAAC,MAAM,KAAK,GAAG,MAAM,CAAC,GAAG,CAAA;;;;;;;;;;;;;;;;wBAgBP,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,KAAK,CAAC,MAAM,CAAC,KAAK;;CAE1D,CAAC"}

package/dist/shared/use-causal-graph-editor.d.ts

@@ -0,0 +1,19 @@
+import { CausalGraph, EditorMode, GraphState } from '../types';
+import { GraphActionCreators } from './causal-graph-store';
+export interface UseCausalGraphEditorApi {
+    api: GraphApi;
+    state: GraphState;
+}
+type ActionName = keyof typeof GraphActionCreators;
+/**
+ * Graph API object containing all available methods to modify the graph
+ */
+export type GraphApi = {
+    [k in ActionName]: (...args: Parameters<typeof GraphActionCreators[k]>) => void;
+};
+/**
+ * A helper hook to inject causal graph editor API for given initial graphdata
+ */
+export default function useCausalGraphEditor(graphData: CausalGraph, editorMode: EditorMode, availableInputs?: string[], newNodesRequirePosition?: boolean): UseCausalGraphEditorApi;
+export {};
+//# sourceMappingURL=use-causal-graph-editor.d.ts.map

package/dist/shared/use-causal-graph-editor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-causal-graph-editor.d.ts","sourceRoot":"","sources":["../../src/shared/use-causal-graph-editor.tsx"],"names":[],"mappings":"AAmBA,OAAO,EAAE,WAAW,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AAC/D,OAAO,EAAE,mBAAmB,EAAiC,MAAM,sBAAsB,CAAC;AAG1F,MAAM,WAAW,uBAAuB;IACpC,GAAG,EAAE,QAAQ,CAAC;IACd,KAAK,EAAE,UAAU,CAAC;CACrB;AAED,KAAK,UAAU,GAAG,MAAM,OAAO,mBAAmB,CAAC;AAGnD;;GAEG;AACH,MAAM,MAAM,QAAQ,GAAG;KAClB,CAAC,IAAI,UAAU,GAAG,CAAC,GAAG,IAAI,EAAE,UAAU,CAAC,OAAO,mBAAmB,CAAC,CAAC,CAAC,CAAC,KAAK,IAAI;CAClF,CAAC;AAEF;;GAEG;AACH,MAAM,CAAC,OAAO,UAAU,oBAAoB,CACxC,SAAS,EAAE,WAAW,EACtB,UAAU,EAAE,UAAU,EACtB,eAAe,CAAC,EAAE,MAAM,EAAE,EAC1B,uBAAuB,CAAC,EAAE,OAAO,GAClC,uBAAuB,CA6CzB"}

package/dist/shared/use-causal-graph-editor.js

@@ -0,0 +1,58 @@
+/**
+ * Copyright 2023 Impulse Innovations Limited
+ *
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+import isEqual from 'lodash/isEqual';
+import { useEffect, useMemo, useReducer, useRef } from 'react';
+import { GraphActionCreators, GraphActionType, GraphReducer } from './causal-graph-store';
+import { causalGraphParser } from './parsers';
+const actionNames = Object.keys(GraphActionCreators);
+/**
+ * A helper hook to inject causal graph editor API for given initial graphdata
+ */
+export default function useCausalGraphEditor(graphData, editorMode, availableInputs, newNodesRequirePosition) {
+    const [state, dispatch] = useReducer(GraphReducer, {
+        editorMode,
+        newNodesRequirePosition,
+    }, (initState) => {
+        return Object.assign(Object.assign({}, initState), { graph: causalGraphParser(graphData, availableInputs) });
+    });
+    // bind each action creator to dispatch
+    const api = useMemo(() => {
+        return actionNames.reduce((acc, actionName) => {
+            const actionCreator = GraphActionCreators[actionName];
+            // eslint-disable-next-line prefer-spread
+            acc[actionName] = (...args) => dispatch(actionCreator.apply(null, args));
+            return acc;
+        }, {});
+    }, [dispatch]);
+    // Init graph data, update when outside graph nodes/edges changes
+    const lastParentData = useRef(graphData); // keep track of last parent data to skip unnecessary updates
+    useEffect(() => {
+        if (!isEqual(lastParentData.current.nodes, graphData.nodes) ||
+            !isEqual(lastParentData.current.edges, graphData.edges)) {
+            dispatch({
+                graph: causalGraphParser(graphData, availableInputs, state.graph),
+                type: GraphActionType.INIT_GRAPH,
+            });
+        }
+        lastParentData.current = graphData;
+    }, [graphData]);
+    return {
+        api,
+        state,
+    };
+}
+//# sourceMappingURL=use-causal-graph-editor.js.map

package/dist/shared/use-causal-graph-editor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-causal-graph-editor.js","sourceRoot":"","sources":["../../src/shared/use-causal-graph-editor.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AACH,OAAO,OAAO,MAAM,gBAAgB,CAAC;AACrC,OAAO,EAAE,SAAS,EAAE,OAAO,EAAE,UAAU,EAAE,MAAM,EAAE,MAAM,OAAO,CAAC;AAG/D,OAAO,EAAE,mBAAmB,EAAE,eAAe,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AAC1F,OAAO,EAAE,iBAAiB,EAAE,MAAM,WAAW,CAAC;AAQ9C,MAAM,WAAW,GAAG,MAAM,CAAC,IAAI,CAAC,mBAAmB,CAAiB,CAAC;AASrE;;GAEG;AACH,MAAM,CAAC,OAAO,UAAU,oBAAoB,CACxC,SAAsB,EACtB,UAAsB,EACtB,eAA0B,EAC1B,uBAAiC;IAEjC,MAAM,CAAC,KAAK,EAAE,QAAQ,CAAC,GAAG,UAAU,CAChC,YAAY,EACZ;QACI,UAAU;QACV,uBAAuB;KAC1B,EACD,CAAC,SAAqB,EAAE,EAAE;QACtB,uCACO,SAAS,KACZ,KAAK,EAAE,iBAAiB,CAAC,SAAS,EAAE,eAAe,CAAC,IACtD;IACN,CAAC,CACJ,CAAC;IAEF,uCAAuC;IACvC,MAAM,GAAG,GAAG,OAAO,CAAC,GAAG,EAAE;QACrB,OAAO,WAAW,CAAC,MAAM,CAAW,CAAC,GAAG,EAAE,UAAU,EAAE,EAAE;YACpD,MAAM,aAAa,GAAG,mBAAmB,CAAC,UAAU,CAAC,CAAC;YACtD,yCAAyC;YACzC,GAAG,CAAC,UAAU,CAAC,GAAG,CAAC,GAAG,IAAsC,EAAE,EAAE,CAAC,QAAQ,CAAC,aAAa,CAAC,KAAK,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC,CAAC;YAC3G,OAAO,GAAG,CAAC;QACf,CAAC,EAAE,EAAc,CAAC,CAAC;IACvB,CAAC,EAAE,CAAC,QAAQ,CAAC,CAAC,CAAC;IAEf,iEAAiE;IACjE,MAAM,cAAc,GAAG,MAAM,CAAC,SAAS,CAAC,CAAC,CAAC,6DAA6D;IACvG,SAAS,CAAC,GAAG,EAAE;QACX,IACI,CAAC,OAAO,CAAC,cAAc,CAAC,OAAO,CAAC,KAAK,EAAE,SAAS,CAAC,KAAK,CAAC;YACvD,CAAC,OAAO,CAAC,cAAc,CAAC,OAAO,CAAC,KAAK,EAAE,SAAS,CAAC,KAAK,CAAC,EACzD;YACE,QAAQ,CAAC;gBACL,KAAK,EAAE,iBAAiB,CAAC,SAAS,EAAE,eAAe,EAAE,KAAK,CAAC,KAAK,CAAC;gBACjE,IAAI,EAAE,eAAe,CAAC,UAAU;aACnC,CAAC,CAAC;SACN;QAED,cAAc,CAAC,OAAO,GAAG,SAAS,CAAC;IACvC,CAAC,EAAE,CAAC,SAAS,CAAC,CAAC,CAAC;IAEhB,OAAO;QACH,GAAG;QACH,KAAK;KACR,CAAC;AACN,CAAC"}

package/dist/shared/use-drag-mode.d.ts

@@ -0,0 +1,33 @@
+/**
+ * Copyright 2023 Impulse Innovations Limited
+ *
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+import React from 'react';
+export type DragMode = 'create_edge' | 'move_node';
+/**
+ * Helper hook controlling switching and enabling drag mode
+ *
+ * @param editMode whether app is in edit mode
+ * @param allowEdgeAdd whether to allow adding edges
+ * @param allowNodeDrag whether to allow node dragging
+ * @param onDragModeChange callback to execute whenever drag mode changes
+ */
+declare function useDragMode(editMode: boolean, allowEdgeAdd: boolean, allowNodeDrag: boolean, onDragModeChange: (dragMode: DragMode | null) => void): {
+    dragEnabled: boolean;
+    dragMode: DragMode;
+    setDragMode: React.Dispatch<React.SetStateAction<DragMode>>;
+};
+export default useDragMode;
+//# sourceMappingURL=use-drag-mode.d.ts.map

package/dist/shared/use-drag-mode.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-drag-mode.d.ts","sourceRoot":"","sources":["../../src/shared/use-drag-mode.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AACH,OAAO,KAAuC,MAAM,OAAO,CAAC;AAE5D,MAAM,MAAM,QAAQ,GAAG,aAAa,GAAG,WAAW,CAAC;AAEnD;;;;;;;GAOG;AACH,iBAAS,WAAW,CAChB,QAAQ,EAAE,OAAO,EACjB,YAAY,EAAE,OAAO,EACrB,aAAa,EAAE,OAAO,EACtB,gBAAgB,EAAE,CAAC,QAAQ,EAAE,QAAQ,GAAG,IAAI,KAAK,IAAI,GACtD;IAAE,WAAW,EAAE,OAAO,CAAC;IAAC,QAAQ,EAAE,QAAQ,CAAC;IAAC,WAAW,EAAE,KAAK,CAAC,QAAQ,CAAC,KAAK,CAAC,cAAc,CAAC,QAAQ,CAAC,CAAC,CAAA;CAAE,CAsD3G;AAED,eAAe,WAAW,CAAC"}

package/dist/shared/use-drag-mode.js

@@ -0,0 +1,75 @@
+/**
+ * Copyright 2023 Impulse Innovations Limited
+ *
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+import { useEffect, useMemo, useState } from 'react';
+/**
+ * Helper hook controlling switching and enabling drag mode
+ *
+ * @param editMode whether app is in edit mode
+ * @param allowEdgeAdd whether to allow adding edges
+ * @param allowNodeDrag whether to allow node dragging
+ * @param onDragModeChange callback to execute whenever drag mode changes
+ */
+function useDragMode(editMode, allowEdgeAdd, allowNodeDrag, onDragModeChange) {
+    const [dragMode, setDragMode] = useState(() => {
+        if (editMode && allowEdgeAdd) {
+            return 'create_edge';
+        }
+        return allowNodeDrag ? 'move_node' : null;
+    });
+    const dragEnabled = useMemo(() => {
+        if (dragMode === 'create_edge') {
+            return editMode && allowEdgeAdd;
+        }
+        if (dragMode === 'move_node') {
+            return allowNodeDrag;
+        }
+        return false;
+    }, [dragMode, editMode, allowEdgeAdd]);
+    useEffect(() => {
+        if (!dragEnabled) {
+            onDragModeChange(null);
+        }
+        else {
+            onDragModeChange(dragMode);
+        }
+    }, [dragMode, dragEnabled]);
+    // Register listener to switch modes in edit mode
+    // In non-edit mode we stay in one mode only
+    useEffect(() => {
+        const cmdHandler = (ev) => {
+            // Left Alt (for Windows&Mac) or Left CMD (for OSX)
+            const codes = ['AltLeft', 'MetaLeft', 'OSLeft'];
+            if (codes.includes(ev.code)) {
+                setDragMode(dragMode === 'move_node' ? 'create_edge' : 'move_node');
+            }
+        };
+        // If both edge adding and node dragging is not allowed, there is no point in switching modes
+        if (editMode && allowEdgeAdd && allowNodeDrag) {
+            document.addEventListener('keydown', cmdHandler);
+            document.addEventListener('keyup', cmdHandler);
+        }
+        return () => {
+            if (editMode && allowEdgeAdd && allowNodeDrag) {
+                document.removeEventListener('keydown', cmdHandler);
+                document.removeEventListener('keyup', cmdHandler);
+            }
+        };
+    }, [dragMode]);
+    return { dragEnabled, dragMode, setDragMode };
+}
+export default useDragMode;
+//# sourceMappingURL=use-drag-mode.js.map

package/dist/shared/use-drag-mode.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-drag-mode.js","sourceRoot":"","sources":["../../src/shared/use-drag-mode.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AACH,OAAc,EAAE,SAAS,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,OAAO,CAAC;AAI5D;;;;;;;GAOG;AACH,SAAS,WAAW,CAChB,QAAiB,EACjB,YAAqB,EACrB,aAAsB,EACtB,gBAAqD;IAErD,MAAM,CAAC,QAAQ,EAAE,WAAW,CAAC,GAAG,QAAQ,CAAW,GAAG,EAAE;QACpD,IAAI,QAAQ,IAAI,YAAY,EAAE;YAC1B,OAAO,aAAa,CAAC;SACxB;QAED,OAAO,aAAa,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,IAAI,CAAC;IAC9C,CAAC,CAAC,CAAC;IACH,MAAM,WAAW,GAAG,OAAO,CAAC,GAAG,EAAE;QAC7B,IAAI,QAAQ,KAAK,aAAa,EAAE;YAC5B,OAAO,QAAQ,IAAI,YAAY,CAAC;SACnC;QAED,IAAI,QAAQ,KAAK,WAAW,EAAE;YAC1B,OAAO,aAAa,CAAC;SACxB;QAED,OAAO,KAAK,CAAC;IACjB,CAAC,EAAE,CAAC,QAAQ,EAAE,QAAQ,EAAE,YAAY,CAAC,CAAC,CAAC;IAEvC,SAAS,CAAC,GAAG,EAAE;QACX,IAAI,CAAC,WAAW,EAAE;YACd,gBAAgB,CAAC,IAAI,CAAC,CAAC;SAC1B;aAAM;YACH,gBAAgB,CAAC,QAAQ,CAAC,CAAC;SAC9B;IACL,CAAC,EAAE,CAAC,QAAQ,EAAE,WAAW,CAAC,CAAC,CAAC;IAE5B,iDAAiD;IACjD,4CAA4C;IAC5C,SAAS,CAAC,GAAG,EAAE;QACX,MAAM,UAAU,GAAG,CAAC,EAAiB,EAAQ,EAAE;YAC3C,mDAAmD;YACnD,MAAM,KAAK,GAAG,CAAC,SAAS,EAAE,UAAU,EAAE,QAAQ,CAAC,CAAC;YAChD,IAAI,KAAK,CAAC,QAAQ,CAAC,EAAE,CAAC,IAAI,CAAC,EAAE;gBACzB,WAAW,CAAC,QAAQ,KAAK,WAAW,CAAC,CAAC,CAAC,aAAa,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC;aACvE;QACL,CAAC,CAAC;QAEF,6FAA6F;QAC7F,IAAI,QAAQ,IAAI,YAAY,IAAI,aAAa,EAAE;YAC3C,QAAQ,CAAC,gBAAgB,CAAC,SAAS,EAAE,UAAU,CAAC,CAAC;YACjD,QAAQ,CAAC,gBAAgB,CAAC,OAAO,EAAE,UAAU,CAAC,CAAC;SAClD;QAED,OAAO,GAAG,EAAE;YACR,IAAI,QAAQ,IAAI,YAAY,IAAI,aAAa,EAAE;gBAC3C,QAAQ,CAAC,mBAAmB,CAAC,SAAS,EAAE,UAAU,CAAC,CAAC;gBACpD,QAAQ,CAAC,mBAAmB,CAAC,OAAO,EAAE,UAAU,CAAC,CAAC;aACrD;QACL,CAAC,CAAC;IACN,CAAC,EAAE,CAAC,QAAQ,CAAC,CAAC,CAAC;IAEf,OAAO,EAAE,WAAW,EAAE,QAAQ,EAAE,WAAW,EAAE,CAAC;AAClD,CAAC;AAED,eAAe,WAAW,CAAC"}

package/dist/shared/use-edge-encoder.d.ts

@@ -0,0 +1,45 @@
+import { EdgeConstraint, EdgeConstraintItem } from '../types';
+/**
+ * Parse edge constraints into internal representation
+ *
+ * @param constraints edge constraints to parse
+ */
+export declare function parseConstraints(constraints: EdgeConstraint[]): EdgeConstraintItem[];
+/**
+ * Parse internal edge constraint items to external representation
+ *
+ * @param constraintItems edge constraint items to parse
+ */
+export declare function parseConstraintItems(constraintItems: EdgeConstraintItem[]): EdgeConstraint[];
+interface EdgeConstraintEncoderApi {
+    /**
+     * Add a new constraint
+     */
+    addConstraint: (source?: string, target?: string) => void;
+    /**
+     * Current constraints
+     */
+    constraints: EdgeConstraintItem[];
+    /**
+     * Remove a constraint with the given id
+     */
+    removeConstraint: (id: string) => void;
+    /**
+     * Reverse a given constraint - switch source and target
+     */
+    reverseConstraint: (edgeConstraint: EdgeConstraintItem) => void;
+    /**
+     * Update given constraint
+     */
+    updateConstraint: (edgeConstraint: EdgeConstraintItem) => void;
+}
+/**
+ * Hook exposing common logic to manage edge constraints
+ * Can be re-used with different frontends to maintain the same functionality
+ *
+ * @param initialConstraints Initial constraints to show
+ * @param onUpdate Handler called whenever constraints are updated
+ */
+export declare function useEdgeConstraintEncoder(initialConstraints: EdgeConstraint[], onUpdate?: (constraints: EdgeConstraint[]) => void | Promise<void>): EdgeConstraintEncoderApi;
+export {};
+//# sourceMappingURL=use-edge-encoder.d.ts.map

package/dist/shared/use-edge-encoder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-edge-encoder.d.ts","sourceRoot":"","sources":["../../src/shared/use-edge-encoder.tsx"],"names":[],"mappings":"AAqBA,OAAO,EAAE,cAAc,EAAE,kBAAkB,EAAsB,MAAM,UAAU,CAAC;AAElF;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,WAAW,EAAE,cAAc,EAAE,GAAG,kBAAkB,EAAE,CAyBpF;AAED;;;;GAIG;AACH,wBAAgB,oBAAoB,CAAC,eAAe,EAAE,kBAAkB,EAAE,GAAG,cAAc,EAAE,CAK5F;AAED,UAAU,wBAAwB;IAC9B;;OAEG;IACH,aAAa,EAAE,CAAC,MAAM,CAAC,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,KAAK,IAAI,CAAC;IAC1D;;OAEG;IACH,WAAW,EAAE,kBAAkB,EAAE,CAAC;IAClC;;OAEG;IACH,gBAAgB,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,IAAI,CAAC;IACvC;;OAEG;IACH,iBAAiB,EAAE,CAAC,cAAc,EAAE,kBAAkB,KAAK,IAAI,CAAC;IAChE;;OAEG;IACH,gBAAgB,EAAE,CAAC,cAAc,EAAE,kBAAkB,KAAK,IAAI,CAAC;CAClE;AAED;;;;;;GAMG;AACH,wBAAgB,wBAAwB,CACpC,kBAAkB,EAAE,cAAc,EAAE,EACpC,QAAQ,CAAC,EAAE,CAAC,WAAW,EAAE,cAAc,EAAE,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,GACnE,wBAAwB,CAmD1B"}