@molecule/app-feature-graph-view-angular 0.0.0-stage → 0.0.1-stage
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.
- package/LICENSE +202 -0
- package/README.md +10 -2
- package/dist/graph-view.component.d.ts +123 -0
- package/dist/graph-view.component.d.ts.map +1 -0
- package/dist/graph-view.component.js +393 -0
- package/dist/graph-view.component.js.map +1 -0
- package/dist/index.d.ts +67 -0
- package/dist/index.d.ts.map +1 -0
- package/dist/index.js +67 -0
- package/dist/index.js.map +1 -0
- package/dist/layout.d.ts +101 -0
- package/dist/layout.d.ts.map +1 -0
- package/dist/layout.js +239 -0
- package/dist/layout.js.map +1 -0
- package/dist/types.d.ts +99 -0
- package/dist/types.d.ts.map +1 -0
- package/dist/types.js +2 -0
- package/dist/types.js.map +1 -0
- package/package.json +73 -4
|
@@ -0,0 +1,393 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* GraphView component (React parity): the Angular counterpart of
|
|
3
|
+
* `@molecule/app-feature-graph-view-react`'s `<GraphView>` — the same props
|
|
4
|
+
* (React names), the same classes, and the same DOM for the same input.
|
|
5
|
+
*
|
|
6
|
+
* @module
|
|
7
|
+
*/
|
|
8
|
+
import { NgTemplateOutlet } from '@angular/common';
|
|
9
|
+
import { Component } from '@angular/core';
|
|
10
|
+
import { useTranslation } from '@molecule/app-angular';
|
|
11
|
+
import { getClassMap } from '@molecule/app-ui';
|
|
12
|
+
import { boundingBox, layoutNodes } from './layout.js';
|
|
13
|
+
import * as i0 from "@angular/core";
|
|
14
|
+
const _c0 = (a0, a1, a2) => ({ a0: a0, a1: a1, a2: a2 });
|
|
15
|
+
const _c1 = a0 => ({ a0: a0 });
|
|
16
|
+
const _forTrack0 = ($index, $item) => $item.edge.id;
|
|
17
|
+
const _forTrack1 = ($index, $item) => $item.id;
|
|
18
|
+
function GraphView_Conditional_0_Template(rf, ctx) { if (rf & 1) {
|
|
19
|
+
i0.ɵɵelementStart(0, "div", 2);
|
|
20
|
+
i0.ɵɵtext(1);
|
|
21
|
+
i0.ɵɵelementEnd();
|
|
22
|
+
} if (rf & 2) {
|
|
23
|
+
const ctx_r0 = i0.ɵɵnextContext();
|
|
24
|
+
i0.ɵɵclassMap(ctx_r0.emptyClasses());
|
|
25
|
+
i0.ɵɵstyleProp("inset", "0px")("display", "grid")("place-items", "center");
|
|
26
|
+
i0.ɵɵadvance();
|
|
27
|
+
i0.ɵɵtextInterpolate1(" ", ctx_r0.emptyLabel(), " ");
|
|
28
|
+
} }
|
|
29
|
+
function GraphView_Conditional_1_For_3_Conditional_0_Template(rf, ctx) { if (rf & 1) {
|
|
30
|
+
i0.ɵɵnamespaceSVG();
|
|
31
|
+
i0.ɵɵelementStart(0, "g");
|
|
32
|
+
i0.ɵɵelementContainer(1, 8);
|
|
33
|
+
i0.ɵɵelementEnd();
|
|
34
|
+
} if (rf & 2) {
|
|
35
|
+
const item_r2 = i0.ɵɵnextContext().$implicit;
|
|
36
|
+
const ctx_r0 = i0.ɵɵnextContext(2);
|
|
37
|
+
i0.ɵɵattribute("data-mol-id", "graph-view-edge-" + item_r2.edge.id);
|
|
38
|
+
i0.ɵɵadvance();
|
|
39
|
+
i0.ɵɵproperty("ngTemplateOutlet", ctx_r0.edgeRenderer)("ngTemplateOutletContext", i0.ɵɵpureFunction3(3, _c0, item_r2.edge, item_r2.src, item_r2.tgt));
|
|
40
|
+
} }
|
|
41
|
+
function GraphView_Conditional_1_For_3_Conditional_1_Template(rf, ctx) { if (rf & 1) {
|
|
42
|
+
i0.ɵɵnamespaceSVG();
|
|
43
|
+
i0.ɵɵelement(0, "line", 7);
|
|
44
|
+
} if (rf & 2) {
|
|
45
|
+
const item_r2 = i0.ɵɵnextContext().$implicit;
|
|
46
|
+
i0.ɵɵattribute("data-mol-id", "graph-view-edge-" + item_r2.edge.id)("x1", item_r2.src.x)("y1", item_r2.src.y)("x2", item_r2.tgt.x)("y2", item_r2.tgt.y);
|
|
47
|
+
} }
|
|
48
|
+
function GraphView_Conditional_1_For_3_Template(rf, ctx) { if (rf & 1) {
|
|
49
|
+
i0.ɵɵconditionalCreate(0, GraphView_Conditional_1_For_3_Conditional_0_Template, 2, 7, "g")(1, GraphView_Conditional_1_For_3_Conditional_1_Template, 1, 5, "line", 7);
|
|
50
|
+
} if (rf & 2) {
|
|
51
|
+
const ctx_r0 = i0.ɵɵnextContext(2);
|
|
52
|
+
i0.ɵɵconditional(ctx_r0.edgeRenderer ? 0 : 1);
|
|
53
|
+
} }
|
|
54
|
+
function GraphView_Conditional_1_For_6_Conditional_1_Template(rf, ctx) { if (rf & 1) {
|
|
55
|
+
i0.ɵɵnamespaceSVG();
|
|
56
|
+
i0.ɵɵelementContainer(0, 8);
|
|
57
|
+
} if (rf & 2) {
|
|
58
|
+
const node_r4 = i0.ɵɵnextContext().$implicit;
|
|
59
|
+
const ctx_r0 = i0.ɵɵnextContext(2);
|
|
60
|
+
i0.ɵɵproperty("ngTemplateOutlet", ctx_r0.nodeRenderer)("ngTemplateOutletContext", i0.ɵɵpureFunction1(2, _c1, node_r4));
|
|
61
|
+
} }
|
|
62
|
+
function GraphView_Conditional_1_For_6_Conditional_2_Template(rf, ctx) { if (rf & 1) {
|
|
63
|
+
i0.ɵɵnamespaceSVG();
|
|
64
|
+
i0.ɵɵelementStart(0, "g");
|
|
65
|
+
i0.ɵɵelement(1, "circle", 10);
|
|
66
|
+
i0.ɵɵelementStart(2, "text", 11);
|
|
67
|
+
i0.ɵɵtext(3);
|
|
68
|
+
i0.ɵɵelementEnd()();
|
|
69
|
+
} if (rf & 2) {
|
|
70
|
+
const node_r4 = i0.ɵɵnextContext().$implicit;
|
|
71
|
+
const ctx_r0 = i0.ɵɵnextContext(2);
|
|
72
|
+
i0.ɵɵattribute("data-mol-id", "graph-view-node-" + node_r4.id)("data-selected", ctx_r0.isSelected(node_r4) ? "true" : "false")("transform", "translate(" + node_r4.x + ", " + node_r4.y + ")");
|
|
73
|
+
i0.ɵɵadvance();
|
|
74
|
+
i0.ɵɵattribute("r", ctx_r0.radius(node_r4))("opacity", ctx_r0.isSelected(node_r4) ? 1 : 0.85)("stroke-width", ctx_r0.isSelected(node_r4) ? 2 : 0);
|
|
75
|
+
i0.ɵɵadvance();
|
|
76
|
+
i0.ɵɵstyleProp("pointer-events", "none")("user-select", "none");
|
|
77
|
+
i0.ɵɵattribute("x", ctx_r0.radius(node_r4) + 4)("opacity", ctx_r0.isSelected(node_r4) ? 1 : 0.75);
|
|
78
|
+
i0.ɵɵadvance();
|
|
79
|
+
i0.ɵɵtextInterpolate1(" ", node_r4.label, " ");
|
|
80
|
+
} }
|
|
81
|
+
function GraphView_Conditional_1_For_6_Template(rf, ctx) { if (rf & 1) {
|
|
82
|
+
const _r3 = i0.ɵɵgetCurrentView();
|
|
83
|
+
i0.ɵɵnamespaceSVG();
|
|
84
|
+
i0.ɵɵelementStart(0, "g", 9);
|
|
85
|
+
i0.ɵɵlistener("click", function GraphView_Conditional_1_For_6_Template_g_click_0_listener() { const node_r4 = i0.ɵɵrestoreView(_r3).$implicit; const ctx_r0 = i0.ɵɵnextContext(2); return i0.ɵɵresetView(ctx_r0.activate(node_r4)); })("keydown", function GraphView_Conditional_1_For_6_Template_g_keydown_0_listener($event) { const node_r4 = i0.ɵɵrestoreView(_r3).$implicit; const ctx_r0 = i0.ɵɵnextContext(2); return i0.ɵɵresetView(ctx_r0.keydown($event, node_r4)); });
|
|
86
|
+
i0.ɵɵconditionalCreate(1, GraphView_Conditional_1_For_6_Conditional_1_Template, 1, 4, "ng-container", 8)(2, GraphView_Conditional_1_For_6_Conditional_2_Template, 4, 13, "g");
|
|
87
|
+
i0.ɵɵelementEnd();
|
|
88
|
+
} if (rf & 2) {
|
|
89
|
+
const node_r4 = ctx.$implicit;
|
|
90
|
+
const ctx_r0 = i0.ɵɵnextContext(2);
|
|
91
|
+
i0.ɵɵstyleProp("cursor", ctx_r0.onNodeClick ? "pointer" : "default")("outline", "none");
|
|
92
|
+
i0.ɵɵattribute("data-mol-id", "graph-view-node-hit-" + node_r4.id)("aria-label", ctx_r0.nodeAria(node_r4));
|
|
93
|
+
i0.ɵɵadvance();
|
|
94
|
+
i0.ɵɵconditional(ctx_r0.nodeRenderer ? 1 : 2);
|
|
95
|
+
} }
|
|
96
|
+
function GraphView_Conditional_1_Template(rf, ctx) { if (rf & 1) {
|
|
97
|
+
i0.ɵɵnamespaceSVG();
|
|
98
|
+
i0.ɵɵelementStart(0, "svg", 3)(1, "g", 4);
|
|
99
|
+
i0.ɵɵrepeaterCreate(2, GraphView_Conditional_1_For_3_Template, 2, 1, null, null, _forTrack0);
|
|
100
|
+
i0.ɵɵelementEnd();
|
|
101
|
+
i0.ɵɵelementStart(4, "g", 5);
|
|
102
|
+
i0.ɵɵrepeaterCreate(5, GraphView_Conditional_1_For_6_Template, 3, 7, "g", 6, _forTrack1);
|
|
103
|
+
i0.ɵɵelementEnd()();
|
|
104
|
+
} if (rf & 2) {
|
|
105
|
+
const ctx_r0 = i0.ɵɵnextContext();
|
|
106
|
+
i0.ɵɵstyleProp("display", "block");
|
|
107
|
+
i0.ɵɵattribute("viewBox", ctx_r0.viewBox());
|
|
108
|
+
i0.ɵɵadvance(2);
|
|
109
|
+
i0.ɵɵrepeater(ctx_r0.renderableEdges());
|
|
110
|
+
i0.ɵɵadvance(3);
|
|
111
|
+
i0.ɵɵrepeater(ctx_r0.positionedNodes());
|
|
112
|
+
} }
|
|
113
|
+
/** Default base radius (world units) of an unweighted node. */
|
|
114
|
+
const NODE_RADIUS = 8;
|
|
115
|
+
/**
|
|
116
|
+
* Force-directed graph view (Obsidian-style).
|
|
117
|
+
*
|
|
118
|
+
* Renders nodes + edges into an SVG, computing positions via a built-in
|
|
119
|
+
* minimal velocity-Verlet simulation. Three layouts are supported —
|
|
120
|
+
* `force` (default), `circular` and `grid` — and either nodes or edges
|
|
121
|
+
* can be overridden via custom templates.
|
|
122
|
+
*
|
|
123
|
+
* The host IS the outer `<div>` (`div[mol-graph-view]`), matching React's root
|
|
124
|
+
* exactly. Style is driven by `getClassMap()`. Inline styles are reserved for
|
|
125
|
+
* SVG geometry — `transform`, viewBox computation, stroke widths — which
|
|
126
|
+
* classes can't express.
|
|
127
|
+
*/
|
|
128
|
+
export class GraphView {
|
|
129
|
+
/** Nodes to render. */
|
|
130
|
+
nodes;
|
|
131
|
+
/** Edges to render. */
|
|
132
|
+
edges;
|
|
133
|
+
/** Fired when the user clicks (or activates) a node. */
|
|
134
|
+
onNodeClick;
|
|
135
|
+
/** Currently-selected node id (highlighted in the view). */
|
|
136
|
+
selectedNodeId;
|
|
137
|
+
/** Layout strategy (defaults to `'force'` at read time). */
|
|
138
|
+
layout;
|
|
139
|
+
/** Custom node renderer template. */
|
|
140
|
+
nodeRenderer;
|
|
141
|
+
/** Custom edge renderer template. */
|
|
142
|
+
edgeRenderer;
|
|
143
|
+
/** Force-layout tunables; ignored for non-force layouts. */
|
|
144
|
+
forceOptions;
|
|
145
|
+
/** Extra classes merged onto the outer wrapper. */
|
|
146
|
+
className;
|
|
147
|
+
/** The bonded translation function. */
|
|
148
|
+
i18n = useTranslation();
|
|
149
|
+
/**
|
|
150
|
+
* The current class map.
|
|
151
|
+
* @returns The UIClassMap.
|
|
152
|
+
*/
|
|
153
|
+
cm() {
|
|
154
|
+
return getClassMap();
|
|
155
|
+
}
|
|
156
|
+
/**
|
|
157
|
+
* Computes the wrapper class list.
|
|
158
|
+
* @returns The class string.
|
|
159
|
+
*/
|
|
160
|
+
classes() {
|
|
161
|
+
return this.cm().cn(this.cm().position('relative'), this.cm().surfaceSecondary, this.className);
|
|
162
|
+
}
|
|
163
|
+
/**
|
|
164
|
+
* Computes the empty-state class list.
|
|
165
|
+
* @returns The class string.
|
|
166
|
+
*/
|
|
167
|
+
emptyClasses() {
|
|
168
|
+
return this.cm().cn(this.cm().position('absolute'), this.cm().sp('p', 6));
|
|
169
|
+
}
|
|
170
|
+
/**
|
|
171
|
+
* The canvas' accessible name.
|
|
172
|
+
* @returns The translated label.
|
|
173
|
+
*/
|
|
174
|
+
ariaLabel() {
|
|
175
|
+
return this.i18n.t('graphView.aria.canvas', {}, { defaultValue: 'Graph view' });
|
|
176
|
+
}
|
|
177
|
+
/**
|
|
178
|
+
* The empty-state message.
|
|
179
|
+
* @returns The translated message.
|
|
180
|
+
*/
|
|
181
|
+
emptyLabel() {
|
|
182
|
+
return this.i18n.t('graphView.empty', {}, { defaultValue: 'No nodes to display' });
|
|
183
|
+
}
|
|
184
|
+
/**
|
|
185
|
+
* One node hit group's accessible name.
|
|
186
|
+
* @param node - The node.
|
|
187
|
+
* @returns The translated label.
|
|
188
|
+
*/
|
|
189
|
+
nodeAria(node) {
|
|
190
|
+
return this.i18n.t('graphView.aria.node', { label: node.label }, { defaultValue: 'Node {{label}}' });
|
|
191
|
+
}
|
|
192
|
+
/**
|
|
193
|
+
* World-space positions for every node, from the chosen layout. The force
|
|
194
|
+
* simulation is deterministic given a fixed seed, so repeated reads (change
|
|
195
|
+
* detection runs several) produce identical coordinates.
|
|
196
|
+
* @returns The positioned nodes.
|
|
197
|
+
*/
|
|
198
|
+
positionedNodes() {
|
|
199
|
+
return layoutNodes(this.nodes ?? [], this.edges ?? [], this.layout ?? 'force', this.forceOptions);
|
|
200
|
+
}
|
|
201
|
+
/**
|
|
202
|
+
* The edges whose endpoints both exist, with both endpoints resolved.
|
|
203
|
+
* @returns The renderable edges, in input order.
|
|
204
|
+
*/
|
|
205
|
+
renderableEdges() {
|
|
206
|
+
const byId = new Map();
|
|
207
|
+
for (const node of this.positionedNodes())
|
|
208
|
+
byId.set(node.id, node);
|
|
209
|
+
const out = [];
|
|
210
|
+
for (const edge of this.edges ?? []) {
|
|
211
|
+
const src = byId.get(edge.source);
|
|
212
|
+
const tgt = byId.get(edge.target);
|
|
213
|
+
if (src && tgt)
|
|
214
|
+
out.push({ edge, src, tgt });
|
|
215
|
+
}
|
|
216
|
+
return out;
|
|
217
|
+
}
|
|
218
|
+
/**
|
|
219
|
+
* The SVG viewBox that fits the layout bounds.
|
|
220
|
+
* @returns The viewBox string.
|
|
221
|
+
*/
|
|
222
|
+
viewBox() {
|
|
223
|
+
const box = boundingBox(this.positionedNodes(), 40);
|
|
224
|
+
return box
|
|
225
|
+
? `${box.minX} ${box.minY} ${Math.max(1, box.maxX - box.minX)} ${Math.max(1, box.maxY - box.minY)}`
|
|
226
|
+
: '-100 -100 200 200';
|
|
227
|
+
}
|
|
228
|
+
/**
|
|
229
|
+
* Whether a node is the selected one.
|
|
230
|
+
* @param node - The node.
|
|
231
|
+
* @returns True when it matches `selectedNodeId`.
|
|
232
|
+
*/
|
|
233
|
+
isSelected(node) {
|
|
234
|
+
return node.id === this.selectedNodeId;
|
|
235
|
+
}
|
|
236
|
+
/**
|
|
237
|
+
* The rendered radius of a node, scaled by its weight.
|
|
238
|
+
* @param node - The node.
|
|
239
|
+
* @returns The radius in world units.
|
|
240
|
+
*/
|
|
241
|
+
radius(node) {
|
|
242
|
+
return NODE_RADIUS * Math.sqrt(Math.max(0.25, node.weight ?? 1));
|
|
243
|
+
}
|
|
244
|
+
/**
|
|
245
|
+
* Calls `onNodeClick` for a node.
|
|
246
|
+
* @param node - The node.
|
|
247
|
+
*/
|
|
248
|
+
activate(node) {
|
|
249
|
+
this.onNodeClick?.(node);
|
|
250
|
+
}
|
|
251
|
+
/**
|
|
252
|
+
* Activates a node on Enter or Space, as React's keydown handler does.
|
|
253
|
+
* @param event - The keyboard event.
|
|
254
|
+
* @param node - The node.
|
|
255
|
+
*/
|
|
256
|
+
keydown(event, node) {
|
|
257
|
+
if (event.key === 'Enter' || event.key === ' ') {
|
|
258
|
+
event.preventDefault();
|
|
259
|
+
this.onNodeClick?.(node);
|
|
260
|
+
}
|
|
261
|
+
}
|
|
262
|
+
static ɵfac = function GraphView_Factory(__ngFactoryType__) { return new (__ngFactoryType__ || GraphView)(); };
|
|
263
|
+
static ɵcmp = /*@__PURE__*/ i0.ɵɵdefineComponent({ type: GraphView, selectors: [["div", "mol-graph-view", ""]], hostAttrs: ["role", "application", "data-mol-id", "graph-view"], hostVars: 9, hostBindings: function GraphView_HostBindings(rf, ctx) { if (rf & 2) {
|
|
264
|
+
i0.ɵɵattribute("aria-label", ctx.ariaLabel());
|
|
265
|
+
i0.ɵɵclassMap(ctx.classes());
|
|
266
|
+
i0.ɵɵstyleProp("width", "100%")("height", "100%")("overflow", "hidden");
|
|
267
|
+
} }, inputs: { nodes: "nodes", edges: "edges", onNodeClick: "onNodeClick", selectedNodeId: "selectedNodeId", layout: "layout", nodeRenderer: "nodeRenderer", edgeRenderer: "edgeRenderer", forceOptions: "forceOptions", className: "className" }, decls: 2, vars: 1, consts: [["data-mol-id", "graph-view-empty", "role", "status", 3, "class", "inset", "display", "place-items"], ["data-mol-id", "graph-view-svg", "width", "100%", "height", "100%", "preserveAspectRatio", "xMidYMid meet", 3, "display"], ["data-mol-id", "graph-view-empty", "role", "status"], ["data-mol-id", "graph-view-svg", "width", "100%", "height", "100%", "preserveAspectRatio", "xMidYMid meet"], ["data-mol-id", "graph-view-edges"], ["data-mol-id", "graph-view-nodes"], ["role", "button", "tabindex", "0", 3, "cursor", "outline"], ["stroke", "currentColor", "stroke-width", "1", "opacity", "0.4"], [3, "ngTemplateOutlet", "ngTemplateOutletContext"], ["role", "button", "tabindex", "0", 3, "click", "keydown"], ["fill", "currentColor", "stroke", "currentColor"], ["y", "4", "font-size", "11", "fill", "currentColor"]], template: function GraphView_Template(rf, ctx) { if (rf & 1) {
|
|
268
|
+
i0.ɵɵconditionalCreate(0, GraphView_Conditional_0_Template, 2, 9, "div", 0)(1, GraphView_Conditional_1_Template, 7, 3, "svg", 1);
|
|
269
|
+
} if (rf & 2) {
|
|
270
|
+
i0.ɵɵconditional(ctx.positionedNodes().length === 0 ? 0 : 1);
|
|
271
|
+
} }, dependencies: [NgTemplateOutlet], encapsulation: 2 });
|
|
272
|
+
}
|
|
273
|
+
(() => { (typeof ngDevMode === "undefined" || ngDevMode) && i0.ɵsetClassMetadata(GraphView, [{
|
|
274
|
+
type: Component,
|
|
275
|
+
args: [{
|
|
276
|
+
selector: 'div[mol-graph-view]',
|
|
277
|
+
standalone: true,
|
|
278
|
+
imports: [NgTemplateOutlet],
|
|
279
|
+
inputs: [
|
|
280
|
+
'nodes',
|
|
281
|
+
'edges',
|
|
282
|
+
'onNodeClick',
|
|
283
|
+
'selectedNodeId',
|
|
284
|
+
'layout',
|
|
285
|
+
'nodeRenderer',
|
|
286
|
+
'edgeRenderer',
|
|
287
|
+
'forceOptions',
|
|
288
|
+
'className',
|
|
289
|
+
],
|
|
290
|
+
host: {
|
|
291
|
+
role: 'application',
|
|
292
|
+
'[attr.aria-label]': 'ariaLabel()',
|
|
293
|
+
'data-mol-id': 'graph-view',
|
|
294
|
+
'[class]': 'classes()',
|
|
295
|
+
'[style.width]': '"100%"',
|
|
296
|
+
'[style.height]': '"100%"',
|
|
297
|
+
'[style.overflow]': '"hidden"',
|
|
298
|
+
},
|
|
299
|
+
template: `@if (positionedNodes().length === 0) {
|
|
300
|
+
<div
|
|
301
|
+
data-mol-id="graph-view-empty"
|
|
302
|
+
role="status"
|
|
303
|
+
[class]="emptyClasses()"
|
|
304
|
+
[style.inset]="'0px'"
|
|
305
|
+
[style.display]="'grid'"
|
|
306
|
+
[style.place-items]="'center'"
|
|
307
|
+
>
|
|
308
|
+
{{ emptyLabel() }}
|
|
309
|
+
</div>
|
|
310
|
+
} @else {
|
|
311
|
+
<svg
|
|
312
|
+
data-mol-id="graph-view-svg"
|
|
313
|
+
width="100%"
|
|
314
|
+
height="100%"
|
|
315
|
+
[attr.viewBox]="viewBox()"
|
|
316
|
+
preserveAspectRatio="xMidYMid meet"
|
|
317
|
+
[style.display]="'block'"
|
|
318
|
+
>
|
|
319
|
+
<g data-mol-id="graph-view-edges">
|
|
320
|
+
@for (item of renderableEdges(); track item.edge.id) {
|
|
321
|
+
@if (edgeRenderer) {
|
|
322
|
+
<g [attr.data-mol-id]="'graph-view-edge-' + item.edge.id">
|
|
323
|
+
<ng-container
|
|
324
|
+
[ngTemplateOutlet]="edgeRenderer"
|
|
325
|
+
[ngTemplateOutletContext]="{ a0: item.edge, a1: item.src, a2: item.tgt }"
|
|
326
|
+
/>
|
|
327
|
+
</g>
|
|
328
|
+
} @else {
|
|
329
|
+
<line
|
|
330
|
+
[attr.data-mol-id]="'graph-view-edge-' + item.edge.id"
|
|
331
|
+
[attr.x1]="item.src.x"
|
|
332
|
+
[attr.y1]="item.src.y"
|
|
333
|
+
[attr.x2]="item.tgt.x"
|
|
334
|
+
[attr.y2]="item.tgt.y"
|
|
335
|
+
stroke="currentColor"
|
|
336
|
+
stroke-width="1"
|
|
337
|
+
opacity="0.4"
|
|
338
|
+
/>
|
|
339
|
+
}
|
|
340
|
+
}
|
|
341
|
+
</g>
|
|
342
|
+
<g data-mol-id="graph-view-nodes">
|
|
343
|
+
@for (node of positionedNodes(); track node.id) {
|
|
344
|
+
<g
|
|
345
|
+
[attr.data-mol-id]="'graph-view-node-hit-' + node.id"
|
|
346
|
+
role="button"
|
|
347
|
+
[attr.aria-label]="nodeAria(node)"
|
|
348
|
+
tabindex="0"
|
|
349
|
+
(click)="activate(node)"
|
|
350
|
+
(keydown)="keydown($event, node)"
|
|
351
|
+
[style.cursor]="onNodeClick ? 'pointer' : 'default'"
|
|
352
|
+
[style.outline]="'none'"
|
|
353
|
+
>
|
|
354
|
+
@if (nodeRenderer) {
|
|
355
|
+
<ng-container
|
|
356
|
+
[ngTemplateOutlet]="nodeRenderer"
|
|
357
|
+
[ngTemplateOutletContext]="{ a0: node }"
|
|
358
|
+
/>
|
|
359
|
+
} @else {
|
|
360
|
+
<g
|
|
361
|
+
[attr.data-mol-id]="'graph-view-node-' + node.id"
|
|
362
|
+
[attr.data-selected]="isSelected(node) ? 'true' : 'false'"
|
|
363
|
+
[attr.transform]="'translate(' + node.x + ', ' + node.y + ')'"
|
|
364
|
+
>
|
|
365
|
+
<circle
|
|
366
|
+
[attr.r]="radius(node)"
|
|
367
|
+
fill="currentColor"
|
|
368
|
+
[attr.opacity]="isSelected(node) ? 1 : 0.85"
|
|
369
|
+
stroke="currentColor"
|
|
370
|
+
[attr.stroke-width]="isSelected(node) ? 2 : 0"
|
|
371
|
+
/>
|
|
372
|
+
<text
|
|
373
|
+
[attr.x]="radius(node) + 4"
|
|
374
|
+
y="4"
|
|
375
|
+
font-size="11"
|
|
376
|
+
fill="currentColor"
|
|
377
|
+
[attr.opacity]="isSelected(node) ? 1 : 0.75"
|
|
378
|
+
[style.pointer-events]="'none'"
|
|
379
|
+
[style.user-select]="'none'"
|
|
380
|
+
>
|
|
381
|
+
{{ node.label }}
|
|
382
|
+
</text>
|
|
383
|
+
</g>
|
|
384
|
+
}
|
|
385
|
+
</g>
|
|
386
|
+
}
|
|
387
|
+
</g>
|
|
388
|
+
</svg>
|
|
389
|
+
}`,
|
|
390
|
+
}]
|
|
391
|
+
}], null, null); })();
|
|
392
|
+
(() => { (typeof ngDevMode === "undefined" || ngDevMode) && i0.ɵsetClassDebugInfo(GraphView, { className: "GraphView", filePath: "graph-view.component.ts", lineNumber: 167 }); })();
|
|
393
|
+
//# sourceMappingURL=graph-view.component.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"graph-view.component.js","sourceRoot":"","sources":["../src/graph-view.component.ts"],"names":[],"mappings":"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"}
|
package/dist/index.d.ts
ADDED
|
@@ -0,0 +1,67 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Angular force-directed graph view (Obsidian-style) — the counterpart of
|
|
3
|
+
* `@molecule/app-feature-graph-view-react`: the same exports, the same props
|
|
4
|
+
* (React names), and the same DOM for the same input.
|
|
5
|
+
*
|
|
6
|
+
* Exports:
|
|
7
|
+
* - `<GraphView>` (`div[mol-graph-view]`) — top-level node-and-edge
|
|
8
|
+
* visualization with built-in `force`, `circular`, and `grid` layouts,
|
|
9
|
+
* click + selection support, and pluggable node / edge templates.
|
|
10
|
+
* - `GraphNode`, `GraphEdge`, `GraphLayout`, `GraphPoint`, `PositionedNode`,
|
|
11
|
+
* `GraphNodeRenderer`, `GraphEdgeRenderer`, `GraphViewProps` types.
|
|
12
|
+
* - Pure layout helpers (`forceLayout`, `circularLayout`, `gridLayout`,
|
|
13
|
+
* `layoutNodes`, `boundingBox`, `createRng`).
|
|
14
|
+
*
|
|
15
|
+
* Used by note-taking and other apps to visualize page / note linkages
|
|
16
|
+
* the same way Obsidian does — a force-directed map of which notes link
|
|
17
|
+
* to which.
|
|
18
|
+
*
|
|
19
|
+
* @example
|
|
20
|
+
* ```ts
|
|
21
|
+
* import { Component } from '@angular/core'
|
|
22
|
+
* import { GraphView, type GraphEdge, type GraphNode } from '@molecule/app-feature-graph-view-angular'
|
|
23
|
+
*
|
|
24
|
+
* const noteNodes: GraphNode[] = [
|
|
25
|
+
* { id: 'a', label: 'Alpha' },
|
|
26
|
+
* { id: 'b', label: 'Beta', group: 'project', weight: 2 },
|
|
27
|
+
* ]
|
|
28
|
+
* const linkEdges: GraphEdge[] = [{ id: 'e1', source: 'a', target: 'b' }]
|
|
29
|
+
*
|
|
30
|
+
* @Component({
|
|
31
|
+
* selector: 'app-note-graph',
|
|
32
|
+
* standalone: true,
|
|
33
|
+
* imports: [GraphView],
|
|
34
|
+
* template: `<div mol-graph-view [nodes]="nodes" [edges]="edges" [onNodeClick]="open"></div>`,
|
|
35
|
+
* })
|
|
36
|
+
* export class NoteGraph {
|
|
37
|
+
* nodes = noteNodes
|
|
38
|
+
* edges = linkEdges
|
|
39
|
+
* open(node: GraphNode): void {
|
|
40
|
+
* console.log(`open ${node.id}`)
|
|
41
|
+
* }
|
|
42
|
+
* }
|
|
43
|
+
* ```
|
|
44
|
+
*
|
|
45
|
+
* @remarks
|
|
46
|
+
* The root element fills 100% of its parent — the PARENT must have an
|
|
47
|
+
* explicit height (e.g. a fixed-height panel or a flex/grid track) or
|
|
48
|
+
* the graph renders zero-tall and appears blank.
|
|
49
|
+
*
|
|
50
|
+
* Interaction surface is click / keyboard-activate + `selectedNodeId`
|
|
51
|
+
* highlighting only. Nodes are NOT draggable and there is no built-in
|
|
52
|
+
* pan / zoom — the SVG `viewBox` auto-fits the layout bounds.
|
|
53
|
+
*
|
|
54
|
+
* The renderer props are Angular templates, rendered with `ngTemplateOutlet`:
|
|
55
|
+
* `nodeRenderer` receives the positioned node as `a0`; `edgeRenderer` receives
|
|
56
|
+
* the edge as `a0`, the source node as `a1` and the target node as `a2`.
|
|
57
|
+
*
|
|
58
|
+
* Layout is deterministic (seeded RNG), computed once per
|
|
59
|
+
* `(nodes, edges, layout, forceOptions)` change. `forceOptions` is
|
|
60
|
+
* ignored by the `circular` and `grid` layouts.
|
|
61
|
+
*
|
|
62
|
+
* @module
|
|
63
|
+
*/
|
|
64
|
+
export * from './graph-view.component.js';
|
|
65
|
+
export * from './layout.js';
|
|
66
|
+
export * from './types.js';
|
|
67
|
+
//# sourceMappingURL=index.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8DG;AAEH,cAAc,2BAA2B,CAAA;AACzC,cAAc,aAAa,CAAA;AAC3B,cAAc,YAAY,CAAA"}
|
package/dist/index.js
ADDED
|
@@ -0,0 +1,67 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Angular force-directed graph view (Obsidian-style) — the counterpart of
|
|
3
|
+
* `@molecule/app-feature-graph-view-react`: the same exports, the same props
|
|
4
|
+
* (React names), and the same DOM for the same input.
|
|
5
|
+
*
|
|
6
|
+
* Exports:
|
|
7
|
+
* - `<GraphView>` (`div[mol-graph-view]`) — top-level node-and-edge
|
|
8
|
+
* visualization with built-in `force`, `circular`, and `grid` layouts,
|
|
9
|
+
* click + selection support, and pluggable node / edge templates.
|
|
10
|
+
* - `GraphNode`, `GraphEdge`, `GraphLayout`, `GraphPoint`, `PositionedNode`,
|
|
11
|
+
* `GraphNodeRenderer`, `GraphEdgeRenderer`, `GraphViewProps` types.
|
|
12
|
+
* - Pure layout helpers (`forceLayout`, `circularLayout`, `gridLayout`,
|
|
13
|
+
* `layoutNodes`, `boundingBox`, `createRng`).
|
|
14
|
+
*
|
|
15
|
+
* Used by note-taking and other apps to visualize page / note linkages
|
|
16
|
+
* the same way Obsidian does — a force-directed map of which notes link
|
|
17
|
+
* to which.
|
|
18
|
+
*
|
|
19
|
+
* @example
|
|
20
|
+
* ```ts
|
|
21
|
+
* import { Component } from '@angular/core'
|
|
22
|
+
* import { GraphView, type GraphEdge, type GraphNode } from '@molecule/app-feature-graph-view-angular'
|
|
23
|
+
*
|
|
24
|
+
* const noteNodes: GraphNode[] = [
|
|
25
|
+
* { id: 'a', label: 'Alpha' },
|
|
26
|
+
* { id: 'b', label: 'Beta', group: 'project', weight: 2 },
|
|
27
|
+
* ]
|
|
28
|
+
* const linkEdges: GraphEdge[] = [{ id: 'e1', source: 'a', target: 'b' }]
|
|
29
|
+
*
|
|
30
|
+
* @Component({
|
|
31
|
+
* selector: 'app-note-graph',
|
|
32
|
+
* standalone: true,
|
|
33
|
+
* imports: [GraphView],
|
|
34
|
+
* template: `<div mol-graph-view [nodes]="nodes" [edges]="edges" [onNodeClick]="open"></div>`,
|
|
35
|
+
* })
|
|
36
|
+
* export class NoteGraph {
|
|
37
|
+
* nodes = noteNodes
|
|
38
|
+
* edges = linkEdges
|
|
39
|
+
* open(node: GraphNode): void {
|
|
40
|
+
* console.log(`open ${node.id}`)
|
|
41
|
+
* }
|
|
42
|
+
* }
|
|
43
|
+
* ```
|
|
44
|
+
*
|
|
45
|
+
* @remarks
|
|
46
|
+
* The root element fills 100% of its parent — the PARENT must have an
|
|
47
|
+
* explicit height (e.g. a fixed-height panel or a flex/grid track) or
|
|
48
|
+
* the graph renders zero-tall and appears blank.
|
|
49
|
+
*
|
|
50
|
+
* Interaction surface is click / keyboard-activate + `selectedNodeId`
|
|
51
|
+
* highlighting only. Nodes are NOT draggable and there is no built-in
|
|
52
|
+
* pan / zoom — the SVG `viewBox` auto-fits the layout bounds.
|
|
53
|
+
*
|
|
54
|
+
* The renderer props are Angular templates, rendered with `ngTemplateOutlet`:
|
|
55
|
+
* `nodeRenderer` receives the positioned node as `a0`; `edgeRenderer` receives
|
|
56
|
+
* the edge as `a0`, the source node as `a1` and the target node as `a2`.
|
|
57
|
+
*
|
|
58
|
+
* Layout is deterministic (seeded RNG), computed once per
|
|
59
|
+
* `(nodes, edges, layout, forceOptions)` change. `forceOptions` is
|
|
60
|
+
* ignored by the `circular` and `grid` layouts.
|
|
61
|
+
*
|
|
62
|
+
* @module
|
|
63
|
+
*/
|
|
64
|
+
export * from './graph-view.component.js';
|
|
65
|
+
export * from './layout.js';
|
|
66
|
+
export * from './types.js';
|
|
67
|
+
//# sourceMappingURL=index.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8DG;AAEH,cAAc,2BAA2B,CAAA;AACzC,cAAc,aAAa,CAAA;AAC3B,cAAc,YAAY,CAAA"}
|
package/dist/layout.d.ts
ADDED
|
@@ -0,0 +1,101 @@
|
|
|
1
|
+
import type { GraphEdge, GraphLayout, GraphNode, PositionedNode } from './types.js';
|
|
2
|
+
/**
|
|
3
|
+
* Pure (framework-free) layout helpers for `<GraphView>`. Extracted so the
|
|
4
|
+
* math is unit-testable without a component library or jsdom.
|
|
5
|
+
*
|
|
6
|
+
* @module
|
|
7
|
+
*/
|
|
8
|
+
/** Default cap on force-layout iterations. */
|
|
9
|
+
export declare const DEFAULT_FORCE_ITERATIONS = 200;
|
|
10
|
+
/** Default repulsion strength used by `forceLayout`. */
|
|
11
|
+
export declare const DEFAULT_REPULSION = 800;
|
|
12
|
+
/** Default spring stiffness used by `forceLayout`. */
|
|
13
|
+
export declare const DEFAULT_SPRING = 0.05;
|
|
14
|
+
/** Default ideal edge length used by `forceLayout`. */
|
|
15
|
+
export declare const DEFAULT_REST_LENGTH = 80;
|
|
16
|
+
/** Default velocity damping used by `forceLayout`. */
|
|
17
|
+
export declare const DEFAULT_DAMPING = 0.85;
|
|
18
|
+
/** Convergence threshold (max per-node displacement squared). */
|
|
19
|
+
export declare const CONVERGENCE_EPSILON = 0.01;
|
|
20
|
+
/** Force-layout tunables. */
|
|
21
|
+
export interface ForceLayoutOptions {
|
|
22
|
+
/** Hard cap on iterations. Defaults to {@link DEFAULT_FORCE_ITERATIONS}. */
|
|
23
|
+
iterations?: number;
|
|
24
|
+
/** Repulsive constant between every pair of nodes. */
|
|
25
|
+
repulsion?: number;
|
|
26
|
+
/** Spring (Hooke) constant for edges. */
|
|
27
|
+
spring?: number;
|
|
28
|
+
/** Ideal edge length (rest distance). */
|
|
29
|
+
restLength?: number;
|
|
30
|
+
/** Velocity damping per step (0–1). */
|
|
31
|
+
damping?: number;
|
|
32
|
+
/** Optional deterministic seed (for tests). Defaults to a fixed value. */
|
|
33
|
+
seed?: number;
|
|
34
|
+
}
|
|
35
|
+
/**
|
|
36
|
+
* Tiny deterministic PRNG (mulberry32). Allows reproducible initial
|
|
37
|
+
* positions in tests without depending on `Math.random()`.
|
|
38
|
+
*
|
|
39
|
+
* @param seed - 32-bit unsigned seed.
|
|
40
|
+
* @returns A function returning floats in `[0, 1)`.
|
|
41
|
+
*/
|
|
42
|
+
export declare function createRng(seed: number): () => number;
|
|
43
|
+
/**
|
|
44
|
+
* Place nodes evenly around the unit circle (scaled by `radius`).
|
|
45
|
+
*
|
|
46
|
+
* @param nodes - Nodes to position.
|
|
47
|
+
* @param radius - Circle radius in world units.
|
|
48
|
+
* @returns Positioned nodes, in input order.
|
|
49
|
+
*/
|
|
50
|
+
export declare function circularLayout(nodes: GraphNode[], radius: number): PositionedNode[];
|
|
51
|
+
/**
|
|
52
|
+
* Place nodes on a square-ish grid, centred on the origin.
|
|
53
|
+
*
|
|
54
|
+
* @param nodes - Nodes to position.
|
|
55
|
+
* @param spacing - Pixel spacing between adjacent grid cells.
|
|
56
|
+
* @returns Positioned nodes, in input order.
|
|
57
|
+
*/
|
|
58
|
+
export declare function gridLayout(nodes: GraphNode[], spacing: number): PositionedNode[];
|
|
59
|
+
/**
|
|
60
|
+
* Run a minimal velocity-Verlet force-directed simulation.
|
|
61
|
+
*
|
|
62
|
+
* Implements:
|
|
63
|
+
* - Pairwise repulsion (Coulomb-like, O(n²)) between every node pair.
|
|
64
|
+
* - Spring (Hooke) attraction along each edge toward `restLength`.
|
|
65
|
+
* - Per-step velocity damping for stability.
|
|
66
|
+
*
|
|
67
|
+
* Stops early once the maximum per-node displacement-squared drops below
|
|
68
|
+
* {@link CONVERGENCE_EPSILON}, or after `iterations` steps — whichever
|
|
69
|
+
* comes first.
|
|
70
|
+
*
|
|
71
|
+
* @param nodes - Nodes to lay out.
|
|
72
|
+
* @param edges - Edges (used only for attractive springs).
|
|
73
|
+
* @param options - Force-layout tunables.
|
|
74
|
+
* @returns Positioned nodes, in input order.
|
|
75
|
+
*/
|
|
76
|
+
export declare function forceLayout(nodes: GraphNode[], edges: GraphEdge[], options?: ForceLayoutOptions): PositionedNode[];
|
|
77
|
+
/**
|
|
78
|
+
* Compute world-space positions for every node using the chosen layout.
|
|
79
|
+
*
|
|
80
|
+
* @param nodes - Nodes to position.
|
|
81
|
+
* @param edges - Edges (consumed only by `force`).
|
|
82
|
+
* @param layout - Layout strategy.
|
|
83
|
+
* @param options - Optional force-layout tunables (ignored for non-force).
|
|
84
|
+
* @returns Positioned nodes.
|
|
85
|
+
*/
|
|
86
|
+
export declare function layoutNodes(nodes: GraphNode[], edges: GraphEdge[], layout: GraphLayout, options?: ForceLayoutOptions): PositionedNode[];
|
|
87
|
+
/**
|
|
88
|
+
* Compute the world-space bounding box of a set of positioned nodes,
|
|
89
|
+
* with a small padding for visual breathing room.
|
|
90
|
+
*
|
|
91
|
+
* @param nodes - Positioned nodes.
|
|
92
|
+
* @param padding - Padding (world units) added to every side. Default 40.
|
|
93
|
+
* @returns Bounding box `{ minX, minY, maxX, maxY }` — or `null` if empty.
|
|
94
|
+
*/
|
|
95
|
+
export declare function boundingBox(nodes: PositionedNode[], padding?: number): {
|
|
96
|
+
minX: number;
|
|
97
|
+
minY: number;
|
|
98
|
+
maxX: number;
|
|
99
|
+
maxY: number;
|
|
100
|
+
} | null;
|
|
101
|
+
//# sourceMappingURL=layout.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"layout.d.ts","sourceRoot":"","sources":["../src/layout.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,WAAW,EAAE,SAAS,EAAE,cAAc,EAAE,MAAM,YAAY,CAAA;AAEnF;;;;;GAKG;AAEH,8CAA8C;AAC9C,eAAO,MAAM,wBAAwB,MAAM,CAAA;AAE3C,wDAAwD;AACxD,eAAO,MAAM,iBAAiB,MAAM,CAAA;AAEpC,sDAAsD;AACtD,eAAO,MAAM,cAAc,OAAO,CAAA;AAElC,uDAAuD;AACvD,eAAO,MAAM,mBAAmB,KAAK,CAAA;AAErC,sDAAsD;AACtD,eAAO,MAAM,eAAe,OAAO,CAAA;AAEnC,iEAAiE;AACjE,eAAO,MAAM,mBAAmB,OAAO,CAAA;AAEvC,6BAA6B;AAC7B,MAAM,WAAW,kBAAkB;IACjC,4EAA4E;IAC5E,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,sDAAsD;IACtD,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,yCAAyC;IACzC,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,yCAAyC;IACzC,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,uCAAuC;IACvC,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,0EAA0E;IAC1E,IAAI,CAAC,EAAE,MAAM,CAAA;CACd;AAED;;;;;;GAMG;AACH,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,MAAM,CASpD;AAED;;;;;;GAMG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,SAAS,EAAE,EAAE,MAAM,EAAE,MAAM,GAAG,cAAc,EAAE,CAOnF;AAED;;;;;;GAMG;AACH,wBAAgB,UAAU,CAAC,KAAK,EAAE,SAAS,EAAE,EAAE,OAAO,EAAE,MAAM,GAAG,cAAc,EAAE,CAWhF;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,WAAW,CACzB,KAAK,EAAE,SAAS,EAAE,EAClB,KAAK,EAAE,SAAS,EAAE,EAClB,OAAO,GAAE,kBAAuB,GAC/B,cAAc,EAAE,CA0GlB;AAED;;;;;;;;GAQG;AACH,wBAAgB,WAAW,CACzB,KAAK,EAAE,SAAS,EAAE,EAClB,KAAK,EAAE,SAAS,EAAE,EAClB,MAAM,EAAE,WAAW,EACnB,OAAO,CAAC,EAAE,kBAAkB,GAC3B,cAAc,EAAE,CAUlB;AAED;;;;;;;GAOG;AACH,wBAAgB,WAAW,CACzB,KAAK,EAAE,cAAc,EAAE,EACvB,OAAO,SAAK,GACX;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,CAanE"}
|