ea 0.1.0 → 0.1.5

data/config/diagram_styles.yml

@@ -0,0 +1,200 @@
+# diagram_styles.yml - Configurable EA Diagram Styling
+# This file defines the default styling for LutaML diagram generation
+
+# Global defaults - applied when no other configuration matches
+defaults:
+  colors:
+    background: "#FFFFFF"
+    default_fill: "#E0E0E0"
+    default_stroke: "#000000"
+    text: "#000000"
+
+  fonts:
+    default:
+      family: "Carlito, Arial, sans-serif"
+      size: 9
+      weight: 400
+      style: normal
+
+    class_name:
+      family: "Carlito, Arial, sans-serif"
+      size: 9
+      weight: 700  # bold
+      style: normal
+
+    stereotype:
+      family: "Carlito, Arial, sans-serif"
+      size: 9
+      weight: 400
+      style: normal
+
+    attribute:
+      family: "Carlito, Arial, sans-serif"
+      size: 9
+      weight: 400
+      style: normal
+
+    operation:
+      family: "Carlito, Arial, sans-serif"
+      size: 9
+      weight: 400
+      style: normal
+
+  box:
+    stroke_width: 2
+    stroke_linecap: round
+    stroke_linejoin: bevel
+    corner_radius: 0
+    padding: 5
+    fill_opacity: 1.0
+    stroke_opacity: 1.0
+
+  text:
+    visibility_public: "+"
+    visibility_private: "-"
+    visibility_protected: "#"
+    visibility_package: "~"
+    cardinality_format: "[%s]"
+    stereotype_format: "«%s»"
+
+# Stereotype-based styling
+# These apply when elements have specific stereotypes
+stereotypes:
+  DataType:
+    colors:
+      fill: "#FFCCFF"  # Pink for i-UR DataTypes
+      stroke: "#000000"
+    fonts:
+      class_name:
+        weight: 700
+        style: italic
+
+  FeatureType:
+    colors:
+      fill: "#FFFFCC"  # Yellow for CityGML FeatureTypes
+      stroke: "#000000"
+
+  GMLType:
+    colors:
+      fill: "#CCFFCC"  # Green for GML Types
+      stroke: "#000000"
+
+  Interface:
+    colors:
+      fill: "#FFFFEE"
+      stroke: "#000000"
+    fonts:
+      class_name:
+        style: italic
+
+  Enumeration:
+    colors:
+      fill: "#FFE6CC"
+      stroke: "#000000"
+
+  Abstract:
+    fonts:
+      class_name:
+        style: italic
+
+# Package-based styling (optional)
+# Supports wildcards: "CityGML::*" matches any package starting with "CityGML::"
+packages:
+  "CityGML::*":
+    colors:
+      fill: "#FFFFCC"
+
+  "i-UR::*":
+    colors:
+      fill: "#FFCCFF"
+
+  "gml::*":
+    colors:
+      fill: "#CCFFCC"
+
+# Class-specific overrides (highest priority after EA data)
+# These take precedence over package and stereotype styling
+classes: {}
+
+# Connector styling
+connectors:
+  generalization:
+    arrow:
+      type: hollow_triangle
+      size: 10
+    line:
+      stroke_width: 1
+      stroke: "#000000"
+      fill: none
+
+  association:
+    arrow:
+      type: open_arrow
+      size: 8
+    line:
+      stroke_width: 1
+      stroke: "#000000"
+    labels:
+      show_role_names: true
+      show_cardinality: true
+      font:
+        family: "Carlito, Arial, sans-serif"
+        size: 8
+
+  dependency:
+    arrow:
+      type: open_arrow
+      size: 8
+    line:
+      stroke_width: 1
+      stroke: "#000000"
+      stroke_dasharray: "5,5"
+
+  aggregation:
+    arrow:
+      type: diamond
+      size: 10
+      fill: white
+    line:
+      stroke_width: 1
+      stroke: "#000000"
+
+  composition:
+    arrow:
+      type: filled_diamond
+      size: 10
+      fill: black
+    line:
+      stroke_width: 1
+      stroke: "#000000"
+
+  realization:
+    arrow:
+      type: hollow_triangle
+      size: 10
+    line:
+      stroke_width: 1
+      stroke: "#000000"
+      stroke_dasharray: "5,5"
+
+# Legend configuration
+legend:
+  enabled: true
+  position: bottom_right
+  title: "Legend"
+  box:
+    fill: "#FFFFFF"
+    stroke: "#000000"
+    stroke_width: 1
+    padding: 10
+  font:
+    family: "Carlito, Arial, sans-serif"
+    size: 9
+    weight: 400
+  entries:
+    - label: "i-UR DataTypes"
+      color: "#FFCCFF"
+    - label: "CityGML FeatureTypes"
+      color: "#FFFFCC"
+    - label: "GML Types"
+      color: "#CCFFCC"

data/config/model_transformations.yml

@@ -0,0 +1,266 @@
+# Model Transformations Configuration
+# This file configures the unified model transformation system for LutaML
+#
+# Version: 1.0
+# Description: External configuration for model format parsers and transformation options
+
+version: "1.0"
+description: "LutaML Model Transformations Configuration"
+
+# Parser configurations define how different model formats are handled
+parsers:
+  # XML Metadata Interchange (XMI) Parser
+  - format: "xmi"
+    extension: ".xmi"
+    parser_class: "Lutaml::ModelTransformations::Parsers::XmiParser"
+    enabled: true
+    priority: 100
+    description: "XML Metadata Interchange parser for UML models"
+    options:
+      - "validate_xml"
+      - "resolve_references"
+      - "preserve_namespaces"
+      - "include_documentation"
+
+  # Enterprise Architect Database (QEA) Parser
+  - format: "qea"
+    extension: ".qea"
+    parser_class: "Lutaml::ModelTransformations::Parsers::QeaParser"
+    enabled: true
+    priority: 90
+    description: "Enterprise Architect database parser"
+    options:
+      - "include_diagrams"
+      - "validate_transformation"
+      - "load_progress_callback"
+      - "cache_database"
+
+  # Legacy XML support (lower priority than XMI)
+  - format: "xml"
+    extension: ".xml"
+    parser_class: "Lutaml::ModelTransformations::Parsers::XmiParser"
+    enabled: true
+    priority: 80
+    description: "Generic XML parser (delegates to XMI parser)"
+    options:
+      - "validate_xml"
+      - "resolve_references"
+
+  # Enterprise Architect Project files (legacy format)
+  - format: "eap"
+    extension: ".eap"
+    parser_class: "Lutaml::ModelTransformations::Parsers::QeaParser"
+    enabled: true
+    priority: 70
+    description: "Enterprise Architect project file parser"
+    options:
+      - "include_diagrams"
+      - "legacy_format_support"
+
+  # Enterprise Architect Exchange files
+  - format: "eapx"
+    extension: ".eapx"
+    parser_class: "Lutaml::ModelTransformations::Parsers::QeaParser"
+    enabled: true
+    priority: 75
+    description: "Enterprise Architect exchange file parser"
+    options:
+      - "include_diagrams"
+      - "compressed_format"
+
+# Global transformation options
+transformation_options:
+  # Validate output document structure after parsing
+  validate_output: false
+
+  # Include diagram information in transformed documents
+  include_diagrams: true
+
+  # Preserve original XMI/QEA IDs in transformed elements
+  preserve_ids: true
+
+  # Resolve cross-references between model elements
+  resolve_references: true
+
+  # Enable strict validation mode (fail on warnings)
+  strict_mode: false
+
+# Format detection configuration
+format_detection:
+  # Use file extensions for format detection
+  use_file_extension: true
+
+  # Use content analysis (magic bytes) for format detection
+  use_content_sniffing: true
+
+  # Fallback parser when format cannot be detected
+  fallback_parser: "Lutaml::ModelTransformations::Parsers::XmiParser"
+
+  # Magic byte signatures for content detection
+  magic_bytes:
+    - "SQLite format 3"  # QEA/SQLite files
+    - "<?xml"            # XML/XMI files
+
+# Error handling configuration
+error_handling:
+  # Error handling strategy: "continue", "fail_fast", "collect"
+  strategy: "continue"
+
+  # Log errors and warnings to console
+  log_errors: true
+
+  # Maximum number of errors before aborting (0 = unlimited)
+  max_errors: 10
+
+  # Fail immediately on first error
+  fail_fast: false
+
+# Format-specific configurations
+format_specific:
+  xmi:
+    # XMI-specific options
+    namespace_handling: "preserve"
+    reference_resolution: "eager"
+    xml_validation: "lenient"
+    encoding_detection: "auto"
+
+  qea:
+    # QEA-specific options
+    database_timeout: 30
+    load_strategy: "progressive"
+    diagram_processing: "full"
+    schema_validation: "basic"
+
+# Performance tuning
+performance:
+  # Enable parser instance caching
+  cache_parsers: true
+
+  # Maximum size for parser cache (number of instances)
+  max_parser_cache_size: 10
+
+  # Enable transformation history tracking
+  track_history: true
+
+  # Maximum number of history entries to keep
+  max_history_size: 1000
+
+# Logging configuration
+logging:
+  # Log level: "debug", "info", "warn", "error"
+  level: "info"
+
+  # Include timestamps in log messages
+  include_timestamps: true
+
+  # Include parser class names in log messages
+  include_parser_names: true
+
+  # Log transformation statistics
+  log_statistics: true
+
+# Plugin/extension support
+plugins:
+  # Enable plugin system
+  enabled: false
+
+  # Plugin discovery paths
+  discovery_paths:
+    - "lib/lutaml/model_transformations/plugins"
+    - "~/.lutaml/plugins"
+
+  # Auto-load plugins on startup
+  auto_load: false
+
+# Validation rules
+validation:
+  # Required elements validation
+  require_packages: false
+  require_classes: false
+
+  # Reference validation
+  check_broken_references: true
+  allow_external_references: true
+
+  # Naming validation
+  validate_naming_conventions: false
+  naming_patterns:
+    package: "^[A-Z][a-zA-Z0-9]*$"
+    class: "^[A-Z][a-zA-Z0-9]*$"
+    attribute: "^[a-z][a-zA-Z0-9]*$"
+
+# Transformation presets for common scenarios
+presets:
+  # Fast parsing preset (minimal validation, no diagrams)
+  fast:
+    transformation_options:
+      validate_output: false
+      include_diagrams: false
+      resolve_references: false
+    error_handling:
+      strategy: "fail_fast"
+      log_errors: false
+
+  # Comprehensive parsing preset (full validation and processing)
+  comprehensive:
+    transformation_options:
+      validate_output: true
+      include_diagrams: true
+      resolve_references: true
+      strict_mode: true
+    error_handling:
+      strategy: "collect"
+      log_errors: true
+      max_errors: 0
+
+  # Production preset (balanced performance and reliability)
+  production:
+    transformation_options:
+      validate_output: true
+      include_diagrams: true
+      resolve_references: true
+      strict_mode: false
+    error_handling:
+      strategy: "continue"
+      log_errors: true
+      max_errors: 5
+    performance:
+      cache_parsers: true
+      track_history: false
+
+# Compatibility settings
+compatibility:
+  # Support legacy LutaML API
+  legacy_api_support: true
+
+  # Automatic migration of old configuration formats
+  auto_migrate_config: true
+
+  # Deprecated feature warnings
+  warn_deprecated: true
+
+# Development/debugging options
+development:
+  # Enable debug mode
+  debug_mode: false
+
+  # Dump intermediate transformation results
+  dump_intermediate: false
+
+  # Benchmark transformation performance
+  benchmark_mode: false
+
+  # Verbose parser output
+  verbose_parsing: false
+
+# Integration settings
+integration:
+  # UML Repository integration
+  auto_build_repository: true
+  repository_lazy_loading: false
+
+  # CLI integration
+  register_cli_commands: true
+
+  # Web UI integration
+  enable_web_ui: false