fontisan 0.2.22 → 0.3.0

metadata

@@ -1,13 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: fontisan
 version: !ruby/object:Gem::Version
-  version: 0.2.22
+  version: 0.3.0
 platform: ruby
 authors:
 - Ribose Inc.
+autorequire:
 bindir: exe
 cert_chain: []
-date: 1980-01-02 00:00:00.000000000 Z
+date: 2026-06-29 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: base64
@@ -262,29 +263,8 @@ files:
 - docs/public/web-app-manifest-512x512.png
 - docs/scripts/post-build.mjs
 - exe/fontisan
+- fontisan.gemspec
 - lib/fontisan.rb
-- lib/fontisan/audit.rb
-- lib/fontisan/audit/codepoint_range_coalescer.rb
-- lib/fontisan/audit/context.rb
-- lib/fontisan/audit/differ.rb
-- lib/fontisan/audit/extractors.rb
-- lib/fontisan/audit/extractors/aggregations.rb
-- lib/fontisan/audit/extractors/base.rb
-- lib/fontisan/audit/extractors/color_capabilities.rb
-- lib/fontisan/audit/extractors/coverage.rb
-- lib/fontisan/audit/extractors/hinting.rb
-- lib/fontisan/audit/extractors/identity.rb
-- lib/fontisan/audit/extractors/language_coverage.rb
-- lib/fontisan/audit/extractors/licensing.rb
-- lib/fontisan/audit/extractors/metrics.rb
-- lib/fontisan/audit/extractors/opentype_layout.rb
-- lib/fontisan/audit/extractors/provenance.rb
-- lib/fontisan/audit/extractors/style.rb
-- lib/fontisan/audit/extractors/variation_detail.rb
-- lib/fontisan/audit/library_aggregator.rb
-- lib/fontisan/audit/library_auditor.rb
-- lib/fontisan/audit/registry.rb
-- lib/fontisan/audit/style_extractor.rb
 - lib/fontisan/base_collection.rb
 - lib/fontisan/binary.rb
 - lib/fontisan/binary/base_record.rb
@@ -303,7 +283,6 @@ files:
 - lib/fontisan/cldr/version_resolver.rb
 - lib/fontisan/cli.rb
 - lib/fontisan/cli/cldr_cli.rb
-- lib/fontisan/cli/ucd_cli.rb
 - lib/fontisan/collection.rb
 - lib/fontisan/collection/builder.rb
 - lib/fontisan/collection/dfont_builder.rb
@@ -313,9 +292,6 @@ files:
 - lib/fontisan/collection/table_deduplicator.rb
 - lib/fontisan/collection/writer.rb
 - lib/fontisan/commands.rb
-- lib/fontisan/commands/audit_command.rb
-- lib/fontisan/commands/audit_compare_command.rb
-- lib/fontisan/commands/audit_library_command.rb
 - lib/fontisan/commands/base_command.rb
 - lib/fontisan/commands/convert_command.rb
 - lib/fontisan/commands/dump_table_command.rb
@@ -342,7 +318,6 @@ files:
 - lib/fontisan/config/scripts.yml
 - lib/fontisan/config/subset_profiles.yml
 - lib/fontisan/config/svg_settings.yml
-- lib/fontisan/config/ucd.yml
 - lib/fontisan/config/variable_settings.yml
 - lib/fontisan/config/woff2_settings.yml
 - lib/fontisan/constants.rb
@@ -379,9 +354,6 @@ files:
 - lib/fontisan/font_loader.rb
 - lib/fontisan/font_writer.rb
 - lib/fontisan/formatters.rb
-- lib/fontisan/formatters/audit_diff_text_renderer.rb
-- lib/fontisan/formatters/audit_text_renderer.rb
-- lib/fontisan/formatters/library_summary_text_renderer.rb
 - lib/fontisan/formatters/text_formatter.rb
 - lib/fontisan/glyph_accessor.rb
 - lib/fontisan/hints.rb
@@ -397,28 +369,6 @@ files:
 - lib/fontisan/metrics_calculator.rb
 - lib/fontisan/models.rb
 - lib/fontisan/models/all_scripts_features_info.rb
-- lib/fontisan/models/audit.rb
-- lib/fontisan/models/audit/audit_axis.rb
-- lib/fontisan/models/audit/audit_block.rb
-- lib/fontisan/models/audit/audit_diff.rb
-- lib/fontisan/models/audit/audit_report.rb
-- lib/fontisan/models/audit/codepoint_range.rb
-- lib/fontisan/models/audit/codepoint_set_diff.rb
-- lib/fontisan/models/audit/color_capabilities.rb
-- lib/fontisan/models/audit/duplicate_group.rb
-- lib/fontisan/models/audit/embedding_type.rb
-- lib/fontisan/models/audit/field_change.rb
-- lib/fontisan/models/audit/fs_selection_flags.rb
-- lib/fontisan/models/audit/gasp_range.rb
-- lib/fontisan/models/audit/hinting.rb
-- lib/fontisan/models/audit/library_summary.rb
-- lib/fontisan/models/audit/licensing.rb
-- lib/fontisan/models/audit/metrics.rb
-- lib/fontisan/models/audit/named_instance.rb
-- lib/fontisan/models/audit/opentype_layout.rb
-- lib/fontisan/models/audit/script_coverage_row.rb
-- lib/fontisan/models/audit/script_features.rb
-- lib/fontisan/models/audit/variation_detail.rb
 - lib/fontisan/models/bitmap_glyph.rb
 - lib/fontisan/models/bitmap_strike.rb
 - lib/fontisan/models/cldr.rb
@@ -456,9 +406,6 @@ files:
 - lib/fontisan/models/ttx/tables/os2_table.rb
 - lib/fontisan/models/ttx/tables/post_table.rb
 - lib/fontisan/models/ttx/ttfont.rb
-- lib/fontisan/models/ucd.rb
-- lib/fontisan/models/ucd/ucd.rb
-- lib/fontisan/models/ucd/ucd_char.rb
 - lib/fontisan/models/unicode_mappings.rb
 - lib/fontisan/models/validation_report.rb
 - lib/fontisan/models/variable_font_info.rb
@@ -488,6 +435,13 @@ files:
 - lib/fontisan/pipeline/variation_resolver.rb
 - lib/fontisan/sfnt_font.rb
 - lib/fontisan/sfnt_table.rb
+- lib/fontisan/stitcher.rb
+- lib/fontisan/stitcher/selector.rb
+- lib/fontisan/stitcher/selector/codepoints.rb
+- lib/fontisan/stitcher/selector/gid.rb
+- lib/fontisan/stitcher/selector/range.rb
+- lib/fontisan/stitcher/source.rb
+- lib/fontisan/stitcher_cli.rb
 - lib/fontisan/subset.rb
 - lib/fontisan/subset/builder.rb
 - lib/fontisan/subset/glyph_mapping.rb
@@ -597,18 +551,49 @@ files:
 - lib/fontisan/type1/ttf_to_type1_converter.rb
 - lib/fontisan/type1/upm_scaler.rb
 - lib/fontisan/type1_font.rb
-- lib/fontisan/ucd.rb
-- lib/fontisan/ucd/aggregator.rb
-- lib/fontisan/ucd/cache_manager.rb
-- lib/fontisan/ucd/config.rb
-- lib/fontisan/ucd/download_error.rb
-- lib/fontisan/ucd/downloader.rb
-- lib/fontisan/ucd/error.rb
-- lib/fontisan/ucd/index.rb
-- lib/fontisan/ucd/index_builder.rb
-- lib/fontisan/ucd/range_entry.rb
-- lib/fontisan/ucd/unknown_version_error.rb
-- lib/fontisan/ucd/version_resolver.rb
+- lib/fontisan/ufo.rb
+- lib/fontisan/ufo/anchor.rb
+- lib/fontisan/ufo/cli.rb
+- lib/fontisan/ufo/compile.rb
+- lib/fontisan/ufo/compile/base_compiler.rb
+- lib/fontisan/ufo/compile/cff.rb
+- lib/fontisan/ufo/compile/cmap.rb
+- lib/fontisan/ufo/compile/filters.rb
+- lib/fontisan/ufo/compile/filters/cubic_to_quadratic.rb
+- lib/fontisan/ufo/compile/filters/decompose_components.rb
+- lib/fontisan/ufo/compile/filters/flatten_components.rb
+- lib/fontisan/ufo/compile/filters/reverse_contour_direction.rb
+- lib/fontisan/ufo/compile/glyf_loca.rb
+- lib/fontisan/ufo/compile/head.rb
+- lib/fontisan/ufo/compile/hhea.rb
+- lib/fontisan/ufo/compile/hmtx.rb
+- lib/fontisan/ufo/compile/maxp.rb
+- lib/fontisan/ufo/compile/name.rb
+- lib/fontisan/ufo/compile/os2.rb
+- lib/fontisan/ufo/compile/otf_compiler.rb
+- lib/fontisan/ufo/compile/post.rb
+- lib/fontisan/ufo/compile/ttf_compiler.rb
+- lib/fontisan/ufo/component.rb
+- lib/fontisan/ufo/contour.rb
+- lib/fontisan/ufo/convert.rb
+- lib/fontisan/ufo/convert/from_bin_data.rb
+- lib/fontisan/ufo/data_set.rb
+- lib/fontisan/ufo/features.rb
+- lib/fontisan/ufo/font.rb
+- lib/fontisan/ufo/glyph.rb
+- lib/fontisan/ufo/guideline.rb
+- lib/fontisan/ufo/image.rb
+- lib/fontisan/ufo/image_set.rb
+- lib/fontisan/ufo/info.rb
+- lib/fontisan/ufo/kerning.rb
+- lib/fontisan/ufo/layer.rb
+- lib/fontisan/ufo/layer_set.rb
+- lib/fontisan/ufo/lib.rb
+- lib/fontisan/ufo/plist.rb
+- lib/fontisan/ufo/point.rb
+- lib/fontisan/ufo/reader.rb
+- lib/fontisan/ufo/transformation.rb
+- lib/fontisan/ufo/writer.rb
 - lib/fontisan/utilities.rb
 - lib/fontisan/utilities/brotli_wrapper.rb
 - lib/fontisan/utilities/checksum_calculator.rb
@@ -675,6 +660,7 @@ metadata:
   source_code_uri: https://github.com/fontist/fontisan
   changelog_uri: https://github.com/fontist/fontisan/blob/main/CHANGELOG.md
   rubygems_mfa_required: 'true'
+post_install_message:
 rdoc_options: []
 require_paths:
 - lib
@@ -689,7 +675,8 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.6.9
+rubygems_version: 3.5.22
+signing_key:
 specification_version: 4
 summary: Font analysis tools and utilities for OpenType fonts
 test_files: []

data/lib/fontisan/audit/codepoint_range_coalescer.rb

@@ -1,41 +0,0 @@
-# frozen_string_literal: true
-
-module Fontisan
-  module Audit
-    # Coalesces a flat codepoint list into contiguous {Models::Audit::CodepointRange}s.
-    #
-    # Single static call site, deterministic output. Used by the Coverage
-    # extractor to produce the compact range view that is the default
-    # AuditReport shape.
-    module CodepointRangeCoalescer
-      module_function
-
-      # @param codepoints [Enumerable<Integer>] any enumeration of integers
-      # @return [Array<Models::Audit::CodepointRange>] contiguous, sorted
-      def call(codepoints)
-        return [] if codepoints.nil? || codepoints.empty?
-
-        sorted = codepoints.sort.uniq
-        ranges = []
-        range_start = sorted[0]
-        prev = sorted[0]
-
-        sorted[1..].each do |cp|
-          next if cp == prev # defensive: .uniq already handles this
-
-          if cp == prev + 1
-            prev = cp
-          else
-            ranges << Models::Audit::CodepointRange.new(first_cp: range_start,
-                                                        last_cp: prev)
-            range_start = cp
-            prev = cp
-          end
-        end
-        ranges << Models::Audit::CodepointRange.new(first_cp: range_start,
-                                                    last_cp: prev)
-        ranges
-      end
-    end
-  end
-end

data/lib/fontisan/audit/context.rb

@@ -1,122 +0,0 @@
-# frozen_string_literal: true
-
-module Fontisan
-  module Audit
-    # Value object carrying everything an extractor needs to do its job.
-    #
-    # Extractors never reach back into AuditCommand state — they read
-    # exclusively from the Context. Shared derived data (codepoints,
-    # UCD indices, source format) is memoized here so multiple
-    # extractors don't recompute it.
-    class Context
-      attr_reader :font, :font_path, :font_index, :num_fonts_in_source,
-                  :options
-
-      def initialize(font:, font_path:, font_index:, num_fonts_in_source:,
-                     options:)
-        @font = font
-        @font_path = font_path
-        @font_index = font_index
-        @num_fonts_in_source = num_fonts_in_source
-        @options = options
-      end
-
-      def codepoints
-        @codepoints ||= extract_codepoints
-      end
-
-      def ucd
-        @ucd ||= resolve_ucd
-      end
-
-      def cldr
-        return nil unless @options[:with_language_coverage]
-
-        @cldr ||= resolve_cldr
-      end
-
-      def source_format
-        @source_format ||= FontLoader.detect_format(@font_path)&.to_s
-      end
-
-      def all_codepoints?
-        @options[:all_codepoints] == true
-      end
-
-      private
-
-      def extract_codepoints
-        return [] unless @font.has_table?(Constants::CMAP_TAG)
-
-        @font.table(Constants::CMAP_TAG).unicode_mappings.keys
-      end
-
-      def resolve_ucd
-        version = Ucd::VersionResolver.resolve(@options[:ucd_version])
-
-        with_local_indices(version) do |blocks_path, scripts_path|
-          {
-            version: version,
-            blocks_index: Ucd::Index.load(blocks_path),
-            scripts_index: Ucd::Index.load(scripts_path),
-            warning: nil,
-          }
-        end
-      rescue Ucd::UnknownVersionError => e
-        { version: nil, blocks_index: nil, scripts_index: nil,
-          warning: "UCD version rejected: #{e.message}" }
-      rescue StandardError => e
-        version_ref = @ucd&.fetch(:version, nil)
-        {
-          version: version_ref,
-          blocks_index: nil,
-          scripts_index: nil,
-          warning: "UCD unavailable for version #{version_ref}: #{e.message}",
-        }
-      end
-
-      def with_local_indices(version)
-        unless Ucd::CacheManager.cached?(version)
-          Ucd::Downloader.download(version)
-        end
-        unless Ucd::CacheManager.blocks_index_path(version).exist?
-          Ucd::IndexBuilder.build(version)
-        end
-        yield Ucd::CacheManager.blocks_index_path(version),
-          Ucd::CacheManager.scripts_index_path(version)
-      end
-
-      def resolve_cldr
-        version = Cldr::VersionResolver.resolve(@options[:cldr_version])
-
-        with_local_languages_index(version) do |index_path|
-          {
-            version: version,
-            index: Cldr::Index.load(index_path),
-            warning: nil,
-          }
-        end
-      rescue Cldr::UnknownVersionError => e
-        { version: nil, index: nil,
-          warning: "CLDR version rejected: #{e.message}" }
-      rescue StandardError => e
-        version_ref = @cldr&.fetch(:version, nil)
-        {
-          version: version_ref,
-          index: nil,
-          warning: "CLDR unavailable for version #{version_ref}: #{e.message}",
-        }
-      end
-
-      def with_local_languages_index(version)
-        unless Cldr::CacheManager.cached?(version)
-          Cldr::Downloader.download(version)
-        end
-        unless Cldr::CacheManager.languages_index_path(version).exist?
-          Cldr::IndexBuilder.build(version)
-        end
-        yield Cldr::CacheManager.languages_index_path(version)
-      end
-    end
-  end
-end

data/lib/fontisan/audit/differ.rb

@@ -1,124 +0,0 @@
-# frozen_string_literal: true
-
-module Fontisan
-  module Audit
-    # Computes an {Models::Audit::AuditDiff} between two AuditReports.
-    #
-    # Pure: no I/O, no font parsing. Both reports must already be built
-    # (Commands::AuditCompareCommand handles loading reports from disk
-    # or auditing fresh fonts before invoking the differ).
-    #
-    # Comparison shape:
-    #   - Scalar fields: one FieldChange per differing field.
-    #   - Codepoint coverage: CodepointSetDiff built from the cmap range
-    #     lists (expanded to integer sets for set arithmetic, then
-    #     re-coalesced to ranges for output).
-    #   - Structural inventories (features, scripts, blocks, languages):
-    #     simple array set-diffs.
-    class Differ
-      # Scalar AuditReport fields compared field-by-field. Excludes
-      # generated_at / source_sha256 / source_file (per-report identity),
-      # codepoints / codepoint_ranges (handled via CodepointSetDiff),
-      # and nested models (surfaced via structural add/remove lists).
-      COMPARED_FIELDS = %i[
-        family_name subfamily_name full_name postscript_name version
-        font_revision weight_class width_class italic bold panose
-        total_codepoints total_glyphs ucd_version cldr_version
-      ].freeze
-
-      def initialize(left_report, right_report)
-        @left = left_report
-        @right = right_report
-      end
-
-      # @return [Models::Audit::AuditDiff]
-      def diff
-        Models::Audit::AuditDiff.new(
-          left_source: @left.source_file,
-          right_source: @right.source_file,
-          field_changes: field_changes,
-          codepoints: codepoint_diff,
-          added_features: set_diff(features(@right), features(@left)),
-          removed_features: set_diff(features(@left), features(@right)),
-          added_scripts: set_diff(scripts(@right), scripts(@left)),
-          removed_scripts: set_diff(scripts(@left), scripts(@right)),
-          added_blocks: set_diff(blocks(@right), blocks(@left)),
-          removed_blocks: set_diff(blocks(@left), blocks(@right)),
-          added_languages: set_diff(languages(@right), languages(@left)),
-          removed_languages: set_diff(languages(@left), languages(@right)),
-        )
-      end
-
-      private
-
-      def field_changes
-        COMPARED_FIELDS.filter_map do |field|
-          left_val = @left.public_send(field)
-          right_val = @right.public_send(field)
-          next if left_val == right_val
-
-          Models::Audit::FieldChange.new(
-            field: field.to_s,
-            left: serialize_value(left_val),
-            right: serialize_value(right_val),
-          )
-        end
-      end
-
-      def codepoint_diff
-        left_set = codepoints_from_ranges(@left)
-        right_set = codepoints_from_ranges(@right)
-        added = right_set - left_set
-        removed = left_set - right_set
-        unchanged = left_set & right_set
-
-        Models::Audit::CodepointSetDiff.new(
-          added: CodepointRangeCoalescer.call(added.to_a),
-          removed: CodepointRangeCoalescer.call(removed.to_a),
-          added_count: added.size,
-          removed_count: removed.size,
-          unchanged_count: unchanged.size,
-        )
-      end
-
-      # Expand a report's compact codepoint range list into a Set<Integer>.
-      # Works for both default reports (range list populated) and
-      # --all-codepoints reports (range list is also populated).
-      def codepoints_from_ranges(report)
-        ranges = report.codepoint_ranges || []
-        ranges.each_with_object(Set.new) do |range, set|
-          (range.first_cp..range.last_cp).each { |cp| set << cp }
-        end
-      end
-
-      def features(report)
-        report.opentype_layout&.features || []
-      end
-
-      def scripts(report)
-        report.opentype_layout&.scripts || []
-      end
-
-      def blocks(report)
-        (report.blocks || []).map(&:name)
-      end
-
-      def languages(report)
-        (report.language_coverage || []).map(&:language)
-      end
-
-      def set_diff(minuend, subtrahend)
-        (Array(minuend) - Array(subtrahend)).sort
-      end
-
-      def serialize_value(value)
-        case value
-        when nil then ""
-        when String, Integer, Float then value.to_s
-        when true, false then value.to_s
-        else value.to_yaml
-        end
-      end
-    end
-  end
-end

data/lib/fontisan/audit/extractors/aggregations.rb

@@ -1,54 +0,0 @@
-# frozen_string_literal: true
-
-module Fontisan
-  module Audit
-    module Extractors
-      # Aggregation fields: UCD block/script coverage.
-      #
-      # Returned fields:
-      #   ucd_version, blocks, unicode_scripts
-      #
-      # OpenType script/feature inventory lives in {Extractors::OpenTypeLayout}
-      # (MECE: this extractor is UCD-driven, that one is SFNT-table-driven).
-      class Aggregations < Base
-        def extract(context)
-          ucd = context.ucd
-          ucd_aggregations(context.codepoints, ucd)
-        end
-
-        private
-
-        def ucd_aggregations(codepoints, ucd)
-          return empty_aggregation(ucd) if ucd[:blocks_index].nil?
-
-          blocks_hashes = Ucd::Aggregator.aggregate_blocks(codepoints,
-                                                           ucd[:blocks_index])
-          {
-            ucd_version: ucd[:version],
-            blocks: blocks_hashes.map { |h| build_audit_block(h) },
-            unicode_scripts: Ucd::Aggregator.aggregate_scripts(codepoints,
-                                                               ucd[:scripts_index]),
-          }
-        end
-
-        def empty_aggregation(ucd)
-          { ucd_version: ucd[:version], blocks: [], unicode_scripts: [] }
-        end
-
-        def build_audit_block(block_hash)
-          Models::Audit::AuditBlock.new(
-            name: block_hash[:name],
-            first_cp: block_hash[:first_cp],
-            last_cp: block_hash[:last_cp],
-            range: format("U+%<first>04X-U+%<last>04X",
-                          first: block_hash[:first_cp], last: block_hash[:last_cp]),
-            total: block_hash[:total],
-            covered: block_hash[:covered],
-            fill_ratio: block_hash[:fill_ratio],
-            complete: block_hash[:complete],
-          )
-        end
-      end
-    end
-  end
-end

data/lib/fontisan/audit/extractors/base.rb

@@ -1,26 +0,0 @@
-# frozen_string_literal: true
-
-module Fontisan
-  module Audit
-    module Extractors
-      # Abstract extractor interface. Subclasses implement `#extract`.
-      #
-      # An extractor reads from a Context and returns a hash of fields
-      # suitable for `Models::Audit::AuditReport.new(**fields)`.
-      # Returning an empty hash is valid (no-op).
-      class Base
-        def extract(context)
-          raise NotImplementedError,
-                "#{self.class} must implement #extract"
-        end
-
-        protected
-
-        # Convenience accessor used by most extractors.
-        def font(context)
-          context.font
-        end
-      end
-    end
-  end
-end