@dxos/react-ui-graph 0.8.4-main.cb12b3f963 → 0.8.4-main.d05539e30a

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (60) hide show
  1. package/LICENSE +102 -5
  2. package/dist/lib/browser/index.mjs +903 -285
  3. package/dist/lib/browser/index.mjs.map +4 -4
  4. package/dist/lib/browser/meta.json +1 -1
  5. package/dist/lib/node-esm/index.mjs +903 -285
  6. package/dist/lib/node-esm/index.mjs.map +4 -4
  7. package/dist/lib/node-esm/meta.json +1 -1
  8. package/dist/types/src/components/Graph/Graph.d.ts +6 -2
  9. package/dist/types/src/components/Graph/Graph.d.ts.map +1 -1
  10. package/dist/types/src/components/Graph/Graph.stories.d.ts +3 -3
  11. package/dist/types/src/components/Graph/Graph.stories.d.ts.map +1 -1
  12. package/dist/types/src/components/Mesh/Mesh.d.ts.map +1 -1
  13. package/dist/types/src/components/Mesh/Mesh.stories.d.ts.map +1 -1
  14. package/dist/types/src/components/SVG/Root.d.ts +4 -0
  15. package/dist/types/src/components/SVG/Root.d.ts.map +1 -1
  16. package/dist/types/src/graph/projector/graph-bundle-projector.d.ts +47 -0
  17. package/dist/types/src/graph/projector/graph-bundle-projector.d.ts.map +1 -0
  18. package/dist/types/src/graph/projector/graph-cluster-projector.d.ts +60 -0
  19. package/dist/types/src/graph/projector/graph-cluster-projector.d.ts.map +1 -0
  20. package/dist/types/src/graph/projector/graph-force-projector.d.ts.map +1 -1
  21. package/dist/types/src/graph/projector/graph-hierarchical-projector.d.ts.map +1 -1
  22. package/dist/types/src/graph/projector/graph-lattice-projector.d.ts +23 -0
  23. package/dist/types/src/graph/projector/graph-lattice-projector.d.ts.map +1 -0
  24. package/dist/types/src/graph/projector/graph-projector.d.ts.map +1 -1
  25. package/dist/types/src/graph/projector/graph-radial-projector.d.ts +6 -0
  26. package/dist/types/src/graph/projector/graph-radial-projector.d.ts.map +1 -1
  27. package/dist/types/src/graph/projector/graph-relational-projector.d.ts.map +1 -1
  28. package/dist/types/src/graph/projector/index.d.ts +3 -0
  29. package/dist/types/src/graph/projector/index.d.ts.map +1 -1
  30. package/dist/types/src/graph/projector/projector.d.ts +10 -1
  31. package/dist/types/src/graph/projector/projector.d.ts.map +1 -1
  32. package/dist/types/src/graph/renderer/graph-renderer.d.ts +21 -1
  33. package/dist/types/src/graph/renderer/graph-renderer.d.ts.map +1 -1
  34. package/dist/types/src/graph/renderer/renderer.d.ts +12 -1
  35. package/dist/types/src/graph/renderer/renderer.d.ts.map +1 -1
  36. package/dist/types/src/graph/types.d.ts +14 -0
  37. package/dist/types/src/graph/types.d.ts.map +1 -1
  38. package/dist/types/src/stories/hooks.stories.d.ts.map +1 -1
  39. package/dist/types/tsconfig.tsbuildinfo +1 -1
  40. package/package.json +18 -18
  41. package/src/components/Graph/Graph.stories.tsx +5 -5
  42. package/src/components/Graph/Graph.tsx +48 -21
  43. package/src/components/Mesh/Mesh.stories.tsx +6 -4
  44. package/src/components/Mesh/Mesh.tsx +43 -35
  45. package/src/components/SVG/Root.tsx +28 -3
  46. package/src/graph/projector/graph-bundle-projector.ts +210 -0
  47. package/src/graph/projector/graph-cluster-projector.ts +325 -0
  48. package/src/graph/projector/graph-force-projector.ts +5 -1
  49. package/src/graph/projector/graph-hierarchical-projector.ts +1 -0
  50. package/src/graph/projector/graph-lattice-projector.ts +86 -0
  51. package/src/graph/projector/graph-projector.ts +7 -0
  52. package/src/graph/projector/graph-radial-projector.ts +30 -2
  53. package/src/graph/projector/graph-relational-projector.ts +1 -0
  54. package/src/graph/projector/index.ts +3 -0
  55. package/src/graph/projector/projector.ts +12 -3
  56. package/src/graph/renderer/graph-renderer.ts +172 -32
  57. package/src/graph/renderer/renderer.ts +15 -4
  58. package/src/graph/types.ts +14 -0
  59. package/src/stories/hooks.stories.tsx +6 -1
  60. package/styles/graph.css +51 -2
@@ -13,8 +13,19 @@ export declare abstract class Renderer<LAYOUT, OPTIONS extends RendererOptions>
13
13
  protected readonly _options?: OPTIONS;
14
14
  constructor(_context: SVGContext, _root: RefObject<SVGGElement>, options?: Partial<OPTIONS>);
15
15
  get context(): SVGContext;
16
- get root(): SVGGElement;
16
+ /**
17
+ * Returns the SVG group root if mounted.
18
+ * The ref may be null between mount/unmount cycles or before the SVG container has sized.
19
+ * Callers should treat null as "skip this render" rather than as an error.
20
+ */
21
+ get root(): SVGGElement | null;
17
22
  get options(): OPTIONS;
18
23
  abstract render(layout: LAYOUT): void;
24
+ /**
25
+ * Fast path invoked when only positions changed.
26
+ * Default falls back to a full `render`; subclasses can override to skip
27
+ * enter/exit joins and attribute callbacks for per-tick updates.
28
+ */
29
+ applyPositions(layout: LAYOUT): void;
19
30
  }
20
31
  //# sourceMappingURL=renderer.d.ts.map
@@ -1 +1 @@
1
- {"version":3,"file":"renderer.d.ts","sourceRoot":"","sources":["../../../../../src/graph/renderer/renderer.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,KAAK,SAAS,EAAE,MAAM,OAAO,CAAC;AAIvC,OAAO,EAAE,KAAK,UAAU,EAAE,MAAM,aAAa,CAAC;AAC9C,OAAO,EAAE,KAAK,UAAU,EAAqB,MAAM,UAAU,CAAC;AAE9D,MAAM,MAAM,eAAe,CAAC,CAAC,GAAG,GAAG,IAAI;IACrC,UAAU,EAAE,UAAU,CAAC;CACxB,GAAG,CAAC,CAAC;AAEN;;GAEG;AACH,8BAAsB,QAAQ,CAAC,MAAM,EAAE,OAAO,SAAS,eAAe;IAIlE,SAAS,CAAC,QAAQ,CAAC,QAAQ,EAAE,UAAU;IACvC,SAAS,CAAC,QAAQ,CAAC,KAAK,EAAE,SAAS,CAAC,WAAW,CAAC;IAJlD,SAAS,CAAC,QAAQ,CAAC,QAAQ,CAAC,EAAE,OAAO,CAAC;IAEtC,YACqB,QAAQ,EAAE,UAAU,EACpB,KAAK,EAAE,SAAS,CAAC,WAAW,CAAC,EAChD,OAAO,CAAC,EAAE,OAAO,CAAC,OAAO,CAAC,EAQ3B;IAED,IAAI,OAAO,IAAI,UAAU,CAExB;IAED,IAAI,IAAI,IAAI,WAAW,CAGtB;IAED,IAAI,OAAO,YAEV;IAED,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;CACvC"}
1
+ {"version":3,"file":"renderer.d.ts","sourceRoot":"","sources":["../../../../../src/graph/renderer/renderer.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,KAAK,SAAS,EAAE,MAAM,OAAO,CAAC;AAEvC,OAAO,EAAE,KAAK,UAAU,EAAE,MAAM,aAAa,CAAC;AAC9C,OAAO,EAAE,KAAK,UAAU,EAAqB,MAAM,UAAU,CAAC;AAE9D,MAAM,MAAM,eAAe,CAAC,CAAC,GAAG,GAAG,IAAI;IACrC,UAAU,EAAE,UAAU,CAAC;CACxB,GAAG,CAAC,CAAC;AAEN;;GAEG;AACH,8BAAsB,QAAQ,CAAC,MAAM,EAAE,OAAO,SAAS,eAAe;IAIlE,SAAS,CAAC,QAAQ,CAAC,QAAQ,EAAE,UAAU;IACvC,SAAS,CAAC,QAAQ,CAAC,KAAK,EAAE,SAAS,CAAC,WAAW,CAAC;IAJlD,SAAS,CAAC,QAAQ,CAAC,QAAQ,CAAC,EAAE,OAAO,CAAC;IAEtC,YACqB,QAAQ,EAAE,UAAU,EACpB,KAAK,EAAE,SAAS,CAAC,WAAW,CAAC,EAChD,OAAO,CAAC,EAAE,OAAO,CAAC,OAAO,CAAC,EAQ3B;IAED,IAAI,OAAO,IAAI,UAAU,CAExB;IAED;;;;OAIG;IACH,IAAI,IAAI,IAAI,WAAW,GAAG,IAAI,CAE7B;IAED,IAAI,OAAO,YAEV;IAED,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IAEtC;;;;OAIG;IACH,cAAc,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAEnC;CACF"}
@@ -18,6 +18,14 @@ export type GraphLayoutNode<NodeData = any> = {
18
18
  type?: string;
19
19
  order?: number;
20
20
  data?: NodeData;
21
+ /** Human-readable label. Synthetic nodes (e.g. cluster root / group) carry this so
22
+ * consumer renderNode callbacks can label them without parsing internal id formats. */
23
+ label?: string;
24
+ /** When true the node remains in the layout but is rendered with opacity 0 and no
25
+ * pointer events — used by the cluster's collapse animation so hidden leaves can
26
+ * tween to their parent's position rather than popping out, and tween back when the
27
+ * parent is re-expanded. */
28
+ hidden?: boolean;
21
29
  x?: number;
22
30
  y?: number;
23
31
  r?: number;
@@ -37,6 +45,12 @@ export type GraphLayoutEdge<NodeData = any, EdgeData = any> = {
37
45
  target: GraphLayoutNode<NodeData>;
38
46
  data?: EdgeData;
39
47
  linkForce?: boolean;
48
+ /**
49
+ * Precomputed SVG `d` attribute. When set, the renderer uses this instead of
50
+ * deriving a straight-line path from `source/target` positions. Lets projectors
51
+ * own edge geometry (e.g. radial elbows, bundled curves) without renderer changes.
52
+ */
53
+ path?: string;
40
54
  classes?: {
41
55
  path?: string;
42
56
  };
@@ -1 +1 @@
1
- {"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../src/graph/types.ts"],"names":[],"mappings":"AASA,OAAO,EAAE,KAAK,KAAK,EAAE,MAAM,aAAa,CAAC;AAGzC,OAAO,EAAE,KAAK,KAAK,EAAE,MAAM,SAAS,CAAC;AAErC,MAAM,MAAM,UAAU,CAAC,CAAC,GAAG,GAAG,IAAI,CAAC,IAAI,EAAE,CAAC,KAAK,MAAM,CAAC;AAEtD,eAAO,MAAM,iBAAiB,EAAE,UAG/B,CAAC;AAEF,eAAO,MAAM,UAAU,EAAE,KAAK,CAAC,GAG9B,CAAC;AAOF,MAAM,MAAM,UAAU,GAAG;IACvB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,EAAE,EAAE,MAAM,CAAC;IACX,EAAE,EAAE,MAAM,CAAC;IACX,CAAC,EAAE,MAAM,CAAC;IACV,OAAO,CAAC,EAAE;QACR,MAAM,CAAC,EAAE,MAAM,CAAC;KACjB,CAAC;CACH,CAAC;AAEF,MAAM,MAAM,eAAe,CAAC,QAAQ,GAAG,GAAG,IAAI;IAC5C,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,IAAI,CAAC,EAAE,QAAQ,CAAC;IAChB,CAAC,CAAC,EAAE,MAAM,CAAC;IACX,CAAC,CAAC,EAAE,MAAM,CAAC;IACX,CAAC,CAAC,EAAE,MAAM,CAAC;IACX,OAAO,CAAC,EAAE;QACR,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,IAAI,CAAC,EAAE,MAAM,CAAC;KACf,CAAC;IACF,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,IAAI,CAAC,EAAE,KAAK,CAAC;CACd,CAAC;AAEF,MAAM,MAAM,eAAe,CAAC,QAAQ,GAAG,GAAG,EAAE,QAAQ,GAAG,GAAG,IAAI;IAC5D,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,eAAe,CAAC,QAAQ,CAAC,CAAC;IAClC,MAAM,EAAE,eAAe,CAAC,QAAQ,CAAC,CAAC;IAClC,IAAI,CAAC,EAAE,QAAQ,CAAC;IAChB,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,OAAO,CAAC,EAAE;QACR,IAAI,CAAC,EAAE,MAAM,CAAC;KACf,CAAC;CACH,CAAC;AAEF,MAAM,MAAM,WAAW,CAAC,QAAQ,GAAG,GAAG,EAAE,QAAQ,GAAG,GAAG,IAAI;IACxD,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,MAAM,CAAC,EAAE,UAAU,EAAE,CAAC;IACtB,KAAK,EAAE;QACL,KAAK,EAAE,eAAe,CAAC,QAAQ,CAAC,EAAE,CAAC;QACnC,KAAK,EAAE,eAAe,CAAC,QAAQ,EAAE,QAAQ,CAAC,EAAE,CAAC;KAC9C,CAAC;CACH,CAAC"}
1
+ {"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../src/graph/types.ts"],"names":[],"mappings":"AASA,OAAO,EAAE,KAAK,KAAK,EAAE,MAAM,aAAa,CAAC;AAGzC,OAAO,EAAE,KAAK,KAAK,EAAE,MAAM,SAAS,CAAC;AAErC,MAAM,MAAM,UAAU,CAAC,CAAC,GAAG,GAAG,IAAI,CAAC,IAAI,EAAE,CAAC,KAAK,MAAM,CAAC;AAEtD,eAAO,MAAM,iBAAiB,EAAE,UAG/B,CAAC;AAEF,eAAO,MAAM,UAAU,EAAE,KAAK,CAAC,GAG9B,CAAC;AAOF,MAAM,MAAM,UAAU,GAAG;IACvB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,EAAE,EAAE,MAAM,CAAC;IACX,EAAE,EAAE,MAAM,CAAC;IACX,CAAC,EAAE,MAAM,CAAC;IACV,OAAO,CAAC,EAAE;QACR,MAAM,CAAC,EAAE,MAAM,CAAC;KACjB,CAAC;CACH,CAAC;AAEF,MAAM,MAAM,eAAe,CAAC,QAAQ,GAAG,GAAG,IAAI;IAC5C,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,IAAI,CAAC,EAAE,QAAQ,CAAC;IAChB;2FACuF;IACvF,KAAK,CAAC,EAAE,MAAM,CAAC;IACf;;;gCAG4B;IAC5B,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,CAAC,CAAC,EAAE,MAAM,CAAC;IACX,CAAC,CAAC,EAAE,MAAM,CAAC;IACX,CAAC,CAAC,EAAE,MAAM,CAAC;IACX,OAAO,CAAC,EAAE;QACR,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,IAAI,CAAC,EAAE,MAAM,CAAC;KACf,CAAC;IACF,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,IAAI,CAAC,EAAE,KAAK,CAAC;CACd,CAAC;AAEF,MAAM,MAAM,eAAe,CAAC,QAAQ,GAAG,GAAG,EAAE,QAAQ,GAAG,GAAG,IAAI;IAC5D,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,eAAe,CAAC,QAAQ,CAAC,CAAC;IAClC,MAAM,EAAE,eAAe,CAAC,QAAQ,CAAC,CAAC;IAClC,IAAI,CAAC,EAAE,QAAQ,CAAC;IAChB,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB;;;;OAIG;IACH,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE;QACR,IAAI,CAAC,EAAE,MAAM,CAAC;KACf,CAAC;CACH,CAAC;AAEF,MAAM,MAAM,WAAW,CAAC,QAAQ,GAAG,GAAG,EAAE,QAAQ,GAAG,GAAG,IAAI;IACxD,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,MAAM,CAAC,EAAE,UAAU,EAAE,CAAC;IACtB,KAAK,EAAE;QACL,KAAK,EAAE,eAAe,CAAC,QAAQ,CAAC,EAAE,CAAC;QACnC,KAAK,EAAE,eAAe,CAAC,QAAQ,EAAE,QAAQ,CAAC,EAAE,CAAC;KAC9C,CAAC;CACH,CAAC"}
@@ -1 +1 @@
1
- {"version":3,"file":"hooks.stories.d.ts","sourceRoot":"","sources":["../../../../src/stories/hooks.stories.tsx"],"names":[],"mappings":"AAIA,OAAO,wBAAwB,CAAC;AAGhC,OAAO,EAAa,KAAK,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AAEjE,OAAO,KAAK,EAAE,EAAE,KAAK,iBAAiB,EAA0C,MAAM,OAAO,CAAC;AAG9F,OAAO,EAAE,KAAK,KAAK,EAAE,MAAM,aAAa,CAAC;AAMzC,OAAO,EAEL,KAAK,0BAA0B,EAOhC,MAAM,UAAU,CAAC;AAElB,OAAO,EAAkB,KAAK,QAAQ,EAAkC,MAAM,YAAY,CAAC;AAE3F,KAAK,cAAc,GAAG,iBAAiB,CAAC;IACtC,KAAK,EAAE,MAAM,KAAK,CAAC,KAAK,CAAC,QAAQ,EAAE,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IACnD,gBAAgB,CAAC,EAAE,0BAA0B,CAAC;IAC9C,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,IAAI,CAAC,EAAE,OAAO,CAAC;CAChB,CAAC,CAAC;AAuHH,QAAA,MAAM,IAAI;;qCAXoC,cAAc;;;QAgBxD,MAAM;;CAE2B,CAAC;eAEvB,IAAI;AAEnB,KAAK,KAAK,GAAG,QAAQ,CAAC,OAAO,IAAI,CAAC,CAAC;AAEnC,eAAO,MAAM,OAAO,EAAE,KAuBrB,CAAC;AAEF,eAAO,MAAM,OAAO,EAAE,KAuBrB,CAAC"}
1
+ {"version":3,"file":"hooks.stories.d.ts","sourceRoot":"","sources":["../../../../src/stories/hooks.stories.tsx"],"names":[],"mappings":"AAIA,OAAO,wBAAwB,CAAC;AAGhC,OAAO,EAAa,KAAK,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AAEjE,OAAO,KAAK,EAAE,EAAE,KAAK,iBAAiB,EAA0C,MAAM,OAAO,CAAC;AAG9F,OAAO,EAAE,KAAK,KAAK,EAAE,MAAM,aAAa,CAAC;AAMzC,OAAO,EAEL,KAAK,0BAA0B,EAOhC,MAAM,UAAU,CAAC;AAElB,OAAO,EAAkB,KAAK,QAAQ,EAAkC,MAAM,YAAY,CAAC;AAE3F,KAAK,cAAc,GAAG,iBAAiB,CAAC;IACtC,KAAK,EAAE,MAAM,KAAK,CAAC,KAAK,CAAC,QAAQ,EAAE,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IACnD,gBAAgB,CAAC,EAAE,0BAA0B,CAAC;IAC9C,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,IAAI,CAAC,EAAE,OAAO,CAAC;CAChB,CAAC,CAAC;AA4HH,QAAA,MAAM,IAAI;;qCAXoC,cAAc;;;QAgBxD,MAAM;;CAE2B,CAAC;eAEvB,IAAI;AAEnB,KAAK,KAAK,GAAG,QAAQ,CAAC,OAAO,IAAI,CAAC,CAAC;AAEnC,eAAO,MAAM,OAAO,EAAE,KAuBrB,CAAC;AAEF,eAAO,MAAM,OAAO,EAAE,KAuBrB,CAAC"}