libui 0.2.0.pre-arm64-darwin → 0.2.2-arm64-darwin

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 2f9904359a2e38169abf117d6d9f35a4777dbbc6b7032c3b94d64a9b408ee16a
-  data.tar.gz: 30b8ef14230fea6c3c48f6f02ed9aca2fea615f115e95f91c0362d67daf9a07c
+  metadata.gz: bab620a614f12ac3bff8eed13a4ebe64fe74f2911b47435bf99e0ae392f7ff8c
+  data.tar.gz: 4143c27f60470c99094b47c239aa949bc4d1eddb6a7935309f25614335110192
 SHA512:
-  metadata.gz: db6a0f30fc19b99289cca38762c3917278eebfa226072fea18bccafc0107a7b661e41160c5ead4c6fea4b35f8f9ec8a49d72ac2d63b87857a5c648159c6844dc
-  data.tar.gz: f93b1aefc1b18d1cc5debbc6257fbb6b181ddbc18f53af1283fc2ef319f9291f6e856c3cb0d1d030f8d01132e2e4a9e98fea8f84a5648629b18d208b66074e3e
+  metadata.gz: 90e21fd14f8359bea259442d413a8edd2939a097586cd06d6da14ddd8e1140a3e12547342a54bbe5a874b65cb7d2ad4f8f96f2aef051e4e5cf9518ed839ec1b3
+  data.tar.gz: ded356ce7a14f2e56819db345e9bebde05c57c38aa56cacfb3735d69110bf84a75374a1846e048c04e257f173dcc9fe6b968b99fb94b8487b8387e54e53f21bd

data/LICENSE.txt

@@ -1,6 +1,6 @@
 The MIT License (MIT)
 
-Copyright (c) 2020-2025 kojix2
+Copyright (c) 2020-present kojix2
 
 Permission is hereby granted, free of charge, to any person obtaining a copy
 of this software and associated documentation files (the "Software"), to deal

data/README.md

@@ -1,7 +1,7 @@
 # LibUI
 
 [![test](https://github.com/kojix2/LibUI/actions/workflows/test.yml/badge.svg)](https://github.com/kojix2/LibUI/actions/workflows/test.yml)
-[![Gem Version](https://badge.fury.io/rb/libui.svg)](https://badge.fury.io/rb/libui)
+[![Gem Version](https://img.shields.io/badge/dynamic/json?label=gem%20version&query=%24%5B0%5D.number&url=https%3A%2F%2Frubygems.org%2Fapi%2Fv1%2Fversions%2Flibui.json&color=brightgreen)](https://rubygems.org/gems/libui/versions)
 <a href="https://github.com/AndyObtiva/glimmer-dsl-libui"><img alt="glimmer-dsl-libui" src="https://github.com/AndyObtiva/glimmer/blob/master/images/glimmer-logo-hi-res.svg" width="50" height="50" align="right"></a>
 [![Pre-build](https://github.com/kojix2/libui-ng/actions/workflows/pre-build.yml/badge.svg?branch=pre-build)](https://github.com/kojix2/libui-ng/actions/workflows/pre-build.yml)
 [![Lines of Code](https://img.shields.io/endpoint?url=https%3A%2F%2Ftokei.kojix2.net%2Fbadge%2Fgithub%2Fkojix2%2FLibUI%2Flines)](https://tokei.kojix2.net/github/kojix2/LibUI)
@@ -16,20 +16,12 @@ LibUI is a Ruby wrapper for libui family.
 
 ## Installation
 
-It is recommended to use libui-ng, via the --pre commandline flag:
-
-```sh
-gem install libui --pre # libui-ng; this will fetch libui-0.1.3.pre-x86_64-linux.gem
-```
-
-If for some reason you would like to install the slightly older libui-0.1.2.gem release, issue:
-
 ```sh
-gem install libui
+gem install libui # --pre
 ```
 
 - The gem package includes the libui-ng shared library for Windows, Mac, and Linux.
-  - Namely `libui.dll`, `libui.dylib`, or `libui.so`.
+  - Namely `libui.x64.dll`/`libui.x86.dll`, `libui.x86_64.dylib`/`libui.arm64.dylib`, or `libui.x86_64.so`/`libui.aarch64.so`.
 - No dependencies required.
   - The libui gem uses the standard Ruby library [Fiddle](https://github.com/ruby/fiddle) to call C functions.
 
@@ -62,9 +54,8 @@ end
 
 UI.window_on_closing(main_window) do
   puts 'Bye Bye'
-  UI.control_destroy(main_window)
   UI.quit
-  0
+  1
 end
 
 UI.window_set_child(main_window, button)
@@ -86,7 +77,7 @@ Compared to the original libui library written in C:
   - The block will be converted to a Proc object and added as the last argument.
   - The last argument can still be omitted when nil.
 
-You can use [the documentation for libui's Go bindings](https://pkg.go.dev/github.com/andlabs/ui) as a reference.
+You can use [the libui-ng API documentation](https://libui-ng.github.io/libui-ng/) as a reference.
 
 ### DSLs for LibUI
 
@@ -95,7 +86,6 @@ LibUI is not object-oriented because it is a thin Ruby wrapper (binding) for the
 To build actual applications, it is recommended to use a DSL for LibUI, as they enable writing object-oriented code the Ruby way (instead of procedural code the C way):
 
 - [Glimmer DSL for LibUI](https://github.com/AndyObtiva/glimmer-dsl-libui)
-- [libui_paradise](https://rubygems.org/gems/libui_paradise)
 
 ### Working with fiddle pointers
 
@@ -105,12 +95,26 @@ UI = LibUI
 UI.init
 ```
 
-To convert a pointer to a string:
+Text getter methods such as `label_text`, `entry_text`, and `window_title`
+return `Fiddle::Pointer` objects for strings allocated by libui. Convert the
+pointer to a Ruby string, then release it with `free_text`.
 
 ```ruby
 label = UI.new_label("Ruby")
-p pointer = UI.label_text(label) # #<Fiddle::Pointer>
-p pointer.to_s # Ruby
+pointer = UI.label_text(label) # #<Fiddle::Pointer>
+text = pointer.to_s
+UI.free_text(pointer)
+p text # Ruby
+```
+
+Use `ensure` if the code between conversion and cleanup can raise:
+
+```ruby
+def ui_text(text_pointer)
+  text_pointer.to_s
+ensure
+  UI.free_text(text_pointer) if text_pointer && !text_pointer.null?
+end
 ```
 
 If you need to use C structs, you can do the following:
@@ -125,11 +129,15 @@ font_descriptor.to_ptr.free = Fiddle::RUBY_FREE
 
 UI.font_button_on_changed(font_button) do
   UI.font_button_font(font_button, font_descriptor)
-  p family:  font_descriptor.Family.to_s,
-    size:    font_descriptor.Size,
-    weight:  font_descriptor.Weight,
-    italic:  font_descriptor.Italic,
-    stretch: font_descriptor.Stretch
+  begin
+    p family:  font_descriptor.Family.to_s,
+      size:    font_descriptor.Size,
+      weight:  font_descriptor.Weight,
+      italic:  font_descriptor.Italic,
+      stretch: font_descriptor.Stretch
+  ensure
+    UI.free_font_button_font(font_descriptor)
+  end
 end
 ```
 
@@ -178,40 +186,27 @@ Add additional options below if necessary:
 git clone https://github.com/kojix2/libui
 cd libui
 bundle install
-bundle exec rake vendor:auto # vendor:build
+bundle exec rake vendor:auto
 bundle exec rake test
 ```
 
 ### Pre-built shared libraries for libui-ng
 
-Use the following rake tasks to download the shared library required for your platform:
-
-`rake -T`
+Download pre-built libui-ng shared libraries (per your current platform):
 
+```sh
+bundle exec rake vendor:auto
 ```
-rake vendor:build[hash]          # Build libui-ng latest master [commit hash]
-rake vendor:libui-ng:macos       # Download latest official pre-build for Mac to vendor directory
-rake vendor:libui-ng:ubuntu_x64  # Download latest official pre-build for Ubuntu to vendor directory
-rake vendor:macos_arm64          # Download pre-build for Mac to vendor directory
-rake vendor:macos_x64            # Download pre-build for Mac to vendor directory
-rake vendor:raspbian_aarch64     # Download pre-build for Raspbian to vendor directory
-rake vendor:ubuntu_x64           # Download pre-build for Ubuntu to vendor directory
-rake vendor:windows_x64          # Download pre-build for Windows to vendor directory
-rake vendor:windows_x86          # Download pre-build for Windows to vendor directory
-```
-
-For example, if you are using a 32-bit (x86) version of Ruby on Windows, type `vendor:windows_x86`.
-These shared libraries are [artifacts](https://github.com/kojix2/libui-ng/actions/workflows/pre-build.yml) of the [pre-build branch](https://github.com/kojix2/libui-ng/tree/pre-build) of [kojix2/libui-ng](https://github.com/kojix2/libui-ng). In that case, please let us know.
 
-### Using C libui compiled from source code
+Clean downloaded vendor files (keeps `vendor/{LICENSE,README}.md`):
 
-The following Rake task will compile libui-ng. meson or ninja is required.
-
-`bundle exec rake vendor:build`
+```sh
+bundle exec rake vendor:clean
+```
 
-Alternatively, you can tell Ruby LibUI the location of shared libraries. Set the environment variable `LIBUIDIR` to specify the path to the shared library. (See [#46](https://github.com/kojix2/LibUI/issues/46#issuecomment-1041575792)). This is especially useful on platforms where the LibUI gem does not provide shared library, such as the ARM architecture (used in devices like Raspberry Pi).
+### Using your own libui build
 
-Another simple approach is to replace the shared libraries in the gem vendor directory with the ones you have compiled.
+If you build libui-ng yourself, set `LIBUIDIR` to the directory containing the compiled `.so/.dylib/.dll` so LibUI can load it. You may also replace files under `vendor/` with your build if preferred. See [#46](https://github.com/kojix2/LibUI/issues/46#issuecomment-1041575792).
 
 ### Publishing gems
 
@@ -220,8 +215,8 @@ Another simple approach is to replace the shared libraries in the gem vendor dir
 Push a version tag to automatically publish platform-specific gems:
 
 ```sh
-git tag v0.1.3
-git push origin v0.1.3
+git tag v0.2.0
+git push origin v0.2.0
 ```
 
 Requires `RUBYGEMS_API_KEY` repository secret with scoped API key.
@@ -239,9 +234,19 @@ find pkg -name *.gem -exec sh -c "echo; echo \# {}; tar -O -f {} -x data.tar.gz
 rake release_platform # publish gems
 ```
 
+Windows Ruby (x64-mingw32 or x64-mingw-ucrt)
+
+```sh
+gem install rake rubyzip
+GEM_PLATFORM=x64-mingw32 rake vendor:clean
+GEM_PLATFORM=x64-mingw32 rake vendor:auto
+GEM_PLATFORM=x64-mingw32 gem build libui.gemspec
+gem push libui-0.2.0-x64-mingw32.gem
+```
+
 ### libui or libui-ng
 
-- From version 0.1.X, we plan to support only libui-ng/libui-ng.
+- From version 0.1.X, LibUI supports only libui-ng.
 - Version 0.0.X only supports andlabs/libui.
 
 ## Contributing

data/lib/libui/ffi.rb

@@ -3,8 +3,6 @@ require_relative 'fiddle_patch'
 require_relative 'error'
 
 module LibUI
-  class Error < StandardError; end
-
   module FFI
     extend Fiddle::Importer
     extend FiddlePatch
@@ -38,6 +36,7 @@ module LibUI
     end
 
     typealias('uint32_t', 'unsigned int')
+    typealias('uint64_t', 'unsigned long long')
 
     InitOptions = struct [
       'size_t Size'

data/lib/libui/fiddle_patch.rb

@@ -11,23 +11,23 @@ module LibUI
     def parse_signature(signature, tymap = nil)
       tymap ||= {}
       ctype, func, args = case compact(signature)
-                          when /^(?:[\w\*\s]+)\(\*(\w+)\((.*?)\)\)(?:\[\w*\]|\(.*?\));?$/
+                          when /^(?:[\w*\s]+)\(\*(\w+)\((.*?)\)\)(?:\[\w*\]|\(.*?\));?$/
                             [TYPE_VOIDP, Regexp.last_match(1), Regexp.last_match(2)]
-                          when /^([\w\*\s]+[*\s])(\w+)\((.*?)\);?$/
+                          when /^([\w*\s]+[*\s])(\w+)\((.*?)\);?$/
                             [parse_ctype(Regexp.last_match(1).strip, tymap), Regexp.last_match(2), Regexp.last_match(3)]
                           else
-                            raise("can't parserake the function prototype: #{signature}")
+                            raise("can't parse the function prototype: #{signature}")
                           end
       symname = func
       callback_argument_types = {}                                              # Added
       argtype = split_arguments(args).collect.with_index do |arg, idx|          # Added with_index
         # Check if it is a function pointer or not
-        if arg =~ /\(\*.*\)\(.*\)/                                              # Added
+        if arg =~ /\(\*.*\)\(.*\)/ # Added
           # From the arguments, create a notation that looks like a function declaration
           # int(*f)(int *, void *) -> int f(int *, void *)
-          func_arg = arg.sub('(*', ' ').sub(')', '')                            # Added
+          func_arg = arg.sub('(*', ' ').sub(')', '') # Added
           # Use Fiddle's parse_signature method again.
-          callback_argument_types[idx] = parse_signature(func_arg)              # Added
+          callback_argument_types[idx] = parse_signature(func_arg) # Added
         end
         parse_ctype(arg, tymap)
       end
@@ -41,8 +41,8 @@ module LibUI
       func = import_function(symname, ctype, argtype, opt[:call_type])
 
       # callback_argument_types
-      func.instance_variable_set(:@callback_argument_types, 
-                                   callback_argument_types) # Added
+      func.instance_variable_set(:@callback_argument_types,
+                                 callback_argument_types) # Added
       # attr_reader
       def func.callback_argument_types
         @callback_argument_types
@@ -68,9 +68,9 @@ module LibUI
       @func_map[name] = func
       # define_method(name){|*args,&block| f.call(*args,&block)}
       begin
-        /^(.+?):(\d+)/ =~ caller.first
-        file = Regexp.last_match(1)
-        line = Regexp.last_match(2).to_i
+        location = caller_locations(1, 1).first
+        file = location.path
+        line = location.lineno
       rescue StandardError
         file, line = __FILE__, __LINE__ + 3
       end

data/lib/libui/libui_base.rb

@@ -25,11 +25,13 @@ module LibUI
           # Protect from GC
           # by giving the owner object a reference to the callback.
           # See https://github.com/kojix2/LibUI/issues/8
-          owner = if idx == 0 or   # UI.queue_main{}
-                     owner.frozen? # UI.timer(100) {}
-                    LibUIBase # or UI is better?
+          receiver = args.first
+          owner = if idx == 0 || # UI.queue_main{}
+                     receiver.nil? ||
+                     (receiver.respond_to?(:frozen?) && receiver.frozen?) # UI.timer(100) {}
+                    LibUIBase # keep a reference on an internal module to avoid GC
                   else
-                    args[0] # receiver
+                    receiver # receiver object holds the callback
                   end
           if owner.instance_variable_defined?(:@callbacks)
             owner.instance_variable_get(:@callbacks) << callback

data/lib/libui/version.rb

@@ -1,3 +1,3 @@
 module LibUI
-  VERSION = '0.2.0.pre'
+  VERSION = '0.2.2'
 end

data/lib/libui.rb

@@ -42,15 +42,121 @@ module LibUI
 
   class << self
     def init(opt = nil)
+      # Allocate uiInitOptions if not provided
       unless opt
         opt = FFI::InitOptions.malloc
         opt.to_ptr.free = Fiddle::RUBY_FREE
+        opt.Size = FFI::InitOptions.size
       end
-      i = super(opt)
-      return if i.size.zero?
 
-      warn 'error'
-      warn UI.free_init_error(init)
+      err_ptr = super(opt) # uiInit returns const char* error or NULL on success
+      return nil if err_ptr.null?
+
+      # Convert C string to Ruby string and free the error string per API contract
+      err_msg = err_ptr.to_s
+      free_init_error(err_ptr)
+      warn err_msg
+      nil
+    end
+
+    def new_button(text = '')
+      super(text)
+    end
+
+    def new_checkbox(text = '')
+      super(text)
+    end
+
+    def window_set_title(window, title = '')
+      super(window, title)
+    end
+
+    def button_set_text(button, text = '')
+      super(button, text)
+    end
+
+    def checkbox_set_text(checkbox, text = '')
+      super(checkbox, text)
+    end
+
+    def entry_set_text(entry, text = '')
+      super(entry, text)
+    end
+
+    def label_set_text(label, text = '')
+      super(label, text)
+    end
+
+    def new_label(text = '')
+      super(text)
+    end
+
+    def group_set_title(group, title = '')
+      super(group, title)
+    end
+
+    def new_group(title = '')
+      super(title)
+    end
+
+    def combobox_append(combobox, text = '')
+      super(combobox, text)
+    end
+
+    def combobox_insert_at(combobox, index, text = '')
+      super(combobox, index, text)
+    end
+
+    def editable_combobox_append(combobox, text = '')
+      super(combobox, text)
+    end
+
+    def editable_combobox_set_text(combobox, text = '')
+      super(combobox, text)
+    end
+
+    def radio_buttons_append(radio_buttons, text = '')
+      super(radio_buttons, text)
+    end
+
+    def multiline_entry_set_text(entry, text = '')
+      super(entry, text)
+    end
+
+    def multiline_entry_append(entry, text = '')
+      super(entry, text)
+    end
+
+    def menu_append_item(menu, name = '')
+      super(menu, name)
+    end
+
+    def menu_append_check_item(menu, name = '')
+      super(menu, name)
+    end
+
+    def new_menu(name = '')
+      super(name)
+    end
+
+    def msg_box(parent, title, description = '')
+      super(parent, title, description)
+    end
+
+    def msg_box_error(parent, title, description = '')
+      super(parent, title, description)
+    end
+
+    def new_attributed_string(initial_string = '')
+      super(initial_string)
+    end
+
+    def attributed_string_append_unattributed(attributed_string, str = '')
+      super(attributed_string, str)
+    end
+
+    def new_table_value_string(str = '')
+      super(str)
     end
 
     # Gets the window position.

metadata

@@ -1,14 +1,13 @@
 --- !ruby/object:Gem::Specification
 name: libui
 version: !ruby/object:Gem::Version
-  version: 0.2.0.pre
+  version: 0.2.2
 platform: arm64-darwin
 authors:
 - kojix2
-autorequire:
 bindir: bin
 cert_chain: []
-date: 2025-08-16 00:00:00.000000000 Z
+date: 1980-01-02 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: fiddle
@@ -24,7 +23,6 @@ dependencies:
     - - ">="
       - !ruby/object:Gem::Version
         version: '0'
-description:
 email:
 - 2xijok@gmail.com
 executables: []
@@ -47,7 +45,6 @@ homepage: https://github.com/kojix2/libui
 licenses:
 - MIT
 metadata: {}
-post_install_message:
 rdoc_options: []
 require_paths:
 - lib
@@ -62,8 +59,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.5.22
-signing_key:
+rubygems_version: 3.6.9
 specification_version: 4
 summary: Ruby bindings to libui
 test_files: []