fontisan 0.2.17 → 0.2.23

data/lib/fontisan/variation/tuple_variation_header.rb

@@ -1,7 +1,5 @@
 # frozen_string_literal: true
 
-require_relative "../binary/base_record"
-
 module Fontisan
   module Variation
     # Tuple variation header structure

data/lib/fontisan/variation/variable_svg_generator.rb

@@ -1,8 +1,5 @@
 # frozen_string_literal: true
 
-require_relative "instance_generator"
-require_relative "../converters/svg_generator"
-
 module Fontisan
   module Variation
     # Generates SVG fonts from variable fonts at specific coordinates

data/lib/fontisan/variation/variation_context.rb

@@ -1,8 +1,5 @@
 # frozen_string_literal: true
 
-require_relative "interpolator"
-require_relative "region_matcher"
-
 module Fontisan
   module Variation
     # Provides shared context for variation operations

data/lib/fontisan/variation/variation_preserver.rb

@@ -1,8 +1,5 @@
 # frozen_string_literal: true
 
-require_relative "variation_context"
-require_relative "../error"
-
 module Fontisan
   module Variation
     # Preserves variation data when converting between compatible font formats

data/lib/fontisan/variation.rb

@@ -0,0 +1,31 @@
+# frozen_string_literal: true
+
+# Autoload hub for the Fontisan::Variation namespace.
+
+module Fontisan
+  module Variation
+    autoload :BlendApplier, "fontisan/variation/blend_applier"
+    autoload :Cache, "fontisan/variation/cache"
+    autoload :CacheKeyBuilder, "fontisan/variation/cache_key_builder"
+    autoload :Converter, "fontisan/variation/converter"
+    autoload :DataExtractor, "fontisan/variation/data_extractor"
+    autoload :DeltaApplier, "fontisan/variation/delta_applier"
+    autoload :DeltaParser, "fontisan/variation/delta_parser"
+    autoload :Inspector, "fontisan/variation/inspector"
+    autoload :InstanceGenerator, "fontisan/variation/instance_generator"
+    autoload :InstanceWriter, "fontisan/variation/instance_writer"
+    autoload :Interpolator, "fontisan/variation/interpolator"
+    autoload :MetricsAdjuster, "fontisan/variation/metrics_adjuster"
+    autoload :Optimizer, "fontisan/variation/optimizer"
+    autoload :ParallelGenerator, "fontisan/variation/parallel_generator"
+    autoload :RegionMatcher, "fontisan/variation/region_matcher"
+    autoload :Subsetter, "fontisan/variation/subsetter"
+    autoload :TableAccessor, "fontisan/variation/table_accessor"
+    autoload :ThreadSafeCache, "fontisan/variation/cache"
+    autoload :TupleVariationHeader, "fontisan/variation/tuple_variation_header"
+    autoload :Validator, "fontisan/variation/validator"
+    autoload :VariableSvgGenerator, "fontisan/variation/variable_svg_generator"
+    autoload :VariationContext, "fontisan/variation/variation_context"
+    autoload :VariationPreserver, "fontisan/variation/variation_preserver"
+  end
+end

data/lib/fontisan/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Fontisan
-  VERSION = "0.2.17"
+  VERSION = "0.2.23"
 end

data/lib/fontisan/woff2.rb

@@ -0,0 +1,13 @@
+# frozen_string_literal: true
+
+# Autoload hub for the Fontisan::Woff2 namespace.
+
+module Fontisan
+  module Woff2
+    autoload :Directory, "fontisan/woff2/directory"
+    autoload :GlyfTransformer, "fontisan/woff2/glyf_transformer"
+    autoload :HmtxTransformer, "fontisan/woff2/hmtx_transformer"
+    autoload :TableTransformer, "fontisan/woff2/table_transformer"
+    autoload :Woff2Header, "fontisan/woff2/header"
+  end
+end

data/lib/fontisan/woff2_font.rb

@@ -3,15 +3,6 @@
 require "bindata"
 require "brotli"
 require "stringio"
-require_relative "constants"
-require_relative "loading_modes"
-require_relative "utilities/checksum_calculator"
-require_relative "woff2/header"
-require_relative "woff2/glyf_transformer"
-require_relative "woff2/hmtx_transformer"
-require_relative "true_type_font"
-require_relative "open_type_font"
-require_relative "error"
 
 module Fontisan
   # WOFF2 Table Directory Entry structure
@@ -82,6 +73,12 @@ module Fontisan
   #   puts font.header.flavor
   #   puts font.table_names
   class Woff2Font
+    # High-level pipeline format identifier. Owned by the font class so the
+    # conversion pipeline can dispatch without case statements (OCP).
+    #
+    # @return [Symbol] :woff2
+    def format = :woff2
+
     # Simple struct for storing file path
     IOSource = Struct.new(:path)
 
@@ -145,6 +142,31 @@ module Fontisan
       @table_entries.any? { |entry| entry.tag == tag }
     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. WOFF2 wraps a single SFNT font; variation tables, if
+    # present on the wrapped font, are reported here.
+    #
+    # @return [Symbol] :static, :gvar, or :cff2
+    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, derived from the wrapped SFNT flavor.
+    #
+    # @return [Symbol] :truetype or :cff
+    def outline_type
+      truetype? ? :truetype : :cff
+    end
+
     # Find table entry by tag
     def find_table_entry(tag)
       @table_entries.find { |entry| entry.tag == tag }

data/lib/fontisan/woff_font.rb

@@ -2,8 +2,6 @@
 
 require "bindata"
 require "zlib"
-require_relative "constants"
-require_relative "utilities/checksum_calculator"
 
 module Fontisan
   # WOFF Header structure
@@ -55,6 +53,12 @@ module Fontisan
   #   woff.to_ttf("output.ttf")  # if TrueType flavored
   #   woff.to_otf("output.otf")  # if CFF flavored
   class WoffFont < BinData::Record
+    # High-level pipeline format identifier. Owned by the font class so the
+    # conversion pipeline can dispatch without case statements (OCP).
+    #
+    # @return [Symbol] :woff
+    def format = :woff
+
     endian :big
 
     woff_header :header
@@ -142,6 +146,31 @@ module Fontisan
       end
     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. WOFF wraps a single SFNT font; variation tables, if
+    # present on the wrapped font, are reported here.
+    #
+    # @return [Symbol] :static, :gvar, or :cff2
+    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, derived from the wrapped SFNT flavor.
+    #
+    # @return [Symbol] :truetype or :cff
+    def outline_type
+      truetype? ? :truetype : :cff
+    end
+
     # Check if font is TrueType flavored
     #
     # @return [Boolean] true if TrueType, false if CFF

data/lib/fontisan.rb

@@ -39,203 +39,93 @@ Lutaml::Model::Config.configure do |config|
   config.xml_adapter_type = :nokogiri
 end
 
-# Core
-require_relative "fontisan/version"
-require_relative "fontisan/error"
-require_relative "fontisan/constants"
-
-# Binary structures and parsers
-require_relative "fontisan/parsers/tag"
-require_relative "fontisan/binary/base_record"
-
-# Table parsers
-require_relative "fontisan/tables/head"
-require_relative "fontisan/tables/hhea"
-require_relative "fontisan/tables/hmtx"
-require_relative "fontisan/tables/maxp"
-require_relative "fontisan/tables/loca"
-require_relative "fontisan/tables/glyf"
-require_relative "fontisan/tables/name"
-require_relative "fontisan/tables/os2"
-require_relative "fontisan/tables/post"
-require_relative "fontisan/tables/cmap"
-require_relative "fontisan/tables/fvar"
-require_relative "fontisan/tables/variation_common"
-require_relative "fontisan/tables/hvar"
-require_relative "fontisan/tables/vvar"
-require_relative "fontisan/tables/mvar"
-require_relative "fontisan/tables/gvar"
-require_relative "fontisan/tables/cvar"
-require_relative "fontisan/tables/cff"
-require_relative "fontisan/tables/layout_common"
-require_relative "fontisan/tables/gsub"
-require_relative "fontisan/tables/gpos"
-require_relative "fontisan/tables/colr"
-require_relative "fontisan/tables/cpal"
-require_relative "fontisan/tables/svg"
-require_relative "fontisan/tables/sbix"
-require_relative "fontisan/tables/cblc"
-require_relative "fontisan/tables/cbdt"
-
-# Domain objects (BinData::Record)
-require_relative "fontisan/true_type_font"
-require_relative "fontisan/open_type_font"
-require_relative "fontisan/true_type_collection"
-require_relative "fontisan/open_type_collection"
-require_relative "fontisan/woff_font"
-require_relative "fontisan/woff2_font"
-require_relative "fontisan/type1_font"
-
-# Font extensions for table-based construction
-require_relative "fontisan/true_type_font_extensions"
-require_relative "fontisan/open_type_font_extensions"
-
-# Font loading
-require_relative "fontisan/font_loader"
-
-# Utilities
-require_relative "fontisan/metrics_calculator"
-require_relative "fontisan/glyph_accessor"
-require_relative "fontisan/outline_extractor"
-require_relative "fontisan/utilities/checksum_calculator"
-require_relative "fontisan/font_writer"
-
-# Information models (Lutaml::Model)
-require_relative "fontisan/models/bitmap_strike"
-require_relative "fontisan/models/bitmap_glyph"
-require_relative "fontisan/models/font_info"
-require_relative "fontisan/models/table_info"
-require_relative "fontisan/models/glyph_info"
-require_relative "fontisan/models/glyph_outline"
-require_relative "fontisan/models/unicode_mappings"
-require_relative "fontisan/models/variable_font_info"
-require_relative "fontisan/models/optical_size_info"
-require_relative "fontisan/models/scripts_info"
-require_relative "fontisan/models/features_info"
-require_relative "fontisan/models/all_scripts_features_info"
-require_relative "fontisan/models/validation_report"
-require_relative "fontisan/models/font_report"
-require_relative "fontisan/models/collection_validation_report"
-require_relative "fontisan/models/font_export"
-require_relative "fontisan/models/collection_font_summary"
-require_relative "fontisan/models/collection_info"
-require_relative "fontisan/models/collection_brief_info"
-require_relative "fontisan/models/collection_list_info"
-require_relative "fontisan/models/font_summary"
-require_relative "fontisan/models/table_sharing_info"
-require_relative "fontisan/models/color_glyph"
-require_relative "fontisan/models/color_layer"
-require_relative "fontisan/models/color_palette"
-require_relative "fontisan/models/svg_glyph"
-
-# Validators infrastructure (NEW - DSL-based framework from Week 2+)
-require_relative "fontisan/validators/validator"
-require_relative "fontisan/validators/basic_validator"
-require_relative "fontisan/validators/font_book_validator"
-require_relative "fontisan/validators/opentype_validator"
-require_relative "fontisan/validators/web_font_validator"
-require_relative "fontisan/validators/profile_loader"
-
-# Export infrastructure
-require_relative "fontisan/export/table_serializer"
-require_relative "fontisan/export/ttx_generator"
-require_relative "fontisan/export/ttx_parser"
-require_relative "fontisan/export/exporter"
-
-# Validation infrastructure (OLD - commented out for new DSL framework)
-# Week 1 deleted these, Week 2-5 building new DSL-based framework
-# require_relative "fontisan/validation/checks/base_check"
-# require_relative "fontisan/validation/check_registry"
-# require_relative "fontisan/validation/profile"
-# require_relative "fontisan/validation/table_validator"
-# require_relative "fontisan/validation/structure_validator"
-# require_relative "fontisan/validation/consistency_validator"
-# require_relative "fontisan/validation/checksum_validator"
-# require_relative "fontisan/validation/validator"
-
-# Subsetting infrastructure
-require_relative "fontisan/subset/options"
-require_relative "fontisan/subset/profile"
-require_relative "fontisan/subset/glyph_mapping"
-require_relative "fontisan/subset/table_subsetter"
-require_relative "fontisan/subset/builder"
-
-# Collection infrastructure
-require_relative "fontisan/collection/table_analyzer"
-require_relative "fontisan/collection/table_deduplicator"
-require_relative "fontisan/collection/offset_calculator"
-require_relative "fontisan/collection/writer"
-require_relative "fontisan/collection/builder"
-
-# Format conversion infrastructure
-require_relative "fontisan/conversion_options"
-require_relative "fontisan/converters/conversion_strategy"
-require_relative "fontisan/converters/table_copier"
-require_relative "fontisan/converters/outline_converter"
-require_relative "fontisan/converters/format_converter"
-
-# Variation infrastructure
-require_relative "fontisan/variation/interpolator"
-require_relative "fontisan/variation/region_matcher"
-require_relative "fontisan/variation/data_extractor"
-require_relative "fontisan/variation/instance_generator"
-require_relative "fontisan/variation/metrics_adjuster"
-require_relative "fontisan/variation/converter"
-require_relative "fontisan/variation/variation_preserver"
-require_relative "fontisan/variation/delta_parser"
-require_relative "fontisan/variation/delta_applier"
-require_relative "fontisan/variation/blend_applier"
-require_relative "fontisan/variation/variable_svg_generator"
-
-# Pipeline infrastructure
-require_relative "fontisan/pipeline/format_detector"
-require_relative "fontisan/pipeline/variation_resolver"
-require_relative "fontisan/pipeline/output_writer"
-require_relative "fontisan/pipeline/transformation_pipeline"
-
-# Optimization infrastructure
-require_relative "fontisan/optimizers/pattern_analyzer"
-require_relative "fontisan/optimizers/subroutine_builder"
-require_relative "fontisan/optimizers/charstring_rewriter"
-require_relative "fontisan/optimizers/subroutine_optimizer"
-require_relative "fontisan/optimizers/subroutine_generator"
-
-# Hints infrastructure
-require_relative "fontisan/models/hint"
-require_relative "fontisan/hints/truetype_instruction_analyzer"
-require_relative "fontisan/hints/truetype_instruction_generator"
-require_relative "fontisan/hints/truetype_hint_extractor"
-require_relative "fontisan/hints/truetype_hint_applier"
-require_relative "fontisan/hints/postscript_hint_extractor"
-require_relative "fontisan/hints/postscript_hint_applier"
-require_relative "fontisan/hints/hint_converter"
-require_relative "fontisan/hints/hint_validator"
-
-# Commands
-require_relative "fontisan/commands/base_command"
-require_relative "fontisan/commands/info_command"
-require_relative "fontisan/commands/ls_command"
-require_relative "fontisan/commands/tables_command"
-require_relative "fontisan/commands/glyphs_command"
-require_relative "fontisan/commands/unicode_command"
-require_relative "fontisan/commands/variable_command"
-require_relative "fontisan/commands/optical_size_command"
-require_relative "fontisan/commands/scripts_command"
-require_relative "fontisan/commands/features_command"
-require_relative "fontisan/commands/dump_table_command"
-require_relative "fontisan/commands/subset_command"
-require_relative "fontisan/commands/convert_command"
-require_relative "fontisan/commands/pack_command"
-require_relative "fontisan/commands/unpack_command"
-require_relative "fontisan/commands/validate_command"
-
-# Formatters
-require_relative "fontisan/formatters/text_formatter"
-
-# CLI
-require_relative "fontisan/cli"
-
 module Fontisan
+  #
+  # Each namespace under Fontisan has a hub file at lib/fontisan/<ns>.rb
+  # that declares autoloads for its children. This file autoloads those
+  # hubs plus the flat Fontisan::* classes. Files are loaded lazily on
+  # first reference.
+
+  # Core
+  require "fontisan/version"
+  autoload :Constants, "fontisan/constants"
+  autoload :LoadingModes, "fontisan/loading_modes"
+  autoload :ConversionOptions, "fontisan/conversion_options"
+
+  # Errors (all defined in fontisan/error)
+  autoload :Error, "fontisan/error"
+  autoload :InvalidFontError, "fontisan/error"
+  autoload :UnsupportedFormatError, "fontisan/error"
+  autoload :CorruptedTableError, "fontisan/error"
+  autoload :MissingTableError, "fontisan/error"
+  autoload :ParseError, "fontisan/error"
+  autoload :SubsettingError, "fontisan/error"
+  autoload :VariationError, "fontisan/error"
+  autoload :InvalidCoordinatesError, "fontisan/error"
+  autoload :MissingVariationTableError, "fontisan/error"
+  autoload :InvalidAxisError, "fontisan/error"
+  autoload :RegionOverlapError, "fontisan/error"
+  autoload :DeltaMismatchError, "fontisan/error"
+  autoload :InvalidInstanceIndexError, "fontisan/error"
+  autoload :CorruptedVariationDataError, "fontisan/error"
+  autoload :InvalidVariationDataError, "fontisan/error"
+  autoload :VariationDataCorruptedError, "fontisan/error"
+
+  # Namespace hubs (each hub declares its own child autoloads)
+  autoload :Binary, "fontisan/binary"
+  autoload :Cldr, "fontisan/cldr"
+  autoload :Collection, "fontisan/collection"
+  autoload :Commands, "fontisan/commands"
+  autoload :Converters, "fontisan/converters"
+  autoload :Export, "fontisan/export"
+  autoload :Formatters, "fontisan/formatters"
+  autoload :Hints, "fontisan/hints"
+  autoload :Models, "fontisan/models"
+  autoload :Optimizers, "fontisan/optimizers"
+  autoload :Parsers, "fontisan/parsers"
+  autoload :Pipeline, "fontisan/pipeline"
+  autoload :Subset, "fontisan/subset"
+  autoload :Svg, "fontisan/svg"
+  autoload :Tables, "fontisan/tables"
+  autoload :Type1, "fontisan/type1"
+  autoload :Utilities, "fontisan/utilities"
+  autoload :Utils, "fontisan/utils"
+  autoload :Validation, "fontisan/validation"
+  autoload :Validators, "fontisan/validators"
+  autoload :Variable, "fontisan/variable"
+  autoload :Variation, "fontisan/variation"
+  autoload :Woff2, "fontisan/woff2"
+
+  # Flat classes (no inner namespace)
+  autoload :BaseCollection, "fontisan/base_collection"
+  autoload :Cli, "fontisan/cli"
+  autoload :DfontCollection, "fontisan/dfont_collection"
+  autoload :FontLoader, "fontisan/font_loader"
+  autoload :FontWriter, "fontisan/font_writer"
+  autoload :GlyphAccessor, "fontisan/glyph_accessor"
+  autoload :MetricsCalculator, "fontisan/metrics_calculator"
+  autoload :OpenTypeCollection, "fontisan/open_type_collection"
+  autoload :OpenTypeFont, "fontisan/open_type_font"
+  autoload :OpenTypeFontExtensions, "fontisan/open_type_font_extensions"
+  autoload :OutlineExtractor, "fontisan/outline_extractor"
+  autoload :SfntFont, "fontisan/sfnt_font"
+  autoload :SfntTable, "fontisan/sfnt_table"
+  autoload :TrueTypeCollection, "fontisan/true_type_collection"
+  autoload :TrueTypeFont, "fontisan/true_type_font"
+  autoload :TrueTypeFontExtensions, "fontisan/true_type_font_extensions"
+  autoload :Type1Font, "fontisan/type1_font"
+  autoload :CldrCli, "fontisan/cli/cldr_cli"
+  autoload :Woff2Font, "fontisan/woff2_font"
+  autoload :WoffFont, "fontisan/woff_font"
+
+  # SFNT offset table and table directory (defined in sfnt_font.rb)
+  autoload :OffsetTable, "fontisan/sfnt_font"
+  autoload :TableDirectory, "fontisan/sfnt_font"
+
+  # WOFF headers and table directory entries
+  autoload :WoffHeader, "fontisan/woff_font"
+  autoload :WoffTableDirectoryEntry, "fontisan/woff_font"
+  autoload :Woff2TableDirectoryEntry, "fontisan/woff2_font"
   class << self
     attr_accessor :logger
 
@@ -279,6 +169,41 @@ module Fontisan
     Commands::InfoCommand.new(path, brief: brief, font_index: font_index).run
   end
 
+  # Convert a font to a different format.
+  #
+  # Delegates to {Commands::ConvertCommand}. Format-specific compression knobs
+  # are declared by each strategy (single source of truth) and forwarded
+  # through the transformation pipeline.
+  #
+  # WOFF uses zlib and runs on every browser that supports web fonts (IE9+,
+  # all evergreen browsers). WOFF2 uses Brotli for ~30% smaller output but
+  # requires modern browsers — use WOFF when legacy support matters.
+  #
+  # @param path [String] Input font file
+  # @param to [Symbol, String] Target format: :ttf, :otf, :type1, :woff,
+  #   :woff2, :svg, :ttc, :otc, :dfont
+  # @param output [String] Output font file path
+  # @param opts [Hash] Conversion options. Format-specific knobs:
+  #   - WOFF:  :zlib_level (0–9, default 6), :uncompressed (bool),
+  #     :compression_threshold (bytes)
+  #   - WOFF2: :brotli_quality (0–11, default 11), :transform_tables (bool)
+  #   - Variable fonts: :coordinates, :instance_index, :preserve_variation
+  #   - Collections: :target_format ("preserve"|"ttf"|"otf")
+  # @return [Hash] Result hash with :success, :output_path, source/target
+  #   format, input/output sizes, and variation strategy.
+  #
+  # @example TTF → WOFF2 (modern browsers)
+  #   Fontisan.convert("f.ttf", to: :woff2, output: "f.woff2", brotli_quality: 11)
+  #
+  # @example TTF → WOFF (legacy browsers, max zlib)
+  #   Fontisan.convert("f.ttf", to: :woff, output: "f.woff", zlib_level: 9)
+  #
+  # @example WOFF with no compression (legal per WOFF 1.0 §5.1)
+  #   Fontisan.convert("f.ttf", to: :woff, output: "f.woff", uncompressed: true)
+  def self.convert(path, to:, output:, **)
+    Commands::ConvertCommand.new(path, { to: to, output: output, ** }).run
+  end
+
   # Validate a font file using specified profile
   #
   # Validates fonts against quality checks, structural integrity, and OpenType