@memberjunction/ng-entity-relationship-diagram 0.0.1 → 2.129.0

package/dist/lib/interfaces/erd-types.d.ts

@@ -0,0 +1,491 @@
+/**
+ * Generic ERD Types for the Entity Relationship Diagram component.
+ * These types are designed to be framework-agnostic and can work with any data source.
+ */
+/**
+ * Represents a field in an ERD node (entity).
+ */
+export interface ERDField {
+    /** Unique identifier for the field */
+    id: string;
+    /** Display name of the field */
+    name: string;
+    /** Data type of the field (e.g., 'string', 'int', 'uuid') */
+    type?: string;
+    /** Whether this field is a primary key */
+    isPrimaryKey: boolean;
+    /** ID of the related node (for foreign keys) */
+    relatedNodeId?: string;
+    /** Name of the related node (for display purposes) */
+    relatedNodeName?: string;
+    /** Name of the field in the related node (for FK relationships) */
+    relatedFieldName?: string;
+    /** Optional description of the field */
+    description?: string;
+    /** Whether the field allows null values */
+    allowsNull?: boolean;
+    /** Default value for the field */
+    defaultValue?: string;
+    /** Maximum length (for string fields) */
+    length?: number;
+    /** Precision (for numeric fields) */
+    precision?: number;
+    /** Scale (for numeric fields) */
+    scale?: number;
+    /** Whether the field is virtual/computed */
+    isVirtual?: boolean;
+    /** Whether the field is auto-increment */
+    autoIncrement?: boolean;
+    /** Possible values for the field (for enums/dropdowns) */
+    possibleValues?: ERDFieldValue[];
+    /** Additional custom data */
+    customData?: Record<string, unknown>;
+}
+/**
+ * Represents a possible value for an ERD field (enum values, dropdown options, etc.)
+ */
+export interface ERDFieldValue {
+    /** Unique identifier for the value */
+    id?: string;
+    /** The actual value */
+    value: string;
+    /** Code representation (may differ from value) */
+    code?: string;
+    /** Description of what this value means */
+    description?: string;
+    /** Sort order */
+    sequence?: number;
+}
+/**
+ * Represents a node (entity/table) in the ERD.
+ */
+export interface ERDNode {
+    /** Unique identifier for the node */
+    id: string;
+    /** Display name of the node */
+    name: string;
+    /** Optional schema/namespace name */
+    schemaName?: string;
+    /** Optional description */
+    description?: string;
+    /** Status of the node (e.g., 'Active', 'Deprecated') */
+    status?: string;
+    /** Base table name (if different from display name) */
+    baseTable?: string;
+    /** All fields in this node */
+    fields: ERDField[];
+    /** Additional custom data that can be used by the consumer */
+    customData?: Record<string, unknown>;
+}
+/**
+ * Represents a link (relationship) between two nodes in the ERD.
+ */
+export interface ERDLink {
+    /** ID of the source node */
+    sourceNodeId: string;
+    /** ID of the target node */
+    targetNodeId: string;
+    /** The field that creates this relationship (usually the FK field) */
+    sourceField: ERDField;
+    /** The field in the target node (usually the PK field) */
+    targetField?: ERDField;
+    /** Whether this is a self-referencing relationship */
+    isSelfReference: boolean;
+    /** Relationship type (e.g., 'one-to-many', 'many-to-one') */
+    relationshipType?: 'one-to-one' | 'one-to-many' | 'many-to-one' | 'many-to-many';
+    /** Optional label for the relationship */
+    label?: string;
+}
+/**
+ * Configuration options for the ERD diagram.
+ */
+export interface ERDConfig {
+    /** Width of each node box in pixels */
+    nodeWidth?: number;
+    /** Base height of each node box in pixels */
+    nodeBaseHeight?: number;
+    /** Height per field in pixels */
+    fieldHeight?: number;
+    /** Maximum height of a node in pixels */
+    maxNodeHeight?: number;
+    /** Charge strength for force simulation (negative = repel) */
+    chargeStrength?: number;
+    /** Link distance for force simulation */
+    linkDistance?: number;
+    /** Collision radius padding */
+    collisionPadding?: number;
+    /** Whether to show field details in nodes */
+    showFieldDetails?: boolean;
+    /** Whether to show relationship labels */
+    showRelationshipLabels?: boolean;
+    /** Whether to enable node dragging */
+    enableDragging?: boolean;
+    /** Whether to enable zoom/pan */
+    enableZoom?: boolean;
+    /** Initial zoom level */
+    initialZoom?: number;
+    /** Colors for different node states */
+    colors?: ERDColorScheme;
+}
+/**
+ * Color scheme for the ERD diagram.
+ */
+export interface ERDColorScheme {
+    /** Background color for node rectangles */
+    nodeBackground?: string;
+    /** Border color for node rectangles */
+    nodeBorder?: string;
+    /** Header background color for nodes */
+    nodeHeader?: string;
+    /** Text color for node headers */
+    nodeHeaderText?: string;
+    /** Background color for primary key fields */
+    primaryKeyBackground?: string;
+    /** Text color for primary key fields */
+    primaryKeyText?: string;
+    /** Background color for foreign key fields */
+    foreignKeyBackground?: string;
+    /** Text color for foreign key fields */
+    foreignKeyText?: string;
+    /** Color for relationship links */
+    linkColor?: string;
+    /** Color for selected nodes */
+    selectedBorder?: string;
+    /** Color for highlighted nodes */
+    highlightBorder?: string;
+    /** Color for related nodes (when showing relationships) */
+    relatedBorder?: string;
+}
+/**
+ * Filter configuration for the ERD.
+ */
+export interface ERDFilter {
+    /** Filter by schema name */
+    schemaName?: string | null;
+    /** Filter by node name (search) */
+    nodeName?: string;
+    /** Filter by node status */
+    nodeStatus?: string | null;
+    /** Filter by base table name (search) */
+    baseTable?: string;
+    /** Custom filter function */
+    customFilter?: (node: ERDNode) => boolean;
+}
+/**
+ * Event data for node selection events.
+ */
+export interface ERDNodeSelectionEvent {
+    /** The selected node (null if deselected) */
+    node: ERDNode | null;
+    /** Previous selected node (null if none) */
+    previousNode: ERDNode | null;
+    /** Whether the consumer can cancel this selection */
+    cancel: boolean;
+}
+/**
+ * Event data for node click events.
+ */
+export interface ERDNodeClickEvent {
+    /** The clicked node */
+    node: ERDNode;
+    /** The mouse event */
+    mouseEvent: MouseEvent;
+    /** Whether to cancel default behavior (selection) */
+    cancel: boolean;
+}
+/**
+ * Event data for node double-click events.
+ */
+export interface ERDNodeDoubleClickEvent {
+    /** The double-clicked node */
+    node: ERDNode;
+    /** The mouse event */
+    mouseEvent: MouseEvent;
+    /** Whether to cancel default behavior */
+    cancel: boolean;
+}
+/**
+ * Event data for link click events.
+ */
+export interface ERDLinkClickEvent {
+    /** The clicked link */
+    link: ERDLink;
+    /** Source node */
+    sourceNode: ERDNode;
+    /** Target node */
+    targetNode: ERDNode;
+    /** The mouse event */
+    mouseEvent: MouseEvent;
+    /** Whether to cancel default behavior */
+    cancel: boolean;
+}
+/**
+ * Event data for zoom change events.
+ */
+export interface ERDZoomEvent {
+    /** Current zoom level */
+    zoomLevel: number;
+    /** X translation */
+    translateX: number;
+    /** Y translation */
+    translateY: number;
+}
+/**
+ * State of the ERD diagram for saving/restoring.
+ * Use with `getState()` and `setState()` methods for persistence.
+ *
+ * @example
+ * ```typescript
+ * // Save state to localStorage
+ * const state = erdComponent.getState();
+ * localStorage.setItem('erd-state', JSON.stringify(state));
+ *
+ * // Restore state
+ * const savedState = JSON.parse(localStorage.getItem('erd-state'));
+ * erdComponent.setState(savedState);
+ * ```
+ */
+export interface ERDState {
+    /** ID of the currently selected node */
+    selectedNodeId: string | null;
+    /** IDs of highlighted nodes */
+    highlightedNodeIds: string[];
+    /** Current zoom level (1 = 100%) */
+    zoomLevel: number;
+    /** X translation (pan position) */
+    translateX: number;
+    /** Y translation (pan position) */
+    translateY: number;
+    /** Focus node ID (if in focus mode) */
+    focusNodeId: string | null;
+    /** Focus depth (number of relationship hops to show) */
+    focusDepth: number;
+    /** Node positions for restoring exact layout */
+    nodePositions: Record<string, {
+        x: number;
+        y: number;
+        fx?: number | null;
+        fy?: number | null;
+    }>;
+}
+/**
+ * Event data for node hover events.
+ * Emitted when the mouse enters a node.
+ */
+export interface ERDNodeHoverEvent {
+    /** The hovered node */
+    node: ERDNode;
+    /** The mouse event */
+    mouseEvent: MouseEvent;
+    /** Nodes directly connected to this node via relationships */
+    relatedNodes: ERDNode[];
+    /** Position for displaying tooltips */
+    position: {
+        x: number;
+        y: number;
+    };
+}
+/**
+ * Event data for link hover events.
+ * Emitted when the mouse enters a relationship link.
+ */
+export interface ERDLinkHoverEvent {
+    /** The hovered link */
+    link: ERDLink;
+    /** Source node of the relationship */
+    sourceNode: ERDNode;
+    /** Target node of the relationship */
+    targetNode: ERDNode;
+    /** The mouse event */
+    mouseEvent: MouseEvent;
+    /** Position for displaying tooltips */
+    position: {
+        x: number;
+        y: number;
+    };
+}
+/**
+ * Event data for context menu events on nodes.
+ * Set `cancel = true` to prevent default browser context menu.
+ */
+export interface ERDNodeContextMenuEvent {
+    /** The right-clicked node */
+    node: ERDNode;
+    /** The mouse event */
+    mouseEvent: MouseEvent;
+    /** Set to true to prevent default context menu */
+    cancel: boolean;
+    /** Screen position for showing custom context menu */
+    position: {
+        x: number;
+        y: number;
+    };
+}
+/**
+ * Event data for context menu events on links.
+ * Set `cancel = true` to prevent default browser context menu.
+ */
+export interface ERDLinkContextMenuEvent {
+    /** The right-clicked link */
+    link: ERDLink;
+    /** Source node */
+    sourceNode: ERDNode;
+    /** Target node */
+    targetNode: ERDNode;
+    /** The mouse event */
+    mouseEvent: MouseEvent;
+    /** Set to true to prevent default context menu */
+    cancel: boolean;
+    /** Screen position for showing custom context menu */
+    position: {
+        x: number;
+        y: number;
+    };
+}
+/**
+ * Event data for context menu events on the diagram background.
+ * Set `cancel = true` to prevent default browser context menu.
+ */
+export interface ERDDiagramContextMenuEvent {
+    /** The mouse event */
+    mouseEvent: MouseEvent;
+    /** Set to true to prevent default context menu */
+    cancel: boolean;
+    /** Screen position for showing custom context menu */
+    position: {
+        x: number;
+        y: number;
+    };
+    /** Diagram coordinates of the click */
+    diagramPosition: {
+        x: number;
+        y: number;
+    };
+}
+/**
+ * Event data for node drag events.
+ * Set `cancel = true` in dragStart to prevent dragging.
+ */
+export interface ERDNodeDragEvent {
+    /** The dragged node */
+    node: ERDNode;
+    /** Position when drag started */
+    startPosition: {
+        x: number;
+        y: number;
+    };
+    /** Current position during drag */
+    currentPosition: {
+        x: number;
+        y: number;
+    };
+    /** Set to true in dragStart to cancel the drag */
+    cancel: boolean;
+}
+/**
+ * Layout algorithm options for the ERD diagram.
+ * - 'force': D3 force-directed layout (dynamic, animated)
+ * - 'dagre': Dagre hierarchical layout with orthogonal edges (static, clean)
+ * - 'horizontal': Left-to-right hierarchical layout using Dagre
+ * - 'vertical': Top-to-bottom hierarchical layout using Dagre
+ * - 'radial': Radial layout (not yet implemented)
+ */
+export type ERDLayoutAlgorithm = 'force' | 'dagre' | 'horizontal' | 'vertical' | 'radial';
+/**
+ * Dagre-specific layout configuration options.
+ */
+export interface ERDDagreConfig {
+    /** Direction of the graph layout. Default: 'LR' (left-to-right) */
+    rankDir?: 'TB' | 'BT' | 'LR' | 'RL';
+    /** Horizontal separation between nodes. Default: 50 */
+    nodeSep?: number;
+    /** Vertical separation between ranks/layers. Default: 100 */
+    rankSep?: number;
+    /** Separation between different edge paths. Default: 10 */
+    edgeSep?: number;
+    /** Algorithm for ranking nodes: 'network-simplex', 'tight-tree', 'longest-path'. Default: 'network-simplex' */
+    ranker?: 'network-simplex' | 'tight-tree' | 'longest-path';
+    /** Alignment of nodes within their rank: 'UL', 'UR', 'DL', 'DR'. Default: undefined (centered) */
+    align?: 'UL' | 'UR' | 'DL' | 'DR';
+}
+/**
+ * Extended configuration options for the ERD diagram.
+ * All options are optional with sensible defaults.
+ */
+export interface ERDConfig {
+    /** Width of each node box in pixels. Default: 180 */
+    nodeWidth?: number;
+    /** Base height of each node box in pixels (before adding fields). Default: 60 */
+    nodeBaseHeight?: number;
+    /** Height per field row in pixels. Default: 20 */
+    fieldHeight?: number;
+    /** Maximum height of a node in pixels. Default: 300 */
+    maxNodeHeight?: number;
+    /** Charge strength for force simulation (negative = repel). Default: -800 */
+    chargeStrength?: number;
+    /** Base distance between linked nodes. Default: 80 */
+    linkDistance?: number;
+    /** Extra padding for collision detection. Default: 20 */
+    collisionPadding?: number;
+    /** Whether to show field details (PKs, FKs) in nodes. Default: true */
+    showFieldDetails?: boolean;
+    /** Whether to show relationship labels on links. Default: true */
+    showRelationshipLabels?: boolean;
+    /** Whether to show the header bar with controls. Default: true */
+    showHeader?: boolean;
+    /** Whether to show node count in header. Default: true */
+    showNodeCount?: boolean;
+    /** Whether to show a minimap for navigation. Default: false */
+    showMinimap?: boolean;
+    /** Whether to show a legend explaining colors. Default: false */
+    showLegend?: boolean;
+    /** Enable node dragging. Default: true */
+    enableDragging?: boolean;
+    /** Enable zoom with mouse wheel. Default: true */
+    enableZoom?: boolean;
+    /** Enable panning by dragging background. Default: true */
+    enablePan?: boolean;
+    /** Minimum zoom level. Default: 0.1 */
+    minZoom?: number;
+    /** Maximum zoom level. Default: 4 */
+    maxZoom?: number;
+    /** Initial zoom level (1 = 100%). Default: 1 */
+    initialZoom?: number;
+    /** Enable multi-select with Ctrl+click. Default: false */
+    enableMultiSelect?: boolean;
+    /** Duration of zoom/pan animations in milliseconds. Default: 750 */
+    animationDuration?: number;
+    /** Whether to auto-fit diagram to container on initial load. Default: true */
+    fitOnLoad?: boolean;
+    /**
+     * Skip the D3 force simulation animation and render immediately.
+     * When true, the simulation runs to completion synchronously and nodes
+     * are positioned immediately without animation.
+     * Default: false
+     */
+    skipAnimation?: boolean;
+    /** Message to show when no nodes are provided. Default: 'No entities to display' */
+    emptyStateMessage?: string;
+    /** Icon class for empty state. Default: 'fa-solid fa-diagram-project' */
+    emptyStateIcon?: string;
+    /** Layout algorithm to use. Default: 'force' */
+    layoutAlgorithm?: ERDLayoutAlgorithm;
+    /** Dagre-specific layout configuration (only used when layoutAlgorithm is 'dagre', 'horizontal', or 'vertical') */
+    dagreConfig?: ERDDagreConfig;
+    /** Color scheme for the diagram */
+    colors?: ERDColorScheme;
+}
+/**
+ * Information about a relationship for highlighting purposes.
+ */
+export interface ERDRelationshipInfo {
+    /** The related node */
+    node: ERDNode;
+    /** The link connecting them */
+    link: ERDLink;
+    /** Direction of relationship from the perspective of the source node */
+    direction: 'outgoing' | 'incoming';
+    /** The field creating this relationship */
+    field: ERDField;
+}
+//# sourceMappingURL=erd-types.d.ts.map

package/dist/lib/interfaces/erd-types.d.ts.map

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

package/dist/lib/interfaces/erd-types.js

@@ -0,0 +1,6 @@
+/**
+ * Generic ERD Types for the Entity Relationship Diagram component.
+ * These types are designed to be framework-agnostic and can work with any data source.
+ */
+export {};
+//# sourceMappingURL=erd-types.js.map

package/dist/lib/interfaces/erd-types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"erd-types.js","sourceRoot":"","sources":["../../../src/lib/interfaces/erd-types.ts"],"names":[],"mappings":"AAAA;;;GAGG"}

package/dist/lib/utils/entity-to-erd-adapter.d.ts

@@ -0,0 +1,64 @@
+import { EntityInfo, EntityFieldInfo } from '@memberjunction/core';
+import { ERDNode, ERDField, ERDLink } from '../interfaces/erd-types';
+/**
+ * Converts MemberJunction EntityFieldInfo to generic ERDField format.
+ */
+export declare function entityFieldToERDField(field: EntityFieldInfo): ERDField;
+/**
+ * Converts MemberJunction EntityInfo to generic ERDNode format.
+ */
+export declare function entityInfoToERDNode(entity: EntityInfo): ERDNode;
+/**
+ * Converts an array of MemberJunction EntityInfo objects to ERDNode format.
+ */
+export declare function entitiesToERDNodes(entities: EntityInfo[]): ERDNode[];
+/**
+ * Extracts the original EntityInfo from an ERDNode's customData.
+ * Returns null if not found.
+ */
+export declare function getOriginalEntityFromERDNode(node: ERDNode): EntityInfo | null;
+/**
+ * Finds an EntityInfo by node ID from an array.
+ */
+export declare function findEntityByNodeId(nodeId: string, entities: EntityInfo[]): EntityInfo | undefined;
+/**
+ * Options for building ERD data from entities.
+ */
+export interface BuildERDDataOptions {
+    /** Include incoming relationships (entities that reference these entities). Default: true */
+    includeIncoming?: boolean;
+    /** Include outgoing relationships (entities these reference via FK). Default: true */
+    includeOutgoing?: boolean;
+    /** All entities in the system (for relationship lookups). Required for includeIncoming/includeOutgoing. */
+    allEntities?: EntityInfo[];
+    /** Relationship depth - how many hops to include. Default: 1 */
+    depth?: number;
+}
+/**
+ * Result of building ERD data from entities.
+ */
+export interface BuildERDDataResult {
+    nodes: ERDNode[];
+    links: ERDLink[];
+}
+/**
+ * Builds ERD nodes and links from an array of EntityInfo objects.
+ * This handles the transformation and automatic relationship discovery.
+ *
+ * @param entities - The primary entities to display
+ * @param options - Options for relationship discovery
+ * @returns Object containing nodes and links arrays
+ *
+ * @example
+ * ```typescript
+ * // Single entity with all related entities
+ * const result = buildERDDataFromEntities([myEntity], {
+ *   allEntities: metadata.Entities,
+ *   includeIncoming: true,
+ *   includeOutgoing: true,
+ *   depth: 1
+ * });
+ * ```
+ */
+export declare function buildERDDataFromEntities(entities: EntityInfo[], options?: BuildERDDataOptions): BuildERDDataResult;
+//# sourceMappingURL=entity-to-erd-adapter.d.ts.map

package/dist/lib/utils/entity-to-erd-adapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"entity-to-erd-adapter.d.ts","sourceRoot":"","sources":["../../../src/lib/utils/entity-to-erd-adapter.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AACnE,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAiB,OAAO,EAAE,MAAM,yBAAyB,CAAC;AAEpF;;GAEG;AACH,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,eAAe,GAAG,QAAQ,CAmCtE;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,UAAU,GAAG,OAAO,CAc/D;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,QAAQ,EAAE,UAAU,EAAE,GAAG,OAAO,EAAE,CAEpE;AAED;;;GAGG;AACH,wBAAgB,4BAA4B,CAAC,IAAI,EAAE,OAAO,GAAG,UAAU,GAAG,IAAI,CAK7E;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,UAAU,EAAE,GAAG,UAAU,GAAG,SAAS,CAEjG;AAED;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC,6FAA6F;IAC7F,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B,sFAAsF;IACtF,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B,2GAA2G;IAC3G,WAAW,CAAC,EAAE,UAAU,EAAE,CAAC;IAC3B,gEAAgE;IAChE,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,KAAK,EAAE,OAAO,EAAE,CAAC;IACjB,KAAK,EAAE,OAAO,EAAE,CAAC;CAClB;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,wBAAwB,CACtC,QAAQ,EAAE,UAAU,EAAE,EACtB,OAAO,GAAE,mBAAwB,GAChC,kBAAkB,CA8JpB"}