@memberjunction/ng-graph-view 0.0.0 → 6.1.0-edge.3

package/dist/lib/models/graph-models.d.ts

@@ -0,0 +1,132 @@
+/**
+ * @fileoverview Domain models and configuration interfaces for `@memberjunction/ng-graph-view`.
+ *
+ * Provides strongly-typed data structures for representing entities as graph nodes,
+ * directed/undirected relationship edges, layout configurations, and viewport telemetry.
+ *
+ * @module @memberjunction/ng-graph-view
+ */
+/**
+ * Standard semantic category of a graph node, or any custom category key defined by the consumer.
+ */
+export type GraphNodeCategory = 'person' | 'organization' | 'committee' | 'account' | 'asset' | 'group' | 'custom' | (string & {});
+/**
+ * Configuration for a graph node category defining its visual appearance in the canvas,
+ * dynamic legend, and inspector drawer.
+ */
+export interface GraphCategoryConfig {
+    /** Unique category key matching GraphNode.Category (e.g. 'person', 'organization', 'vendor', 'role') */
+    Category: string;
+    /** Human-readable display label shown in the legend and node inspector */
+    Label: string;
+    /** Hex code, HSL, or CSS color variable (e.g. '#10b981' or 'var(--mj-brand-primary)') */
+    Color: string;
+    /** Font Awesome icon class (e.g. 'fa-solid fa-user') */
+    IconClass?: string;
+    /** Optional secondary stroke / accent color */
+    StrokeColor?: string;
+}
+/**
+ * Directional behavior of an edge in the network graph.
+ */
+export type GraphEdgeDirection = 'directed' | 'undirected' | 'bidirectional';
+/**
+ * Visual styling pattern for relationship edge lines.
+ */
+export type GraphEdgeStyle = 'solid' | 'dashed' | 'dotted';
+/**
+ * Layout simulation mode for graph positioning.
+ */
+export type GraphLayoutMode = 'force' | 'circular' | 'hierarchy' | 'grid';
+/**
+ * Represents a single node entity in the network graph.
+ */
+export interface GraphNode<TData = Record<string, unknown>> {
+    /** Unique identifier for the node */
+    ID: string;
+    /** Primary display label (e.g. Person Name, Organization Name) */
+    Label: string;
+    /** Secondary descriptive sublabel (e.g. Job Title, Industry) */
+    Sublabel?: string;
+    /** Semantic category defining the default icon and palette */
+    Category: GraphNodeCategory;
+    /** Optional Font Awesome icon class override (e.g. 'fa-solid fa-user') */
+    IconClass?: string;
+    /** Optional custom hex/HSL color or CSS color variable override */
+    Color?: string;
+    /** Node radius / diameter scale (default is 28) */
+    Radius?: number;
+    /** Optional small badge text or status indicator */
+    Badge?: string;
+    /** Distance from root/selected focus node in hops (0 = focal center) */
+    HopDistance?: number;
+    /** Current 2D simulation coordinates (uppercase for MJ models, lowercase for D3 compatibility) */
+    X?: number;
+    Y?: number;
+    VX?: number;
+    VY?: number;
+    FX?: number | null;
+    FY?: number | null;
+    x?: number;
+    y?: number;
+    vx?: number;
+    vy?: number;
+    fx?: number | null;
+    fy?: number | null;
+    index?: number;
+    /** Underlying business entity reference / data payload */
+    Data?: TData;
+}
+/**
+ * Represents a relationship edge between two nodes.
+ */
+export interface GraphEdge<TData = Record<string, unknown>> {
+    /** Unique identifier for the relationship edge */
+    ID: string;
+    /** Source node identifier */
+    SourceID: string;
+    /** Target node identifier */
+    TargetID: string;
+    /** D3 simulation link object references */
+    source?: string | GraphNode;
+    target?: string | GraphNode;
+    index?: number;
+    /** Relationship semantic label (e.g. 'Employed By', 'Board Member', 'Subsidiary Of') */
+    Label: string;
+    /** Directionality of the relationship */
+    Direction?: GraphEdgeDirection;
+    /** Edge thickness / weight (default is 2) */
+    Weight?: number;
+    /** Line style pattern */
+    Style?: GraphEdgeStyle;
+    /** Optional stroke color override */
+    Color?: string;
+    /** Whether to render an animated particle flow along the edge */
+    Animated?: boolean;
+    /** Underlying relationship entity reference / data payload */
+    Data?: TData;
+}
+/**
+ * Viewport zoom and pan transformation state.
+ */
+export interface GraphViewportTransform {
+    Scale: number;
+    PanX: number;
+    PanY: number;
+}
+/**
+ * Options for configuring graph layout physics simulation.
+ */
+export interface GraphPhysicsConfig {
+    /** Node repulsion charge strength (negative number, default -400) */
+    Repulsion: number;
+    /** Ideal spring link distance between connected nodes (default 120) */
+    LinkDistance: number;
+    /** Centering gravity force strength (default 0.05) */
+    Gravity: number;
+    /** Velocity damping coefficient between 0 and 1 (default 0.85) */
+    Damping: number;
+    /** Maximum simulation iterations before settling (default 300) */
+    MaxIterations: number;
+}
+//# sourceMappingURL=graph-models.d.ts.map

package/dist/lib/models/graph-models.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"graph-models.d.ts","sourceRoot":"","sources":["../../../src/lib/models/graph-models.ts"],"names":[],"mappings":"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"}

package/dist/lib/models/graph-models.js

@@ -0,0 +1,10 @@
+/**
+ * @fileoverview Domain models and configuration interfaces for `@memberjunction/ng-graph-view`.
+ *
+ * Provides strongly-typed data structures for representing entities as graph nodes,
+ * directed/undirected relationship edges, layout configurations, and viewport telemetry.
+ *
+ * @module @memberjunction/ng-graph-view
+ */
+export {};
+//# sourceMappingURL=graph-models.js.map

package/dist/lib/models/graph-models.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"graph-models.js","sourceRoot":"","sources":["../../../src/lib/models/graph-models.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG","sourcesContent":["/**\n * @fileoverview Domain models and configuration interfaces for `@memberjunction/ng-graph-view`.\n *\n * Provides strongly-typed data structures for representing entities as graph nodes,\n * directed/undirected relationship edges, layout configurations, and viewport telemetry.\n *\n * @module @memberjunction/ng-graph-view\n */\n\n/**\n * Standard semantic category of a graph node, or any custom category key defined by the consumer.\n */\nexport type GraphNodeCategory =\n    | 'person'\n    | 'organization'\n    | 'committee'\n    | 'account'\n    | 'asset'\n    | 'group'\n    | 'custom'\n    | (string & {});\n\n/**\n * Configuration for a graph node category defining its visual appearance in the canvas,\n * dynamic legend, and inspector drawer.\n */\nexport interface GraphCategoryConfig {\n    /** Unique category key matching GraphNode.Category (e.g. 'person', 'organization', 'vendor', 'role') */\n    Category: string;\n    /** Human-readable display label shown in the legend and node inspector */\n    Label: string;\n    /** Hex code, HSL, or CSS color variable (e.g. '#10b981' or 'var(--mj-brand-primary)') */\n    Color: string;\n    /** Font Awesome icon class (e.g. 'fa-solid fa-user') */\n    IconClass?: string;\n    /** Optional secondary stroke / accent color */\n    StrokeColor?: string;\n}\n\n/**\n * Directional behavior of an edge in the network graph.\n */\nexport type GraphEdgeDirection =\n    | 'directed'\n    | 'undirected'\n    | 'bidirectional';\n\n/**\n * Visual styling pattern for relationship edge lines.\n */\nexport type GraphEdgeStyle =\n    | 'solid'\n    | 'dashed'\n    | 'dotted';\n\n/**\n * Layout simulation mode for graph positioning.\n */\nexport type GraphLayoutMode =\n    | 'force'\n    | 'circular'\n    | 'hierarchy'\n    | 'grid';\n\n/**\n * Represents a single node entity in the network graph.\n */\nexport interface GraphNode<TData = Record<string, unknown>> {\n    /** Unique identifier for the node */\n    ID: string;\n\n    /** Primary display label (e.g. Person Name, Organization Name) */\n    Label: string;\n\n    /** Secondary descriptive sublabel (e.g. Job Title, Industry) */\n    Sublabel?: string;\n\n    /** Semantic category defining the default icon and palette */\n    Category: GraphNodeCategory;\n\n    /** Optional Font Awesome icon class override (e.g. 'fa-solid fa-user') */\n    IconClass?: string;\n\n    /** Optional custom hex/HSL color or CSS color variable override */\n    Color?: string;\n\n    /** Node radius / diameter scale (default is 28) */\n    Radius?: number;\n\n    /** Optional small badge text or status indicator */\n    Badge?: string;\n\n    /** Distance from root/selected focus node in hops (0 = focal center) */\n    HopDistance?: number;\n\n    /** Current 2D simulation coordinates (uppercase for MJ models, lowercase for D3 compatibility) */\n    X?: number;\n    Y?: number;\n    VX?: number;\n    VY?: number;\n    FX?: number | null;\n    FY?: number | null;\n\n    x?: number;\n    y?: number;\n    vx?: number;\n    vy?: number;\n    fx?: number | null;\n    fy?: number | null;\n    index?: number;\n\n    /** Underlying business entity reference / data payload */\n    Data?: TData;\n}\n\n/**\n * Represents a relationship edge between two nodes.\n */\nexport interface GraphEdge<TData = Record<string, unknown>> {\n    /** Unique identifier for the relationship edge */\n    ID: string;\n\n    /** Source node identifier */\n    SourceID: string;\n\n    /** Target node identifier */\n    TargetID: string;\n\n    /** D3 simulation link object references */\n    source?: string | GraphNode;\n    target?: string | GraphNode;\n    index?: number;\n\n    /** Relationship semantic label (e.g. 'Employed By', 'Board Member', 'Subsidiary Of') */\n    Label: string;\n\n    /** Directionality of the relationship */\n    Direction?: GraphEdgeDirection;\n\n    /** Edge thickness / weight (default is 2) */\n    Weight?: number;\n\n    /** Line style pattern */\n    Style?: GraphEdgeStyle;\n\n    /** Optional stroke color override */\n    Color?: string;\n\n    /** Whether to render an animated particle flow along the edge */\n    Animated?: boolean;\n\n    /** Underlying relationship entity reference / data payload */\n    Data?: TData;\n}\n\n/**\n * Viewport zoom and pan transformation state.\n */\nexport interface GraphViewportTransform {\n    Scale: number;\n    PanX: number;\n    PanY: number;\n}\n\n/**\n * Options for configuring graph layout physics simulation.\n */\nexport interface GraphPhysicsConfig {\n    /** Node repulsion charge strength (negative number, default -400) */\n    Repulsion: number;\n\n    /** Ideal spring link distance between connected nodes (default 120) */\n    LinkDistance: number;\n\n    /** Centering gravity force strength (default 0.05) */\n    Gravity: number;\n\n    /** Velocity damping coefficient between 0 and 1 (default 0.85) */\n    Damping: number;\n\n    /** Maximum simulation iterations before settling (default 300) */\n    MaxIterations: number;\n}\n"]}

package/dist/public-api.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Public API Surface of `@memberjunction/ng-graph-view`
+ */
+export * from './lib/components/graph-view.component';
+export * from './lib/graph-view.module';
+export * from './lib/models/graph-models';
+export * from './lib/events/graph-events';
+//# sourceMappingURL=public-api.d.ts.map

package/dist/public-api.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"public-api.d.ts","sourceRoot":"","sources":["../src/public-api.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,cAAc,uCAAuC,CAAC;AACtD,cAAc,yBAAyB,CAAC;AAGxC,cAAc,2BAA2B,CAAC;AAG1C,cAAc,2BAA2B,CAAC"}

package/dist/public-api.js

@@ -0,0 +1,11 @@
+/**
+ * Public API Surface of `@memberjunction/ng-graph-view`
+ */
+// Component & Module
+export * from './lib/components/graph-view.component';
+export * from './lib/graph-view.module';
+// Models
+export * from './lib/models/graph-models';
+// Events
+export * from './lib/events/graph-events';
+//# sourceMappingURL=public-api.js.map

package/dist/public-api.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"public-api.js","sourceRoot":"","sources":["../src/public-api.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,qBAAqB;AACrB,cAAc,uCAAuC,CAAC;AACtD,cAAc,yBAAyB,CAAC;AAExC,SAAS;AACT,cAAc,2BAA2B,CAAC;AAE1C,SAAS;AACT,cAAc,2BAA2B,CAAC","sourcesContent":["/**\n * Public API Surface of `@memberjunction/ng-graph-view`\n */\n\n// Component & Module\nexport * from './lib/components/graph-view.component';\nexport * from './lib/graph-view.module';\n\n// Models\nexport * from './lib/models/graph-models';\n\n// Events\nexport * from './lib/events/graph-events';\n"]}

package/package.json

@@ -1,10 +1,47 @@
 {
   "name": "@memberjunction/ng-graph-view",
-  "version": "0.0.0",
-  "description": "OIDC trusted publishing setup package for @memberjunction/ng-graph-view",
+  "version": "6.1.0-edge.3",
+  "description": "MemberJunction: Generic interactive network and relationship graph viewer with force-directed physics, Before/After cancelable events, and MJ design tokens",
+  "main": "./dist/public-api.js",
+  "typings": "./dist/public-api.d.ts",
+  "files": [
+    "/dist"
+  ],
   "keywords": [
-    "oidc",
-    "trusted-publishing",
-    "setup"
-  ]
-}
+    "angular",
+    "graph",
+    "network",
+    "force-directed",
+    "relationships",
+    "visualization",
+    "memberjunction"
+  ],
+  "author": "",
+  "license": "BUSL-1.1",
+  "devDependencies": {
+    "@angular/compiler": "21.1.3",
+    "@angular/compiler-cli": "21.1.3"
+  },
+  "peerDependencies": {
+    "@angular/common": "^21.1.3",
+    "@angular/core": "^21.1.3",
+    "@angular/forms": "^21.1.3"
+  },
+  "dependencies": {
+    "@memberjunction/ng-ui-components": "6.1.0-edge.3",
+    "@memberjunction/global": "6.1.0-edge.3",
+    "@types/d3": "^7.4.3",
+    "d3": "^7.9.0",
+    "tslib": "^2.8.1",
+    "rxjs": "^7.8.2"
+  },
+  "sideEffects": false,
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/MemberJunction/MJ"
+  },
+  "mjUILayer": "widgets",
+  "scripts": {
+    "build": "ngc"
+  }
+}