qtimetrap 0.1.1

data/app/views/main_window_splitter_toggle_hover_helpers.rb

@@ -0,0 +1,71 @@
+# frozen_string_literal: true
+
+module QTimetrap
+  module Views
+    # Hover and delayed hide behavior for splitter toggle button.
+    module MainWindowSplitterToggleHoverHelpers
+      SIDEBAR_TOGGLE_HIDE_DELAY_MS = 40
+
+      private
+
+      def bind_toggle_zone_events(zone:, button:, state:)
+        zone.on(:enter) { |_| on_toggle_zone_enter(button: button, state: state) }
+        zone.on(:leave) { |_| on_toggle_zone_leave(button: button, state: state) }
+      end
+
+      def bind_toggle_button_events(button:, state:)
+        button.on(:enter) { |_| on_toggle_button_enter(button: button, state: state) }
+        button.on(:leave) { |_| on_toggle_button_leave(button: button, state: state) }
+      end
+
+      def on_toggle_zone_enter(button:, state:)
+        state[:zone_hovered] = true
+        cancel_toggle_hide(state)
+        button.show
+        button.raise
+      end
+
+      def on_toggle_zone_leave(button:, state:)
+        state[:zone_hovered] = false
+        schedule_toggle_hide(button: button, state: state)
+      end
+
+      def on_toggle_button_enter(button:, state:)
+        state[:button_hovered] = true
+        cancel_toggle_hide(state)
+        button.raise
+      end
+
+      def on_toggle_button_leave(button:, state:)
+        state[:button_hovered] = false
+        schedule_toggle_hide(button: button, state: state)
+      end
+
+      def hide_toggle_button_unless_hovered(button:, state:)
+        show = state[:button_hovered] || state[:zone_hovered]
+        button.set_visible(show)
+      end
+
+      def schedule_toggle_hide(button:, state:)
+        timer = state[:hide_timer] ||= build_toggle_hide_timer(button, state)
+        timer.stop
+        timer.start
+      end
+
+      def cancel_toggle_hide(state)
+        timer = state[:hide_timer]
+        timer&.stop
+      end
+
+      def build_toggle_hide_timer(button, state)
+        QTimer.new(button).tap do |timer|
+          timer.set_interval(SIDEBAR_TOGGLE_HIDE_DELAY_MS)
+          timer.connect('timeout') do |_|
+            timer.stop
+            hide_toggle_button_unless_hovered(button: button, state: state)
+          end
+        end
+      end
+    end
+  end
+end

data/app/views/main_window_splitter_toggle_layout_helpers.rb

@@ -0,0 +1,24 @@
+# frozen_string_literal: true
+
+module QTimetrap
+  module Views
+    # Coordinate helpers for splitter toggle affordance.
+    module MainWindowSplitterToggleLayoutHelpers
+      SIDEBAR_TOGGLE_W = 20
+      SIDEBAR_TOGGLE_H = 56
+
+      private
+
+      def toggle_x(splitter:, sidebar_widget:)
+        sidebar_width = sidebar_widget.is_visible ? sidebar_widget.width : 0
+        splitter.x + [sidebar_width - (SIDEBAR_TOGGLE_W / 2), 0].max
+      end
+
+      def toggle_y(splitter_height:)
+        y_center = ((splitter_height - SIDEBAR_TOGGLE_H) / 2)
+        max_y = [splitter_height - SIDEBAR_TOGGLE_H - 8, 8].max
+        y_center.clamp(8, max_y)
+      end
+    end
+  end
+end

data/app/views/main_window_ui_helpers.rb

@@ -0,0 +1,45 @@
+# frozen_string_literal: true
+
+module QTimetrap
+  module Views
+    # UI helper methods extracted from MainWindow runtime logic.
+    module MainWindowUiHelpers
+      private
+
+      def next_theme_name
+        themes = self.class::THEMES
+        current = themes.index(theme.name) || 0
+        themes[(current + 1) % themes.length]
+      end
+
+      def set_window_icon
+        WindowIconLoader.new(window: window, root: Application.root).apply
+      rescue StandardError => e
+        warn("[qtimetrap] icon load failed: #{e.class}: #{e.message}")
+      end
+
+      def extract_event_value(event, key)
+        return unless event.respond_to?(:[])
+
+        value = event[key]
+        return value.to_i if value
+
+        nil
+      end
+
+      def build_base_window
+        QWidget.new do |widget|
+          widget.set_window_title('QTimetrap')
+          widget.set_object_name('main_window')
+          widget.set_geometry(40, 40, self.class::WINDOW_W, self.class::WINDOW_H)
+        end
+      end
+
+      def apply_theme
+        Application.configuration.theme_name = theme.name
+        window.set_style_sheet(theme.application_stylesheet)
+        settings_store.write_theme_name(theme.name)
+      end
+    end
+  end
+end

data/app/views/window_icon_loader.rb

@@ -0,0 +1,37 @@
+# frozen_string_literal: true
+
+module QTimetrap
+  module Views
+    # Loads the app icon with SVG primary source and PNG fallback.
+    class WindowIconLoader
+      def initialize(window:, root:)
+        @window = window
+        @root = root
+      end
+
+      def apply
+        candidates = icon_candidates
+        return if candidates.empty?
+
+        icon = QIcon.new(candidates.first)
+        add_fallbacks(icon, candidates.drop(1))
+        window.set_window_icon(icon)
+      end
+
+      private
+
+      attr_reader :window, :root
+
+      def icon_candidates
+        icons_dir = File.join(root, 'app', 'assets', 'icons')
+        svg_path = File.join(icons_dir, 'qtimetrap-icon.svg')
+        png_fallback = File.join(icons_dir, 'qtimetrap-icon-256.png')
+        [svg_path, png_fallback].select { |path| File.exist?(path) }
+      end
+
+      def add_fallbacks(icon, paths)
+        paths.each { |path| icon.add_file(path) }
+      end
+    end
+  end
+end

data/bin/qtimetrap

@@ -0,0 +1,7 @@
+#!/usr/bin/env ruby
+# frozen_string_literal: true
+
+$LOAD_PATH.unshift(File.expand_path('../lib', __dir__))
+require 'qtimetrap'
+
+QTimetrap::CLI.start(ARGV)

data/config/application.rb

@@ -0,0 +1,87 @@
+# frozen_string_literal: true
+
+module QTimetrap
+  # Bootstraps app runtime, configuration, loader, and Qt application object.
+  module Application
+    module_function
+
+    def boot!
+      setup_qt
+      loader.setup
+      load_environment!
+      load_initializers!
+      load_persisted_configuration!
+      qt_app
+    end
+
+    def root
+      @root ||= File.expand_path('..', __dir__)
+    end
+
+    def environment
+      ENV.fetch('QTIMETRAP_ENV', 'development')
+    end
+
+    def configuration
+      @configuration ||= Configuration.new(environment: environment)
+    end
+
+    def configure
+      yield(configuration)
+    end
+
+    def container
+      @container ||= Container.new(config: configuration)
+    end
+
+    def loader
+      @loader ||= Zeitwerk::Loader.new.tap do |autoload|
+        autoload.push_dir(File.join(root, 'app'), namespace: QTimetrap)
+        autoload.collapse(File.join(root, 'app', 'components'))
+        autoload.enable_reloading if configuration.enable_reloading
+      end
+    end
+
+    def setup_qt
+      return if @qt_app
+
+      @qt_app = QApplication.new(0, [])
+      apply_qt_identity!
+    rescue StandardError
+      @qt_app ||= nil
+    end
+
+    def qt_app
+      @qt_app
+    end
+
+    def load_environment!
+      path = File.join(root, 'config', 'environments', "#{environment}.rb")
+      require path if File.exist?(path)
+    end
+
+    def load_initializers!
+      Dir[File.join(root, 'config', 'initializers', '*.rb')].each do |file|
+        require file
+      end
+    end
+
+    def load_persisted_configuration!
+      return if env_theme_name?
+
+      persisted_theme = Services::SettingsStore.new.read_theme_name
+      configuration.theme_name = persisted_theme if persisted_theme
+    end
+
+    def env_theme_name?
+      ENV.fetch('QTIMETRAP_THEME', '').strip != ''
+    end
+
+    def apply_qt_identity!
+      QApplication.set_application_name('qtimetrap')
+      QApplication.set_desktop_file_name('qtimetrap')
+      QApplication.set_application_display_name('QTimetrap')
+      QApplication.set_organization_name('mveynberg')
+    end
+  end
+end

data/config/environments/development.rb

@@ -0,0 +1,5 @@
+# frozen_string_literal: true
+
+QTimetrap::Application.configure do |config|
+  config.enable_reloading = ENV['QTIMETRAP_RELOAD'] == '1'
+end

data/config/environments/production.rb

@@ -0,0 +1,5 @@
+# frozen_string_literal: true
+
+QTimetrap::Application.configure do |config|
+  config.enable_reloading = false
+end

data/config/initializers/theme.rb

@@ -0,0 +1,5 @@
+# frozen_string_literal: true
+
+QTimetrap::Application.configure do |config|
+  config.theme_name = ENV.fetch('QTIMETRAP_THEME', config.theme_name)
+end

data/config/initializers/timetrap.rb

@@ -0,0 +1,5 @@
+# frozen_string_literal: true
+
+QTimetrap::Application.configure do |config|
+  config.timetrap_bin = ENV.fetch('TIMETRAP_BIN', config.timetrap_bin)
+end

data/lib/qtimetrap/configuration.rb

@@ -0,0 +1,15 @@
+# frozen_string_literal: true
+
+module QTimetrap
+  # Mutable runtime configuration used during application boot.
+  class Configuration
+    attr_accessor :environment, :theme_name, :timetrap_bin, :enable_reloading
+
+    def initialize(environment: 'development')
+      @environment = environment
+      @theme_name = 'light'
+      @timetrap_bin = 't'
+      @enable_reloading = environment == 'development'
+    end
+  end
+end

data/lib/qtimetrap/container.rb

@@ -0,0 +1,57 @@
+# frozen_string_literal: true
+
+module QTimetrap
+  # Tiny DI container that registers app services and memoized singletons.
+  class Container
+    def initialize(config:)
+      @config = config
+      @providers = {}
+      @memoized = {}
+      register_defaults
+    end
+
+    def register(key, &provider)
+      providers[key.to_sym] = provider
+    end
+
+    def fetch(key)
+      name = key.to_sym
+      return memoized[name] if memoized.key?(name)
+
+      provider = providers.fetch(name)
+      memoized[name] = provider.call
+    end
+
+    private
+
+    attr_reader :config, :providers, :memoized
+
+    def register_defaults
+      register_core
+      register_ui
+    end
+
+    def register_core
+      register(:theme) { Styles::Theme.new(name: config.theme_name, root: Application.root) }
+      register(:settings_store) { Services::SettingsStore.new }
+      register(:archived_entries_store) { Services::ArchivedEntriesStore.new }
+      register(:timetrap_gateway) { Services::TimetrapGateway.new(bin: config.timetrap_bin) }
+      register(:main_view_model) do
+        ViewModels::MainViewModel.new(
+          gateway: fetch(:timetrap_gateway),
+          archived_entries_store: fetch(:archived_entries_store)
+        )
+      end
+    end
+
+    def register_ui
+      register(:main_window) do
+        Views::MainWindow.new(
+          view_model: fetch(:main_view_model),
+          theme: fetch(:theme),
+          settings_store: fetch(:settings_store)
+        )
+      end
+    end
+  end
+end

data/lib/qtimetrap/version.rb

@@ -0,0 +1,5 @@
+# frozen_string_literal: true
+
+module QTimetrap
+  VERSION = '0.1.1'
+end

data/lib/qtimetrap.rb

@@ -0,0 +1,25 @@
+# frozen_string_literal: true
+
+require 'qt'
+require 'zeitwerk'
+
+require_relative 'qtimetrap/version'
+require_relative 'qtimetrap/configuration'
+require_relative 'qtimetrap/container'
+require_relative '../config/application'
+
+module QTimetrap
+  # CLI entrypoint for launching the Qt desktop application.
+  class CLI
+    def self.start(_argv = [])
+      app = QTimetrap::Application.boot!
+      main_window = QTimetrap::Application.container.fetch(:main_window)
+      previous_int = Signal.trap('INT') { main_window.request_shutdown }
+      main_window.show
+      app.exec
+    ensure
+      Signal.trap('INT', previous_int) if defined?(previous_int) && previous_int
+      app&.dispose
+    end
+  end
+end

metadata

@@ -0,0 +1,207 @@
+--- !ruby/object:Gem::Specification
+name: qtimetrap
+version: !ruby/object:Gem::Version
+  version: 0.1.1
+platform: ruby
+authors:
+- Maksim Veynberg
+bindir: bin
+cert_chain: []
+date: 1980-01-02 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: qt
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.1'
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 0.1.4
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.1'
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 0.1.4
+- !ruby/object:Gem::Dependency
+  name: zeitwerk
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.6'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.6'
+description: MVVM Ruby desktop app for Timetrap built with Qt and Zeitwerk.
+email:
+- mv@cj264.ru
+executables:
+- qtimetrap
+extensions: []
+extra_rdoc_files: []
+files:
+- LICENSE
+- README.md
+- Rakefile
+- app/assets/icons/qtimetrap-icon-128.png
+- app/assets/icons/qtimetrap-icon-256.png
+- app/assets/icons/qtimetrap-icon-512.png
+- app/assets/icons/qtimetrap-icon.svg
+- app/components/entries/branch_hierarchy_helpers.rb
+- app/components/entries/leaf_archive_helpers.rb
+- app/components/entries/leaf_note_helpers.rb
+- app/components/entries/leaf_task_helpers.rb
+- app/components/entries/leaf_time_helpers.rb
+- app/components/entries/list_component.rb
+- app/components/entries/list_host_helpers.rb
+- app/components/entries/list_state_helpers.rb
+- app/components/entries/node_presentation_helpers.rb
+- app/components/entries/render_helpers.rb
+- app/components/entries/tree_helpers.rb
+- app/components/entries/tree_toolbar_helpers.rb
+- app/components/project_sidebar/archive_toggle_helpers.rb
+- app/components/project_sidebar/component.rb
+- app/components/project_sidebar/logo_helpers.rb
+- app/components/project_sidebar/project_button_helpers.rb
+- app/components/project_sidebar/project_selection_helpers.rb
+- app/components/project_sidebar/task_helpers.rb
+- app/components/project_sidebar/task_selection_helpers.rb
+- app/components/qt_ui_helpers.rb
+- app/components/tracker_controls/component.rb
+- app/components/tracker_controls/layout_builder.rb
+- app/components/tracker_controls/layout_helpers.rb
+- app/models/null_settings_store.rb
+- app/models/time_entry.rb
+- app/services/archived_entries_store.rb
+- app/services/formatters.rb
+- app/services/settings_store.rb
+- app/services/timetrap_gateway.rb
+- app/services/timetrap_gateway_logger.rb
+- app/services/timetrap_gateway_query_helpers.rb
+- app/services/timetrap_gateway_start_helpers.rb
+- app/services/timetrap_gateway_update_note_helpers.rb
+- app/services/timetrap_gateway_update_task_helpers.rb
+- app/services/timetrap_gateway_update_time_helpers.rb
+- app/styles/theme.rb
+- app/styles/themes/dark/application.qss
+- app/styles/themes/dark/entries_list.qss
+- app/styles/themes/dark/project_sidebar.qss
+- app/styles/themes/dark/snippets/app_background.qss
+- app/styles/themes/dark/snippets/button_ghost.qss
+- app/styles/themes/dark/snippets/button_start.qss
+- app/styles/themes/dark/snippets/button_stop.qss
+- app/styles/themes/dark/snippets/entries_host.qss
+- app/styles/themes/dark/snippets/entries_scroll.qss
+- app/styles/themes/dark/snippets/entry_row_day.qss
+- app/styles/themes/dark/snippets/entry_row_detail.qss
+- app/styles/themes/dark/snippets/entry_row_project.qss
+- app/styles/themes/dark/snippets/project_button.qss
+- app/styles/themes/dark/snippets/project_button_active.qss
+- app/styles/themes/dark/snippets/project_sidebar_heading.qss
+- app/styles/themes/dark/snippets/project_sidebar_logo.qss
+- app/styles/themes/dark/snippets/project_sidebar_panel.qss
+- app/styles/themes/dark/snippets/tracker_clock.qss
+- app/styles/themes/dark/snippets/tracker_input.qss
+- app/styles/themes/dark/snippets/tracker_project_label.qss
+- app/styles/themes/dark/snippets/tracker_row.qss
+- app/styles/themes/dark/snippets/tracker_summary.qss
+- app/styles/themes/dark/snippets/tracker_timer.qss
+- app/styles/themes/dark/snippets/tracker_title.qss
+- app/styles/themes/dark/snippets/tracker_topbar.qss
+- app/styles/themes/dark/tracker_controls.qss
+- app/styles/themes/light/application.qss
+- app/styles/themes/light/entries_list.qss
+- app/styles/themes/light/project_sidebar.qss
+- app/styles/themes/light/snippets/app_background.qss
+- app/styles/themes/light/snippets/button_ghost.qss
+- app/styles/themes/light/snippets/button_start.qss
+- app/styles/themes/light/snippets/button_stop.qss
+- app/styles/themes/light/snippets/entries_host.qss
+- app/styles/themes/light/snippets/entries_scroll.qss
+- app/styles/themes/light/snippets/entry_row_day.qss
+- app/styles/themes/light/snippets/entry_row_detail.qss
+- app/styles/themes/light/snippets/entry_row_project.qss
+- app/styles/themes/light/snippets/project_button.qss
+- app/styles/themes/light/snippets/project_button_active.qss
+- app/styles/themes/light/snippets/project_sidebar_heading.qss
+- app/styles/themes/light/snippets/project_sidebar_logo.qss
+- app/styles/themes/light/snippets/project_sidebar_panel.qss
+- app/styles/themes/light/snippets/tracker_clock.qss
+- app/styles/themes/light/snippets/tracker_input.qss
+- app/styles/themes/light/snippets/tracker_project_label.qss
+- app/styles/themes/light/snippets/tracker_row.qss
+- app/styles/themes/light/snippets/tracker_summary.qss
+- app/styles/themes/light/snippets/tracker_timer.qss
+- app/styles/themes/light/snippets/tracker_title.qss
+- app/styles/themes/light/snippets/tracker_topbar.qss
+- app/styles/themes/light/tracker_controls.qss
+- app/view_models/entry_nodes_builder.rb
+- app/view_models/main_view_model.rb
+- app/view_models/main_view_model_archive_mode_helpers.rb
+- app/view_models/main_view_model_entry_note_helpers.rb
+- app/view_models/main_view_model_entry_task_helpers.rb
+- app/view_models/main_view_model_entry_time_helpers.rb
+- app/view_models/main_view_model_sheet_helpers.rb
+- app/view_models/main_view_model_task_filter_helpers.rb
+- app/view_models/main_view_model_time_range_filter_helpers.rb
+- app/views/main_window.rb
+- app/views/main_window_layout_builder.rb
+- app/views/main_window_runtime.rb
+- app/views/main_window_runtime_archive_helpers.rb
+- app/views/main_window_runtime_entry_task_helpers.rb
+- app/views/main_window_runtime_entry_time_helpers.rb
+- app/views/main_window_runtime_key_helpers.rb
+- app/views/main_window_runtime_render_helpers.rb
+- app/views/main_window_splitter_toggle_bootstrap_helpers.rb
+- app/views/main_window_splitter_toggle_helpers.rb
+- app/views/main_window_splitter_toggle_hover_helpers.rb
+- app/views/main_window_splitter_toggle_layout_helpers.rb
+- app/views/main_window_ui_helpers.rb
+- app/views/window_icon_loader.rb
+- bin/qtimetrap
+- config/application.rb
+- config/environments/development.rb
+- config/environments/production.rb
+- config/initializers/theme.rb
+- config/initializers/timetrap.rb
+- lib/qtimetrap.rb
+- lib/qtimetrap/configuration.rb
+- lib/qtimetrap/container.rb
+- lib/qtimetrap/version.rb
+homepage: https://github.com/CyJimmy264/qtimetrap
+licenses:
+- BSD-2-Clause
+metadata:
+  source_code_uri: https://github.com/CyJimmy264/qtimetrap
+  changelog_uri: https://github.com/CyJimmy264/qtimetrap/releases
+  bug_tracker_uri: https://github.com/CyJimmy264/qtimetrap/issues
+  rubygems_mfa_required: 'true'
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '3.2'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubygems_version: 3.6.7
+specification_version: 4
+summary: Desktop Timetrap UI on Qt
+test_files: []