charming 0.1.0 → 0.1.2

data/lib/charming/generators/app_generator/component_templates.rb

@@ -1,36 +0,0 @@
-# frozen_string_literal: true
-
-module Charming
-  module Generators
-    class AppGenerator
-      module ComponentTemplates
-        def component
-          %(# frozen_string_literal: true
-
-module #{name.class_name}
-  class AppFrameComponent < Charming::Component
-    def render
-      column(title_line, help_line, gap: 1)
-    end
-#{component_helpers}
-  end
-end
-)
-        end
-
-        def component_helpers
-          %(
-    private
-
-    def title_line
-      text title, style: theme.title
-    end
-
-    def help_line
-      text "Press p for commands, q to quit.", style: theme.muted
-    end)
-        end
-      end
-    end
-  end
-end

data/lib/charming/generators/app_generator/controller_template.rb

@@ -1,69 +0,0 @@
-# frozen_string_literal: true
-
-module Charming
-  module Generators
-    class AppGenerator
-      module ControllerTemplate
-        def application_controller
-          %(# frozen_string_literal: true
-
-module #{name.class_name}
-  class ApplicationController < Charming::Controller
-    layout Layouts::Application
-    focus_ring :sidebar, :content
-
-    key "p", :open_command_palette, scope: :global
-    key "q", :quit, scope: :global
-
-    command "Home" do
-      navigate_to "/"
-    end
-
-    command "Theme", :open_theme_palette
-    command "Close palette", :close_command_palette
-    command "Quit app", :quit
-  end
-end
-)
-        end
-
-        def controller
-          %(# frozen_string_literal: true
-
-module #{name.class_name}
-  class HomeController < ApplicationController
-#{controller_actions}
-#{controller_helpers}
-  end
-end
-)
-        end
-
-        def controller_actions
-          %(
-    def show
-      render_home
-    end)
-        end
-
-        def controller_helpers
-          %(
-
-    private
-#{render_helpers})
-        end
-
-        def render_helpers
-          %(
-    def render_home
-      render HomeView.new(home: home, palette: command_palette, screen: screen, theme: theme)
-    end
-
-    def home
-      model(:home, HomeModel)
-    end)
-        end
-      end
-    end
-  end
-end

data/lib/charming/generators/app_generator/layout_template.rb

@@ -1,160 +0,0 @@
-# frozen_string_literal: true
-
-module Charming
-  module Generators
-    class AppGenerator
-      module LayoutTemplate
-        def layout
-          %(# frozen_string_literal: true
-
-module #{name.class_name}
-  module Layouts
-    class Application < Charming::View
-      def render
-        body = Charming::UI.place(app_frame, width: screen.width, height: screen.height)
-        return body unless palette
-
-        Charming::UI.overlay(body, command_palette_modal)
-      end
-#{layout_helpers}
-    end
-  end
-end
-)
-        end
-
-        def layout_helpers
-          %(
-      private
-#{layout_frame_helpers}
-#{layout_navigation_helpers}
-#{layout_modal_helpers}
-#{layout_style_helpers})
-        end
-
-        def layout_frame_helpers
-          %(
-      def app_frame
-        narrow? ? column(sidebar, main_content, gap: 1) : row(sidebar, main_content, gap: 1)
-      end
-
-      def sidebar
-        box(column(app_title, navigation, shortcuts, gap: 1), style: sidebar_style)
-      end
-
-      def main_content
-        box(yield_content, style: main_content_style)
-      end)
-        end
-
-        def layout_navigation_helpers
-          %(
-
-      def app_title
-        text "#{name.class_name}", style: theme.header_accent.align(:center).width(sidebar_width)
-      end
-
-      def navigation
-        column(*nav_items)
-      end
-
-      def nav_items
-        controller.application.routes.all.each_with_index.map do |route, index|
-          text nav_label(route, index), style: nav_style(route, index)
-        end
-      end
-
-      def nav_label(route, index)
-        cursor = sidebar_focused? && index == sidebar_index ? ">" : " "
-        active = current_route?(route) ? "●" : " "
-        "\#{cursor} \#{active} \#{route.title}"
-      end
-
-      def nav_style(route, index)
-        return theme.selected if sidebar_focused? && index == sidebar_index
-        return theme.title if current_route?(route)
-
-        theme.muted
-      end
-
-      def shortcuts
-        text "tab focus\\np commands\\nq quit", style: theme.muted
-      end
-
-      def sidebar_focused?
-        controller.sidebar_focused?
-      end
-
-      def content_focused?
-        controller.content_focused?
-      end
-
-      def sidebar_index
-        controller.sidebar_index
-      end
-
-      def current_route?(route)
-        route.controller_class == controller.class && route.action == :show
-      end)
-        end
-
-        def layout_modal_helpers
-          %(
-
-      def command_palette_modal
-        render_component Charming::Components::Modal.new(
-          content: palette,
-          title: "Command palette",
-          help: "Type to filter. Enter selects. Escape closes.",
-          width: 52,
-          theme: theme
-        )
-      end)
-        end
-
-        def layout_style_helpers
-          %(
-#{layout_frame_style_helpers}
-#{layout_dimension_helpers})
-        end
-
-        def layout_frame_style_helpers
-          %(
-      def sidebar_style
-        base = sidebar_focused? ? theme.title : theme.border
-        base = base.border(:rounded).padding(1, 2).width(sidebar_width).height(panel_height)
-        palette ? base.faint : base
-      end
-
-      def main_content_style
-        base = content_focused? ? theme.title : theme.border
-        base = base.border(:rounded).padding(1, 2).width(main_content_width).height(panel_height)
-        palette ? base.faint : base
-      end)
-        end
-
-        def layout_dimension_helpers
-          %(
-
-      def narrow?
-        screen.width < 72 && screen.height >= 20
-      end
-
-      def sidebar_width
-        narrow? ? [screen.width - 6, 20].max : 22
-      end
-
-      def main_content_width
-        narrow? ? [screen.width - 6, 20].max : [screen.width - sidebar_width - 13, 20].max
-      end
-
-      def panel_height
-        return nil if narrow?
-
-        [screen.height - 4, 5].max
-      end)
-        end
-      end
-    end
-  end
-end

data/lib/charming/generators/app_generator/model_templates.rb

@@ -1,30 +0,0 @@
-# frozen_string_literal: true
-
-module Charming
-  module Generators
-    class AppGenerator
-      module ModelTemplates
-        def application_model
-          %(# frozen_string_literal: true
-
-module #{name.class_name}
-  class ApplicationModel < Charming::ApplicationModel
-  end
-end
-)
-        end
-
-        def home_model
-          %(# frozen_string_literal: true
-
-module #{name.class_name}
-  class HomeModel < ApplicationModel
-    attribute :title, :string, default: "#{name.class_name}"
-  end
-end
-)
-        end
-      end
-    end
-  end
-end

data/lib/charming/generators/app_generator/screen_spec_templates.rb

@@ -1,70 +0,0 @@
-# frozen_string_literal: true
-
-module Charming
-  module Generators
-    class AppGenerator
-      module ScreenSpecTemplates
-        def spec_model
-          %(# frozen_string_literal: true
-
-require "#{app_name.snake_name}"
-
-RSpec.describe #{app_name.class_name}::#{name.class_name}Model do
-  describe "#title" do
-    it "has the correct default string value" do
-      instance = described_class.new
-      expect(instance.title).to eq("#{name.class_name}")
-    end
-
-    it "accepts overridden title values" do
-      instance = described_class.new(title: "Alternative")
-      expect(instance.title).to eq("Alternative")
-    end
-  end
-end
-)
-        end
-
-        def spec_controller
-          %(# frozen_string_literal: true
-
-require "#{app_name.snake_name}"
-
-RSpec.describe #{app_name.class_name}::#{name.controller_class_name} do
-  let(:application) { #{app_name.class_name}::Application.new }
-
-  subject(:controller) { described_class.new(application: application) }
-
-  describe "#show" do
-    it "renders the view with the model" do
-      response = controller.dispatch(:show)
-
-      expect(response).to respond_to(:body)
-    end
-  end
-end
-)
-        end
-
-        def spec_view
-          %(# frozen_string_literal: true
-
-require "#{app_name.snake_name}"
-
-RSpec.describe #{app_name.class_name}::#{name.view_class_name} do
-  describe "#render" do
-    it "renders the model title" do
-      view = described_class.new(
-        #{name.snake_name}: double(title: "#{name.class_name}")
-       )
-
-      expect(view.render).to eq("#{name.class_name}")
-    end
-  end
-end
-)
-        end
-      end
-    end
-  end
-end

data/lib/charming/generators/app_generator/view_template.rb

@@ -1,90 +0,0 @@
-# frozen_string_literal: true
-
-module Charming
-  module Generators
-    class AppGenerator
-      module ViewTemplate
-        def executable
-          %(#!/usr/bin/env ruby
-# frozen_string_literal: true
-
-require "bundler/setup"
-require "#{name.snake_name}"
-
-Charming.run(#{name.class_name}::Application.new)
-)
-        end
-
-        def root_file
-          %(# frozen_string_literal: true
-
-require "charming"
-require "zeitwerk"
-
-module #{name.class_name}
-end
-
-loader = Zeitwerk::Loader.new
-loader.tag = "#{name.snake_name}"
-loader.inflector.inflect("version" => "VERSION")
-loader.push_dir(File.expand_path("#{name.snake_name}", __dir__), namespace: #{name.class_name})
-loader.push_dir(File.expand_path("../app/models", __dir__), namespace: #{name.class_name})
-loader.push_dir(File.expand_path("../app/components", __dir__), namespace: #{name.class_name})
-loader.push_dir(File.expand_path("../app/views", __dir__), namespace: #{name.class_name})
-loader.push_dir(File.expand_path("../app/controllers", __dir__), namespace: #{name.class_name})
-loader.setup
-
-require_relative "../config/routes"
-)
-        end
-
-        def application
-          %(# frozen_string_literal: true
-
-module #{name.class_name}
-  class Application < Charming::Application
-    Charming::UI::Theme.built_in_names.each do |theme_name|
-      theme theme_name.to_sym, built_in: theme_name
-    end
-
-    default_theme :phosphor
-  end
-end
-)
-        end
-
-        def version
-          %(# frozen_string_literal: true
-
-module #{name.class_name}
-  VERSION = "0.1.0"
-end
-)
-        end
-
-        def view
-          %(# frozen_string_literal: true
-
-module #{name.class_name}
-  class HomeView < Charming::View
-    def render
-      app_frame
-    end
-#{view_helpers}
-  end
-end
-)
-        end
-
-        def view_helpers
-          %(
-    private
-
-    def app_frame
-      render_component AppFrameComponent.new(title: home.title, theme: theme)
-    end)
-        end
-      end
-    end
-  end
-end

data/lib/charming/key_event.rb

@@ -1,13 +0,0 @@
-# frozen_string_literal: true
-
-module Charming
-  # KeyEvent represents a terminal key press parsed by the backend. *key* is the normalized semantic
-  # action name (e.g., `:up`, `:down`, `:q`), while *char*, *ctrl*, *alt*, and *shift* capture raw
-  # input details for custom bindings.
-  KeyEvent = Data.define(:key, :char, :ctrl, :alt, :shift) do
-    # Constructs a key event with the required *key* symbol, plus optional *char* string and modifier booleans.
-    def initialize(key:, char: nil, ctrl: false, alt: false, shift: false)
-      super(key: key.to_sym, char: char, ctrl: ctrl, alt: alt, shift: shift)
-    end
-  end
-end

data/lib/charming/mouse_event.rb

@@ -1,40 +0,0 @@
-# frozen_string_literal: true
-
-module Charming
-  # MOUSE_BUTTON_MAP encodes terminal mouse button codes to semantic symbols. The constant is frozen and private.
-  MOUSE_BUTTON_MAP = {
-    0 => :left, 1 => :middle, 2 => :right, 3 => :release,
-    64 => :scroll_up, 65 => :scroll_down,
-    66 => :scroll_up, 67 => :scroll_down
-  }.freeze
-  private_constant :MOUSE_BUTTON_MAP
-
-  # MouseEvent represents a mouse input event. *button* encodes which button or action was triggered (left,
-  # right, scroll), while *x* and *y* provide the cursor position. Modifier booleans (*ctrl*, *alt*, *shift*)
-  # capture key state at the time of the event.
-  MouseEvent = Data.define(:button, :x, :y, :ctrl, :alt, :shift) do
-    def initialize(button:, x:, y:, ctrl: false, alt: false, shift: false)
-      super
-    end
-
-    # Returns the semantic symbol for *button* — one of `left`, `right`, `scroll_up`, etc. or `:unknown`.
-    def button_name
-      MOUSE_BUTTON_MAP.fetch(button, :unknown)
-    end
-
-    # Returns `true` when the current event is a click (left, middle, or right button).
-    def click?
-      %i[left middle right].include?(button_name)
-    end
-
-    # Returns `true` when the button name maps to either direction of scroll.
-    def scroll?
-      %i[scroll_up scroll_down].include?(button_name)
-    end
-
-    # Returns `true` when the current event is a mouse release action.
-    def release?
-      button_name == :release
-    end
-  end
-end

data/lib/charming/resize_event.rb

@@ -1,7 +0,0 @@
-# frozen_string_literal: true
-
-module Charming
-  # ResizeEvent represents a terminal window resize. *width* and *height* carry the new terminal dimensions
-  # in screen cells, replacing the previous Screen dimensions for all subsequent rendering.
-  ResizeEvent = Data.define(:width, :height)
-end

data/lib/charming/task.rb

@@ -1,7 +0,0 @@
-# frozen_string_literal: true
-
-module Charming
-  Task = Data.define(:name, :block) do
-    def call = block.call
-  end
-end

data/lib/charming/task_event.rb

@@ -1,17 +0,0 @@
-# frozen_string_literal: true
-
-module Charming
-  # TaskEvent represents background task completion. *name* is the declared task identifier, *value* carries
-  # the return result and *error* captures any exception raised during execution. The `error?` predicate
-  # simplifies error handling in controller handlers.
-  TaskEvent = Data.define(:name, :value, :error) do
-    def initialize(name:, value: nil, error: nil)
-      super
-    end
-
-    # Returns `true` when the task finished with a non-nil exception.
-    def error?
-      !error.nil?
-    end
-  end
-end

data/lib/charming/task_executor.rb

@@ -1,62 +0,0 @@
-# frozen_string_literal: true
-
-module Charming
-  module TaskExecutor
-    class Threaded
-      def initialize(queue)
-        @queue = queue
-        @threads = []
-        @mutex = Mutex.new
-      end
-
-      def submit(name, &block)
-        task = Task.new(name: name.to_sym, block: block)
-        thread = Thread.new(task) { |t| @queue << run(t) }
-        @mutex.synchronize { @threads << thread }
-        nil
-      end
-
-      def shutdown(timeout: 0.0)
-        threads = @mutex.synchronize { @threads.dup }
-        threads.each { |thread| thread.join(timeout) }
-        threads.each do |thread|
-          next unless thread.alive?
-
-          thread.kill
-          thread.join(0)
-        end
-      end
-
-      private
-
-      def run(task)
-        TaskEvent.new(name: task.name, value: task.call)
-      rescue StandardError, ScriptError => e
-        TaskEvent.new(name: task.name, error: e)
-      end
-    end
-
-    class Inline
-      def initialize(queue)
-        @queue = queue
-      end
-
-      def submit(name, &block)
-        task = Task.new(name: name.to_sym, block: block)
-        @queue << run(task)
-        nil
-      end
-
-      def shutdown(timeout: 0.0)
-      end
-
-      private
-
-      def run(task)
-        TaskEvent.new(name: task.name, value: task.call)
-      rescue StandardError, ScriptError => e
-        TaskEvent.new(name: task.name, error: e)
-      end
-    end
-  end
-end

data/lib/charming/timer_event.rb

@@ -1,7 +0,0 @@
-# frozen_string_literal: true
-
-module Charming
-  # TimerEvent represents a timed dispatch from the runtime loop. *name* is the declared timer identifier;
-  # *now* is the monotonically rising clock value at emission for throttle comparisons.
-  TimerEvent = Data.define(:name, :now)
-end

data/lib/charming/ui/border.rb

@@ -1,33 +0,0 @@
-# frozen_string_literal: true
-
-module Charming
-  module UI
-    class Border
-      attr_reader :top_left, :top_right, :bottom_left, :bottom_right, :horizontal, :vertical
-
-      def initialize(corners:, edges:)
-        @top_left, @top_right, @bottom_left, @bottom_right = corners
-        @horizontal, @vertical = edges
-      end
-
-      def self.fetch(name)
-        STYLES.fetch(name.to_sym)
-      end
-    end
-
-    Border::STYLES = {
-      normal: Border.new(
-        corners: ["+", "+", "+", "+"], edges: ["-", "|"]
-      ),
-      rounded: Border.new(
-        corners: ["╭", "╮", "╰", "╯"], edges: ["─", "│"]
-      ),
-      thick: Border.new(
-        corners: ["┏", "┓", "┗", "┛"], edges: ["━", "┃"]
-      ),
-      double: Border.new(
-        corners: ["╔", "╗", "╚", "╝"], edges: ["═", "║"]
-      )
-    }.freeze
-  end
-end