suma 0.1.20 → 0.1.22

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 930231a5ca9c90a49c8e52b4a0881e2f93fd87508506872c02e693b9c0b8b25e
-  data.tar.gz: 13202f05c7673f950e8d4de87a7088a044db5e0b393cf768889c3c0483baf174
+  metadata.gz: 414cf7549060d821671a08771418a9f3c163ba23af62ef980eb4b12ccd0f5ad4
+  data.tar.gz: 0b30377a2b1db558bf62c765f136c5c505ba905b387a5d76e249fc48fce8c237
 SHA512:
-  metadata.gz: 63c387978764d7bf16fb2b8ea129038dbbf771a360415ddf09254ab14dcf33cdae44166fbdb60439e52026925c7755e4b631985ac0b41d9b2cc43311e3e2374c
-  data.tar.gz: 8632ad3a285fa3a970805c7491812f07ed9501268f6cf3ce12fcb2be22b48d30a494e47bfbb40de1f4fe3f4c0e4822f5c2e3978637605f3afac7b2eb28edb8b9
+  metadata.gz: 7e899f31a08df29536d7abe1e8d2fc29a0c20038e1bb7dcedda35a7b9fa5d5041046e963d543401b4eaa100fa9d1aff19218b4e1c72457fb2a081a34211072f5
+  data.tar.gz: c764fc1985311dafb09074a498cfc30694427e95c2f29d4d243872fca5ddfa0ab6df3d323d785254b3ef69848cf3114c8b0b44b483ae09b97a1e293b05f82356

data/.rubocop_todo.yml

@@ -1,26 +1,24 @@
 # This configuration was generated by
 # `rubocop --auto-gen-config`
-# on 2025-07-18 05:24:45 UTC using RuboCop version 1.78.0.
+# on 2025-10-04 11:33:46 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: 3
-# Configuration parameters: Severity, Include.
-# Include: **/*.gemspec
+# Configuration parameters: Severity.
 Gemspec/DuplicatedAssignment:
   Exclude:
     - 'suma.gemspec'
 
 # Offense count: 1
-# Configuration parameters: Severity, Include.
-# Include: **/*.gemspec
+# Configuration parameters: Severity.
 Gemspec/RequiredRubyVersion:
   Exclude:
     - 'suma.gemspec'
 
-# Offense count: 28
+# Offense count: 67
 # This cop supports safe autocorrection (--autocorrect).
 # Configuration parameters: Max, AllowHeredoc, AllowURI, AllowQualifiedName, URISchemes, IgnoreCopDirectives, AllowedPatterns, SplitStrings.
 # URISchemes: http, https
@@ -29,6 +27,8 @@ Layout/LineLength:
     - 'lib/suma/cli.rb'
     - 'lib/suma/cli/build.rb'
     - 'lib/suma/cli/validate.rb'
+    - 'lib/suma/jsdai/figure.rb'
+    - 'lib/suma/jsdai/figure_image.rb'
     - 'lib/suma/processor.rb'
     - 'lib/suma/schema_attachment.rb'
     - 'lib/suma/schema_collection.rb'
@@ -36,27 +36,44 @@ Layout/LineLength:
     - 'lib/suma/thor_ext.rb'
     - 'spec/suma/cli/extract_terms_spec.rb'
     - 'spec/suma/cli/validate_ascii_spec.rb'
+    - 'spec/suma/jsdai/figure_spec.rb'
     - 'suma.gemspec'
 
+# Offense count: 2
+# Configuration parameters: IgnoreLiteralBranches, IgnoreConstantBranches, IgnoreDuplicateElseBranch.
+Lint/DuplicateBranch:
+  Exclude:
+    - 'lib/suma/jsdai/figure.rb'
+
 # Offense count: 1
 Lint/DuplicateMethods:
   Exclude:
     - 'lib/suma/express_schema.rb'
 
-# Offense count: 4
+# Offense count: 9
 # Configuration parameters: AllowedMethods, AllowedPatterns, CountRepeatedAttributes, Max.
 Metrics/AbcSize:
   Exclude:
+    - 'lib/suma/jsdai/figure.rb'
+    - 'lib/suma/jsdai/figure_image.rb'
     - 'lib/suma/schema_attachment.rb'
     - 'lib/suma/schema_document.rb'
     - 'lib/suma/thor_ext.rb'
 
-# Offense count: 1
+# Offense count: 3
 # Configuration parameters: AllowedMethods, AllowedPatterns, Max.
 Metrics/CyclomaticComplexity:
   Exclude:
+    - 'lib/suma/jsdai/figure.rb'
+    - 'lib/suma/jsdai/figure_image.rb'
     - 'lib/suma/thor_ext.rb'
 
+# Offense count: 1
+# Configuration parameters: AllowedMethods, AllowedPatterns, Max.
+Metrics/PerceivedComplexity:
+  Exclude:
+    - 'lib/suma/jsdai/figure_image.rb'
+
 # Offense count: 4
 # Configuration parameters: EnforcedStyle, CheckMethodNames, CheckSymbols, AllowedIdentifiers, AllowedPatterns.
 # SupportedStyles: snake_case, normalcase, non_integer
@@ -71,11 +88,11 @@ Performance/CollectionLiteralInLoop:
   Exclude:
     - 'spec/suma/cli_spec.rb'
 
-# Offense count: 9
+# Offense count: 24
 # Configuration parameters: CountAsOne.
 RSpec/ExampleLength:
   Max: 44
 
-# Offense count: 6
+# Offense count: 21
 RSpec/MultipleExpectations:
   Max: 12

data/Gemfile

@@ -5,6 +5,7 @@ source "https://rubygems.org"
 # Specify your gem's dependencies in suma.gemspec
 gemspec
 
+gem "nokogiri"
 gem "rake"
 gem "rspec"
 gem "rubocop"

data/README.adoc

@@ -36,13 +36,14 @@ $ gem install suma
 ----
 # Defaults to `suma help`
 $ suma
-Commands:
-  suma build METANORMA_SITE_MANIFEST        # Build collection specified in site manifest (`metanorma*.yml`)
-  suma reformat EXPRESS_FILE_PATH           # Reformat EXPRESS files
-  suma validate SUBCOMMAND ...ARGS          # Validate express documents
-  suma generate_schemas METANORMA_MANIFEST_FILE SCHEMA_MANIFEST_FILE # Generate schemas manifest file from Metanorma manifest YAML file
-  suma extract_terms SCHEMA_MANIFEST_FILE GLOSSARIST_OUTPUT_PATH # Extract terms from schema manifest file
-  suma help [COMMAND]                       # Describe available commands or one specific command
+ Commands:
+  suma build METANORMA_SITE_MANIFEST                                  # Build collection specified in site manifest (`metanorma*.yml`)
+  suma convert-jsdai XML_FILE IMAGE_FILE OUTPUT_DIR                   # Convert JSDAI XML and image files to SVG and EXP files
+  suma extract-terms SCHEMA_MANIFEST_FILE GLOSSARIST_OUTPUT_PATH      # Extract terms from SCHEMA_MANIFEST_FILE into Glossarist v2 format
+  suma generate-schemas METANORMA_MANIFEST_FILE SCHEMA_MANIFEST_FILE  # Generate EXPRESS schema manifest file from Metanorma site manifest
+  suma help [COMMAND]                                                 # Describe available commands or one specific command
+  suma reformat EXPRESS_FILE_PATH                                     # Reformat EXPRESS files
+  suma validate SUBCOMMAND ...ARGS                                    # Validate express documents
 ----
 
 === Build command
@@ -291,13 +292,13 @@ Replacement: AsciiMath: xx
 
 === Generate schemas command
 
-The `suma generate_schemas` command generates an EXPRESS schema manifest file
+The `suma generate-schemas` command generates an EXPRESS schema manifest file
 containing all schemas of documents referenced in the Metanorma manifest file,
 recursively.
 
 [source,sh]
 ----
-$ suma generate_schemas METANORMA_MANIFEST_FILE SCHEMA_MANIFEST_FILE [options]
+$ suma generate-schemas METANORMA_MANIFEST_FILE SCHEMA_MANIFEST_FILE [options]
 ----
 
 Parameters:
@@ -314,14 +315,14 @@ Options:
 .To generate schemas manifest file from Metanorma manifest file
 [source,sh]
 ----
-$ bundle exec suma generate_schemas metanorma-smrl-all.yml schemas-smrl-all.yml
+$ bundle exec suma generate-schemas metanorma-smrl-all.yml schemas-smrl-all.yml
 # => generates schemas-smrl-all.yml
 ----
 
 .To generate schemas manifest file from Metanorma manifest file and exclude schemas with names like `*_lf.exp`
 [source,sh]
 ----
-$ bundle exec suma generate_schemas metanorma-smrl-all.yml schemas-smrl-all.yml -e *_lf.exp
+$ bundle exec suma generate-schemas metanorma-smrl-all.yml schemas-smrl-all.yml -e *_lf.exp
 # => generates schemas-smrl-all.yml without schemas with names like *_lf.exp
 ----
 ====
@@ -336,14 +337,14 @@ The "extract terms" command is implemented for ISO 10303-2, and could also be
 used for other EXPRESS schema collections that require term extraction for
 glossary or dictionary applications.
 
-The `suma extract_terms` command extracts terms from EXPRESS schemas and
+The `suma extract-terms` command extracts terms from EXPRESS schemas and
 generates a Glossarist v2 dataset in the output directory. This command processes
 various types of STEP schemas and creates standardized terminology datasets
 suitable for glossary and dictionary applications.
 
 [source,sh]
 ----
-$ suma extract_terms SCHEMA_MANIFEST_FILE GLOSSARIST_OUTPUT_PATH [options]
+$ suma extract-terms SCHEMA_MANIFEST_FILE GLOSSARIST_OUTPUT_PATH [options]
 ----
 
 Parameters:
@@ -397,7 +398,7 @@ The command generates a Glossarist v2 compliant dataset with:
 ====
 [source,sh]
 ----
-$ bundle exec suma extract_terms schemas-smrl-all.yml glossarist_output
+$ bundle exec suma extract-terms schemas-smrl-all.yml glossarist_output
 # => generates glossarist_output/concept/*.yaml and
 #      glossarist_output/localized_concept/*.yaml
 ----
@@ -408,12 +409,144 @@ $ bundle exec suma extract_terms schemas-smrl-all.yml glossarist_output
 ====
 [source,sh]
 ----
-$ bundle exec suma extract_terms schemas-activity-modules.yml terms_output
+$ bundle exec suma extract-terms schemas-activity-modules.yml terms_output
 # => processes only schemas listed in the manifest file
 ----
 ====
 
 
+=== Convert JSDAI image outputs to SVG and Annotated EXPRESS
+
+The `suma convert-jsdai` command converts JSDAI EXPRESS-G diagram outputs
+(XML + image file) into SVG and Annotated EXPRESS formats suitable for
+Metanorma documentation.
+
+JSDAI (Java Step Data Access Interface) Java tool is used by ISO/TC 184/SC 4 to
+create EXPRESS-G diagrams.
+
+JSDAI generates two files for each diagram:
+
+* a raster image file (GIF or JPEG)
+* an XML file containing image metadata and clickable area definitions
+
+This command converts these inputs into:
+
+* an SVG file that embeds the raster image as Base64 with clickable rectangular areas
+* an Annotated EXPRESS file with a Metanorma `svgmap` block for easy copy-paste
+
+[source,sh]
+----
+$ suma convert-jsdai XML_FILE IMAGE_FILE OUTPUT_DIR
+----
+
+Where:
+
+`XML_FILE`:: Path to the JSDAI XML file (e.g., "action_schemaexpg1.xml")
+
+`IMAGE_FILE`:: Path to the raster image file (GIF or JPEG format)
+
+`OUTPUT_DIR`:: Path to the output directory where SVG and EXP files will be generated
+
+[example]
+.To convert JSDAI outputs for a resource schema diagram
+====
+[source,sh]
+----
+$ bundle exec suma convert-jsdai \
+    documents/resources/action_schema/action_schemaexpg1.xml \
+    documents/resources/action_schema/action_schemaexpg1.gif \
+    output/
+# => generates:
+#    output/action_schemaexpg1.svg
+#    output/action_schemaexpg1.exp
+----
+====
+
+This command:
+
+* Parses the JSDAI XML file to extract image metadata and clickable area definitions
+* Reads the raster image file and converts it to base64 format
+* Generates an SVG file with:
+** The embedded base64-encoded image
+** Clickable rectangular areas (`<a>` and `<rect>` elements) corresponding to the XML definitions
+** Proper viewBox dimensions matching the source image
+* Generates an Annotated EXPRESS file containing:
+** A Metanorma `svgmap` block with numbered cross-references
+** Proper anchor IDs for document integration
+** Cross-reference targets extracted from the XML href attributes
+
+
+The generated SVG and EXP files work together through a numbered mapping system:
+
+. In the SVG file, each clickable area is assigned a sequential number:
++
+[source,xml]
+----
+<a href="1"><rect .../></a>
+<a href="2"><rect .../></a>
+<a href="3"><rect .../></a>
+----
+
+. In the EXPRESS file, the `svgmap` block maps these numbers to targets which
+are either EXPRESS or AsciiDoc anchors.
++
+--
+[example]
+.Resource schema diagram with SVG and Annotated EXPRESS cross-references
+=====
+[source,express]
+----
+(*"action_schema.__expressg"
+[[action_schema_expg1]]
+[.svgmap]
+====
+image::action_schemaexpg1.svg[]
+
+* <<express:basic_attribute_schema>>; 1
+* <<express:action_schema>>; 2
+* <<express:support_resource_schema>>; 3
+====
+*)
+----
+=====
+
+[example]
+.Module schema diagram with SVG and Annotated EXPRESS cross-references
+=====
+[source,express]
+----
+(*"Activity_mim.__expressg"
+[[Activity_mim_expg1]]
+[.svgmap]
+====
+image::mimexpg1.svg[]
+
+* <<Activity_mim_expg2>>; 1
+* <<express:action_schema>>; 2
+* <<Activity_method_mim_expg1>>; 3
+* <<express:basic_attribute_schema>>; 4
+* <<express:management_resources_schema>>; 5
+====
+*)
+----
+=====
+--
+
+. When rendered in Metanorma, clicking on "area 1" in the SVG, will navigate to
+the `express:basic_attribute_schema` anchor, "area 2" to
+`express:action_schema`, and so on.
+
+The mapping is derived from the original JSDAI XML file, where each `<img.area>`
+element contains:
+
+`coords` attribute:: converted to SVG `<rect>` dimensions
+
+`href` attribute:: converted to EXPRESS cross-reference target in the `svgmap`
+block
+
+Sequential position:: assigned as the numbered href in both SVG and `svgmap`
+list
+
 
 == Usage: Ruby
 

data/lib/suma/cli/convert_jsdai.rb

@@ -0,0 +1,65 @@
+# frozen_string_literal: true
+
+require "thor"
+require_relative "../thor_ext"
+require_relative "../jsdai"
+require "fileutils"
+
+module Suma
+  module Cli
+    # ConvertJsdai command to convert JSDAI XML and image to SVG and EXP
+    class ConvertJsdai < Thor
+      desc "convert_jsdai XML_FILE IMAGE_FILE OUTPUT_DIR",
+           "Convert JSDAI XML and image files to SVG and EXP files"
+
+      # rubocop:disable Metrics/MethodLength
+      def convert_jsdai(xml_file, image_file, output_dir)
+        xml_file = File.expand_path(xml_file)
+        image_file = File.expand_path(image_file)
+        output_dir = File.expand_path(output_dir)
+
+        unless File.exist?(xml_file)
+          raise Errno::ENOENT, "XML file not found: #{xml_file}"
+        end
+
+        unless File.exist?(image_file)
+          raise Errno::ENOENT, "Image file not found: #{image_file}"
+        end
+
+        unless File.file?(xml_file)
+          raise ArgumentError, "Specified path is not a file: #{xml_file}"
+        end
+
+        unless File.file?(image_file)
+          raise ArgumentError, "Specified path is not a file: #{image_file}"
+        end
+
+        run(xml_file, image_file, output_dir)
+      end
+      # rubocop:enable Metrics/MethodLength
+
+      private
+
+      # rubocop:disable Metrics/MethodLength
+      def run(xml_file, image_file, output_dir)
+        FileUtils.mkdir_p(output_dir)
+
+        figure = Suma::Jsdai::Figure.new(xml_file, image_file)
+        basename = File.basename(xml_file, ".xml")
+
+        svg_output = File.join(output_dir, "#{basename}.svg")
+        exp_output = File.join(output_dir, "#{basename}.exp")
+
+        puts "Converting JSDAI files..."
+        File.write(svg_output, figure.to_svg)
+        puts "Generated SVG: #{svg_output}"
+
+        File.write(exp_output, figure.to_exp)
+        puts "Generated EXP: #{exp_output}"
+
+        puts "Conversion complete."
+      end
+      # rubocop:enable Metrics/MethodLength
+    end
+  end
+end

data/lib/suma/cli/validate_ascii.rb

@@ -2,9 +2,10 @@
 
 require "thor"
 require "yaml"
-require "terminal-table"
+require "paint"
 require "plurimath"
 require "set" # For using Set in unique_character_count
+require "table_tennis"
 require_relative "../thor_ext"
 
 module Suma
@@ -188,12 +189,18 @@ module Suma
 
         # Print each file's violations
         @file_violations.each_value do |file_violation|
-          puts "\n#{file_violation.display_path}:"
+          puts "\n#{Paint[file_violation.display_path, :cyan, :bold]}:"
 
           file_violation.violations.each do |v|
-            puts "  Line #{v[:line_number]}, Column #{v[:column]}:"
+            puts "  #{Paint['Line',
+                            :blue]} #{Paint[v[:line_number],
+                                            :yellow]}, #{Paint['Column',
+                                                               :blue]} #{Paint[v[:column],
+                                                                               :yellow]}:"
             puts "    #{v[:line]}"
-            puts "    #{' ' * v[:column]}#{'^' * v[:match].length} Non-ASCII sequence"
+            puts "    #{' ' * v[:column]}#{Paint['^' * v[:match].length,
+                                                 :red]} #{Paint['Non-ASCII sequence',
+                                                                :red]}"
 
             v[:char_details].each do |cd|
               character = file_violation.unique_characters.find do |c|
@@ -201,29 +208,42 @@ module Suma
               end
               next unless character
 
-              puts "      \"#{cd[:char]}\" - Hex: #{cd[:hex]}, UTF-8 bytes: #{cd[:utf8]}"
-              puts "      Replacement: #{character.replacement_text}"
+              puts "      #{Paint["\"#{cd[:char]}\"",
+                                  :yellow]} - Hex: #{Paint[cd[:hex],
+                                                           :magenta]}, UTF-8 bytes: #{Paint[cd[:utf8],
+                                                                                            :magenta]}"
+              puts "      #{Paint['Replacement:',
+                                  :green]} #{character.replacement_text}"
             end
             puts ""
           end
 
-          puts "  Found #{file_violation.violation_count} non-ASCII sequence(s) in #{file_violation.filename}\n"
+          puts "  #{Paint['Found',
+                          :green]} #{Paint[file_violation.violation_count,
+                                           :red]} #{Paint['non-ASCII sequence(s) in',
+                                                          :green]} #{Paint[file_violation.filename,
+                                                                           :cyan]}\n"
         end
 
         # Print summary
-        puts "\nSummary:"
-        puts "  Scanned #{@total_files} EXPRESS file(s)"
-        puts "  Found #{total_violations} non-ASCII sequence(s) in #{files_with_violations} file(s)"
+        puts "\n#{Paint['Summary:', :blue, :bold]}"
+        puts "  #{Paint['Scanned',
+                        :green]} #{Paint[@total_files,
+                                         :yellow]} #{Paint['EXPRESS file(s)',
+                                                           :green]}"
+        puts "  #{Paint['Found',
+                        :green]} #{Paint[total_violations,
+                                         :red]} #{Paint['non-ASCII sequence(s) in',
+                                                        :green]} #{Paint[files_with_violations,
+                                                                         :red]} #{Paint['file(s)',
+                                                                                        :green]}"
       end
 
       def print_table_output
         return if @file_violations.empty?
 
-        table = ::Terminal::Table.new(
-          title: "Non-ASCII Characters Summary",
-          headings: ["File", "Symbol", "Replacement", "Occurrences"],
-        )
-
+        # Build rows array
+        rows = []
         total_occurrences = 0
 
         @file_violations.each_value do |file_violation|
@@ -231,25 +251,37 @@ module Suma
             occurrence_count = character.occurrence_count
             total_occurrences += occurrence_count
 
-            table.add_row [
-              file_violation.display_path,
-              "\"#{character.char}\" (#{character.hex})",
-              character.replacement_text,
-              occurrence_count,
-            ]
+            rows << {
+              file: file_violation.display_path,
+              symbol: "\"#{character.char}\" (#{character.hex})",
+              replacement: character.replacement_text,
+              occurrences: occurrence_count,
+            }
           end
         end
 
-        # Add a separator and total row
-        table.add_separator
-        table.add_row [
-          "TOTAL",
-          "#{unique_character_count} unique",
-          "",
-          total_occurrences,
-        ]
+        # Add total row
+        rows << {
+          file: "TOTAL",
+          symbol: "#{unique_character_count} unique",
+          replacement: "",
+          occurrences: total_occurrences,
+        }
+
+        # Use TableTennis to render
+        options = {
+          title: "Non-ASCII Characters Summary",
+          columns: %i[file symbol replacement occurrences],
+          headers: {
+            file: "File",
+            symbol: "Symbol",
+            replacement: "Replacement",
+            occurrences: "Occurrences",
+          },
+          mark: ->(row) { row[:file] == "TOTAL" },
+        }
 
-        puts "\n#{table}\n"
+        puts "\n#{TableTennis.new(rows, options)}\n"
       end
 
       private

data/lib/suma/cli.rb

@@ -23,7 +23,7 @@ module Suma
         Cli::Build.start
       end
 
-      desc "generate_schemas METANORMA_MANIFEST_FILE SCHEMA_MANIFEST_FILE",
+      desc "generate-schemas METANORMA_MANIFEST_FILE SCHEMA_MANIFEST_FILE",
            "Generate EXPRESS schema manifest file from Metanorma site manifest"
       option :exclude_paths, type: :string, default: nil, aliases: "-e",
                              desc: "Exclude schemas paths by pattern " \
@@ -43,7 +43,7 @@ module Suma
         Cli::Reformat.start
       end
 
-      desc "extract_terms SCHEMA_MANIFEST_FILE GLOSSARIST_OUTPUT_PATH",
+      desc "extract-terms SCHEMA_MANIFEST_FILE GLOSSARIST_OUTPUT_PATH",
            "Extract terms from SCHEMA_MANIFEST_FILE into " \
            "Glossarist v2 format"
       option :language_code, type: :string, default: "eng", aliases: "-l",
@@ -53,6 +53,13 @@ module Suma
         Cli::ExtractTerms.start
       end
 
+      desc "convert-jsdai XML_FILE IMAGE_FILE OUTPUT_DIR",
+           "Convert JSDAI XML and image files to SVG and EXP files"
+      def convert_jsdai(_xml_file, _image_file, _output_dir)
+        require_relative "cli/convert_jsdai"
+        Cli::ConvertJsdai.start
+      end
+
       desc "validate SUBCOMMAND ...ARGS", "Validate express documents"
       subcommand "validate", Cli::Validate
 

data/lib/suma/jsdai/figure.rb

@@ -0,0 +1,210 @@
+# frozen_string_literal: true
+
+require_relative "figure_xml"
+require_relative "figure_image"
+
+module Suma
+  module Jsdai
+    # Main class for JSDAI figure conversion
+    class Figure
+      attr_reader :xml, :image
+
+      def initialize(xml_file, image_file)
+        @xml = FigureXml.from_xml(File.read(xml_file))
+        @image = FigureImage.new(image_file)
+        @xml_file = xml_file
+      end
+
+      # rubocop:disable Metrics/MethodLength
+      def to_svg
+        width, height = @image.dimensions
+        svg_parts = []
+
+        svg_parts << '<?xml version="1.0" encoding="UTF-8"?>'
+        svg_parts << '<svg xmlns="http://www.w3.org/2000/svg" '
+        svg_parts << 'xml:space="preserve" '
+        svg_parts << 'style="enable-background:new 0 0 595.28 841.89;" '
+        svg_parts << "height=\"#{height}\" "
+        svg_parts << "width=\"#{width}\" "
+        svg_parts << "viewBox=\"0 0 #{width} #{height}\" "
+        svg_parts << 'y="0px" x="0px" id="Layer_1" version="1.1">'
+        svg_parts << "\n\t\t\t\n\t\t\t"
+
+        # Add embedded image
+        svg_parts << "<image href=\"#{@image.to_base64}\" "
+        svg_parts << "height=\"#{height}\" "
+        svg_parts << "width=\"#{width}\" "
+        svg_parts << 'style="overflow:visible;">'
+        svg_parts << "\n\t\t\t</image>\n\t\t\t"
+
+        # Add clickable areas
+        if @xml.img.areas && !@xml.img.areas.empty?
+          area_parts = @xml.img.areas.each_with_index.map do |area, index|
+            shape_element = generate_shape_element(area)
+            "<a href=\"#{index + 1}\">#{shape_element}</a>"
+          end
+
+          svg_parts << area_parts.join
+        end
+        svg_parts << "\n\t\t</svg>"
+        svg_parts.join
+      end
+      # rubocop:enable Metrics/MethodLength
+
+      # rubocop:disable Metrics/MethodLength
+      def to_exp
+        basename = File.basename(@xml_file, ".xml")
+        schema_name = extract_schema_name(basename)
+        anchor_id = extract_anchor_id(basename)
+
+        exp_parts = []
+        exp_parts << "(*\"#{schema_name}.__expressg\""
+        exp_parts << "\n[[#{anchor_id}]]"
+        exp_parts << "\n[.svgmap]"
+        exp_parts << "\n===="
+        exp_parts << "\nimage::#{basename}.svg[]"
+
+        if @xml.img.areas && !@xml.img.areas.empty?
+          exp_parts << "\n"
+          @xml.img.areas.each_with_index do |area, index|
+            target = extract_target_from_href(area.href)
+            exp_parts << "\n* <<#{target}>>; #{index + 1}"
+          end
+        end
+
+        exp_parts << "\n===="
+        exp_parts << "\n*)\n"
+        exp_parts.join
+      end
+      # rubocop:enable Metrics/MethodLength
+
+      private
+
+      # rubocop:disable Metrics/MethodLength
+      def generate_shape_element(area)
+        shape_attrs = []
+        shape_attrs << 'onmouseout="this.style.opacity=0" '
+        shape_attrs << 'onmouseover="this.style.opacity=1" '
+        shape_attrs << 'style="opacity: 0; fill: rgb(33, 128, 255); '
+        shape_attrs << "fill-opacity: 0.3; stroke: rgb(0, 128, 255); "
+        shape_attrs << "stroke-width: 1px; stroke-linecap: butt; "
+        shape_attrs << 'stroke-linejoin: miter; stroke-opacity: 1;" '
+
+        case area.shape
+        when "rect"
+          coords = parse_rect_coords(area.coords)
+          shape_attrs << "height=\"#{coords[:height]}\" "
+          shape_attrs << "width=\"#{coords[:width]}\" "
+          shape_attrs << "y=\"#{coords[:y]}\" "
+          shape_attrs << "x=\"#{coords[:x]}\"/>"
+          "<rect #{shape_attrs.join}"
+        when "poly", "polygon"
+          shape_attrs << "points=\"#{area.coords}\"/>"
+          "<polygon #{shape_attrs.join}"
+        else
+          # Unsupported shape, default to rectangle
+          coords = parse_rect_coords(area.coords)
+          shape_attrs << "height=\"#{coords[:height]}\" "
+          shape_attrs << "width=\"#{coords[:width]}\" "
+          shape_attrs << "y=\"#{coords[:y]}\" "
+          shape_attrs << "x=\"#{coords[:x]}\"/>"
+          "<rect #{shape_attrs.join}"
+        end
+      end
+      # rubocop:enable Metrics/MethodLength
+
+      def parse_rect_coords(coords_str)
+        parts = coords_str.split(",").map(&:to_i)
+        {
+          x: parts[0],
+          y: parts[1],
+          width: parts[2] - parts[0],
+          height: parts[3] - parts[1],
+        }
+      end
+
+      def parse_coords(coords_str)
+        parse_rect_coords(coords_str)
+      end
+
+      def extract_anchor_id(basename)
+        # For module schemas like "armexpg1" with module="activity"
+        # Result should be "Activity_arm_expg1"
+        # For resource schemas like "action_schemaexpg2"
+        # Result should be "action_schema_expg2"
+
+        if basename =~ /^(arm|mim)expg(\d+)$/
+          # Module schema: use schema_name + _expg + number
+          schema_name = extract_schema_name(basename)
+          "#{schema_name}_expg#{::Regexp.last_match(2)}"
+        else
+          # Resource schema: insert underscore before expg
+          basename.sub("expg", "_expg")
+        end
+      end
+
+      # rubocop:disable Metrics/MethodLength
+      def extract_schema_name(basename)
+        # For module schemas like "armexpg1" with module="activity"
+        # Result should be "Activity_arm"
+        # For resource schemas like "action_schemaexpg2"
+        # Result should be "action_schema"
+
+        if basename =~ /^(arm|mim)expg\d+$/
+          # Module schema: use XML module attribute + arm/mim
+          # Capitalize only the first letter of the module name
+          module_name = @xml.module.split("_").map.with_index do |part, idx|
+            idx.zero? ? part.capitalize : part
+          end.join("_")
+          "#{module_name}_#{::Regexp.last_match(1)}"
+        else
+          # Resource schema: strip expg suffix
+          basename.sub(/expg\d+$/, "")
+        end
+      end
+      # rubocop:enable Metrics/MethodLength
+
+      # rubocop:disable Metrics/MethodLength
+      def extract_target_from_href(href)
+        # Extract the target from href
+        # Type 1: "../../resources/action_schema/action_schema.xml#action_schema.as_name_attribute_select"
+        #   → "express:action_schema.as_name_attribute_select"
+        # Type 2: "../../resources/basic_attribute_schema/basic_attribute_schema.xml"
+        #   → "express:basic_attribute_schema"
+        # Type 3: "../activity_method/armexpg1.xml"
+        #   → "Activity_method_arm_expg1"
+        # Type 4: "../../resources/geometry_schema/geometry_schemaexpg3.xml"
+        #   → "geometry_schema_expg3" (image reference in same resource)
+
+        case href
+        when /#(.+)$/
+          # Has fragment - use it as entity reference
+          "express:#{::Regexp.last_match(1)}"
+        when %r{^\.\./([\w_]+)/(arm|mim)expg(\d+)\.xml$}
+          # Module image reference like "../activity_method/armexpg1.xml"
+          module_dir = ::Regexp.last_match(1)
+          schema_type = ::Regexp.last_match(2)
+          expg_num = ::Regexp.last_match(3)
+          # Capitalize only the first letter of the module name
+          module_name = module_dir.split("_").map.with_index do |part, idx|
+            idx.zero? ? part.capitalize : part
+          end.join("_")
+          "#{module_name}_#{schema_type}_expg#{expg_num}"
+        when %r{/([^/]+)expg(\d+)\.xml$}
+          # Image reference to another diagram in same or different resource
+          # e.g., "../../resources/geometry_schema/geometry_schemaexpg3.xml"
+          # Result: "geometry_schema_expg3" (no "express:" prefix for images)
+          schema_name = ::Regexp.last_match(1)
+          expg_num = ::Regexp.last_match(2)
+          "#{schema_name}_expg#{expg_num}"
+        when %r{/([^/]+)\.xml$}
+          # Resource schema reference (no expg)
+          "express:#{::Regexp.last_match(1)}"
+        else
+          href
+        end
+      end
+      # rubocop:enable Metrics/MethodLength
+    end
+  end
+end

data/lib/suma/jsdai/figure_image.rb

@@ -0,0 +1,96 @@
+# frozen_string_literal: true
+
+require "base64"
+
+module Suma
+  module Jsdai
+    # Represents a JSDAI figure image file
+    class FigureImage
+      attr_reader :path, :width, :height
+
+      def initialize(image_file)
+        @path = image_file
+        @base64_data = nil
+        @width = nil
+        @height = nil
+        @image_type = extract_image_type
+      end
+
+      def to_base64
+        @to_base64 ||= begin
+          image_data = File.binread(@path)
+          "data:image/#{@image_type};base64,#{Base64.strict_encode64(image_data)}"
+        end
+      end
+
+      def dimensions
+        extract_dimensions unless @width && @height
+        [@width, @height]
+      end
+
+      private
+
+      def extract_image_type
+        File.extname(@path).delete(".").downcase
+      end
+
+      def extract_dimensions
+        case @image_type
+        when "gif"
+          extract_gif_dimensions
+        when "jpg", "jpeg"
+          extract_jpeg_dimensions
+        else
+          raise "Unsupported image type: #{@image_type}"
+        end
+      end
+
+      def extract_gif_dimensions
+        # Read GIF header to extract dimensions
+        # GIF87a and GIF89a format: width at bytes 6-7, height at bytes 8-9
+        File.open(@path, "rb") do |file|
+          file.read(6) # Skip "GIF87a" or "GIF89a"
+          width_bytes = file.read(2)
+          height_bytes = file.read(2)
+
+          @width = width_bytes.unpack1("S<") # Little-endian short
+          @height = height_bytes.unpack1("S<")
+        end
+      end
+
+      # rubocop:disable Metrics/MethodLength
+      def extract_jpeg_dimensions
+        # Read JPEG file to extract dimensions
+        # JPEG uses markers, we look for SOF (Start of Frame) markers
+        File.open(@path, "rb") do |file|
+          # Check for JPEG magic number
+          return unless file.read(2) == "\xFF\xD8".b
+
+          loop do
+            marker = file.read(2)
+            break unless marker
+
+            # SOF markers: 0xFFC0-0xFFC3, 0xFFC5-0xFFC7, 0xFFC9-0xFFCB, 0xFFCD-0xFFCF
+            if marker[0] == "\xFF".b &&
+                marker[1].ord.between?(0xC0, 0xCF) &&
+                marker[1].ord != 0xC4 && marker[1].ord != 0xC8 && marker[1].ord != 0xCC
+              file.read(3) # Skip length (2 bytes) and precision (1 byte)
+              height_bytes = file.read(2)
+              width_bytes = file.read(2)
+              @height = height_bytes.unpack1("n") # Big-endian short
+              @width = width_bytes.unpack1("n")
+              break
+            end
+
+            # Skip this marker's data
+            length = file.read(2)&.unpack1("n")
+            break unless length
+
+            file.seek(length - 2, IO::SEEK_CUR)
+          end
+        end
+      end
+      # rubocop:enable Metrics/MethodLength
+    end
+  end
+end

data/lib/suma/jsdai/figure_xml.rb

@@ -0,0 +1,47 @@
+# frozen_string_literal: true
+
+require "lutaml/model"
+
+module Suma
+  module Jsdai
+    # Represents an image area with coordinates and href
+    class FigureXmlImageArea < Lutaml::Model::Serializable
+      attribute :shape, :string
+      attribute :coords, :string
+      attribute :href, :string
+
+      xml do
+        root "img.area"
+        map_attribute "shape", to: :shape
+        map_attribute "coords", to: :coords
+        map_attribute "href", to: :href
+      end
+    end
+
+    # Represents the img element with source and areas
+    class FigureXmlImage < Lutaml::Model::Serializable
+      attribute :src, :string
+      attribute :areas, FigureXmlImageArea, collection: true
+
+      xml do
+        root "img"
+        map_attribute "src", to: :src
+        map_element "img.area", to: :areas
+      end
+    end
+
+    # Represents the root imgfile.content element
+    class FigureXml < Lutaml::Model::Serializable
+      attribute :module, :string
+      attribute :file, :string
+      attribute :img, FigureXmlImage
+
+      xml do
+        root "imgfile.content"
+        map_attribute "module", to: :module
+        map_attribute "file", to: :file
+        map_element "img", to: :img
+      end
+    end
+  end
+end

data/lib/suma/jsdai.rb

@@ -0,0 +1,12 @@
+module Suma
+  module Jsdai
+  end
+end
+
+require_relative "jsdai/figure"
+
+# Configure XML adapter to Nokogiri because Ox goes into a "stack level too
+# deep" error, for unknown reasons
+Lutaml::Model::Config.configure do |config|
+  config.xml_adapter_type = :nokogiri
+end

data/lib/suma/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Suma
-  VERSION = "0.1.20"
+  VERSION = "0.1.22"
 end

data/lib/suma.rb

@@ -1,6 +1,8 @@
 # frozen_string_literal: true
 
 require "expressir"
+require "lutaml/model"
+
 require_relative "suma/version"
 require_relative "suma/processor"
 

data/suma.gemspec

@@ -39,7 +39,7 @@ Gem::Specification.new do |spec| # rubocop:disable Metrics/BlockLength
   spec.add_dependency "metanorma-cli"
   spec.add_dependency "plurimath"
   spec.add_dependency "ruby-progressbar"
-  spec.add_dependency "terminal-table", "~> 3.0"
+  spec.add_dependency "table_tennis"
   spec.add_dependency "thor", ">= 0.20"
   spec.metadata["rubygems_mfa_required"] = "true"
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: suma
 version: !ruby/object:Gem::Version
-  version: 0.1.20
+  version: 0.1.22
 platform: ruby
 authors:
 - Ribose Inc.
 autorequire:
 bindir: exe
 cert_chain: []
-date: 2025-07-18 00:00:00.000000000 Z
+date: 2025-10-05 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: expressir
@@ -95,19 +95,19 @@ dependencies:
       - !ruby/object:Gem::Version
         version: '0'
 - !ruby/object:Gem::Dependency
-  name: terminal-table
+  name: table_tennis
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - "~>"
+    - - ">="
       - !ruby/object:Gem::Version
-        version: '3.0'
+        version: '0'
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - "~>"
+    - - ">="
       - !ruby/object:Gem::Version
-        version: '3.0'
+        version: '0'
 - !ruby/object:Gem::Dependency
   name: thor
   requirement: !ruby/object:Gem::Requirement
@@ -148,6 +148,7 @@ files:
 - lib/suma.rb
 - lib/suma/cli.rb
 - lib/suma/cli/build.rb
+- lib/suma/cli/convert_jsdai.rb
 - lib/suma/cli/extract_terms.rb
 - lib/suma/cli/generate_schemas.rb
 - lib/suma/cli/reformat.rb
@@ -157,6 +158,10 @@ files:
 - lib/suma/collection_config.rb
 - lib/suma/collection_manifest.rb
 - lib/suma/express_schema.rb
+- lib/suma/jsdai.rb
+- lib/suma/jsdai/figure.rb
+- lib/suma/jsdai/figure_image.rb
+- lib/suma/jsdai/figure_xml.rb
 - lib/suma/processor.rb
 - lib/suma/schema_attachment.rb
 - lib/suma/schema_collection.rb