metanorma-plugin-plantuml 1.0.6 → 1.0.8

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 75336a98da7df341a06f5414a384d4727814537fcabb01ec7cadf25e74de22fc
-  data.tar.gz: 45d100cab5c110e730306aec82952fb64283e76e5c15c5f37a23a704af2bb3f9
+  metadata.gz: f630e977bc4ffc712b558d93838862f20d33a3c321d170035f236b28f263caf9
+  data.tar.gz: 7767222a7655f56628928d69cf0990d38b5667c6cc74a009af2c53d1232ade2a
 SHA512:
-  metadata.gz: f91adf74d6025425419422f122c86ba28cb6febbd6b62de7e2f408322c10bcb7429b4f08242be4e1f5e548639122ce2a0755abe89289072e1732554d6938b9e6
-  data.tar.gz: c7f5edb42f7d063c68941d96d2f6d84e1974ba50f98910db731922515c4337c66542d952dba98542cca39efb4459eed0c95a49bf962ebd146bba6a700df73569
+  metadata.gz: 65d274ab21262faf3ffb1909f25b5e99c8eaad34c9f3df675b73aa7c727ca0d2e8f0a03ebd6e73c71e5a595dbf529d1b2e902c68ba635d7d866f8c417c8bc5e9
+  data.tar.gz: 9ddc2697ab8d6eb43a488aa8c3b30e8d7d0c0c2a6dcf7abbb72501f28b89aff1aae8f36108c65fed41d714c5c627833fa660e26f19d9d76d49d712b84a7826bd

data/.rubocop.yml

@@ -0,0 +1,27 @@
+# Auto-generated by Cimas: Do not edit it manually!
+# See https://github.com/metanorma/cimas
+inherit_from:
+  - .rubocop_todo.yml
+  - https://raw.githubusercontent.com/riboseinc/oss-guides/main/ci/rubocop.yml
+
+# local repo-specific modifications
+# ...
+
+Metrics/CyclomaticComplexity:
+  Max: 10
+
+Metrics/BlockLength:
+  Exclude:
+    - 'Rakefile'
+    - 'spec/**/*'
+
+Metrics/MethodLength:
+  Exclude:
+    - 'Rakefile'
+    - 'lib/metanorma/plugin/plantuml/block_processor.rb'
+    - 'lib/metanorma/plugin/plantuml/image_block_macro_processor.rb'
+    - 'lib/metanorma/plugin/plantuml/wrapper.rb'
+    - 'spec/**/*'
+
+AllCops:
+  TargetRubyVersion: 3.1

data/.rubocop_todo.yml

@@ -0,0 +1,53 @@
+# This configuration was generated by
+# `rubocop --auto-gen-config`
+# on 2025-10-03 01:36:37 UTC using RuboCop version 1.81.1.
+# The point is for the user to remove these configuration records
+# one by one as the offenses are removed from the code base.
+# Note that changes in the inspected code, or installation of new
+# versions of RuboCop, may require this file to be generated again.
+
+# Offense count: 1
+# Configuration parameters: Severity.
+Gemspec/RequiredRubyVersion:
+  Exclude:
+    - 'metanorma-plugin-plantuml.gemspec'
+
+# Offense count: 11
+# This cop supports safe autocorrection (--autocorrect).
+# Configuration parameters: Max, AllowHeredoc, AllowURI, AllowQualifiedName, URISchemes, IgnoreCopDirectives, AllowedPatterns, SplitStrings.
+# URISchemes: http, https
+Layout/LineLength:
+  Exclude:
+    - 'Rakefile'
+    - 'lib/metanorma/plugin/plantuml/backend.rb'
+    - 'lib/metanorma/plugin/plantuml/config.rb'
+    - 'lib/metanorma/plugin/plantuml/wrapper.rb'
+    - 'spec/metanorma/plugin/plantuml/plantuml_integration_spec.rb'
+
+# Offense count: 3
+# Configuration parameters: AllowedMethods, AllowedPatterns, CountRepeatedAttributes, Max.
+Metrics/AbcSize:
+  Exclude:
+    - 'Rakefile'
+
+# Offense count: 1
+# Configuration parameters: CountComments, CountAsOne, AllowedMethods, AllowedPatterns.
+# AllowedMethods: refine
+Metrics/BlockLength:
+  Exclude:
+    - 'Rakefile'
+
+# Offense count: 8
+# Configuration parameters: CountComments, CountAsOne, AllowedMethods, AllowedPatterns.
+Metrics/MethodLength:
+  Exclude:
+    - 'Rakefile'
+    - 'lib/metanorma/plugin/plantuml/block_processor.rb'
+    - 'lib/metanorma/plugin/plantuml/image_block_macro_processor.rb'
+    - 'lib/metanorma/plugin/plantuml/wrapper.rb'
+
+# Offense count: 1
+# Configuration parameters: AllowedMethods, AllowedPatterns, Max.
+Metrics/PerceivedComplexity:
+  Exclude:
+    - 'Rakefile'

data/Gemfile

@@ -1,3 +1,5 @@
+# frozen_string_literal: true
+
 Encoding.default_external = Encoding::UTF_8
 Encoding.default_internal = Encoding::UTF_8
 
@@ -24,6 +26,7 @@ gem "rspec"
 gem "rspec-html-matchers"
 gem "rubocop"
 gem "rubocop-performance"
+gem "rubocop-rake"
 gem "simplecov"
 gem "timecop"
 gem "vcr"

data/README.adoc

@@ -89,6 +89,7 @@ Generally, the command syntax is more suitable for referencing external PlantUML
 files.
 
 
+[[command-syntax]]
 === Command syntax for external diagrams
 
 PlantUML diagrams can be directly referenced from external files using the
@@ -104,7 +105,7 @@ plantuml_image::{plantuml-source.puml}[{options}]
 Where,
 
 `{plantuml-source.puml}`:: Path to the PlantUML source file, relative to the
-path of the current file.
+path of the document root file.
 
 `{options}`:: (Optional) Comma-separated list of options to customize diagram
 generation.
@@ -140,6 +141,35 @@ The file `foo/bar.puml` is the same as above.
 The `format=svg` option specifies the output format as SVG.
 ====
 
+The path to the PlantUML source file is relative to the document root file,
+which is illustrated in the following example.
+
+.PlantUML source file path is relative to document root
+[example]
+====
+Given the following directory structure:
+
+[source]
+----
+dir/
+dir/sources/document.adoc
+dir/sources/sections/section_1.adoc
+dir/sources/plantuml/my_diagram.puml
+----
+
+Where:
+
+* `document.adoc` includes `sections/section_1.adoc`
+* `section_1.adoc` contains the `plantuml_image` command.
+
+The path to the PlantUML source file in `section_1.adoc` is specified relative
+to `document.adoc`, the document root, which is `plantuml/my_diagram.puml`:
+
+[source,asciidoc]
+----
+plantuml_image::plantuml/my_diagram.puml[]
+----
+====
 
 
 === Block syntax for inline diagrams
@@ -452,6 +482,15 @@ Syntax:
 :plantuml-includedirs: {path1};{path2};...
 ----
 
+Where,
+
+`{path1}`, `{path2}`, etc.:: paths to directories (relative to document root)
+containing PlantUML files to be included, delimited by semicolons.
++
+NOTE: All paths passed to `includedirs` must be relative to the document root
+file, see <<command-syntax>> on how to determine the document root.
+
+
 .Resolving PlantUML includes with document-level `includedirs` attribute
 [example]
 ====

data/Rakefile

@@ -1,3 +1,7 @@
+# frozen_string_literal: true
+
+require "English"
+
 require "bundler/gem_tasks"
 require "rspec/core/rake_task"
 require_relative "lib/metanorma/plugin/plantuml/version"
@@ -17,7 +21,7 @@ end
 def github_client
   require "octokit"
   @github_client ||= begin
-    token = ENV['GITHUB_TOKEN'] || `gh auth token 2>/dev/null`.strip
+    token = ENV["GITHUB_TOKEN"] || `gh auth token 2>/dev/null`.strip
     token = nil if token.empty?
     if token
       Octokit::Client.new(access_token: token)
@@ -31,32 +35,32 @@ def find_latest_valid_plantuml_release
   puts "Searching for latest valid PlantUML release..."
 
   client = github_client
-  releases = client.releases('plantuml/plantuml')
+  releases = client.releases("plantuml/plantuml")
 
   # Filter for valid JAR releases
   valid_releases = releases.reject(&:prerelease).select do |release|
     tag_name = release.tag_name
-    version = tag_name.sub(/^v/, '')
+    version = tag_name.sub(/^v/, "")
     # Must match pattern v\d+\.\d{4}\.\d+ and not contain -native or other suffixes
     tag_name.match?(/^v\d+\.\d{4}\.\d+$/) &&
-    !tag_name.include?('-native') &&
-    !tag_name.include?('-snapshot') &&
-    release.assets.any? { |asset| asset.name == "plantuml-#{version}.jar" }
+      !tag_name.include?("-native") &&
+      !tag_name.include?("-snapshot") &&
+      release.assets.any? { |asset| asset.name == "plantuml-#{version}.jar" }
   end
 
-  if valid_releases.empty?
-    raise "No valid PlantUML JAR releases found"
-  end
+  raise "No valid PlantUML JAR releases found" if valid_releases.empty?
 
   latest = valid_releases.first
-  version = latest.tag_name.sub(/^v/, '')
+  version = latest.tag_name.sub(/^v/, "")
 
   puts "Found latest valid release: #{latest.tag_name} (#{version})"
   {
     version: version,
     tag_name: latest.tag_name,
     html_url: latest.html_url,
-    jar_asset: latest.assets.find { |asset| asset.name == "plantuml-#{version}.jar" }
+    jar_asset: latest.assets.find do |asset|
+      asset.name == "plantuml-#{version}.jar"
+    end,
   }
 rescue Octokit::Error => e
   puts "GitHub API error: #{e.message}"
@@ -80,8 +84,10 @@ def update_version_file(new_plantuml_version, new_gem_version)
 
   # Update PlantUML version (handle .freeze suffix)
   original_content = content.dup
-  content.gsub!(/VERSION = ["']([^"']+)["']\.freeze/, %Q(VERSION = "#{new_gem_version}".freeze))
-  content.gsub!(/PLANTUML_JAR_VERSION = ["']([^"']+)["']\.freeze/, %Q(PLANTUML_JAR_VERSION = "#{new_plantuml_version}".freeze))
+  content.gsub!(/VERSION = ["']([^"']+)["']\.freeze/,
+                %(VERSION = "#{new_gem_version}".freeze))
+  content.gsub!(/PLANTUML_JAR_VERSION = ["']([^"']+)["']\.freeze/,
+                %(PLANTUML_JAR_VERSION = "#{new_plantuml_version}".freeze))
 
   if content == original_content
     puts "⚠️  No changes made to version file. Current content:"
@@ -93,7 +99,7 @@ def update_version_file(new_plantuml_version, new_gem_version)
 
   # Verify the file was written correctly
   updated_content = File.read(version_file)
-  unless updated_content.include?(%Q("#{new_plantuml_version}")) && updated_content.include?(%Q("#{new_gem_version}"))
+  unless updated_content.include?(%("#{new_plantuml_version}")) && updated_content.include?(%("#{new_gem_version}"))
     puts "❌ File content after update:"
     puts updated_content
     raise "Version file update verification failed"
@@ -105,32 +111,31 @@ def update_version_file(new_plantuml_version, new_gem_version)
 end
 
 def increment_gem_version(current_version)
-  require 'rubygems'
+  require "rubygems"
   version = Gem::Version.new(current_version)
   segments = version.segments.dup
   segments[2] = (segments[2] || 0) + 1
-  segments.join('.')
+  segments.join(".")
 end
 
 def test_plantuml_jar
   jar_file = "data/plantuml.jar"
 
-  unless File.exist?(jar_file)
-    raise "PlantUML JAR file not found: #{jar_file}"
-  end
+  raise "PlantUML JAR file not found: #{jar_file}" unless File.exist?(jar_file)
 
   puts "Testing PlantUML JAR functionality..."
 
   # Test version command
   version_output = `java -jar #{jar_file} -version 2>&1`
-  unless $?.success? && version_output.include?("PlantUML")
+  unless $CHILD_STATUS.success? && version_output.include?("PlantUML")
     raise "PlantUML version test failed. Output: #{version_output}"
   end
+
   puts "✅ Version test passed"
 
   # Test diagram generation
   test_diagram = "test_diagram_#{Time.now.to_i}.puml"
-  test_svg = test_diagram.sub('.puml', '.svg')
+  test_svg = test_diagram.sub(".puml", ".svg")
 
   File.write(test_diagram, <<~PUML)
     @startuml
@@ -141,9 +146,10 @@ def test_plantuml_jar
 
   begin
     generation_output = `java -jar #{jar_file} -tsvg #{test_diagram} 2>&1`
-    unless $?.success? && File.exist?(test_svg)
+    unless $CHILD_STATUS.success? && File.exist?(test_svg)
       raise "PlantUML diagram generation test failed. Output: #{generation_output}"
     end
+
     puts "✅ Diagram generation test passed"
   ensure
     FileUtils.rm_f([test_diagram, test_svg])
@@ -214,7 +220,7 @@ task :update_plantuml do
     end
 
     # Check if update is actually newer
-    require 'rubygems'
+    require "rubygems"
     if Gem::Version.new(latest_version) <= Gem::Version.new(current_version)
       puts "⚠️  Latest version (#{latest_version}) is not newer than current (#{current_version})"
       exit 0
@@ -239,7 +245,6 @@ task :update_plantuml do
     puts "  Release: #{release_info[:html_url]}"
 
     exit 1  # Exit with code 1 to indicate changes were made
-
   rescue StandardError => e
     puts "❌ Failed to update PlantUML: #{e.message}"
     exit 2  # Exit with code 2 to indicate error
@@ -247,7 +252,7 @@ task :update_plantuml do
 end
 
 desc "Update PlantUML version in version.rb (manual)"
-task :update_plantuml_version, [:plantuml_version] do |t, args|
+task :update_plantuml_version, [:plantuml_version] do |_t, args|
   plantuml_version = args[:plantuml_version]
 
   unless plantuml_version

data/bin/console

@@ -1,4 +1,5 @@
 #!/usr/bin/env ruby
+# frozen_string_literal: true
 
 require "bundler/setup"
 require "metanorma/plugin/plantuml"

data/lib/metanorma/plugin/plantuml/backend.rb

@@ -34,9 +34,7 @@ module Metanorma
             filename = generate_unique_filename(fmt)
             extracted_filename = extract_plantuml_filename(plantuml_content)
 
-            if extracted_filename
-              filename = "#{extracted_filename}.#{fmt}"
-            end
+            filename = "#{extracted_filename}.#{fmt}" if extracted_filename
 
             absolute_path, relative_path = path_prep(ldir, imagesdir)
             output_file = File.join(absolute_path, filename)
@@ -48,9 +46,7 @@ module Metanorma
               includedirs: options[:includedirs],
             )
 
-            unless result[:success]
-              raise "No image output from PlantUML: #{result[:error].message}"
-            end
+            raise "No image output from PlantUML: #{result[:error].message}" unless result[:success]
 
             File.join(relative_path, filename)
           end
@@ -95,9 +91,7 @@ module Metanorma
             sourcepath = imagesdir ? File.join(localdir, imagesdir) : localdir
             path.mkpath
 
-            unless File.writable?(path)
-              raise "Destination path #{path} not writable for PlantUML!"
-            end
+            raise "Destination path #{path} not writable for PlantUML!" unless File.writable?(path)
 
             [
               path,
@@ -129,31 +123,28 @@ module Metanorma
           end
 
           def generate_attrs(attrs)
-            %w(id align float title role width height alt)
-              .inject({}) do |memo, key|
-              memo[key] = attrs[key] if attrs.has_key?(key)
-              memo
+            %w[id align float title role width height alt]
+              .each_with_object({}) do |key, memo|
+              memo[key] = attrs[key] if attrs.key?(key)
             end
           end
 
           private
 
-          def validate_plantuml_delimiters(src) # rubocop:disable Metrics/MethodLength
+          def validate_plantuml_delimiters(src)
             # Find @start... pattern
             # (case insensitive, support all PlantUML diagram types)
             start_match = src.match(/^@start(\w+)/i)
-            unless start_match
-              raise "PlantUML content must start with @start... directive!"
-            end
+            raise "PlantUML content must start with @start... directive!" unless start_match
 
             diagram_type = start_match[1].downcase
             end_pattern = "@end#{diagram_type}"
 
             # Look for matching @end... directive (case insensitive)
-            unless /#{Regexp.escape(end_pattern)}\s*$/mi.match?(src)
-              raise "@start#{diagram_type} without matching #{end_pattern} " \
-                    "in PlantUML!"
-            end
+            return if /#{Regexp.escape(end_pattern)}\s*$/mi.match?(src)
+
+            raise "@start#{diagram_type} without matching #{end_pattern} " \
+                  "in PlantUML!"
           end
 
           def extract_plantuml_filename(plantuml_content)

data/lib/metanorma/plugin/plantuml/block_processor.rb

@@ -11,15 +11,17 @@ module Metanorma
         on_context :literal
         parse_content_as :raw
 
-        def process(parent, reader, attrs) # rubocop:disable Metrics/AbcSize, Metrics/MethodLength
+        def process(parent, reader, attrs)
           # Check for document-level disable flag
           if parent.document.attr("plantuml-disabled")
-            return abort(parent, reader, attrs, "PlantUML processing disabled")
+            return abort(parent, reader, attrs,
+                         "PlantUML processing disabled")
           end
 
           # Check PlantUML availability explicitly
           unless Backend.plantuml_available?
-            return abort(parent, reader, attrs, "PlantUML not installed")
+            return abort(parent, reader, attrs,
+                         "PlantUML not installed")
           end
 
           # Parse format specifications

data/lib/metanorma/plugin/plantuml/block_processor_base.rb

@@ -75,7 +75,7 @@ module Metanorma
           includedirs.compact.uniq
         end
 
-        def process_image_block(parent, reader, attrs, formats, options) # rubocop:disable Metrics/AbcSize, Metrics/MethodLength
+        def process_image_block(parent, reader, attrs, formats, options) # rubocop:disable Metrics/MethodLength
           if formats.length == 1
             # Single format - original behavior
             filename = Backend.generate_file(

data/lib/metanorma/plugin/plantuml/config.rb

@@ -1,3 +1,5 @@
+# frozen_string_literal: true
+
 require "rbconfig"
 
 module Metanorma
@@ -20,9 +22,7 @@ module Metanorma
             "-Djava.awt.headless=true",
           ]
 
-          if RbConfig::CONFIG["host_os"].match?(/darwin|mac os/)
-            options << "-Dapple.awt.UIElement=true"
-          end
+          options << "-Dapple.awt.UIElement=true" if RbConfig::CONFIG["host_os"].match?(/darwin|mac os/)
 
           options
         end

data/lib/metanorma/plugin/plantuml/errors.rb

@@ -1,3 +1,5 @@
+# frozen_string_literal: true
+
 module Metanorma
   module Plugin
     module Plantuml

data/lib/metanorma/plugin/plantuml/image_block_macro_processor.rb

@@ -9,15 +9,17 @@ module Metanorma
         use_dsl
         named :plantuml_image
 
-        def process(parent, reader, attrs) # rubocop:disable Metrics/AbcSize, Metrics/MethodLength
+        def process(parent, reader, attrs)
           # Check for document-level disable flag
           if parent.document.attr("plantuml-disabled")
-            return abort(parent, reader, attrs, "PlantUML processing disabled")
+            return abort(parent, reader, attrs,
+                         "PlantUML processing disabled")
           end
 
           # Check PlantUML availability explicitly
           unless Backend.plantuml_available?
-            return abort(parent, reader, attrs, "PlantUML not installed")
+            return abort(parent, reader, attrs,
+                         "PlantUML not installed")
           end
 
           # Parse format specifications
@@ -33,7 +35,9 @@ module Metanorma
 
         def add_image_path_to_includedirs(document, image_path, includedirs)
           docdir = document.attributes["docdir"]
-          includedirs << File.dirname(File.join(docdir, image_path))
+          includedirs << File.dirname(
+            document.path_resolver.system_path(image_path, docdir),
+          )
           includedirs.compact.uniq
         end
 

data/lib/metanorma/plugin/plantuml/version.rb

@@ -1,8 +1,10 @@
+# frozen_string_literal: true
+
 module Metanorma
   module Plugin
     module Plantuml
-      VERSION = "1.0.6".freeze
-      PLANTUML_JAR_VERSION = "1.2025.7".freeze
+      VERSION = "1.0.8"
+      PLANTUML_JAR_VERSION = "1.2025.7"
     end
   end
 end

data/lib/metanorma/plugin/plantuml/wrapper.rb

@@ -1,3 +1,5 @@
+# frozen_string_literal: true
+
 require "open3"
 require "base64"
 require "tempfile"
@@ -12,27 +14,25 @@ module Metanorma
   module Plugin
     module Plantuml
       class Wrapper
-        PLANTUML_JAR_NAME = "plantuml.jar".freeze
+        PLANTUML_JAR_NAME = "plantuml.jar"
         PLANTUML_JAR_PATH = File.join(
-          File.dirname(__FILE__), "..", "..", "..",
-          "..", "data", PLANTUML_JAR_NAME
+          Gem::Specification.find_by_name("metanorma-plugin-plantuml").gem_dir,
+          "data", PLANTUML_JAR_NAME
         )
 
         SUPPORTED_FORMATS = %w[png svg pdf txt eps].freeze
-        DEFAULT_FORMAT = "png".freeze
+        DEFAULT_FORMAT = "png"
 
         class << self
           def jvm_options
             options = ["-Xss5m", "-Xmx1024m"]
 
-            if RbConfig::CONFIG["host_os"].match?(/darwin|mac os/)
-              options << "-Dapple.awt.UIElement=true"
-            end
+            options << "-Dapple.awt.UIElement=true" if RbConfig::CONFIG["host_os"].match?(/darwin|mac os/)
 
             options
           end
 
-          def generate( # rubocop:disable Metrics/MethodLength, Metrics/AbcSize
+          def generate( # rubocop:disable Metrics/MethodLength
             content,
             format: DEFAULT_FORMAT,
             output_file: nil,
@@ -58,17 +58,15 @@ module Metanorma
             { success: false, error: e }
           end
 
-          def get_include_files(content, _options) # rubocop:disable Metrics/MethodLength
+          def get_include_files(content, _options)
             include_files = []
             content.each_line do |line|
               case line
               when /(!include|!includesub)\s(.+){1}/
-                found_file = $2.split("!").first
+                found_file = ::Regexp.last_match(2).split("!").first
 
                 # skip web links and standard libraries
-                if found_file.start_with?("<", "http")
-                  found_file = nil
-                end
+                found_file = nil if found_file.start_with?("<", "http")
 
                 include_files << found_file
               end
@@ -81,7 +79,8 @@ module Metanorma
             output_file: nil, base64: false, **options
           )
             unless File.exist?(input_file)
-              raise GenerationError.new("Input file not found: #{input_file}")
+              raise GenerationError,
+                    "Input file not found: #{input_file}"
             end
 
             content = File.read(input_file)
@@ -123,21 +122,21 @@ module Metanorma
 
           def validate_format!(format)
             format_str = format.to_s.downcase
-            unless SUPPORTED_FORMATS.include?(format_str)
-              raise InvalidFormatError.new(format, SUPPORTED_FORMATS)
-            end
+            return if SUPPORTED_FORMATS.include?(format_str)
+
+            raise InvalidFormatError.new(format, SUPPORTED_FORMATS)
           end
 
           def ensure_jar_available!
-            unless File.exist?(PLANTUML_JAR_PATH)
-              raise JarNotFoundError.new(PLANTUML_JAR_PATH)
-            end
+            return if File.exist?(PLANTUML_JAR_PATH)
+
+            raise JarNotFoundError, PLANTUML_JAR_PATH
           end
 
           def ensure_java_available!
-            unless java_available?
-              raise JavaNotFoundError.new
-            end
+            return if java_available?
+
+            raise JavaNotFoundError
           end
 
           def java_available?
@@ -155,24 +154,22 @@ module Metanorma
             execute_plantuml(content, format, output_file, options)
 
             unless File.exist?(output_file)
-              raise GenerationError.new(
-                "Output file was not created: #{output_file}",
-              )
+              raise GenerationError,
+                    "Output file was not created: #{output_file}"
             end
 
             { output_path: File.expand_path(output_file) }
           end
 
-          def generate_to_base64(content, format, options) # rubocop:disable Metrics/MethodLength
+          def generate_to_base64(content, format, options)
             Tempfile.create(["plantuml_output", ".#{format}"]) do |temp_file|
               temp_file.close
 
               execute_plantuml(content, format, temp_file.path, options)
 
               unless File.exist?(temp_file.path)
-                raise GenerationError.new(
-                  "Temporary output file was not created",
-                )
+                raise GenerationError,
+                      "Temporary output file was not created"
               end
 
               encoded_content = Base64
@@ -204,30 +201,33 @@ module Metanorma
                 if options[:includedirs].empty?
                   # raise error when include files are found but includedirs
                   # is nil
-                  raise PlantumlError.new(
-                    "includedirs is required when include files are specified",
-                  )
+                  raise PlantumlError,
+                        "includedirs is required when include files are specified"
                 end
 
                 options[:include_files].each do |include_file|
                   # find local include file in includedirs
                   found_include_file = nil
                   options[:includedirs].each do |includedir|
-                    include_file_path = File.join(includedir, include_file)
+                    include_file_path = Pathname.new(includedir)
+                      .join(include_file).to_s
+
                     if File.exist?(include_file_path)
                       found_include_file = include_file_path
                       break
                     end
                   end
 
-                  if found_include_file
-                    # create include file in temp directory
-                    temp_include_file = File.join(temp_dir, include_file)
-                    FileUtils.mkdir_p(File.dirname(temp_include_file))
+                  next unless found_include_file
 
-                    File.open(temp_include_file, "w") do |f|
-                      f.write(File.read(found_include_file))
-                    end
+                  # create include file in temp directory
+                  temp_include_file = Pathname.new(temp_dir)
+                    .join(include_file).to_s
+
+                  FileUtils.mkdir_p(File.dirname(temp_include_file))
+
+                  File.open(temp_include_file, "w") do |f|
+                    f.write(File.read(found_include_file))
                   end
                 end
               end
@@ -264,7 +264,7 @@ module Metanorma
                   error_msg += "Found files: #{generated_files.map do |f|
                     File.basename(f)
                   end.join(', ')}"
-                  raise GenerationError.new(error_msg)
+                  raise GenerationError, error_msg
                 end
               end
 
@@ -272,7 +272,7 @@ module Metanorma
             end
           end
 
-          def find_generated_file(temp_dir, content, format) # rubocop:disable Metrics/MethodLength
+          def find_generated_file(temp_dir, content, format)
             # PlantUML generates files based on the filename specified in
             # @start... line
             extension = format.to_s.downcase
@@ -304,7 +304,7 @@ module Metanorma
             filename.gsub(/^["']|["']$/, "")
           end
 
-          def build_command(input_file, format, output_dir, _options) # rubocop:disable Metrics/AbcSize, Metrics/MethodLength
+          def build_command(input_file, format, output_dir, _options) # rubocop:disable Metrics/MethodLength
             cmd = [
               configuration.java_path,
               *jvm_options,
@@ -313,9 +313,10 @@ module Metanorma
 
             # Add format-specific options
             format_str = format.to_s.downcase
-            if SUPPORTED_FORMATS.include?(format_str)
-              cmd << "-t#{format_str}"
-            end
+            cmd << "-t#{format_str}" if SUPPORTED_FORMATS.include?(format_str)
+
+            # Use 'smetana' layout engine for pragma
+            cmd << "-Playout=smetana"
 
             # Add output directory option
             cmd << "-o" << output_dir

data/lib/metanorma-plugin-plantuml.rb

@@ -1,3 +1,5 @@
+# frozen_string_literal: true
+
 module Metanorma
   module Plugin
     module Plantuml

data/metanorma-plugin-plantuml.gemspec

@@ -1,3 +1,5 @@
+# frozen_string_literal: true
+
 lib = File.expand_path("lib", __dir__)
 $LOAD_PATH.unshift(lib) unless $LOAD_PATH.include?(lib)
 require "metanorma/plugin/plantuml/version"
@@ -26,7 +28,7 @@ Gem::Specification.new do |spec|
   spec.executables   = spec.files.grep(%r{^exe/}) { |f| File.basename(f) }
   spec.require_paths = ["lib"]
 
-  spec.required_ruby_version = ">= 2.7.0" # rubocop:disable Gemspec/RequiredRubyVersion
+  spec.required_ruby_version = ">= 2.7.0"
 
   spec.add_dependency "asciidoctor"
   spec.add_dependency "isodoc"

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: metanorma-plugin-plantuml
 version: !ruby/object:Gem::Version
-  version: 1.0.6
+  version: 1.0.8
 platform: ruby
 authors:
 - Ribose Inc.
 autorequire:
 bindir: exe
 cert_chain: []
-date: 2025-09-15 00:00:00.000000000 Z
+date: 2025-10-03 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: asciidoctor
@@ -49,6 +49,8 @@ files:
 - ".github/workflows/rake.yml"
 - ".github/workflows/release.yml"
 - ".gitignore"
+- ".rubocop.yml"
+- ".rubocop_todo.yml"
 - Gemfile
 - LICENSE
 - README.adoc