@memberjunction/core-actions 2.106.0 → 2.108.0

package/dist/custom/visualization/shared/svg-theming.d.ts

@@ -0,0 +1,91 @@
+/**
+ * @fileoverview Theming system for SVG visualizations.
+ * Provides color palettes, font stacks, and CSS generation for consistent branding.
+ *
+ * @module @memberjunction/actions-core/visualization
+ * @since 2.107.0
+ */
+import { Palette, Branding, FontSpec } from './svg-types';
+/**
+ * Predefined color palettes for visualizations
+ */
+export declare const PALETTES: {
+    mjDefault: {
+        background: string;
+        foreground: string;
+        categorical: string[];
+        sequential: string[];
+    };
+    gray: {
+        background: string;
+        foreground: string;
+        categorical: string[];
+        sequential: string[];
+    };
+    pastel: {
+        background: string;
+        foreground: string;
+        categorical: string[];
+        sequential: string[];
+    };
+    highContrast: {
+        background: string;
+        foreground: string;
+        categorical: string[];
+        sequential: string[];
+    };
+};
+/**
+ * Default font stack with system font fallbacks
+ */
+export declare const DEFAULT_FONT_STACK = "-apple-system, BlinkMacSystemFont, \"Segoe UI\", Roboto, \"Helvetica Neue\", Arial, sans-serif";
+/**
+ * Retrieves a palette by name or returns manual palette configuration
+ *
+ * @param palette - Palette configuration
+ * @returns Resolved palette colors
+ */
+export declare function getPalette(palette?: Palette): {
+    background: string;
+    foreground: string;
+    categorical: string[];
+    sequential: string[];
+};
+/**
+ * Gets a categorical color by index, cycling through the palette
+ *
+ * @param index - Color index
+ * @param palette - Palette configuration
+ * @returns Hex color string
+ */
+export declare function getColorForIndex(index: number, palette?: Palette): string;
+/**
+ * Gets a sequential color by normalized value (0-1)
+ *
+ * @param value - Normalized value between 0 and 1
+ * @param palette - Palette configuration
+ * @returns Hex color string
+ */
+export declare function getSequentialColor(value: number, palette?: Palette): string;
+/**
+ * Generates inline CSS from branding configuration
+ *
+ * @param branding - Branding configuration
+ * @returns CSS string for injection into <style> element
+ */
+export declare function generateCSS(branding?: Branding): string;
+/**
+ * Gets font specification with defaults applied
+ *
+ * @param font - Optional font configuration
+ * @returns Complete font specification
+ */
+export declare function getFontSpec(font?: FontSpec): Required<FontSpec>;
+/**
+ * Gets font stack for CSS font-family property
+ *
+ * @param font - Optional font configuration
+ * @returns Font family stack string
+ */
+export declare function getFontStack(font?: FontSpec): string;
+//# sourceMappingURL=svg-theming.d.ts.map

package/dist/custom/visualization/shared/svg-theming.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"svg-theming.d.ts","sourceRoot":"","sources":["../../../../src/custom/visualization/shared/svg-theming.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAE1D;;GAEG;AACH,eAAO,MAAM,QAAQ;;;;;;;;;;;;;;;;;;;;;;;;;CA2FpB,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,kBAAkB,mGACiE,CAAC;AAEjG;;;;;GAKG;AACH,wBAAgB,UAAU,CACtB,OAAO,CAAC,EAAE,OAAO,GAClB;IACC,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,MAAM,EAAE,CAAC;IACtB,UAAU,EAAE,MAAM,EAAE,CAAC;CACxB,CAaA;AAED;;;;;;GAMG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,OAAO,GAAG,MAAM,CAGzE;AAED;;;;;;GAMG;AACH,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,OAAO,GAAG,MAAM,CAK3E;AAED;;;;;GAKG;AACH,wBAAgB,WAAW,CAAC,QAAQ,CAAC,EAAE,QAAQ,GAAG,MAAM,CAoDvD;AAED;;;;;GAKG;AACH,wBAAgB,WAAW,CAAC,IAAI,CAAC,EAAE,QAAQ,GAAG,QAAQ,CAAC,QAAQ,CAAC,CAO/D;AAED;;;;;GAKG;AACH,wBAAgB,YAAY,CAAC,IAAI,CAAC,EAAE,QAAQ,GAAG,MAAM,CAEpD"}

package/dist/custom/visualization/shared/svg-theming.js

@@ -0,0 +1,235 @@
+"use strict";
+/**
+ * @fileoverview Theming system for SVG visualizations.
+ * Provides color palettes, font stacks, and CSS generation for consistent branding.
+ *
+ * @module @memberjunction/actions-core/visualization
+ * @since 2.107.0
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getFontStack = exports.getFontSpec = exports.generateCSS = exports.getSequentialColor = exports.getColorForIndex = exports.getPalette = exports.DEFAULT_FONT_STACK = exports.PALETTES = void 0;
+/**
+ * Predefined color palettes for visualizations
+ */
+exports.PALETTES = {
+    mjDefault: {
+        background: '#FFFFFF',
+        foreground: '#1A1A1A',
+        categorical: [
+            '#2E7D32', // Green
+            '#1976D2', // Blue
+            '#F57C00', // Orange
+            '#7B1FA2', // Purple
+            '#C62828', // Red
+            '#00796B', // Teal
+            '#F9A825', // Yellow
+            '#5D4037', // Brown
+            '#455A64', // Blue Grey
+            '#E91E63', // Pink
+        ],
+        sequential: [
+            '#E8F5E9', // Light Green
+            '#A5D6A7',
+            '#66BB6A',
+            '#43A047',
+            '#2E7D32',
+            '#1B5E20', // Dark Green
+        ],
+    },
+    gray: {
+        background: '#FFFFFF',
+        foreground: '#212121',
+        categorical: [
+            '#424242',
+            '#616161',
+            '#757575',
+            '#9E9E9E',
+            '#BDBDBD',
+            '#E0E0E0',
+        ],
+        sequential: [
+            '#FAFAFA',
+            '#E0E0E0',
+            '#BDBDBD',
+            '#9E9E9E',
+            '#757575',
+            '#424242',
+        ],
+    },
+    pastel: {
+        background: '#FAFAFA',
+        foreground: '#333333',
+        categorical: [
+            '#A5D6A7', // Pastel Green
+            '#90CAF9', // Pastel Blue
+            '#FFCC80', // Pastel Orange
+            '#CE93D8', // Pastel Purple
+            '#EF9A9A', // Pastel Red
+            '#80CBC4', // Pastel Teal
+            '#FFF59D', // Pastel Yellow
+            '#BCAAA4', // Pastel Brown
+            '#B0BEC5', // Pastel Blue Grey
+            '#F48FB1', // Pastel Pink
+        ],
+        sequential: [
+            '#F1F8E9',
+            '#DCEDC8',
+            '#C5E1A5',
+            '#AED581',
+            '#9CCC65',
+            '#7CB342',
+        ],
+    },
+    highContrast: {
+        background: '#FFFFFF',
+        foreground: '#000000',
+        categorical: [
+            '#000000', // Black
+            '#E60000', // Red
+            '#0000FF', // Blue
+            '#00A000', // Green
+            '#FF8C00', // Dark Orange
+            '#9400D3', // Dark Violet
+            '#FFD700', // Gold
+            '#00CED1', // Dark Turquoise
+        ],
+        sequential: [
+            '#FFFFFF',
+            '#CCCCCC',
+            '#999999',
+            '#666666',
+            '#333333',
+            '#000000',
+        ],
+    },
+};
+/**
+ * Default font stack with system font fallbacks
+ */
+exports.DEFAULT_FONT_STACK = '-apple-system, BlinkMacSystemFont, "Segoe UI", Roboto, "Helvetica Neue", Arial, sans-serif';
+/**
+ * Retrieves a palette by name or returns manual palette configuration
+ *
+ * @param palette - Palette configuration
+ * @returns Resolved palette colors
+ */
+function getPalette(palette) {
+    if (!palette || palette.type === 'named') {
+        const paletteName = palette?.type === 'named' ? palette.name : 'mjDefault';
+        return exports.PALETTES[paletteName] || exports.PALETTES.mjDefault;
+    }
+    // Manual palette
+    return {
+        background: palette.background || '#FFFFFF',
+        foreground: palette.foreground || '#1A1A1A',
+        categorical: palette.categorical || exports.PALETTES.mjDefault.categorical,
+        sequential: palette.sequential || exports.PALETTES.mjDefault.sequential,
+    };
+}
+exports.getPalette = getPalette;
+/**
+ * Gets a categorical color by index, cycling through the palette
+ *
+ * @param index - Color index
+ * @param palette - Palette configuration
+ * @returns Hex color string
+ */
+function getColorForIndex(index, palette) {
+    const colors = getPalette(palette).categorical;
+    return colors[index % colors.length];
+}
+exports.getColorForIndex = getColorForIndex;
+/**
+ * Gets a sequential color by normalized value (0-1)
+ *
+ * @param value - Normalized value between 0 and 1
+ * @param palette - Palette configuration
+ * @returns Hex color string
+ */
+function getSequentialColor(value, palette) {
+    const colors = getPalette(palette).sequential;
+    const clampedValue = Math.max(0, Math.min(1, value));
+    const index = Math.floor(clampedValue * (colors.length - 1));
+    return colors[index];
+}
+exports.getSequentialColor = getSequentialColor;
+/**
+ * Generates inline CSS from branding configuration
+ *
+ * @param branding - Branding configuration
+ * @returns CSS string for injection into <style> element
+ */
+function generateCSS(branding) {
+    const pal = getPalette(branding?.palette);
+    const font = getFontSpec(branding?.font);
+    const css = `
+        .bg-default { fill: ${pal.background}; }
+        .fg-default { fill: ${pal.foreground}; stroke: ${pal.foreground}; }
+        .text-default {
+            fill: ${pal.foreground};
+            font-family: ${font.family};
+            font-size: ${font.size}px;
+            font-weight: ${font.weight};
+        }
+        .node-text {
+            fill: ${pal.foreground};
+            font-family: ${font.family};
+            font-size: ${font.size}px;
+            text-anchor: middle;
+            dominant-baseline: middle;
+        }
+        .edge-line {
+            fill: none;
+            stroke: ${pal.foreground};
+            stroke-width: 2;
+        }
+        .edge-label {
+            fill: ${pal.foreground};
+            font-family: ${font.family};
+            font-size: ${font.size - 2}px;
+            text-anchor: middle;
+        }
+        ${pal.categorical
+        .map((color, i) => `
+        .cat-${i} { fill: ${color}; }
+        .cat-${i}-stroke { stroke: ${color}; }
+        .cat-${i}-text { fill: ${color}; }
+        `)
+        .join('')}
+        ${pal.sequential
+        .map((color, i) => `
+        .seq-${i} { fill: ${color}; }
+        `)
+        .join('')}
+    `
+        .replace(/\n\s+/g, '\n')
+        .trim();
+    return css;
+}
+exports.generateCSS = generateCSS;
+/**
+ * Gets font specification with defaults applied
+ *
+ * @param font - Optional font configuration
+ * @returns Complete font specification
+ */
+function getFontSpec(font) {
+    return {
+        family: font?.family || exports.DEFAULT_FONT_STACK,
+        size: font?.size || 14,
+        weight: font?.weight || 400,
+        lineHeight: font?.lineHeight || 1.5,
+    };
+}
+exports.getFontSpec = getFontSpec;
+/**
+ * Gets font stack for CSS font-family property
+ *
+ * @param font - Optional font configuration
+ * @returns Font family stack string
+ */
+function getFontStack(font) {
+    return font?.family || exports.DEFAULT_FONT_STACK;
+}
+exports.getFontStack = getFontStack;
+//# sourceMappingURL=svg-theming.js.map

package/dist/custom/visualization/shared/svg-theming.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"svg-theming.js","sourceRoot":"","sources":["../../../../src/custom/visualization/shared/svg-theming.ts"],"names":[],"mappings":"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"}

package/dist/custom/visualization/shared/svg-types.d.ts

@@ -0,0 +1,338 @@
+/**
+ * @fileoverview Type definitions for server-rendered SVG visualizations.
+ * These types support the MemberJunction infographic system and provide
+ * consistent interfaces across all visualization actions.
+ *
+ * @module @memberjunction/actions-core/visualization
+ * @since 2.107.0
+ */
+import { ActionResultSimple } from '@memberjunction/actions-base';
+/**
+ * ViewBox configuration for SVG canvas dimensions and padding
+ */
+export interface ViewBox {
+    /** Final pixel width of the SVG */
+    width: number;
+    /** Final pixel height of the SVG */
+    height: number;
+    /** Padding around content (uniform or per-side) */
+    padding?: number | {
+        top?: number;
+        right?: number;
+        bottom?: number;
+        left?: number;
+    };
+}
+/**
+ * Font specification for text rendering
+ */
+export interface FontSpec {
+    /** Font family stack (e.g., 'Inter, Arial, sans-serif') */
+    family?: string;
+    /** Font size in pixels (default: 12-14) */
+    size?: number;
+    /** Font weight (400, 600, 'bold', etc.) */
+    weight?: number | string;
+    /** Line height in em units */
+    lineHeight?: number;
+}
+/**
+ * Color palette configuration
+ */
+export type Palette = {
+    type: 'named';
+    name: 'mjDefault' | 'gray' | 'pastel' | 'highContrast';
+} | {
+    type: 'manual';
+    background?: string;
+    foreground?: string;
+    categorical?: string[];
+    sequential?: string[];
+};
+/**
+ * Branding and visual identity configuration
+ */
+export interface Branding {
+    /** Color palette to use */
+    palette?: Palette;
+    /** Font specification */
+    font?: FontSpec;
+    /** Optional logo SVG snippet to place in corner */
+    logoSvg?: string;
+    /** Optional watermark text */
+    watermarkText?: string;
+}
+/**
+ * Accessibility configuration for WCAG compliance
+ */
+export interface Accessibility {
+    /** Title for <title> element */
+    title?: string;
+    /** Description for <desc> element */
+    desc?: string;
+    /** ARIA role for root SVG */
+    ariaRole?: 'img' | 'graphics-document';
+    /** Include data table for screen readers */
+    includeDataTable?: boolean;
+}
+/**
+ * Animation configuration (primarily for web display)
+ */
+export interface AnimationOptions {
+    /** Enable animations (default: false for print-first) */
+    enabled?: boolean;
+    /** Prefer CSS animations over inline JS */
+    preferCSS?: boolean;
+    /** Animation duration in milliseconds */
+    durationMs?: number;
+    /** Easing function */
+    ease?: 'linear' | 'ease' | 'ease-in' | 'ease-out' | 'ease-in-out';
+    /** Stagger delay between items in milliseconds */
+    staggerMs?: number;
+}
+/**
+ * Interactivity configuration (requires inline JS)
+ */
+export interface InteractivityOptions {
+    /** Enable interactivity (default: false) */
+    enabled?: boolean;
+    /** Show tooltips on hover */
+    tooltips?: boolean;
+    /** Enable expand/collapse for trees */
+    expandCollapse?: boolean;
+}
+/**
+ * Export and rendering controls
+ */
+export interface ExportControls {
+    /** Inline CSS in <style> tag (default: true) */
+    embedCSS?: boolean;
+    /** Inline JavaScript in <script> tag (default: false) */
+    embedJS?: boolean;
+    /** Prefix for element IDs to ensure uniqueness */
+    idPrefix?: string;
+    /** Seed for deterministic random layouts */
+    seed?: number;
+}
+/**
+ * Base configuration shared by all SVG actions
+ */
+export interface ActionBase {
+    /** ViewBox dimensions and padding */
+    viewBox: ViewBox;
+    /** Branding and visual identity */
+    branding?: Branding;
+    /** Accessibility configuration */
+    a11y?: Accessibility;
+    /** Animation options */
+    animation?: AnimationOptions;
+    /** Interactivity options */
+    interactivity?: InteractivityOptions;
+    /** Export controls */
+    export?: ExportControls;
+    /** Pass-through metadata for tracing/debugging */
+    meta?: Record<string, unknown>;
+}
+/**
+ * Standardized result from SVG actions
+ */
+export interface SVGActionResult extends ActionResultSimple {
+    /** SVG XML string ready to embed */
+    svg?: string;
+    /** Width in pixels */
+    width?: number;
+    /** Height in pixels */
+    height?: number;
+    /** Warnings about rendering issues */
+    warnings?: string[];
+    /** Diagnostic information */
+    diagnostics?: Record<string, unknown>;
+}
+/**
+ * Types of nodes in flowcharts
+ */
+export type FlowNodeKind = 'start' | 'end' | 'process' | 'decision' | 'input' | 'output' | 'subprocess';
+/**
+ * Node in a flowchart
+ */
+export interface FlowNode {
+    /** Unique node identifier */
+    id: string;
+    /** Node type/shape */
+    kind: FlowNodeKind;
+    /** Display label */
+    label: string;
+    /** Optional note/description */
+    note?: string;
+    /** Optional icon SVG */
+    icon?: string;
+    /** Override width (auto-calculated if not provided) */
+    width?: number;
+    /** Override height (auto-calculated if not provided) */
+    height?: number;
+}
+/**
+ * Edge connecting flowchart nodes
+ */
+export interface FlowEdge {
+    /** Source node ID */
+    from: string;
+    /** Target node ID */
+    to: string;
+    /** Optional edge label */
+    label?: string;
+    /** Render as dashed line */
+    dashed?: boolean;
+}
+/**
+ * Layout configuration for flowcharts
+ */
+export interface FlowLayout {
+    /** Layout direction */
+    direction?: 'TB' | 'LR' | 'RL' | 'BT';
+    /** Vertical spacing between ranks */
+    rankSep?: number;
+    /** Horizontal spacing between nodes */
+    nodeSep?: number;
+}
+/**
+ * Node in an org chart
+ */
+export interface OrgNode {
+    /** Unique node identifier */
+    id: string;
+    /** Person/position name */
+    label: string;
+    /** Job title/role */
+    role?: string;
+    /** Avatar URL (data URI or omitted) */
+    avatarUrl?: string;
+    /** Child nodes in hierarchy */
+    children?: OrgNode[];
+    /** Highlight this node */
+    highlight?: boolean;
+}
+/**
+ * Attribute in an entity
+ */
+export interface ERAttribute {
+    /** Attribute name */
+    name: string;
+    /** Data type */
+    type?: string;
+    /** Primary key indicator */
+    pk?: boolean;
+    /** Foreign key indicator */
+    fk?: boolean;
+}
+/**
+ * Table/Entity in ER diagram
+ */
+export interface ERTable {
+    /** Unique table identifier */
+    id: string;
+    /** Table display name */
+    name: string;
+    /** Table attributes/columns */
+    attrs: ERAttribute[];
+}
+/**
+ * Relationship between entities
+ */
+export interface ERRelation {
+    /** Source table ID */
+    from: string;
+    /** Target table ID */
+    to: string;
+    /** Relationship cardinality */
+    label?: '1-1' | '1-N' | 'N-M';
+}
+/**
+ * Word with weight for cloud/tag visualization
+ */
+export interface WordItem {
+    /** The word/term */
+    text: string;
+    /** Weight/frequency/importance */
+    weight: number;
+}
+/**
+ * Word cloud layout configuration
+ */
+export interface CloudLayout {
+    /** Rotation strategy */
+    rotate?: 'none' | 'few' | 'mixed';
+    /** Padding between words */
+    padding?: number;
+    /** Spiral algorithm type */
+    spiral?: 'archimedean' | 'rectangular';
+    /** Minimum font size */
+    minFont?: number;
+    /** Maximum font size */
+    maxFont?: number;
+}
+/**
+ * Node in a network graph
+ */
+export interface GraphNode {
+    /** Unique node identifier */
+    id: string;
+    /** Display label */
+    label?: string;
+    /** Group/category for coloring */
+    group?: string;
+    /** Node size (auto-calculated if not provided) */
+    size?: number;
+}
+/**
+ * Edge connecting graph nodes
+ */
+export interface GraphEdge {
+    /** Optional edge identifier */
+    id?: string;
+    /** Source node ID */
+    source: string;
+    /** Target node ID */
+    target: string;
+    /** Edge weight/strength */
+    weight?: number;
+    /** Directed edge (arrow) */
+    directed?: boolean;
+}
+/**
+ * Network layout type
+ */
+export type NetworkLayoutType = 'force' | 'radial' | 'tree' | 'grid';
+/**
+ * Physics simulation parameters for force-directed layouts
+ */
+export interface PhysicsParams {
+    /** Charge/repulsion strength (negative = repel) */
+    charge?: number;
+    /** Ideal distance between connected nodes */
+    linkDistance?: number;
+    /** Number of simulation iterations */
+    iterations?: number;
+}
+/**
+ * Decision tree node (hierarchical)
+ */
+export interface DecisionNode {
+    /** Unique node identifier */
+    id: string;
+    /** Node label */
+    label: string;
+    /** Optional value/probability */
+    value?: number;
+    /** Child nodes in tree */
+    children?: DecisionNode[];
+    /** Collapsed state (if interactivity enabled) */
+    collapsed?: boolean;
+    /** Optional note */
+    note?: string;
+}
+/**
+ * Node shape for decision trees
+ */
+export type NodeShape = 'rect' | 'circle' | 'pill';
+//# sourceMappingURL=svg-types.d.ts.map

package/dist/custom/visualization/shared/svg-types.d.ts.map

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