roxane 0.0.1 → 0.0.2

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: e5b9afbc87612a9f5e97a4f57fea36a3556e988bd193cc72f624fdcaed7cabe1
-  data.tar.gz: c5870e5c200f2deaedfb5e3a55f00b172d68611df04d2c0e2722dd75093bcf76
+  metadata.gz: c0ef9393493008dcc4763293fa6ebd36ebb6fdd891b1e2358100eb442ed729ec
+  data.tar.gz: 1fbfe739d81d37b48fcaf9ac428db7d60319c864a63e6b3a9ef9819cb305a65f
 SHA512:
-  metadata.gz: 9a71c4851681187f76a8e1ac1675962a8eef44df6b25908c8b05d628441ef8c3e3a7b1290dfbf64fd0b37c5c556827932c05944e2b2f483a71f1048ffd47c421
-  data.tar.gz: aeb62cb2ea3659aa06b7faaf911d9b269026f64998842ef9818b53b33a60472d38608597c6fd6d46cdc333e040365c4a3bc63c775a021c3453998409db6054fe
+  metadata.gz: 2a84c3f0dc6f20488b7d1bfea51a327fafa1b77e4cd393685645b64e843dc8609c3eeb2a5fc6ab7cff8ec810610cd36afafc8766860003732073b8111464e11f
+  data.tar.gz: 100d61215f9c9c821da5c76648ac6bebd4b59a19aabf342f8928246fe8530243730a73128c013cdb094d3555f4d9933e5bb5e1ff115b2506dcbdcb4891bb4a8c

data/lib/roxane/ffi.rb

@@ -15,6 +15,12 @@ module Roxane
     HINT_MAX   = 2
     HINT_FIXED = 3
 
+    # webview_native_handle_kind_t — BROWSER_CONTROLLER is the engine view
+    # (WebKitWebView* on GTK), the door to engine calls webview doesn't wrap.
+    NATIVE_HANDLE_UI_WINDOW = 0
+    NATIVE_HANDLE_UI_WIDGET = 1
+    NATIVE_HANDLE_BROWSER_CONTROLLER = 2
+
     begin
       ffi_lib Roxane.library_path
 
@@ -31,6 +37,7 @@ module Roxane
       attach_function :webview_set_html,  [:pointer, :string],          :int
       attach_function :webview_init,      [:pointer, :string],          :int
       attach_function :webview_eval,      [:pointer, :string],          :int
+      attach_function :webview_get_native_handle, [:pointer, :int],     :pointer
 
       callback :bind_fn, [:string, :string, :pointer], :void
       attach_function :webview_bind,   [:pointer, :string, :bind_fn, :pointer], :int

data/lib/roxane/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Roxane
-  VERSION = "0.0.1"
+  VERSION = "0.0.2"
 end

data/lib/roxane/webkit.rb

@@ -0,0 +1,38 @@
+# frozen_string_literal: true
+
+module Roxane
+  # Direct WebKitGTK bindings for the few affordances the webview C API doesn't
+  # wrap (today: full-content zoom). On Linux the library is already linked into
+  # the process by libwebview — we bind the soname libwebview itself links (4.1,
+  # falling back to 4.0). Where neither loads (macOS/Windows — their engines get
+  # their own bindings later), AVAILABLE is false and callers no-op gracefully.
+  module WebKit
+    extend ::FFI::Library
+
+    begin
+      ffi_lib ["libwebkit2gtk-4.1.so.0", "libwebkit2gtk-4.0.so.37"]
+      attach_function :webkit_web_view_set_zoom_level, [:pointer, :double], :void
+      attach_function :webkit_web_view_get_zoom_level, [:pointer], :double
+      AVAILABLE = true
+    rescue LoadError, ::FFI::NotFoundError
+      AVAILABLE = false
+    end
+  end
+
+  # GLib main-loop scheduling. g_idle_add is thread-safe and runs the callback
+  # as a TOP-LEVEL main-loop iteration — a clean stack, never nested inside a
+  # webview dispatch callback (layout-triggering WebKit calls made from inside
+  # one can reenter the engine and crash; see the zoom work, 2026-07-03).
+  module GLib
+    extend ::FFI::Library
+
+    begin
+      ffi_lib "libglib-2.0.so.0"
+      callback :g_source_func, [:pointer], :int
+      attach_function :g_idle_add, [:g_source_func, :pointer], :uint
+      AVAILABLE = true
+    rescue LoadError, ::FFI::NotFoundError
+      AVAILABLE = false
+    end
+  end
+end

data/lib/roxane/window.rb

@@ -26,6 +26,7 @@ module Roxane
       @on_close  = nil
       @server    = nil
       @ui_queue  = Queue.new # procs to run on the UI thread
+      @zoom      = 1.0
 
       @w = FFI.webview_create(debug ? 1 : 0, nil)
       raise Error, "could not create webview" if @w.null?
@@ -83,6 +84,31 @@ module Roxane
       self
     end
 
+    # Full-content zoom, like a browser's Ctrl+± (1.0 = natural size). Backed by
+    # the engine's native zoom (WebKitGTK today); where that binding isn't
+    # available the setter no-ops and the reader reports the last requested
+    # level. Safe from any thread: scheduled with g_idle_add, which runs on the
+    # UI thread as a TOP-LEVEL loop iteration — never nested inside a webview
+    # dispatch callback, where a layout-triggering WebKit call can reenter the
+    # engine mid-resolve and crash it. Rapid calls coalesce (each application
+    # reads the latest requested level; extra idles are harmless).
+    def zoom
+      @zoom
+    end
+
+    def zoom=(factor)
+      @zoom = Float(factor)
+      return unless WebKit::AVAILABLE && GLib::AVAILABLE
+
+      @apply_zoom ||= ::FFI::Function.new(:int, [:pointer]) do |_data|
+        view = FFI.webview_get_native_handle(@w, FFI::NATIVE_HANDLE_BROWSER_CONTROLLER)
+        WebKit.webkit_web_view_set_zoom_level(view, @zoom) unless view.null?
+        0 # G_SOURCE_REMOVE
+      end
+      @callbacks << @apply_zoom unless @callbacks.include?(@apply_zoom)
+      GLib.g_idle_add(@apply_zoom, nil)
+    end
+
     def on_close(&block)
       @on_close = block
       self

data/lib/roxane.rb

@@ -36,5 +36,6 @@ module Roxane
 end
 
 require_relative "roxane/ffi"
+require_relative "roxane/webkit"
 require_relative "roxane/static_server"
 require_relative "roxane/window"

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: roxane
 version: !ruby/object:Gem::Version
-  version: 0.0.1
+  version: 0.0.2
 platform: ruby
 authors:
 - BKK Riese
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2026-06-18 00:00:00.000000000 Z
+date: 2026-07-03 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: ffi
@@ -41,6 +41,7 @@ files:
 - lib/roxane/ffi.rb
 - lib/roxane/static_server.rb
 - lib/roxane/version.rb
+- lib/roxane/webkit.rb
 - lib/roxane/window.rb
 homepage: https://github.com/quarterstack/roxane
 licenses: