fontisan 0.2.17 → 0.2.23

data/lib/fontisan/true_type_font.rb

@@ -1,7 +1,5 @@
 # frozen_string_literal: true
 
-require_relative "sfnt_font"
-
 module Fontisan
   # TrueType Font domain object
   #
@@ -25,6 +23,14 @@ module Fontisan
   # @example Reading from TTC collection
   #   ttf = TrueTypeFont.from_collection(io, offset)
   class TrueTypeFont < SfntFont
+    extend TrueTypeFontExtensions
+
+    # High-level pipeline format identifier. Owned by the font class so the
+    # conversion pipeline can dispatch without case statements (OCP).
+    #
+    # @return [Symbol] :ttf
+    def format = :ttf
+
     # Check if font is TrueType flavored
     #
     # @return [Boolean] true for TrueType fonts

data/lib/fontisan/true_type_font_extensions.rb

@@ -1,24 +1,25 @@
 # frozen_string_literal: true
 
 module Fontisan
-  # Extensions to TrueTypeFont for table-based construction
-  class TrueTypeFont
+  # Extension module for {TrueTypeFont} providing table-based construction.
+  #
+  # Extended into TrueTypeFont from +true_type_font.rb+ so that
+  # +TrueTypeFont.from_tables(...)+ is available whenever the class
+  # itself is loaded.
+  module TrueTypeFontExtensions
     # Create font from hash of tables
     #
     # This is used during font conversion when we have tables but not a file.
     #
     # @param tables [Hash<String, String>] Map of table tag to binary data
     # @return [TrueTypeFont] New font instance
-    def self.from_tables(tables)
-      # Create minimal header structure
+    def from_tables(tables)
       font = new
       font.initialize_storage
       font.loading_mode = LoadingModes::FULL
 
-      # Store table data
       font.table_data = tables
 
-      # Build header from tables
       num_tables = tables.size
       max_power = 0
       n = num_tables
@@ -37,13 +38,12 @@ module Fontisan
       font.header.entry_selector = entry_selector
       font.header.range_shift = range_shift
 
-      # Build table directory
       font.tables.clear
       tables.each_key do |tag|
         entry = TableDirectory.new
         entry.tag = tag
-        entry.checksum = 0 # Will be calculated on write
-        entry.offset = 0 # Will be calculated on write
+        entry.checksum = 0
+        entry.offset = 0
         entry.table_length = tables[tag].bytesize
         font.tables << entry
       end

data/lib/fontisan/type1/afm_generator.rb

@@ -1,9 +1,5 @@
 # frozen_string_literal: true
 
-require_relative "upm_scaler"
-require_relative "encodings"
-require_relative "agl"
-
 module Fontisan
   module Type1
     # AFM (Adobe Font Metrics) file generator

data/lib/fontisan/type1/conversion_options.rb

@@ -1,7 +1,5 @@
 # frozen_string_literal: true
 
-require_relative "encodings"
-
 module Fontisan
   module Type1
     # Conversion options for Type 1 font generation

data/lib/fontisan/type1/encodings.rb

@@ -1,7 +1,5 @@
 # frozen_string_literal: true
 
-require_relative "agl"
-
 module Fontisan
   module Type1
     # Font encoding schemes for Type 1 fonts

data/lib/fontisan/type1/generator.rb

@@ -1,14 +1,6 @@
 # frozen_string_literal: true
 
 require "fileutils"
-require_relative "upm_scaler"
-require_relative "encodings"
-require_relative "conversion_options"
-require_relative "afm_generator"
-require_relative "pfm_generator"
-require_relative "pfa_generator"
-require_relative "pfb_generator"
-require_relative "inf_generator"
 
 module Fontisan
   module Type1

data/lib/fontisan/type1/pfa_generator.rb

@@ -1,8 +1,5 @@
 # frozen_string_literal: true
 
-require_relative "pfb_generator"
-require_relative "decryptor"
-
 module Fontisan
   module Type1
     # PFA (Printer Font ASCII) Generator

data/lib/fontisan/type1/pfb_generator.rb

@@ -1,10 +1,5 @@
 # frozen_string_literal: true
 
-require_relative "upm_scaler"
-require_relative "ttf_to_type1_converter"
-require_relative "decryptor"
-require_relative "../tables/name"
-
 module Fontisan
   module Type1
     # PFB (Printer Font Binary) Generator

data/lib/fontisan/type1/pfm_generator.rb

@@ -1,9 +1,5 @@
 # frozen_string_literal: true
 
-require_relative "../constants"
-require_relative "upm_scaler"
-require_relative "afm_generator"
-
 module Fontisan
   module Type1
     # PFM (Printer Font Metrics) file generator

data/lib/fontisan/type1.rb

@@ -1,75 +1,48 @@
 # frozen_string_literal: true
 
+# Autoload hub for the Fontisan::Type1 namespace.
+#
+# Adobe Type 1 Font support — PFB/PFA parsing, eexec decryption,
+# CharString decryption, font dictionary parsing, conversion from
+# TTF/OTF, UPM scaling, and multiple encoding support.
+#
+# @example Generate Type 1 formats from TTF
+#   font = Fontisan::FontLoader.load("font.ttf")
+#   result = Fontisan::Type1::Generator.generate(font)
+#   result[:afm]   # => AFM file content
+#   result[:pfm]   # => PFM file content
+#   result[:pfb]   # => PFB file content
+#   result[:inf]   # => INF file content
+#
+# @example Generate with specific options
+#   options = Fontisan::Type1::ConversionOptions.windows_type1
+#   result = Fontisan::Type1::Generator.generate(font, options)
+#
+# @see https://www.adobe.com/devnet/font/pdfs/Type1.pdf
+
 module Fontisan
-  # Adobe Type 1 Font support
-  #
-  # [`Type1`](lib/fontisan/type1.rb) provides parsing and conversion
-  # capabilities for Adobe Type 1 fonts in PFB (Printer Font Binary)
-  # and PFA (Printer Font ASCII) formats.
-  #
-  # Type 1 fonts were the standard for digital typography in the 1980s-1990s
-  # and are still encountered in legacy systems and design workflows.
-  #
-  # Key features:
-  # - PFB and PFA format parsing
-  # - eexec decryption for encrypted font portions
-  # - CharString decryption with lenIV handling
-  # - Font dictionary parsing (FontInfo, Private dict)
-  # - Conversion from TTF/OTF to Type 1 formats
-  # - UPM scaling for Type 1 compatibility (1000 UPM)
-  # - Multiple encoding support (AdobeStandard, ISOLatin1, Unicode)
-  #
-  # @example Generate Type 1 formats from TTF
-  #   font = Fontisan::FontLoader.load("font.ttf")
-  #   result = Fontisan::Type1::Generator.generate(font)
-  #   result[:afm]   # => AFM file content
-  #   result[:pfm]   # => PFM file content
-  #   result[:pfb]   # => PFB file content
-  #   result[:inf]   # => INF file content
-  #
-  # @example Generate with specific options
-  #   options = Fontisan::Type1::ConversionOptions.windows_type1
-  #   result = Fontisan::Type1::Generator.generate(font, options)
-  #
-  # @see https://www.adobe.com/devnet/font/pdfs/Type1.pdf
   module Type1
+    autoload :AGL, "fontisan/type1/agl"
+    autoload :AFMGenerator, "fontisan/type1/afm_generator"
+    autoload :AFMParser, "fontisan/type1/afm_parser"
+    autoload :CffToType1Converter, "fontisan/type1/cff_to_type1_converter"
+    autoload :CharStringConverter, "fontisan/type1/charstring_converter"
+    autoload :CharStrings, "fontisan/type1/charstrings"
+    autoload :ConversionOptions, "fontisan/type1/conversion_options"
+    autoload :Decryptor, "fontisan/type1/decryptor"
+    autoload :Encodings, "fontisan/type1/encodings"
+    autoload :FontDictionary, "fontisan/type1/font_dictionary"
+    autoload :Generator, "fontisan/type1/generator"
+    autoload :INFGenerator, "fontisan/type1/inf_generator"
+    autoload :PFAGenerator, "fontisan/type1/pfa_generator"
+    autoload :PFAParser, "fontisan/type1/pfa_parser"
+    autoload :PFBGenerator, "fontisan/type1/pfb_generator"
+    autoload :PFBParser, "fontisan/type1/pfb_parser"
+    autoload :PFMGenerator, "fontisan/type1/pfm_generator"
+    autoload :PFMParser, "fontisan/type1/pfm_parser"
+    autoload :PrivateDict, "fontisan/type1/private_dict"
+    autoload :SeacExpander, "fontisan/type1/seac_expander"
+    autoload :TTFToType1Converter, "fontisan/type1/ttf_to_type1_converter"
+    autoload :UPMScaler, "fontisan/type1/upm_scaler"
   end
 end
-
-# Parsers
-require_relative "type1/pfb_parser"
-require_relative "type1/pfa_parser"
-
-# Core components
-require_relative "type1/decryptor"
-require_relative "type1/font_dictionary"
-require_relative "type1/private_dict"
-require_relative "type1/charstrings"
-require_relative "type1/charstring_converter"
-require_relative "type1/cff_to_type1_converter"
-require_relative "type1/seac_expander"
-
-# Infrastructure
-require_relative "type1/upm_scaler"
-require_relative "type1/agl"
-require_relative "type1/encodings"
-require_relative "type1/conversion_options"
-
-# TTF to Type 1 conversion
-require_relative "type1/ttf_to_type1_converter"
-
-# Metrics parsers
-require_relative "type1/afm_parser"
-require_relative "type1/pfm_parser"
-
-# Metrics generators
-require_relative "type1/afm_generator"
-require_relative "type1/pfm_generator"
-
-# Type 1 font generators
-require_relative "type1/pfa_generator"
-require_relative "type1/pfb_generator"
-require_relative "type1/inf_generator"
-
-# Unified generator interface
-require_relative "type1/generator"

data/lib/fontisan/type1_font.rb

@@ -1,7 +1,5 @@
 # frozen_string_literal: true
 
-require_relative "type1"
-
 module Fontisan
   # Adobe Type 1 Font handler
   #
@@ -34,8 +32,38 @@ module Fontisan
     # @return [String, nil] File path if loaded from file
     attr_reader :file_path
 
-    # @return [Symbol] Format type (:pfb or :pfa)
-    attr_reader :format
+    # @return [Symbol] Container variant (:pfb or :pfa) — the on-disk
+    #   encoding of a Type 1 font (binary vs ASCII). Distinct from
+    #   {#format}, which is the high-level pipeline format.
+    attr_reader :container_format
+
+    # High-level pipeline format identifier. Owned by the font class so
+    # the conversion pipeline can dispatch without case statements (OCP).
+    #
+    # @return [Symbol] :type1
+    def format = :type1
+
+    # 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
+
+    # Type 1 fonts are not OpenType variable fonts.
+    #
+    # @return [Symbol] :static
+    def variation_type = :static
+
+    # Outline representation. Type 1 fonts use cubic PostScript CharStrings.
+    #
+    # @return [Symbol] :postscript
+    def outline_type = :postscript
+
+    # Type 1 fonts have no SFNT table directory; the table-oriented pipeline
+    # introspection does not apply.
+    #
+    # @return [Array<String>] empty
+    def table_names = []
 
     # @return [Symbol] Loading mode (:metadata or :full)
     attr_reader :loading_mode
@@ -64,12 +92,13 @@ module Fontisan
     # Initialize a new Type1Font instance
     #
     # @param data [String] Font file data (binary or text)
-    # @param format [Symbol] Format type (:pfb or :pfa, auto-detected if nil)
+    # @param container_format [Symbol] Container variant (:pfb or :pfa,
+    #   auto-detected if nil)
     # @param file_path [String, nil] Optional file path for reference
     # @param mode [Symbol] Loading mode (:metadata or :full, default: :full)
-    def initialize(data, format: nil, file_path: nil, mode: :full)
+    def initialize(data, container_format: nil, file_path: nil, mode: :full)
       @file_path = file_path
-      @format = format || detect_format(data)
+      @container_format = container_format || detect_format(data)
       @data = data
       @loading_mode = mode
 
@@ -139,7 +168,7 @@ module Fontisan
       if @encrypted_portion.nil? || @encrypted_portion.empty?
         @decrypted_data = @clear_text
       else
-        encrypted_binary = if @format == :pfa
+        encrypted_binary = if @container_format == :pfa
                              # Convert hex string to binary
                              [@encrypted_portion.gsub(/\s/, "")].pack("H*")
                            else
@@ -226,15 +255,15 @@ module Fontisan
 
     private
 
-    # Parse font data based on format
+    # Parse font data based on container format
     def parse_font_data
-      case @format
+      case @container_format
       when :pfb
         parse_pfb
       when :pfa
         parse_pfa
       else
-        raise Fontisan::Error, "Unknown format: #{@format}"
+        raise Fontisan::Error, "Unknown container format: #{@container_format}"
       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