fontisan 0.2.4 → 0.2.6

data/lib/fontisan/validators/font_book_validator.rb

@@ -0,0 +1,130 @@
+# frozen_string_literal: true
+
+require_relative "basic_validator"
+
+module Fontisan
+  module Validators
+    # FontBookValidator provides macOS Font Book installation compatibility checks
+    #
+    # This validator extends BasicValidator with additional checks needed for
+    # fonts to be successfully installed and used in macOS Font Book. It ensures
+    # proper encoding combinations, OS/2 metrics, and other macOS-specific
+    # requirements.
+    #
+    # The validator inherits all 8 checks from BasicValidator and adds 12 new
+    # checks focusing on:
+    # - Name table encoding combinations (Windows and Mac)
+    # - OS/2 table metrics and metadata
+    # - Head table bounding box
+    # - Hhea table metrics
+    # - Post table metadata
+    # - Cmap subtables
+    #
+    # @example Using FontBookValidator
+    #   validator = FontBookValidator.new
+    #   report = validator.validate(font)
+    #   puts "Font is Font Book compatible" if report.valid?
+    class FontBookValidator < BasicValidator
+      private
+
+      # Define Font Book compatibility checks
+      #
+      # Calls super to inherit BasicValidator's 8 checks, then adds 12 new checks.
+      # All checks use helpers from Week 1 table implementations.
+      def define_checks
+        # Inherit BasicValidator checks (8 checks)
+        super
+
+        # Check 9: Name table Windows Unicode English encoding
+        check_table :name_windows_encoding, 'name', severity: :error do |table|
+          table.has_valid_platform_combos?([3, 1, 0x0409]) # Windows Unicode English
+        end
+
+        # Check 10: Name table Mac Roman English encoding
+        check_table :name_mac_encoding, 'name', severity: :warning do |table|
+          table.has_valid_platform_combos?([1, 0, 0]) # Mac Roman English
+        end
+
+        # Check 11: OS/2 table version must be valid
+        check_table :os2_version, 'OS/2', severity: :error do |table|
+          table.valid_version?
+        end
+
+        # Check 12: OS/2 weight class must be valid (1-1000)
+        check_table :os2_weight_class, 'OS/2', severity: :error do |table|
+          table.valid_weight_class?
+        end
+
+        # Check 13: OS/2 width class must be valid (1-9)
+        check_table :os2_width_class, 'OS/2', severity: :error do |table|
+          table.valid_width_class?
+        end
+
+        # Check 14: OS/2 vendor ID should be present
+        check_table :os2_vendor_id, 'OS/2', severity: :warning do |table|
+          table.has_vendor_id?
+        end
+
+        # Check 15: OS/2 PANOSE classification should be present
+        check_table :os2_panose, 'OS/2', severity: :info do |table|
+          table.has_panose?
+        end
+
+        # Check 16: OS/2 typographic metrics must be valid
+        check_table :os2_typo_metrics, 'OS/2', severity: :error do |table|
+          table.valid_typo_metrics?
+        end
+
+        # Check 17: OS/2 Windows metrics must be valid
+        check_table :os2_win_metrics, 'OS/2', severity: :error do |table|
+          table.valid_win_metrics?
+        end
+
+        # Check 18: OS/2 Unicode ranges should be present
+        check_table :os2_unicode_ranges, 'OS/2', severity: :warning do |table|
+          table.has_unicode_ranges?
+        end
+
+        # Check 19: Head table bounding box must be valid
+        check_table :head_bounding_box, 'head', severity: :error do |table|
+          table.valid_bounding_box?
+        end
+
+        # Check 20: Hhea ascent/descent must be valid
+        check_table :hhea_ascent_descent, 'hhea', severity: :error do |table|
+          table.valid_ascent_descent?
+        end
+
+        # Check 21: Hhea line gap should be valid
+        check_table :hhea_line_gap, 'hhea', severity: :warning do |table|
+          table.valid_line_gap?
+        end
+
+        # Check 22: Hhea horizontal metrics count must be valid
+        check_table :hhea_metrics_count, 'hhea', severity: :error do |table|
+          table.valid_number_of_h_metrics?
+        end
+
+        # Check 23: Post table version must be valid
+        check_table :post_version, 'post', severity: :error do |table|
+          table.valid_version?
+        end
+
+        # Check 24: Post table italic angle should be valid
+        check_table :post_italic_angle, 'post', severity: :warning do |table|
+          table.valid_italic_angle?
+        end
+
+        # Check 25: Post table underline metrics should be present
+        check_table :post_underline, 'post', severity: :info do |table|
+          table.has_underline_metrics?
+        end
+
+        # Check 26: Cmap table must have subtables
+        check_table :cmap_subtables, 'cmap', severity: :error do |table|
+          table.has_subtables?
+        end
+      end
+    end
+  end
+end

data/lib/fontisan/validators/opentype_validator.rb

@@ -0,0 +1,112 @@
+# frozen_string_literal: true
+
+require_relative "font_book_validator"
+
+module Fontisan
+  module Validators
+    # OpenTypeValidator provides comprehensive OpenType specification compliance checks
+    #
+    # This validator extends FontBookValidator with additional checks ensuring full
+    # OpenType specification compliance. It validates glyph data, character mappings,
+    # and cross-table consistency.
+    #
+    # The validator inherits all checks from FontBookValidator (18 checks from
+    # FontBookValidator + 8 from BasicValidator = 26 total) and adds 10 new checks:
+    # - Maxp TrueType metrics validation
+    # - Glyf table structure and accessibility
+    # - Cmap Unicode mapping and coverage
+    # - Cross-table consistency checks
+    #
+    # @example Using OpenTypeValidator
+    #   validator = OpenTypeValidator.new
+    #   report = validator.validate(font)
+    #   puts "Font is OpenType compliant" if report.valid?
+    class OpenTypeValidator < FontBookValidator
+      private
+
+      # Define OpenType specification compliance checks
+      #
+      # Calls super to inherit FontBookValidator's checks, then adds 10 new checks.
+      # All checks use helpers from Week 1 table implementations.
+      def define_checks
+        # Inherit FontBookValidator checks (26 checks total)
+        super
+
+        # Check 27: Maxp TrueType metrics (only for version 1.0)
+        check_table :maxp_truetype_metrics, 'maxp', severity: :warning do |table|
+          !table.version_1_0? || table.has_truetype_metrics?
+        end
+
+        # Check 28: Maxp max zones must be valid
+        check_table :maxp_zones, 'maxp', severity: :error do |table|
+          table.valid_max_zones?
+        end
+
+        # Check 29: Glyf glyphs must be accessible (TrueType fonts only)
+        check_glyphs :glyf_accessible, severity: :error do |font|
+          glyf = font.table('glyf')
+          next true unless glyf # Skip if CFF font
+
+          loca = font.table('loca')
+          head = font.table('head')
+          maxp = font.table('maxp')
+          glyf.all_glyphs_accessible?(loca, head, maxp.num_glyphs)
+        end
+
+        # Check 30: Glyf glyphs should not be clipped
+        check_glyphs :glyf_no_clipping, severity: :warning do |font|
+          glyf = font.table('glyf')
+          next true unless glyf
+
+          loca = font.table('loca')
+          head = font.table('head')
+          maxp = font.table('maxp')
+          glyf.no_clipped_glyphs?(loca, head, maxp.num_glyphs)
+        end
+
+        # Check 31: Glyf contour counts must be valid
+        check_glyphs :glyf_valid_contours, severity: :error do |font|
+          glyf = font.table('glyf')
+          next true unless glyf
+
+          loca = font.table('loca')
+          head = font.table('head')
+          maxp = font.table('maxp')
+
+          (0...maxp.num_glyphs).all? do |glyph_id|
+            glyf.valid_contour_count?(glyph_id, loca, head)
+          end
+        end
+
+        # Check 32: Cmap must have Unicode mapping
+        check_table :cmap_unicode_mapping, 'cmap', severity: :error do |table|
+          table.has_unicode_mapping?
+        end
+
+        # Check 33: Cmap should have BMP coverage
+        check_table :cmap_bmp_coverage, 'cmap', severity: :warning do |table|
+          table.has_bmp_coverage?
+        end
+
+        # Check 34: Cmap must have format 4 subtable
+        check_table :cmap_format4, 'cmap', severity: :error do |table|
+          table.has_format_4_subtable?
+        end
+
+        # Check 35: Cmap glyph indices must be valid
+        check_structure :cmap_glyph_indices, severity: :error do |font|
+          cmap = font.table('cmap')
+          maxp = font.table('maxp')
+          cmap.valid_glyph_indices?(maxp.num_glyphs)
+        end
+
+        # Check 36: Table checksums (info level - many fonts have mismatches)
+        check_structure :checksum_valid, severity: :info do |font|
+          # Table checksum validation (info level - for reference)
+          # Most fonts have checksum mismatches, so we make it info not error
+          true # Placeholder - actual checksum validation if desired
+        end
+      end
+    end
+  end
+end

data/lib/fontisan/validators/profile_loader.rb

@@ -0,0 +1,139 @@
+# frozen_string_literal: true
+
+require_relative "basic_validator"
+require_relative "font_book_validator"
+require_relative "opentype_validator"
+require_relative "web_font_validator"
+
+module Fontisan
+  module Validators
+    # ProfileLoader manages validation profiles and loads appropriate validators
+    #
+    # This class provides a registry of validation profiles, each configured for
+    # specific use cases. Profiles define which validator to use, loading mode,
+    # and severity thresholds.
+    #
+    # Available profiles:
+    # - indexability: Fast validation for font discovery (BasicValidator)
+    # - usability: Basic usability for installation (FontBookValidator)
+    # - production: Comprehensive quality checks (OpenTypeValidator)
+    # - web: Web embedding and optimization (WebFontValidator)
+    # - spec_compliance: Full OpenType spec compliance (OpenTypeValidator)
+    # - default: Alias for production profile
+    #
+    # @example Loading a profile
+    #   validator = ProfileLoader.load(:production)
+    #   report = validator.validate(font)
+    #
+    # @example Getting profile info
+    #   info = ProfileLoader.profile_info(:web)
+    #   puts info[:description]
+    class ProfileLoader
+      # Profile definitions (hardcoded, no YAML)
+      PROFILES = {
+        indexability: {
+          name: "Font Indexability",
+          description: "Fast validation for font discovery and indexing",
+          validator: "BasicValidator",
+          loading_mode: "metadata",
+          severity_threshold: "error",
+        },
+        usability: {
+          name: "Font Usability",
+          description: "Basic usability for installation",
+          validator: "FontBookValidator",
+          loading_mode: "full",
+          severity_threshold: "warning",
+        },
+        production: {
+          name: "Production Quality",
+          description: "Comprehensive quality checks",
+          validator: "OpenTypeValidator",
+          loading_mode: "full",
+          severity_threshold: "warning",
+        },
+        web: {
+          name: "Web Font Readiness",
+          description: "Web embedding and optimization",
+          validator: "WebFontValidator",
+          loading_mode: "full",
+          severity_threshold: "warning",
+        },
+        spec_compliance: {
+          name: "OpenType Specification",
+          description: "Full OpenType spec compliance",
+          validator: "OpenTypeValidator",
+          loading_mode: "full",
+          severity_threshold: "info",
+        },
+        default: {
+          name: "Default Profile",
+          description: "Default validation profile (alias for production)",
+          validator: "OpenTypeValidator",
+          loading_mode: "full",
+          severity_threshold: "warning",
+        },
+      }.freeze
+
+      class << self
+        # Load a validator for the specified profile
+        #
+        # @param profile_name [Symbol, String] Profile name
+        # @return [Validator] Validator instance for the profile
+        # @raise [ArgumentError] if profile name is unknown
+        #
+        # @example Load production validator
+        #   validator = ProfileLoader.load(:production)
+        def load(profile_name)
+          profile_name = profile_name.to_sym
+          profile_config = PROFILES[profile_name]
+
+          unless profile_config
+            raise ArgumentError,
+                  "Unknown profile: #{profile_name}. " \
+                  "Available profiles: #{available_profiles.join(', ')}"
+          end
+
+          validator_class_name = profile_config[:validator]
+          validator_class = Validators.const_get(validator_class_name)
+          validator_class.new
+        end
+
+        # Get list of available profile names
+        #
+        # @return [Array<Symbol>] Array of profile names
+        #
+        # @example List available profiles
+        #   ProfileLoader.available_profiles
+        #   # => [:indexability, :usability, :production, :web, :spec_compliance, :default]
+        def available_profiles
+          PROFILES.keys
+        end
+
+        # Get profile configuration
+        #
+        # @param profile_name [Symbol, String] Profile name
+        # @return [Hash, nil] Profile configuration or nil if not found
+        #
+        # @example Get profile info
+        #   info = ProfileLoader.profile_info(:web)
+        #   puts info[:description]
+        def profile_info(profile_name)
+          PROFILES[profile_name.to_sym]
+        end
+
+        # Get all profiles with their configurations
+        #
+        # @return [Hash] All profile configurations
+        #
+        # @example Get all profiles
+        #   ProfileLoader.all_profiles.each do |name, config|
+        #     puts "#{name}: #{config[:description]}"
+        #   end
+        def all_profiles
+          PROFILES
+        end
+      end
+    end
+  end
+end