fontisan 0.2.17 → 0.2.22

data/lib/fontisan/tables/cff2/charstring_parser.rb

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

data/lib/fontisan/tables/cff2/table_builder.rb

@@ -1,12 +1,5 @@
 # frozen_string_literal: true
 
-require_relative "../cff/table_builder"
-require_relative "table_reader"
-require_relative "private_dict_blend_handler"
-require_relative "../cff/charstring_parser"
-require_relative "../cff/charstring_builder"
-require_relative "../cff/hint_operation_injector"
-require_relative "../cff/dict_builder"
 require "stringio"
 
 module Fontisan
@@ -493,8 +486,6 @@ vstore:)
         # @param dict [Hash] Top DICT hash with integer operator keys
         # @return [String] Binary DICT data
         def serialize_top_dict(dict)
-          require_relative "../cff/dict_builder"
-
           # Convert integer operator keys to symbol keys for DictBuilder
           symbol_dict = convert_operators_to_symbols(dict)
           Cff::DictBuilder.build(symbol_dict)
@@ -505,8 +496,6 @@ vstore:)
         # @param dict [Hash] Private DICT hash
         # @return [String] Binary DICT data
         def serialize_private_dict(dict)
-          require_relative "../cff/dict_builder"
-
           # Convert integer operator keys to symbol keys for DictBuilder
           symbol_dict = convert_operators_to_symbols(dict)
           Cff::DictBuilder.build(symbol_dict)

data/lib/fontisan/tables/cff2/table_reader.rb

@@ -1,7 +1,6 @@
 # frozen_string_literal: true
 
 require "stringio"
-require_relative "../../binary/base_record"
 
 module Fontisan
   module Tables
@@ -233,7 +232,6 @@ module Fontisan
         # @return [Cff::Index] CharStrings INDEX
         def read_charstrings(offset)
           @io.seek(offset)
-          require_relative "../cff/index"
           Cff::Index.new(@io, start_offset: offset)
         end
 

data/lib/fontisan/tables/cff2.rb

@@ -1,7 +1,6 @@
 # frozen_string_literal: true
 
 require "stringio"
-require_relative "../binary/base_record"
 
 module Fontisan
   module Tables
@@ -21,6 +20,19 @@ module Fontisan
     #   cff2 = Fontisan::Tables::Cff2.read(data)
     #   num_glyphs = cff2.glyph_count
     class Cff2 < Binary::BaseRecord
+      # Inner namespace autoloads — declared here so Cff2::* constants
+      # resolve on first reference without require_relative.
+      autoload :BlendOperator, "fontisan/tables/cff2/blend_operator"
+      autoload :CharstringParser, "fontisan/tables/cff2/charstring_parser"
+      autoload :OperandStack, "fontisan/tables/cff2/operand_stack"
+      autoload :PrivateDictBlendHandler,
+               "fontisan/tables/cff2/private_dict_blend_handler"
+      autoload :RegionMatcher, "fontisan/tables/cff2/region_matcher"
+      autoload :TableBuilder, "fontisan/tables/cff2/table_builder"
+      autoload :TableReader, "fontisan/tables/cff2/table_reader"
+      autoload :VariationDataExtractor,
+               "fontisan/tables/cff2/variation_data_extractor"
+
       # CFF2 header structure
       class Cff2Header < Binary::BaseRecord
         uint8 :major_version
@@ -105,7 +117,6 @@ module Fontisan
         return nil if charstring_data.nil?
 
         # Parse with CFF2 CharString parser
-        require_relative "cff2/charstring_parser"
         CharstringParser.new(
           charstring_data,
           @num_axes,
@@ -159,7 +170,6 @@ module Fontisan
         io = StringIO.new(data)
         io.seek(offset)
 
-        require_relative "cff/index"
         Cff::Index.new(io, start_offset: offset)
       rescue StandardError => e
         warn "Failed to parse Global Subr INDEX: #{e.message}"
@@ -212,7 +222,6 @@ module Fontisan
         io = StringIO.new(data)
         io.seek(offset)
 
-        require_relative "cff/index"
         Cff::Index.new(io, start_offset: offset)
       rescue StandardError => e
         warn "Failed to parse CharStrings INDEX: #{e.message}"
@@ -334,13 +343,3 @@ module Fontisan
     end
   end
 end
-
-# Load CFF2 subcomponents
-require_relative "cff2/charstring_parser"
-require_relative "cff2/blend_operator"
-require_relative "cff2/operand_stack"
-require_relative "cff2/table_reader"
-require_relative "cff2/variation_data_extractor"
-require_relative "cff2/region_matcher"
-require_relative "cff2/private_dict_blend_handler"
-require_relative "cff2/table_builder"

data/lib/fontisan/tables/cmap.rb

@@ -1,7 +1,5 @@
 # frozen_string_literal: true
 
-require_relative "../binary/base_record"
-
 module Fontisan
   module Tables
     # Parser for the 'cmap' (Character to Glyph Index Mapping) table
@@ -347,6 +345,30 @@ module Fontisan
         false
       end
 
+      # Distinct subtable formats present in this cmap, sorted ascending.
+      #
+      # Each encoding record's subtable begins with a uint16 format tag.
+      # Returns the unique set of those formats across all records. Useful
+      # for audit reports that need to record which cmap subtables
+      # contributed to the Unicode mappings.
+      #
+      # @return [Array<Integer>] sorted unique format numbers
+      def subtable_formats
+        data = to_binary_s
+        records = read_encoding_records(data)
+
+        formats = records.filter_map do |record|
+          subtable_data = extract_subtable_data(record, data)
+          next nil unless subtable_data && subtable_data.length >= 2
+
+          subtable_data[0, 2].unpack1("n")
+        end
+
+        formats.uniq.sort
+      rescue StandardError
+        []
+      end
+
       # Validation helper: Check if glyph indices are within bounds
       #
       # @param max_glyph_id [Integer] Maximum valid glyph ID from maxp table

data/lib/fontisan/tables/cmap_table.rb

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

data/lib/fontisan/tables/colr.rb

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

data/lib/fontisan/tables/cpal.rb

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

data/lib/fontisan/tables/cvar.rb

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

data/lib/fontisan/tables/fvar.rb

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

data/lib/fontisan/tables/glyf/compound_glyph_resolver.rb

@@ -1,7 +1,5 @@
 # frozen_string_literal: true
 
-require_relative "../../models/outline"
-
 module Fontisan
   module Tables
     # Resolves compound glyphs into simple outlines

data/lib/fontisan/tables/glyf/glyph_builder.rb

@@ -1,8 +1,5 @@
 # frozen_string_literal: true
 
-require_relative "../../models/outline"
-require_relative "curve_converter"
-
 module Fontisan
   module Tables
     # Builds binary TrueType glyph data from universal outline representation

data/lib/fontisan/tables/glyf.rb

@@ -1,11 +1,5 @@
 # frozen_string_literal: true
 
-require_relative "../binary/base_record"
-require_relative "glyf/simple_glyph"
-require_relative "glyf/compound_glyph"
-require_relative "glyf/curve_converter"
-require_relative "glyf/glyph_builder"
-
 module Fontisan
   module Tables
     # Parser for the 'glyf' (Glyph Data) table

data/lib/fontisan/tables/glyf_table.rb

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

data/lib/fontisan/tables/gpos.rb

@@ -1,7 +1,5 @@
 # frozen_string_literal: true
 
-require_relative "layout_common"
-
 module Fontisan
   module Tables
     # GPOS (Glyph Positioning) table parser

data/lib/fontisan/tables/gsub.rb

@@ -1,7 +1,5 @@
 # frozen_string_literal: true
 
-require_relative "layout_common"
-
 module Fontisan
   module Tables
     # GSUB (Glyph Substitution) table parser

data/lib/fontisan/tables/gvar.rb

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

data/lib/fontisan/tables/head.rb

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

data/lib/fontisan/tables/head_table.rb

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

data/lib/fontisan/tables/hhea.rb

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

data/lib/fontisan/tables/hhea_table.rb

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

data/lib/fontisan/tables/hmtx.rb

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

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