qt 0.1.0

data/examples/qtproject/widgets/itemviews/spreadsheet/main.rb

@@ -0,0 +1,252 @@
+# frozen_string_literal: true
+
+$LOAD_PATH.unshift(File.expand_path('../../../../../lib', __dir__))
+require 'qt'
+
+WINDOW_W = 980
+WINDOW_H = 660
+COLS = 6
+
+HEADERS = ['Item', 'Date', 'Price', 'Currency', 'Ex. Rate', 'NOK'].freeze
+ROWS_DATA = [
+  ['AirportBus', '15/6/2006', 150, 'NOK', 1],
+  ['Flight (Munich)', '15/6/2006', 2350, 'NOK', 1],
+  ['Lunch', '15/6/2006', -14, 'EUR', 8],
+  ['Flight (LA)', '21/5/2006', 980, 'EUR', 8],
+  ['Taxi', '16/6/2006', 5, 'USD', 7],
+  ['Dinner', '16/6/2006', 120, 'USD', 7],
+  ['Hotel', '16/6/2006', 300, 'USD', 7],
+  ['Flight (Oslo)', '18/6/2006', 1240, 'NOK', 1]
+].freeze
+
+ROWS = ROWS_DATA.length + 1
+TOTAL_ROW = ROWS - 1
+
+BG = 'background-color: #0b111b; border: 1px solid #1f2937;'
+PANEL = 'background-color: #0f172a; border: 1px solid #334155; color: #e2e8f0;'
+TITLE = 'background-color: #111827; border: 1px solid #374151; color: #f8fafc; font-size: 16px; font-weight: 800;'
+INPUT = 'background-color: #0b1220; border: 1px solid #334155; color: #f8fafc; font-size: 12px;'
+BTN = 'background-color: #111827; border: 1px solid #64748b; color: #e2e8f0; font-size: 12px; font-weight: 700;'
+BTN_ACTIVE = 'background-color: #1d4ed8; border: 2px solid #60a5fa; color: #f8fafc; font-size: 12px; font-weight: 800;'
+
+TABLE_QSS = [
+  'QTableWidget {',
+  '  background-color: #0b1220;',
+  '  color: #f8fafc;',
+  '  border: 1px solid #334155;',
+  '  gridline-color: #1f2937;',
+  '}',
+  'QHeaderView::section {',
+  '  background-color: #3f3f46;',
+  '  color: #f8fafc;',
+  '  border: 1px solid #4b5563;',
+  '  font-weight: 700;',
+  '}',
+  'QTableCornerButton::section {',
+  '  background-color: #3f3f46;',
+  '  border: 1px solid #4b5563;',
+  '}'
+].join("\n").freeze
+
+app = QApplication.new(0, [])
+window = QWidget.new do |w|
+  w.set_window_title('Spreadsheet')
+  w.set_geometry(70, 60, WINDOW_W, WINDOW_H)
+end
+
+bg = QLabel.new(window)
+panel = QLabel.new(window)
+
+title = QLabel.new(window)
+title.set_alignment(Qt::AlignCenter)
+title.set_text('Spreadsheet')
+
+cell_label = QLabel.new(window)
+cell_label.set_alignment(Qt::AlignCenter)
+cell_label.set_text('Cell: (A1)')
+
+formula = QLineEdit.new(window)
+formula.set_placeholder_text('Cell value')
+
+apply_btn = QPushButton.new(window)
+apply_btn.set_text('APPLY')
+
+recalc_btn = QPushButton.new(window)
+recalc_btn.set_text('RECALCULATE')
+
+sheet = QTableWidget.new(window)
+sheet.set_row_count(ROWS)
+sheet.set_column_count(COLS)
+sheet.set_vertical_scroll_mode(Qt::ScrollPerPixel)
+
+[180, 160, 120, 140, 120, 120].each_with_index do |width, col|
+  sheet.set_column_width(col, width)
+end
+
+headers = []
+HEADERS.each_with_index do |text, col|
+  item = QTableWidgetItem.new
+  item.set_text(text)
+  item.set_text_alignment(Qt::AlignCenter)
+  sheet.set_horizontal_header_item(col, item)
+  headers << item
+end
+
+matrix = Array.new(ROWS) { Array.new(COLS) }
+
+ROWS_DATA.each_with_index do |row_data, row|
+  COLS.times do |col|
+    item = QTableWidgetItem.new
+    value = case col
+            when 0 then row_data[0]
+            when 1 then row_data[1]
+            when 2 then row_data[2]
+            when 3 then row_data[3]
+            when 4 then row_data[4]
+            else 0
+            end
+    item.set_text(value.to_s)
+    item.set_text_alignment(Qt::AlignCenter)
+    sheet.set_item(row, col, item)
+    matrix[row][col] = item
+  end
+end
+
+COLS.times do |col|
+  item = QTableWidgetItem.new
+  value = if col.zero?
+            'Total:'
+          elsif col == 5
+            '0'
+          else
+            'None'
+          end
+  item.set_text(value)
+  item.set_text_alignment(Qt::AlignCenter)
+  sheet.set_item(TOTAL_ROW, col, item)
+  matrix[TOTAL_ROW][col] = item
+end
+
+int_value = lambda do |text|
+  Integer(text.to_s.strip)
+rescue StandardError
+  0
+end
+
+recompute = lambda do
+  total = 0
+  ROWS_DATA.length.times do |row|
+    price = int_value.call(matrix[row][2].text)
+    rate = int_value.call(matrix[row][4].text)
+    nok = price * rate
+    matrix[row][5].set_text(nok.to_s)
+    total += nok
+  end
+
+  matrix[TOTAL_ROW][5].set_text(total.to_s)
+end
+
+col_label = lambda do |col|
+  letters = +''
+  n = col + 1
+  while n.positive?
+    n -= 1
+    letters.prepend((65 + (n % 26)).chr)
+    n /= 26
+  end
+  letters
+end
+
+sync_formula_with_current = lambda do
+  row = sheet.current_row
+  col = sheet.current_column
+  return if row.negative? || col.negative?
+
+  item = matrix[row][col]
+  return unless item
+
+  cell_label.set_text("Cell: (#{col_label.call(col)}#{row + 1})")
+  formula.set_text(item.text.to_s)
+end
+
+flash = lambda do |button|
+  button.set_style_sheet(BTN_ACTIVE)
+  QApplication.process_events
+  sleep(0.03)
+  button.set_style_sheet(BTN)
+end
+
+apply_current_cell = lambda do
+  row = sheet.current_row
+  col = sheet.current_column
+  return if row.negative? || col.negative?
+
+  item = matrix[row][col]
+  return unless item
+
+  item.set_text(formula.text.to_s)
+  recompute.call
+  sync_formula_with_current.call
+end
+
+apply_btn.connect('clicked') do
+  flash.call(apply_btn)
+  apply_current_cell.call
+end
+
+formula.connect('returnPressed') { apply_current_cell.call }
+
+recalc_btn.connect('clicked') do
+  flash.call(recalc_btn)
+  recompute.call
+  sync_formula_with_current.call
+end
+
+sheet.on(:mouse_button_release) { sync_formula_with_current.call }
+sheet.on(:key_release) { sync_formula_with_current.call }
+
+layout_ui = lambda do
+  ww = window.width
+  wh = window.height
+
+  bg.set_geometry(0, 0, ww, wh)
+  panel.set_geometry(16, 16, ww - 32, wh - 32)
+
+  title.set_geometry(32, 24, ww - 64, 36)
+
+  cell_label.set_geometry(32, 68, 130, 32)
+  formula.set_geometry(170, 68, ww - 372, 32)
+  apply_btn.set_geometry(ww - 194, 68, 74, 32)
+  recalc_btn.set_geometry(ww - 112, 68, 80, 32)
+
+  sheet.set_geometry(32, 112, ww - 64, wh - 144)
+end
+
+apply_styles = lambda do
+  bg.set_style_sheet(BG)
+  panel.set_style_sheet(PANEL)
+  title.set_style_sheet(TITLE)
+  cell_label.set_style_sheet(PANEL)
+  formula.set_style_sheet(INPUT)
+  apply_btn.set_style_sheet(BTN)
+  recalc_btn.set_style_sheet(BTN)
+  sheet.set_style_sheet(TABLE_QSS)
+end
+
+window.on(:resize) { layout_ui.call }
+
+recompute.call
+apply_styles.call
+layout_ui.call
+sheet.set_current_cell(0, 0)
+sync_formula_with_current.call
+window.show
+QApplication.process_events
+
+# TODO: Replace manual process_events loop with app.exec + QTimer.
+while window.is_visible != 0
+  QApplication.process_events
+  sleep(0.01)
+end
+
+app.dispose

data/examples/qtproject/widgets/widgetsgallery/main.rb

@@ -0,0 +1,184 @@
+# frozen_string_literal: true
+
+$LOAD_PATH.unshift(File.expand_path('../../../../lib', __dir__))
+require 'qt'
+
+WINDOW_W = 980
+WINDOW_H = 640
+SIDEBAR_W = 300
+
+THEMES = {
+  light: {
+    root: 'background-color: #f5f7fb; border: 1px solid #dbe1ec;',
+    card: 'background-color: #ffffff; border: 1px solid #d5dce8; color: #0f172a;',
+    title: 'background-color: #ffffff; border: 1px solid #cbd5e1; color: #0f172a; font-size: 17px; font-weight: 800;',
+    button: 'background-color: #ffffff; border: 1px solid #94a3b8; color: #0f172a; font-size: 12px; font-weight: 700;',
+    button_active: 'background-color: #dbeafe; border: 2px solid #2563eb; color: #0f172a; ' \
+                   'font-size: 12px; font-weight: 800;',
+    input: 'background-color: #ffffff; border: 1px solid #a8b3c6; color: #0f172a; font-size: 12px;'
+  },
+  dark: {
+    root: 'background-color: #0b1220; border: 1px solid #1f2a44;',
+    card: 'background-color: #101a2d; border: 1px solid #334155; color: #e2e8f0;',
+    title: 'background-color: #0f172a; border: 1px solid #334155; color: #f8fafc; font-size: 17px; font-weight: 800;',
+    button: 'background-color: #111827; border: 1px solid #475569; color: #e2e8f0; font-size: 12px; font-weight: 700;',
+    button_active: 'background-color: #1d4ed8; border: 2px solid #60a5fa; color: #f8fafc; ' \
+                   'font-size: 12px; font-weight: 800;',
+    input: 'background-color: #0b1220; border: 1px solid #475569; color: #e2e8f0; font-size: 12px;'
+  }
+}.freeze
+
+app = QApplication.new(0, [])
+window = QWidget.new do |w|
+  w.set_window_title('Qt Ruby Widget Gallery Lite (inspired by PySide widgetsgallery)')
+  w.set_geometry(70, 60, WINDOW_W, WINDOW_H)
+end
+
+root = QLabel.new(window)
+left = QLabel.new(window)
+right = QLabel.new(window)
+
+headline = QLabel.new(window)
+headline.set_alignment(Qt::AlignCenter)
+headline.set_text('Widget Gallery Lite')
+
+subtitle = QLabel.new(window)
+subtitle.set_alignment(Qt::AlignCenter)
+subtitle.set_text('Inspired by PySide widgetsgallery: theme toggle, interactive controls, status area')
+
+name_label = QLabel.new(window)
+name_label.set_alignment(Qt::AlignCenter)
+name_label.set_text('Name input')
+
+name_input = QLineEdit.new(window)
+name_input.set_placeholder_text('Type your name...')
+
+name_echo = QLabel.new(window)
+name_echo.set_alignment(Qt::AlignCenter)
+name_echo.set_text('Hello, stranger')
+
+counter_label = QLabel.new(window)
+counter_label.set_alignment(Qt::AlignCenter)
+counter_label.set_text('Counter: 0')
+
+counter = 0
+
+actions = [
+  { key: :plus, text: 'INCREMENT' },
+  { key: :minus, text: 'DECREMENT' },
+  { key: :reset, text: 'RESET' },
+  { key: :theme, text: 'TOGGLE THEME' }
+]
+
+actions.each do |action|
+  action[:view] = QPushButton.new(window)
+  action[:view].set_text(action[:text])
+end
+
+status = QLabel.new(window)
+status.set_alignment(Qt::AlignCenter)
+status.set_text('Ready')
+
+current_theme = :light
+
+layout_ui = lambda do
+  ww = window.width
+  wh = window.height
+  sidebar_x = ww - SIDEBAR_W
+
+  root.set_geometry(0, 0, ww, wh)
+
+  left.set_geometry(16, 16, ww - SIDEBAR_W - 32, wh - 32)
+  headline.set_geometry(34, 34, ww - SIDEBAR_W - 68, 40)
+  subtitle.set_geometry(34, 82, ww - SIDEBAR_W - 68, 34)
+
+  name_label.set_geometry(34, 142, ww - SIDEBAR_W - 68, 30)
+  name_input.set_geometry(34, 178, ww - SIDEBAR_W - 68, 38)
+  name_echo.set_geometry(34, 224, ww - SIDEBAR_W - 68, 38)
+  counter_label.set_geometry(34, 272, ww - SIDEBAR_W - 68, 38)
+
+  right.set_geometry(sidebar_x, 0, SIDEBAR_W, wh)
+  actions.each_with_index do |action, idx|
+    action[:view].set_geometry(sidebar_x + 18, 28 + (idx * 52), SIDEBAR_W - 36, 40)
+  end
+  status.set_geometry(sidebar_x + 18, wh - 84, SIDEBAR_W - 36, 56)
+end
+
+apply_theme = lambda do
+  theme = THEMES.fetch(current_theme)
+  root.set_style_sheet(theme[:root])
+  left.set_style_sheet(theme[:card])
+  right.set_style_sheet(theme[:card])
+  headline.set_style_sheet(theme[:title])
+  subtitle.set_style_sheet(theme[:card])
+  name_label.set_style_sheet(theme[:card])
+  name_input.set_style_sheet(theme[:input])
+  name_echo.set_style_sheet(theme[:card])
+  counter_label.set_style_sheet(theme[:card])
+  status.set_style_sheet(theme[:card])
+  actions.each { |a| a[:view].set_style_sheet(theme[:button]) }
+end
+
+flash = lambda do |button|
+  theme = THEMES.fetch(current_theme)
+  button.set_style_sheet(theme[:button_active])
+  QApplication.process_events
+  sleep(0.03)
+  button.set_style_sheet(theme[:button])
+end
+
+set_name_echo = lambda do
+  text = name_input.text.to_s.strip
+  name_echo.set_text(text.empty? ? 'Hello, stranger' : "Hello, #{text}")
+end
+
+set_counter = lambda do
+  counter_label.set_text("Counter: #{counter}")
+end
+
+perform = lambda do |key, view|
+  flash.call(view)
+
+  case key
+  when :plus
+    counter += 1
+    set_counter.call
+    status.set_text('Incremented')
+  when :minus
+    counter -= 1
+    set_counter.call
+    status.set_text('Decremented')
+  when :reset
+    counter = 0
+    set_counter.call
+    name_input.set_text('')
+    set_name_echo.call
+    status.set_text('Reset all')
+  when :theme
+    current_theme = (current_theme == :light ? :dark : :light)
+    apply_theme.call
+    status.set_text("Theme: #{current_theme}")
+  end
+end
+
+actions.each do |action|
+  action[:view].connect('clicked') do
+    perform.call(action[:key], action[:view])
+  end
+end
+
+name_input.connect('textChanged') { set_name_echo.call }
+window.on(:resize) { layout_ui.call }
+
+layout_ui.call
+apply_theme.call
+window.show
+QApplication.process_events
+
+# TODO: Replace manual process_events loop with app.exec + QTimer.
+while window.is_visible != 0
+  QApplication.process_events
+  sleep(0.01)
+end
+
+app.dispose

data/ext/qt_ruby_bridge/extconf.rb

@@ -0,0 +1,75 @@
+# frozen_string_literal: true
+
+require 'mkmf'
+require 'fileutils'
+
+PKG_CONFIG = RbConfig::CONFIG['PKG_CONFIG'] || 'pkg-config'
+QT_PACKAGES = %w[Qt6Core Qt6Gui Qt6Widgets].freeze
+MINIMUM_QT_VERSION = Gem::Version.new('6.10.0')
+
+def pkg_config(*)
+  system(PKG_CONFIG, *, out: File::NULL, err: File::NULL)
+end
+
+def pkg_config_capture(*args)
+  `#{[PKG_CONFIG, *args].join(' ')}`.strip
+end
+
+abort 'pkg-config is required to build qt-ruby bridge.' unless find_executable(PKG_CONFIG)
+
+generator = File.expand_path('../../scripts/generate_bridge.rb', __dir__)
+abort "Generator script not found: #{generator}" unless File.exist?(generator)
+
+generator_env = {}
+scope = ENV.fetch('QT_RUBY_SCOPE', nil)
+generator_env['QT_RUBY_SCOPE'] = scope if scope && !scope.empty?
+abort 'Failed to generate Qt bridge files.' unless system(generator_env, RbConfig.ruby, generator)
+
+missing = QT_PACKAGES.reject { |pkg| pkg_config('--exists', pkg) }
+abort "Missing Qt packages: #{missing.join(', ')}" unless missing.empty?
+
+qt_version_str = pkg_config_capture('--modversion', 'Qt6Core')
+qt_version = Gem::Version.new(qt_version_str)
+abort "Qt version #{qt_version} is too old. Require >= #{MINIMUM_QT_VERSION}." if qt_version < MINIMUM_QT_VERSION
+
+cflags = pkg_config_capture('--cflags', *QT_PACKAGES)
+libs = pkg_config_capture('--libs', *QT_PACKAGES)
+generated_cpp = if File.exist?('qt_ruby_bridge.cpp')
+                  File.expand_path('qt_ruby_bridge.cpp')
+                else
+                  File.expand_path('../../build/generated/qt_ruby_bridge.cpp', __dir__)
+                end
+runtime_hpp = File.expand_path('../../ext/qt_ruby_bridge/qt_ruby_runtime.hpp', __dir__)
+runtime_cpp_files = %w[
+  runtime_events.cpp
+  runtime_signals.cpp
+].map { |name| File.expand_path("../../ext/qt_ruby_bridge/#{name}", __dir__) }
+
+unless File.exist?(generated_cpp)
+  abort "Generated source not found: #{generated_cpp}. Run: ruby scripts/generate_bridge.rb"
+end
+abort "Runtime header not found: #{runtime_hpp}" unless File.exist?(runtime_hpp)
+missing_runtime = runtime_cpp_files.reject { |path| File.exist?(path) }
+abort "Runtime source not found: #{missing_runtime.join(', ')}" unless missing_runtime.empty?
+
+local_cpp = File.expand_path('qt_ruby_bridge.cpp')
+FileUtils.cp(generated_cpp, local_cpp) unless File.exist?(local_cpp) && File.identical?(generated_cpp, local_cpp)
+runtime_cpp_files.each do |runtime_cpp|
+  local_runtime_cpp = File.expand_path(File.basename(runtime_cpp))
+  unless File.exist?(local_runtime_cpp) && File.identical?(runtime_cpp, local_runtime_cpp)
+    FileUtils.cp(runtime_cpp, local_runtime_cpp)
+  end
+end
+local_runtime_hpp = File.expand_path('qt_ruby_runtime.hpp')
+unless File.exist?(local_runtime_hpp) && File.identical?(runtime_hpp, local_runtime_hpp)
+  FileUtils.cp(runtime_hpp, local_runtime_hpp)
+end
+
+# mkmf uses these global variables for compiler/linker/source configuration.
+# rubocop:disable Style/GlobalVars
+$CXXFLAGS = "#{$CXXFLAGS} #{cflags} -std=c++17"
+$LDFLAGS = "#{$LDFLAGS} #{libs}"
+$srcs = ['qt_ruby_bridge.cpp', *runtime_cpp_files.map { |f| File.basename(f) }]
+# rubocop:enable Style/GlobalVars
+
+create_makefile('qt/qt_ruby_bridge')

data/ext/qt_ruby_bridge/qt_ruby_runtime.hpp

@@ -0,0 +1,23 @@
+#pragma once
+
+#include <QApplication>
+
+namespace QtRubyRuntime {
+using EventCallback = void (*)(void*, int, int, int, int, int);
+using SignalCallback = void (*)(void*, int, const char*);
+
+// Creates/owns the singleton QApplication used by the Ruby runtime bridge.
+// The implementation records the creating thread as GUI thread for shutdown checks.
+QApplication* qapplication_new(const char* argv0);
+// Performs guarded QApplication teardown.
+// Returns false when teardown is rejected by runtime safety checks.
+bool qapplication_delete(void* app_handle);
+
+void set_event_callback(void* callback_ptr);
+void watch_qobject_event(void* object_handle, int event_type);
+void unwatch_qobject_event(void* object_handle, int event_type);
+
+void set_signal_callback(void* callback_ptr);
+int qobject_connect_signal(void* object_handle, const char* signal_name);
+int qobject_disconnect_signal(void* object_handle, const char* signal_name);
+}  // namespace QtRubyRuntime