lutaml 0.9.43 → 0.10.0

data/Rakefile

@@ -1,6 +1,12 @@
+# frozen_string_literal: true
+
 require "bundler/gem_tasks"
 require "rspec/core/rake_task"
 
 RSpec::Core::RakeTask.new(:spec)
 
-task default: :spec
+require "rubocop/rake_task"
+
+RuboCop::RakeTask.new
+
+task default: %i[spec rubocop]

data/bin/plantuml2lutaml

@@ -14,9 +14,9 @@ def sync_puts(line, level = 0)
   $stdout.flush
 end
 
-SKIPPED_LINES_REGEXP = /^(@startuml|'\*{7}|note|@enduml|!|'\/)/.freeze
-COMMENT_START = /\/'/.freeze
-COMMENT_END = /'\//.freeze
+SKIPPED_LINES_REGEXP = /^(@startuml|'\*{7}|note|@enduml|!|'\/)/
+COMMENT_START = /\/'/
+COMMENT_END = /'\//
 ASSOCIATION_MAPPINGS = {
   /-\|>/ => ",inheritance",
   /<\|-/ => "inheritance,",

data/bin/yaml2lutaml

@@ -7,7 +7,7 @@
 
 require "yaml"
 
-view_yaml = YAML.safe_load(File.read(ARGV[0]))
+view_yaml = YAML.safe_load_file(ARGV[0])
 models_path = File.expand_path("../../models", ARGV[0])
 
 def sync_puts(line, level = 0)
@@ -85,7 +85,7 @@ view_yaml["relations"]&.each do |values|
 end
 
 view_yaml["imports"].each_key do |entry| # rubocop:disable Metrics/BlockLength
-  import = YAML.safe_load(File.read(File.join(models_path, "#{entry}.yml")))
+  import = YAML.safe_load_file(File.join(models_path, "#{entry}.yml"))
   import_name = import["name"] || File.basename(entry)
   # Class notation
   sync_puts("#{import['modelType']} #{import_name} {", 2)

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

data/config/package_metadata.example.yml

@@ -0,0 +1,58 @@
+# Package Metadata Configuration Example
+#
+# This file demonstrates how to configure package metadata for use with
+# LutaML's PackageMetadata system.
+#
+# Package metadata enables external configuration of:
+# - XSD generation: xmlns, targetNamespace, schemaLocation
+# - Documentation: Package descriptions
+# - Styling: Package-specific styling rules
+# - Validation: Package constraints
+#
+# Format: YAML with "packages" root key
+
+packages:
+  # Exact package path match
+  "ModelRoot::i-UR::Urban Planning ADE 3.2::uro":
+    xmlns: "http://www.kantei.go.jp/jp/singi/tiiki/toshisaisei/itoshisaisei/iur/uro/2.0"
+    targetNamespace: "http://www.kantei.go.jp/jp/singi/tiiki/toshisaisei/itoshisaisei/iur/uro/2.0"
+    schemaLocation: "../../schemas/uro/2.0/urbanObject.xsd"
+    prefix: "uro"
+    documentation: |
+      Urban Object package containing classes for urban planning and
+      infrastructure modeling in PLATEAU i-UR standard.
+    version: "2.0"
+
+  # Another exact match
+  "ModelRoot::CityGML2.0::Core":
+    xmlns: "http://www.opengis.net/citygml/2.0"
+    targetNamespace: "http://www.opengis.net/citygml/2.0/core"
+    schemaLocation: "http://schemas.opengis.net/citygml/2.0/cityGMLBase.xsd"
+    prefix: "core"
+    documentation: "CityGML 2.0 Core module - fundamental city model classes"
+
+  # Wildcard pattern: matches any direct child of ModelRoot::CityGML2.0
+  "ModelRoot::CityGML2.0::*":
+    xmlns: "http://www.opengis.net/citygml/2.0"
+    prefix: "citygml"
+    documentation: "Default CityGML 2.0 namespace"
+
+  # Multi-level wildcard: matches ModelRoot::<anything>::Common
+  "ModelRoot::*::Common":
+    documentation: "Common elements package"
+    category: "utilities"
+
+  # Package with custom metadata
+  "ModelRoot::CustomPackage":
+    xmlns: "http://example.com/custom/1.0"
+    prefix: "custom"
+    author: "Your Organization"
+    license: "Apache-2.0"
+    contact: "info@example.com"
+
+# Notes:
+# 1. Exact matches take precedence over wildcard patterns
+# 2. Multiple wildcards can match the same package path
+# 3. Metadata from all matches is merged (exact match wins)
+# 4. Any custom keys are supported beyond the standard ones
+# 5. Package paths use "::" as separator (UML qualified name format)