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

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 2f9904359a2e38169abf117d6d9f35a4777dbbc6b7032c3b94d64a9b408ee16a
-  data.tar.gz: 30b8ef14230fea6c3c48f6f02ed9aca2fea615f115e95f91c0362d67daf9a07c
+  metadata.gz: e9ff7947a9b584b530dba33a19b9ebbd7051cdbc7907a93e06238964a0351f6f
+  data.tar.gz: cc8c67692634e93fcfb5081317229631a419bf9618b5e56424343f1116265f4f
 SHA512:
-  metadata.gz: db6a0f30fc19b99289cca38762c3917278eebfa226072fea18bccafc0107a7b661e41160c5ead4c6fea4b35f8f9ec8a49d72ac2d63b87857a5c648159c6844dc
-  data.tar.gz: f93b1aefc1b18d1cc5debbc6257fbb6b181ddbc18f53af1283fc2ef319f9291f6e856c3cb0d1d030f8d01132e2e4a9e98fea8f84a5648629b18d208b66074e3e
+  metadata.gz: 4e956d038e306c5cbfb6cf563331067bfe06ec43780e15f3eeb77f033abc362ba3fcab13e2c33bddc992eadbc7899fadd1a4ed96d9084bb83eeed5c0fb9089fa
+  data.tar.gz: 8df39ece64ee5c4aab78b721ce7382c11a09f3e4376023cb2980331f2ded2b62221143fc3c2a0c547a3bff50c5f5f58ac462db033ed3b55d26f58164ab34869b

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

@@ -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
 
@@ -105,12 +96,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 +130,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 +187,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 +216,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 +235,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,7 +3,6 @@ require_relative 'fiddle_patch'
 require_relative 'error'
 
 module LibUI
-  class Error < StandardError; end
 
   module FFI
     extend Fiddle::Importer
@@ -38,6 +37,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

@@ -16,7 +16,7 @@ module LibUI
                           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

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.1'
 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.1
 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: []