fontisan 0.2.17 → 0.2.23

data/lib/fontisan/dfont_collection.rb

@@ -1,9 +1,5 @@
 # frozen_string_literal: true
 
-require_relative "parsers/dfont_parser"
-require_relative "error"
-require_relative "collection/shared_logic"
-
 module Fontisan
   # DfontCollection represents an Apple dfont suitcase containing multiple fonts
   #
@@ -26,6 +22,35 @@ module Fontisan
   class DfontCollection
     include Collection::SharedLogic
 
+    # High-level pipeline format identifier. Owned by the collection class
+    # so the conversion pipeline can dispatch without case statements (OCP).
+    #
+    # @return [Symbol] :dfont
+    def format = :dfont
+
+    # 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? = true
+
+    # Variation profile. dfonts are containers; per-font variation is not
+    # exposed at the collection level.
+    #
+    # @return [Symbol] :static
+    def variation_type = :static
+
+    # Outline representation. dfonts may contain mixed-flavor fonts;
+    # per-font outline type requires loading an individual font.
+    #
+    # @return [Symbol] :unknown
+    def outline_type = :unknown
+
+    # Collections have no single SFNT table directory.
+    #
+    # @return [Array<String>] empty
+    def table_names = []
+
     # Path to dfont file
     # @return [String]
     attr_reader :path
@@ -138,9 +163,6 @@ module Fontisan
     # @param io [IO] Open file handle
     # @return [Models::CollectionListInfo] Collection list info
     def list_fonts(io)
-      require_relative "models/collection_list_info"
-      require_relative "models/collection_font_summary"
-
       fonts = extract_fonts(io)
 
       summaries = fonts.map.with_index do |font, index|
@@ -227,9 +249,6 @@ module Fontisan
     #     puts "Format: #{info.collection_format}"
     #   end
     def collection_info(io, path)
-      require_relative "models/collection_info"
-      require_relative "models/table_sharing_info"
-
       # Calculate table sharing statistics
       table_sharing = calculate_table_sharing(io)
 

data/lib/fontisan/export/exporter.rb

@@ -1,11 +1,5 @@
 # frozen_string_literal: true
 
-require_relative "../models/font_export"
-require_relative "table_serializer"
-require_relative "ttx_generator"
-require_relative "transformers/font_to_ttx"
-require_relative "../utilities/checksum_calculator"
-
 module Fontisan
   module Export
     # Exporter orchestrates font export to YAML/JSON/TTX

data/lib/fontisan/export/transformers/font_to_ttx.rb

@@ -1,14 +1,5 @@
 # frozen_string_literal: true
 
-require_relative "../../models/ttx/ttfont"
-require_relative "../../models/ttx/glyph_order"
-require_relative "head_transformer"
-require_relative "name_transformer"
-require_relative "os2_transformer"
-require_relative "post_transformer"
-require_relative "hhea_transformer"
-require_relative "maxp_transformer"
-
 module Fontisan
   module Export
     module Transformers

data/lib/fontisan/export/transformers/head_transformer.rb

@@ -1,7 +1,5 @@
 # frozen_string_literal: true
 
-require_relative "../../models/ttx/tables/head_table"
-
 module Fontisan
   module Export
     module Transformers

data/lib/fontisan/export/transformers/hhea_transformer.rb

@@ -1,7 +1,5 @@
 # frozen_string_literal: true
 
-require_relative "../../models/ttx/tables/hhea_table"
-
 module Fontisan
   module Export
     module Transformers

data/lib/fontisan/export/transformers/maxp_transformer.rb

@@ -1,7 +1,5 @@
 # frozen_string_literal: true
 
-require_relative "../../models/ttx/tables/maxp_table"
-
 module Fontisan
   module Export
     module Transformers

data/lib/fontisan/export/transformers/name_transformer.rb

@@ -1,7 +1,5 @@
 # frozen_string_literal: true
 
-require_relative "../../models/ttx/tables/name_table"
-
 module Fontisan
   module Export
     module Transformers

data/lib/fontisan/export/transformers/os2_transformer.rb

@@ -1,7 +1,5 @@
 # frozen_string_literal: true
 
-require_relative "../../models/ttx/tables/os2_table"
-
 module Fontisan
   module Export
     module Transformers

data/lib/fontisan/export/transformers/post_transformer.rb

@@ -1,7 +1,5 @@
 # frozen_string_literal: true
 
-require_relative "../../models/ttx/tables/post_table"
-
 module Fontisan
   module Export
     module Transformers

data/lib/fontisan/export/transformers.rb

@@ -0,0 +1,17 @@
+# frozen_string_literal: true
+
+# Autoload hub for the Fontisan::Export::Transformers namespace.
+
+module Fontisan
+  module Export
+    module Transformers
+      autoload :FontToTtx, "fontisan/export/transformers/font_to_ttx"
+      autoload :HeadTransformer, "fontisan/export/transformers/head_transformer"
+      autoload :HheaTransformer, "fontisan/export/transformers/hhea_transformer"
+      autoload :MaxpTransformer, "fontisan/export/transformers/maxp_transformer"
+      autoload :NameTransformer, "fontisan/export/transformers/name_transformer"
+      autoload :Os2Transformer, "fontisan/export/transformers/os2_transformer"
+      autoload :PostTransformer, "fontisan/export/transformers/post_transformer"
+    end
+  end
+end

data/lib/fontisan/export.rb

@@ -0,0 +1,13 @@
+# frozen_string_literal: true
+
+# Autoload hub for the Fontisan::Export namespace.
+
+module Fontisan
+  module Export
+    autoload :Exporter, "fontisan/export/exporter"
+    autoload :TableSerializer, "fontisan/export/table_serializer"
+    autoload :Transformers, "fontisan/export/transformers/font_to_ttx"
+    autoload :TtxGenerator, "fontisan/export/ttx_generator"
+    autoload :TtxParser, "fontisan/export/ttx_parser"
+  end
+end

data/lib/fontisan/font_loader.rb

@@ -1,18 +1,6 @@
 # frozen_string_literal: true
 
 require "stringio"
-require_relative "constants"
-require_relative "loading_modes"
-require_relative "true_type_font"
-require_relative "open_type_font"
-require_relative "true_type_collection"
-require_relative "open_type_collection"
-require_relative "dfont_collection"
-require_relative "woff_font"
-require_relative "woff2_font"
-require_relative "type1_font"
-require_relative "parsers/dfont_parser"
-require_relative "error"
 
 module Fontisan
   # FontLoader provides unified font loading with content-based format detection.
@@ -85,12 +73,18 @@ module Fontisan
 
       format = detect(path)
       case format
-      when :ttf   then TrueTypeFont.from_file(path, mode: resolved_mode, lazy: resolved_lazy)
-      when :otf   then OpenTypeFont.from_file(path, mode: resolved_mode, lazy: resolved_lazy)
-      when :woff  then WoffFont.from_file(path, mode: resolved_mode, lazy: resolved_lazy)
-      when :woff2 then Woff2Font.from_file(path, mode: resolved_mode, lazy: resolved_lazy)
-      when :ttc, :otc then load_from_collection(path, format, font_index, mode: resolved_mode)
-      when :dfont then load_dfont(path, font_index: font_index, mode: resolved_mode)
+      when :ttf   then TrueTypeFont.from_file(path, mode: resolved_mode,
+                                                    lazy: resolved_lazy)
+      when :otf   then OpenTypeFont.from_file(path, mode: resolved_mode,
+                                                    lazy: resolved_lazy)
+      when :woff  then WoffFont.from_file(path, mode: resolved_mode,
+                                                lazy: resolved_lazy)
+      when :woff2 then Woff2Font.from_file(path, mode: resolved_mode,
+                                                 lazy: resolved_lazy)
+      when :ttc, :otc then load_from_collection(path, format, font_index,
+                                                mode: resolved_mode)
+      when :dfont then load_dfont(path, font_index: font_index,
+                                        mode: resolved_mode)
       when :pfa, :pfb then Type1Font.from_file(path, mode: resolved_mode)
       else
         raise InvalidFontError,
@@ -279,7 +273,8 @@ module Fontisan
     # public `lazy:` flag is not threaded through this path.
     def self.load_dfont(path, font_index:, mode:)
       File.open(path, "rb") do |io|
-        sfnt_io = StringIO.new(Parsers::DfontParser.extract_sfnt(io, index: font_index))
+        sfnt_io = StringIO.new(Parsers::DfontParser.extract_sfnt(io,
+                                                                 index: font_index))
         klass = case Constants.sfnt_format_for(sfnt_io.read(4))
                 when :ttf then TrueTypeFont
                 when :otf then OpenTypeFont

data/lib/fontisan/font_writer.rb

@@ -1,7 +1,6 @@
 # frozen_string_literal: true
 
 require "fileutils"
-require_relative "constants"
 
 module Fontisan
   # FontWriter handles writing font binaries from table data

data/lib/fontisan/formatters.rb

@@ -0,0 +1,9 @@
+# frozen_string_literal: true
+
+# Autoload hub for the Fontisan::Formatters namespace.
+
+module Fontisan
+  module Formatters
+    autoload :TextFormatter, "fontisan/formatters/text_formatter"
+  end
+end

data/lib/fontisan/hints/hint_converter.rb

@@ -1,7 +1,6 @@
 # frozen_string_literal: true
 
 require "json"
-require_relative "../models/hint"
 
 module Fontisan
   module Hints

data/lib/fontisan/hints/postscript_hint_applier.rb

@@ -1,6 +1,5 @@
 # frozen_string_literal: true
 
-require_relative "../models/hint"
 require "json"
 
 module Fontisan
@@ -80,9 +79,6 @@ module Fontisan
         cff2_data = tables["CFF2"] || tables["CFF2 "]
 
         begin
-          require_relative "../tables/cff2/table_reader"
-          require_relative "../tables/cff2/table_builder"
-
           reader = Tables::Cff2::TableReader.new(cff2_data)
 
           # Validate CFF2 version
@@ -131,11 +127,6 @@ module Fontisan
 
         # Apply hints (both font-level and per-glyph)
         begin
-          require_relative "../tables/cff/table_builder"
-          require_relative "../tables/cff/charstring_rebuilder"
-          require_relative "../tables/cff/hint_operation_injector"
-          require_relative "../tables/cff"
-
           # Parse CFF binary data into Cff object if needed
           cff_data = tables["CFF "]
           cff_table = if cff_data.is_a?(Tables::Cff)

data/lib/fontisan/hints/postscript_hint_extractor.rb

@@ -1,7 +1,5 @@
 # frozen_string_literal: true
 
-require_relative "../models/hint"
-
 module Fontisan
   module Hints
     # Extracts rendering hints from PostScript/CFF CharString data

data/lib/fontisan/hints/truetype_hint_extractor.rb

@@ -1,7 +1,5 @@
 # frozen_string_literal: true
 
-require_relative "../models/hint"
-
 module Fontisan
   module Hints
     # Extracts rendering hints from TrueType glyph data

data/lib/fontisan/hints.rb

@@ -0,0 +1,19 @@
+# frozen_string_literal: true
+
+# Autoload hub for the Fontisan::Hints namespace.
+
+module Fontisan
+  module Hints
+    autoload :HintConverter, "fontisan/hints/hint_converter"
+    autoload :HintValidator, "fontisan/hints/hint_validator"
+    autoload :PostScriptHintApplier, "fontisan/hints/postscript_hint_applier"
+    autoload :PostScriptHintExtractor,
+             "fontisan/hints/postscript_hint_extractor"
+    autoload :TrueTypeHintApplier, "fontisan/hints/truetype_hint_applier"
+    autoload :TrueTypeHintExtractor, "fontisan/hints/truetype_hint_extractor"
+    autoload :TrueTypeInstructionAnalyzer,
+             "fontisan/hints/truetype_instruction_analyzer"
+    autoload :TrueTypeInstructionGenerator,
+             "fontisan/hints/truetype_instruction_generator"
+  end
+end

data/lib/fontisan/metrics_calculator.rb

@@ -1,7 +1,5 @@
 # frozen_string_literal: true
 
-require_relative "constants"
-
 module Fontisan
   # High-level utility class for accessing font metrics
   #

data/lib/fontisan/models/all_scripts_features_info.rb

@@ -1,7 +1,6 @@
 # frozen_string_literal: true
 
 require "lutaml/model"
-require_relative "features_info"
 
 module Fontisan
   module Models

data/lib/fontisan/models/cldr/language_coverage.rb

@@ -0,0 +1,31 @@
+# frozen_string_literal: true
+
+require "lutaml/model"
+
+module Fontisan
+  module Models
+    module Cldr
+      # Per-language coverage for one face against a CLDR exemplar set.
+      #
+      # `coverage_ratio` is in [0.0, 1.0] rounded to 4 decimal places;
+      # `fully_supported` is true only when every required codepoint
+      # (total > 0) is covered. A language with total == 0 (empty exemplar
+      # set in the index) is reported as ratio 0.0, fully_supported false.
+      class LanguageCoverage < Lutaml::Model::Serializable
+        attribute :language,        :string
+        attribute :covered,         :integer
+        attribute :total,           :integer
+        attribute :coverage_ratio,  :float
+        attribute :fully_supported, Lutaml::Model::Type::Boolean
+
+        key_value do
+          map "language",        to: :language
+          map "covered",         to: :covered
+          map "total",           to: :total
+          map "coverage_ratio",  to: :coverage_ratio
+          map "fully_supported", to: :fully_supported
+        end
+      end
+    end
+  end
+end

data/lib/fontisan/models/cldr.rb

@@ -0,0 +1,12 @@
+# frozen_string_literal: true
+
+require "lutaml/model"
+
+module Fontisan
+  module Models
+    # Namespace for CLDR-derived audit models.
+    module Cldr
+      autoload :LanguageCoverage, "fontisan/models/cldr/language_coverage"
+    end
+  end
+end

data/lib/fontisan/models/collection_brief_info.rb

@@ -1,7 +1,6 @@
 # frozen_string_literal: true
 
 require "lutaml/model"
-require_relative "font_info"
 
 module Fontisan
   module Models

data/lib/fontisan/models/collection_info.rb

@@ -1,8 +1,6 @@
 # frozen_string_literal: true
 
 require "lutaml/model"
-require_relative "table_sharing_info"
-require_relative "font_info"
 
 module Fontisan
   module Models

data/lib/fontisan/models/collection_list_info.rb

@@ -1,7 +1,6 @@
 # frozen_string_literal: true
 
 require "lutaml/model"
-require_relative "collection_font_summary"
 
 module Fontisan
   module Models

data/lib/fontisan/models/collection_validation_report.rb

@@ -1,7 +1,5 @@
 # frozen_string_literal: true
 
-require_relative "font_report"
-require_relative "validation_report"
 require "lutaml/model"
 
 module Fontisan

data/lib/fontisan/models/color_glyph.rb

@@ -1,7 +1,6 @@
 # frozen_string_literal: true
 
 require "lutaml/model"
-require_relative "color_layer"
 
 module Fontisan
   module Models

data/lib/fontisan/models/font_report.rb

@@ -1,6 +1,5 @@
 # frozen_string_literal: true
 
-require_relative "validation_report"
 require "lutaml/model"
 
 module Fontisan

data/lib/fontisan/models/ttx/tables.rb

@@ -0,0 +1,21 @@
+# frozen_string_literal: true
+
+# Autoload hub for the Fontisan::Models::Ttx::Tables namespace.
+
+module Fontisan
+  module Models
+    module Ttx
+      module Tables
+        autoload :BinaryTable, "fontisan/models/ttx/tables/binary_table"
+        autoload :HeadTable, "fontisan/models/ttx/tables/head_table"
+        autoload :HheaTable, "fontisan/models/ttx/tables/hhea_table"
+        autoload :MaxpTable, "fontisan/models/ttx/tables/maxp_table"
+        autoload :NameRecord, "fontisan/models/ttx/tables/name_table"
+        autoload :NameTable, "fontisan/models/ttx/tables/name_table"
+        autoload :Os2Table, "fontisan/models/ttx/tables/os2_table"
+        autoload :Panose, "fontisan/models/ttx/tables/os2_table"
+        autoload :PostTable, "fontisan/models/ttx/tables/post_table"
+      end
+    end
+  end
+end

data/lib/fontisan/models/ttx/ttfont.rb

@@ -1,14 +1,6 @@
 # frozen_string_literal: true
 
 require "lutaml/model"
-require_relative "glyph_order"
-require_relative "tables/head_table"
-require_relative "tables/name_table"
-require_relative "tables/maxp_table"
-require_relative "tables/hhea_table"
-require_relative "tables/os2_table"
-require_relative "tables/post_table"
-require_relative "tables/binary_table"
 
 module Fontisan
   module Models

data/lib/fontisan/models/ttx.rb

@@ -0,0 +1,14 @@
+# frozen_string_literal: true
+
+# Autoload hub for the Fontisan::Models::Ttx namespace.
+
+module Fontisan
+  module Models
+    module Ttx
+      autoload :GlyphId, "fontisan/models/ttx/glyph_order"
+      autoload :GlyphOrder, "fontisan/models/ttx/glyph_order"
+      autoload :Tables, "fontisan/models/ttx/tables/os2_table"
+      autoload :TtFont, "fontisan/models/ttx/ttfont"
+    end
+  end
+end

data/lib/fontisan/models.rb

@@ -0,0 +1,47 @@
+# frozen_string_literal: true
+
+# Autoload hub for the Fontisan::Models namespace.
+
+module Fontisan
+  module Models
+    autoload :AllScriptsFeaturesInfo,
+             "fontisan/models/all_scripts_features_info"
+    autoload :AxisInfo, "fontisan/models/variable_font_info"
+    autoload :BitmapGlyph, "fontisan/models/bitmap_glyph"
+    autoload :BitmapStrike, "fontisan/models/bitmap_strike"
+    autoload :CollectionBriefInfo, "fontisan/models/collection_brief_info"
+    autoload :CollectionFontSummary, "fontisan/models/collection_font_summary"
+    autoload :CollectionInfo, "fontisan/models/collection_info"
+    autoload :CollectionListInfo, "fontisan/models/collection_list_info"
+    autoload :CollectionValidationReport,
+             "fontisan/models/collection_validation_report"
+    autoload :Cldr, "fontisan/models/cldr"
+    autoload :ColorGlyph, "fontisan/models/color_glyph"
+    autoload :ColorLayer, "fontisan/models/color_layer"
+    autoload :ColorPalette, "fontisan/models/color_palette"
+    autoload :FeatureRecord, "fontisan/models/features_info"
+    autoload :FeaturesInfo, "fontisan/models/features_info"
+    autoload :FontExport, "fontisan/models/font_export"
+    autoload :FontInfo, "fontisan/models/font_info"
+    autoload :FontReport, "fontisan/models/font_report"
+    autoload :FontSummary, "fontisan/models/font_summary"
+    autoload :GlyphInfo, "fontisan/models/glyph_info"
+    autoload :GlyphOutline, "fontisan/models/glyph_outline"
+    autoload :Hint, "fontisan/models/hint"
+    autoload :HintSet, "fontisan/models/hint"
+    autoload :InstanceInfo, "fontisan/models/variable_font_info"
+    autoload :OpticalSizeInfo, "fontisan/models/optical_size_info"
+    autoload :Outline, "fontisan/models/outline"
+    autoload :ScriptRecord, "fontisan/models/scripts_info"
+    autoload :ScriptsInfo, "fontisan/models/scripts_info"
+    autoload :SvgGlyph, "fontisan/models/svg_glyph"
+    autoload :TableEntry, "fontisan/models/table_info"
+    autoload :TableInfo, "fontisan/models/table_info"
+    autoload :TableSharingInfo, "fontisan/models/table_sharing_info"
+    autoload :Ttx, "fontisan/models/ttx/ttfont"
+    autoload :UnicodeMapping, "fontisan/models/unicode_mappings"
+    autoload :UnicodeMappings, "fontisan/models/unicode_mappings"
+    autoload :ValidationReport, "fontisan/models/validation_report"
+    autoload :VariableFontInfo, "fontisan/models/variable_font_info"
+  end
+end

data/lib/fontisan/open_type_collection.rb

@@ -1,7 +1,5 @@
 # frozen_string_literal: true
 
-require_relative "base_collection"
-
 module Fontisan
   # OpenType Collection domain object
   #
@@ -15,11 +13,16 @@ module Fontisan
   #     fonts = otc.extract_fonts(io)  # => [OpenTypeFont, OpenTypeFont, ...]
   #   end
   class OpenTypeCollection < BaseCollection
+    # High-level pipeline format identifier. Owned by the collection class
+    # so the conversion pipeline can dispatch without case statements (OCP).
+    #
+    # @return [Symbol] :otc
+    def format = :otc
+
     # Get the font class for OpenType collections
     #
     # @return [Class] OpenTypeFont class
     def self.font_class
-      require_relative "open_type_font"
       OpenTypeFont
     end
 
@@ -38,8 +41,6 @@ module Fontisan
     # @param io [IO] Open file handle to read fonts from
     # @return [Array<OpenTypeFont>] Array of font objects
     def extract_fonts(io)
-      require_relative "open_type_font"
-
       font_offsets.map do |offset|
         OpenTypeFont.from_collection(io, offset)
       end

data/lib/fontisan/open_type_font.rb

@@ -1,7 +1,5 @@
 # frozen_string_literal: true
 
-require_relative "sfnt_font"
-
 module Fontisan
   # OpenType Font domain object
   #
@@ -26,6 +24,14 @@ module Fontisan
   # @example Reading from TTC collection
   #   otf = OpenTypeFont.from_collection(io, offset)
   class OpenTypeFont < SfntFont
+    extend OpenTypeFontExtensions
+
+    # High-level pipeline format identifier. Owned by the font class so the
+    # conversion pipeline can dispatch without case statements (OCP).
+    #
+    # @return [Symbol] :otf
+    def format = :otf
+
     # Page cache for lazy loading (maps page_start_offset => page_data)
     attr_accessor :page_cache
 

data/lib/fontisan/open_type_font_extensions.rb

@@ -1,24 +1,25 @@
 # frozen_string_literal: true
 
 module Fontisan
-  # Extensions to OpenTypeFont for table-based construction
-  class OpenTypeFont
+  # Extension module for {OpenTypeFont} providing table-based construction.
+  #
+  # Extended into OpenTypeFont from +open_type_font.rb+ so that
+  # +OpenTypeFont.from_tables(...)+ is available whenever the class
+  # itself is loaded.
+  module OpenTypeFontExtensions
     # 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 [OpenTypeFont] 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