postsvg 0.1.0 → 0.3.0

data/lib/postsvg.rb

@@ -1,78 +1,112 @@
 # frozen_string_literal: true
 
-require_relative "postsvg/version"
-require_relative "postsvg/errors"
-require_relative "postsvg/tokenizer"
-require_relative "postsvg/interpreter"
+require "parslet"
+require "thor"
+require "nokogiri"
 
 module Postsvg
-  class << self
-    # Convert PostScript content to SVG
-    def convert(ps_content)
-      bbox = extract_bounding_box(ps_content)
-      tokens = Tokenizer.tokenize(ps_content)
+  autoload :VERSION, "postsvg/version"
 
-      interpreter = Interpreter.new
-      svg_out = interpreter.interpret(tokens, bbox)
+  # Errors
+  autoload :Error, "postsvg/errors"
+  autoload :ParseError, "postsvg/errors"
+  autoload :LexError, "postsvg/errors"
+  autoload :SyntaxError, "postsvg/errors"
+  autoload :RenderError, "postsvg/errors"
+  autoload :StackUnderflowError, "postsvg/errors"
+  autoload :UndefinedOperatorError, "postsvg/errors"
+  autoload :RecursionLimitError, "postsvg/errors"
+  autoload :SizeLimitError, "postsvg/errors"
+  autoload :TranslationError, "postsvg/errors"
+  autoload :UnsupportedElementError, "postsvg/errors"
+  autoload :UnresolvedReferenceError, "postsvg/errors"
+  autoload :SerializeError, "postsvg/errors"
+  autoload :ConversionError, "postsvg/errors"
+  autoload :UnsupportedOperatorError, "postsvg/errors"
+  autoload :ExitSignal, "postsvg/errors"
+  autoload :QuitSignal, "postsvg/errors"
 
-      generate_svg(svg_out, bbox)
-    end
+  # Foundational value types
+  autoload :FormatNumber, "postsvg/format_number"
+  autoload :Matrix, "postsvg/matrix"
+  autoload :Color, "postsvg/color"
 
-    # Convert PostScript file to SVG
-    def convert_file(input_path, output_path = nil)
-      ps_content = File.read(input_path)
-      svg_content = convert(ps_content)
+  # Source-reading layer (PS source -> Model::Program)
+  autoload :Source, "postsvg/source"
 
-      File.write(output_path, svg_content) if output_path
+  # PS domain model
+  autoload :Model, "postsvg/model"
 
-      svg_content
-    end
+  # Graphics state
+  autoload :GraphicsContext, "postsvg/graphics_context"
+  autoload :GraphicsStack, "postsvg/graphics_stack"
+  autoload :PathBuilder, "postsvg/path_builder"
+
+  # SVG emission (forward direction)
+  autoload :SvgBuilder, "postsvg/svg_builder"
+
+  # Forward direction (PS -> SVG)
+  autoload :Options, "postsvg/options"
+  autoload :Renderer, "postsvg/renderer"
+  autoload :Visitors, "postsvg/visitors"
+
+  # SVG domain model (reverse direction input)
+  autoload :Svg, "postsvg/svg"
+
+  # Reverse direction (SVG -> PS)
+  autoload :Translation, "postsvg/translation"
+  autoload :Serializer, "postsvg/serializer"
 
-    private
+  # CLI
+  autoload :CLI, "postsvg/cli"
 
-    def extract_bounding_box(ps_content)
-      match = ps_content.match(/%%BoundingBox:\s*([-+0-9.eE]+)\s+([-+0-9.eE]+)\s+([-+0-9.eE]+)\s+([-+0-9.eE]+)/)
-      return nil unless match
+  # Legacy implementations retained on disk for reference. Not on the
+  # public autoload path; require explicitly if needed:
+  #   require "postsvg/tokenizer"
+  #   require "postsvg/interpreter"
+  #   require "postsvg/parser"
+  #   require "postsvg/converter"
+  #   require "postsvg/svg_generator"
+  #   require "postsvg/graphics_state"
+  #   require "postsvg/colors"
 
-      {
-        llx: match[1].to_f,
-        lly: match[2].to_f,
-        urx: match[3].to_f,
-        ury: match[4].to_f,
-      }
+  class << self
+    # PS/EPS source -> SVG string.
+    def to_svg(source, **options)
+      program = Source.parse(source)
+      Renderer.call(program, Options.new(**options))
+    end
+
+    # PS/EPS file -> SVG string. Writes to +output_path+ if given;
+    # returns the SVG string either way.
+    def to_svg_file(input_path, output_path = nil, **options)
+      svg = to_svg(File.read(input_path), **options)
+      File.write(output_path, svg) if output_path
+      svg
     end
 
-    def generate_svg(svg_out, bbox)
-      if bbox
-        width = bbox[:urx] - bbox[:llx]
-        height = bbox[:ury] - bbox[:lly]
-        view_box = "viewBox=\"#{num_fmt(bbox[:llx])} #{num_fmt(bbox[:lly])} #{num_fmt(width)} #{num_fmt(height)}\" " \
-                   "width=\"#{num_fmt(width)}\" height=\"#{num_fmt(height)}\""
-      else
-        width = 1920
-        height = 1080
-        view_box = "viewBox=\"0 0 #{width} #{height}\" width=\"#{width}\" height=\"#{height}\""
-      end
-
-      defs = svg_out[:defs].empty? ? "" : "<defs>\n#{svg_out[:defs].join("\n")}\n</defs>"
-      shapes = svg_out[:element_shapes].join("\n")
-      texts = svg_out[:element_texts].join("\n")
-      body = "<g transform=\"translate(0 #{height}) scale(1 -1)\">\n#{shapes}\n#{texts}</g>"
-
-      "<?xml version=\"1.0\" encoding=\"UTF-8\"?>\n" \
-        "<svg xmlns=\"http://www.w3.org/2000/svg\" #{view_box}>\n" \
-        "#{defs}\n" \
-        "#{body}\n" \
-        "</svg>"
+    # SVG string -> PS source. Pass +eps: true+ for EPS output.
+    def to_ps(svg_string, eps: false, **options)
+      document = Svg::Parser.call(svg_string)
+      program = Translation::PsRenderer.call(document, eps: eps)
+      Serializer.call(program, eps: eps, **options)
     end
 
-    def num_fmt(n)
-      # Format number, removing unnecessary decimals
-      if n == n.to_i
-        n.to_i.to_s
-      else
-        format("%.3f", n).sub(/\.?0+$/, "")
-      end
+    # SVG string -> EPS source.
+    def to_eps(svg_string, **options)
+      to_ps(svg_string, eps: true, **options)
     end
+
+    # SVG file -> PS source. Writes to +output_path+ if given.
+    def to_ps_file(input_path, output_path = nil, eps: false, **options)
+      ps = to_ps(File.read(input_path), eps: eps, **options)
+      File.write(output_path, ps) if output_path
+      ps
+    end
+
+    # Backwards-compatible aliases. Pre-0.2 the only direction was
+    # PS -> SVG; existing callers used +convert+ / +convert_file+.
+    alias convert to_svg
+    alias convert_file to_svg_file
   end
 end

data/lychee.toml

@@ -0,0 +1,86 @@
+# Lychee link checker configuration for Postsvg documentation
+# https://lychee.cli.rs/
+#
+# This configuration is optimized for checking internal documentation links.
+# External URLs are excluded by default to avoid false positives from
+# anti-bot measures and rate limiting.
+
+# Base configuration
+max_redirects = 10
+max_retries = 3
+timeout = 20
+
+# Check files matching these patterns
+include = [
+    "docs/**/*.adoc",
+    "README.adoc"
+]
+
+# Exclude certain patterns from checking (regex patterns)
+exclude = [
+    # Exclude generated/temporary files
+    "docs/docs/.*",
+    ".*/node_modules/.*",
+    ".*/.git/.*"
+]
+
+# Exclude certain link patterns
+exclude_link_local = false
+exclude_all_private = false
+exclude_mail = false
+
+# Accept status codes as valid
+accept = [
+    200, 201, 202, 203, 204, 205, 206,  # 2xx success
+    300, 301, 302, 303, 307, 308,  # 3xx redirects
+    429  # Rate limit - acceptable for external links
+]
+
+# Include fragments in link validation (e.g., #section-name)
+include_fragments = true
+
+# Follow HTTP redirects
+follow_redirects = true
+
+# Check for broken fragments (anchor links)
+check_fragments = true
+
+# Retry broken links before reporting
+retry_broken = true
+
+# Cache successful link checks to speed up repeated runs
+cache = true
+
+# User agent string for HTTP requests
+user_agent = "lychee/postsvg-docs"
+
+# HTTP method for checking links
+method = "get"
+
+# Headers to send with requests
+headers = [
+    "accept=text/html,application/xhtml+xml,application/xml;q=0.9,*/*;q=0.8"
+]
+
+# Base URL for relative links (when checking outside of workspace context)
+# base = "https://metanorma.github.io/postsvg/"
+
+# Skip checking SSL certificates (not recommended for production)
+insecure = false
+
+# Maximum number of concurrent network requests
+max_concurrency = 8
+
+# Remap URLs (useful for local development or changed URLs)
+# remap = ["https://old-url.com https://new-url.com"]
+
+# Custom glob patterns for AsciiDoc links
+# AsciiDoc uses link:path[text] syntax
+# Lychee should automatically detect these, but we ensure all .adoc files are checked
+
+# Output format (compact, detailed, json, markdown)
+# This can be overridden via CLI
+format = "detailed"
+
+# Exclude specific domains that may have anti-bot measures
+# exclude_path can be used for this purpose if needed

metadata

@@ -1,15 +1,29 @@
 --- !ruby/object:Gem::Specification
 name: postsvg
 version: !ruby/object:Gem::Version
-  version: 0.1.0
+  version: 0.3.0
 platform: ruby
 authors:
 - Ribose Inc.
 autorequire:
 bindir: exe
 cert_chain: []
-date: 2025-10-19 00:00:00.000000000 Z
+date: 2026-07-27 00:00:00.000000000 Z
 dependencies:
+- !ruby/object:Gem::Dependency
+  name: nokogiri
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
 - !ruby/object:Gem::Dependency
   name: parslet
   requirement: !ruby/object:Gem::Requirement
@@ -39,9 +53,10 @@ dependencies:
       - !ruby/object:Gem::Version
         version: '0'
 description: |
-  Postsvg provides a pure Ruby library for converting PostScript (PS) and
-  Encapsulated PostScript (EPS) files to clean,
-  standards-compliant Scalable Vector Graphics (SVG) format output.
+  Postsvg is a pure-Ruby transformer between PostScript (PS) /
+  Encapsulated PostScript (EPS) and Scalable Vector Graphics (SVG).
+  Both directions are implemented: PS/EPS -> SVG and SVG -> PS/EPS.
+  No external tools (Ghostscript, Inkscape) are required.
 email:
 - open.source@ribose.com
 executables:
@@ -51,11 +66,92 @@ extra_rdoc_files: []
 files:
 - ".rubocop.yml"
 - ".rubocop_todo.yml"
+- CHANGELOG.md
+- CLAUDE.md
 - Gemfile
 - LICENSE
 - README.adoc
 - Rakefile
+- TODO.roadmap/00-architecture.md
+- TODO.roadmap/01-autoload-migration.md
+- TODO.roadmap/02-isolate-dormant-code.md
+- TODO.roadmap/03-domain-model.md
+- TODO.roadmap/04-lexer.md
+- TODO.roadmap/05-parser.md
+- TODO.roadmap/06-graphics-state.md
+- TODO.roadmap/07-matrix-and-color.md
+- TODO.roadmap/08-svg-builder.md
+- TODO.roadmap/09-renderer.md
+- TODO.roadmap/10-visitor.md
+- TODO.roadmap/11-operator-coverage.md
+- TODO.roadmap/12-svg-domain.md
+- TODO.roadmap/13-translation-handlers.md
+- TODO.roadmap/14-ps-serializer.md
+- TODO.roadmap/15-cli-and-public-api.md
+- TODO.roadmap/16-specs.md
+- TODO.roadmap/17-docs-sync.md
+- TODO.roadmap/18-performance-and-determinism.md
+- TODO.roadmap/19-error-model.md
+- TODO.roadmap/20-font-and-text.md
+- TODO.roadmap/21-images.md
+- TODO.roadmap/22-forms-and-resources.md
+- TODO.roadmap/23-level2-level3.md
+- TODO.roadmap/24-ci-and-release.md
+- TODO.roadmap/README.md
+- docs/.gitignore
+- docs/CHANGELOG.md
+- docs/COMPLETE_DOCUMENTATION_STATUS.md
+- docs/DEPLOYMENT.md
+- docs/DEPLOYMENT_INSTRUCTIONS.md
+- docs/DOCUMENTATION_PLAN.md
+- docs/FINAL_SUMMARY.md
+- docs/Gemfile
 - docs/POSTSCRIPT.adoc
+- docs/README.md
+- docs/_config.yml
+- docs/advanced-topics.adoc
+- docs/api-reference.adoc
+- docs/api-reference/colors.adoc
+- docs/api-reference/converter.adoc
+- docs/api-reference/execution-context.adoc
+- docs/api-reference/graphics-state.adoc
+- docs/api-reference/interpreter.adoc
+- docs/api-reference/matrix.adoc
+- docs/api-reference/path-builder.adoc
+- docs/api-reference/postsvg-module.adoc
+- docs/api-reference/svg-generator.adoc
+- docs/api-reference/tokenizer.adoc
+- docs/architecture.adoc
+- docs/architecture/command-registry.adoc
+- docs/architecture/conversion-pipeline.adoc
+- docs/architecture/design-decisions.adoc
+- docs/architecture/generator-stage.adoc
+- docs/architecture/graphics-state-model.adoc
+- docs/architecture/interpreter-stage.adoc
+- docs/architecture/parser-stage.adoc
+- docs/cli-reference.adoc
+- docs/cli-reference/batch-command.adoc
+- docs/cli-reference/check-command.adoc
+- docs/cli-reference/cli-options.adoc
+- docs/cli-reference/convert-command.adoc
+- docs/cli-reference/version-command.adoc
+- docs/concepts.adoc
+- docs/concepts/conversion-pipeline.adoc
+- docs/concepts/coordinate-systems.adoc
+- docs/concepts/graphics-state.adoc
+- docs/concepts/path-operations.adoc
+- docs/concepts/postscript-language.adoc
+- docs/concepts/svg-generation.adoc
+- docs/contributing.adoc
+- docs/development.adoc
+- docs/faq.adoc
+- docs/getting-started.adoc
+- docs/getting-started/basic-usage.adoc
+- docs/getting-started/common-workflows.adoc
+- docs/getting-started/first-conversion.adoc
+- docs/getting-started/installation.adoc
+- docs/index.adoc
+- docs/optimization.adoc
 - docs/postscript/fundamentals.adoc
 - docs/postscript/graphics-model.adoc
 - docs/postscript/implementation-notes.adoc
@@ -70,31 +166,140 @@ files:
 - docs/postscript/operators/stack-manipulation.adoc
 - docs/postscript/operators/transformations.adoc
 - docs/postscript/svg-mapping.adoc
+- docs/ps2svg_compatibility.adoc
+- docs/quick-reference.adoc
+- docs/sitemap.adoc
+- docs/troubleshooting.adoc
+- docs/validation.adoc
 - exe/postsvg
 - lib/postsvg.rb
 - lib/postsvg/cli.rb
+- lib/postsvg/color.rb
 - lib/postsvg/colors.rb
 - lib/postsvg/converter.rb
 - lib/postsvg/errors.rb
+- lib/postsvg/format_number.rb
+- lib/postsvg/graphics_context.rb
+- lib/postsvg/graphics_stack.rb
 - lib/postsvg/graphics_state.rb
 - lib/postsvg/interpreter.rb
 - lib/postsvg/matrix.rb
+- lib/postsvg/model.rb
+- lib/postsvg/model/literals.rb
+- lib/postsvg/model/literals/array.rb
+- lib/postsvg/model/literals/dictionary.rb
+- lib/postsvg/model/literals/hex.rb
+- lib/postsvg/model/literals/name.rb
+- lib/postsvg/model/literals/number.rb
+- lib/postsvg/model/literals/procedure.rb
+- lib/postsvg/model/literals/string.rb
+- lib/postsvg/model/operator.rb
+- lib/postsvg/model/operators.rb
+- lib/postsvg/model/operators/arithmetic.rb
+- lib/postsvg/model/operators/boolean.rb
+- lib/postsvg/model/operators/color.rb
+- lib/postsvg/model/operators/container.rb
+- lib/postsvg/model/operators/control_flow.rb
+- lib/postsvg/model/operators/device.rb
+- lib/postsvg/model/operators/dictionary.rb
+- lib/postsvg/model/operators/font.rb
+- lib/postsvg/model/operators/graphics_state.rb
+- lib/postsvg/model/operators/painting.rb
+- lib/postsvg/model/operators/path.rb
+- lib/postsvg/model/operators/stack.rb
+- lib/postsvg/model/operators/transformations.rb
+- lib/postsvg/model/program.rb
+- lib/postsvg/model/token.rb
+- lib/postsvg/options.rb
 - lib/postsvg/parser.rb
 - lib/postsvg/parser/postscript_parser.rb
 - lib/postsvg/parser/transform.rb
 - lib/postsvg/path_builder.rb
+- lib/postsvg/renderer.rb
+- lib/postsvg/serializer.rb
+- lib/postsvg/source.rb
+- lib/postsvg/source/ast_builder.rb
+- lib/postsvg/source/lexer.rb
+- lib/postsvg/source/operand_stack.rb
+- lib/postsvg/svg.rb
+- lib/postsvg/svg/attribute_parser.rb
+- lib/postsvg/svg/clip_path_registry.rb
+- lib/postsvg/svg/document.rb
+- lib/postsvg/svg/element.rb
+- lib/postsvg/svg/elements.rb
+- lib/postsvg/svg/elements/circle.rb
+- lib/postsvg/svg/elements/clip_path.rb
+- lib/postsvg/svg/elements/defs.rb
+- lib/postsvg/svg/elements/ellipse.rb
+- lib/postsvg/svg/elements/group.rb
+- lib/postsvg/svg/elements/image.rb
+- lib/postsvg/svg/elements/line.rb
+- lib/postsvg/svg/elements/path.rb
+- lib/postsvg/svg/elements/polygon.rb
+- lib/postsvg/svg/elements/polyline.rb
+- lib/postsvg/svg/elements/rect.rb
+- lib/postsvg/svg/elements/svg.rb
+- lib/postsvg/svg/elements/text.rb
+- lib/postsvg/svg/paint.rb
+- lib/postsvg/svg/parser.rb
+- lib/postsvg/svg/path_data.rb
+- lib/postsvg/svg/path_data/command.rb
+- lib/postsvg/svg/path_data/parser.rb
+- lib/postsvg/svg/stroke.rb
+- lib/postsvg/svg/transform_list.rb
+- lib/postsvg/svg_builder.rb
 - lib/postsvg/svg_generator.rb
 - lib/postsvg/tokenizer.rb
+- lib/postsvg/translation.rb
+- lib/postsvg/translation/arc_converter.rb
+- lib/postsvg/translation/bounding_box.rb
+- lib/postsvg/translation/context.rb
+- lib/postsvg/translation/handler_registry.rb
+- lib/postsvg/translation/handlers.rb
+- lib/postsvg/translation/handlers/circle_handler.rb
+- lib/postsvg/translation/handlers/clip_path_handler.rb
+- lib/postsvg/translation/handlers/defs_handler.rb
+- lib/postsvg/translation/handlers/ellipse_handler.rb
+- lib/postsvg/translation/handlers/group_handler.rb
+- lib/postsvg/translation/handlers/image_handler.rb
+- lib/postsvg/translation/handlers/line_handler.rb
+- lib/postsvg/translation/handlers/open_handler.rb
+- lib/postsvg/translation/handlers/path_handler.rb
+- lib/postsvg/translation/handlers/polygon_handler.rb
+- lib/postsvg/translation/handlers/polyline_handler.rb
+- lib/postsvg/translation/handlers/rect_handler.rb
+- lib/postsvg/translation/handlers/shared.rb
+- lib/postsvg/translation/handlers/svg_handler.rb
+- lib/postsvg/translation/handlers/text_handler.rb
+- lib/postsvg/translation/ps_renderer.rb
+- lib/postsvg/translation/record_emitter.rb
 - lib/postsvg/version.rb
-- postsvg.gemspec
+- lib/postsvg/visitors.rb
+- lib/postsvg/visitors/ps_visitor.rb
+- lib/postsvg/visitors/ps_visitor/arithmetic.rb
+- lib/postsvg/visitors/ps_visitor/boolean.rb
+- lib/postsvg/visitors/ps_visitor/color.rb
+- lib/postsvg/visitors/ps_visitor/common.rb
+- lib/postsvg/visitors/ps_visitor/container.rb
+- lib/postsvg/visitors/ps_visitor/control_flow.rb
+- lib/postsvg/visitors/ps_visitor/device.rb
+- lib/postsvg/visitors/ps_visitor/dictionary.rb
+- lib/postsvg/visitors/ps_visitor/font.rb
+- lib/postsvg/visitors/ps_visitor/graphics_state.rb
+- lib/postsvg/visitors/ps_visitor/painting.rb
+- lib/postsvg/visitors/ps_visitor/path.rb
+- lib/postsvg/visitors/ps_visitor/stack.rb
+- lib/postsvg/visitors/ps_visitor/transformations.rb
+- lychee.toml
 - scripts/regenerate_fixtures.rb
-homepage: https://github.com/metanorma/postsvg
+homepage: https://github.com/claricle/postsvg
 licenses:
 - BSD-2-Clause
 metadata:
-  homepage_uri: https://github.com/metanorma/postsvg
-  source_code_uri: https://github.com/metanorma/postsvg
-  changelog_uri: https://github.com/metanorma/postsvg
+  homepage_uri: https://github.com/claricle/postsvg
+  source_code_uri: https://github.com/claricle/postsvg
+  changelog_uri: https://github.com/claricle/postsvg/blob/main/CHANGELOG.md
+  bug_tracker_uri: https://github.com/claricle/postsvg/issues
   rubygems_mfa_required: 'true'
 post_install_message:
 rdoc_options: []
@@ -114,5 +319,5 @@ requirements: []
 rubygems_version: 3.5.22
 signing_key:
 specification_version: 4
-summary: Pure Ruby PostScript/EPS to SVG converter
+summary: Pure Ruby bidirectional PS/EPS <-> SVG converter
 test_files: []

data/postsvg.gemspec

@@ -1,38 +0,0 @@
-# frozen_string_literal: true
-
-require_relative "lib/postsvg/version"
-
-Gem::Specification.new do |spec|
-  spec.name = "postsvg"
-  spec.version = Postsvg::VERSION
-  spec.authors = ["Ribose Inc."]
-  spec.email = ["open.source@ribose.com"]
-
-  spec.summary = "Pure Ruby PostScript/EPS to SVG converter"
-  spec.description = <<~HEREDOC
-    Postsvg provides a pure Ruby library for converting PostScript (PS) and
-    Encapsulated PostScript (EPS) files to clean,
-    standards-compliant Scalable Vector Graphics (SVG) format output.
-  HEREDOC
-
-  spec.homepage = "https://github.com/metanorma/postsvg"
-  spec.license = "BSD-2-Clause"
-  spec.required_ruby_version = ">= 3.0.0"
-
-  spec.metadata["homepage_uri"] = spec.homepage
-  spec.metadata["source_code_uri"] = "https://github.com/metanorma/postsvg"
-  spec.metadata["changelog_uri"] = "https://github.com/metanorma/postsvg"
-  spec.metadata["rubygems_mfa_required"] = "true"
-
-  spec.files = Dir.chdir(__dir__) do
-    `git ls-files -z`.split("\x0").reject do |f|
-      (f == __FILE__) || f.match(%r{\A(?:(?:bin|test|spec|features)/|\.(?:git|travis|circleci)|appveyor)})
-    end
-  end
-  spec.bindir = "exe"
-  spec.executables = spec.files.grep(%r{\Aexe/}) { |f| File.basename(f) }
-  spec.require_paths = ["lib"]
-
-  spec.add_dependency "parslet"
-  spec.add_dependency "thor"
-end