charming 0.2.3 → 0.4.0

data/lib/charming.rb

@@ -1,7 +1,5 @@
 # frozen_string_literal: true
 
-require "active_support/inflector"
-require "active_support/string_inquirer"
 require "logger"
 require "zeitwerk"
 
@@ -26,15 +24,15 @@ module Charming
   # Base error class for all Charming-specific exceptions (used by templates, generators, runtime, etc.).
   class Error < StandardError; end
 
-  # The current environment, read from CHARMING_ENV (default "development"). Returns a
-  # StringInquirer so callers can write `Charming.env.test?` / `Charming.env.production?`.
+  # The current environment, read from CHARMING_ENV (default "development"). Returns an
+  # EnvInquirer so callers can write `Charming.env.test?` / `Charming.env.production?`.
   def self.env
-    @env ||= ActiveSupport::StringInquirer.new(ENV["CHARMING_ENV"] || "development")
+    @env ||= Internal::EnvInquirer.new(ENV["CHARMING_ENV"] || "development")
   end
 
   # Overrides the environment (used by tests and the CLI).
   def self.env=(value)
-    @env = value.nil? ? nil : ActiveSupport::StringInquirer.new(value.to_s)
+    @env = value.nil? ? nil : Internal::EnvInquirer.new(value.to_s)
   end
 
   # Entry point for running a Charming application. Instantiates a Runtime for *application* and starts
@@ -43,6 +41,12 @@ module Charming
     Runtime.new(application, backend: backend).run
   end
 
+  # Returns the seconds-per-frame time delta for a frame rate, for initializing
+  # physics primitives: `Charming::Spring.new(delta_time: Charming.fps(60))`.
+  def self.fps(frames_per_second)
+    1.0 / frames_per_second
+  end
+
   # Returns the normalized key symbol for an event-like object — `event.key` when the object responds
   # to it, otherwise `event.to_sym`. Lets components treat raw strings and KeyEvent objects uniformly.
   def self.key_of(event)
@@ -78,6 +82,16 @@ module Charming
 
     :"#{(ordered_modifiers + [key]).join("+")}"
   end
+
+  # Emits a deprecation warning once per process per *category*, prefixed
+  # "[charming deprecation]". Warnings go to stderr.
+  def self.deprecate(message, category:)
+    @deprecation_emitted ||= {}
+    return if @deprecation_emitted[category]
+
+    @deprecation_emitted[category] = true
+    warn("[charming deprecation] #{message}")
+  end
 end
 
 Charming::Templates.register ".tui.erb", Charming::Templates::ErbHandler

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: charming
 version: !ruby/object:Gem::Version
-  version: 0.2.3
+  version: 0.4.0
 platform: ruby
 authors:
 - pando
@@ -29,26 +29,6 @@ dependencies:
     - - ">="
       - !ruby/object:Gem::Version
         version: 8.1.2
-- !ruby/object:Gem::Dependency
-  name: activesupport
-  requirement: !ruby/object:Gem::Requirement
-    requirements:
-    - - "~>"
-      - !ruby/object:Gem::Version
-        version: '8.1'
-    - - ">="
-      - !ruby/object:Gem::Version
-        version: 8.1.2
-  type: :runtime
-  prerelease: false
-  version_requirements: !ruby/object:Gem::Requirement
-    requirements:
-    - - "~>"
-      - !ruby/object:Gem::Version
-        version: '8.1'
-    - - ">="
-      - !ruby/object:Gem::Version
-        version: 8.1.2
 - !ruby/object:Gem::Dependency
   name: commonmarker
   requirement: !ruby/object:Gem::Requirement
@@ -91,48 +71,6 @@ dependencies:
     - - "~>"
       - !ruby/object:Gem::Version
         version: '5.0'
-- !ruby/object:Gem::Dependency
-  name: tty-cursor
-  requirement: !ruby/object:Gem::Requirement
-    requirements:
-    - - "~>"
-      - !ruby/object:Gem::Version
-        version: '0.7'
-  type: :runtime
-  prerelease: false
-  version_requirements: !ruby/object:Gem::Requirement
-    requirements:
-    - - "~>"
-      - !ruby/object:Gem::Version
-        version: '0.7'
-- !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'
-- !ruby/object:Gem::Dependency
-  name: tty-table
-  requirement: !ruby/object:Gem::Requirement
-    requirements:
-    - - "~>"
-      - !ruby/object:Gem::Version
-        version: '0.12'
-  type: :runtime
-  prerelease: false
-  version_requirements: !ruby/object:Gem::Requirement
-    requirements:
-    - - "~>"
-      - !ruby/object:Gem::Version
-        version: '0.12'
 - !ruby/object:Gem::Dependency
   name: tty-reader
   requirement: !ruby/object:Gem::Requirement
@@ -148,21 +86,21 @@ dependencies:
       - !ruby/object:Gem::Version
         version: '0.9'
 - !ruby/object:Gem::Dependency
-  name: tty-screen
+  name: unicode-display_width
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '0.8'
+        version: '2.6'
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '0.8'
+        version: '2.6'
 - !ruby/object:Gem::Dependency
-  name: unicode-display_width
+  name: zeitwerk
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
@@ -196,17 +134,18 @@ files:
 - lib/charming/controller.rb
 - lib/charming/controller/action_hooks.rb
 - lib/charming/controller/class_methods.rb
-- lib/charming/controller/command_palette.rb
-- lib/charming/controller/component_dispatching.rb
+- lib/charming/controller/component_dispatch.rb
 - lib/charming/controller/dispatching.rb
 - lib/charming/controller/focus.rb
 - lib/charming/controller/focus_management.rb
 - lib/charming/controller/key_dispatch.rb
 - lib/charming/controller/rendering.rb
 - lib/charming/controller/session_state.rb
-- lib/charming/controller/sidebar_navigation.rb
 - lib/charming/controller/terminal.rb
+- lib/charming/controller/timers.rb
+- lib/charming/cross_thread_access.rb
 - lib/charming/database/commands.rb
+- lib/charming/double_render_error.rb
 - lib/charming/escape.rb
 - lib/charming/events/focus_event.rb
 - lib/charming/events/key_event.rb
@@ -267,15 +206,22 @@ files:
 - lib/charming/image/source.rb
 - lib/charming/image/terminal.rb
 - lib/charming/image/transmit.rb
+- lib/charming/internal/deep_freeze.rb
+- lib/charming/internal/env_inquirer.rb
 - lib/charming/internal/event_loop.rb
+- lib/charming/internal/inflections.rb
 - lib/charming/internal/renderer/differential.rb
 - lib/charming/internal/renderer/full_repaint.rb
+- lib/charming/internal/session_guard.rb
 - lib/charming/internal/terminal/adapter.rb
+- lib/charming/internal/terminal/cursor.rb
 - lib/charming/internal/terminal/key_normalizer.rb
 - lib/charming/internal/terminal/memory_backend.rb
 - lib/charming/internal/terminal/modified_key_parser.rb
 - lib/charming/internal/terminal/mouse_parser.rb
+- lib/charming/internal/terminal/size.rb
 - lib/charming/internal/terminal/tty_backend.rb
+- lib/charming/internal/timer_control.rb
 - lib/charming/presentation/component.rb
 - lib/charming/presentation/components/activity_indicator.rb
 - lib/charming/presentation/components/audio.rb
@@ -307,6 +253,7 @@ files:
 - lib/charming/presentation/components/multi_select_list.rb
 - lib/charming/presentation/components/paginator.rb
 - lib/charming/presentation/components/progressbar.rb
+- lib/charming/presentation/components/result.rb
 - lib/charming/presentation/components/sparkline.rb
 - lib/charming/presentation/components/spinner.rb
 - lib/charming/presentation/components/status_bar.rb
@@ -366,16 +313,24 @@ files:
 - lib/charming/presentation/ui/truncate.rb
 - lib/charming/presentation/ui/width.rb
 - lib/charming/presentation/view.rb
+- lib/charming/projectile.rb
+- lib/charming/render_artifacts.rb
 - lib/charming/response.rb
 - lib/charming/router.rb
 - lib/charming/runtime.rb
 - lib/charming/screen.rb
+- lib/charming/shell/palette.rb
+- lib/charming/shell/sidebar.rb
+- lib/charming/spring.rb
 - lib/charming/tasks/cancelled.rb
+- lib/charming/tasks/context.rb
 - lib/charming/tasks/inline_executor.rb
 - lib/charming/tasks/progress.rb
 - lib/charming/tasks/task.rb
 - lib/charming/tasks/threaded_executor.rb
 - lib/charming/test_helper.rb
+- lib/charming/unhandled_component_event.rb
+- lib/charming/unknown_slot.rb
 - lib/charming/version.rb
 - lib/charming/welcome.rb
 - lib/charming/welcome/controller.rb

data/lib/charming/controller/component_dispatching.rb

@@ -1,125 +0,0 @@
-# frozen_string_literal: true
-
-module Charming
-  class Controller
-    # Component-dispatch helpers mixed into Controller. Forwards key events to the currently
-    # focused component (the slot returned by `focus.current`) and translates component return
-    # values into controller hook calls (e.g., `slot_submitted`, `slot_selected`, `slot_cancelled`).
-    module ComponentDispatching
-      private
-
-      # Sends the current key event to the focused component (if it responds to `handle_key`).
-      # Returns `:handled` after dispatching, or nil when no component is focused.
-      def dispatch_to_focused_component
-        slot = focus.current
-        return nil unless slot && respond_to?(slot, true)
-
-        component = send(slot)
-        return nil unless component.respond_to?(:handle_key)
-
-        result = component.handle_key(event)
-        return nil if result.nil?
-
-        dispatch_component_result(slot, result)
-        :handled
-      end
-
-      # Translates a component `handle_key` *result* into a controller hook call. `:cancelled`
-      # triggers `<slot>_cancelled`, `[:submitted, value]` triggers `<slot>_submitted(value)`,
-      # `[:selected, value]` triggers `<slot>_selected(value)`. Falls back to a default render
-      # when no matching hook exists.
-      def dispatch_component_result(slot, result)
-        action, arguments = component_result_action(slot, result)
-        action ? send(action, *arguments) : render_default_action
-        render_default_action unless response
-      end
-
-      # Resolves which controller hook (if any) corresponds to the *result* from a component.
-      def component_result_action(slot, result)
-        case result
-        when :cancelled
-          component_action(slot, :cancelled)
-        when Array
-          component_array_action(slot, result)
-        end
-      end
-
-      # Handles array-shaped component results, currently `[:submitted, value]` and `[:selected, value]`.
-      def component_array_action(slot, result)
-        event_name, value = result
-        return component_action(slot, :submitted, value) if event_name == :submitted
-        return component_action(slot, :selected, value) if event_name == :selected
-
-        nil
-      end
-
-      # Returns `[action, arguments]` for the `<slot>_<suffix>` controller hook if defined, or nil.
-      def component_action(slot, suffix, *arguments)
-        action = :"#{slot}_#{suffix}"
-        return unless respond_to?(action, true)
-
-        [action, arguments]
-      end
-
-      # Handles Tab/Shift+Tab by cycling through the focus ring. Returns :handled after rendering.
-      def dispatch_tab_traversal
-        return nil unless key_name == :tab
-        return nil if focus.ring.empty?
-
-        focus.cycle(event.shift ? -1 : +1)
-        render_default_action
-        :handled
-      end
-
-      # Hit-tests the current mouse event against named layout panes from the latest render.
-      # Clicks move focus to matching slots; components in clicked panes receive local coordinates.
-      def dispatch_component_mouse
-        target = mouse_target_for_event
-        return nil unless target
-
-        slot = target.fetch(:name)
-        previous_focus = focus.current
-        focus.focus(slot) if focusable_click?(slot)
-
-        result = dispatch_mouse_to_target_component(slot, target)
-        return response if result.nil? && previous_focus == focus.current
-
-        result ? dispatch_component_result(slot, result) : render_default_action
-        response
-      end
-
-      def mouse_target_for_event
-        mouse_targets.rfind { |target| target.fetch(:rect).cover?(event.x, event.y) }
-      end
-
-      def focusable_click?(slot)
-        event.respond_to?(:click?) && event.click? && focus.ring.include?(slot)
-      end
-
-      def dispatch_mouse_to_target_component(slot, target)
-        return nil unless respond_to?(slot, true)
-
-        component = send(slot)
-        return nil unless component.respond_to?(:handle_mouse)
-
-        local_event = local_mouse_event(target.fetch(:inner_rect))
-        return nil unless local_event
-
-        component.handle_mouse(local_event)
-      end
-
-      def local_mouse_event(rect)
-        return nil unless rect.cover?(event.x, event.y)
-
-        Events::MouseEvent.new(
-          button: event.button,
-          x: event.x - rect.x,
-          y: event.y - rect.y,
-          ctrl: event.ctrl,
-          alt: event.alt,
-          shift: event.shift
-        )
-      end
-    end
-  end
-end