fontisan 0.1.0 → 0.2.0

data/lib/fontisan/models/ttx/glyph_order.rb

@@ -0,0 +1,31 @@
+# frozen_string_literal: true
+
+require "lutaml/model"
+
+module Fontisan
+  module Models
+    module Ttx
+      # GlyphID entry in GlyphOrder
+      class GlyphId < Lutaml::Model::Serializable
+        attribute :id, :integer
+        attribute :name, :string
+
+        xml do
+          root "GlyphID"
+          map_attribute "id", to: :id
+          map_attribute "name", to: :name
+        end
+      end
+
+      # GlyphOrder section in TTX
+      class GlyphOrder < Lutaml::Model::Serializable
+        attribute :glyph_ids, GlyphId, collection: true
+
+        xml do
+          root "GlyphOrder"
+          map_element "GlyphID", to: :glyph_ids
+        end
+      end
+    end
+  end
+end

data/lib/fontisan/models/ttx/tables/binary_table.rb

@@ -0,0 +1,67 @@
+# frozen_string_literal: true
+
+require "lutaml/model"
+
+module Fontisan
+  module Models
+    module Ttx
+      module Tables
+        # BinaryTable represents unparsed tables in TTX format
+        #
+        # Used as a fallback for tables that don't have specific
+        # parsers, storing them as hexdata following fonttools format.
+        class BinaryTable < Lutaml::Model::Serializable
+          attribute :tag, :string
+          attribute :hexdata, :string
+
+          # Custom serialization since we need dynamic root element
+          # based on table tag
+          def to_xml(options = {})
+            builder = Nokogiri::XML::Builder.new(encoding: "UTF-8") do |xml|
+              xml.send(tag.to_sym) do
+                xml.hexdata do
+                  xml.text("\n    #{format_hexdata(hexdata)}\n  ")
+                end
+              end
+            end
+
+            if options[:pretty]
+              builder.doc.root.to_xml(indent: options.fetch(:indent, 2))
+            else
+              builder.to_xml
+            end
+          end
+
+          # Parse from XML
+          def self.from_xml(xml_string, tag)
+            doc = Nokogiri::XML(xml_string)
+            table_elem = doc.at_xpath("//#{tag}")
+            return nil unless table_elem
+
+            hexdata_elem = table_elem.at_xpath("hexdata")
+            hexdata = hexdata_elem ? parse_hexdata(hexdata_elem.text) : ""
+
+            new(tag: tag, hexdata: hexdata)
+          end
+
+          private
+
+          # Format hexdata for output
+          def format_hexdata(data)
+            return "" if data.nil? || data.empty?
+
+            hex = data.unpack1("H*")
+            # Format in lines of 64 hex chars (32 bytes)
+            hex.scan(/.{1,64}/).join("\n    ")
+          end
+
+          # Parse hexdata from XML
+          def self.parse_hexdata(hex_str)
+            hex_clean = hex_str.gsub(/\s+/, "")
+            [hex_clean].pack("H*")
+          end
+        end
+      end
+    end
+  end
+end

data/lib/fontisan/models/ttx/tables/head_table.rb

@@ -0,0 +1,74 @@
+# frozen_string_literal: true
+
+require "lutaml/model"
+
+module Fontisan
+  module Models
+    module Ttx
+      module Tables
+        # HeadTable represents the 'head' table in TTX format
+        #
+        # Contains global font metrics and metadata following the OpenType
+        # specification for the head table.
+        class HeadTable < Lutaml::Model::Serializable
+          attribute :table_version, :float
+          attribute :font_revision, :float
+          attribute :checksum_adjustment, :integer
+          attribute :magic_number, :integer
+          attribute :flags, :integer
+          attribute :units_per_em, :integer
+          attribute :created, :string
+          attribute :modified, :string
+          attribute :x_min, :integer
+          attribute :y_min, :integer
+          attribute :x_max, :integer
+          attribute :y_max, :integer
+          attribute :mac_style, :string
+          attribute :lowest_rec_ppem, :integer
+          attribute :font_direction_hint, :integer
+          attribute :index_to_loc_format, :integer
+          attribute :glyph_data_format, :integer
+
+          xml do
+            root "head"
+
+            map_element "tableVersion", to: :table_version,
+                                        render_default: true
+            map_element "fontRevision", to: :font_revision,
+                                        render_default: true
+            map_element "checkSumAdjustment", to: :checksum_adjustment,
+                                              render_default: true
+            map_element "magicNumber", to: :magic_number,
+                                       render_default: true
+            map_element "flags", to: :flags,
+                                 render_default: true
+            map_element "unitsPerEm", to: :units_per_em,
+                                      render_default: true
+            map_element "created", to: :created,
+                                   render_default: true
+            map_element "modified", to: :modified,
+                                    render_default: true
+            map_element "xMin", to: :x_min,
+                                render_default: true
+            map_element "yMin", to: :y_min,
+                                render_default: true
+            map_element "xMax", to: :x_max,
+                                render_default: true
+            map_element "yMax", to: :y_max,
+                                render_default: true
+            map_element "macStyle", to: :mac_style,
+                                    render_default: true
+            map_element "lowestRecPPEM", to: :lowest_rec_ppem,
+                                         render_default: true
+            map_element "fontDirectionHint", to: :font_direction_hint,
+                                             render_default: true
+            map_element "indexToLocFormat", to: :index_to_loc_format,
+                                            render_default: true
+            map_element "glyphDataFormat", to: :glyph_data_format,
+                                           render_default: true
+          end
+        end
+      end
+    end
+  end
+end

data/lib/fontisan/models/ttx/tables/hhea_table.rb

@@ -0,0 +1,74 @@
+# frozen_string_literal: true
+
+require "lutaml/model"
+
+module Fontisan
+  module Models
+    module Ttx
+      module Tables
+        # HheaTable represents the 'hhea' table in TTX format
+        #
+        # Contains horizontal header information following the OpenType
+        # specification for the hhea table.
+        class HheaTable < Lutaml::Model::Serializable
+          attribute :table_version, :string
+          attribute :ascent, :integer
+          attribute :descent, :integer
+          attribute :line_gap, :integer
+          attribute :advance_width_max, :integer
+          attribute :min_left_side_bearing, :integer
+          attribute :min_right_side_bearing, :integer
+          attribute :x_max_extent, :integer
+          attribute :caret_slope_rise, :integer
+          attribute :caret_slope_run, :integer
+          attribute :caret_offset, :integer
+          attribute :reserved0, :integer, default: -> { 0 }
+          attribute :reserved1, :integer, default: -> { 0 }
+          attribute :reserved2, :integer, default: -> { 0 }
+          attribute :reserved3, :integer, default: -> { 0 }
+          attribute :metric_data_format, :integer
+          attribute :number_of_h_metrics, :integer
+
+          xml do
+            root "hhea"
+
+            map_element "tableVersion", to: :table_version,
+                                        render_default: true
+            map_element "ascent", to: :ascent,
+                                  render_default: true
+            map_element "descent", to: :descent,
+                                   render_default: true
+            map_element "lineGap", to: :line_gap,
+                                   render_default: true
+            map_element "advanceWidthMax", to: :advance_width_max,
+                                           render_default: true
+            map_element "minLeftSideBearing", to: :min_left_side_bearing,
+                                              render_default: true
+            map_element "minRightSideBearing", to: :min_right_side_bearing,
+                                               render_default: true
+            map_element "xMaxExtent", to: :x_max_extent,
+                                      render_default: true
+            map_element "caretSlopeRise", to: :caret_slope_rise,
+                                          render_default: true
+            map_element "caretSlopeRun", to: :caret_slope_run,
+                                         render_default: true
+            map_element "caretOffset", to: :caret_offset,
+                                       render_default: true
+            map_element "reserved0", to: :reserved0,
+                                     render_default: true
+            map_element "reserved1", to: :reserved1,
+                                     render_default: true
+            map_element "reserved2", to: :reserved2,
+                                     render_default: true
+            map_element "reserved3", to: :reserved3,
+                                     render_default: true
+            map_element "metricDataFormat", to: :metric_data_format,
+                                            render_default: true
+            map_element "numberOfHMetrics", to: :number_of_h_metrics,
+                                            render_default: true
+          end
+        end
+      end
+    end
+  end
+end

data/lib/fontisan/models/ttx/tables/maxp_table.rb

@@ -0,0 +1,55 @@
+# frozen_string_literal: true
+
+require "lutaml/model"
+
+module Fontisan
+  module Models
+    module Ttx
+      module Tables
+        # MaxpTable represents the 'maxp' table in TTX format
+        #
+        # Contains maximum profile information following the OpenType
+        # specification for the maxp table.
+        class MaxpTable < Lutaml::Model::Serializable
+          attribute :table_version, :string
+          attribute :num_glyphs, :integer
+          attribute :max_points, :integer
+          attribute :max_contours, :integer
+          attribute :max_composite_points, :integer
+          attribute :max_composite_contours, :integer
+          attribute :max_zones, :integer
+          attribute :max_twilight_points, :integer
+          attribute :max_storage, :integer
+          attribute :max_function_defs, :integer
+          attribute :max_instruction_defs, :integer
+          attribute :max_stack_elements, :integer
+          attribute :max_size_of_instructions, :integer
+          attribute :max_component_elements, :integer
+          attribute :max_component_depth, :integer
+
+          xml do
+            root "maxp"
+
+            map_element "tableVersion", to: :table_version,
+                                        render_default: true
+            map_element "numGlyphs", to: :num_glyphs,
+                                     render_default: true
+            map_element "maxPoints", to: :max_points
+            map_element "maxContours", to: :max_contours
+            map_element "maxCompositePoints", to: :max_composite_points
+            map_element "maxCompositeContours", to: :max_composite_contours
+            map_element "maxZones", to: :max_zones
+            map_element "maxTwilightPoints", to: :max_twilight_points
+            map_element "maxStorage", to: :max_storage
+            map_element "maxFunctionDefs", to: :max_function_defs
+            map_element "maxInstructionDefs", to: :max_instruction_defs
+            map_element "maxStackElements", to: :max_stack_elements
+            map_element "maxSizeOfInstructions", to: :max_size_of_instructions
+            map_element "maxComponentElements", to: :max_component_elements
+            map_element "maxComponentDepth", to: :max_component_depth
+          end
+        end
+      end
+    end
+  end
+end

data/lib/fontisan/models/ttx/tables/name_table.rb

@@ -0,0 +1,45 @@
+# frozen_string_literal: true
+
+require "lutaml/model"
+
+module Fontisan
+  module Models
+    module Ttx
+      module Tables
+        # NameRecord represents a single name record in the name table
+        class NameRecord < Lutaml::Model::Serializable
+          attribute :name_id, :integer
+          attribute :platform_id, :integer
+          attribute :plat_enc_id, :integer
+          attribute :lang_id, :string
+          attribute :string, :string
+
+          xml do
+            root "namerecord"
+
+            map_attribute "nameID", to: :name_id
+            map_attribute "platformID", to: :platform_id
+            map_attribute "platEncID", to: :plat_enc_id
+            map_attribute "langID", to: :lang_id
+
+            map_content to: :string
+          end
+        end
+
+        # NameTable represents the 'name' table in TTX format
+        #
+        # Contains human-readable information about the font following
+        # the OpenType specification for the name table.
+        class NameTable < Lutaml::Model::Serializable
+          attribute :name_records, NameRecord, collection: true
+
+          xml do
+            root "name"
+
+            map_element "namerecord", to: :name_records
+          end
+        end
+      end
+    end
+  end
+end

data/lib/fontisan/models/ttx/tables/os2_table.rb

@@ -0,0 +1,157 @@
+# frozen_string_literal: true
+
+require "lutaml/model"
+
+module Fontisan
+  module Models
+    module Ttx
+      module Tables
+        # Panose classification in OS/2 table
+        class Panose < Lutaml::Model::Serializable
+          attribute :b_family_type, :integer
+          attribute :b_serif_style, :integer
+          attribute :b_weight, :integer
+          attribute :b_proportion, :integer
+          attribute :b_contrast, :integer
+          attribute :b_stroke_variation, :integer
+          attribute :b_arm_style, :integer
+          attribute :b_letter_form, :integer
+          attribute :b_midline, :integer
+          attribute :b_x_height, :integer
+
+          xml do
+            root "panose"
+
+            map_element "bFamilyType", to: :b_family_type,
+                                       render_default: true
+            map_element "bSerifStyle", to: :b_serif_style,
+                                       render_default: true
+            map_element "bWeight", to: :b_weight,
+                                   render_default: true
+            map_element "bProportion", to: :b_proportion,
+                                       render_default: true
+            map_element "bContrast", to: :b_contrast,
+                                     render_default: true
+            map_element "bStrokeVariation", to: :b_stroke_variation,
+                                            render_default: true
+            map_element "bArmStyle", to: :b_arm_style,
+                                     render_default: true
+            map_element "bLetterForm", to: :b_letter_form,
+                                       render_default: true
+            map_element "bMidline", to: :b_midline,
+                                    render_default: true
+            map_element "bXHeight", to: :b_x_height,
+                                    render_default: true
+          end
+        end
+
+        # Os2Table represents the 'OS/2' table in TTX format
+        #
+        # Contains OS/2 and Windows-specific metrics following the
+        # OpenType specification for the OS/2 table.
+        class Os2Table < Lutaml::Model::Serializable
+          attribute :version, :integer
+          attribute :x_avg_char_width, :integer
+          attribute :us_weight_class, :integer
+          attribute :us_width_class, :integer
+          attribute :fs_type, :string
+          attribute :y_subscript_x_size, :integer
+          attribute :y_subscript_y_size, :integer
+          attribute :y_subscript_x_offset, :integer
+          attribute :y_subscript_y_offset, :integer
+          attribute :y_superscript_x_size, :integer
+          attribute :y_superscript_y_size, :integer
+          attribute :y_superscript_x_offset, :integer
+          attribute :y_superscript_y_offset, :integer
+          attribute :y_strikeout_size, :integer
+          attribute :y_strikeout_position, :integer
+          attribute :s_family_class, :integer
+          attribute :panose, Panose
+          attribute :ul_unicode_range_1, :string
+          attribute :ul_unicode_range_2, :string
+          attribute :ul_unicode_range_3, :string
+          attribute :ul_unicode_range_4, :string
+          attribute :ach_vend_id, :string
+          attribute :fs_selection, :string
+          attribute :us_first_char_index, :integer
+          attribute :us_last_char_index, :integer
+          attribute :s_typo_ascender, :integer
+          attribute :s_typo_descender, :integer
+          attribute :s_typo_line_gap, :integer
+          attribute :us_win_ascent, :integer
+          attribute :us_win_descent, :integer
+          attribute :ul_code_page_range_1, :string
+          attribute :ul_code_page_range_2, :string
+
+          xml do
+            root "OS_2"
+
+            map_element "version", to: :version,
+                                   render_default: true
+            map_element "xAvgCharWidth", to: :x_avg_char_width,
+                                         render_default: true
+            map_element "usWeightClass", to: :us_weight_class,
+                                         render_default: true
+            map_element "usWidthClass", to: :us_width_class,
+                                        render_default: true
+            map_element "fsType", to: :fs_type,
+                                  render_default: true
+            map_element "ySubscriptXSize", to: :y_subscript_x_size,
+                                           render_default: true
+            map_element "ySubscriptYSize", to: :y_subscript_y_size,
+                                           render_default: true
+            map_element "ySubscriptXOffset", to: :y_subscript_x_offset,
+                                             render_default: true
+            map_element "ySubscriptYOffset", to: :y_subscript_y_offset,
+                                             render_default: true
+            map_element "ySuperscriptXSize", to: :y_superscript_x_size,
+                                             render_default: true
+            map_element "ySuperscriptYSize", to: :y_superscript_y_size,
+                                             render_default: true
+            map_element "ySuperscriptXOffset", to: :y_superscript_x_offset,
+                                               render_default: true
+            map_element "ySuperscriptYOffset", to: :y_superscript_y_offset,
+                                               render_default: true
+            map_element "yStrikeoutSize", to: :y_strikeout_size,
+                                          render_default: true
+            map_element "yStrikeoutPosition", to: :y_strikeout_position,
+                                              render_default: true
+            map_element "sFamilyClass", to: :s_family_class,
+                                        render_default: true
+            map_element "panose", to: :panose
+            map_element "ulUnicodeRange1", to: :ul_unicode_range_1,
+                                           render_default: true
+            map_element "ulUnicodeRange2", to: :ul_unicode_range_2,
+                                           render_default: true
+            map_element "ulUnicodeRange3", to: :ul_unicode_range_3,
+                                           render_default: true
+            map_element "ulUnicodeRange4", to: :ul_unicode_range_4,
+                                           render_default: true
+            map_element "achVendID", to: :ach_vend_id,
+                                     render_default: true
+            map_element "fsSelection", to: :fs_selection,
+                                       render_default: true
+            map_element "usFirstCharIndex", to: :us_first_char_index,
+                                            render_default: true
+            map_element "usLastCharIndex", to: :us_last_char_index,
+                                           render_default: true
+            map_element "sTypoAscender", to: :s_typo_ascender,
+                                         render_default: true
+            map_element "sTypoDescender", to: :s_typo_descender,
+                                          render_default: true
+            map_element "sTypoLineGap", to: :s_typo_line_gap,
+                                        render_default: true
+            map_element "usWinAscent", to: :us_win_ascent,
+                                       render_default: true
+            map_element "usWinDescent", to: :us_win_descent,
+                                        render_default: true
+            map_element "ulCodePageRange1", to: :ul_code_page_range_1,
+                                            render_default: true
+            map_element "ulCodePageRange2", to: :ul_code_page_range_2,
+                                            render_default: true
+          end
+        end
+      end
+    end
+  end
+end

data/lib/fontisan/models/ttx/tables/post_table.rb

@@ -0,0 +1,50 @@
+# frozen_string_literal: true
+
+require "lutaml/model"
+
+module Fontisan
+  module Models
+    module Ttx
+      module Tables
+        # PostTable represents the 'post' table in TTX format
+        #
+        # Contains PostScript information following the OpenType
+        # specification for the post table.
+        class PostTable < Lutaml::Model::Serializable
+          attribute :format_type, :float
+          attribute :italic_angle, :float
+          attribute :underline_position, :integer
+          attribute :underline_thickness, :integer
+          attribute :is_fixed_pitch, :integer
+          attribute :min_mem_type42, :integer
+          attribute :max_mem_type42, :integer
+          attribute :min_mem_type1, :integer
+          attribute :max_mem_type1, :integer
+
+          xml do
+            root "post"
+
+            map_element "formatType", to: :format_type,
+                                      render_default: true
+            map_element "italicAngle", to: :italic_angle,
+                                       render_default: true
+            map_element "underlinePosition", to: :underline_position,
+                                             render_default: true
+            map_element "underlineThickness", to: :underline_thickness,
+                                              render_default: true
+            map_element "isFixedPitch", to: :is_fixed_pitch,
+                                        render_default: true
+            map_element "minMemType42", to: :min_mem_type42,
+                                        render_default: true
+            map_element "maxMemType42", to: :max_mem_type42,
+                                        render_default: true
+            map_element "minMemType1", to: :min_mem_type1,
+                                       render_default: true
+            map_element "maxMemType1", to: :max_mem_type1,
+                                       render_default: true
+          end
+        end
+      end
+    end
+  end
+end

data/lib/fontisan/models/ttx/ttfont.rb

@@ -0,0 +1,49 @@
+# frozen_string_literal: true
+
+require "lutaml/model"
+require_relative "glyph_order"
+require_relative "tables/head_table"
+require_relative "tables/name_table"
+require_relative "tables/maxp_table"
+require_relative "tables/hhea_table"
+require_relative "tables/os2_table"
+require_relative "tables/post_table"
+require_relative "tables/binary_table"
+
+module Fontisan
+  module Models
+    module Ttx
+      # Root TTFont element for TTX format
+      #
+      # Represents the complete TTX XML structure following fonttools format.
+      # This is the main container for all font data in TTX format.
+      class TtFont < Lutaml::Model::Serializable
+        attribute :sfnt_version, :string
+        attribute :ttlib_version, :string, default: -> { "4.0" }
+        attribute :glyph_order, GlyphOrder
+        attribute :head_table, Tables::HeadTable
+        attribute :hhea_table, Tables::HheaTable
+        attribute :maxp_table, Tables::MaxpTable
+        attribute :name_table, Tables::NameTable
+        attribute :os2_table, Tables::Os2Table
+        attribute :post_table, Tables::PostTable
+        attribute :binary_tables, Tables::BinaryTable, collection: true
+
+        xml do
+          root "ttFont"
+
+          map_attribute "sfntVersion", to: :sfnt_version
+          map_attribute "ttLibVersion", to: :ttlib_version
+
+          map_element "GlyphOrder", to: :glyph_order
+          map_element "head", to: :head_table
+          map_element "hhea", to: :hhea_table
+          map_element "maxp", to: :maxp_table
+          map_element "name", to: :name_table
+          map_element "OS_2", to: :os2_table
+          map_element "post", to: :post_table
+        end
+      end
+    end
+  end
+end