@dxos/react-ui-graph 0.8.4-main.84f28bd → 0.8.4-main.8baae0fced

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 (134) hide show
  1. package/LICENSE +102 -5
  2. package/README.md +5 -7
  3. package/dist/lib/browser/chunk-EASNZZ7B.mjs +52 -0
  4. package/dist/lib/browser/chunk-EASNZZ7B.mjs.map +7 -0
  5. package/dist/lib/browser/index.mjs +1965 -560
  6. package/dist/lib/browser/index.mjs.map +4 -4
  7. package/dist/lib/browser/meta.json +1 -1
  8. package/dist/lib/browser/testing/index.mjs +16 -16
  9. package/dist/lib/browser/testing/index.mjs.map +3 -3
  10. package/dist/lib/node-esm/chunk-JSE2X4ML.mjs +54 -0
  11. package/dist/lib/node-esm/chunk-JSE2X4ML.mjs.map +7 -0
  12. package/dist/lib/node-esm/index.mjs +1965 -560
  13. package/dist/lib/node-esm/index.mjs.map +4 -4
  14. package/dist/lib/node-esm/meta.json +1 -1
  15. package/dist/lib/node-esm/testing/index.mjs +16 -16
  16. package/dist/lib/node-esm/testing/index.mjs.map +3 -3
  17. package/dist/types/src/components/Graph/Graph.d.ts +9 -6
  18. package/dist/types/src/components/Graph/Graph.d.ts.map +1 -1
  19. package/dist/types/src/components/Graph/Graph.stories.d.ts +20 -11
  20. package/dist/types/src/components/Graph/Graph.stories.d.ts.map +1 -1
  21. package/dist/types/src/components/Mesh/Mesh.d.ts.map +1 -1
  22. package/dist/types/src/components/Mesh/Mesh.stories.d.ts +9 -5
  23. package/dist/types/src/components/Mesh/Mesh.stories.d.ts.map +1 -1
  24. package/dist/types/src/components/SVG/Grid.d.ts.map +1 -1
  25. package/dist/types/src/components/SVG/Markers.d.ts.map +1 -1
  26. package/dist/types/src/components/SVG/Root.d.ts +8 -4
  27. package/dist/types/src/components/SVG/Root.d.ts.map +1 -1
  28. package/dist/types/src/components/SVG/SVG.d.ts +14 -17
  29. package/dist/types/src/components/SVG/SVG.d.ts.map +1 -1
  30. package/dist/types/src/components/SVG/Svg.stories.d.ts +11 -9
  31. package/dist/types/src/components/SVG/Svg.stories.d.ts.map +1 -1
  32. package/dist/types/src/components/SVG/Zoom.d.ts.map +1 -1
  33. package/dist/types/src/fx/fx.stories.d.ts +16 -15
  34. package/dist/types/src/fx/fx.stories.d.ts.map +1 -1
  35. package/dist/types/src/fx/pulsar.d.ts.map +1 -1
  36. package/dist/types/src/graph/markers.d.ts.map +1 -1
  37. package/dist/types/src/graph/projector/graph-bundle-projector.d.ts +47 -0
  38. package/dist/types/src/graph/projector/graph-bundle-projector.d.ts.map +1 -0
  39. package/dist/types/src/graph/projector/graph-cluster-projector.d.ts +60 -0
  40. package/dist/types/src/graph/projector/graph-cluster-projector.d.ts.map +1 -0
  41. package/dist/types/src/graph/projector/graph-drag.d.ts +1 -1
  42. package/dist/types/src/graph/projector/graph-drag.d.ts.map +1 -1
  43. package/dist/types/src/graph/projector/graph-force-projector.d.ts +2 -2
  44. package/dist/types/src/graph/projector/graph-force-projector.d.ts.map +1 -1
  45. package/dist/types/src/graph/projector/graph-forces.d.ts.map +1 -1
  46. package/dist/types/src/graph/projector/graph-hierarchical-projector.d.ts +2 -2
  47. package/dist/types/src/graph/projector/graph-hierarchical-projector.d.ts.map +1 -1
  48. package/dist/types/src/graph/projector/graph-lattice-projector.d.ts +23 -0
  49. package/dist/types/src/graph/projector/graph-lattice-projector.d.ts.map +1 -0
  50. package/dist/types/src/graph/projector/graph-projector.d.ts +4 -4
  51. package/dist/types/src/graph/projector/graph-projector.d.ts.map +1 -1
  52. package/dist/types/src/graph/projector/graph-radial-projector.d.ts +8 -2
  53. package/dist/types/src/graph/projector/graph-radial-projector.d.ts.map +1 -1
  54. package/dist/types/src/graph/projector/graph-relational-projector.d.ts +2 -2
  55. package/dist/types/src/graph/projector/graph-relational-projector.d.ts.map +1 -1
  56. package/dist/types/src/graph/projector/index.d.ts +3 -0
  57. package/dist/types/src/graph/projector/index.d.ts.map +1 -1
  58. package/dist/types/src/graph/projector/projector.d.ts +10 -1
  59. package/dist/types/src/graph/projector/projector.d.ts.map +1 -1
  60. package/dist/types/src/graph/renderer/bullets.d.ts.map +1 -1
  61. package/dist/types/src/graph/renderer/graph-renderer.d.ts +22 -2
  62. package/dist/types/src/graph/renderer/graph-renderer.d.ts.map +1 -1
  63. package/dist/types/src/graph/renderer/renderer.d.ts +12 -1
  64. package/dist/types/src/graph/renderer/renderer.d.ts.map +1 -1
  65. package/dist/types/src/graph/types.d.ts +15 -1
  66. package/dist/types/src/graph/types.d.ts.map +1 -1
  67. package/dist/types/src/hooks/useGrid.d.ts.map +1 -1
  68. package/dist/types/src/hooks/useStateRef.d.ts.map +1 -1
  69. package/dist/types/src/hooks/useSvgContext.d.ts.map +1 -1
  70. package/dist/types/src/hooks/useZoom.d.ts.map +1 -1
  71. package/dist/types/src/stories/hooks.stories.d.ts +14 -9
  72. package/dist/types/src/stories/hooks.stories.d.ts.map +1 -1
  73. package/dist/types/src/testing/data.d.ts +5 -5
  74. package/dist/types/src/testing/data.d.ts.map +1 -1
  75. package/dist/types/src/testing/hooks.d.ts +2 -16
  76. package/dist/types/src/testing/hooks.d.ts.map +1 -1
  77. package/dist/types/src/testing/model.d.ts +4 -8
  78. package/dist/types/src/testing/model.d.ts.map +1 -1
  79. package/dist/types/src/util/events.d.ts.map +1 -1
  80. package/dist/types/src/util/fraction.d.ts +1 -1
  81. package/dist/types/src/util/fraction.d.ts.map +1 -1
  82. package/dist/types/src/util/index.d.ts +2 -2
  83. package/dist/types/src/util/index.d.ts.map +1 -1
  84. package/dist/types/src/util/points.d.ts.map +1 -1
  85. package/dist/types/src/util/scale.d.ts.map +1 -1
  86. package/dist/types/src/util/screen.d.ts +1 -1
  87. package/dist/types/src/util/screen.d.ts.map +1 -1
  88. package/dist/types/src/util/vector.d.ts +1 -1
  89. package/dist/types/src/util/vector.d.ts.map +1 -1
  90. package/dist/types/tsconfig.tsbuildinfo +1 -1
  91. package/package.json +33 -35
  92. package/src/components/Graph/Graph.stories.tsx +73 -69
  93. package/src/components/Graph/Graph.tsx +60 -25
  94. package/src/components/Mesh/Mesh.stories.tsx +16 -13
  95. package/src/components/Mesh/Mesh.tsx +44 -36
  96. package/src/components/SVG/Grid.tsx +2 -2
  97. package/src/components/SVG/Markers.tsx +1 -1
  98. package/src/components/SVG/Root.tsx +41 -9
  99. package/src/components/SVG/SVG.tsx +13 -4
  100. package/src/components/SVG/Svg.stories.tsx +23 -19
  101. package/src/components/SVG/Zoom.tsx +1 -1
  102. package/src/fx/fx.stories.tsx +18 -15
  103. package/src/graph/projector/graph-bundle-projector.ts +210 -0
  104. package/src/graph/projector/graph-cluster-projector.ts +325 -0
  105. package/src/graph/projector/graph-drag.ts +1 -1
  106. package/src/graph/projector/graph-force-projector.ts +8 -4
  107. package/src/graph/projector/graph-forces.ts +1 -1
  108. package/src/graph/projector/graph-hierarchical-projector.ts +5 -4
  109. package/src/graph/projector/graph-lattice-projector.ts +86 -0
  110. package/src/graph/projector/graph-projector.ts +12 -5
  111. package/src/graph/projector/graph-radial-projector.ts +33 -5
  112. package/src/graph/projector/graph-relational-projector.ts +5 -4
  113. package/src/graph/projector/index.ts +3 -0
  114. package/src/graph/projector/projector.ts +13 -4
  115. package/src/graph/renderer/bullets.ts +1 -1
  116. package/src/graph/renderer/graph-renderer.ts +178 -32
  117. package/src/graph/renderer/renderer.ts +16 -5
  118. package/src/graph/types.ts +15 -1
  119. package/src/hooks/useStateRef.ts +1 -1
  120. package/src/hooks/useZoom.ts +1 -1
  121. package/src/stories/hooks.stories.tsx +49 -37
  122. package/src/testing/data.ts +14 -14
  123. package/src/testing/hooks.ts +5 -5
  124. package/src/testing/model.ts +6 -6
  125. package/src/util/fraction.ts +1 -1
  126. package/src/util/index.ts +2 -2
  127. package/src/util/screen.test.ts +1 -1
  128. package/src/util/screen.ts +1 -1
  129. package/src/util/vector.ts +1 -1
  130. package/styles/graph.css +341 -43
  131. package/dist/lib/browser/chunk-4C5Z5DAE.mjs +0 -979
  132. package/dist/lib/browser/chunk-4C5Z5DAE.mjs.map +0 -7
  133. package/dist/lib/node-esm/chunk-AK6HNA4R.mjs +0 -981
  134. package/dist/lib/node-esm/chunk-AK6HNA4R.mjs.map +0 -7
@@ -1 +1 @@
1
- {"version":3,"file":"Svg.stories.d.ts","sourceRoot":"","sources":["../../../../../src/components/SVG/Svg.stories.tsx"],"names":[],"mappings":"AAIA,OAAO,aAAa,CAAC;AAErB,OAAO,KAAiB,MAAM,OAAO,CAAC;AAEtC,OAAO,EAAE,KAAK,IAAI,EAAyB,MAAM,uBAAuB,CAAC;AAKzE,OAAO,2BAA2B,CAAC;AAEnC,KAAK,cAAc,GAAG;IACpB,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,IAAI,CAAC,EAAE,OAAO,CAAC;CAChB,CAAC;AAYF,QAAA,MAAM,SAAS,GAAI,SAAS,cAAc,sBAYzC,CAAC;AAEF,QAAA,MAAM,IAAI,EAAE,IAAI,CAAC,OAAO,SAAS,CAIhC,CAAC;AAEF,eAAe,IAAI,CAAC;AAEpB,eAAO,MAAM,OAAO;;;;CAInB,CAAC"}
1
+ {"version":3,"file":"Svg.stories.d.ts","sourceRoot":"","sources":["../../../../../src/components/SVG/Svg.stories.tsx"],"names":[],"mappings":"AAIA,OAAO,2BAA2B,CAAC;AAEnC,OAAO,EAAa,KAAK,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AACjE,OAAO,KAAiB,MAAM,OAAO,CAAC;AAOtC,KAAK,cAAc,GAAG;IACpB,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,IAAI,CAAC,EAAE,OAAO,CAAC;CAChB,CAAC;AA0BF,QAAA,MAAM,IAAI;;oBAVmB,cAAc;;;QAevC,MAAM;;CAE2B,CAAC;eAEvB,IAAI;AAEnB,KAAK,KAAK,GAAG,QAAQ,CAAC,OAAO,IAAI,CAAC,CAAC;AAEnC,eAAO,MAAM,OAAO,EAAE,KAIrB,CAAC"}
@@ -1 +1 @@
1
- {"version":3,"file":"Zoom.d.ts","sourceRoot":"","sources":["../../../../../src/components/SVG/Zoom.tsx"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,EAAE,KAAK,SAAS,EAAiB,MAAM,OAAO,CAAC;AAE7D,OAAO,EAAW,KAAK,UAAU,EAAE,MAAM,aAAa,CAAC;AAEvD,MAAM,MAAM,SAAS,GAAG;IACtB,MAAM,CAAC,EAAE,UAAU,CAAC;IACpB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,EAAE,SAAS,CAAC;CACtB,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,IAAI,8DAA0C,SAAS,uBASlE,CAAC"}
1
+ {"version":3,"file":"Zoom.d.ts","sourceRoot":"","sources":["../../../../../src/components/SVG/Zoom.tsx"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,EAAE,KAAK,SAAS,EAAiB,MAAM,OAAO,CAAC;AAE7D,OAAO,EAAE,KAAK,UAAU,EAAW,MAAM,aAAa,CAAC;AAEvD,MAAM,MAAM,SAAS,GAAG;IACtB,MAAM,CAAC,EAAE,UAAU,CAAC;IACpB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,EAAE,SAAS,CAAC;CACtB,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,IAAI,8DAA0C,SAAS,uBASlE,CAAC"}
@@ -1,19 +1,20 @@
1
- import '@dxos-theme';
2
- import { type Meta } from '@storybook/react-vite';
3
1
  import '../../styles/graph.css';
4
- declare const meta: Meta;
5
- export default meta;
6
- export declare const DefaultPulse: {
7
- args: {
8
- count: number;
9
- };
10
- };
11
- export declare const RapidPulse: {
12
- args: {
13
- count: number;
14
- duration: number;
15
- period: number;
16
- ratio: number;
2
+ import { type StoryObj } from '@storybook/react-vite';
3
+ import React from 'react';
4
+ import { Pulsar } from './pulsar';
5
+ type DefaultStoryProps = {
6
+ count: number;
7
+ } & Pulsar.Options;
8
+ declare const meta: {
9
+ title: string;
10
+ render: (props: DefaultStoryProps) => React.JSX.Element;
11
+ decorators: import("@storybook/react").Decorator[];
12
+ parameters: {
13
+ layout: string;
17
14
  };
18
15
  };
16
+ export default meta;
17
+ type Story = StoryObj<typeof meta>;
18
+ export declare const DefaultPulse: Story;
19
+ export declare const RapidPulse: Story;
19
20
  //# sourceMappingURL=fx.stories.d.ts.map
@@ -1 +1 @@
1
- {"version":3,"file":"fx.stories.d.ts","sourceRoot":"","sources":["../../../../src/fx/fx.stories.tsx"],"names":[],"mappings":"AAIA,OAAO,aAAa,CAAC;AAErB,OAAO,EAAE,KAAK,IAAI,EAAE,MAAM,uBAAuB,CAAC;AAWlD,OAAO,wBAAwB,CAAC;AA6EhC,QAAA,MAAM,IAAI,EAAE,IAIX,CAAC;AAEF,eAAe,IAAI,CAAC;AAEpB,eAAO,MAAM,YAAY;;;;CAIxB,CAAC;AAEF,eAAO,MAAM,UAAU;;;;;;;CAOtB,CAAC"}
1
+ {"version":3,"file":"fx.stories.d.ts","sourceRoot":"","sources":["../../../../src/fx/fx.stories.tsx"],"names":[],"mappings":"AAIA,OAAO,wBAAwB,CAAC;AAEhC,OAAO,EAAa,KAAK,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AAEjE,OAAO,KAA8C,MAAM,OAAO,CAAC;AAOnE,OAAO,EAAE,MAAM,EAAE,MAAM,UAAU,CAAC;AAQlC,KAAK,iBAAiB,GAAG;IACvB,KAAK,EAAE,MAAM,CAAC;CACf,GAAG,MAAM,CAAC,OAAO,CAAC;AAmEnB,QAAA,MAAM,IAAI;;oBAjEmB,iBAAiB;;;QAsE1C,MAAM;;CAE2B,CAAC;eAEvB,IAAI;AAEnB,KAAK,KAAK,GAAG,QAAQ,CAAC,OAAO,IAAI,CAAC,CAAC;AAEnC,eAAO,MAAM,YAAY,EAAE,KAI1B,CAAC;AAEF,eAAO,MAAM,UAAU,EAAE,KAOxB,CAAC"}
@@ -1 +1 @@
1
- {"version":3,"file":"pulsar.d.ts","sourceRoot":"","sources":["../../../../src/fx/pulsar.ts"],"names":[],"mappings":"AAMA,OAAO,EAAE,KAAK,UAAU,EAAE,KAAK,WAAW,EAAE,MAAM,SAAS,CAAC;AAI5D;;GAEG;AACH,yBAAiB,MAAM,CAAC;IACf,MAAM,GAAG,GAAI,OAAO,WAAW,CAAC,WAAW,CAAC,YAA6C,CAAC;IAE1F,MAAM,MAAM,EAAE,UAAU,CAAC,WAAW,CAQ1C,CAAC;IAEK,MAAM,MAAM,EAAE,UAAU,CAAC,WAAW,CAE1C,CAAC;IAEF,KAAY,OAAO,GAAG,aAAa,CAAC;CACrC;AAED,KAAK,aAAa,GAAG;IACnB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB,CAAC"}
1
+ {"version":3,"file":"pulsar.d.ts","sourceRoot":"","sources":["../../../../src/fx/pulsar.ts"],"names":[],"mappings":"AAMA,OAAO,EAAE,KAAK,UAAU,EAAE,KAAK,WAAW,EAAE,MAAM,SAAS,CAAC;AAI5D;;GAEG;AACH,yBAAiB,MAAM,CAAC,CAAC;IAChB,MAAM,GAAG,UAAW,WAAW,CAAC,WAAW,CAAC,YAA6C,CAAC;IAE1F,MAAM,MAAM,EAAE,UAAU,CAAC,WAAW,CAQ1C,CAAC;IAEK,MAAM,MAAM,EAAE,UAAU,CAAC,WAAW,CAE1C,CAAC;IAEF,KAAY,OAAO,GAAG,aAAa,CAAC;CACrC;AAED,KAAK,aAAa,GAAG;IACnB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB,CAAC"}
@@ -1 +1 @@
1
- {"version":3,"file":"markers.d.ts","sourceRoot":"","sources":["../../../../src/graph/markers.ts"],"names":[],"mappings":"AAMA,OAAO,EAAE,KAAK,UAAU,EAAE,MAAM,SAAS,CAAC;AAI1C,MAAM,MAAM,aAAa,GAAG;IAC1B,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB,CAAC;AAsCF;;;;GAIG;AACH,eAAO,MAAM,aAAa,GACvB,gBAAoB,aAAkB,KAAG,UA4BzC,CAAC"}
1
+ {"version":3,"file":"markers.d.ts","sourceRoot":"","sources":["../../../../src/graph/markers.ts"],"names":[],"mappings":"AAMA,OAAO,EAAE,KAAK,UAAU,EAAE,MAAM,SAAS,CAAC;AAI1C,MAAM,MAAM,aAAa,GAAG;IAC1B,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB,CAAC;AAsCF;;;;GAIG;AACH,eAAO,MAAM,aAAa,mBACH,aAAa,KAAQ,UA4BzC,CAAC"}
@@ -0,0 +1,47 @@
1
+ import { type Graph } from '@dxos/graph';
2
+ import { type GraphLayoutNode } from '../types';
3
+ import { GraphRadialProjector, type GraphRadialProjectorOptions } from './graph-radial-projector';
4
+ export type GraphBundleProjectorOptions = GraphRadialProjectorOptions & {
5
+ /** Reserved space around the bundle (screen pixels). */
6
+ margin?: number;
7
+ /** Radius for leaf nodes. Default 4. */
8
+ leafRadius?: number;
9
+ /**
10
+ * Group key for each node — synthetic intermediate nodes are created per unique key
11
+ * to give the bundling layout a routing point (lowest common ancestor) for edges
12
+ * between leaves in different groups. Return `undefined` to attach the node directly
13
+ * to the root (all such leaves bundle through the root).
14
+ */
15
+ groupOf?: (node: GraphLayoutNode) => string | undefined;
16
+ /** Bundling tension passed to `d3.curveBundle.beta`. 0 = straight chord, 1 = max bundled. */
17
+ tension?: number;
18
+ };
19
+ /**
20
+ * Hierarchical edge bundling — Holten 2006 / d3 observable notebook
21
+ * (https://observablehq.com/@d3/hierarchical-edge-bundling).
22
+ *
23
+ * Synthesizes the same root → group → leaf hierarchy as `GraphClusterProjector`, runs
24
+ * d3.cluster to give every node a polar position, but renders ONLY the leaves
25
+ * (root + groups are routing anchors, not visible nodes). Each data edge is replaced
26
+ * with a curve generated by `lineRadial(curveBundle.beta(tension))` over the polar
27
+ * positions of `source.path(target)` — i.e. the chain of ancestors through the lowest
28
+ * common ancestor.
29
+ *
30
+ * Per-frame `onTickFrame` refreshes the leaf endpoints (first + last point of every
31
+ * path) from current cartesian positions so the curves stay glued to leaves during a
32
+ * cross-variant tween (force → bundle, lattice → bundle). Internal ancestor positions
33
+ * are fixed at d3.cluster's final polar layout, which means during the tween curves
34
+ * route through the destination "pivot points" while the leaf endpoints catch up —
35
+ * visually the bundle "snaps into shape" as the leaves arrive.
36
+ */
37
+ export declare class GraphBundleProjector<NodeData = any, Options extends GraphBundleProjectorOptions = any> extends GraphRadialProjector<NodeData, Options> {
38
+ #private;
39
+ protected onUpdate(graph?: Graph.Any): void;
40
+ /**
41
+ * Refresh leaf endpoint polar values from current cartesian so the curve tracks
42
+ * its endpoints during the tween. Internal hierarchy positions stay constant.
43
+ */
44
+ protected onTickFrame(_t: number): void;
45
+ private doBundleLayout;
46
+ }
47
+ //# sourceMappingURL=graph-bundle-projector.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"graph-bundle-projector.d.ts","sourceRoot":"","sources":["../../../../../src/graph/projector/graph-bundle-projector.ts"],"names":[],"mappings":"AAMA,OAAO,EAAE,KAAK,KAAK,EAAE,MAAM,aAAa,CAAC;AAGzC,OAAO,EAAwB,KAAK,eAAe,EAAE,MAAM,UAAU,CAAC;AACtE,OAAO,EAAE,oBAAoB,EAAE,KAAK,2BAA2B,EAAc,MAAM,0BAA0B,CAAC;AAE9G,MAAM,MAAM,2BAA2B,GAAG,2BAA2B,GAAG;IACtE,wDAAwD;IACxD,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,wCAAwC;IACxC,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB;;;;;OAKG;IACH,OAAO,CAAC,EAAE,CAAC,IAAI,EAAE,eAAe,KAAK,MAAM,GAAG,SAAS,CAAC;IACxD,6FAA6F;IAC7F,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB,CAAC;AAgBF;;;;;;;;;;;;;;;;;GAiBG;AACH,qBAAa,oBAAoB,CAC/B,QAAQ,GAAG,GAAG,EACd,OAAO,SAAS,2BAA2B,GAAG,GAAG,CACjD,SAAQ,oBAAoB,CAAC,QAAQ,EAAE,OAAO,CAAC;;IAS/C,UAAmB,QAAQ,CAAC,KAAK,CAAC,EAAE,KAAK,CAAC,GAAG,QAM5C;IAED;;;OAGG;IACH,UAAmB,WAAW,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI,CAe/C;IAED,OAAO,CAAC,cAAc;CA4GvB"}
@@ -0,0 +1,60 @@
1
+ import { type Graph } from '@dxos/graph';
2
+ import { type GraphLayoutNode } from '../types';
3
+ import { GraphRadialProjector, type GraphRadialProjectorOptions } from './graph-radial-projector';
4
+ export type GraphClusterProjectorOptions = GraphRadialProjectorOptions & {
5
+ /** Reserved space around the cluster (screen pixels). */
6
+ margin?: number;
7
+ /** Radius for leaf nodes. Default 4. */
8
+ leafRadius?: number;
9
+ /** Radius for the synthetic group nodes (visible as smaller intermediate dots). Default 3. */
10
+ groupRadius?: number;
11
+ /** Radius for the synthetic root node. Default 5. */
12
+ rootRadius?: number;
13
+ /**
14
+ * Group key for each node — synthetic intermediate nodes are created per unique key,
15
+ * giving a root → group → leaf hierarchy. Return `undefined` to attach the node
16
+ * directly to the root.
17
+ */
18
+ groupOf?: (node: GraphLayoutNode) => string | undefined;
19
+ /** Root id used for the synthetic root node. */
20
+ rootId?: string;
21
+ /** Display label set on the synthetic root node. Renderers read `node.label`. */
22
+ rootLabel?: string;
23
+ /** Optional formatter applied to the `groupOf` key to derive the group's display label.
24
+ * Defaults to the key itself. */
25
+ groupLabel?: (key: string) => string;
26
+ };
27
+ /** Node type tags so consumer renderers can distinguish leaves from synthetic structural nodes. */
28
+ export declare const CLUSTER_NODE_TYPE_LEAF = "leaf";
29
+ export declare const CLUSTER_NODE_TYPE_GROUP = "group";
30
+ export declare const CLUSTER_NODE_TYPE_ROOT = "root";
31
+ /**
32
+ * Radial cluster (d3.cluster) layout. Materializes a root → group → leaf
33
+ * hierarchy from the `groupOf` callback, runs d3.cluster, and:
34
+ *
35
+ * - Places leaves around the outer ring; synthetic group nodes sit on an
36
+ * inner ring; the root sits at the origin. All three kinds are added to the
37
+ * layout so they render via the consumer's `renderNode` (the `type` field
38
+ * identifies which is which).
39
+ * - Each hierarchy edge carries a `path` string (d3's `linkRadial` curve)
40
+ * computed from CURRENT cartesian endpoint positions every frame via
41
+ * `onTickFrame`. The curve therefore tracks moving endpoints during a
42
+ * cross-variant tween (e.g. force → cluster) instead of snapping to the
43
+ * final polar shape.
44
+ */
45
+ export declare class GraphClusterProjector<NodeData = any, Options extends GraphClusterProjectorOptions = any> extends GraphRadialProjector<NodeData, Options> {
46
+ #private;
47
+ /** Toggle collapse state for a synthetic node id. Triggers a topology re-emit. */
48
+ toggleCollapsed(id: string): void;
49
+ /** Whether a synthetic-node id is currently collapsed. */
50
+ isCollapsed(id: string): boolean;
51
+ protected onUpdate(graph?: Graph.Any): void;
52
+ /**
53
+ * Recompute each hierarchy edge's `path` from current cartesian source/target positions,
54
+ * so the curves track moving endpoints during a cross-variant tween (e.g. force → cluster)
55
+ * instead of being pinned to the final polar layout.
56
+ */
57
+ protected onTickFrame(_t: number): void;
58
+ private doClusterLayout;
59
+ }
60
+ //# sourceMappingURL=graph-cluster-projector.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"graph-cluster-projector.d.ts","sourceRoot":"","sources":["../../../../../src/graph/projector/graph-cluster-projector.ts"],"names":[],"mappings":"AAMA,OAAO,EAAE,KAAK,KAAK,EAAE,MAAM,aAAa,CAAC;AAGzC,OAAO,EAAwB,KAAK,eAAe,EAAE,MAAM,UAAU,CAAC;AACtE,OAAO,EAAE,oBAAoB,EAAE,KAAK,2BAA2B,EAAc,MAAM,0BAA0B,CAAC;AAE9G,MAAM,MAAM,4BAA4B,GAAG,2BAA2B,GAAG;IACvE,yDAAyD;IACzD,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,wCAAwC;IACxC,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,8FAA8F;IAC9F,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,qDAAqD;IACrD,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB;;;;OAIG;IACH,OAAO,CAAC,EAAE,CAAC,IAAI,EAAE,eAAe,KAAK,MAAM,GAAG,SAAS,CAAC;IACxD,gDAAgD;IAChD,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,iFAAiF;IACjF,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB;qCACiC;IACjC,UAAU,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,MAAM,CAAC;CACtC,CAAC;AAMF,mGAAmG;AACnG,eAAO,MAAM,sBAAsB,SAAS,CAAC;AAC7C,eAAO,MAAM,uBAAuB,UAAU,CAAC;AAC/C,eAAO,MAAM,sBAAsB,SAAS,CAAC;AAwB7C;;;;;;;;;;;;;GAaG;AACH,qBAAa,qBAAqB,CAChC,QAAQ,GAAG,GAAG,EACd,OAAO,SAAS,4BAA4B,GAAG,GAAG,CAClD,SAAQ,oBAAoB,CAAC,QAAQ,EAAE,OAAO,CAAC;;IAa/C,kFAAkF;IAClF,eAAe,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI,CAWhC;IAED,0DAA0D;IAC1D,WAAW,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAE/B;IAED,UAAmB,QAAQ,CAAC,KAAK,CAAC,EAAE,KAAK,CAAC,GAAG,QAS5C;IAED;;;;OAIG;IACH,UAAmB,WAAW,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI,CAU/C;IAED,OAAO,CAAC,eAAe;CAoLxB"}
@@ -1,7 +1,7 @@
1
- import { type GraphProjector } from './graph-projector';
2
1
  import { type SVGContext } from '../../hooks';
3
2
  import { type Point } from '../../util';
4
3
  import { type GraphLayoutNode } from '../types';
4
+ import { type GraphProjector } from './graph-projector';
5
5
  export interface DragOptions<N> {
6
6
  dragMod?: string;
7
7
  linkMod?: string;
@@ -1 +1 @@
1
- {"version":3,"file":"graph-drag.d.ts","sourceRoot":"","sources":["../../../../../src/graph/projector/graph-drag.ts"],"names":[],"mappings":"AAMA,OAAO,EAAE,KAAK,cAAc,EAAE,MAAM,mBAAmB,CAAC;AACxD,OAAO,EAAE,KAAK,UAAU,EAAE,MAAM,aAAa,CAAC;AAC9C,OAAO,EAAE,KAAK,KAAK,EAAE,MAAM,YAAY,CAAC;AACxC,OAAO,EAAE,KAAK,eAAe,EAAE,MAAM,UAAU,CAAC;AAOhD,MAAM,WAAW,WAAW,CAAC,CAAC;IAC5B,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,MAAM,CAAC,EAAE,CAAC,MAAM,CAAC,EAAE,eAAe,CAAC,CAAC,CAAC,EAAE,MAAM,CAAC,EAAE,eAAe,CAAC,CAAC,CAAC,EAAE,KAAK,CAAC,EAAE,KAAK,KAAK,IAAI,CAAC;IAC3F,MAAM,CAAC,EAAE,CAAC,MAAM,EAAE,eAAe,CAAC,CAAC,CAAC,EAAE,MAAM,CAAC,EAAE,eAAe,CAAC,CAAC,CAAC,KAAK,IAAI,CAAC;CAC5E;AAOD;;GAEG;AACH,eAAO,MAAM,eAAe,GAAI,QAAQ,EACtC,SAAS,UAAU,EACnB,WAAW,cAAc,CAAC,QAAQ,CAAC,EACnC,UAAS,WAAW,CAAC,QAAQ,CAAsB,+HAwFpD,CAAC"}
1
+ {"version":3,"file":"graph-drag.d.ts","sourceRoot":"","sources":["../../../../../src/graph/projector/graph-drag.ts"],"names":[],"mappings":"AAMA,OAAO,EAAE,KAAK,UAAU,EAAE,MAAM,aAAa,CAAC;AAC9C,OAAO,EAAE,KAAK,KAAK,EAAE,MAAM,YAAY,CAAC;AACxC,OAAO,EAAE,KAAK,eAAe,EAAE,MAAM,UAAU,CAAC;AAChD,OAAO,EAAE,KAAK,cAAc,EAAE,MAAM,mBAAmB,CAAC;AAOxD,MAAM,WAAW,WAAW,CAAC,CAAC;IAC5B,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,MAAM,CAAC,EAAE,CAAC,MAAM,CAAC,EAAE,eAAe,CAAC,CAAC,CAAC,EAAE,MAAM,CAAC,EAAE,eAAe,CAAC,CAAC,CAAC,EAAE,KAAK,CAAC,EAAE,KAAK,KAAK,IAAI,CAAC;IAC3F,MAAM,CAAC,EAAE,CAAC,MAAM,EAAE,eAAe,CAAC,CAAC,CAAC,EAAE,MAAM,CAAC,EAAE,eAAe,CAAC,CAAC,CAAC,KAAK,IAAI,CAAC;CAC5E;AAOD;;GAEG;AACH,eAAO,MAAM,eAAe,GAAI,QAAQ,WAC7B,UAAU,aACR,cAAc,CAAC,QAAQ,CAAC,YAC1B,WAAW,CAAC,QAAQ,CAAC,+HAwF/B,CAAC"}
@@ -1,6 +1,6 @@
1
1
  import { type Graph } from '@dxos/graph';
2
- import { GraphProjector, type GraphProjectorOptions } from './graph-projector';
3
2
  import { type GraphLayoutEdge, type GraphLayoutNode } from '../types';
3
+ import { GraphProjector, type GraphProjectorOptions } from './graph-projector';
4
4
  /**
5
5
  * https://github.com/d3/d3-force#forceLink
6
6
  */
@@ -86,7 +86,7 @@ export declare class GraphForceProjector<NodeData = any> extends GraphProjector<
86
86
  onStart(): Promise<void>;
87
87
  onStop(): Promise<void>;
88
88
  onRefresh(dragging?: boolean): void;
89
- onUpdate(graph?: Graph): void;
89
+ onUpdate(graph?: Graph.Any): void;
90
90
  private updateLayout;
91
91
  /**
92
92
  * Update all forces.
@@ -1 +1 @@
1
- {"version":3,"file":"graph-force-projector.d.ts","sourceRoot":"","sources":["../../../../../src/graph/projector/graph-force-projector.ts"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"graph-force-projector.d.ts","sourceRoot":"","sources":["../../../../../src/graph/projector/graph-force-projector.ts"],"names":[],"mappings":"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"}
@@ -1 +1 @@
1
- {"version":3,"file":"graph-forces.d.ts","sourceRoot":"","sources":["../../../../../src/graph/projector/graph-forces.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,KAAK,KAAK,EAAkB,KAAK,mBAAmB,EAAE,KAAK,mBAAmB,EAAE,MAAM,IAAI,CAAC;AAEpG,MAAM,MAAM,iBAAiB,GAAG;IAC9B,CAAC,CAAC,EAAE,MAAM,CAAC;IACX,CAAC,CAAC,EAAE,MAAM,CAAC;IACX,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB,CAAC;AAEF,eAAO,MAAM,UAAU,GACrB,SAAS,SAAS,mBAAmB,EACrC,SAAS,SAAS,mBAAmB,CAAC,SAAS,CAAC,GAAG,SAAS,EAC5D,qBAIC,iBAAiB,KAAG,KAAK,CAAC,SAAS,EAAE,SAAS,CAehD,CAAC"}
1
+ {"version":3,"file":"graph-forces.d.ts","sourceRoot":"","sources":["../../../../../src/graph/projector/graph-forces.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,KAAK,KAAK,EAAE,KAAK,mBAAmB,EAAE,KAAK,mBAAmB,EAAkB,MAAM,IAAI,CAAC;AAEpG,MAAM,MAAM,iBAAiB,GAAG;IAC9B,CAAC,CAAC,EAAE,MAAM,CAAC;IACX,CAAC,CAAC,EAAE,MAAM,CAAC;IACX,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB,CAAC;AAEF,eAAO,MAAM,UAAU,GACrB,SAAS,SAAS,mBAAmB,EACrC,SAAS,SAAS,mBAAmB,CAAC,SAAS,CAAC,GAAG,SAAS,uBAK3D,iBAAiB,KAAG,KAAK,CAAC,SAAS,EAAE,SAAS,CAehD,CAAC"}
@@ -1,14 +1,14 @@
1
1
  import { type Graph } from '@dxos/graph';
2
+ import { type GraphLayoutNode } from '../types';
2
3
  import { type GraphProjectorOptions } from './graph-projector';
3
4
  import { GraphRadialProjector } from './graph-radial-projector';
4
- import { type GraphLayoutNode } from '../types';
5
5
  export type GraphHierarchicalProjectorOptions = GraphProjectorOptions & {
6
6
  radius?: number;
7
7
  margin?: number;
8
8
  duration?: number;
9
9
  };
10
10
  export declare class GraphHierarchicalProjector<NodeData = any, Options extends GraphHierarchicalProjectorOptions = any> extends GraphRadialProjector<NodeData, Options> {
11
- protected onUpdate(graph?: Graph): void;
11
+ protected onUpdate(graph?: Graph.Any): void;
12
12
  protected doHierarchicalLayout(selected: GraphLayoutNode): void;
13
13
  }
14
14
  //# sourceMappingURL=graph-hierarchical-projector.d.ts.map
@@ -1 +1 @@
1
- {"version":3,"file":"graph-hierarchical-projector.d.ts","sourceRoot":"","sources":["../../../../../src/graph/projector/graph-hierarchical-projector.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,KAAK,KAAK,EAAE,MAAM,aAAa,CAAC;AAGzC,OAAO,EAAE,KAAK,qBAAqB,EAAE,MAAM,mBAAmB,CAAC;AAC/D,OAAO,EAAE,oBAAoB,EAA4B,MAAM,0BAA0B,CAAC;AAC1F,OAAO,EAAE,KAAK,eAAe,EAAE,MAAM,UAAU,CAAC;AAEhD,MAAM,MAAM,iCAAiC,GAAG,qBAAqB,GAAG;IACtE,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB,CAAC;AAEF,qBAAa,0BAA0B,CACrC,QAAQ,GAAG,GAAG,EACd,OAAO,SAAS,iCAAiC,GAAG,GAAG,CACvD,SAAQ,oBAAoB,CAAC,QAAQ,EAAE,OAAO,CAAC;cAC5B,QAAQ,CAAC,KAAK,CAAC,EAAE,KAAK;IAmBzC,SAAS,CAAC,oBAAoB,CAAC,QAAQ,EAAE,eAAe;CAuCzD"}
1
+ {"version":3,"file":"graph-hierarchical-projector.d.ts","sourceRoot":"","sources":["../../../../../src/graph/projector/graph-hierarchical-projector.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,KAAK,KAAK,EAAE,MAAM,aAAa,CAAC;AAGzC,OAAO,EAAE,KAAK,eAAe,EAAE,MAAM,UAAU,CAAC;AAChD,OAAO,EAAE,KAAK,qBAAqB,EAAE,MAAM,mBAAmB,CAAC;AAC/D,OAAO,EAAE,oBAAoB,EAA4B,MAAM,0BAA0B,CAAC;AAE1F,MAAM,MAAM,iCAAiC,GAAG,qBAAqB,GAAG;IACtE,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB,CAAC;AAEF,qBAAa,0BAA0B,CACrC,QAAQ,GAAG,GAAG,EACd,OAAO,SAAS,iCAAiC,GAAG,GAAG,CACvD,SAAQ,oBAAoB,CAAC,QAAQ,EAAE,OAAO,CAAC;IAC/C,UAAmB,QAAQ,CAAC,KAAK,CAAC,EAAE,KAAK,CAAC,GAAG,QAkB5C;IAED,SAAS,CAAC,oBAAoB,CAAC,QAAQ,EAAE,eAAe,QAsCvD;CACF"}
@@ -0,0 +1,23 @@
1
+ import { type Graph } from '@dxos/graph';
2
+ import { type GraphLayoutNode } from '../types';
3
+ import { GraphRadialProjector, type GraphRadialProjectorOptions } from './graph-radial-projector';
4
+ export type GraphLatticeProjectorOptions = GraphRadialProjectorOptions & {
5
+ /** Reserved space around the lattice (screen pixels). */
6
+ margin?: number;
7
+ /** Node radius used by `renderNode` consumers. Defaults to the force-graph default (6) so animations across variants don't resize nodes. */
8
+ radius?: number;
9
+ /** Sort key for cells; defaults to the node label / id. Same-typename nodes naturally cluster. */
10
+ sortBy?: (node: GraphLayoutNode) => string;
11
+ };
12
+ /**
13
+ * Lays out nodes as a square-as-possible grid that fits the container.
14
+ * Extends `GraphRadialProjector` to inherit the tween (`updateNode` + `animate`),
15
+ * so switching to / from this layout animates each node from its current
16
+ * position to the grid cell — and the initial mount can also "grow" from
17
+ * existing positions if seeded with a prior projector's layout.
18
+ */
19
+ export declare class GraphLatticeProjector<NodeData = any, Options extends GraphLatticeProjectorOptions = any> extends GraphRadialProjector<NodeData, Options> {
20
+ protected onUpdate(graph?: Graph.Any): void;
21
+ private doLatticeLayout;
22
+ }
23
+ //# sourceMappingURL=graph-lattice-projector.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"graph-lattice-projector.d.ts","sourceRoot":"","sources":["../../../../../src/graph/projector/graph-lattice-projector.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,KAAK,KAAK,EAAE,MAAM,aAAa,CAAC;AAGzC,OAAO,EAAE,KAAK,eAAe,EAAE,MAAM,UAAU,CAAC;AAChD,OAAO,EAAE,oBAAoB,EAAE,KAAK,2BAA2B,EAAc,MAAM,0BAA0B,CAAC;AAE9G,MAAM,MAAM,4BAA4B,GAAG,2BAA2B,GAAG;IACvE,yDAAyD;IACzD,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,4IAA4I;IAC5I,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,kGAAkG;IAClG,MAAM,CAAC,EAAE,CAAC,IAAI,EAAE,eAAe,KAAK,MAAM,CAAC;CAC5C,CAAC;AAEF;;;;;;GAMG;AACH,qBAAa,qBAAqB,CAChC,QAAQ,GAAG,GAAG,EACd,OAAO,SAAS,4BAA4B,GAAG,GAAG,CAClD,SAAQ,oBAAoB,CAAC,QAAQ,EAAE,OAAO,CAAC;IAC/C,UAAmB,QAAQ,CAAC,KAAK,CAAC,EAAE,KAAK,CAAC,GAAG,QAQ5C;IAED,OAAO,CAAC,eAAe;CA6CxB"}
@@ -1,12 +1,12 @@
1
- import { type SelectionModel, type Graph } from '@dxos/graph';
2
- import { Projector, type ProjectorOptions } from './projector';
1
+ import { type Graph, type SelectionModel } from '@dxos/graph';
3
2
  import { type SVGContext } from '../../hooks';
4
3
  import { type GraphLayout, type GraphLayoutNode } from '../types';
4
+ import { Projector, type ProjectorOptions } from './projector';
5
5
  export type GraphProjectorOptions = ProjectorOptions & {};
6
6
  /**
7
7
  * Base class for graph projectors.
8
8
  */
9
- export declare abstract class GraphProjector<NodeData = any, Options extends GraphProjectorOptions = any> extends Projector<Graph, GraphLayout<NodeData>, Options> {
9
+ export declare abstract class GraphProjector<NodeData = any, Options extends GraphProjectorOptions = any> extends Projector<Graph.Any, GraphLayout<NodeData>, Options> {
10
10
  private readonly _selection?;
11
11
  private readonly _layout;
12
12
  constructor(context: SVGContext, options?: Options, _selection?: SelectionModel, layout?: GraphLayout<NodeData>);
@@ -18,7 +18,7 @@ export declare abstract class GraphProjector<NodeData = any, Options extends Gra
18
18
  * Merge external data with internal representation (e.g., so force properties like position are preserved).
19
19
  * @param data
20
20
  */
21
- protected mergeData(data?: Graph): void;
21
+ protected mergeData(data?: Graph.Any): void;
22
22
  onClear(): Promise<void>;
23
23
  abstract findNode(x: number, y: number, radius: number): GraphLayoutNode<NodeData> | undefined;
24
24
  }
@@ -1 +1 @@
1
- {"version":3,"file":"graph-projector.d.ts","sourceRoot":"","sources":["../../../../../src/graph/projector/graph-projector.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,KAAK,cAAc,EAAE,KAAK,KAAK,EAAE,MAAM,aAAa,CAAC;AAE9D,OAAO,EAAE,SAAS,EAAE,KAAK,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAC/D,OAAO,EAAE,KAAK,UAAU,EAAE,MAAM,aAAa,CAAC;AAC9C,OAAO,EAAc,KAAK,WAAW,EAAE,KAAK,eAAe,EAAE,MAAM,UAAU,CAAC;AAE9E,MAAM,MAAM,qBAAqB,GAAG,gBAAgB,GAAG,EAAE,CAAC;AAE1D;;GAEG;AACH,8BAAsB,cAAc,CAAC,QAAQ,GAAG,GAAG,EAAE,OAAO,SAAS,qBAAqB,GAAG,GAAG,CAAE,SAAQ,SAAS,CACjH,KAAK,EACL,WAAW,CAAC,QAAQ,CAAC,EACrB,OAAO,CACR;IAOG,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAC;IAN9B,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAwB;gBAI9C,OAAO,EAAE,UAAU,EACnB,OAAO,CAAC,EAAE,OAAO,EACA,UAAU,CAAC,EAAE,cAAc,EAC5C,MAAM,CAAC,EAAE,WAAW,CAAC,QAAQ,CAAC;IAYhC,IAAI,MAAM,0BAET;IAED,IAAI,SAAS,mBAEZ;IAED,WAAW,CAAC,IAAI,EAAE,eAAe;IAIjC,KAAK;IAML;;;OAGG;IACH,SAAS,CAAC,SAAS,CAAC,IAAI,GAAE,KAAkB;IAgC7B,OAAO;IAItB,QAAQ,CAAC,QAAQ,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,eAAe,CAAC,QAAQ,CAAC,GAAG,SAAS;CAC/F"}
1
+ {"version":3,"file":"graph-projector.d.ts","sourceRoot":"","sources":["../../../../../src/graph/projector/graph-projector.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,KAAK,KAAK,EAAE,KAAK,cAAc,EAAE,MAAM,aAAa,CAAC;AAE9D,OAAO,EAAE,KAAK,UAAU,EAAE,MAAM,aAAa,CAAC;AAC9C,OAAO,EAAE,KAAK,WAAW,EAAE,KAAK,eAAe,EAAc,MAAM,UAAU,CAAC;AAC9E,OAAO,EAAE,SAAS,EAAE,KAAK,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAE/D,MAAM,MAAM,qBAAqB,GAAG,gBAAgB,GAAG,EAAE,CAAC;AAE1D;;GAEG;AACH,8BAAsB,cAAc,CAAC,QAAQ,GAAG,GAAG,EAAE,OAAO,SAAS,qBAAqB,GAAG,GAAG,CAAE,SAAQ,SAAS,CACjH,KAAK,CAAC,GAAG,EACT,WAAW,CAAC,QAAQ,CAAC,EACrB,OAAO,CACR;IAOG,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAC;IAN9B,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAwB;IAGhD,YACE,OAAO,EAAE,UAAU,EACnB,OAAO,CAAC,EAAE,OAAO,EACA,UAAU,CAAC,EAAE,cAAc,EAC5C,MAAM,CAAC,EAAE,WAAW,CAAC,QAAQ,CAAC,EAU/B;IAED,IAAI,MAAM,0BAET;IAED,IAAI,SAAS,mBAEZ;IAED,WAAW,CAAC,IAAI,EAAE,eAAe,UAEhC;IAED,KAAK,SAIJ;IAED;;;OAGG;IACH,SAAS,CAAC,SAAS,CAAC,IAAI,GAAE,KAAK,CAAC,GAAgB,QAqC/C;IAEc,OAAO,kBAErB;IAED,QAAQ,CAAC,QAAQ,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,eAAe,CAAC,QAAQ,CAAC,GAAG,SAAS,CAAC;CAChG"}
@@ -1,7 +1,7 @@
1
1
  import { type Graph } from '@dxos/graph';
2
- import { GraphProjector, type GraphProjectorOptions } from './graph-projector';
3
2
  import { type Point } from '../../util';
4
3
  import { type GraphLayoutNode } from '../types';
4
+ import { GraphProjector, type GraphProjectorOptions } from './graph-projector';
5
5
  export type GraphRadialProjectorOptions = GraphProjectorOptions & {
6
6
  radius?: number;
7
7
  margin?: number;
@@ -10,8 +10,14 @@ export type GraphRadialProjectorOptions = GraphProjectorOptions & {
10
10
  export declare class GraphRadialProjector<NodeData = any, Options extends GraphRadialProjectorOptions = any> extends GraphProjector<NodeData, Options> {
11
11
  private _timer?;
12
12
  findNode(x: number, y: number, radius: number): GraphLayoutNode<NodeData> | undefined;
13
- protected onUpdate(graph?: Graph): void;
13
+ protected onUpdate(graph?: Graph.Any): void;
14
14
  protected animate(): void;
15
+ /**
16
+ * Per-frame hook called after node x/y/r are interpolated and before the
17
+ * 'positions' emit. Subclasses override to update edge geometry (`edge.path`)
18
+ * so curves stay glued to moving endpoints. `t` is the eased progress in [0, 1].
19
+ */
20
+ protected onTickFrame(t: number): void;
15
21
  protected onStop(): Promise<void>;
16
22
  protected doRadialLayout(): void;
17
23
  }
@@ -1 +1 @@
1
- {"version":3,"file":"graph-radial-projector.d.ts","sourceRoot":"","sources":["../../../../../src/graph/projector/graph-radial-projector.ts"],"names":[],"mappings":"AAMA,OAAO,EAAE,KAAK,KAAK,EAAE,MAAM,aAAa,CAAC;AAGzC,OAAO,EAAE,cAAc,EAAE,KAAK,qBAAqB,EAAE,MAAM,mBAAmB,CAAC;AAC/E,OAAO,EAAE,KAAK,KAAK,EAAE,MAAM,YAAY,CAAC;AACxC,OAAO,EAAE,KAAK,eAAe,EAAE,MAAM,UAAU,CAAC;AAEhD,MAAM,MAAM,2BAA2B,GAAG,qBAAqB,GAAG;IAChE,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB,CAAC;AAEF,qBAAa,oBAAoB,CAC/B,QAAQ,GAAG,GAAG,EACd,OAAO,SAAS,2BAA2B,GAAG,GAAG,CACjD,SAAQ,cAAc,CAAC,QAAQ,EAAE,OAAO,CAAC;IACzC,OAAO,CAAC,MAAM,CAAC,CAAQ;IAEd,QAAQ,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,eAAe,CAAC,QAAQ,CAAC,GAAG,SAAS;cAI3E,QAAQ,CAAC,KAAK,CAAC,EAAE,KAAK;IAMzC,SAAS,CAAC,OAAO;cAwBQ,MAAM;IAK/B,SAAS,CAAC,cAAc;CAoBzB;AAED;;GAEG;AACH,eAAO,MAAM,UAAU,GAAI,MAAM,eAAe,EAAE,UAAU,KAAK,EAAE,WAAM,SAmBxE,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,YAAY,GAAI,GAAG,MAAM,EAAE,GAAG,MAAM,EAAE,GAAG,MAAM,EAAE,GAAG,MAAM,EAAE,cAAoB,MAEnF,GAAG,MAAM,KAAG,KAIrB,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,gBAAgB,GAAI,GAAG,MAAM,EAAE,GAAG,MAAM,EAAE,GAAG,MAAM,EAAE,GAAG,MAAM,MAGjE,GAAG,MAAM,KAAG,KAGrB,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,cAAc,GAAI,GAAG,MAAM,EAAE,GAAG,MAAM,EAAE,GAAG,MAAM,EAAE,GAAG,MAAM,MAG/D,GAAG,MAAM,KAAG,KAGrB,CAAC"}
1
+ {"version":3,"file":"graph-radial-projector.d.ts","sourceRoot":"","sources":["../../../../../src/graph/projector/graph-radial-projector.ts"],"names":[],"mappings":"AAMA,OAAO,EAAE,KAAK,KAAK,EAAE,MAAM,aAAa,CAAC;AAGzC,OAAO,EAAE,KAAK,KAAK,EAAE,MAAM,YAAY,CAAC;AACxC,OAAO,EAAE,KAAK,eAAe,EAAE,MAAM,UAAU,CAAC;AAChD,OAAO,EAAE,cAAc,EAAE,KAAK,qBAAqB,EAAE,MAAM,mBAAmB,CAAC;AAE/E,MAAM,MAAM,2BAA2B,GAAG,qBAAqB,GAAG;IAChE,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB,CAAC;AAEF,qBAAa,oBAAoB,CAC/B,QAAQ,GAAG,GAAG,EACd,OAAO,SAAS,2BAA2B,GAAG,GAAG,CACjD,SAAQ,cAAc,CAAC,QAAQ,EAAE,OAAO,CAAC;IACzC,OAAO,CAAC,MAAM,CAAC,CAAQ;IAEd,QAAQ,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,eAAe,CAAC,QAAQ,CAAC,GAAG,SAAS,CAE7F;IAED,UAAmB,QAAQ,CAAC,KAAK,CAAC,EAAE,KAAK,CAAC,GAAG,QAM5C;IAED,SAAS,CAAC,OAAO,SAyChB;IAED;;;;OAIG;IACH,SAAS,CAAC,WAAW,CAAC,CAAC,EAAE,MAAM,GAAG,IAAI,CAAG;IAEzC,UAAyB,MAAM,kBAG9B;IAED,SAAS,CAAC,cAAc,SAmBvB;CACF;AAED;;GAEG;AACH,eAAO,MAAM,UAAU,SAAU,eAAe,YAAY,KAAK,sBAmBhE,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,YAAY,MAAO,MAAM,KAAK,MAAM,KAAK,MAAM,KAAK,MAAM,yBAE1D,MAAM,KAAG,KAIrB,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,gBAAgB,MAAO,MAAM,KAAK,MAAM,KAAK,MAAM,KAAK,MAAM,SAG9D,MAAM,KAAG,KAGrB,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,cAAc,MAAO,MAAM,KAAK,MAAM,KAAK,MAAM,KAAK,MAAM,SAG5D,MAAM,KAAG,KAGrB,CAAC"}
@@ -1,14 +1,14 @@
1
1
  import { type Graph } from '@dxos/graph';
2
+ import { type GraphLayoutNode } from '../types';
2
3
  import { type GraphProjectorOptions } from './graph-projector';
3
4
  import { GraphRadialProjector } from './graph-radial-projector';
4
- import { type GraphLayoutNode } from '../types';
5
5
  export type GraphRelationalProjectorOptions = GraphProjectorOptions & {
6
6
  radius?: number;
7
7
  margin?: number;
8
8
  duration?: number;
9
9
  };
10
10
  export declare class GraphRelationalProjector<NodeData = any, Options extends GraphRelationalProjectorOptions = any> extends GraphRadialProjector<NodeData, Options> {
11
- protected onUpdate(graph?: Graph): void;
11
+ protected onUpdate(graph?: Graph.Any): void;
12
12
  protected doRelationalLayout(selected: GraphLayoutNode): void;
13
13
  }
14
14
  //# sourceMappingURL=graph-relational-projector.d.ts.map
@@ -1 +1 @@
1
- {"version":3,"file":"graph-relational-projector.d.ts","sourceRoot":"","sources":["../../../../../src/graph/projector/graph-relational-projector.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,KAAK,KAAK,EAAE,MAAM,aAAa,CAAC;AAGzC,OAAO,EAAE,KAAK,qBAAqB,EAAE,MAAM,mBAAmB,CAAC;AAC/D,OAAO,EAAE,oBAAoB,EAA8C,MAAM,0BAA0B,CAAC;AAC5G,OAAO,EAAE,KAAK,eAAe,EAAE,MAAM,UAAU,CAAC;AAEhD,MAAM,MAAM,+BAA+B,GAAG,qBAAqB,GAAG;IACpE,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB,CAAC;AAEF,qBAAa,wBAAwB,CACnC,QAAQ,GAAG,GAAG,EACd,OAAO,SAAS,+BAA+B,GAAG,GAAG,CACrD,SAAQ,oBAAoB,CAAC,QAAQ,EAAE,OAAO,CAAC;cAC5B,QAAQ,CAAC,KAAK,CAAC,EAAE,KAAK;IAmBzC,SAAS,CAAC,kBAAkB,CAAC,QAAQ,EAAE,eAAe;CAqEvD"}
1
+ {"version":3,"file":"graph-relational-projector.d.ts","sourceRoot":"","sources":["../../../../../src/graph/projector/graph-relational-projector.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,KAAK,KAAK,EAAE,MAAM,aAAa,CAAC;AAGzC,OAAO,EAAE,KAAK,eAAe,EAAE,MAAM,UAAU,CAAC;AAChD,OAAO,EAAE,KAAK,qBAAqB,EAAE,MAAM,mBAAmB,CAAC;AAC/D,OAAO,EAAE,oBAAoB,EAA8C,MAAM,0BAA0B,CAAC;AAE5G,MAAM,MAAM,+BAA+B,GAAG,qBAAqB,GAAG;IACpE,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB,CAAC;AAEF,qBAAa,wBAAwB,CACnC,QAAQ,GAAG,GAAG,EACd,OAAO,SAAS,+BAA+B,GAAG,GAAG,CACrD,SAAQ,oBAAoB,CAAC,QAAQ,EAAE,OAAO,CAAC;IAC/C,UAAmB,QAAQ,CAAC,KAAK,CAAC,EAAE,KAAK,CAAC,GAAG,QAkB5C;IAED,SAAS,CAAC,kBAAkB,CAAC,QAAQ,EAAE,eAAe,QAoErD;CACF"}
@@ -1,7 +1,10 @@
1
+ export * from './graph-bundle-projector';
2
+ export * from './graph-cluster-projector';
1
3
  export * from './graph-drag';
2
4
  export * from './graph-projector';
3
5
  export * from './graph-force-projector';
4
6
  export * from './graph-hierarchical-projector';
7
+ export * from './graph-lattice-projector';
5
8
  export * from './graph-relational-projector';
6
9
  export * from './graph-radial-projector';
7
10
  export * from './projector';
@@ -1 +1 @@
1
- {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/graph/projector/index.ts"],"names":[],"mappings":"AAIA,cAAc,cAAc,CAAC;AAC7B,cAAc,mBAAmB,CAAC;AAClC,cAAc,yBAAyB,CAAC;AACxC,cAAc,gCAAgC,CAAC;AAC/C,cAAc,8BAA8B,CAAC;AAC7C,cAAc,0BAA0B,CAAC;AACzC,cAAc,aAAa,CAAC"}
1
+ {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/graph/projector/index.ts"],"names":[],"mappings":"AAIA,cAAc,0BAA0B,CAAC;AACzC,cAAc,2BAA2B,CAAC;AAC1C,cAAc,cAAc,CAAC;AAC7B,cAAc,mBAAmB,CAAC;AAClC,cAAc,yBAAyB,CAAC;AACxC,cAAc,gCAAgC,CAAC;AAC/C,cAAc,2BAA2B,CAAC;AAC1C,cAAc,8BAA8B,CAAC;AAC7C,cAAc,0BAA0B,CAAC;AACzC,cAAc,aAAa,CAAC"}
@@ -4,6 +4,14 @@ import { type IdAccessor } from '../types';
4
4
  export type ProjectorOptions = {
5
5
  idAccessor?: IdAccessor;
6
6
  };
7
+ /**
8
+ * Update kinds signal what changed since the previous render.
9
+ * - `topology`: nodes/edges added or removed, or per-node attributes may have changed.
10
+ * The renderer should perform a full enter/exit join and re-run attribute callbacks.
11
+ * - `positions`: only `x/y` (and similar transient layout state) changed.
12
+ * The renderer can fast-path: just update transforms and edge geometry.
13
+ */
14
+ export type ProjectorUpdateKind = 'topology' | 'positions';
7
15
  /**
8
16
  * Generates a layout to be rendered.
9
17
  */
@@ -11,6 +19,7 @@ export declare abstract class Projector<NodeData, Layout, Options extends Projec
11
19
  private readonly _context;
12
20
  readonly updated: EventEmitter<{
13
21
  layout: Layout;
22
+ kind: ProjectorUpdateKind;
14
23
  }>;
15
24
  private readonly _options;
16
25
  constructor(_context: SVGContext, options?: Partial<Options>);
@@ -19,7 +28,7 @@ export declare abstract class Projector<NodeData, Layout, Options extends Projec
19
28
  get options(): Options;
20
29
  refresh(dragging?: boolean): void;
21
30
  updateData(data?: NodeData): void;
22
- emitUpdate(): void;
31
+ emitUpdate(kind?: ProjectorUpdateKind): void;
23
32
  clear(): Promise<void>;
24
33
  start(): Promise<void>;
25
34
  stop(): Promise<void>;
@@ -1 +1 @@
1
- {"version":3,"file":"projector.d.ts","sourceRoot":"","sources":["../../../../../src/graph/projector/projector.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,KAAK,UAAU,EAAE,MAAM,aAAa,CAAC;AAC9C,OAAO,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAC1C,OAAO,EAAqB,KAAK,UAAU,EAAE,MAAM,UAAU,CAAC;AAE9D,MAAM,MAAM,gBAAgB,GAAG;IAC7B,UAAU,CAAC,EAAE,UAAU,CAAC;CACzB,CAAC;AAEF;;GAEG;AACH,8BAAsB,SAAS,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,SAAS,gBAAgB;IAM9E,OAAO,CAAC,QAAQ,CAAC,QAAQ;IAL3B,SAAgB,OAAO;gBAA8B,MAAM;OAAM;IAEjE,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAU;gBAGhB,QAAQ,EAAE,UAAU,EACrC,OAAO,CAAC,EAAE,OAAO,CAAC,OAAO,CAAC;IAU5B,QAAQ,KAAK,MAAM,IAAI,MAAM,CAAC;IAE9B,IAAI,OAAO,IAAI,UAAU,CAExB;IAED,IAAI,OAAO,IAAI,OAAO,CAErB;IAED,OAAO,CAAC,QAAQ,UAAQ;IAIxB,UAAU,CAAC,IAAI,CAAC,EAAE,QAAQ;IAI1B,UAAU;IAIJ,KAAK;IAIL,KAAK;IAIL,IAAI;IAIV,SAAS,CAAC,SAAS,CAAC,QAAQ,UAAQ,GAAG,IAAI;IAC3C,SAAS,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,QAAQ,GAAG,IAAI;cACzB,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;cACxB,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;cACxB,MAAM,IAAI,OAAO,CAAC,IAAI,CAAC;CACxC"}
1
+ {"version":3,"file":"projector.d.ts","sourceRoot":"","sources":["../../../../../src/graph/projector/projector.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,KAAK,UAAU,EAAE,MAAM,aAAa,CAAC;AAC9C,OAAO,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAC1C,OAAO,EAAE,KAAK,UAAU,EAAqB,MAAM,UAAU,CAAC;AAE9D,MAAM,MAAM,gBAAgB,GAAG;IAC7B,UAAU,CAAC,EAAE,UAAU,CAAC;CACzB,CAAC;AAEF;;;;;;GAMG;AACH,MAAM,MAAM,mBAAmB,GAAG,UAAU,GAAG,WAAW,CAAC;AAE3D;;GAEG;AACH,8BAAsB,SAAS,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,SAAS,gBAAgB;IAM9E,OAAO,CAAC,QAAQ,CAAC,QAAQ;IAL3B,SAAgB,OAAO;gBAA8B,MAAM;cAAQ,mBAAmB;OAAM;IAE5F,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAU;IAEnC,YACmB,QAAQ,EAAE,UAAU,EACrC,OAAO,CAAC,EAAE,OAAO,CAAC,OAAO,CAAC,EAQ3B;IAED,QAAQ,KAAK,MAAM,IAAI,MAAM,CAAC;IAE9B,IAAI,OAAO,IAAI,UAAU,CAExB;IAED,IAAI,OAAO,IAAI,OAAO,CAErB;IAED,OAAO,CAAC,QAAQ,UAAQ,QAEvB;IAED,UAAU,CAAC,IAAI,CAAC,EAAE,QAAQ,QAEzB;IAED,UAAU,CAAC,IAAI,GAAE,mBAAgC,QAEhD;IAEK,KAAK,kBAEV;IAEK,KAAK,kBAEV;IAEK,IAAI,kBAET;IAED,SAAS,CAAC,SAAS,CAAC,QAAQ,UAAQ,GAAG,IAAI,CAAG;IAC9C,SAAS,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,QAAQ,GAAG,IAAI,CAAG;IAC5C,UAAgB,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC,CAAG;IAC3C,UAAgB,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC,CAAG;IAC3C,UAAgB,MAAM,IAAI,OAAO,CAAC,IAAI,CAAC,CAAG;CAC3C"}
@@ -1 +1 @@
1
- {"version":3,"file":"bullets.d.ts","sourceRoot":"","sources":["../../../../../src/graph/renderer/bullets.ts"],"names":[],"mappings":"AAMA,OAAO,EAAoB,KAAK,UAAU,EAAE,MAAM,YAAY,CAAC;AAE/D,MAAM,MAAM,aAAa,GAAG;IAC1B,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB,CAAC;AAEF;;;;;GAKG;AACH,eAAO,MAAM,aAAa,GAAI,OAAO,WAAW,EAAE,QAAQ,MAAM,EAAE,UAAS,aAAkB,KAAG,UAiD/F,CAAC"}
1
+ {"version":3,"file":"bullets.d.ts","sourceRoot":"","sources":["../../../../../src/graph/renderer/bullets.ts"],"names":[],"mappings":"AAMA,OAAO,EAAE,KAAK,UAAU,EAAoB,MAAM,YAAY,CAAC;AAE/D,MAAM,MAAM,aAAa,GAAG;IAC1B,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB,CAAC;AAEF;;;;;GAKG;AACH,eAAO,MAAM,aAAa,UAAW,WAAW,UAAU,MAAM,YAAW,aAAa,KAAQ,UAiD/F,CAAC"}
@@ -1,6 +1,12 @@
1
- import { Renderer, type RendererOptions } from './renderer';
2
- import { type D3Callable } from '../../util';
1
+ import { type D3Callable, type D3Selection } from '../../util';
3
2
  import { type GraphLayout, type GraphLayoutEdge, type GraphLayoutNode } from '../types';
3
+ import { Renderer, type RendererOptions } from './renderer';
4
+ /**
5
+ * Replace the default `<circle>` with a custom node shape. Invoked once per
6
+ * entering node — append your own elements to the supplied `<g>`. Position and
7
+ * `attributes.node` callbacks are still applied by the renderer.
8
+ */
9
+ export type RenderNode<NodeData = any> = (group: D3Selection<SVGGElement>, node: GraphLayoutNode<NodeData>) => void;
4
10
  export type LabelOptions<NodeData = any> = {
5
11
  text: (node: GraphLayoutNode<NodeData>, highlight?: boolean) => string | undefined;
6
12
  };
@@ -24,16 +30,30 @@ export type GraphRendererOptions<NodeData = any, EdgeData = any> = RendererOptio
24
30
  labels?: LabelOptions<NodeData>;
25
31
  subgraphs?: boolean;
26
32
  attributes?: AttributesOptions<NodeData>;
33
+ /**
34
+ * Override the default `<circle>` node shape. When set, the renderer appends
35
+ * whatever this callback creates instead. Use for lattice rects, custom icons, etc.
36
+ */
37
+ renderNode?: RenderNode<NodeData>;
27
38
  transition?: () => any;
28
39
  onNodeClick?: (node: GraphLayoutNode<NodeData>, event: MouseEvent) => void;
29
40
  onNodePointerEnter?: (node: GraphLayoutNode<NodeData>, event: MouseEvent) => void;
41
+ /** Fires on pointerleave from a node hit-target. Pair with `onNodePointerEnter` to clear hover state. */
42
+ onNodePointerLeave?: (node: GraphLayoutNode<NodeData>, event: MouseEvent) => void;
30
43
  onLinkClick?: (link: GraphLayoutEdge<NodeData, EdgeData>, event: MouseEvent) => void;
31
44
  }>;
32
45
  /**
33
46
  * Renders the Graph layout.
34
47
  */
35
48
  export declare class GraphRenderer<NodeData = any, EdgeData = any> extends Renderer<GraphLayout<NodeData, EdgeData>, GraphRendererOptions<NodeData, EdgeData>> {
49
+ #private;
36
50
  render(layout: GraphLayout<NodeData, EdgeData>): void;
51
+ /**
52
+ * Fast positions-only update. Skips enter/exit, attribute callbacks, label sizing,
53
+ * and the subgraph hull pass; just writes `transform` per node and `d` per edge.
54
+ * Called per simulation tick / animation frame.
55
+ */
56
+ applyPositions(layout: GraphLayout<NodeData, EdgeData>): void;
37
57
  /**
38
58
  * Trigger path bullets.
39
59
  * @param node
@@ -1 +1 @@
1
- {"version":3,"file":"graph-renderer.d.ts","sourceRoot":"","sources":["../../../../../src/graph/renderer/graph-renderer.ts"],"names":[],"mappings":"AAUA,OAAO,EAAE,QAAQ,EAAE,KAAK,eAAe,EAAE,MAAM,YAAY,CAAC;AAC5D,OAAO,EAA4C,KAAK,UAAU,EAAc,MAAM,YAAY,CAAC;AACnG,OAAO,EAAE,KAAK,WAAW,EAAE,KAAK,eAAe,EAAE,KAAK,eAAe,EAAE,MAAM,UAAU,CAAC;AAIxF,MAAM,MAAM,YAAY,CAAC,QAAQ,GAAG,GAAG,IAAI;IACzC,IAAI,EAAE,CAAC,IAAI,EAAE,eAAe,CAAC,QAAQ,CAAC,EAAE,SAAS,CAAC,EAAE,OAAO,KAAK,MAAM,GAAG,SAAS,CAAC;CACpF,CAAC;AAEF,MAAM,MAAM,iBAAiB,CAAC,QAAQ,GAAG,GAAG,EAAE,QAAQ,GAAG,GAAG,IAAI;IAC9D,IAAI,CAAC,EAAE,CAAC,IAAI,EAAE,eAAe,CAAC,QAAQ,CAAC,KAAK;QAC1C,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;QAClC,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,CAAC;KAC3C,CAAC;IAEF,IAAI,CAAC,EAAE,CAAC,IAAI,EAAE,eAAe,CAAC,QAAQ,EAAE,QAAQ,CAAC,KAAK;QACpD,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;QAClC,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,CAAC;KAC3C,CAAC;CACH,CAAC;AAEF,MAAM,MAAM,oBAAoB,CAAC,QAAQ,GAAG,GAAG,EAAE,QAAQ,GAAG,GAAG,IAAI,eAAe,CAAC;IACjF,IAAI,CAAC,EAAE,UAAU,CAAC;IAClB,MAAM,CAAC,EAAE;QACP,KAAK,CAAC,EAAE,OAAO,CAAC;QAChB,GAAG,CAAC,EAAE,OAAO,CAAC;KACf,CAAC;IACF,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,MAAM,CAAC,EAAE,YAAY,CAAC,QAAQ,CAAC,CAAC;IAChC,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,UAAU,CAAC,EAAE,iBAAiB,CAAC,QAAQ,CAAC,CAAC;IACzC,UAAU,CAAC,EAAE,MAAM,GAAG,CAAC;IACvB,WAAW,CAAC,EAAE,CAAC,IAAI,EAAE,eAAe,CAAC,QAAQ,CAAC,EAAE,KAAK,EAAE,UAAU,KAAK,IAAI,CAAC;IAC3E,kBAAkB,CAAC,EAAE,CAAC,IAAI,EAAE,eAAe,CAAC,QAAQ,CAAC,EAAE,KAAK,EAAE,UAAU,KAAK,IAAI,CAAC;IAClF,WAAW,CAAC,EAAE,CAAC,IAAI,EAAE,eAAe,CAAC,QAAQ,EAAE,QAAQ,CAAC,EAAE,KAAK,EAAE,UAAU,KAAK,IAAI,CAAC;CACtF,CAAC,CAAC;AAOH;;GAEG;AACH,qBAAa,aAAa,CAAC,QAAQ,GAAG,GAAG,EAAE,QAAQ,GAAG,GAAG,CAAE,SAAQ,QAAQ,CACzE,WAAW,CAAC,QAAQ,EAAE,QAAQ,CAAC,EAC/B,oBAAoB,CAAC,QAAQ,EAAE,QAAQ,CAAC,CACzC;IACU,MAAM,CAAC,MAAM,EAAE,WAAW,CAAC,QAAQ,EAAE,QAAQ,CAAC;IAiJvD;;;OAGG;IACH,UAAU,CAAC,IAAI,EAAE,eAAe,CAAC,QAAQ,CAAC;CAG3C"}
1
+ {"version":3,"file":"graph-renderer.d.ts","sourceRoot":"","sources":["../../../../../src/graph/renderer/graph-renderer.ts"],"names":[],"mappings":"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"}
@@ -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,EAAqB,KAAK,UAAU,EAAE,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;gBAGjB,QAAQ,EAAE,UAAU,EACpB,KAAK,EAAE,SAAS,CAAC,WAAW,CAAC,EAChD,OAAO,CAAC,EAAE,OAAO,CAAC,OAAO,CAAC;IAU5B,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;CACtC"}
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"}
@@ -2,7 +2,7 @@ import { type Graph } from '@dxos/graph';
2
2
  import { type Point } from '../util';
3
3
  export type IdAccessor<N = any> = (node: N) => string;
4
4
  export declare const defaultIdAccessor: IdAccessor;
5
- export declare const emptyGraph: Graph;
5
+ export declare const emptyGraph: Graph.Any;
6
6
  export type GraphGuide = {
7
7
  id: string;
8
8
  type: string;
@@ -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,KAGxB,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"}