fontisan 0.2.16 → 0.2.22

data/lib/fontisan/sfnt_font.rb

@@ -1,20 +1,6 @@
 # frozen_string_literal: true
 
 require "bindata"
-require_relative "constants"
-require_relative "loading_modes"
-require_relative "utilities/checksum_calculator"
-require_relative "sfnt_table"
-require_relative "tables/head_table"
-require_relative "tables/name_table"
-require_relative "tables/os2_table"
-require_relative "tables/cmap_table"
-require_relative "tables/glyf_table"
-require_relative "tables/hhea_table"
-require_relative "tables/maxp_table"
-require_relative "tables/post_table"
-require_relative "tables/hmtx_table"
-require_relative "tables/loca_table"
 
 module Fontisan
   # SFNT Offset Table structure
@@ -377,6 +363,35 @@ module Fontisan
       !find_table_entry(tag).nil?
     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 of the font, derived from its table set. Used by the
+    # conversion pipeline to choose between preserving variation tables and
+    # generating a static instance.
+    #
+    # @return [Symbol] :static, :gvar (TrueType variable), or :cff2 (CFF2 variable)
+    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 used by the font. Derived from the table set.
+    #
+    # @return [Symbol] :truetype (glyf/gvar) or :cff (CFF/CFF2)
+    def outline_type
+      return :truetype if has_table?("glyf") || has_table?("gvar")
+      return :cff if has_table?("CFF ") || has_table?("CFF2")
+
+      :unknown
+    end
+
     # Check if a table is available in the current loading mode
     #
     # @param tag [String] The table tag to check

data/lib/fontisan/sfnt_table.rb

@@ -1,8 +1,5 @@
 # frozen_string_literal: true
 
-require_relative "constants"
-require_relative "loading_modes"
-
 module Fontisan
   # Base class for SFNT font tables
   #
@@ -198,7 +195,6 @@ module Fontisan
     def calculate_checksum
       load_data! unless data_loaded?
 
-      require_relative "utilities/checksum_calculator"
       Utilities::ChecksumCalculator.calculate_table_checksum(@data)
     end
 

data/lib/fontisan/subset/builder.rb

@@ -1,11 +1,5 @@
 # frozen_string_literal: true
 
-require_relative "options"
-require_relative "profile"
-require_relative "glyph_mapping"
-require_relative "table_subsetter"
-require_relative "../font_writer"
-
 module Fontisan
   module Subset
     # Main font subsetting engine

data/lib/fontisan/subset.rb

@@ -0,0 +1,13 @@
+# frozen_string_literal: true
+
+# Autoload hub for the Fontisan::Subset namespace.
+
+module Fontisan
+  module Subset
+    autoload :Builder, "fontisan/subset/builder"
+    autoload :GlyphMapping, "fontisan/subset/glyph_mapping"
+    autoload :Options, "fontisan/subset/options"
+    autoload :Profile, "fontisan/subset/profile"
+    autoload :TableSubsetter, "fontisan/subset/table_subsetter"
+  end
+end

data/lib/fontisan/svg/font_generator.rb

@@ -1,9 +1,5 @@
 # frozen_string_literal: true
 
-require_relative "font_face_generator"
-require_relative "glyph_generator"
-require_relative "view_box_calculator"
-
 module Fontisan
   module Svg
     # Generates complete SVG font XML structure

data/lib/fontisan/svg/glyph_generator.rb

@@ -1,7 +1,5 @@
 # frozen_string_literal: true
 
-require_relative "view_box_calculator"
-
 module Fontisan
   module Svg
     # Generates SVG glyph elements from glyph outlines

data/lib/fontisan/svg.rb

@@ -0,0 +1,12 @@
+# frozen_string_literal: true
+
+# Autoload hub for the Fontisan::Svg namespace.
+
+module Fontisan
+  module Svg
+    autoload :FontFaceGenerator, "fontisan/svg/font_face_generator"
+    autoload :FontGenerator, "fontisan/svg/font_generator"
+    autoload :GlyphGenerator, "fontisan/svg/glyph_generator"
+    autoload :ViewBoxCalculator, "fontisan/svg/view_box_calculator"
+  end
+end

data/lib/fontisan/tables/cbdt.rb

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

data/lib/fontisan/tables/cblc.rb

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

data/lib/fontisan/tables/cff/charset.rb

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

data/lib/fontisan/tables/cff/charstring.rb

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

data/lib/fontisan/tables/cff/charstring_rebuilder.rb

@@ -1,9 +1,5 @@
 # frozen_string_literal: true
 
-require_relative "charstring_parser"
-require_relative "charstring_builder"
-require_relative "index_builder"
-
 module Fontisan
   module Tables
     class Cff

data/lib/fontisan/tables/cff/charstrings_index.rb

@@ -1,8 +1,5 @@
 # frozen_string_literal: true
 
-require_relative "index"
-require_relative "charstring"
-
 module Fontisan
   module Tables
     class Cff

data/lib/fontisan/tables/cff/dict.rb

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

data/lib/fontisan/tables/cff/encoding.rb

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

data/lib/fontisan/tables/cff/header.rb

@@ -1,7 +1,5 @@
 # frozen_string_literal: true
 
-require_relative "../../binary/base_record"
-
 module Fontisan
   module Tables
     class Cff

data/lib/fontisan/tables/cff/hint_operation_injector.rb

@@ -1,7 +1,5 @@
 # frozen_string_literal: true
 
-require_relative "../../models/hint"
-
 module Fontisan
   module Tables
     class Cff

data/lib/fontisan/tables/cff/index.rb

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

data/lib/fontisan/tables/cff/private_dict.rb

@@ -1,7 +1,5 @@
 # frozen_string_literal: true
 
-require_relative "dict"
-
 module Fontisan
   module Tables
     class Cff

data/lib/fontisan/tables/cff/private_dict_writer.rb

@@ -1,7 +1,5 @@
 # frozen_string_literal: true
 
-require_relative "dict_builder"
-
 module Fontisan
   module Tables
     class Cff

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

@@ -1,11 +1,5 @@
 # frozen_string_literal: true
 
-require_relative "private_dict_writer"
-require_relative "offset_recalculator"
-require_relative "index_builder"
-require_relative "dict_builder"
-require_relative "charstring_rebuilder"
-require_relative "hint_operation_injector"
 require "stringio"
 
 module Fontisan

data/lib/fontisan/tables/cff/top_dict.rb

@@ -1,7 +1,5 @@
 # frozen_string_literal: true
 
-require_relative "dict"
-
 module Fontisan
   module Tables
     class Cff

data/lib/fontisan/tables/cff.rb

@@ -1,7 +1,6 @@
 # frozen_string_literal: true
 
 require "stringio"
-require_relative "../binary/base_record"
 
 module Fontisan
   module Tables
@@ -42,6 +41,28 @@ module Fontisan
     #   puts cff.font_count  # => 1
     #   puts cff.header.version  # => "1.0"
     class Cff < Binary::BaseRecord
+      # Inner namespace autoloads — declared here so Cff::* constants
+      # resolve on first reference without require_relative.
+      autoload :CFFGlyph, "fontisan/tables/cff/cff_glyph"
+      autoload :Charset, "fontisan/tables/cff/charset"
+      autoload :CharString, "fontisan/tables/cff/charstring"
+      autoload :CharStringBuilder, "fontisan/tables/cff/charstring_builder"
+      autoload :CharStringParser, "fontisan/tables/cff/charstring_parser"
+      autoload :CharStringRebuilder, "fontisan/tables/cff/charstring_rebuilder"
+      autoload :CharstringsIndex, "fontisan/tables/cff/charstrings_index"
+      autoload :Dict, "fontisan/tables/cff/dict"
+      autoload :DictBuilder, "fontisan/tables/cff/dict_builder"
+      autoload :Encoding, "fontisan/tables/cff/encoding"
+      autoload :Header, "fontisan/tables/cff/header"
+      autoload :HintOperationInjector, "fontisan/tables/cff/hint_operation_injector"
+      autoload :Index, "fontisan/tables/cff/index"
+      autoload :IndexBuilder, "fontisan/tables/cff/index_builder"
+      autoload :OffsetRecalculator, "fontisan/tables/cff/offset_recalculator"
+      autoload :PrivateDict, "fontisan/tables/cff/private_dict"
+      autoload :PrivateDictWriter, "fontisan/tables/cff/private_dict_writer"
+      autoload :TableBuilder, "fontisan/tables/cff/table_builder"
+      autoload :TopDict, "fontisan/tables/cff/top_dict"
+
       # OpenType table tag for CFF
       TAG = "CFF "
 
@@ -468,19 +489,5 @@ module Fontisan
         raise CorruptedTableError, "Failed to parse Encoding: #{e.message}"
       end
     end
-
-    # Load nested class definitions after the main class is defined
-    require_relative "cff/header"
-    require_relative "cff/index"
-    require_relative "cff/dict"
-    require_relative "cff/top_dict"
-    require_relative "cff/private_dict"
-    require_relative "cff/charstring"
-    require_relative "cff/charstring_parser"
-    require_relative "cff/charstring_rebuilder"
-    require_relative "cff/charstrings_index"
-    require_relative "cff/charset"
-    require_relative "cff/encoding"
-    require_relative "cff/cff_glyph"
   end
 end

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