fontisan 0.2.3 → 0.2.4

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: d342cbc82376aa9327747fd679edf9199ab0e1fbed9a729d4385aae52d6c5de9
-  data.tar.gz: 8427c56d4e65ca035a5bff415ef7020e3f6e17c31f4c43d8b28b5ca8e41e4fe4
+  metadata.gz: efdc28872530847f76e7d586ed2ac859d0860275a9289936e742a467f6139799
+  data.tar.gz: b1af1580a3ef2d2b1dbb449c3c7295194497b358d8819d5f18496282b7730ed5
 SHA512:
-  metadata.gz: e5c9b89e658113edcd96e98c4c56733538a4e47eb18220d49ca8e21c5117285795759a6e3dd5b4f2a0b29f7a4a66c0bf0bf25757780dd438045eb705feef97ef
-  data.tar.gz: 5ec8c48befb405a5d9911a6f00a2287a9cae461847b52094abe1367cd5f1fd5c451363182ed3c9a924c96d13299659869c6ffa2f192951301d1218eb840e0623
+  metadata.gz: 533a181937b1b46ea380a14a9c108ba19678f9bf1c0fcb8a5b51f0e0fb43630c69180c74679ad91da49fa73d136ec783e69b460ce8f031834e3fc500ca666139
+  data.tar.gz: '09e9d4ff6a4694df5d6756dc9f4dc056f1951d66ca456079ad40336a41e32b804b15aa597f4089d20a20474a75faf680782c6cca2bf5ee8c2d5c30eb41e12623'

data/.rubocop_todo.yml

@@ -1,6 +1,6 @@
 # This configuration was generated by
 # `rubocop --auto-gen-config`
-# on 2025-12-30 09:54:17 UTC using RuboCop version 1.81.7.
+# on 2026-01-03 02:11:10 UTC using RuboCop version 1.81.7.
 # The point is for the user to remove these configuration records
 # one by one as the offenses are removed from the code base.
 # Note that changes in the inspected code, or installation of new
@@ -12,6 +12,14 @@ Gemspec/RequiredRubyVersion:
   Exclude:
     - 'fontisan.gemspec'
 
+# Offense count: 1
+# This cop supports safe autocorrection (--autocorrect).
+# Configuration parameters: EnforcedStyle, IndentationWidth.
+# SupportedStyles: with_first_argument, with_fixed_indentation
+Layout/ArgumentAlignment:
+  Exclude:
+    - 'lib/fontisan/converters/woff2_encoder.rb'
+
 # Offense count: 1
 # This cop supports safe autocorrection (--autocorrect).
 Layout/EmptyLineAfterGuardClause:
@@ -24,21 +32,32 @@ Layout/EmptyLinesAroundExceptionHandlingKeywords:
   Exclude:
     - 'lib/fontisan/hints/hint_validator.rb'
 
-# Offense count: 2
+# Offense count: 23
 # This cop supports safe autocorrection (--autocorrect).
 # Configuration parameters: AllowForAlignment, AllowBeforeTrailingComments, ForceEqualSignAlignment.
 Layout/ExtraSpacing:
   Exclude:
+    - 'lib/fontisan/commands/info_command.rb'
     - 'lib/fontisan/hints/truetype_instruction_analyzer.rb'
+    - 'lib/fontisan/tables/sbix.rb'
+    - 'spec/fontisan/tables/sbix_spec.rb'
+    - 'spec/integration/color_emoji_fonts_spec.rb'
 
-# Offense count: 1109
+# Offense count: 1270
 # This cop supports safe autocorrection (--autocorrect).
 # Configuration parameters: Max, AllowHeredoc, AllowURI, AllowQualifiedName, URISchemes, IgnoreCopDirectives, AllowedPatterns, SplitStrings.
 # URISchemes: http, https
 Layout/LineLength:
   Enabled: false
 
-# Offense count: 26
+# Offense count: 18
+# This cop supports safe autocorrection (--autocorrect).
+# Configuration parameters: AllowInHeredoc.
+Layout/TrailingWhitespace:
+  Exclude:
+    - 'spec/fontisan/converters/woff2_encoder_integration_spec.rb'
+
+# Offense count: 27
 # Configuration parameters: IgnoreLiteralBranches, IgnoreConstantBranches, IgnoreDuplicateElseBranch.
 Lint/DuplicateBranch:
   Enabled: false
@@ -79,17 +98,26 @@ Lint/StructNewOverride:
   Exclude:
     - 'lib/fontisan/optimizers/pattern_analyzer.rb'
 
-# Offense count: 5
+# Offense count: 1
+# This cop supports safe autocorrection (--autocorrect).
+# Configuration parameters: IgnoreEmptyBlocks, AllowUnusedKeywordArguments.
+Lint/UnusedBlockArgument:
+  Exclude:
+    - 'spec/fontisan/tables/sbix_spec.rb'
+
+# Offense count: 8
 # This cop supports safe autocorrection (--autocorrect).
 # Configuration parameters: AllowUnusedKeywordArguments, IgnoreEmptyMethods, IgnoreNotImplementedMethods, NotImplementedExceptions.
 # NotImplementedExceptions: NotImplementedError
 Lint/UnusedMethodArgument:
   Exclude:
     - 'lib/fontisan/font_loader.rb'
+    - 'lib/fontisan/optimizers/charstring_rewriter.rb'
     - 'lib/fontisan/tables/cff2/private_dict_blend_handler.rb'
     - 'lib/fontisan/utilities/brotli_wrapper.rb'
     - 'lib/fontisan/variation/table_accessor.rb'
     - 'lib/fontisan/woff2/glyf_transformer.rb'
+    - 'lib/fontisan/woff_font.rb'
 
 # Offense count: 3
 # This cop supports safe autocorrection (--autocorrect).
@@ -98,39 +126,39 @@ Lint/UselessAssignment:
     - 'lib/fontisan/hints/truetype_instruction_analyzer.rb'
     - 'spec/fontisan/hints/hint_round_trip_spec.rb'
 
-# Offense count: 432
+# Offense count: 462
 # Configuration parameters: AllowedMethods, AllowedPatterns, CountRepeatedAttributes, Max.
 Metrics/AbcSize:
   Enabled: false
 
-# Offense count: 27
+# Offense count: 29
 # Configuration parameters: CountComments, CountAsOne, AllowedMethods, AllowedPatterns, inherit_mode.
 # AllowedMethods: refine
 Metrics/BlockLength:
-  Max: 80
+  Max: 91
 
 # Offense count: 8
 # Configuration parameters: CountBlocks, CountModifierForms.
 Metrics/BlockNesting:
   Max: 5
 
-# Offense count: 223
+# Offense count: 240
 # Configuration parameters: AllowedMethods, AllowedPatterns, Max.
 Metrics/CyclomaticComplexity:
   Enabled: false
 
-# Offense count: 648
+# Offense count: 699
 # Configuration parameters: CountComments, CountAsOne, AllowedMethods, AllowedPatterns.
 Metrics/MethodLength:
   Max: 135
 
-# Offense count: 17
+# Offense count: 18
 # Configuration parameters: CountKeywordArgs.
 Metrics/ParameterLists:
   Max: 39
   MaxOptionalParameters: 4
 
-# Offense count: 157
+# Offense count: 174
 # Configuration parameters: AllowedMethods, AllowedPatterns, Max.
 Metrics/PerceivedComplexity:
   Enabled: false
@@ -145,29 +173,14 @@ Naming/MethodParameterName:
     - 'lib/fontisan/tables/glyf/curve_converter.rb'
     - 'lib/fontisan/variation/optimizer.rb'
 
-# Offense count: 71
+# Offense count: 84
 # Configuration parameters: EnforcedStyle, CheckMethodNames, CheckSymbols, AllowedIdentifiers, AllowedPatterns.
 # SupportedStyles: snake_case, normalcase, non_integer
 # AllowedIdentifiers: TLS1_1, TLS1_2, capture3, iso8601, rfc1123_date, rfc822, rfc2822, rfc3339, x86_64
 Naming/VariableNumber:
-  Exclude:
-    - 'lib/fontisan/models/ttx/tables/os2_table.rb'
-    - 'lib/fontisan/subset/table_subsetter.rb'
-    - 'lib/fontisan/tables/cff/charset.rb'
-    - 'lib/fontisan/tables/cff/encoding.rb'
-    - 'lib/fontisan/tables/cmap.rb'
-    - 'lib/fontisan/tables/glyf.rb'
-    - 'lib/fontisan/tables/glyf/compound_glyph.rb'
-    - 'lib/fontisan/tables/glyf/glyph_builder.rb'
-    - 'lib/fontisan/tables/glyf/simple_glyph.rb'
-    - 'spec/fontisan/collection/table_deduplicator_spec.rb'
-    - 'spec/fontisan/tables/cff/charset_spec.rb'
-    - 'spec/fontisan/tables/glyf/glyph_builder_spec.rb'
-    - 'spec/fontisan/tables/glyf_spec.rb'
-    - 'spec/fontisan/tables/hmtx_spec.rb'
-    - 'spec/fontisan/tables/maxp_spec.rb'
+  Enabled: false
 
-# Offense count: 22
+# Offense count: 25
 # Configuration parameters: MinSize.
 Performance/CollectionLiteralInLoop:
   Exclude:
@@ -177,8 +190,10 @@ Performance/CollectionLiteralInLoop:
     - 'lib/fontisan/tables/cff/private_dict_writer.rb'
     - 'lib/fontisan/tables/cff2.rb'
     - 'lib/fontisan/tables/cff2/region_matcher.rb'
+    - 'lib/fontisan/tables/sbix.rb'
     - 'lib/fontisan/true_type_font.rb'
     - 'lib/fontisan/variation/validator.rb'
+    - 'lib/fontisan/woff2/table_transformer.rb'
     - 'spec/fontisan/cli_spec.rb'
     - 'spec/fontisan/commands/glyphs_command_spec.rb'
     - 'spec/fontisan/commands/info_command_spec.rb'
@@ -202,36 +217,40 @@ RSpec/AnyInstance:
     - 'spec/fontisan/variation/parallel_generator_spec.rb'
     - 'spec/integration/format_conversion_spec.rb'
 
-# Offense count: 100
+# Offense count: 105
 # Configuration parameters: Prefixes, AllowedPatterns.
 # Prefixes: when, with, without
 RSpec/ContextWording:
   Enabled: false
 
-# Offense count: 17
+# Offense count: 21
 # Configuration parameters: IgnoredMetadata.
 RSpec/DescribeClass:
   Enabled: false
 
-# Offense count: 1
+# Offense count: 2
 RSpec/DescribeMethod:
   Exclude:
     - 'spec/fontisan/collection/variable_font_builder_spec.rb'
+    - 'spec/fontisan/converters/woff2_encoder_integration_spec.rb'
 
-# Offense count: 1156
+# Offense count: 1263
 # Configuration parameters: CountAsOne.
 RSpec/ExampleLength:
   Max: 66
 
-# Offense count: 4
+# Offense count: 7
 # This cop supports safe autocorrection (--autocorrect).
 RSpec/ExpectActual:
   Exclude:
     - '**/spec/routing/**/*'
     - 'spec/fontisan/commands/subset_command_spec.rb'
+    - 'spec/fontisan/converters/extended_woff2_spec.rb'
+    - 'spec/fontisan/converters/woff2_round_trip_spec.rb'
     - 'spec/fontisan/subset/builder_spec.rb'
     - 'spec/fontisan/utils/thread_pool_spec.rb'
     - 'spec/fontisan/variation/validator_spec.rb'
+    - 'spec/fontisan/woff2/table_transformer_spec.rb'
 
 # Offense count: 1
 RSpec/IdenticalEqualityAssertion:
@@ -280,19 +299,20 @@ RSpec/MessageSpies:
     - 'spec/fontisan/variation/instance_writer_spec.rb'
     - 'spec/fontisan/woff2_font_spec.rb'
 
-# Offense count: 4
+# Offense count: 5
 RSpec/MultipleDescribes:
   Exclude:
     - 'spec/fontisan/loading_modes_spec.rb'
     - 'spec/fontisan/models/table_info_spec.rb'
     - 'spec/fontisan/utils/thread_pool_spec.rb'
+    - 'spec/fontisan/validation/woff2_validator_spec.rb'
     - 'spec/fontisan/variation/cache_spec.rb'
 
-# Offense count: 1494
+# Offense count: 1606
 RSpec/MultipleExpectations:
   Max: 22
 
-# Offense count: 134
+# Offense count: 135
 # Configuration parameters: AllowSubject.
 RSpec/MultipleMemoizedHelpers:
   Max: 13
@@ -375,7 +395,7 @@ Security/Open:
   Exclude:
     - 'Rakefile'
 
-# Offense count: 3
+# Offense count: 9
 # This cop supports safe autocorrection (--autocorrect).
 # Configuration parameters: EnforcedStyle, ProceduralMethods, FunctionalMethods, AllowedMethods, AllowedPatterns, AllowBracesOnProceduralOneLiners, BracesRequiredMethods.
 # SupportedStyles: line_count_based, semantic, braces_for_chaining, always_braces
@@ -384,8 +404,11 @@ Security/Open:
 # AllowedMethods: lambda, proc, it
 Style/BlockDelimiters:
   Exclude:
+    - 'spec/fontisan/converters/extended_woff2_spec.rb'
     - 'spec/fontisan/hints/hint_validator_spec.rb'
     - 'spec/fontisan/hints/truetype_instruction_analyzer_spec.rb'
+    - 'spec/fontisan/tables/colr_spec.rb'
+    - 'spec/fontisan/tables/cpal_spec.rb'
 
 # Offense count: 1
 # This cop supports unsafe autocorrection (--autocorrect-all).
@@ -427,6 +450,13 @@ Style/HashLikeCase:
     - 'lib/fontisan/commands/unpack_command.rb'
     - 'lib/fontisan/models/validation_report.rb'
 
+# Offense count: 1
+# This cop supports safe autocorrection (--autocorrect).
+# Configuration parameters: AllowIfModifier.
+Style/IfInsideElse:
+  Exclude:
+    - 'Rakefile'
+
 # Offense count: 6
 # This cop supports unsafe autocorrection (--autocorrect-all).
 # Configuration parameters: EnforcedStyle, AllowedMethods, AllowedPatterns.
@@ -454,6 +484,13 @@ Style/SoleNestedConditional:
   Exclude:
     - 'lib/fontisan/hints/hint_validator.rb'
 
+# Offense count: 4
+# This cop supports unsafe autocorrection (--autocorrect-all).
+# Configuration parameters: Mode.
+Style/StringConcatenation:
+  Exclude:
+    - 'spec/fontisan/tables/cbdt_spec.rb'
+
 # Offense count: 2
 # This cop supports safe autocorrection (--autocorrect).
 # Configuration parameters: .
@@ -462,13 +499,28 @@ Style/SymbolArray:
   EnforcedStyle: percent
   MinSize: 3
 
-# Offense count: 3
+# Offense count: 53
+# This cop supports safe autocorrection (--autocorrect).
+# Configuration parameters: EnforcedStyleForMultiline.
+# SupportedStylesForMultiline: comma, consistent_comma, diff_comma, no_comma
+Style/TrailingCommaInArguments:
+  Exclude:
+    - 'lib/fontisan/commands/info_command.rb'
+    - 'spec/fontisan/converters/woff2_encoder_integration_spec.rb'
+    - 'spec/fontisan/optimizers/charstring_rewriter_spec.rb'
+    - 'spec/fontisan/tables/cblc_spec.rb'
+    - 'spec/fontisan/tables/sbix_spec.rb'
+    - 'spec/integration/color_emoji_fonts_spec.rb'
+
+# Offense count: 12
 # This cop supports safe autocorrection (--autocorrect).
 # Configuration parameters: EnforcedStyleForMultiline.
 # SupportedStylesForMultiline: comma, consistent_comma, diff_comma, no_comma
 Style/TrailingCommaInArrayLiteral:
   Exclude:
     - 'spec/fontisan/hints/truetype_instruction_analyzer_spec.rb'
+    - 'spec/fontisan/tables/colr_spec.rb'
+    - 'spec/fontisan/tables/cpal_spec.rb'
     - 'spec/fontisan/variation/parallel_generator_spec.rb'
 
 # Offense count: 1

data/README.adoc

@@ -1300,6 +1300,173 @@ $ fontisan validate FONT.{ttc,otc}
 NOTE: In `extract_ttc`, this was done with `extract_ttc --validate FONT.ttc`.
 
 
+
+
+== Color font support
+
+=== General
+
+Fontisan provides comprehensive analysis of all color font formats defined in the OpenType specification.
+
+=== Supported color font formats
+
+Fontisan supports all four color font table formats:
+
+COLR/CPAL:: Layered color glyphs with custom color palettes (Microsoft/Google standard)
+
+SVG:: Embedded SVG graphics with gzip compression support (W3C standard)
+
+CBDT/CBLC:: Bitmap glyphs at multiple ppem sizes (Google format)
+
+sbix:: Bitmap graphics with PNG/JPEG/TIFF support (Apple format)
+
+=== Analyzing color fonts
+
+[source,ruby]
+----
+require 'fontisan'
+
+# Load and analyze a color font
+info = Fontisan.info('emoji-font.ttf')
+
+# Color glyph detection
+puts info.is_color_font       # true if COLR/CPAL present
+puts info.has_svg_table        # true if SVG table present
+puts info.has_bitmap_glyphs    # true if CBDT/CBLC or sbix present
+
+# Get color palette information (COLR/CPAL)
+if info.is_color_font
+  puts "Color glyphs: #{info.color_glyphs}"
+  puts "Color palettes: #{info.color_palettes}"
+  puts "Colors per palette: #{info.colors_per_palette}"
+end
+
+# Get SVG glyph information
+if info.has_svg_table
+  puts "SVG glyphs: #{info.svg_glyph_count}"
+end
+
+# Get bitmap information
+if info.has_bitmap_glyphs
+  puts "Bitmap formats: #{info.bitmap_formats.join(', ')}"
+  puts "Available sizes (ppem): #{info.bitmap_ppem_sizes.join(', ')}"
+
+  info.bitmap_strikes.each do |strike|
+    puts "Strike at #{strike.ppem}ppem:"
+    puts "  - Glyphs: #{strike.num_glyphs}"
+    puts "  - Color depth: #{strike.color_depth}"
+  end
+end
+----
+
+=== Color font table access
+
+Access color font tables directly:
+
+[source,ruby]
+----
+font = Fontisan::FontLoader.load('emoji-font.ttf')
+
+# Access COLR table (layered color)
+if font.has_table?('COLR')
+  colr = font.table('COLR')
+  puts "Color glyphs: #{colr.num_color_glyphs}"
+
+  # Get color layers for a glyph
+  layers = colr.layers_for_glyph(42)
+  layers.each do |layer|
+    puts "Layer glyph: #{layer.glyph_id}, Palette index: #{layer.palette_index}"
+  end
+end
+
+# Access CPAL table (color palettes)
+if font.has_table?('CPAL')
+  cpal = font.table('CPAL')
+
+  # Get colors from first palette
+  palette = cpal.palette(0)
+  palette.each_with_index do |color, i|
+    puts "Color #{i}: R=#{color.red} G=#{color.green} B=#{color.blue} A=#{color.alpha}"
+  end
+end
+
+# Access SVG table
+if font.has_table?('SVG ')
+  svg = font.table('SVG ')
+
+  # Get SVG document for glyph 100
+  svg_doc = svg.svg_document_for_glyph(100)
+  puts "Compressed: #{svg_doc.compressed?}"
+  puts "SVG data: #{svg_doc.svg_data}"
+end
+
+# Access bitmap tables
+if font.has_table?('CBLC')
+  cblc = font.table('CBLC')
+  puts "Available ppem sizes: #{cblc.ppem_sizes.join(', ')}"
+
+  # Check if glyph 50 has bitmap at 64ppem
+  if cblc.has_bitmap_for_glyph?(50, 64)
+    puts "Glyph 50 has bitmap at 64ppem"
+  end
+end
+
+if font.has_table?('sbix')
+  sbix = font.table('sbix')
+
+  # Get bitmap data for glyph 42 at 128ppem
+  glyph_data = sbix.glyph_data(42, 128)
+  if glyph_data
+    puts "Format: #{glyph_data[:graphic_type_name]}"
+    puts "Origin: (#{glyph_data[:origin_x]}, #{glyph_data[:origin_y]})"
+    puts "Data size: #{glyph_data[:data].length} bytes"
+  end
+end
+----
+
+=== Output formats
+
+Color font information can be serialized to multiple formats:
+
+[source,ruby]
+----
+info = Fontisan.info('emoji-font.ttf')
+
+# YAML output
+puts info.to_yaml
+
+# JSON output
+puts info.to_json
+
+# XML output
+puts info.to_xml
+----
+
+Example YAML output:
+
+[source,yaml]
+----
+font_format: truetype
+family_name: "Emoji Font"
+is_color_font: true
+color_glyphs: 872
+color_palettes: 1
+colors_per_palette: 256
+has_svg_table: true
+svg_glyph_count: 872
+has_bitmap_glyphs: true
+bitmap_ppem_sizes: [16, 32, 64, 128, 256]
+bitmap_formats: ["PNG"]
+bitmap_strikes:
+  - ppem: 128
+    start_glyph_id: 1
+    end_glyph_id: 872
+    bit_depth: 32
+    num_glyphs: 872
+    color_depth: "32-bit (full color with alpha)"
+----
+
+
 == Advanced features
 
 Fontisan provides capabilities:
@@ -1389,6 +1556,9 @@ The loading mode can be queried at any time.
 
 [source,ruby]
 ----
+# Check laziness
+font.lazy?                  # => true
+
 # Mode stored as font property
 font.loading_mode  # => :metadata or :full
 
@@ -1397,6 +1567,12 @@ font.table_available?(tag)  # => boolean
 
 # Access restricted based on mode
 font.table(tag)  # => Returns table or raises error
+
+# Test lazy loading with an expensive operation
+glyphs = [] if font.subset_glyphs(lazy: true) { glyphs = font.subset_glyphs }
+glyphs.count                # => Tests whether glyphs were already loaded
+font.table_available?("head") # => true (lazy loading enabled)
+font.table_available?("GSUB") # => false (lazy loading enabled)
 ----
 
 
@@ -1430,7 +1606,7 @@ fields:
 `family_name`:: Font family name (nameID 1)
 `subfamily_name`:: Font subfamily/style name (nameID 2)
 `full_name`:: Full font name (nameID 4)
-`post_script_name`:: PostScript name (nameID 6)
+`postscript_name`:: PostScript name (nameID 6)
 `preferred_family_name`:: Preferred family name (nameID 16, may be nil)
 `preferred_subfamily_name`:: Preferred subfamily name (nameID 17, may be nil)
 `units_per_em`:: Units per em from head table
@@ -1484,6 +1660,64 @@ font = Fontisan::FontLoader.load('font.ttf', mode: :full, lazy: false)
 ----
 
 
+=== Table preparedness
+
+Every table uses preparedness to avoid lazy initialization overhead. Function
+`table_available?` was added to check if table prepared for access.
+
+[source,ruby]
+----
+font = Fontisan::FontLoader.load('font.ttf')
+
+# Check preparedness
+font.table_available?("head")     # => true
+font.table_available?("GSUB")     # => true
+font.table_available?("GPOS")     # => true
+
+# Force loading of a table
+head = font.table("head")
+puts head.metrics.units_per_em    # => Asks explicitly for metric value
+puts head.metrics.weight_class    # => Asks explicitly for metric value
+print head.ty                     # => Prints force loaded table
+
+# Check preparedness after loading
+font.table_available?("head")     # => true in cache
+font.table_available?("GSUB")     # => true in cache
+font.table_available?("GPOS")     # => true in cache
+----
+
+A table not present in a font file is loaded lazily and `table_available?`
+returns `false` after loading this table or after calling directly `table` for
+the given tag:
+
+[source,ruby]
+----
+font = Fontisan::FontLoader.load('font.ttf')
+
+# Check preparedness
+font.standard_glyphs              # => instantly loading glyphs (CFF and GDEF)
+font.candlestick_and_widget_chart # => instantly loading glyphs (Colr)
+font.txt_encoder                  # => instantly loading glyphs (OutlinedFont)
+font.table_available?("post")     # => true (cached)
+
+font.table_available?("OS/2")     # => false (not loaded)
+font.table("OS/2")                # => instant loading tables (lazy loading)
+font.table_available?("OS/2")     # => true (cached)
+
+font.table_available?("VORG")     # => false (not loaded)
+font.table("VORG")                # => instant loading tables (lazy loading)
+# Raises Fontisan::Tables::VorgTableNotInFont: Not a valid sfnt font or sfnt table VORG not included in input font
+font.table_available?("VORG")     # => true (cached)
+
+font.table_available?("GLYC")     # => nil
+font.table("GLYC")                # => instant loading tables (lazy loading)
+# Raises Fontisan::TableNotFound: Table GLYC not found in font
+font.table_available?("GLYC")     # => nil (not cached)
+----
+
+NOTE: If you do not need to check whether the table is present before access
+it is faster to access directly `table` method and catch error with validation
+than first call table_available? for the table not present in the font file.
 
 
 == Outline format conversion
@@ -1599,6 +1833,31 @@ converter.supported_targets(:ttf)
 # => [:ttf, :otf, :woff2, :svg]
 ----
 
+=== Convert into WOFF2
+
+==== Validation
+
+WOFF2 encoding can be validated automatically to ensure spec compliance:
+
+.Validation example
+[example]
+====
+[source,ruby]
+----
+encoder = Fontisan::Converters::Woff2Encoder.new
+result = encoder.convert(font, {
+  transform_tables: true,
+  validate: true,
+  validation_level: :strict  # :strict, :standard, or :lenient
+})
+
+report = result[:validation_report]
+puts "Valid: #{report.valid}"
+puts "Compression: #{report.info_issues.first.message}"
+----
+====
+
+
 
 === Validation
 
@@ -2117,7 +2376,7 @@ end
 ====
 
 
-== Round-Trip validation
+== Round-trip validation
 
 === General
 
@@ -2190,7 +2449,7 @@ Loron.
 
 Support for layered import CFF color glyphs rasterizing on demand, with
 composite font support, a multi-layer color font represented by many
-CFF fonts stacked on top of each other.	ColorGlyph support contains
+CFF fonts stacked on top of each other.  ColorGlyph support contains
 color glyphs, advanced color fonts glyphs and raster images (PNG or JPG)
 combined with TrueType outlines.
 

data/Rakefile

@@ -87,6 +87,9 @@ namespace :fixtures do
 
   # Create file tasks for each font
   fonts.each do |name, config|
+    # Skip fonts that should not be downloaded (already committed)
+    next if config[:skip_download]
+
     file config[:marker] do
       if config[:single_file]
         download_single_file(name, config[:url], config[:marker])
@@ -97,16 +100,26 @@ namespace :fixtures do
   end
 
   desc "Download all test fixture fonts"
-  task download: fonts.values.map { |config| config[:marker] }
+  task download: fonts.values.reject { |config| config[:skip_download] }.map { |config| config[:marker] }
 
   desc "Clean downloaded fixtures"
   task :clean do
-    fonts.values.map { |config| config[:target_dir] }.each do |path|
-      next unless File.exist?(path)
-
-      puts "[fixtures:clean] Removing #{path}..."
-      FileUtils.rm_rf(path)
-      puts "[fixtures:clean] Removed #{path}"
+    fonts.values.reject { |config| config[:skip_download] }.each do |config|
+      if config[:single_file]
+        # For single files, just delete the marker file itself
+        if File.exist?(config[:marker])
+          puts "[fixtures:clean] Removing #{config[:marker]}..."
+          FileUtils.rm_f(config[:marker])
+          puts "[fixtures:clean] Removed #{config[:marker]}"
+        end
+      else
+        # For archives, delete the entire target directory
+        if File.exist?(config[:target_dir])
+          puts "[fixtures:clean] Removing #{config[:target_dir]}..."
+          FileUtils.rm_rf(config[:target_dir])
+          puts "[fixtures:clean] Removed #{config[:target_dir]}"
+        end
+      end
     end
   end
 end