@deck.gl-community/graph-layers 9.2.0-beta.2 → 9.2.0-beta.3

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 (232) hide show
  1. package/dist/core/graph-engine.d.ts +63 -21
  2. package/dist/core/graph-engine.d.ts.map +1 -1
  3. package/dist/core/graph-engine.js +155 -75
  4. package/dist/core/graph-engine.js.map +1 -1
  5. package/dist/core/graph-layout.d.ts +22 -18
  6. package/dist/core/graph-layout.d.ts.map +1 -1
  7. package/dist/core/graph-layout.js +33 -18
  8. package/dist/core/graph-layout.js.map +1 -1
  9. package/dist/core/interaction-manager.d.ts +2 -2
  10. package/dist/core/interaction-manager.d.ts.map +1 -1
  11. package/dist/core/interaction-manager.js +7 -5
  12. package/dist/core/interaction-manager.js.map +1 -1
  13. package/dist/graph/arrow-graph.d.ts +69 -0
  14. package/dist/graph/arrow-graph.d.ts.map +1 -0
  15. package/dist/graph/arrow-graph.js +513 -0
  16. package/dist/graph/arrow-graph.js.map +1 -0
  17. package/dist/graph/classic-graph.d.ts +169 -0
  18. package/dist/graph/classic-graph.d.ts.map +1 -0
  19. package/dist/graph/classic-graph.js +390 -0
  20. package/dist/graph/classic-graph.js.map +1 -0
  21. package/dist/graph/edge.d.ts +6 -6
  22. package/dist/graph/edge.d.ts.map +1 -1
  23. package/dist/graph/edge.js.map +1 -1
  24. package/dist/graph/functions/arrow-utils.d.ts +6 -0
  25. package/dist/graph/functions/arrow-utils.d.ts.map +1 -0
  26. package/dist/graph/functions/arrow-utils.js +67 -0
  27. package/dist/graph/functions/arrow-utils.js.map +1 -0
  28. package/dist/graph/functions/create-graph-from-data.d.ts +3 -0
  29. package/dist/graph/functions/create-graph-from-data.d.ts.map +1 -0
  30. package/dist/graph/functions/create-graph-from-data.js +12 -0
  31. package/dist/graph/functions/create-graph-from-data.js.map +1 -0
  32. package/dist/graph/graph-normalization.d.ts +10 -0
  33. package/dist/graph/graph-normalization.d.ts.map +1 -0
  34. package/dist/graph/graph-normalization.js +65 -0
  35. package/dist/graph/graph-normalization.js.map +1 -0
  36. package/dist/graph/graph.d.ts +62 -155
  37. package/dist/graph/graph.d.ts.map +1 -1
  38. package/dist/graph/graph.js +11 -300
  39. package/dist/graph/graph.js.map +1 -1
  40. package/dist/graph/node.d.ts +6 -6
  41. package/dist/graph/node.d.ts.map +1 -1
  42. package/dist/graph/node.js +2 -2
  43. package/dist/graph/node.js.map +1 -1
  44. package/dist/graph-data/arrow-graph-data-builder.d.ts +21 -0
  45. package/dist/graph-data/arrow-graph-data-builder.d.ts.map +1 -0
  46. package/dist/graph-data/arrow-graph-data-builder.js +105 -0
  47. package/dist/graph-data/arrow-graph-data-builder.js.map +1 -0
  48. package/dist/graph-data/graph-data-builder.d.ts +6 -0
  49. package/dist/graph-data/graph-data-builder.d.ts.map +1 -0
  50. package/dist/graph-data/graph-data-builder.js +1 -0
  51. package/dist/graph-data/graph-data-builder.js.map +1 -0
  52. package/dist/graph-data/graph-data.d.ts +40 -0
  53. package/dist/graph-data/graph-data.d.ts.map +1 -0
  54. package/dist/graph-data/graph-data.js +11 -0
  55. package/dist/graph-data/graph-data.js.map +1 -0
  56. package/dist/graph-data/plain-graph-data-builder.d.ts +20 -0
  57. package/dist/graph-data/plain-graph-data-builder.d.ts.map +1 -0
  58. package/dist/graph-data/plain-graph-data-builder.js +105 -0
  59. package/dist/graph-data/plain-graph-data-builder.js.map +1 -0
  60. package/dist/graph-style-schema.cdn.js +1 -1
  61. package/dist/graph-style-schema.json +1 -1
  62. package/dist/index.cjs +6905 -4576
  63. package/dist/index.cjs.map +4 -4
  64. package/dist/index.d.ts +14 -7
  65. package/dist/index.d.ts.map +1 -1
  66. package/dist/index.js +24 -11
  67. package/dist/index.js.map +1 -1
  68. package/dist/layers/common-layers/flow-path-layer/flow-path-layer.d.ts.map +1 -1
  69. package/dist/layers/common-layers/flow-path-layer/flow-path-layer.js +1 -2
  70. package/dist/layers/common-layers/flow-path-layer/flow-path-layer.js.map +1 -1
  71. package/dist/layers/common-layers/grid-layer/grid-layer.d.ts +83 -0
  72. package/dist/layers/common-layers/grid-layer/grid-layer.d.ts.map +1 -0
  73. package/dist/layers/common-layers/grid-layer/grid-layer.js +133 -0
  74. package/dist/layers/common-layers/grid-layer/grid-layer.js.map +1 -0
  75. package/dist/layers/edge-attachment-helper.d.ts.map +1 -1
  76. package/dist/layers/edge-attachment-helper.js +1 -2
  77. package/dist/layers/edge-attachment-helper.js.map +1 -1
  78. package/dist/layers/graph-layer.d.ts +68 -11
  79. package/dist/layers/graph-layer.d.ts.map +1 -1
  80. package/dist/layers/graph-layer.js +435 -50
  81. package/dist/layers/graph-layer.js.map +1 -1
  82. package/dist/layouts/d3-dag/collapsable-d3-dag-layout.d.ts +24 -0
  83. package/dist/layouts/d3-dag/collapsable-d3-dag-layout.d.ts.map +1 -0
  84. package/dist/layouts/d3-dag/collapsable-d3-dag-layout.js +251 -0
  85. package/dist/layouts/d3-dag/collapsable-d3-dag-layout.js.map +1 -0
  86. package/dist/layouts/d3-dag/d3-dag-layout.d.ts +46 -61
  87. package/dist/layouts/d3-dag/d3-dag-layout.d.ts.map +1 -1
  88. package/dist/layouts/d3-dag/d3-dag-layout.js +85 -270
  89. package/dist/layouts/d3-dag/d3-dag-layout.js.map +1 -1
  90. package/dist/layouts/d3-force/d3-force-layout.d.ts +20 -8
  91. package/dist/layouts/d3-force/d3-force-layout.d.ts.map +1 -1
  92. package/dist/layouts/d3-force/d3-force-layout.js +39 -20
  93. package/dist/layouts/d3-force/d3-force-layout.js.map +1 -1
  94. package/dist/layouts/experimental/force-multi-graph-layout.d.ts +19 -15
  95. package/dist/layouts/experimental/force-multi-graph-layout.d.ts.map +1 -1
  96. package/dist/layouts/experimental/force-multi-graph-layout.js +47 -38
  97. package/dist/layouts/experimental/force-multi-graph-layout.js.map +1 -1
  98. package/dist/layouts/experimental/hive-plot-layout.d.ts +18 -15
  99. package/dist/layouts/experimental/hive-plot-layout.d.ts.map +1 -1
  100. package/dist/layouts/experimental/hive-plot-layout.js +33 -34
  101. package/dist/layouts/experimental/hive-plot-layout.js.map +1 -1
  102. package/dist/layouts/experimental/radial-layout.d.ts +12 -7
  103. package/dist/layouts/experimental/radial-layout.d.ts.map +1 -1
  104. package/dist/layouts/experimental/radial-layout.js +31 -14
  105. package/dist/layouts/experimental/radial-layout.js.map +1 -1
  106. package/dist/layouts/gpu-force/gpu-force-layout.d.ts +11 -8
  107. package/dist/layouts/gpu-force/gpu-force-layout.d.ts.map +1 -1
  108. package/dist/layouts/gpu-force/gpu-force-layout.js +59 -56
  109. package/dist/layouts/gpu-force/gpu-force-layout.js.map +1 -1
  110. package/dist/layouts/simple-layout.d.ts +8 -25
  111. package/dist/layouts/simple-layout.d.ts.map +1 -1
  112. package/dist/layouts/simple-layout.js +13 -17
  113. package/dist/layouts/simple-layout.js.map +1 -1
  114. package/dist/loaders/dot-graph-loader.d.ts +25 -0
  115. package/dist/loaders/dot-graph-loader.d.ts.map +1 -0
  116. package/dist/loaders/dot-graph-loader.js +668 -0
  117. package/dist/loaders/dot-graph-loader.js.map +1 -0
  118. package/dist/loaders/json-graph-loader.d.ts +6 -0
  119. package/dist/loaders/json-graph-loader.d.ts.map +1 -0
  120. package/dist/loaders/json-graph-loader.js +31 -0
  121. package/dist/loaders/json-graph-loader.js.map +1 -0
  122. package/dist/loaders/{edge-parsers.d.ts → parsers/edge-parsers.d.ts} +1 -1
  123. package/dist/loaders/parsers/edge-parsers.d.ts.map +1 -0
  124. package/dist/loaders/{edge-parsers.js → parsers/edge-parsers.js} +1 -1
  125. package/dist/loaders/parsers/edge-parsers.js.map +1 -0
  126. package/dist/loaders/{node-parsers.d.ts → parsers/node-parsers.d.ts} +1 -1
  127. package/dist/loaders/parsers/node-parsers.d.ts.map +1 -0
  128. package/dist/loaders/{node-parsers.js → parsers/node-parsers.js} +1 -1
  129. package/dist/loaders/parsers/node-parsers.js.map +1 -0
  130. package/dist/loaders/parsers/parse-json-graph.d.ts +29 -0
  131. package/dist/loaders/parsers/parse-json-graph.d.ts.map +1 -0
  132. package/dist/loaders/parsers/parse-json-graph.js +78 -0
  133. package/dist/loaders/parsers/parse-json-graph.js.map +1 -0
  134. package/dist/style/graph-style-engine.d.ts +4 -2
  135. package/dist/style/graph-style-engine.d.ts.map +1 -1
  136. package/dist/style/graph-style-engine.js +3 -2
  137. package/dist/style/graph-style-engine.js.map +1 -1
  138. package/dist/style/{style-engine.d.ts → stylesheet-engine.d.ts} +3 -3
  139. package/dist/style/stylesheet-engine.d.ts.map +1 -0
  140. package/dist/style/{style-engine.js → stylesheet-engine.js} +1 -1
  141. package/dist/style/stylesheet-engine.js.map +1 -0
  142. package/dist/utils/collapsed-chains.d.ts +8 -8
  143. package/dist/utils/collapsed-chains.d.ts.map +1 -1
  144. package/dist/utils/collapsed-chains.js +1 -6
  145. package/dist/utils/collapsed-chains.js.map +1 -1
  146. package/dist/utils/rank-grid.d.ts +30 -0
  147. package/dist/utils/rank-grid.d.ts.map +1 -0
  148. package/dist/utils/rank-grid.js +306 -0
  149. package/dist/utils/rank-grid.js.map +1 -0
  150. package/package.json +4 -8
  151. package/src/_disabled/arrow-graph-data.ts.disabled +18 -0
  152. package/src/_disabled/columnar-graph-data-builder.ts.disabled +250 -0
  153. package/src/_disabled/graph-runtime-layout.ts.disabled +29 -0
  154. package/src/core/graph-engine.ts +201 -84
  155. package/src/core/graph-layout.ts +52 -29
  156. package/src/core/interaction-manager.ts +20 -20
  157. package/src/graph/arrow-graph.ts +648 -0
  158. package/src/graph/classic-graph.ts +447 -0
  159. package/src/graph/edge.ts +7 -7
  160. package/src/graph/functions/arrow-utils.ts +72 -0
  161. package/src/graph/functions/convert-arrow-graph-to-classic-graph.ts.disabled +47 -0
  162. package/src/graph/functions/convert-plain-graph-to-arrow-graph.ts.disabled +119 -0
  163. package/src/graph/functions/create-graph-from-data.ts +16 -0
  164. package/src/graph/functions/create-plain-graph-from-data.ts.disabled +176 -0
  165. package/src/graph/graph-normalization.ts +87 -0
  166. package/src/graph/graph.ts +68 -339
  167. package/src/graph/node.ts +9 -9
  168. package/src/graph/tabular-graph.ts.disabled +761 -0
  169. package/src/graph-data/arrow-graph-data-builder.ts +165 -0
  170. package/src/graph-data/graph-data-builder.ts +7 -0
  171. package/src/graph-data/graph-data.ts +57 -0
  172. package/src/graph-data/plain-graph-data-builder.ts +132 -0
  173. package/src/index.ts +53 -13
  174. package/src/layers/common-layers/flow-path-layer/flow-path-layer.ts +1 -2
  175. package/src/layers/common-layers/grid-layer/grid-layer.ts +237 -0
  176. package/src/layers/edge-attachment-helper.ts +22 -16
  177. package/src/layers/graph-layer.ts +642 -62
  178. package/src/layouts/d3-dag/collapsable-d3-dag-layout.ts +330 -0
  179. package/src/layouts/d3-dag/d3-dag-layout.ts +166 -396
  180. package/src/layouts/d3-force/d3-force-layout.ts +52 -30
  181. package/src/layouts/experimental/force-multi-graph-layout.ts +55 -49
  182. package/src/layouts/experimental/hive-plot-layout.ts +41 -42
  183. package/src/layouts/experimental/radial-layout.ts +39 -20
  184. package/src/layouts/gpu-force/gpu-force-layout.ts +72 -70
  185. package/src/layouts/simple-layout.ts +20 -44
  186. package/src/loaders/{create-graph.ts → deprecated/create-graph.ts.disabled} +6 -6
  187. package/src/loaders/deprecated/json-classic-graph-loader.ts.disabled +33 -0
  188. package/src/loaders/{simple-json-graph-loader.ts → deprecated/simple-json-graph-loader.ts.disabled} +3 -3
  189. package/src/loaders/{table-graph-loader.ts → deprecated/table-graph-loader.ts.disabled} +8 -8
  190. package/src/loaders/dot-graph-loader.ts +860 -0
  191. package/src/loaders/json-graph-loader.ts +48 -0
  192. package/src/loaders/parsers/create-graph-data.ts.disabled +45 -0
  193. package/src/loaders/{edge-parsers.ts → parsers/edge-parsers.ts} +2 -2
  194. package/src/loaders/{node-parsers.ts → parsers/node-parsers.ts} +2 -2
  195. package/src/loaders/parsers/parse-json-graph.ts +134 -0
  196. package/src/style/graph-style-engine.ts +5 -2
  197. package/src/style/{style-engine.ts → stylesheet-engine.ts} +3 -3
  198. package/src/utils/collapsed-chains.ts +11 -17
  199. package/src/utils/rank-grid.ts +426 -0
  200. package/dist/loaders/create-graph.d.ts +0 -12
  201. package/dist/loaders/create-graph.d.ts.map +0 -1
  202. package/dist/loaders/create-graph.js +0 -38
  203. package/dist/loaders/create-graph.js.map +0 -1
  204. package/dist/loaders/edge-parsers.d.ts.map +0 -1
  205. package/dist/loaders/edge-parsers.js.map +0 -1
  206. package/dist/loaders/json-loader.d.ts +0 -7
  207. package/dist/loaders/json-loader.d.ts.map +0 -1
  208. package/dist/loaders/json-loader.js +0 -16
  209. package/dist/loaders/json-loader.js.map +0 -1
  210. package/dist/loaders/node-parsers.d.ts.map +0 -1
  211. package/dist/loaders/node-parsers.js.map +0 -1
  212. package/dist/loaders/simple-json-graph-loader.d.ts +0 -11
  213. package/dist/loaders/simple-json-graph-loader.d.ts.map +0 -1
  214. package/dist/loaders/simple-json-graph-loader.js +0 -20
  215. package/dist/loaders/simple-json-graph-loader.js.map +0 -1
  216. package/dist/loaders/table-graph-loader.d.ts +0 -16
  217. package/dist/loaders/table-graph-loader.d.ts.map +0 -1
  218. package/dist/loaders/table-graph-loader.js +0 -91
  219. package/dist/loaders/table-graph-loader.js.map +0 -1
  220. package/dist/style/style-engine.d.ts.map +0 -1
  221. package/dist/style/style-engine.js.map +0 -1
  222. package/dist/widgets/long-press-button.d.ts +0 -12
  223. package/dist/widgets/long-press-button.d.ts.map +0 -1
  224. package/dist/widgets/long-press-button.js +0 -31
  225. package/dist/widgets/long-press-button.js.map +0 -1
  226. package/dist/widgets/view-control-widget.d.ts +0 -77
  227. package/dist/widgets/view-control-widget.d.ts.map +0 -1
  228. package/dist/widgets/view-control-widget.js +0 -197
  229. package/dist/widgets/view-control-widget.js.map +0 -1
  230. package/src/loaders/json-loader.ts +0 -19
  231. package/src/widgets/long-press-button.tsx +0 -50
  232. package/src/widgets/view-control-widget.tsx +0 -339
@@ -0,0 +1,306 @@
1
+ // deck.gl-community
2
+ // SPDX-License-Identifier: MIT
3
+ // Copyright (c) vis.gl contributors
4
+ function distributeEvenSpacing(positions, start, end) {
5
+ const count = positions.length;
6
+ if (count === 0) {
7
+ return;
8
+ }
9
+ if (count === 1) {
10
+ positions[0].yPosition = start;
11
+ return;
12
+ }
13
+ const step = (end - start) / (count - 1);
14
+ for (let i = 0; i < count; i++) {
15
+ positions[i].yPosition = start + step * i;
16
+ }
17
+ }
18
+ function fallbackMonotonicSpacing(positions) {
19
+ if (positions.length === 0) {
20
+ return;
21
+ }
22
+ let previous = positions[0].yPosition;
23
+ for (let i = 1; i < positions.length; i++) {
24
+ const current = positions[i].yPosition;
25
+ if (!(current > previous)) {
26
+ previous += 1;
27
+ positions[i].yPosition = previous;
28
+ }
29
+ else {
30
+ previous = current;
31
+ }
32
+ }
33
+ }
34
+ function enforceMonotonicPositions(positions, range) {
35
+ if (positions.length === 0) {
36
+ return;
37
+ }
38
+ const hasFiniteMin = Number.isFinite(range.min);
39
+ const hasFiniteMax = Number.isFinite(range.max);
40
+ if (positions.length === 1) {
41
+ if (hasFiniteMin) {
42
+ positions[0].yPosition = range.min;
43
+ }
44
+ return;
45
+ }
46
+ if (hasFiniteMin && hasFiniteMax && range.max > range.min) {
47
+ distributeEvenSpacing(positions, range.min, range.max);
48
+ return;
49
+ }
50
+ if (hasFiniteMin) {
51
+ positions[0].yPosition = range.min;
52
+ }
53
+ fallbackMonotonicSpacing(positions);
54
+ }
55
+ function resolveTargetRange(range, override) {
56
+ const overrideMin = typeof override?.min === 'number' && Number.isFinite(override.min) ? override.min : undefined;
57
+ const overrideMax = typeof override?.max === 'number' && Number.isFinite(override.max) ? override.max : undefined;
58
+ const candidateMin = overrideMin ?? range.min;
59
+ const candidateMax = overrideMax ?? range.max;
60
+ const min = Number.isFinite(candidateMin) ? candidateMin : range.min;
61
+ const max = Number.isFinite(candidateMax) ? candidateMax : range.max;
62
+ return { min, max };
63
+ }
64
+ function accumulateRank(node, getRank, getLabel, getPosition, state) {
65
+ const { aggregates, range } = state;
66
+ const rank = getRank(node);
67
+ if (typeof rank !== 'number' || !Number.isFinite(rank)) {
68
+ return;
69
+ }
70
+ const position = getPosition(node);
71
+ if (!position) {
72
+ return;
73
+ }
74
+ const [, y] = position;
75
+ if (typeof y !== 'number' || !Number.isFinite(y)) {
76
+ return;
77
+ }
78
+ const entry = aggregates.get(rank) ?? { sum: 0, count: 0, label: null };
79
+ entry.sum += y;
80
+ entry.count += 1;
81
+ if (entry.label === null) {
82
+ const label = getLabel(node);
83
+ if (label !== null) {
84
+ entry.label = label;
85
+ }
86
+ }
87
+ aggregates.set(rank, entry);
88
+ range.min = Math.min(range.min, y);
89
+ range.max = Math.max(range.max, y);
90
+ }
91
+ function normalizeRankAccessor(accessor) {
92
+ if (!accessor) {
93
+ return (node) => {
94
+ const value = node.getPropertyValue('srank');
95
+ if (typeof value === 'number' && Number.isFinite(value)) {
96
+ return value;
97
+ }
98
+ if (typeof value === 'string') {
99
+ const parsed = Number(value);
100
+ return Number.isFinite(parsed) ? parsed : null;
101
+ }
102
+ return null;
103
+ };
104
+ }
105
+ if (typeof accessor === 'function') {
106
+ return (node) => {
107
+ const value = accessor(node);
108
+ if (typeof value === 'number' && Number.isFinite(value)) {
109
+ return value;
110
+ }
111
+ if (typeof value === 'string') {
112
+ const parsed = Number(value);
113
+ return Number.isFinite(parsed) ? parsed : null;
114
+ }
115
+ return null;
116
+ };
117
+ }
118
+ return (node) => {
119
+ const value = node.getPropertyValue(accessor);
120
+ if (typeof value === 'number' && Number.isFinite(value)) {
121
+ return value;
122
+ }
123
+ if (typeof value === 'string') {
124
+ const parsed = Number(value);
125
+ return Number.isFinite(parsed) ? parsed : null;
126
+ }
127
+ return null;
128
+ };
129
+ }
130
+ function normalizeLabelAccessor(accessor) {
131
+ if (!accessor) {
132
+ return (node) => {
133
+ const value = node.getPropertyValue('rankLabel');
134
+ if (value === undefined || value === null || value === '') {
135
+ return null;
136
+ }
137
+ if (typeof value === 'number' || typeof value === 'string') {
138
+ return value;
139
+ }
140
+ return null;
141
+ };
142
+ }
143
+ if (typeof accessor === 'function') {
144
+ return (node) => {
145
+ const value = accessor(node);
146
+ if (value === undefined || value === null || value === '') {
147
+ return null;
148
+ }
149
+ if (typeof value === 'number' || typeof value === 'string') {
150
+ return value;
151
+ }
152
+ return null;
153
+ };
154
+ }
155
+ return (node) => {
156
+ const value = node.getPropertyValue(accessor);
157
+ if (value === undefined || value === null || value === '') {
158
+ return null;
159
+ }
160
+ if (typeof value === 'number' || typeof value === 'string') {
161
+ return value;
162
+ }
163
+ return null;
164
+ };
165
+ }
166
+ /**
167
+ * Builds a mapping from rank identifiers to averaged y positions.
168
+ */
169
+ export function mapRanksToYPositions(nodes, getPosition, options) {
170
+ const getRank = normalizeRankAccessor(options?.rankAccessor);
171
+ const getLabel = normalizeLabelAccessor(options?.labelAccessor);
172
+ const state = {
173
+ aggregates: new Map(),
174
+ range: { min: Number.POSITIVE_INFINITY, max: Number.NEGATIVE_INFINITY }
175
+ };
176
+ for (const node of nodes) {
177
+ accumulateRank(node, getRank, getLabel, getPosition, state);
178
+ }
179
+ const { aggregates, range } = state;
180
+ const positions = Array.from(aggregates.entries()).map(([rank, { sum, count, label }]) => ({
181
+ rank,
182
+ yPosition: count ? sum / count : 0,
183
+ label: label ?? rank
184
+ }));
185
+ positions.sort((a, b) => a.rank - b.rank);
186
+ const needsRemap = positions.some((entry, index) => index > 0 && entry.yPosition <= positions[index - 1].yPosition);
187
+ if (needsRemap) {
188
+ const targetRange = resolveTargetRange(range, options?.yRange);
189
+ enforceMonotonicPositions(positions, targetRange);
190
+ }
191
+ return positions;
192
+ }
193
+ function locateInsertionIndex(ranks, target) {
194
+ let low = 0;
195
+ let high = ranks.length - 1;
196
+ while (low < high) {
197
+ const mid = Math.floor((low + high) / 2);
198
+ if (ranks[mid].yPosition < target) {
199
+ low = mid + 1;
200
+ }
201
+ else {
202
+ high = mid;
203
+ }
204
+ }
205
+ return low;
206
+ }
207
+ function pickNearestAvailableIndex(ranks, target, startIndex, used) {
208
+ let bestIndex = -1;
209
+ let bestDistance = Number.POSITIVE_INFINITY;
210
+ const consider = (index) => {
211
+ if (index < 0 || index >= ranks.length || used.has(index)) {
212
+ return;
213
+ }
214
+ const distance = Math.abs(ranks[index].yPosition - target);
215
+ const isCloser = distance < bestDistance;
216
+ const isTie = distance === bestDistance && bestIndex !== -1;
217
+ if (isCloser || (isTie && (ranks[index].yPosition < ranks[bestIndex].yPosition || index < bestIndex))) {
218
+ bestDistance = distance;
219
+ bestIndex = index;
220
+ }
221
+ };
222
+ consider(startIndex);
223
+ consider(startIndex - 1);
224
+ for (let offset = 1; bestIndex === -1 && (startIndex - offset >= 0 || startIndex + offset < ranks.length); offset++) {
225
+ consider(startIndex - offset);
226
+ consider(startIndex + offset);
227
+ }
228
+ return bestIndex;
229
+ }
230
+ function findFallbackIndex(ranks, used) {
231
+ for (let i = 0; i < ranks.length; i++) {
232
+ if (!used.has(i)) {
233
+ return i;
234
+ }
235
+ }
236
+ return -1;
237
+ }
238
+ function findClosestAvailableIndex(ranks, target, used) {
239
+ if (ranks.length === 0) {
240
+ return -1;
241
+ }
242
+ const insertionIndex = locateInsertionIndex(ranks, target);
243
+ const nearest = pickNearestAvailableIndex(ranks, target, insertionIndex, used);
244
+ if (nearest !== -1) {
245
+ return nearest;
246
+ }
247
+ const fallback = findFallbackIndex(ranks, used);
248
+ if (fallback !== -1) {
249
+ return fallback;
250
+ }
251
+ return Math.min(Math.max(insertionIndex, 0), ranks.length - 1);
252
+ }
253
+ function computeTargetRatios(count) {
254
+ if (count <= 1) {
255
+ return [0.5];
256
+ }
257
+ const step = 1 / (count - 1);
258
+ return Array.from({ length: count }, (_, index) => index * step);
259
+ }
260
+ function fillRemainingSelections(used, lastIndex, maxCount) {
261
+ for (let i = 0; used.size < maxCount && i <= lastIndex; i++) {
262
+ used.add(i);
263
+ }
264
+ }
265
+ function chooseEvenlySpacedIndices(ranks, maxCount) {
266
+ const lastIndex = ranks.length - 1;
267
+ const start = ranks[0].yPosition;
268
+ const end = ranks[lastIndex].yPosition;
269
+ const span = end - start;
270
+ const used = new Set();
271
+ for (const ratio of computeTargetRatios(maxCount)) {
272
+ const target = span !== 0 ? start + ratio * span : start;
273
+ const index = findClosestAvailableIndex(ranks, target, used);
274
+ if (index !== -1) {
275
+ used.add(index);
276
+ }
277
+ }
278
+ fillRemainingSelections(used, lastIndex, maxCount);
279
+ return Array.from(used).sort((a, b) => a - b).slice(0, maxCount);
280
+ }
281
+ /**
282
+ * Selects a subset of rank positions that are evenly distributed within a range.
283
+ */
284
+ export function selectRankLines(ranks, { yMin, yMax, maxCount = 8 }) {
285
+ if (!Number.isFinite(yMin) || !Number.isFinite(yMax) || maxCount <= 0) {
286
+ return [];
287
+ }
288
+ const min = Math.min(yMin, yMax);
289
+ const max = Math.max(yMin, yMax);
290
+ const filtered = ranks
291
+ .filter((entry) => Number.isFinite(entry.yPosition) && entry.yPosition >= min && entry.yPosition <= max)
292
+ .sort((a, b) => a.yPosition - b.yPosition);
293
+ if (filtered.length === 0) {
294
+ return [];
295
+ }
296
+ if (filtered.length <= maxCount) {
297
+ return filtered;
298
+ }
299
+ if (maxCount === 1) {
300
+ const midpoint = (filtered[0].yPosition + filtered[filtered.length - 1].yPosition) / 2;
301
+ const index = findClosestAvailableIndex(filtered, midpoint, new Set());
302
+ return index === -1 ? [filtered[0]] : [filtered[index]];
303
+ }
304
+ const selected = chooseEvenlySpacedIndices(filtered, maxCount);
305
+ return selected.map((index) => filtered[index]);
306
+ }
@@ -0,0 +1 @@
1
+ {"version":3,"file":"rank-grid.js","sourceRoot":"","sources":["../../src/utils/rank-grid.ts"],"names":[],"mappings":"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"}
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@deck.gl-community/graph-layers",
3
- "version": "9.2.0-beta.2",
3
+ "version": "9.2.0-beta.3",
4
4
  "description": "WebGL2-Powered library for Graph Visualization",
5
5
  "keywords": [
6
6
  "graph",
@@ -46,20 +46,16 @@
46
46
  "@luma.gl/engine": "~9.2.0",
47
47
  "@luma.gl/shadertools": "~9.2.0",
48
48
  "@probe.gl/log": "^4.0.4",
49
+ "apache-arrow": "^17.0.0",
49
50
  "cardinal-spline-js": "^2.3.10",
50
51
  "color": "^4.2.3",
51
52
  "core-js": "^3.29.0",
52
- "d3": "^7.8.2",
53
53
  "d3-array": "^3.2.2",
54
54
  "d3-dag": "^1.1.0",
55
55
  "d3-force": "^3.0.0",
56
56
  "d3-format": "^3.1.0",
57
57
  "d3-scale": "^4.0.2",
58
- "global": "^4.4.0",
59
- "lodash.isequal": "^4.5.0",
60
- "lodash.pick": "^4.4.0",
61
- "preact": "^10.17.0",
62
- "raf": "^3.4.1"
58
+ "lodash.isequal": "^4.5.0"
63
59
  },
64
60
  "devDependencies": {
65
61
  "ngraph.generators": "^20.1.0",
@@ -69,5 +65,5 @@
69
65
  "peerDependencies": {
70
66
  "zod": "^3.23.8 || ^4.0.0"
71
67
  },
72
- "gitHead": "b434bcba10800f27e95a7c9e6c4c7edd0b915773"
68
+ "gitHead": "6110b774c8be16f199ecdf67723851a2e34901e5"
73
69
  }
@@ -0,0 +1,18 @@
1
+ // deck.gl-community
2
+ // SPDX-License-Identifier: MIT
3
+ // Copyright (c) vis.gl contributors
4
+
5
+ import type {Table} from 'apache-arrow';
6
+
7
+ export type ArrowGraphData = {
8
+ type?: 'arrow-graph-data';
9
+ version: number;
10
+ nodes: Table;
11
+ edges: Table;
12
+ };
13
+
14
+ export function isArrowGraphData(value: unknown): value is ArrowGraphData {
15
+ const candidate = value as ArrowGraphData;
16
+ return typeof value === 'object' && candidate?.type === 'arrow-graph-data';
17
+ }
18
+
@@ -0,0 +1,250 @@
1
+ // deck.gl-community
2
+ // SPDX-License-Identifier: MIT
3
+ // Copyright (c) vis.gl contributors
4
+
5
+ import type {NodeState, EdgeState} from '../core/constants';
6
+ import type {GraphNodeData, GraphEdgeData} from './graph-data';
7
+ import {
8
+ cloneDataColumn,
9
+ cloneRecord,
10
+ normalizeEdgeState,
11
+ normalizeNodeState,
12
+ normalizeVersion
13
+ } from '../graph/graph-normalization';
14
+
15
+ export type ColumnarGraphDataBuilderOptions = {
16
+ nodeCapacity?: number;
17
+ edgeCapacity?: number;
18
+ version?: number;
19
+ };
20
+
21
+ export interface ColumnarGraphNodeColumns {
22
+ id: (string | number)[];
23
+ state?: NodeState[];
24
+ selectable?: boolean[];
25
+ highlightConnectedEdges?: boolean[];
26
+ data?: Record<string, unknown>[];
27
+ [columnName: string]: unknown;
28
+ }
29
+
30
+ export interface ColumnarGraphEdgeColumns {
31
+ id: (string | number)[];
32
+ sourceId: (string | number)[];
33
+ targetId: (string | number)[];
34
+ directed?: boolean[];
35
+ state?: EdgeState[];
36
+ data?: Record<string, unknown>[];
37
+ [columnName: string]: unknown;
38
+ }
39
+
40
+ export interface ColumnarGraphColumns {
41
+ type?: 'columnar-graph-data';
42
+ version?: number;
43
+ nodes: ColumnarGraphNodeColumns;
44
+ edges: ColumnarGraphEdgeColumns;
45
+ }
46
+
47
+ type MutableNodeColumns = {
48
+ id: (string | number)[];
49
+ state: NodeState[];
50
+ selectable: boolean[];
51
+ highlightConnectedEdges: boolean[];
52
+ data: Record<string, unknown>[];
53
+ };
54
+
55
+ type MutableEdgeColumns = {
56
+ id: (string | number)[];
57
+ sourceId: (string | number)[];
58
+ targetId: (string | number)[];
59
+ directed: boolean[];
60
+ state: EdgeState[];
61
+ data: Record<string, unknown>[];
62
+ };
63
+
64
+ export class ColumnarGraphDataBuilder {
65
+ private nodeColumns: MutableNodeColumns;
66
+ private edgeColumns: MutableEdgeColumns;
67
+
68
+ private nodeCapacity: number;
69
+ private edgeCapacity: number;
70
+
71
+ private nodeLength = 0;
72
+ private edgeLength = 0;
73
+
74
+ private _version: number;
75
+
76
+ constructor(options: ColumnarGraphDataBuilderOptions = {}) {
77
+ this.nodeCapacity = Math.max(0, options.nodeCapacity ?? 0);
78
+ this.edgeCapacity = Math.max(0, options.edgeCapacity ?? 0);
79
+ this.nodeColumns = createMutableNodeColumns(this.nodeCapacity);
80
+ this.edgeColumns = createMutableEdgeColumns(this.edgeCapacity);
81
+ this._version = normalizeVersion(options.version);
82
+ }
83
+
84
+ get version(): number {
85
+ return this._version;
86
+ }
87
+
88
+ setVersion(version: unknown): void {
89
+ this._version = normalizeVersion(version);
90
+ }
91
+
92
+ get nodeCount(): number {
93
+ return this.nodeLength;
94
+ }
95
+
96
+ get edgeCount(): number {
97
+ return this.edgeLength;
98
+ }
99
+
100
+ addNode(node: GraphNodeData): number {
101
+ if (typeof node?.id === 'undefined') {
102
+ throw new Error('Graph node requires an "id" field.');
103
+ }
104
+
105
+ this.ensureNodeCapacity(this.nodeLength + 1);
106
+
107
+ const index = this.nodeLength++;
108
+ const attributes = cloneRecord(node.attributes);
109
+
110
+ if (typeof node.label !== 'undefined') {
111
+ attributes.label = node.label;
112
+ }
113
+
114
+ if (typeof node.weight !== 'undefined') {
115
+ attributes.weight = node.weight;
116
+ }
117
+
118
+ const stateCandidate = node.state ?? (attributes.state as NodeState | undefined);
119
+ const selectableCandidate = node.selectable ?? (attributes.selectable as boolean | undefined);
120
+ const highlightCandidate =
121
+ node.highlightConnectedEdges ?? (attributes.highlightConnectedEdges as boolean | undefined);
122
+
123
+ this.nodeColumns.id[index] = node.id;
124
+ this.nodeColumns.state[index] = normalizeNodeState(stateCandidate);
125
+ this.nodeColumns.selectable[index] = Boolean(selectableCandidate);
126
+ this.nodeColumns.highlightConnectedEdges[index] = Boolean(highlightCandidate);
127
+ this.nodeColumns.data[index] = attributes;
128
+
129
+ return index;
130
+ }
131
+
132
+ addEdge(edge: GraphEdgeData): number {
133
+ if (
134
+ typeof edge?.id === 'undefined' ||
135
+ typeof edge?.sourceId === 'undefined' ||
136
+ typeof edge?.targetId === 'undefined'
137
+ ) {
138
+ throw new Error('Graph edge requires "id", "sourceId", and "targetId" fields.');
139
+ }
140
+
141
+ this.ensureEdgeCapacity(this.edgeLength + 1);
142
+
143
+ const index = this.edgeLength++;
144
+ const attributes = cloneRecord(edge.attributes);
145
+
146
+ if (typeof edge.label !== 'undefined') {
147
+ attributes.label = edge.label;
148
+ }
149
+
150
+ if (typeof edge.weight !== 'undefined') {
151
+ attributes.weight = edge.weight;
152
+ }
153
+
154
+ const stateCandidate = edge.state ?? (attributes.state as EdgeState | undefined);
155
+ const directedCandidate = edge.directed ?? (attributes.directed as boolean | undefined);
156
+
157
+ this.edgeColumns.id[index] = edge.id;
158
+ this.edgeColumns.sourceId[index] = edge.sourceId;
159
+ this.edgeColumns.targetId[index] = edge.targetId;
160
+ this.edgeColumns.directed[index] = Boolean(directedCandidate);
161
+ this.edgeColumns.state[index] = normalizeEdgeState(stateCandidate);
162
+ this.edgeColumns.data[index] = attributes;
163
+
164
+ return index;
165
+ }
166
+
167
+ build(): ColumnarGraphColumns {
168
+ return {
169
+ type: 'columnar-graph-data',
170
+ version: this._version,
171
+ nodes: {
172
+ id: this.nodeColumns.id.slice(0, this.nodeLength),
173
+ state: this.nodeColumns.state.slice(0, this.nodeLength),
174
+ selectable: this.nodeColumns.selectable.slice(0, this.nodeLength),
175
+ highlightConnectedEdges: this.nodeColumns.highlightConnectedEdges.slice(0, this.nodeLength),
176
+ data: cloneDataColumn(this.nodeColumns.data, this.nodeLength)
177
+ },
178
+ edges: {
179
+ id: this.edgeColumns.id.slice(0, this.edgeLength),
180
+ sourceId: this.edgeColumns.sourceId.slice(0, this.edgeLength),
181
+ targetId: this.edgeColumns.targetId.slice(0, this.edgeLength),
182
+ directed: this.edgeColumns.directed.slice(0, this.edgeLength),
183
+ state: this.edgeColumns.state.slice(0, this.edgeLength),
184
+ data: cloneDataColumn(this.edgeColumns.data, this.edgeLength)
185
+ }
186
+ };
187
+ }
188
+
189
+ private ensureNodeCapacity(minCapacity: number): void {
190
+ if (this.nodeCapacity >= minCapacity) {
191
+ return;
192
+ }
193
+
194
+ const nextCapacity = Math.max(8, this.nodeCapacity * 2, minCapacity);
195
+ const nextColumns = createMutableNodeColumns(nextCapacity);
196
+
197
+ for (let i = 0; i < this.nodeLength; i++) {
198
+ nextColumns.id[i] = this.nodeColumns.id[i];
199
+ nextColumns.state[i] = this.nodeColumns.state[i];
200
+ nextColumns.selectable[i] = this.nodeColumns.selectable[i];
201
+ nextColumns.highlightConnectedEdges[i] = this.nodeColumns.highlightConnectedEdges[i];
202
+ nextColumns.data[i] = this.nodeColumns.data[i];
203
+ }
204
+
205
+ this.nodeColumns = nextColumns;
206
+ this.nodeCapacity = nextCapacity;
207
+ }
208
+
209
+ private ensureEdgeCapacity(minCapacity: number): void {
210
+ if (this.edgeCapacity >= minCapacity) {
211
+ return;
212
+ }
213
+
214
+ const nextCapacity = Math.max(8, this.edgeCapacity * 2, minCapacity);
215
+ const nextColumns = createMutableEdgeColumns(nextCapacity);
216
+
217
+ for (let i = 0; i < this.edgeLength; i++) {
218
+ nextColumns.id[i] = this.edgeColumns.id[i];
219
+ nextColumns.sourceId[i] = this.edgeColumns.sourceId[i];
220
+ nextColumns.targetId[i] = this.edgeColumns.targetId[i];
221
+ nextColumns.directed[i] = this.edgeColumns.directed[i];
222
+ nextColumns.state[i] = this.edgeColumns.state[i];
223
+ nextColumns.data[i] = this.edgeColumns.data[i];
224
+ }
225
+
226
+ this.edgeColumns = nextColumns;
227
+ this.edgeCapacity = nextCapacity;
228
+ }
229
+ }
230
+
231
+ function createMutableNodeColumns(capacity: number): MutableNodeColumns {
232
+ return {
233
+ id: new Array<string | number>(capacity),
234
+ state: new Array<NodeState>(capacity),
235
+ selectable: new Array<boolean>(capacity),
236
+ highlightConnectedEdges: new Array<boolean>(capacity),
237
+ data: new Array<Record<string, unknown>>(capacity)
238
+ };
239
+ }
240
+
241
+ function createMutableEdgeColumns(capacity: number): MutableEdgeColumns {
242
+ return {
243
+ id: new Array<string | number>(capacity),
244
+ sourceId: new Array<string | number>(capacity),
245
+ targetId: new Array<string | number>(capacity),
246
+ directed: new Array<boolean>(capacity),
247
+ state: new Array<EdgeState>(capacity),
248
+ data: new Array<Record<string, unknown>>(capacity)
249
+ };
250
+ }
@@ -0,0 +1,29 @@
1
+ // deck.gl-community
2
+ // SPDX-License-Identifier: MIT
3
+ // Copyright (c) vis.gl contributors
4
+
5
+ import type {Bounds2D} from '@math.gl/types';
6
+
7
+ import type {GraphLayoutProps, GraphLayoutState} from './graph-layout';
8
+ import type {EdgeInterface, Graph, NodeInterface} from '../graph/graph';
9
+
10
+ export interface GraphRuntimeLayout {
11
+ readonly version: number;
12
+ readonly state: GraphLayoutState;
13
+ getProps(): GraphLayoutProps;
14
+ setProps(props: Partial<GraphLayoutProps>): void;
15
+ initializeGraph(graph: Graph): void;
16
+ updateGraph(graph: Graph): void;
17
+ start(): void;
18
+ update(): void;
19
+ resume(): void;
20
+ stop(): void;
21
+ getBounds(): Bounds2D | null;
22
+ getNodePosition(node: NodeInterface): [number, number] | null | undefined;
23
+ getEdgePosition(edge: EdgeInterface): unknown;
24
+ lockNodePosition(node: NodeInterface, x: number, y: number): void;
25
+ unlockNodePosition(node: NodeInterface): void;
26
+ destroy?(): void;
27
+ }
28
+
29
+ export type TabularGraphLayout = GraphRuntimeLayout;