nodeq-mindmap

NODEQ MindMap & Pipeline Builder 🧠⚡

npm version License: MIT GitHub

A revolutionary lightweight library that combines interactive mind map visualization with intelligent data pipeline building. Transform JSON data into beautiful mind maps AND create ML-powered data transformation pipelines.

🏗️ Architecture Overview

### Mind Map Visualization ```mermaid flowchart TD A[JSON Data] --> B[Schema Detection] B --> C[Node Generation] C --> D[D3.js Rendering] D --> E[Interactive UI] E --> F[Export/Theme] ```
### Pipeline Processor ```mermaid flowchart TD A[Input Sample] --> B[Configuration] C[Output Sample] --> B B --> D[ML Analysis] D --> E[Pipeline Generation] E --> F[Static Execution] ```

📦 Installation

npm install nodeq-mindmap

🚀 Quick Start

Basic Mind Map

import { NodeQMindMap } from 'nodeq-mindmap';

const data = {
  "topic": "My Project",
  "children": [
    { "topic": "Frontend", "skills": ["React", "TypeScript"] },
    { "topic": "Backend", "skills": ["Node.js", "PostgreSQL"] }
  ]
};

const mindMap = new NodeQMindMap({
  container: '#mindmap-container',
  data: data,
  width: 800,
  height: 600
});

mindMap.render();

Smart Data Pipeline

// Define input/output samples - AI creates transformation
const inputSample = { "firstName": "John", "lastName": "Doe", "age": 25 };
const outputSample = { "fullName": "John Doe", "isAdult": true };

const pipeline = await mindMap.createDataPipeline(
  'User Transform',
  inputSample, 
  outputSample
);

// Execute with new data (fast static execution)
const result = mindMap.executePipeline({
  "firstName": "Jane", "lastName": "Smith", "age": 17
});
// Result: { "fullName": "Jane Smith", "isAdult": false }

📋 Core API Methods

Mind Map Methods

const mindMap = new NodeQMindMap(config);

// Rendering
mindMap.render();                    // Render the mind map
mindMap.updateData(newData);         // Update with new data
mindMap.destroy();                   // Clean up resources

// Styling
mindMap.updateTheme(themeOptions);   // Change theme
mindMap.exportSVG();                 // Export as SVG

// Navigation
mindMap.expandAll();                 // Expand all nodes
mindMap.collapseAll();              // Collapse all nodes
mindMap.zoomToFit();                // Auto-zoom to content
mindMap.centerMap();                // Center the view

Pipeline Methods

// Pipeline operations
await mindMap.createDataPipeline(name, inputSample, outputSample, options);
mindMap.executePipeline(inputData);  // Fast static execution
mindMap.exportPipelineCode();        // Generate executable code

// Management
mindMap.getAllPipelines();           // Get all pipelines
mindMap.switchToPipeline(pipelineId); // Switch active pipeline
mindMap.getPipelineEngine();         // Access engine directly

Configuration Options

const config = {
  container: '#mindmap-container',   // Required: DOM selector
  data: jsonData,                   // Required: JSON data
  width: 800,                       // Canvas width
  height: 600,                      // Canvas height

  // Styling
  theme: {
    nodeColor: '#4299e1',          // Node background
    textColor: '#2d3748',          // Text color
    linkColor: '#a0aec0',          // Connection lines
    backgroundColor: '#ffffff'     // Canvas background
  },

  // Behavior
  interactive: true,               // Enable interactions
  zoomable: true,                 // Enable zoom/pan
  collapsible: true,              // Enable node collapse

  // Callbacks
  onNodeClick: (node) => { /* handle click */ },
  onPipelineCreated: (pipeline) => { /* handle creation */ }
};

✨ Key Features

🧠 AI/ML Integration

NodeQ supports multiple AI backends for intelligent pipeline generation:

// OpenAI integration example
const openaiConfig = {
  type: 'openai',
  modelName: 'gpt-4',
  apiKey: process.env.OPENAI_API_KEY
};

const pipeline = await mindMap.createDataPipeline(
  'Smart Pipeline',
  inputSample,
  outputSample, 
  { modelConfig: openaiConfig }
);

📚 Complete Documentation

📖 Guide 📝 Description
Installation & Setup Complete setup, configuration, and framework integration
Pipeline Builder Guide ML-powered data transformation and ETL automation
ML Models & AI Integration TensorFlow, OpenAI, Hugging Face integration guide
CLI Usage Command-line interface and headless operations
Real-World Use Cases Industry examples and implementation patterns
API Reference Complete API documentation and TypeScript types
Framework Integration React, Vue, Angular integration examples
Data Sources IoT, Kafka, API, and database integrations
System Architecture Technical architecture and design patterns

🛠️ CLI Usage

# Generate mind map from JSON
nodeq-mindmap generate --input data.json --output mindmap.svg

# Create data pipeline
nodeq-mindmap pipeline create \
  --input sample-input.json \
  --output sample-output.json \
  --name "My Pipeline"

# Execute pipeline
nodeq-mindmap pipeline execute \
  --name "My Pipeline" \
  --input new-data.json

🎨 Built-in Themes

// Theme presets: 'default', 'dark', 'forest', 'ocean'
mindMap.updateTheme({
  nodeColor: '#4299e1',
  textColor: '#2d3748',
  backgroundColor: '#ffffff'
});

🚀 What’s New in v2.1.0

✨ Enhanced Pipeline Engine with ML-powered transformation
🧠 Configurable ML Models (TensorFlow.js, Hugging Face, OpenAI)
🔌 Real-time Data Sources (IoT Hub, Kafka, REST APIs, WebSockets)
⚡ ETL Process Automation replacing traditional ETL workflows
📊 Performance Monitoring with built-in metrics

📊 Performance

📄 License

MIT License - see LICENSE file for details.

📞 Support

Transform your data with intelligence. Visualize your pipelines with clarity.

Made with ❤️ by the NODEQ Team

This site is open source. Improve this page.