fontisan 0.2.16 → 0.2.22

data/lib/fontisan/ucd/version_resolver.rb

@@ -0,0 +1,79 @@
+# frozen_string_literal: true
+
+require "net/http"
+require "uri"
+require "rubygems"
+
+module Fontisan
+  module Ucd
+    # Resolves a user-supplied version intent to a concrete version string.
+    #
+    # Three input modes:
+    #
+    #   resolve(nil)           # default_version from config
+    #   resolve(:default)      # default_version from config
+    #   resolve("17.0.0")      # explicit; validated against known_versions
+    #   resolve(:latest)       # probes listing_url, picks highest; falls
+    #                          # back to default on failure
+    #
+    module VersionResolver
+      class << self
+        # @param intent [nil, :default, :latest, String]
+        # @return [String] a concrete version string
+        def resolve(intent)
+          case intent
+          when nil, :default
+            Config.default_version
+          when :latest
+            probe_latest
+          else
+            validate!(intent)
+            intent
+          end
+        end
+
+        # Raise UnknownVersionError unless `version` is in known_versions.
+        # @param version [String]
+        # @return [void]
+        def validate!(version)
+          return if Config.known?(version)
+
+          raise UnknownVersionError,
+                "UCD version #{version.inspect} is not recognized. " \
+                "Known versions: #{Config.known_versions.join(', ')}"
+        end
+
+        private
+
+        # Best-effort scrape of the unicode.org ucdxml directory listing.
+        # Returns the highest semver found, or Config.default_version on
+        # any failure.
+        def probe_latest
+          versions = fetch_directory_versions
+          return fallback_latest("directory listing was empty") if versions.empty?
+
+          highest = versions.max_by { |v| Gem::Version.new(v) }
+          if Config.known?(highest)
+            highest
+          else
+            fallback_latest("#{highest.inspect} is not in known_versions; using default")
+          end
+        rescue StandardError => e
+          fallback_latest(e.message)
+        end
+
+        def fallback_latest(reason)
+          warn "Ucd::VersionResolver: --latest probe failed (#{reason}); " \
+               "falling back to default #{Config.default_version.inspect}"
+          Config.default_version
+        end
+
+        def fetch_directory_versions
+          uri = URI(Config.listing_url)
+          html = Net::HTTP.get(uri)
+          html.scan(%r{href="(\d+\.\d+\.\d+)/?"}i).flatten.uniq
+        end
+      end
+    end
+  end
+end

data/lib/fontisan/ucd.rb

@@ -0,0 +1,23 @@
+# frozen_string_literal: true
+
+# Namespace file for UCD (Unicode Character Database) support.
+#
+# All Ucd::* constants are autoloaded from here. Top-level callers
+# (`lib/fontisan.rb`) require this file; downstream files reference
+# constants like Ucd::CacheManager and let autoload do the work.
+
+module Fontisan
+  module Ucd
+    autoload :Config,              "fontisan/ucd/config"
+    autoload :CacheManager,        "fontisan/ucd/cache_manager"
+    autoload :Downloader,          "fontisan/ucd/downloader"
+    autoload :VersionResolver,     "fontisan/ucd/version_resolver"
+    autoload :IndexBuilder,        "fontisan/ucd/index_builder"
+    autoload :Index,               "fontisan/ucd/index"
+    autoload :Aggregator,          "fontisan/ucd/aggregator"
+    autoload :RangeEntry,          "fontisan/ucd/range_entry"
+    autoload :Error,               "fontisan/ucd/error"
+    autoload :DownloadError,       "fontisan/ucd/download_error"
+    autoload :UnknownVersionError, "fontisan/ucd/unknown_version_error"
+  end
+end

data/lib/fontisan/utilities/checksum_calculator.rb

@@ -1,7 +1,6 @@
 # frozen_string_literal: true
 
 require "stringio"
-require_relative "../constants"
 
 module Fontisan
   module Utilities

data/lib/fontisan/utilities.rb

@@ -0,0 +1,10 @@
+# frozen_string_literal: true
+
+# Autoload hub for the Fontisan::Utilities namespace.
+
+module Fontisan
+  module Utilities
+    autoload :BrotliWrapper, "fontisan/utilities/brotli_wrapper"
+    autoload :ChecksumCalculator, "fontisan/utilities/checksum_calculator"
+  end
+end

data/lib/fontisan/utils.rb

@@ -0,0 +1,10 @@
+# frozen_string_literal: true
+
+# Autoload hub for the Fontisan::Utils namespace.
+
+module Fontisan
+  module Utils
+    autoload :Future, "fontisan/utils/thread_pool"
+    autoload :ThreadPool, "fontisan/utils/thread_pool"
+  end
+end

data/lib/fontisan/validation/collection_validator.rb

@@ -1,7 +1,5 @@
 # frozen_string_literal: true
 
-require_relative "../error"
-
 module Fontisan
   module Validation
     # CollectionValidator validates font compatibility for collection formats

data/lib/fontisan/validation.rb

@@ -0,0 +1,9 @@
+# frozen_string_literal: true
+
+# Autoload hub for the Fontisan::Validation namespace.
+
+module Fontisan
+  module Validation
+    autoload :CollectionValidator, "fontisan/validation/collection_validator"
+  end
+end

data/lib/fontisan/validators/basic_validator.rb

@@ -1,7 +1,5 @@
 # frozen_string_literal: true
 
-require_relative "validator"
-
 module Fontisan
   module Validators
     # BasicValidator provides minimal validation for fast font indexing

data/lib/fontisan/validators/font_book_validator.rb

@@ -1,7 +1,5 @@
 # frozen_string_literal: true
 
-require_relative "basic_validator"
-
 module Fontisan
   module Validators
     # FontBookValidator provides macOS Font Book installation compatibility checks

data/lib/fontisan/validators/opentype_validator.rb

@@ -1,7 +1,5 @@
 # frozen_string_literal: true
 
-require_relative "font_book_validator"
-
 module Fontisan
   module Validators
     # OpenTypeValidator provides comprehensive OpenType specification compliance checks

data/lib/fontisan/validators/profile_loader.rb

@@ -1,10 +1,5 @@
 # frozen_string_literal: true
 
-require_relative "basic_validator"
-require_relative "font_book_validator"
-require_relative "opentype_validator"
-require_relative "web_font_validator"
-
 module Fontisan
   module Validators
     # ProfileLoader manages validation profiles and loads appropriate validators

data/lib/fontisan/validators/validator.rb

@@ -1,7 +1,5 @@
 # frozen_string_literal: true
 
-require_relative "../models/validation_report"
-
 module Fontisan
   module Validators
     # Base class for all validators using block-based DSL

data/lib/fontisan/validators/web_font_validator.rb

@@ -1,7 +1,5 @@
 # frozen_string_literal: true
 
-require_relative "basic_validator"
-
 module Fontisan
   module Validators
     # WebFontValidator provides web font optimization and embedding compatibility checks

data/lib/fontisan/validators.rb

@@ -0,0 +1,14 @@
+# frozen_string_literal: true
+
+# Autoload hub for the Fontisan::Validators namespace.
+
+module Fontisan
+  module Validators
+    autoload :BasicValidator, "fontisan/validators/basic_validator"
+    autoload :FontBookValidator, "fontisan/validators/font_book_validator"
+    autoload :OpenTypeValidator, "fontisan/validators/opentype_validator"
+    autoload :ProfileLoader, "fontisan/validators/profile_loader"
+    autoload :Validator, "fontisan/validators/validator"
+    autoload :WebFontValidator, "fontisan/validators/web_font_validator"
+  end
+end

data/lib/fontisan/variable/delta_applicator.rb

@@ -1,10 +1,6 @@
 # frozen_string_literal: true
 
 require "yaml"
-require_relative "axis_normalizer"
-require_relative "region_matcher"
-require_relative "glyph_delta_processor"
-require_relative "metric_delta_processor"
 
 module Fontisan
   module Variable

data/lib/fontisan/variable/instancer.rb

@@ -1,8 +1,5 @@
 # frozen_string_literal: true
 
-require_relative "delta_applicator"
-require_relative "static_font_builder"
-
 module Fontisan
   module Variable
     # Main entry point for variable font instancing

data/lib/fontisan/variable/static_font_builder.rb

@@ -1,8 +1,5 @@
 # frozen_string_literal: true
 
-require_relative "table_updater"
-require_relative "../font_writer"
-
 module Fontisan
   module Variable
     # Builds static font instances from variable font data

data/lib/fontisan/variable.rb

@@ -0,0 +1,16 @@
+# frozen_string_literal: true
+
+# Autoload hub for the Fontisan::Variable namespace.
+
+module Fontisan
+  module Variable
+    autoload :AxisNormalizer, "fontisan/variable/axis_normalizer"
+    autoload :DeltaApplicator, "fontisan/variable/delta_applicator"
+    autoload :GlyphDeltaProcessor, "fontisan/variable/glyph_delta_processor"
+    autoload :Instancer, "fontisan/variable/instancer"
+    autoload :MetricDeltaProcessor, "fontisan/variable/metric_delta_processor"
+    autoload :RegionMatcher, "fontisan/variable/region_matcher"
+    autoload :StaticFontBuilder, "fontisan/variable/static_font_builder"
+    autoload :TableUpdater, "fontisan/variable/table_updater"
+  end
+end

data/lib/fontisan/variation/blend_applier.rb

@@ -1,7 +1,5 @@
 # frozen_string_literal: true
 
-require_relative "interpolator"
-
 module Fontisan
   module Variation
     # Applies CFF2 blend operators during CharString execution

data/lib/fontisan/variation/cache.rb

@@ -1,7 +1,5 @@
 # frozen_string_literal: true
 
-require_relative "cache_key_builder"
-
 module Fontisan
   module Variation
     # Caches variation calculations for performance

data/lib/fontisan/variation/converter.rb

@@ -1,8 +1,5 @@
 # frozen_string_literal: true
 
-require_relative "interpolator"
-require_relative "table_accessor"
-
 module Fontisan
   module Variation
     # Converts variation data between TrueType (gvar) and CFF2 (blend) formats

data/lib/fontisan/variation/data_extractor.rb

@@ -1,7 +1,5 @@
 # frozen_string_literal: true
 
-require_relative "variation_context"
-
 module Fontisan
   module Variation
     # Extracts variation data from OpenType variable fonts

data/lib/fontisan/variation/delta_applier.rb

@@ -1,10 +1,5 @@
 # frozen_string_literal: true
 
-require_relative "delta_parser"
-require_relative "interpolator"
-require_relative "region_matcher"
-require_relative "table_accessor"
-
 module Fontisan
   module Variation
     # Applies variation deltas to glyph outlines

data/lib/fontisan/variation/inspector.rb

@@ -2,7 +2,6 @@
 
 require "json"
 require "yaml"
-require_relative "variation_context"
 
 module Fontisan
   module Variation

data/lib/fontisan/variation/instance_generator.rb

@@ -1,11 +1,5 @@
 # frozen_string_literal: true
 
-require_relative "interpolator"
-require_relative "region_matcher"
-require_relative "metrics_adjuster"
-require_relative "variation_context"
-require_relative "table_accessor"
-
 module Fontisan
   module Variation
     # Generates static font instances from variable fonts

data/lib/fontisan/variation/instance_writer.rb

@@ -1,10 +1,5 @@
 # frozen_string_literal: true
 
-require_relative "../font_writer"
-require_relative "../converters/outline_converter"
-require_relative "../converters/woff_writer"
-require_relative "../error"
-
 module Fontisan
   module Variation
     # Writes generated static font instances to files in various formats

data/lib/fontisan/variation/metrics_adjuster.rb

@@ -1,9 +1,5 @@
 # frozen_string_literal: true
 
-require_relative "interpolator"
-require_relative "region_matcher"
-require_relative "table_accessor"
-
 module Fontisan
   module Variation
     # Applies metrics variation deltas to font metrics tables

data/lib/fontisan/variation/optimizer.rb

@@ -1,8 +1,5 @@
 # frozen_string_literal: true
 
-require_relative "../optimizers/pattern_analyzer"
-require_relative "../optimizers/subroutine_optimizer"
-
 module Fontisan
   module Variation
     # Optimizes CFF subroutines for variable fonts

data/lib/fontisan/variation/parallel_generator.rb

@@ -1,8 +1,5 @@
 # frozen_string_literal: true
 
-require_relative "instance_generator"
-require_relative "cache"
-require_relative "../utils/thread_pool"
 require "etc"
 
 module Fontisan

data/lib/fontisan/variation/subsetter.rb

@@ -1,9 +1,5 @@
 # frozen_string_literal: true
 
-require_relative "validator"
-require_relative "optimizer"
-require_relative "table_accessor"
-
 module Fontisan
   module Variation
     # Subset variable fonts while preserving variation

data/lib/fontisan/variation/tuple_variation_header.rb

@@ -1,7 +1,5 @@
 # frozen_string_literal: true
 
-require_relative "../binary/base_record"
-
 module Fontisan
   module Variation
     # Tuple variation header structure

data/lib/fontisan/variation/variable_svg_generator.rb

@@ -1,8 +1,5 @@
 # frozen_string_literal: true
 
-require_relative "instance_generator"
-require_relative "../converters/svg_generator"
-
 module Fontisan
   module Variation
     # Generates SVG fonts from variable fonts at specific coordinates

data/lib/fontisan/variation/variation_context.rb

@@ -1,8 +1,5 @@
 # frozen_string_literal: true
 
-require_relative "interpolator"
-require_relative "region_matcher"
-
 module Fontisan
   module Variation
     # Provides shared context for variation operations

data/lib/fontisan/variation/variation_preserver.rb

@@ -1,8 +1,5 @@
 # frozen_string_literal: true
 
-require_relative "variation_context"
-require_relative "../error"
-
 module Fontisan
   module Variation
     # Preserves variation data when converting between compatible font formats

data/lib/fontisan/variation.rb

@@ -0,0 +1,31 @@
+# frozen_string_literal: true
+
+# Autoload hub for the Fontisan::Variation namespace.
+
+module Fontisan
+  module Variation
+    autoload :BlendApplier, "fontisan/variation/blend_applier"
+    autoload :Cache, "fontisan/variation/cache"
+    autoload :CacheKeyBuilder, "fontisan/variation/cache_key_builder"
+    autoload :Converter, "fontisan/variation/converter"
+    autoload :DataExtractor, "fontisan/variation/data_extractor"
+    autoload :DeltaApplier, "fontisan/variation/delta_applier"
+    autoload :DeltaParser, "fontisan/variation/delta_parser"
+    autoload :Inspector, "fontisan/variation/inspector"
+    autoload :InstanceGenerator, "fontisan/variation/instance_generator"
+    autoload :InstanceWriter, "fontisan/variation/instance_writer"
+    autoload :Interpolator, "fontisan/variation/interpolator"
+    autoload :MetricsAdjuster, "fontisan/variation/metrics_adjuster"
+    autoload :Optimizer, "fontisan/variation/optimizer"
+    autoload :ParallelGenerator, "fontisan/variation/parallel_generator"
+    autoload :RegionMatcher, "fontisan/variation/region_matcher"
+    autoload :Subsetter, "fontisan/variation/subsetter"
+    autoload :TableAccessor, "fontisan/variation/table_accessor"
+    autoload :ThreadSafeCache, "fontisan/variation/cache"
+    autoload :TupleVariationHeader, "fontisan/variation/tuple_variation_header"
+    autoload :Validator, "fontisan/variation/validator"
+    autoload :VariableSvgGenerator, "fontisan/variation/variable_svg_generator"
+    autoload :VariationContext, "fontisan/variation/variation_context"
+    autoload :VariationPreserver, "fontisan/variation/variation_preserver"
+  end
+end

data/lib/fontisan/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Fontisan
-  VERSION = "0.2.16"
+  VERSION = "0.2.22"
 end

data/lib/fontisan/woff2.rb

@@ -0,0 +1,13 @@
+# frozen_string_literal: true
+
+# Autoload hub for the Fontisan::Woff2 namespace.
+
+module Fontisan
+  module Woff2
+    autoload :Directory, "fontisan/woff2/directory"
+    autoload :GlyfTransformer, "fontisan/woff2/glyf_transformer"
+    autoload :HmtxTransformer, "fontisan/woff2/hmtx_transformer"
+    autoload :TableTransformer, "fontisan/woff2/table_transformer"
+    autoload :Woff2Header, "fontisan/woff2/header"
+  end
+end

data/lib/fontisan/woff2_font.rb

@@ -3,15 +3,6 @@
 require "bindata"
 require "brotli"
 require "stringio"
-require_relative "constants"
-require_relative "loading_modes"
-require_relative "utilities/checksum_calculator"
-require_relative "woff2/header"
-require_relative "woff2/glyf_transformer"
-require_relative "woff2/hmtx_transformer"
-require_relative "true_type_font"
-require_relative "open_type_font"
-require_relative "error"
 
 module Fontisan
   # WOFF2 Table Directory Entry structure
@@ -82,6 +73,12 @@ module Fontisan
   #   puts font.header.flavor
   #   puts font.table_names
   class Woff2Font
+    # High-level pipeline format identifier. Owned by the font class so the
+    # conversion pipeline can dispatch without case statements (OCP).
+    #
+    # @return [Symbol] :woff2
+    def format = :woff2
+
     # Simple struct for storing file path
     IOSource = Struct.new(:path)
 
@@ -145,6 +142,31 @@ module Fontisan
       @table_entries.any? { |entry| entry.tag == tag }
     end
 
+    # Whether this object represents a font collection rather than a single
+    # font. Each font class is the authority on this question.
+    #
+    # @return [Boolean]
+    def collection? = false
+
+    # Variation profile. WOFF2 wraps a single SFNT font; variation tables, if
+    # present on the wrapped font, are reported here.
+    #
+    # @return [Symbol] :static, :gvar, or :cff2
+    def variation_type
+      return :static unless has_table?("fvar")
+      return :gvar if has_table?("gvar")
+      return :cff2 if has_table?("CFF2")
+
+      :static
+    end
+
+    # Outline representation, derived from the wrapped SFNT flavor.
+    #
+    # @return [Symbol] :truetype or :cff
+    def outline_type
+      truetype? ? :truetype : :cff
+    end
+
     # Find table entry by tag
     def find_table_entry(tag)
       @table_entries.find { |entry| entry.tag == tag }

data/lib/fontisan/woff_font.rb

@@ -2,8 +2,6 @@
 
 require "bindata"
 require "zlib"
-require_relative "constants"
-require_relative "utilities/checksum_calculator"
 
 module Fontisan
   # WOFF Header structure
@@ -55,6 +53,12 @@ module Fontisan
   #   woff.to_ttf("output.ttf")  # if TrueType flavored
   #   woff.to_otf("output.otf")  # if CFF flavored
   class WoffFont < BinData::Record
+    # High-level pipeline format identifier. Owned by the font class so the
+    # conversion pipeline can dispatch without case statements (OCP).
+    #
+    # @return [Symbol] :woff
+    def format = :woff
+
     endian :big
 
     woff_header :header
@@ -142,6 +146,31 @@ module Fontisan
       end
     end
 
+    # Whether this object represents a font collection rather than a single
+    # font. Each font class is the authority on this question.
+    #
+    # @return [Boolean]
+    def collection? = false
+
+    # Variation profile. WOFF wraps a single SFNT font; variation tables, if
+    # present on the wrapped font, are reported here.
+    #
+    # @return [Symbol] :static, :gvar, or :cff2
+    def variation_type
+      return :static unless has_table?("fvar")
+      return :gvar if has_table?("gvar")
+      return :cff2 if has_table?("CFF2")
+
+      :static
+    end
+
+    # Outline representation, derived from the wrapped SFNT flavor.
+    #
+    # @return [Symbol] :truetype or :cff
+    def outline_type
+      truetype? ? :truetype : :cff
+    end
+
     # Check if font is TrueType flavored
     #
     # @return [Boolean] true if TrueType, false if CFF