harfbuzz-ruby 1.0.0

data/lib/harfbuzz/c/ot/math.rb

@@ -0,0 +1,23 @@
+# frozen_string_literal: true
+
+module HarfBuzz
+  module C
+    attach_function :hb_ot_math_has_data, [:hb_face_t], :hb_bool_t
+    attach_function :hb_ot_math_get_constant, [:hb_font_t, :uint], :hb_position_t
+    attach_function :hb_ot_math_get_glyph_italics_correction,
+      [:hb_font_t, :hb_codepoint_t], :hb_position_t
+    attach_function :hb_ot_math_get_glyph_top_accent_attachment,
+      [:hb_font_t, :hb_codepoint_t], :hb_position_t
+    attach_function :hb_ot_math_is_glyph_extended_shape,
+      [:hb_face_t, :hb_codepoint_t], :hb_bool_t
+    attach_function :hb_ot_math_get_glyph_kerning,
+      [:hb_font_t, :hb_codepoint_t, :uint, :hb_position_t], :hb_position_t
+    attach_function :hb_ot_math_get_glyph_variants,
+      [:hb_font_t, :hb_codepoint_t, :hb_direction_t, :uint, :pointer, :pointer], :uint
+    attach_function :hb_ot_math_get_glyph_assembly,
+      [:hb_font_t, :hb_codepoint_t, :hb_direction_t,
+       :uint, :pointer, :pointer, :pointer], :uint
+    attach_function :hb_ot_math_get_min_connector_overlap,
+      [:hb_font_t, :hb_direction_t], :hb_position_t
+  end
+end

data/lib/harfbuzz/c/ot/meta.rb

@@ -0,0 +1,10 @@
+# frozen_string_literal: true
+
+module HarfBuzz
+  module C
+    attach_function :hb_ot_meta_get_entry_tags,
+      [:hb_face_t, :uint, :pointer, :pointer], :uint
+    attach_function :hb_ot_meta_reference_entry,
+      [:hb_face_t, :hb_ot_meta_tag_t], :hb_blob_t
+  end
+end

data/lib/harfbuzz/c/ot/metrics.rb

@@ -0,0 +1,16 @@
+# frozen_string_literal: true
+
+module HarfBuzz
+  module C
+    attach_function :hb_ot_metrics_get_position,
+      [:hb_font_t, :uint, :pointer], :hb_bool_t
+    attach_function :hb_ot_metrics_get_position_with_fallback,
+      [:hb_font_t, :uint, :pointer], :void
+    attach_function :hb_ot_metrics_get_variation,
+      [:hb_font_t, :uint], :float
+    attach_function :hb_ot_metrics_get_x_variation,
+      [:hb_font_t, :uint], :hb_position_t
+    attach_function :hb_ot_metrics_get_y_variation,
+      [:hb_font_t, :uint], :hb_position_t
+  end
+end

data/lib/harfbuzz/c/ot/name.rb

@@ -0,0 +1,13 @@
+# frozen_string_literal: true
+
+module HarfBuzz
+  module C
+    attach_function :hb_ot_name_list_names, [:hb_face_t, :pointer], :pointer
+    attach_function :hb_ot_name_get_utf8,
+      [:hb_face_t, :hb_ot_name_id_t, :pointer, :pointer, :pointer], :uint
+    attach_function :hb_ot_name_get_utf16,
+      [:hb_face_t, :hb_ot_name_id_t, :pointer, :pointer, :pointer], :uint
+    attach_function :hb_ot_name_get_utf32,
+      [:hb_face_t, :hb_ot_name_id_t, :pointer, :pointer, :pointer], :uint
+  end
+end

data/lib/harfbuzz/c/ot/shape.rb

@@ -0,0 +1,10 @@
+# frozen_string_literal: true
+
+module HarfBuzz
+  module C
+    attach_function :hb_ot_shape_glyphs_closure,
+      [:hb_font_t, :hb_buffer_t, :pointer, :uint, :hb_set_t], :void
+    attach_function :hb_ot_shape_plan_collect_lookups,
+      [:hb_shape_plan_t, :hb_tag_t, :hb_set_t], :void
+  end
+end

data/lib/harfbuzz/c/ot/var.rb

@@ -0,0 +1,22 @@
+# frozen_string_literal: true
+
+module HarfBuzz
+  module C
+    attach_function :hb_ot_var_has_data, [:hb_face_t], :hb_bool_t
+    attach_function :hb_ot_var_get_axis_count, [:hb_face_t], :uint
+    attach_function :hb_ot_var_get_axis_infos, [:hb_face_t, :uint, :pointer, :pointer], :uint
+    attach_function :hb_ot_var_find_axis_info,
+      [:hb_face_t, :hb_tag_t, :pointer], :hb_bool_t
+    attach_function :hb_ot_var_get_named_instance_count, [:hb_face_t], :uint
+    attach_function :hb_ot_var_named_instance_get_subfamily_name_id,
+      [:hb_face_t, :uint], :hb_ot_name_id_t
+    attach_function :hb_ot_var_named_instance_get_postscript_name_id,
+      [:hb_face_t, :uint], :hb_ot_name_id_t
+    attach_function :hb_ot_var_named_instance_get_design_coords,
+      [:hb_face_t, :uint, :pointer, :pointer], :uint
+    attach_function :hb_ot_var_normalize_variations,
+      [:hb_face_t, :pointer, :uint, :pointer, :uint], :void
+    attach_function :hb_ot_var_normalize_coords,
+      [:hb_face_t, :uint, :pointer, :pointer], :void
+  end
+end

data/lib/harfbuzz/c/paint.rb

@@ -0,0 +1,38 @@
+# frozen_string_literal: true
+
+module HarfBuzz
+  module C
+    attach_function :hb_paint_funcs_create, [], :hb_paint_funcs_t
+    attach_function :hb_paint_funcs_destroy, [:hb_paint_funcs_t], :void
+    attach_function :hb_paint_funcs_reference, [:hb_paint_funcs_t], :hb_paint_funcs_t
+    attach_function :hb_paint_funcs_is_immutable, [:hb_paint_funcs_t], :hb_bool_t
+    attach_function :hb_paint_funcs_make_immutable, [:hb_paint_funcs_t], :void
+
+    attach_function :hb_paint_funcs_set_push_transform_func,
+      [:hb_paint_funcs_t, :pointer, :pointer, :pointer], :void
+    attach_function :hb_paint_funcs_set_pop_transform_func,
+      [:hb_paint_funcs_t, :pointer, :pointer, :pointer], :void
+    attach_function :hb_paint_funcs_set_push_clip_glyph_func,
+      [:hb_paint_funcs_t, :pointer, :pointer, :pointer], :void
+    attach_function :hb_paint_funcs_set_push_clip_rectangle_func,
+      [:hb_paint_funcs_t, :pointer, :pointer, :pointer], :void
+    attach_function :hb_paint_funcs_set_pop_clip_func,
+      [:hb_paint_funcs_t, :pointer, :pointer, :pointer], :void
+    attach_function :hb_paint_funcs_set_color_func,
+      [:hb_paint_funcs_t, :pointer, :pointer, :pointer], :void
+    attach_function :hb_paint_funcs_set_linear_gradient_func,
+      [:hb_paint_funcs_t, :pointer, :pointer, :pointer], :void
+    attach_function :hb_paint_funcs_set_radial_gradient_func,
+      [:hb_paint_funcs_t, :pointer, :pointer, :pointer], :void
+    attach_function :hb_paint_funcs_set_sweep_gradient_func,
+      [:hb_paint_funcs_t, :pointer, :pointer, :pointer], :void
+    attach_function :hb_paint_funcs_set_push_group_func,
+      [:hb_paint_funcs_t, :pointer, :pointer, :pointer], :void
+    attach_function :hb_paint_funcs_set_pop_group_func,
+      [:hb_paint_funcs_t, :pointer, :pointer, :pointer], :void
+    attach_function :hb_paint_funcs_set_image_func,
+      [:hb_paint_funcs_t, :pointer, :pointer, :pointer], :void
+    attach_function :hb_paint_funcs_set_custom_palette_color_func,
+      [:hb_paint_funcs_t, :pointer, :pointer, :pointer], :void
+  end
+end

data/lib/harfbuzz/c/set.rb

@@ -0,0 +1,42 @@
+# frozen_string_literal: true
+
+module HarfBuzz
+  module C
+    HB_SET_VALUE_INVALID = 0xFFFFFFFF
+
+    attach_function :hb_set_create, [], :hb_set_t
+    attach_function :hb_set_destroy, [:hb_set_t], :void
+    attach_function :hb_set_reference, [:hb_set_t], :hb_set_t
+    attach_function :hb_set_get_empty, [], :hb_set_t
+    attach_function :hb_set_clear, [:hb_set_t], :void
+    attach_function :hb_set_is_empty, [:hb_set_t], :hb_bool_t
+    attach_function :hb_set_get_population, [:hb_set_t], :uint
+    attach_function :hb_set_has, [:hb_set_t, :hb_codepoint_t], :hb_bool_t
+    attach_function :hb_set_add, [:hb_set_t, :hb_codepoint_t], :void
+    attach_function :hb_set_add_range, [:hb_set_t, :hb_codepoint_t, :hb_codepoint_t], :void
+    attach_function :hb_set_add_sorted_array,
+      [:hb_set_t, :pointer, :uint], :void
+    attach_function :hb_set_del, [:hb_set_t, :hb_codepoint_t], :void
+    attach_function :hb_set_del_range, [:hb_set_t, :hb_codepoint_t, :hb_codepoint_t], :void
+    attach_function :hb_set_is_equal, [:hb_set_t, :hb_set_t], :hb_bool_t
+    attach_function :hb_set_hash, [:hb_set_t], :uint
+    attach_function :hb_set_is_subset, [:hb_set_t, :hb_set_t], :hb_bool_t
+    attach_function :hb_set_set, [:hb_set_t, :hb_set_t], :void
+    attach_function :hb_set_union, [:hb_set_t, :hb_set_t], :void
+    attach_function :hb_set_intersect, [:hb_set_t, :hb_set_t], :void
+    attach_function :hb_set_subtract, [:hb_set_t, :hb_set_t], :void
+    attach_function :hb_set_symmetric_difference, [:hb_set_t, :hb_set_t], :void
+    attach_function :hb_set_invert, [:hb_set_t], :void
+    attach_function :hb_set_get_min, [:hb_set_t], :hb_codepoint_t
+    attach_function :hb_set_get_max, [:hb_set_t], :hb_codepoint_t
+    attach_function :hb_set_next, [:hb_set_t, :pointer], :hb_bool_t
+    attach_function :hb_set_previous, [:hb_set_t, :pointer], :hb_bool_t
+    attach_function :hb_set_next_range, [:hb_set_t, :pointer, :pointer], :hb_bool_t
+    attach_function :hb_set_previous_range, [:hb_set_t, :pointer, :pointer], :hb_bool_t
+    attach_function :hb_set_next_many, [:hb_set_t, :hb_codepoint_t, :pointer, :uint], :uint
+
+    attach_function :hb_set_set_user_data,
+      [:hb_set_t, :pointer, :pointer, :pointer, :hb_bool_t], :hb_bool_t
+    attach_function :hb_set_get_user_data, [:hb_set_t, :pointer], :pointer
+  end
+end

data/lib/harfbuzz/c/shape.rb

@@ -0,0 +1,11 @@
+# frozen_string_literal: true
+
+module HarfBuzz
+  module C
+    attach_function :hb_shape,
+      [:hb_font_t, :hb_buffer_t, :pointer, :uint], :void
+    attach_function :hb_shape_full,
+      [:hb_font_t, :hb_buffer_t, :pointer, :uint, :pointer], :hb_bool_t
+    attach_function :hb_shape_list_shapers, [], :pointer
+  end
+end

data/lib/harfbuzz/c/shape_plan.rb

@@ -0,0 +1,24 @@
+# frozen_string_literal: true
+
+module HarfBuzz
+  module C
+    attach_function :hb_shape_plan_create,
+      [:hb_face_t, :pointer, :pointer, :uint, :pointer], :hb_shape_plan_t
+    attach_function :hb_shape_plan_create_cached,
+      [:hb_face_t, :pointer, :pointer, :uint, :pointer], :hb_shape_plan_t
+    attach_function :hb_shape_plan_create2,
+      [:hb_face_t, :pointer, :pointer, :uint, :pointer, :uint, :pointer], :hb_shape_plan_t
+    attach_function :hb_shape_plan_create_cached2,
+      [:hb_face_t, :pointer, :pointer, :uint, :pointer, :uint, :pointer], :hb_shape_plan_t
+    attach_function :hb_shape_plan_destroy, [:hb_shape_plan_t], :void
+    attach_function :hb_shape_plan_reference, [:hb_shape_plan_t], :hb_shape_plan_t
+    attach_function :hb_shape_plan_execute,
+      [:hb_shape_plan_t, :hb_font_t, :hb_buffer_t, :pointer, :uint], :hb_bool_t
+    attach_function :hb_shape_plan_get_shaper, [:hb_shape_plan_t], :string
+    attach_function :hb_shape_plan_get_empty, [], :hb_shape_plan_t
+
+    attach_function :hb_shape_plan_set_user_data,
+      [:hb_shape_plan_t, :pointer, :pointer, :pointer, :hb_bool_t], :hb_bool_t
+    attach_function :hb_shape_plan_get_user_data, [:hb_shape_plan_t, :pointer], :pointer
+  end
+end

data/lib/harfbuzz/c/structs.rb

@@ -0,0 +1,120 @@
+# frozen_string_literal: true
+
+module HarfBuzz
+  module C
+    class HbGlyphInfoT < FFI::Struct
+      layout :codepoint, :hb_codepoint_t,
+             :mask,      :hb_mask_t,
+             :cluster,   :uint32,
+             :var1,      :uint32,
+             :var2,      :uint32
+    end
+
+    class HbGlyphPositionT < FFI::Struct
+      layout :x_advance, :hb_position_t,
+             :y_advance, :hb_position_t,
+             :x_offset,  :hb_position_t,
+             :y_offset,  :hb_position_t,
+             :var,       :uint32
+    end
+
+    class HbFeatureT < FFI::Struct
+      layout :tag,   :hb_tag_t,
+             :value, :uint32,
+             :start, :uint,
+             :end,   :uint
+    end
+
+    class HbVariationT < FFI::Struct
+      layout :tag,   :hb_tag_t,
+             :value, :float
+    end
+
+    class HbSegmentPropertiesT < FFI::Struct
+      layout :direction, :int,
+             :script,    :uint32,
+             :language,  :pointer,
+             :reserved1, :pointer,
+             :reserved2, :pointer
+    end
+
+    class HbGlyphExtentsT < FFI::Struct
+      layout :x_bearing, :hb_position_t,
+             :y_bearing, :hb_position_t,
+             :width,     :hb_position_t,
+             :height,    :hb_position_t
+    end
+
+    class HbFontExtentsT < FFI::Struct
+      layout :ascender,  :hb_position_t,
+             :descender, :hb_position_t,
+             :line_gap,  :hb_position_t,
+             :reserved9, :hb_position_t,
+             :reserved8, :hb_position_t,
+             :reserved7, :hb_position_t,
+             :reserved6, :hb_position_t,
+             :reserved5, :hb_position_t,
+             :reserved4, :hb_position_t,
+             :reserved3, :hb_position_t,
+             :reserved2, :hb_position_t,
+             :reserved1, :hb_position_t
+    end
+
+    class HbOtVarAxisInfoT < FFI::Struct
+      layout :axis_index,    :uint,
+             :tag,           :hb_tag_t,
+             :name_id,       :uint,
+             :flags,         :uint,
+             :min_value,     :float,
+             :default_value, :float,
+             :max_value,     :float,
+             :reserved,      :uint
+    end
+
+    class HbOtNameEntryT < FFI::Struct
+      layout :name_id,  :uint,
+             :var,      :uint32,
+             :language, :pointer
+    end
+
+    class HbOtMathGlyphVariantT < FFI::Struct
+      layout :glyph,   :hb_codepoint_t,
+             :advance, :hb_position_t
+    end
+
+    class HbOtMathGlyphPartT < FFI::Struct
+      layout :glyph,                  :hb_codepoint_t,
+             :start_connector_length, :hb_position_t,
+             :end_connector_length,   :hb_position_t,
+             :full_advance,           :hb_position_t,
+             :flags,                  :uint
+    end
+
+    class HbOtColorLayerT < FFI::Struct
+      layout :glyph,       :hb_codepoint_t,
+             :color_index, :uint
+    end
+
+    class HbAatLayoutFeatureSelectorInfoT < FFI::Struct
+      layout :name_id,  :uint,
+             :enable,   :uint,
+             :disable,  :uint,
+             :reserved, :uint
+    end
+
+    class HbDrawStateT < FFI::Struct
+      layout :path_open,    :hb_bool_t,
+             :path_start_x, :float,
+             :path_start_y, :float,
+             :current_x,    :float,
+             :current_y,    :float,
+             :reserved1,    :uint32,
+             :reserved2,    :uint32,
+             :reserved3,    :uint32,
+             :reserved4,    :uint32,
+             :reserved5,    :uint32,
+             :reserved6,    :uint32,
+             :reserved7,    :uint32
+    end
+  end
+end

data/lib/harfbuzz/c/subset.rb

@@ -0,0 +1,49 @@
+# frozen_string_literal: true
+
+module HarfBuzz
+  module Subset
+    # Subset C bindings loaded from libharfbuzz-subset
+    module C
+      extend FFI::Library
+
+      SUBSET_LIBRARY_NAMES = %w[
+        harfbuzz-subset libharfbuzz-subset libharfbuzz-subset-0
+      ].freeze
+
+      begin
+        ffi_lib SUBSET_LIBRARY_NAMES
+        @available = true
+      rescue FFI::NotFoundError
+        @available = false
+      end
+
+      def self.available?
+        @available
+      end
+
+      if @available
+        attach_function :hb_subset_input_create_or_fail, [], :pointer
+        attach_function :hb_subset_input_destroy, [:pointer], :void
+        attach_function :hb_subset_input_reference, [:pointer], :pointer
+        attach_function :hb_subset_input_unicode_set, [:pointer], HarfBuzz::C.find_type(:hb_set_t)
+        attach_function :hb_subset_input_glyph_set, [:pointer], HarfBuzz::C.find_type(:hb_set_t)
+        attach_function :hb_subset_input_set_flags, [:pointer, :uint32], :void
+        attach_function :hb_subset_input_get_flags, [:pointer], :uint32
+        attach_function :hb_subset_or_fail,
+          [HarfBuzz::C.find_type(:hb_face_t), :pointer], HarfBuzz::C.find_type(:hb_face_t)
+        attach_function :hb_subset_plan_create_or_fail,
+          [HarfBuzz::C.find_type(:hb_face_t), :pointer], :pointer
+        attach_function :hb_subset_plan_destroy, [:pointer], :void
+        attach_function :hb_subset_plan_reference, [:pointer], :pointer
+        attach_function :hb_subset_plan_execute_or_fail,
+          [:pointer], HarfBuzz::C.find_type(:hb_face_t)
+        attach_function :hb_subset_plan_old_to_new_glyph_mapping,
+          [:pointer], HarfBuzz::C.find_type(:hb_map_t)
+        attach_function :hb_subset_plan_new_to_old_glyph_mapping,
+          [:pointer], HarfBuzz::C.find_type(:hb_map_t)
+        attach_function :hb_subset_plan_unicode_to_old_glyph_mapping,
+          [:pointer], HarfBuzz::C.find_type(:hb_map_t)
+      end
+    end
+  end
+end

data/lib/harfbuzz/c/unicode.rb

@@ -0,0 +1,40 @@
+# frozen_string_literal: true
+
+module HarfBuzz
+  module C
+    attach_function :hb_unicode_funcs_create, [:hb_unicode_funcs_t], :hb_unicode_funcs_t
+    attach_function :hb_unicode_funcs_get_default, [], :hb_unicode_funcs_t
+    attach_function :hb_unicode_funcs_get_empty, [], :hb_unicode_funcs_t
+    attach_function :hb_unicode_funcs_destroy, [:hb_unicode_funcs_t], :void
+    attach_function :hb_unicode_funcs_reference, [:hb_unicode_funcs_t], :hb_unicode_funcs_t
+    attach_function :hb_unicode_funcs_get_parent, [:hb_unicode_funcs_t], :hb_unicode_funcs_t
+    attach_function :hb_unicode_funcs_is_immutable, [:hb_unicode_funcs_t], :hb_bool_t
+    attach_function :hb_unicode_funcs_make_immutable, [:hb_unicode_funcs_t], :void
+
+    attach_function :hb_unicode_funcs_set_general_category_func,
+      [:hb_unicode_funcs_t, :pointer, :pointer, :pointer], :void
+    attach_function :hb_unicode_funcs_set_combining_class_func,
+      [:hb_unicode_funcs_t, :pointer, :pointer, :pointer], :void
+    attach_function :hb_unicode_funcs_set_mirroring_func,
+      [:hb_unicode_funcs_t, :pointer, :pointer, :pointer], :void
+    attach_function :hb_unicode_funcs_set_script_func,
+      [:hb_unicode_funcs_t, :pointer, :pointer, :pointer], :void
+    attach_function :hb_unicode_funcs_set_compose_func,
+      [:hb_unicode_funcs_t, :pointer, :pointer, :pointer], :void
+    attach_function :hb_unicode_funcs_set_decompose_func,
+      [:hb_unicode_funcs_t, :pointer, :pointer, :pointer], :void
+
+    attach_function :hb_unicode_general_category,
+      [:hb_unicode_funcs_t, :hb_codepoint_t], :hb_unicode_general_category_t
+    attach_function :hb_unicode_combining_class,
+      [:hb_unicode_funcs_t, :hb_codepoint_t], :uint
+    attach_function :hb_unicode_mirroring,
+      [:hb_unicode_funcs_t, :hb_codepoint_t], :hb_codepoint_t
+    attach_function :hb_unicode_script,
+      [:hb_unicode_funcs_t, :hb_codepoint_t], :uint32
+    attach_function :hb_unicode_compose,
+      [:hb_unicode_funcs_t, :hb_codepoint_t, :hb_codepoint_t, :pointer], :hb_bool_t
+    attach_function :hb_unicode_decompose,
+      [:hb_unicode_funcs_t, :hb_codepoint_t, :pointer, :pointer], :hb_bool_t
+  end
+end

data/lib/harfbuzz/c/version.rb

@@ -0,0 +1,25 @@
+# frozen_string_literal: true
+
+module HarfBuzz
+  module C
+    # === Version Functions ===
+
+    # Returns the HarfBuzz library version
+    # @param major [FFI::Pointer] Pointer to store major version
+    # @param minor [FFI::Pointer] Pointer to store minor version
+    # @param micro [FFI::Pointer] Pointer to store micro version
+    # @return [void]
+    attach_function :hb_version, [:pointer, :pointer, :pointer], :void
+
+    # Returns the HarfBuzz library version as a string
+    # @return [String] Version string (e.g., "8.3.0")
+    attach_function :hb_version_string, [], :string
+
+    # Checks if the library version is at least the specified version
+    # @param major [Integer] Major version
+    # @param minor [Integer] Minor version
+    # @param micro [Integer] Micro version
+    # @return [Integer] Non-zero if version >= specified, 0 otherwise
+    attach_function :hb_version_atleast, [:uint, :uint, :uint], :hb_bool_t
+  end
+end

data/lib/harfbuzz/draw_funcs.rb

@@ -0,0 +1,112 @@
+# frozen_string_literal: true
+
+module HarfBuzz
+  # Wraps hb_draw_funcs_t — callbacks for glyph outline rendering
+  #
+  # @example Extracting an SVG path
+  #   draw = HarfBuzz::DrawFuncs.new
+  #   path = []
+  #   draw.on_move_to    { |x, y| path << "M#{x},#{y}" }
+  #   draw.on_line_to    { |x, y| path << "L#{x},#{y}" }
+  #   draw.on_cubic_to   { |c1x, c1y, c2x, c2y, x, y| path << "C#{c1x},#{c1y},#{c2x},#{c2y},#{x},#{y}" }
+  #   draw.on_close_path { path << "Z" }
+  #   draw.make_immutable!
+  #   font.draw_glyph(glyph_id, draw)
+  class DrawFuncs
+    attr_reader :ptr
+
+    def initialize
+      @ptr = C.hb_draw_funcs_create
+      raise AllocationError, "Failed to create draw_funcs" if @ptr.null?
+
+      HarfBuzz::DrawFuncs.define_finalizer(self, @ptr)
+    end
+
+    # @return [Boolean] true if immutable
+    def immutable?
+      C.from_hb_bool(C.hb_draw_funcs_is_immutable(@ptr))
+    end
+
+    # Makes immutable (call after setting all callbacks)
+    # @return [self]
+    def make_immutable!
+      C.hb_draw_funcs_make_immutable(@ptr)
+      self
+    end
+
+    # Sets the move_to callback
+    # @yield [x, y] Called for move-to operations
+    def on_move_to(&block)
+      @move_to_callback = block
+      cb = FFI::Function.new(:void,
+        [:pointer, :pointer, :pointer, :float, :float, :pointer]) do
+        |_dfuncs, _draw_data, _st, x, y, _user_data|
+        block.call(x, y)
+      end
+      @move_to_ffi = cb
+      C.hb_draw_funcs_set_move_to_func(@ptr, cb, nil, nil)
+    end
+
+    # Sets the line_to callback
+    # @yield [x, y] Called for line-to operations
+    def on_line_to(&block)
+      @line_to_callback = block
+      cb = FFI::Function.new(:void,
+        [:pointer, :pointer, :pointer, :float, :float, :pointer]) do
+        |_dfuncs, _draw_data, _st, x, y, _user_data|
+        block.call(x, y)
+      end
+      @line_to_ffi = cb
+      C.hb_draw_funcs_set_line_to_func(@ptr, cb, nil, nil)
+    end
+
+    # Sets the quadratic_to callback
+    # @yield [cx, cy, x, y] Control point and end point
+    def on_quadratic_to(&block)
+      @quadratic_to_callback = block
+      cb = FFI::Function.new(:void,
+        [:pointer, :pointer, :pointer,
+         :float, :float, :float, :float, :pointer]) do
+        |_dfuncs, _draw_data, _st, cx, cy, x, y, _user_data|
+        block.call(cx, cy, x, y)
+      end
+      @quadratic_to_ffi = cb
+      C.hb_draw_funcs_set_quadratic_to_func(@ptr, cb, nil, nil)
+    end
+
+    # Sets the cubic_to callback
+    # @yield [c1x, c1y, c2x, c2y, x, y] Two control points and end point
+    def on_cubic_to(&block)
+      @cubic_to_callback = block
+      cb = FFI::Function.new(:void,
+        [:pointer, :pointer, :pointer,
+         :float, :float, :float, :float, :float, :float, :pointer]) do
+        |_dfuncs, _draw_data, _st, c1x, c1y, c2x, c2y, x, y, _user_data|
+        block.call(c1x, c1y, c2x, c2y, x, y)
+      end
+      @cubic_to_ffi = cb
+      C.hb_draw_funcs_set_cubic_to_func(@ptr, cb, nil, nil)
+    end
+
+    # Sets the close_path callback
+    # @yield Called when a path is closed
+    def on_close_path(&block)
+      @close_path_callback = block
+      cb = FFI::Function.new(:void, [:pointer, :pointer, :pointer, :pointer]) do
+        |_dfuncs, _draw_data, _st, _user_data|
+        block.call
+      end
+      @close_path_ffi = cb
+      C.hb_draw_funcs_set_close_path_func(@ptr, cb, nil, nil)
+    end
+
+    def inspect
+      "#<HarfBuzz::DrawFuncs immutable=#{immutable?}>"
+    end
+
+    def self.define_finalizer(obj, ptr)
+      destroy = C.method(:hb_draw_funcs_destroy)
+      ObjectSpace.define_finalizer(obj, proc { destroy.call(ptr) })
+    end
+  end
+end

data/lib/harfbuzz/error.rb

@@ -0,0 +1,27 @@
+# frozen_string_literal: true
+
+module HarfBuzz
+  # Base error class for all HarfBuzz errors
+  class Error < StandardError; end
+
+  # Raised when the HarfBuzz shared library cannot be found
+  class LibraryNotFoundError < Error; end
+
+  # Raised when memory allocation fails (create functions return NULL)
+  class AllocationError < Error; end
+
+  # Raised when an invalid argument is passed to a function
+  class InvalidArgumentError < Error; end
+
+  # Raised when a Feature string cannot be parsed
+  class FeatureParseError < Error; end
+
+  # Raised when a Variation string cannot be parsed
+  class VariationParseError < Error; end
+
+  # Raised when hb_subset_or_fail or similar operations fail
+  class SubsetError < Error; end
+
+  # Raised when an optional feature (FreeType, Subset) is unavailable
+  class UnavailableError < Error; end
+end