fontist 3.0.6 → 3.0.8

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 901ef91ebd6bdc2f41e97ecad10c4fe2e752f9b5dff6faa2d75a8d9065bea478
-  data.tar.gz: b793fbea7abd2f98fb8334682238b7e8f34168b69509a3641196799bf1b171b0
+  metadata.gz: 83651351d9e3e1b81441f082b60ca4d9583a643e69dc0ce33e313ab2be4063be
+  data.tar.gz: c45afceafa8580fec964069c14aa4f0e7326ed9c9b4cee922425146763785cbc
 SHA512:
-  metadata.gz: a3e4427e15dd34aecfb531bc1a25e980351c24d32515f58723b731ff0fa11467d450c3ef24feaf1661b23d5035147758d9cead9828c2a468e23ecc2230afa0bc
-  data.tar.gz: 8e0e6912a1bf8c3cd07d0c4f7c2699450c0e5b324c65f82392a74e5c5d60147f764996eb18caf079fea5707bac10cc66398f32e510405ee2d531127d17be14f3
+  metadata.gz: bf4d03572d48ac3893f0f46d456fefd77887ceaa314a0cc167964642c54b72f31494fa2cbf8ae7fcbe504dac424b864d02e85522fc8694007768050baba86205
+  data.tar.gz: d5fd1c0d4631af5c6c7f94b22237bf2a11c777ebd7f064ac9af0282cf4ff0158ec822f3625338017900af8a8c8bfeb1276ca00c8c94ffee15dc150862cdd12dc

data/fontist.gemspec

@@ -31,7 +31,7 @@ Gem::Specification.new do |spec|
 
   spec.add_dependency "down", "~> 5.0"
   spec.add_dependency "excavate", "~> 1.0", ">= 1.0.3"
-  spec.add_dependency "fontisan", "~> 0.2", ">= 0.2.16"
+  spec.add_dependency "fontisan", "~> 0.2", ">= 0.2.17"
   spec.add_dependency "fuzzy_match", "~> 2.1"
   spec.add_dependency "git", "> 1.0"
   spec.add_dependency "json", "~> 2.0"

data/lib/fontist/collection_file.rb

@@ -43,15 +43,17 @@ module Fontist
             "#{e.category}: #{e.message}"
           end.join("; ")
           # rubocop:disable Layout/LineLength
-          raise Errors::FontFileError,
+          raise Errors::FontIndexabilityValidationError,
                 "Font collection failed indexability validation (first font): #{error_messages}"
           # rubocop:enable Layout/LineLength
         end
 
         collection
+      rescue Errors::FontIndexabilityValidationError
+        raise
       rescue StandardError => e
         raise Errors::FontFileError,
-              "Font collection could not be loaded: #{e.inspect}."
+              "Font collection could not be loaded: #{e.message}"
       end
       # rubocop:enable Metrics/AbcSize, Metrics/MethodLength
 

data/lib/fontist/errors.rb

@@ -20,6 +20,12 @@ module Fontist
 
     class FontFileError < GeneralError; end
 
+    # Raised when a font is structurally readable but fails the indexability
+    # profile (missing required tables, incomplete name records, etc.).
+    # Distinct from FontFileError so callers can tell "we don't recognise this
+    # file" apart from "this file is a font but unusable as an index entry".
+    class FontIndexabilityValidationError < FontFileError; end
+
     class FontExtractError < GeneralError; end
 
     class FontistVersionError < GeneralError; end

data/lib/fontist/font_file.rb

@@ -150,26 +150,9 @@ module Fontist
       end
       # rubocop:enable Metrics/AbcSize, Metrics/CyclomaticComplexity, Metrics/MethodLength, Metrics/PerceivedComplexity
 
-      # rubocop:disable Metrics/MethodLength
       def detect_font_format(path)
-        # Open file and check SFNT version to determine actual format
-        File.open(path, "rb") do |io|
-          signature = io.read(4)
-          io.rewind
-
-          case signature
-          when "\x00\x01\x00\x00", "true"
-            "ttf"
-          when "OTTO"
-            "otf"
-          when "wOFF"
-            "woff"
-          when "wOF2"
-            "woff2"
-          else
-            "unknown"
-          end
-        end
+        format = Fontisan::FontLoader.detect_format(path)
+        format ? format.to_s : "unknown"
       rescue StandardError
         "unknown"
       end

data/lib/fontist/indexes/base_font_collection_index.rb

@@ -41,14 +41,21 @@ module Fontist
       # Get the collection, initializing it lazily if nil
       #
       # Uses lazy initialization so that the collection is created with fresh
-      # font_paths each time it's accessed after reset_cache
+      # font_paths each time it's accessed after reset_cache.
+      #
+      # On cold start (no on-disk index file), eagerly build the index once
+      # so that `fonts` reflects an authoritative scan. This lets callers in
+      # read-only mode trust the cached `fonts` without re-running `build` on
+      # every lookup.
       #
       # @return [SystemIndexFontCollection] The collection object
       def collection
         @collection ||= SystemIndexFontCollection.from_file(
           path: index_path,
           paths_loader: -> { font_paths },
-        )
+        ).tap do |coll|
+          coll.build unless File.exist?(index_path)
+        end
       end
 
       # Enable read-only mode for operations that don't need index rebuilding

data/lib/fontist/manifest.rb

@@ -215,10 +215,9 @@ location: nil)
           installed_any = true
         end
       end
-      # Only reset fontist index (not system index) if we actually installed fonts
       if installed_any
-        # Reset only the fontist font cache, not system fonts
         Fontist::SystemFont.reset_fontist_font_paths_cache
+        Fontist::SystemFont.reset_find_styles_cache
       end
       to_response
     end

data/lib/fontist/system_index.rb

@@ -1,4 +1,5 @@
 require "paint"
+require "fontisan"
 
 module Fontist
   # Statistics tracking for index building (thread-safe)
@@ -229,11 +230,7 @@ module Fontist
     end
 
     def index
-      # Fast path: if read_only mode is set, skip index_changed? check entirely.
-      # But we still need to build on first access — treat an empty fonts list
-      # the same as nil, since Lutaml initializes `instances :fonts` to `[]`
-      # rather than nil when the on-disk index file is absent.
-      if @read_only_mode && !fonts.nil? && !fonts.empty?
+      if @read_only_mode && !fonts.nil?
         return fonts
       end
 
@@ -634,15 +631,12 @@ spinner_index = nil)
       return if excluded?(path)
 
       gather_fonts(path)
+    rescue Errors::FontIndexabilityValidationError => e
+      stats&.record_validation_failure
+      print_validation_error(e, path)
     rescue Errors::FontFileError => e
-      # Check if this is a validation failure
-      if e.message.include?("indexability validation")
-        stats&.record_validation_failure
-        print_validation_error(e, path)
-      else
-        stats&.record_error
-        print_recognition_error(e, path)
-      end
+      stats&.record_error
+      print_recognition_error(e, path)
     end
 
     def excluded?(path)
@@ -653,15 +647,24 @@ spinner_index = nil)
       @excluded_fonts ||= YAML.load_file(Fontist.excluded_fonts_path)
     end
 
+    # Dispatch a file to the file-font or collection parser based on its actual
+    # magic bytes, not its extension. Some vendors ship files with misleading
+    # extensions (notably macOS ships a single OpenType-CFF font as
+    # `SauberScript.ttc` inside its private FontServices framework). Trusting
+    # the extension causes such files to be routed through the collection
+    # parser, which correctly rejects them, producing spurious "not recognized"
+    # warnings.
     def gather_fonts(path)
-      case File.extname(path).gsub(/^\./, "").downcase
-      when "ttf", "otf", "woff", "woff2"
-        detect_file_font(path)
-      when "ttc", "otc"
+      case Fontisan::FontLoader.detect_format(path)
+      when :ttc, :otc
         detect_collection_fonts(path)
+      when :ttf, :otf, :woff, :woff2
+        detect_file_font(path)
       else
         print_recognition_error(Errors::UnknownFontTypeError.new(path), path)
       end
+    rescue Errno::ENOENT, Errno::EACCES, IOError => e
+      print_recognition_error(Errors::FontFileError.new(e.message), path)
     end
 
     def print_validation_error(exception, path)

data/lib/fontist/version.rb

@@ -1,3 +1,3 @@
 module Fontist
-  VERSION = "3.0.6".freeze
+  VERSION = "3.0.8".freeze
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: fontist
 version: !ruby/object:Gem::Version
-  version: 3.0.6
+  version: 3.0.8
 platform: ruby
 authors:
 - Ribose Inc.
 autorequire:
 bindir: exe
 cert_chain: []
-date: 2026-05-18 00:00:00.000000000 Z
+date: 2026-06-11 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: down
@@ -53,7 +53,7 @@ dependencies:
         version: '0.2'
     - - ">="
       - !ruby/object:Gem::Version
-        version: 0.2.16
+        version: 0.2.17
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
@@ -63,7 +63,7 @@ dependencies:
         version: '0.2'
     - - ">="
       - !ruby/object:Gem::Version
-        version: 0.2.16
+        version: 0.2.17
 - !ruby/object:Gem::Dependency
   name: fuzzy_match
   requirement: !ruby/object:Gem::Requirement