fontisan 0.1.0 → 0.2.1

data/lib/fontisan/models/collection_font_summary.rb

@@ -0,0 +1,52 @@
+# frozen_string_literal: true
+
+require "lutaml/model"
+
+module Fontisan
+  module Models
+    # Model for individual font summary within a collection
+    #
+    # Represents basic metadata for a single font in a TTC/OTC collection.
+    # Used by CollectionListInfo to provide per-font summaries.
+    #
+    # @example Creating a font summary
+    #   summary = CollectionFontSummary.new(
+    #     index: 0,
+    #     family_name: "Helvetica",
+    #     subfamily_name: "Regular",
+    #     postscript_name: "Helvetica-Regular",
+    #     font_format: "TrueType",
+    #     num_glyphs: 268,
+    #     num_tables: 14
+    #   )
+    class CollectionFontSummary < Lutaml::Model::Serializable
+      attribute :index, :integer
+      attribute :family_name, :string
+      attribute :subfamily_name, :string
+      attribute :postscript_name, :string
+      attribute :font_format, :string
+      attribute :num_glyphs, :integer
+      attribute :num_tables, :integer
+
+      yaml do
+        map "index", to: :index
+        map "family_name", to: :family_name
+        map "subfamily_name", to: :subfamily_name
+        map "postscript_name", to: :postscript_name
+        map "font_format", to: :font_format
+        map "num_glyphs", to: :num_glyphs
+        map "num_tables", to: :num_tables
+      end
+
+      json do
+        map "index", to: :index
+        map "family_name", to: :family_name
+        map "subfamily_name", to: :subfamily_name
+        map "postscript_name", to: :postscript_name
+        map "font_format", to: :font_format
+        map "num_glyphs", to: :num_glyphs
+        map "num_tables", to: :num_tables
+      end
+    end
+  end
+end

data/lib/fontisan/models/collection_info.rb

@@ -0,0 +1,76 @@
+# frozen_string_literal: true
+
+require "lutaml/model"
+require_relative "table_sharing_info"
+
+module Fontisan
+  module Models
+    # Model for collection metadata
+    #
+    # Represents comprehensive information about a TTC/OTC collection.
+    # Used by InfoCommand when operating on collection files.
+    #
+    # @example Creating collection info
+    #   info = CollectionInfo.new(
+    #     collection_path: "fonts.ttc",
+    #     collection_format: "TTC",
+    #     ttc_tag: "ttcf",
+    #     major_version: 2,
+    #     minor_version: 0,
+    #     num_fonts: 6,
+    #     font_offsets: [48, 380, 712, 1044, 1376, 1676],
+    #     file_size_bytes: 2240000,
+    #     table_sharing: table_sharing_obj
+    #   )
+    class CollectionInfo < Lutaml::Model::Serializable
+      attribute :collection_path, :string
+      attribute :collection_format, :string
+      attribute :ttc_tag, :string
+      attribute :major_version, :integer
+      attribute :minor_version, :integer
+      attribute :num_fonts, :integer
+      attribute :font_offsets, :integer, collection: true
+      attribute :file_size_bytes, :integer
+      attribute :table_sharing, TableSharingInfo
+
+      yaml do
+        map "collection_path", to: :collection_path
+        map "collection_format", to: :collection_format
+        map "ttc_tag", to: :ttc_tag
+        map "major_version", to: :major_version
+        map "minor_version", to: :minor_version
+        map "num_fonts", to: :num_fonts
+        map "font_offsets", to: :font_offsets
+        map "file_size_bytes", to: :file_size_bytes
+        map "table_sharing", to: :table_sharing
+      end
+
+      json do
+        map "collection_path", to: :collection_path
+        map "collection_format", to: :collection_format
+        map "ttc_tag", to: :ttc_tag
+        map "major_version", to: :major_version
+        map "minor_version", to: :minor_version
+        map "num_fonts", to: :num_fonts
+        map "font_offsets", to: :font_offsets
+        map "file_size_bytes", to: :file_size_bytes
+        map "table_sharing", to: :table_sharing
+      end
+
+      # Get version as a formatted string
+      #
+      # @return [String] Version string (e.g., "2.0")
+      def version_string
+        "#{major_version}.#{minor_version}"
+      end
+
+      # Get version as a hexadecimal string
+      #
+      # @return [String] Hex version (e.g., "0x00020000")
+      def version_hex
+        version_int = (major_version << 16) | minor_version
+        format("0x%08X", version_int)
+      end
+    end
+  end
+end

data/lib/fontisan/models/collection_list_info.rb

@@ -0,0 +1,37 @@
+# frozen_string_literal: true
+
+require "lutaml/model"
+require_relative "collection_font_summary"
+
+module Fontisan
+  module Models
+    # Model for collection font listing
+    #
+    # Represents a list of fonts within a TTC/OTC collection.
+    # Used by LsCommand when operating on collection files.
+    #
+    # @example Creating a collection list
+    #   list = CollectionListInfo.new(
+    #     collection_path: "fonts.ttc",
+    #     num_fonts: 6,
+    #     fonts: [summary1, summary2, ...]
+    #   )
+    class CollectionListInfo < Lutaml::Model::Serializable
+      attribute :collection_path, :string
+      attribute :num_fonts, :integer
+      attribute :fonts, CollectionFontSummary, collection: true
+
+      yaml do
+        map "collection_path", to: :collection_path
+        map "num_fonts", to: :num_fonts
+        map "fonts", to: :fonts
+      end
+
+      json do
+        map "collection_path", to: :collection_path
+        map "num_fonts", to: :num_fonts
+        map "fonts", to: :fonts
+      end
+    end
+  end
+end

data/lib/fontisan/models/font_export.rb

@@ -0,0 +1,158 @@
+# frozen_string_literal: true
+
+require "lutaml/model"
+
+module Fontisan
+  module Models
+    # FontExport represents complete font structure for export to YAML/JSON
+    #
+    # This model encapsulates the entire font structure including header
+    # information, all tables (parsed and binary), and metadata. It supports
+    # round-trip conversion: font → export → import → font.
+    #
+    # @example Exporting a font
+    #   export = FontExport.new(source_file: "font.ttf")
+    #   export.extract_from_font(font)
+    #   yaml_output = export.to_yaml
+    #
+    # @example Importing from YAML
+    #   export = FontExport.from_yaml(yaml_string)
+    #   font = export.rebuild_font
+    class FontExport < Lutaml::Model::Serializable
+      # Metadata about the export
+      class Metadata < Lutaml::Model::Serializable
+        attribute :source_file, :string
+        attribute :export_date, :string
+        attribute :exporter_version, :string
+        attribute :font_format, :string
+
+        yaml do
+          map "source_file", to: :source_file
+          map "export_date", to: :export_date
+          map "exporter_version", to: :exporter_version
+          map "font_format", to: :font_format
+        end
+
+        json do
+          map "source_file", to: :source_file
+          map "export_date", to: :export_date
+          map "exporter_version", to: :exporter_version
+          map "font_format", to: :font_format
+        end
+      end
+
+      # Font header information
+      class Header < Lutaml::Model::Serializable
+        attribute :sfnt_version, :string
+        attribute :num_tables, :integer
+        attribute :search_range, :integer
+        attribute :entry_selector, :integer
+        attribute :range_shift, :integer
+
+        yaml do
+          map "sfnt_version", to: :sfnt_version
+          map "num_tables", to: :num_tables
+          map "search_range", to: :search_range
+          map "entry_selector", to: :entry_selector
+          map "range_shift", to: :range_shift
+        end
+
+        json do
+          map "sfnt_version", to: :sfnt_version
+          map "num_tables", to: :num_tables
+          map "search_range", to: :search_range
+          map "entry_selector", to: :entry_selector
+          map "range_shift", to: :range_shift
+        end
+      end
+
+      # Individual table export
+      class TableExport < Lutaml::Model::Serializable
+        attribute :tag, :string
+        attribute :checksum, :string
+        attribute :parsed, :boolean, default: -> { false }
+        attribute :data, :string, default: -> { nil }
+        attribute :fields, :string, default: -> { nil }
+
+        yaml do
+          map "tag", to: :tag
+          map "checksum", to: :checksum
+          map "parsed", to: :parsed
+          map "data", to: :data
+          map "fields", to: :fields
+        end
+
+        json do
+          map "tag", to: :tag
+          map "checksum", to: :checksum
+          map "parsed", to: :parsed
+          map "data", to: :data
+          map "fields", to: :fields
+        end
+      end
+
+      attribute :metadata, Metadata
+      attribute :header, Header
+      attribute :tables, TableExport, collection: true, default: -> { [] }
+
+      yaml do
+        map "metadata", to: :metadata
+        map "header", to: :header
+        map "tables", to: :tables
+      end
+
+      json do
+        map "metadata", to: :metadata
+        map "header", to: :header
+        map "tables", to: :tables
+      end
+
+      # Find a table by tag
+      #
+      # @param tag [String] The table tag (e.g., "head", "name")
+      # @return [TableExport, nil] The table or nil if not found
+      def find_table(tag)
+        tables.find { |t| t.tag == tag }
+      end
+
+      # Get all parsed tables
+      #
+      # @return [Array<TableExport>] Array of parsed tables
+      def parsed_tables
+        tables.select(&:parsed)
+      end
+
+      # Get all binary-only tables
+      #
+      # @return [Array<TableExport>] Array of binary tables
+      def binary_tables
+        tables.reject(&:parsed)
+      end
+
+      # Add a table to the export
+      #
+      # @param tag [String] Table tag
+      # @param checksum [String] Table checksum
+      # @param parsed [Boolean] Whether table is parsed
+      # @param data [String, nil] Binary data (hex/base64)
+      # @param fields [Hash, nil] Parsed fields as Hash/JSON
+      # @return [void]
+      def add_table(tag:, checksum:, parsed: false, data: nil, fields: nil)
+        tables << TableExport.new(
+          tag: tag,
+          checksum: checksum,
+          parsed: parsed,
+          data: data,
+          fields: fields,
+        )
+      end
+
+      # Validate export structure
+      #
+      # @return [Boolean] True if export is valid
+      def valid?
+        !metadata.nil? && !header.nil? && !tables.empty?
+      end
+    end
+  end
+end

data/lib/fontisan/models/font_summary.rb

@@ -0,0 +1,48 @@
+# frozen_string_literal: true
+
+require "lutaml/model"
+
+module Fontisan
+  module Models
+    # Model for quick font summary
+    #
+    # Represents a brief overview of an individual font file.
+    # Used by LsCommand when operating on TTF/OTF files.
+    #
+    # @example Creating a font summary
+    #   summary = FontSummary.new(
+    #     font_path: "font.ttf",
+    #     family_name: "Helvetica",
+    #     subfamily_name: "Regular",
+    #     font_format: "TrueType",
+    #     num_glyphs: 268,
+    #     num_tables: 14
+    #   )
+    class FontSummary < Lutaml::Model::Serializable
+      attribute :font_path, :string
+      attribute :family_name, :string
+      attribute :subfamily_name, :string
+      attribute :font_format, :string
+      attribute :num_glyphs, :integer
+      attribute :num_tables, :integer
+
+      yaml do
+        map "font_path", to: :font_path
+        map "family_name", to: :family_name
+        map "subfamily_name", to: :subfamily_name
+        map "font_format", to: :font_format
+        map "num_glyphs", to: :num_glyphs
+        map "num_tables", to: :num_tables
+      end
+
+      json do
+        map "font_path", to: :font_path
+        map "family_name", to: :family_name
+        map "subfamily_name", to: :subfamily_name
+        map "font_format", to: :font_format
+        map "num_glyphs", to: :num_glyphs
+        map "num_tables", to: :num_tables
+      end
+    end
+  end
+end