fontisan 0.2.16 → 0.2.22

data/lib/fontisan/tables/hmtx_table.rb

@@ -1,8 +1,5 @@
 # frozen_string_literal: true
 
-require_relative "../sfnt_table"
-require_relative "hmtx"
-
 module Fontisan
   module Tables
     # OOP representation of the 'hmtx' (Horizontal Metrics) table

data/lib/fontisan/tables/hvar.rb

@@ -1,8 +1,5 @@
 # frozen_string_literal: true
 
-require_relative "../binary/base_record"
-require_relative "variation_common"
-
 module Fontisan
   module Tables
     # Parser for the 'HVAR' (Horizontal Metrics Variations) table

data/lib/fontisan/tables/loca.rb

@@ -1,7 +1,5 @@
 # frozen_string_literal: true
 
-require_relative "../binary/base_record"
-
 module Fontisan
   module Tables
     # Parser for the 'loca' (Index to Location) table

data/lib/fontisan/tables/loca_table.rb

@@ -1,8 +1,5 @@
 # frozen_string_literal: true
 
-require_relative "../sfnt_table"
-require_relative "loca"
-
 module Fontisan
   module Tables
     # OOP representation of the 'loca' (Index to Location) table

data/lib/fontisan/tables/maxp.rb

@@ -1,7 +1,5 @@
 # frozen_string_literal: true
 
-require_relative "../binary/base_record"
-
 module Fontisan
   module Tables
     # BinData structure for the 'maxp' (Maximum Profile) table

data/lib/fontisan/tables/maxp_table.rb

@@ -1,8 +1,5 @@
 # frozen_string_literal: true
 
-require_relative "../sfnt_table"
-require_relative "maxp"
-
 module Fontisan
   module Tables
     # OOP representation of the 'maxp' (Maximum Profile) table

data/lib/fontisan/tables/mvar.rb

@@ -1,8 +1,5 @@
 # frozen_string_literal: true
 
-require_relative "../binary/base_record"
-require_relative "variation_common"
-
 module Fontisan
   module Tables
     # Parser for the 'MVAR' (Metrics Variations) table

data/lib/fontisan/tables/name.rb

@@ -1,7 +1,5 @@
 # frozen_string_literal: true
 
-require_relative "../binary/base_record"
-
 module Fontisan
   module Tables
     # BinData structure for a single name record

data/lib/fontisan/tables/name_table.rb

@@ -1,8 +1,5 @@
 # frozen_string_literal: true
 
-require_relative "../sfnt_table"
-require_relative "name"
-
 module Fontisan
   module Tables
     # OOP representation of the 'name' (Naming) table

data/lib/fontisan/tables/os2_table.rb

@@ -1,8 +1,5 @@
 # frozen_string_literal: true
 
-require_relative "../sfnt_table"
-require_relative "os2"
-
 module Fontisan
   module Tables
     # OOP representation of the 'OS/2' (OS/2 and Windows Metrics) table

data/lib/fontisan/tables/post_table.rb

@@ -1,8 +1,5 @@
 # frozen_string_literal: true
 
-require_relative "../sfnt_table"
-require_relative "post"
-
 module Fontisan
   module Tables
     # OOP representation of the 'post' (PostScript) table

data/lib/fontisan/tables/sbix.rb

@@ -1,7 +1,6 @@
 # frozen_string_literal: true
 
 require "stringio"
-require_relative "../binary/base_record"
 
 module Fontisan
   module Tables

data/lib/fontisan/tables/svg.rb

@@ -2,7 +2,6 @@
 
 require "stringio"
 require "zlib"
-require_relative "../binary/base_record"
 
 module Fontisan
   module Tables

data/lib/fontisan/tables/variation_common.rb

@@ -1,7 +1,6 @@
 # frozen_string_literal: true
 
 require "stringio"
-require_relative "../binary/base_record"
 
 module Fontisan
   module Tables

data/lib/fontisan/tables/vvar.rb

@@ -1,8 +1,5 @@
 # frozen_string_literal: true
 
-require_relative "../binary/base_record"
-require_relative "variation_common"
-
 module Fontisan
   module Tables
     # Parser for the 'VVAR' (Vertical Metrics Variations) table

data/lib/fontisan/tables.rb

@@ -0,0 +1,54 @@
+# frozen_string_literal: true
+
+# Autoload hub for the Fontisan::Tables namespace.
+
+module Fontisan
+  module Tables
+    autoload :Cbdt, "fontisan/tables/cbdt"
+    autoload :Cblc, "fontisan/tables/cblc"
+    autoload :Cff, "fontisan/tables/cff"
+    autoload :Cff2, "fontisan/tables/cff2"
+    autoload :Cmap, "fontisan/tables/cmap"
+    autoload :CmapTable, "fontisan/tables/cmap_table"
+    autoload :Colr, "fontisan/tables/colr"
+    autoload :CompoundGlyph, "fontisan/tables/glyf/compound_glyph"
+    autoload :CompoundGlyphResolver, "fontisan/tables/glyf/compound_glyph_resolver"
+    autoload :Cpal, "fontisan/tables/cpal"
+    autoload :CurveConverter, "fontisan/tables/glyf/curve_converter"
+    autoload :Cvar, "fontisan/tables/cvar"
+    autoload :Fvar, "fontisan/tables/fvar"
+    autoload :Glyf, "fontisan/tables/glyf"
+    autoload :GlyfTable, "fontisan/tables/glyf_table"
+    autoload :GlyphBuilder, "fontisan/tables/glyf/glyph_builder"
+    autoload :Gpos, "fontisan/tables/gpos"
+    autoload :Gsub, "fontisan/tables/gsub"
+    autoload :Gvar, "fontisan/tables/gvar"
+    autoload :Head, "fontisan/tables/head"
+    autoload :HeadTable, "fontisan/tables/head_table"
+    autoload :Hhea, "fontisan/tables/hhea"
+    autoload :HheaTable, "fontisan/tables/hhea_table"
+    autoload :Hmtx, "fontisan/tables/hmtx"
+    autoload :HmtxTable, "fontisan/tables/hmtx_table"
+    autoload :Hvar, "fontisan/tables/hvar"
+    autoload :InstanceRecord, "fontisan/tables/fvar"
+    autoload :LayoutCommon, "fontisan/tables/layout_common"
+    autoload :Loca, "fontisan/tables/loca"
+    autoload :LocaTable, "fontisan/tables/loca_table"
+    autoload :Maxp, "fontisan/tables/maxp"
+    autoload :MaxpTable, "fontisan/tables/maxp_table"
+    autoload :Mvar, "fontisan/tables/mvar"
+    autoload :Name, "fontisan/tables/name"
+    autoload :NameRecord, "fontisan/tables/name"
+    autoload :NameTable, "fontisan/tables/name_table"
+    autoload :Os2, "fontisan/tables/os2"
+    autoload :Os2Table, "fontisan/tables/os2_table"
+    autoload :Post, "fontisan/tables/post"
+    autoload :PostTable, "fontisan/tables/post_table"
+    autoload :Sbix, "fontisan/tables/sbix"
+    autoload :SimpleGlyph, "fontisan/tables/glyf/simple_glyph"
+    autoload :Svg, "fontisan/tables/svg"
+    autoload :VariationAxisRecord, "fontisan/tables/fvar"
+    autoload :VariationCommon, "fontisan/tables/variation_common"
+    autoload :Vvar, "fontisan/tables/vvar"
+  end
+end

data/lib/fontisan/true_type_collection.rb

@@ -1,7 +1,5 @@
 # frozen_string_literal: true
 
-require_relative "base_collection"
-
 module Fontisan
   # TrueType Collection domain object
   #
@@ -15,11 +13,16 @@ module Fontisan
   #     fonts = ttc.extract_fonts(io)  # => [TrueTypeFont, TrueTypeFont, ...]
   #   end
   class TrueTypeCollection < BaseCollection
+    # High-level pipeline format identifier. Owned by the collection class
+    # so the conversion pipeline can dispatch without case statements (OCP).
+    #
+    # @return [Symbol] :ttc
+    def format = :ttc
+
     # Get the font class for TrueType collections
     #
     # @return [Class] TrueTypeFont class
     def self.font_class
-      require_relative "true_type_font"
       TrueTypeFont
     end
 
@@ -41,7 +44,6 @@ module Fontisan
     def font(index, io, mode: LoadingModes::FULL)
       return nil if index >= num_fonts
 
-      require_relative "true_type_font"
       TrueTypeFont.from_collection(io, font_offsets[index], mode: mode)
     end
 
@@ -53,8 +55,6 @@ module Fontisan
     # @param io [IO] Open file handle to read fonts from
     # @return [Array<TrueTypeFont>] Array of font objects
     def extract_fonts(io)
-      require_relative "true_type_font"
-
       font_offsets.map do |offset|
         TrueTypeFont.from_collection(io, offset)
       end
@@ -67,11 +67,6 @@ module Fontisan
     # @param io [IO] Open file handle to read fonts from
     # @return [CollectionListInfo] List of fonts with metadata
     def list_fonts(io)
-      require_relative "models/collection_list_info"
-      require_relative "models/collection_font_summary"
-      require_relative "true_type_font"
-      require_relative "tables/name"
-
       fonts = font_offsets.map.with_index do |offset, index|
         font = TrueTypeFont.from_collection(io, offset)
 
@@ -124,9 +119,6 @@ module Fontisan
     # @param io [IO] Open file handle
     # @return [TableSharingInfo] Sharing statistics
     def calculate_table_sharing(io)
-      require_relative "models/table_sharing_info"
-      require_relative "true_type_font"
-
       # Extract all fonts
       fonts = font_offsets.map do |offset|
         TrueTypeFont.from_collection(io, offset)

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