@linkurious/ogma-linkurious-parser 4.1.4 → 4.1.6

package/dist/ogma/features/nodeGrouping.d.ts

@@ -1,5 +1,5 @@
 import { Transformation, NodeList, StyleRule } from '@linkurious/ogma';
-import { LkEdgeData, LkNodeData, NodeGroupingRule } from '@linkurious/rest-client';
+import { IVizNodeGroupInfo, LkEdgeData, LkNodeData, NodeGroupingRule } from '@linkurious/rest-client';
 import { LKOgma } from '../index';
 export declare const LKE_NODE_GROUPING_EDGE = "LKE_NODE_GROUPING_EDGE";
 export declare const LKE_NODE_GROUPING_NODE = "LKE_NODE_GROUPING_NODE";
@@ -44,6 +44,11 @@ export declare class NodeGroupingTransformation {
      * @private
      */
     getVirtualNodesOfTransformation(): NodeList<LkNodeData, LkEdgeData>;
+    /**
+     * Set the node group pin
+     * @param nodeGroups object containing the node group id and the layoutable attribute
+     */
+    setNodeGroupPin(nodeGroups: IVizNodeGroupInfo[]): Promise<void>;
     /**
      * Return the caption of a virtual node
      * @param node reference to the virtual node

package/dist/ogma/features/nodeGrouping.js

@@ -169,12 +169,33 @@ class NodeGroupingTransformation {
         // @ts-ignore getContext exists on the transformation but hidden by the types
         return this.transformation.getContext().metaNodes;
     }
+    /**
+     * Set the node group pin
+     * @param nodeGroups object containing the node group id and the layoutable attribute
+     */
+    setNodeGroupPin(nodeGroups) {
+        return __awaiter(this, void 0, void 0, function* () {
+            this._ogma
+                .getNodes()
+                .filter((node) => node.isVirtual())
+                .forEach((node) => {
+                var _a;
+                const nodeGroupInfo = nodeGroups.find((nodeGroup) => nodeGroup.id === node.getData('nodeGroupId'));
+                if (nodeGroupInfo !== undefined) {
+                    void node.setAttribute('layoutable', (_a = nodeGroupInfo.attributes.layoutable) !== null && _a !== void 0 ? _a : false);
+                }
+            });
+        });
+    }
     /**
      * Return the caption of a virtual node
      * @param node reference to the virtual node
      */
     _getNodeGroupingCaption(node) {
-        if (node !== undefined && node.isVirtual()) {
+        var _a;
+        // TODO: Normally there is no need to check if getSubNodes return a value, Ogma issue
+        //https://github.com/Linkurious/ogma/issues/3876
+        if (node !== undefined && node.isVirtual() && ((_a = node.getSubNodes()) === null || _a === void 0 ? void 0 : _a.get(0)) !== undefined) {
             // get the property value of the first node of the group (all nodes share the same property value)
             const lkPropertyValue = node
                 .getSubNodes()

package/dist/ogma/features/nodeGrouping.js.map

@@ -1 +1 @@
-{"version":3,"file":"nodeGrouping.js","sourceRoot":"","sources":["../../../src/ogma/features/nodeGrouping.ts"],"names":[],"mappings":"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","sourcesContent":["import {Transformation, Node, NodeList, StyleRule} from '@linkurious/ogma';\nimport {LkEdgeData, LkNodeData, MissingValue, NodeGroupingRule} from '@linkurious/rest-client';\nimport sha1 from 'sha1';\n\nimport {FORCE_LAYOUT_CONFIG, LKOgma} from '../index';\nimport {Tools} from '../../tools/tools';\n\nexport const LKE_NODE_GROUPING_EDGE = 'LKE_NODE_GROUPING_EDGE';\nexport const LKE_NODE_GROUPING_NODE = 'LKE_NODE_GROUPING_NODE';\n\nexport class NodeGroupingTransformation {\n  public transformation?: Transformation<LkNodeData, LkEdgeData>;\n  public groupRule?: NodeGroupingRule;\n  public nodeGroupingStyleRule?: StyleRule<LkNodeData, LkEdgeData>;\n  private _ogma: LKOgma;\n\n  constructor(ogma: LKOgma) {\n    this._ogma = ogma;\n  }\n\n  /**\n   * Set the grouping rule\n   * @param rule of grouping\n   */\n  public setGroupingRule(rule: NodeGroupingRule | undefined): void {\n    this.groupRule = rule;\n  }\n\n  /**\n   * create a node grouping transformation\n   * It uses groupRule to define the rule\n   * Group the nodes based on a category type and a property value\n   */\n  public async initTransformation(): Promise<void> {\n    if (this.transformation === undefined) {\n      this.transformation = this._ogma.transformations.addNodeGrouping({\n        groupIdFunction: (node) => {\n          if (this._isRuleNotApplicableToNode(node)) {\n            return undefined;\n          } else {\n            const propertyValue = this._findGroupingPropertyValue(node);\n            // groupRule is defined if not we returned undefined\n            // node with same value will be part of the same group\n            return `${this.groupRule?.groupingOptions.itemTypes.join('-')}-${propertyValue}`\n              .toLowerCase()\n              .trim();\n          }\n        },\n        nodeGenerator: (nodes) => {\n          return {\n            data: {\n              categories: [LKE_NODE_GROUPING_NODE],\n              properties: {},\n              nodeGroupId: this._findNodeGroupId(nodes)\n            }\n          };\n        },\n        edgeGenerator: () => {\n          return {\n            data: {\n              type: LKE_NODE_GROUPING_EDGE\n            }\n          };\n        },\n        showContents: true,\n        padding: 10\n      });\n    } else {\n      await this.refreshTransformation();\n    }\n  }\n\n  /**\n   * refresh the transformation\n   * Called when there is a change in the rule\n   */\n  public async refreshTransformation(): Promise<void> {\n    if (this.transformation !== undefined) {\n      await this.transformation.refresh();\n      await this._unpinNodes(this._getAllTransformationRawNodes());\n    } else {\n      await this.initTransformation();\n    }\n  }\n\n  /**\n   * init node grouping style\n   */\n  public initNodeGroupingStyle(): void {\n    this.nodeGroupingStyleRule = this._ogma.styles.addRule({\n      nodeAttributes: {\n        // Any default style will go here\n        text: {\n          content: (node: Node<LkNodeData> | undefined): string | undefined => {\n            return this._getNodeGroupingCaption(node);\n          },\n          style: 'bold'\n        },\n        layer: -1,\n        color: 'rgba(240, 240, 240)',\n        innerStroke: {\n          color: '#7f7f7f',\n          width: 2\n        }\n      },\n      nodeSelector: (node) => {\n        // TODO: Tools.isDefined(node.getSubNodes()) is a work around for an ogma issue visible when using image export plugin with Node grouping\n        // remove when updating to Ogma v5.1.x\n        return node.isVirtual() && Tools.isDefined(node.getSubNodes());\n      },\n      // the style will be updated when data object is updated\n      nodeDependencies: {self: {data: true}}\n    });\n  }\n\n  public async refreshNodeGroupingStyle(): Promise<void> {\n    await this.nodeGroupingStyleRule?.refresh();\n  }\n\n  /**\n   * run layout on all subnodes of virtual nodes\n   */\n  public async runLayoutOnAllSubNodes(): Promise<void> {\n    await this._ogma.transformations.afterNextUpdate();\n    const rawNodesList = this._getAllTransformationRawNodes();\n    const promisesList: Promise<void>[] = [];\n    for (let i = 0; i < rawNodesList.length; i++) {\n      // rawNodesList[i] is not null because each group has at least one node\n      const subNodes = rawNodesList[i]!;\n      promisesList.push(this.runSubNodesLayout(subNodes));\n    }\n    await Promise.all(promisesList);\n  }\n\n  /**\n   * Run the layout on the subnodes of the virtual node\n   * @param subNodes nodes part of a virtual node\n   */\n  public async runSubNodesLayout(subNodes: NodeList<LkNodeData, LkEdgeData>): Promise<void> {\n    if (subNodes.size === 0 || subNodes.size === 1) {\n      return;\n    }\n\n    const noEdges = subNodes.getAdjacentEdges({bothExtremities: true}).size === 0;\n    if (noEdges) {\n      await this._runCirclePack(subNodes);\n    } else {\n      await this._runForceLayout(subNodes);\n    }\n  }\n\n  /**\n   * Get the virtual nodes of the transformation\n   * @private\n   */\n  public getVirtualNodesOfTransformation(): NodeList<LkNodeData, LkEdgeData> {\n    // @ts-ignore getContext exists on the transformation but hidden by the types\n    return this.transformation.getContext().metaNodes;\n  }\n\n  /**\n   * Return the caption of a virtual node\n   * @param node reference to the virtual node\n   */\n  private _getNodeGroupingCaption(node: Node<LkNodeData> | undefined): string | undefined {\n    if (node !== undefined && node.isVirtual()) {\n      // get the property value of the first node of the group (all nodes share the same property value)\n      const lkPropertyValue = node\n        .getSubNodes()!\n        .get(0)\n        .getData(['properties', this.groupRule!.groupingOptions.propertyKey]);\n      const propertyValue = Tools.getValueFromLkProperty(lkPropertyValue);\n      const size = node.getSubNodes()!.filter((e) => !e.hasClass('filtered')).size;\n      return `${propertyValue} (${size})`;\n    }\n  }\n\n  /**\n   * Run the circle pack layout on the subnodes\n   * @param subNodes\n   */\n  private async _runCirclePack(subNodes: NodeList<LkNodeData, LkEdgeData>): Promise<void> {\n    await this._ogma.algorithms.circlePack({\n      nodes: subNodes,\n      margin: 10,\n      sort: 'asc'\n    });\n  }\n\n  private async _runForceLayout(subNodes: NodeList<LkNodeData, LkEdgeData>): Promise<void> {\n    await this._ogma.layouts.force({\n      nodes: subNodes,\n      ...FORCE_LAYOUT_CONFIG\n    });\n  }\n\n  private _isRuleNotApplicableToNode(node: Node<LkNodeData>): boolean {\n    const propertyValue = node.getData([\n      'properties',\n      this.groupRule?.groupingOptions.propertyKey ?? ''\n    ]);\n    return (\n      // if the group rule is not defined\n      this.groupRule === undefined ||\n      // if rule is applied to a different category\n      this.groupRule.groupingOptions.itemTypes.every(\n        (itemType) => !node.getData('categories').includes(itemType)\n      ) ||\n      // if the property value is not defined\n      !Tools.isDefined(propertyValue) ||\n      // if the property value is missing\n      (typeof propertyValue === 'object' && (propertyValue as MissingValue).status === 'missing')\n    );\n  }\n\n  /**\n   * Unpin list of nodes\n   * @param nodes\n   * @private\n   */\n  private async _unpinNodes(nodes: Array<NodeList | null>): Promise<void> {\n    await Promise.all(\n      nodes.map((nodeList) => {\n        if (nodeList !== null) {\n          return nodeList.setAttribute('layoutable', true);\n        }\n      })\n    );\n  }\n\n  /**\n   * Get all the raw nodes part of the transformation\n   * @private\n   */\n  private _getAllTransformationRawNodes(): Array<NodeList | null> {\n    const virtualNodes = this.getVirtualNodesOfTransformation();\n    return virtualNodes.getSubNodes();\n  }\n\n  private _findGroupingPropertyValue(node: Node<LkNodeData>): string {\n    const propertyValue = node.getData([\n      'properties',\n      this.groupRule?.groupingOptions.propertyKey ?? ''\n    ]);\n    return `${Tools.getValueFromLkProperty(propertyValue)}`;\n  }\n\n  /**\n   * Return a hashed string that represents the group id\n   */\n  private _findNodeGroupId(nodes: NodeList<LkNodeData, LkEdgeData>): string {\n    const propertyValue = this._findGroupingPropertyValue(nodes.get(0));\n    return sha1(\n      `${this.groupRule?.name}-${this.groupRule?.groupingOptions.itemTypes.join(\n        '-'\n      )}-${propertyValue}`\n    );\n  }\n}\n"]}
+{"version":3,"file":"nodeGrouping.js","sourceRoot":"","sources":["../../../src/ogma/features/nodeGrouping.ts"],"names":[],"mappings":"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","sourcesContent":["import {Transformation, Node, NodeList, StyleRule} from '@linkurious/ogma';\nimport {\n  IVizNodeGroupInfo,\n  LkEdgeData,\n  LkNodeData,\n  MissingValue,\n  NodeGroupingRule\n} from '@linkurious/rest-client';\nimport sha1 from 'sha1';\n\nimport {FORCE_LAYOUT_CONFIG, LKOgma} from '../index';\nimport {Tools} from '../../tools/tools';\n\nexport const LKE_NODE_GROUPING_EDGE = 'LKE_NODE_GROUPING_EDGE';\nexport const LKE_NODE_GROUPING_NODE = 'LKE_NODE_GROUPING_NODE';\n\nexport class NodeGroupingTransformation {\n  public transformation?: Transformation<LkNodeData, LkEdgeData>;\n  public groupRule?: NodeGroupingRule;\n  public nodeGroupingStyleRule?: StyleRule<LkNodeData, LkEdgeData>;\n  private _ogma: LKOgma;\n\n  constructor(ogma: LKOgma) {\n    this._ogma = ogma;\n  }\n\n  /**\n   * Set the grouping rule\n   * @param rule of grouping\n   */\n  public setGroupingRule(rule: NodeGroupingRule | undefined): void {\n    this.groupRule = rule;\n  }\n\n  /**\n   * create a node grouping transformation\n   * It uses groupRule to define the rule\n   * Group the nodes based on a category type and a property value\n   */\n  public async initTransformation(): Promise<void> {\n    if (this.transformation === undefined) {\n      this.transformation = this._ogma.transformations.addNodeGrouping({\n        groupIdFunction: (node) => {\n          if (this._isRuleNotApplicableToNode(node)) {\n            return undefined;\n          } else {\n            const propertyValue = this._findGroupingPropertyValue(node);\n            // groupRule is defined if not we returned undefined\n            // node with same value will be part of the same group\n            return `${this.groupRule?.groupingOptions.itemTypes.join('-')}-${propertyValue}`\n              .toLowerCase()\n              .trim();\n          }\n        },\n        nodeGenerator: (nodes) => {\n          return {\n            data: {\n              categories: [LKE_NODE_GROUPING_NODE],\n              properties: {},\n              nodeGroupId: this._findNodeGroupId(nodes)\n            }\n          };\n        },\n        edgeGenerator: () => {\n          return {\n            data: {\n              type: LKE_NODE_GROUPING_EDGE\n            }\n          };\n        },\n        showContents: true,\n        padding: 10\n      });\n    } else {\n      await this.refreshTransformation();\n    }\n  }\n\n  /**\n   * refresh the transformation\n   * Called when there is a change in the rule\n   */\n  public async refreshTransformation(): Promise<void> {\n    if (this.transformation !== undefined) {\n      await this.transformation.refresh();\n      await this._unpinNodes(this._getAllTransformationRawNodes());\n    } else {\n      await this.initTransformation();\n    }\n  }\n\n  /**\n   * init node grouping style\n   */\n  public initNodeGroupingStyle(): void {\n    this.nodeGroupingStyleRule = this._ogma.styles.addRule({\n      nodeAttributes: {\n        // Any default style will go here\n        text: {\n          content: (node: Node<LkNodeData> | undefined): string | undefined => {\n            return this._getNodeGroupingCaption(node);\n          },\n          style: 'bold'\n        },\n        layer: -1,\n        color: 'rgba(240, 240, 240)',\n        innerStroke: {\n          color: '#7f7f7f',\n          width: 2\n        }\n      },\n      nodeSelector: (node) => {\n        // TODO: Tools.isDefined(node.getSubNodes()) is a work around for an ogma issue visible when using image export plugin with Node grouping\n        // remove when updating to Ogma v5.1.x\n        return node.isVirtual() && Tools.isDefined(node.getSubNodes());\n      },\n      // the style will be updated when data object is updated\n      nodeDependencies: {self: {data: true}}\n    });\n  }\n\n  public async refreshNodeGroupingStyle(): Promise<void> {\n    await this.nodeGroupingStyleRule?.refresh();\n  }\n\n  /**\n   * run layout on all subnodes of virtual nodes\n   */\n  public async runLayoutOnAllSubNodes(): Promise<void> {\n    await this._ogma.transformations.afterNextUpdate();\n    const rawNodesList = this._getAllTransformationRawNodes();\n    const promisesList: Promise<void>[] = [];\n    for (let i = 0; i < rawNodesList.length; i++) {\n      // rawNodesList[i] is not null because each group has at least one node\n      const subNodes = rawNodesList[i]!;\n      promisesList.push(this.runSubNodesLayout(subNodes));\n    }\n    await Promise.all(promisesList);\n  }\n\n  /**\n   * Run the layout on the subnodes of the virtual node\n   * @param subNodes nodes part of a virtual node\n   */\n  public async runSubNodesLayout(subNodes: NodeList<LkNodeData, LkEdgeData>): Promise<void> {\n    if (subNodes.size === 0 || subNodes.size === 1) {\n      return;\n    }\n\n    const noEdges = subNodes.getAdjacentEdges({bothExtremities: true}).size === 0;\n    if (noEdges) {\n      await this._runCirclePack(subNodes);\n    } else {\n      await this._runForceLayout(subNodes);\n    }\n  }\n\n  /**\n   * Get the virtual nodes of the transformation\n   * @private\n   */\n  public getVirtualNodesOfTransformation(): NodeList<LkNodeData, LkEdgeData> {\n    // @ts-ignore getContext exists on the transformation but hidden by the types\n    return this.transformation.getContext().metaNodes;\n  }\n\n  /**\n   * Set the node group pin\n   * @param nodeGroups object containing the node group id and the layoutable attribute\n   */\n  public async setNodeGroupPin(nodeGroups: IVizNodeGroupInfo[]): Promise<void> {\n    this._ogma\n      .getNodes()\n      .filter((node) => node.isVirtual())\n      .forEach((node) => {\n        const nodeGroupInfo = nodeGroups.find(\n          (nodeGroup) => nodeGroup.id === node.getData('nodeGroupId')\n        );\n        if (nodeGroupInfo !== undefined) {\n          void node.setAttribute('layoutable', nodeGroupInfo.attributes.layoutable ?? false);\n        }\n      });\n  }\n\n  /**\n   * Return the caption of a virtual node\n   * @param node reference to the virtual node\n   */\n  private _getNodeGroupingCaption(node: Node<LkNodeData> | undefined): string | undefined {\n    // TODO: Normally there is no need to check if getSubNodes return a value, Ogma issue\n    //https://github.com/Linkurious/ogma/issues/3876\n    if (node !== undefined && node.isVirtual() && node.getSubNodes()?.get(0) !== undefined) {\n      // get the property value of the first node of the group (all nodes share the same property value)\n      const lkPropertyValue = node\n        .getSubNodes()!\n        .get(0)\n        .getData(['properties', this.groupRule!.groupingOptions.propertyKey]);\n      const propertyValue = Tools.getValueFromLkProperty(lkPropertyValue);\n      const size = node.getSubNodes()!.filter((e) => !e.hasClass('filtered')).size;\n      return `${propertyValue} (${size})`;\n    }\n  }\n\n  /**\n   * Run the circle pack layout on the subnodes\n   * @param subNodes\n   */\n  private async _runCirclePack(subNodes: NodeList<LkNodeData, LkEdgeData>): Promise<void> {\n    await this._ogma.algorithms.circlePack({\n      nodes: subNodes,\n      margin: 10,\n      sort: 'asc'\n    });\n  }\n\n  private async _runForceLayout(subNodes: NodeList<LkNodeData, LkEdgeData>): Promise<void> {\n    await this._ogma.layouts.force({\n      nodes: subNodes,\n      ...FORCE_LAYOUT_CONFIG\n    });\n  }\n\n  private _isRuleNotApplicableToNode(node: Node<LkNodeData>): boolean {\n    const propertyValue = node.getData([\n      'properties',\n      this.groupRule?.groupingOptions.propertyKey ?? ''\n    ]);\n    return (\n      // if the group rule is not defined\n      this.groupRule === undefined ||\n      // if rule is applied to a different category\n      this.groupRule.groupingOptions.itemTypes.every(\n        (itemType) => !node.getData('categories').includes(itemType)\n      ) ||\n      // if the property value is not defined\n      !Tools.isDefined(propertyValue) ||\n      // if the property value is missing\n      (typeof propertyValue === 'object' && (propertyValue as MissingValue).status === 'missing')\n    );\n  }\n\n  /**\n   * Unpin list of nodes\n   * @param nodes\n   * @private\n   */\n  private async _unpinNodes(nodes: Array<NodeList | null>): Promise<void> {\n    await Promise.all(\n      nodes.map((nodeList) => {\n        if (nodeList !== null) {\n          return nodeList.setAttribute('layoutable', true);\n        }\n      })\n    );\n  }\n\n  /**\n   * Get all the raw nodes part of the transformation\n   * @private\n   */\n  private _getAllTransformationRawNodes(): Array<NodeList | null> {\n    const virtualNodes = this.getVirtualNodesOfTransformation();\n    return virtualNodes.getSubNodes();\n  }\n\n  private _findGroupingPropertyValue(node: Node<LkNodeData>): string {\n    const propertyValue = node.getData([\n      'properties',\n      this.groupRule?.groupingOptions.propertyKey ?? ''\n    ]);\n    return `${Tools.getValueFromLkProperty(propertyValue)}`;\n  }\n\n  /**\n   * Return a hashed string that represents the group id\n   */\n  private _findNodeGroupId(nodes: NodeList<LkNodeData, LkEdgeData>): string {\n    const propertyValue = this._findGroupingPropertyValue(nodes.get(0));\n    return sha1(\n      `${this.groupRule?.name}-${this.groupRule?.groupingOptions.itemTypes.join(\n        '-'\n      )}-${propertyValue}`\n    );\n  }\n}\n"]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@linkurious/ogma-linkurious-parser",
-  "version": "4.1.4",
+  "version": "4.1.6",
   "author": "Linkurious SAS",
   "description": "Parse and load a Linkurious visualization in Ogma with one line of code ",
   "files": [
@@ -54,7 +54,7 @@
   },
   "devDependencies": {
     "@linkurious/ogma": "5.1.1",
-    "@linkurious/rest-client": "4.1.4",
+    "@linkurious/rest-client": "4.1.6",
     "@rollup/plugin-buble": "0.21.3",
     "@rollup/plugin-commonjs": "17.0.0",
     "@rollup/plugin-json": "4.1.0",