fontisan 0.2.17 → 0.2.22

data/lib/fontisan/models/audit/script_features.rb

@@ -0,0 +1,28 @@
+# frozen_string_literal: true
+
+require "lutaml/model"
+
+module Fontisan
+  module Models
+    module Audit
+      # Per-script breakdown of OpenType features.
+      #
+      # Pairs a script tag (e.g. "latn", "kana ") with the GSUB features
+      # and GPOS features that apply to it. The two collections are
+      # kept separate because substitution and positioning have different
+      # semantics — consumers answering "does this font support kerning
+      # for Latin?" want to look at GPOS only.
+      class ScriptFeatures < Lutaml::Model::Serializable
+        attribute :script,         :string
+        attribute :gsub_features,  :string, collection: true
+        attribute :gpos_features,  :string, collection: true
+
+        key_value do
+          map "script",        to: :script
+          map "gsub_features", to: :gsub_features
+          map "gpos_features", to: :gpos_features
+        end
+      end
+    end
+  end
+end

data/lib/fontisan/models/audit/variation_detail.rb

@@ -0,0 +1,44 @@
+# frozen_string_literal: true
+
+require "lutaml/model"
+
+module Fontisan
+  module Models
+    module Audit
+      # Variable-font detail for one face.
+      #
+      # Bundles everything fvar-derived (axes + named instances) with the
+      # presence flags for every variation side-table (avar/cvar/HVAR/VVAR/
+      # MVAR/gvar). Replaces the previous flat `axes` + `is_variable` pair
+      # on AuditReport for MECE cleanliness — a face is variable iff this
+      # object is non-nil.
+      #
+      # `axes` reuses the existing AuditAxis shape; `named_instances` is a
+      # parallel NamedInstance collection. The has_* booleans are presence
+      # checks only — they don't validate the table contents.
+      class VariationDetail < Lutaml::Model::Serializable
+        attribute :axes,            AuditAxis,      collection: true
+        attribute :named_instances, NamedInstance,  collection: true
+
+        # Variation side-table presence flags.
+        attribute :has_avar, Lutaml::Model::Type::Boolean # axis variation
+        attribute :has_cvar, Lutaml::Model::Type::Boolean # CVT variation
+        attribute :has_hvar, Lutaml::Model::Type::Boolean # horizontal metrics
+        attribute :has_vvar, Lutaml::Model::Type::Boolean # vertical metrics
+        attribute :has_mvar, Lutaml::Model::Type::Boolean # metrics variation
+        attribute :has_gvar, Lutaml::Model::Type::Boolean # glyph variation (TT)
+
+        key_value do
+          map "axes",            to: :axes
+          map "named_instances", to: :named_instances
+          map "has_avar", to: :has_avar
+          map "has_cvar", to: :has_cvar
+          map "has_hvar", to: :has_hvar
+          map "has_vvar", to: :has_vvar
+          map "has_mvar", to: :has_mvar
+          map "has_gvar", to: :has_gvar
+        end
+      end
+    end
+  end
+end

data/lib/fontisan/models/audit.rb

@@ -0,0 +1,33 @@
+# frozen_string_literal: true
+
+# Namespace hub for audit-related models.
+#
+# All Models::Audit::* constants are autoloaded from here.
+
+module Fontisan
+  module Models
+    module Audit
+      autoload :AuditBlock,  "fontisan/models/audit/audit_block"
+      autoload :AuditAxis,   "fontisan/models/audit/audit_axis"
+      autoload :AuditDiff,   "fontisan/models/audit/audit_diff"
+      autoload :AuditReport, "fontisan/models/audit/audit_report"
+      autoload :CodepointRange, "fontisan/models/audit/codepoint_range"
+      autoload :CodepointSetDiff, "fontisan/models/audit/codepoint_set_diff"
+      autoload :ColorCapabilities, "fontisan/models/audit/color_capabilities"
+      autoload :DuplicateGroup, "fontisan/models/audit/duplicate_group"
+      autoload :EmbeddingType, "fontisan/models/audit/embedding_type"
+      autoload :FieldChange, "fontisan/models/audit/field_change"
+      autoload :FsSelectionFlags, "fontisan/models/audit/fs_selection_flags"
+      autoload :GaspRange, "fontisan/models/audit/gasp_range"
+      autoload :Hinting, "fontisan/models/audit/hinting"
+      autoload :LibrarySummary, "fontisan/models/audit/library_summary"
+      autoload :Licensing, "fontisan/models/audit/licensing"
+      autoload :Metrics, "fontisan/models/audit/metrics"
+      autoload :NamedInstance, "fontisan/models/audit/named_instance"
+      autoload :OpenTypeLayout, "fontisan/models/audit/opentype_layout"
+      autoload :ScriptCoverageRow, "fontisan/models/audit/script_coverage_row"
+      autoload :ScriptFeatures, "fontisan/models/audit/script_features"
+      autoload :VariationDetail, "fontisan/models/audit/variation_detail"
+    end
+  end
+end

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/ucd/ucd.rb

@@ -0,0 +1,38 @@
+# frozen_string_literal: true
+
+require "lutaml/model"
+
+module Fontisan
+  module Models
+    module Ucd
+      # Root <ucd> element of the UCDXML flat file.
+      #
+      # The flat UCDXML file has the structure:
+      #
+      #   <ucd>
+      #     <description>...</description>
+      #     <last_revision date="2025-..." version="17.0.0" />
+      #     <char cp="0000" .../>
+      #     <char cp="0001" .../>
+      #     ...
+      #     <char first-cp="3400" last-cp="4DBF" .../>
+      #     ...
+      #   </ucd>
+      #
+      # The flat variant merges all per-category UCD files (Blocks.txt,
+      # Scripts.txt, UnicodeData.txt, etc.) into one stream of <char>
+      # elements. Roughly 340,000 entries for Unicode 17.0.0.
+      class Ucd < Lutaml::Model::Serializable
+        attribute :last_revision, :string
+        attribute :chars, UcdChar, collection: true
+
+        xml do
+          element "ucd"
+
+          map_element "last_revision", to: :last_revision
+          map_element "char", to: :chars
+        end
+      end
+    end
+  end
+end

data/lib/fontisan/models/ucd/ucd_char.rb

@@ -0,0 +1,67 @@
+# frozen_string_literal: true
+
+require "lutaml/model"
+
+module Fontisan
+  module Models
+    module Ucd
+      # Single <char> element from the UCDXML flat file.
+      #
+      # UCDXML uses two forms:
+      #   <char cp="0041" name="..." script="Latin" block="Basic Latin" .../>
+      #   <char first-cp="3400" last-cp="4DBF" name="..." script="Han" .../>
+      #
+      # The first form describes one codepoint. The second form describes a
+      # closed range of codepoints that share the same properties (used for
+      # CJK ideograph ranges where each codepoint would otherwise need its
+      # own <char> entry).
+      #
+      # Both forms can appear in the same document; `cp` is mutually
+      # exclusive with `first-cp`/`last-cp`.
+      class UcdChar < Lutaml::Model::Serializable
+        attribute :cp, :string
+        attribute :first_cp, :string
+        attribute :last_cp, :string
+        attribute :name, :string
+        attribute :general_category, :string
+        attribute :script, :string
+        attribute :block, :string
+        attribute :age, :string
+
+        xml do
+          element "char"
+
+          map_attribute "cp",               to: :cp
+          map_attribute "first-cp",         to: :first_cp
+          map_attribute "last-cp",          to: :last_cp
+          map_attribute "name",             to: :name
+          map_attribute "general-category", to: :general_category
+          map_attribute "script",           to: :script
+          map_attribute "block",            to: :block
+          map_attribute "age",              to: :age
+        end
+
+        # True if this entry describes a codepoint range rather than a
+        # single codepoint.
+        def range?
+          !first_cp.nil? && !last_cp.nil?
+        end
+
+        # The codepoints covered by this entry, as Integers.
+        # For a single-codepoint entry, returns a one-element array.
+        # For a range entry, returns the inclusive range as an array
+        # (caller should treat this lazily if the range is huge — CJK
+        # ranges can have tens of thousands of codepoints).
+        def codepoints
+          if range?
+            (first_cp.to_i(16)..last_cp.to_i(16)).to_a
+          elsif cp
+            [cp.to_i(16)]
+          else
+            []
+          end
+        end
+      end
+    end
+  end
+end

data/lib/fontisan/models/ucd.rb

@@ -0,0 +1,19 @@
+# frozen_string_literal: true
+
+require "lutaml/model"
+
+module Fontisan
+  module Models
+    # Namespace for UCDXML deserialization models.
+    #
+    # These classes deserialize the upstream UCDXML flat file
+    # (https://www.unicode.org/Public/<version>/ucdxml/ucd.all.flat.zip)
+    # into Ruby objects. They are used by Fontisan::Ucd::IndexBuilder to
+    # derive compact run-length-encoded indices for Unicode block and
+    # script lookup.
+    module Ucd
+      autoload :UcdChar, "fontisan/models/ucd/ucd_char"
+      autoload :Ucd,     "fontisan/models/ucd/ucd"
+    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 :Audit, "fontisan/models/audit"
+    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 :Ucd, "fontisan/models/ucd"
+    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

data/lib/fontisan/optimizers/pattern_analyzer.rb

@@ -1,7 +1,6 @@
 # frozen_string_literal: true
 
 require "stringio"
-require_relative "stack_tracker"
 
 module Fontisan
   module Optimizers

data/lib/fontisan/optimizers.rb

@@ -0,0 +1,14 @@
+# frozen_string_literal: true
+
+# Autoload hub for the Fontisan::Optimizers namespace.
+
+module Fontisan
+  module Optimizers
+    autoload :CharstringRewriter, "fontisan/optimizers/charstring_rewriter"
+    autoload :PatternAnalyzer, "fontisan/optimizers/pattern_analyzer"
+    autoload :StackTracker, "fontisan/optimizers/stack_tracker"
+    autoload :SubroutineBuilder, "fontisan/optimizers/subroutine_builder"
+    autoload :SubroutineGenerator, "fontisan/optimizers/subroutine_generator"
+    autoload :SubroutineOptimizer, "fontisan/optimizers/subroutine_optimizer"
+  end
+end

data/lib/fontisan/outline_extractor.rb

@@ -1,7 +1,5 @@
 # frozen_string_literal: true
 
-require_relative "models/glyph_outline"
-
 module Fontisan
   # Extracts glyph outlines from font tables
   #

data/lib/fontisan/parsers/dfont_parser.rb

@@ -1,7 +1,6 @@
 # frozen_string_literal: true
 
 require "bindata"
-require_relative "../error"
 
 module Fontisan
   module Parsers

data/lib/fontisan/parsers.rb

@@ -0,0 +1,10 @@
+# frozen_string_literal: true
+
+# Autoload hub for the Fontisan::Parsers namespace.
+
+module Fontisan
+  module Parsers
+    autoload :DfontParser, "fontisan/parsers/dfont_parser"
+    autoload :Tag, "fontisan/parsers/tag"
+  end
+end