fontisan 0.2.0 → 0.2.2

data/lib/fontisan/woff_font.rb

@@ -450,13 +450,8 @@ module Fontisan
     # @param path [String] Path to the font file
     # @return [void]
     def update_checksum_adjustment_in_file(path)
-      # Calculate file checksum
-      checksum = Utilities::ChecksumCalculator.calculate_file_checksum(path)
-
-      # Calculate adjustment
-      adjustment = Utilities::ChecksumCalculator.calculate_adjustment(checksum)
-
       # Find head table position in output file
+      head_offset = nil
       File.open(path, "rb") do |io|
         io.seek(4) # Skip sfnt_version
         num_tables = io.read(2).unpack1("n")
@@ -469,15 +464,25 @@ module Fontisan
           io.read(4) # length
 
           if tag == Constants::HEAD_TAG
-            # Write adjustment to head table (offset 8 within head table)
-            File.open(path, "r+b") do |write_io|
-              write_io.seek(offset + 8)
-              write_io.write([adjustment].pack("N"))
-            end
+            head_offset = offset
             break
           end
         end
       end
+
+      return unless head_offset
+
+      # Use tempfile-based checksum calculation for Windows compatibility
+      File.open(path, "r+b") do |io|
+        checksum, _tmpfile = Utilities::ChecksumCalculator.calculate_checksum_from_io_with_tempfile(io)
+
+        # Calculate adjustment
+        adjustment = Utilities::ChecksumCalculator.calculate_adjustment(checksum)
+
+        # Write adjustment to head table (offset 8 within head table)
+        io.seek(head_offset + 8)
+        io.write([adjustment].pack("N"))
+      end
     end
   end
 end

data/lib/fontisan.rb

@@ -78,6 +78,10 @@ require_relative "fontisan/open_type_collection"
 require_relative "fontisan/woff_font"
 require_relative "fontisan/woff2_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"
 
@@ -103,6 +107,7 @@ require_relative "fontisan/models/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"
@@ -145,13 +150,19 @@ 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/interpolator"
-require_relative "fontisan/variation/region_matcher"
 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"
@@ -160,6 +171,17 @@ 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"
@@ -197,4 +219,34 @@ module Fontisan
   self.logger = Logger.new($stdout).tap do |log|
     log.level = Logger::WARN
   end
+
+  # Get font information.
+  #
+  # Supports both full and brief modes. Brief mode uses metadata loading for
+  # 5x faster parsing by loading only essential tables (name, head, hhea,
+  # maxp, OS/2, post). Returns FontInfo with 13 essential fields in brief mode
+  # or all 38 fields in full mode.
+  #
+  # @param path [String] Path to font file
+  # @param brief [Boolean] Use brief mode for fast identification (default: false)
+  # @param font_index [Integer] Index for TTC/OTC files (default: 0)
+  # @return [Models::FontInfo, Models::CollectionInfo, Models::CollectionBriefInfo] Font information
+  #
+  # @example Get full info
+  #   info = Fontisan.info("font.ttf")
+  #   puts info.family_name
+  #   puts info.copyright  # populated in full mode
+  #
+  # @example Get brief info (5x faster)
+  #   info = Fontisan.info("font.ttf", brief: true)
+  #   puts info.family_name       # populated
+  #   puts info.postscript_name   # populated
+  #   puts info.copyright         # nil (not populated in brief mode)
+  #
+  # @example Serialize to JSON
+  #   info = Fontisan.info("font.ttf", brief: true)
+  #   puts info.to_json
+  def self.info(path, brief: false, font_index: 0)
+    Commands::InfoCommand.new(path, brief: brief, font_index: font_index).run
+  end
 end

data/scripts/measure_optimization.rb

@@ -51,21 +51,26 @@ def measure_font(font_path, options = {})
   puts "RESULTS"
   puts "-" * 80
   puts "File Sizes:"
-  puts "  Without optimization: #{format('%10d', size_unopt)} bytes (#{size_per_glyph_unopt} bytes/glyph)"
-  puts "  With optimization:    #{format('%10d', size_opt)} bytes (#{size_per_glyph_opt} bytes/glyph)"
+  puts "  Without optimization: #{format('%10d',
+                                         size_unopt)} bytes (#{size_per_glyph_unopt} bytes/glyph)"
+  puts "  With optimization:    #{format('%10d',
+                                         size_opt)} bytes (#{size_per_glyph_opt} bytes/glyph)"
   puts "  Bytes saved:          #{format('%10d', savings)} bytes"
   puts "  Reduction:            #{format('%9.2f', reduction_percent)}%"
 
   puts "\nProcessing Time:"
   puts "  Without optimization: #{format('%.2f', time_unopt)} seconds"
   puts "  With optimization:    #{format('%.2f', time_opt)} seconds"
-  puts "  Overhead:             #{format('%.2f', time_opt - time_unopt)} seconds"
+  puts "  Overhead:             #{format('%.2f',
+                                         time_opt - time_unopt)} seconds"
 
   if opt_result
     puts "\nOptimization Details:"
     puts "  Patterns found:       #{format('%10d', opt_result[:pattern_count])}"
-    puts "  Patterns selected:    #{format('%10d', opt_result[:selected_count])}"
-    puts "  Subroutines:          #{format('%10d', opt_result[:local_subrs].length)}"
+    puts "  Patterns selected:    #{format('%10d',
+                                           opt_result[:selected_count])}"
+    puts "  Subroutines:          #{format('%10d',
+                                           opt_result[:local_subrs].length)}"
     puts "  CFF bias:             #{format('%10d', opt_result[:bias])}"
     puts "  Est. bytes saved:     #{format('%10d', opt_result[:savings])}"
   end
@@ -103,7 +108,9 @@ def print_summary(results)
   end
 
   # Calculate averages
-  avg_reduction = (results.sum { |r| r[:reduction_percent] } / results.length).round(2)
+  avg_reduction = (results.sum do |r|
+    r[:reduction_percent]
+  end / results.length).round(2)
   total_saved = results.sum { |r| r[:savings] }
 
   puts "-" * 80
@@ -118,7 +125,8 @@ if __FILE__ == $PROGRAM_NAME
 
   if font_paths.empty?
     # Use fixtures if no arguments provided
-    fixtures_dir = File.join(File.dirname(__FILE__), "..", "spec", "fixtures", "fonts")
+    fixtures_dir = File.join(File.dirname(__FILE__), "..", "spec", "fixtures",
+                             "fonts")
     font_paths = Dir.glob(File.join(fixtures_dir, "*.ttf"))
   end
 

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: fontisan
 version: !ruby/object:Gem::Version
-  version: 0.2.0
+  version: 0.2.2
 platform: ruby
 authors:
 - Ribose Inc.
 autorequire:
 bindir: exe
 cert_chain: []
-date: 2025-12-17 00:00:00.000000000 Z
+date: 2025-12-30 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: base64
@@ -117,6 +117,8 @@ files:
 - Rakefile
 - benchmark/variation_quick_bench.rb
 - docs/EXTRACT_TTC_MIGRATION.md
+- docs/FONT_HINTING.adoc
+- docs/VARIABLE_FONT_OPERATIONS.adoc
 - exe/fontisan
 - fontisan.gemspec
 - lib/fontisan.rb
@@ -181,13 +183,17 @@ files:
 - lib/fontisan/formatters/text_formatter.rb
 - lib/fontisan/glyph_accessor.rb
 - lib/fontisan/hints/hint_converter.rb
+- lib/fontisan/hints/hint_validator.rb
 - lib/fontisan/hints/postscript_hint_applier.rb
 - lib/fontisan/hints/postscript_hint_extractor.rb
 - lib/fontisan/hints/truetype_hint_applier.rb
 - lib/fontisan/hints/truetype_hint_extractor.rb
+- lib/fontisan/hints/truetype_instruction_analyzer.rb
+- lib/fontisan/hints/truetype_instruction_generator.rb
 - lib/fontisan/loading_modes.rb
 - lib/fontisan/metrics_calculator.rb
 - lib/fontisan/models/all_scripts_features_info.rb
+- lib/fontisan/models/collection_brief_info.rb
 - lib/fontisan/models/collection_font_summary.rb
 - lib/fontisan/models/collection_info.rb
 - lib/fontisan/models/collection_list_info.rb
@@ -217,6 +223,7 @@ files:
 - lib/fontisan/models/variable_font_info.rb
 - lib/fontisan/open_type_collection.rb
 - lib/fontisan/open_type_font.rb
+- lib/fontisan/open_type_font_extensions.rb
 - lib/fontisan/optimizers/charstring_rewriter.rb
 - lib/fontisan/optimizers/pattern_analyzer.rb
 - lib/fontisan/optimizers/stack_tracker.rb
@@ -225,6 +232,14 @@ files:
 - lib/fontisan/optimizers/subroutine_optimizer.rb
 - lib/fontisan/outline_extractor.rb
 - lib/fontisan/parsers/tag.rb
+- lib/fontisan/pipeline/format_detector.rb
+- lib/fontisan/pipeline/output_writer.rb
+- lib/fontisan/pipeline/strategies/base_strategy.rb
+- lib/fontisan/pipeline/strategies/instance_strategy.rb
+- lib/fontisan/pipeline/strategies/named_strategy.rb
+- lib/fontisan/pipeline/strategies/preserve_strategy.rb
+- lib/fontisan/pipeline/transformation_pipeline.rb
+- lib/fontisan/pipeline/variation_resolver.rb
 - lib/fontisan/subset/builder.rb
 - lib/fontisan/subset/glyph_mapping.rb
 - lib/fontisan/subset/options.rb
@@ -239,19 +254,30 @@ files:
 - lib/fontisan/tables/cff/charset.rb
 - lib/fontisan/tables/cff/charstring.rb
 - lib/fontisan/tables/cff/charstring_builder.rb
+- lib/fontisan/tables/cff/charstring_parser.rb
+- lib/fontisan/tables/cff/charstring_rebuilder.rb
 - lib/fontisan/tables/cff/charstrings_index.rb
 - lib/fontisan/tables/cff/dict.rb
 - lib/fontisan/tables/cff/dict_builder.rb
 - lib/fontisan/tables/cff/encoding.rb
 - lib/fontisan/tables/cff/header.rb
+- lib/fontisan/tables/cff/hint_operation_injector.rb
 - lib/fontisan/tables/cff/index.rb
 - lib/fontisan/tables/cff/index_builder.rb
+- lib/fontisan/tables/cff/offset_recalculator.rb
 - lib/fontisan/tables/cff/private_dict.rb
+- lib/fontisan/tables/cff/private_dict_writer.rb
+- lib/fontisan/tables/cff/table_builder.rb
 - lib/fontisan/tables/cff/top_dict.rb
 - lib/fontisan/tables/cff2.rb
 - lib/fontisan/tables/cff2/blend_operator.rb
 - lib/fontisan/tables/cff2/charstring_parser.rb
 - lib/fontisan/tables/cff2/operand_stack.rb
+- lib/fontisan/tables/cff2/private_dict_blend_handler.rb
+- lib/fontisan/tables/cff2/region_matcher.rb
+- lib/fontisan/tables/cff2/table_builder.rb
+- lib/fontisan/tables/cff2/table_reader.rb
+- lib/fontisan/tables/cff2/variation_data_extractor.rb
 - lib/fontisan/tables/cmap.rb
 - lib/fontisan/tables/cvar.rb
 - lib/fontisan/tables/fvar.rb
@@ -279,6 +305,7 @@ files:
 - lib/fontisan/tables/vvar.rb
 - lib/fontisan/true_type_collection.rb
 - lib/fontisan/true_type_font.rb
+- lib/fontisan/true_type_font_extensions.rb
 - lib/fontisan/utilities/brotli_wrapper.rb
 - lib/fontisan/utilities/checksum_calculator.rb
 - lib/fontisan/utils/thread_pool.rb
@@ -287,6 +314,7 @@ files:
 - lib/fontisan/validation/structure_validator.rb
 - lib/fontisan/validation/table_validator.rb
 - lib/fontisan/validation/validator.rb
+- lib/fontisan/validation/variable_font_validator.rb
 - lib/fontisan/variable/axis_normalizer.rb
 - lib/fontisan/variable/delta_applicator.rb
 - lib/fontisan/variable/glyph_delta_processor.rb
@@ -304,6 +332,7 @@ files:
 - lib/fontisan/variation/delta_parser.rb
 - lib/fontisan/variation/inspector.rb
 - lib/fontisan/variation/instance_generator.rb
+- lib/fontisan/variation/instance_writer.rb
 - lib/fontisan/variation/interpolator.rb
 - lib/fontisan/variation/metrics_adjuster.rb
 - lib/fontisan/variation/optimizer.rb
@@ -311,11 +340,17 @@ files:
 - lib/fontisan/variation/region_matcher.rb
 - lib/fontisan/variation/subsetter.rb
 - lib/fontisan/variation/table_accessor.rb
+- lib/fontisan/variation/tuple_variation_header.rb
 - lib/fontisan/variation/validator.rb
+- lib/fontisan/variation/variable_svg_generator.rb
 - lib/fontisan/variation/variation_context.rb
+- lib/fontisan/variation/variation_preserver.rb
 - lib/fontisan/version.rb
+- lib/fontisan/version.rb.orig
 - lib/fontisan/woff2/directory.rb
+- lib/fontisan/woff2/glyf_transformer.rb
 - lib/fontisan/woff2/header.rb
+- lib/fontisan/woff2/hmtx_transformer.rb
 - lib/fontisan/woff2/table_transformer.rb
 - lib/fontisan/woff2_font.rb
 - lib/fontisan/woff_font.rb