charming 0.1.0 → 0.1.1

data/lib/charming/presentation/view.rb

@@ -0,0 +1,118 @@
+# frozen_string_literal: true
+
+module Charming
+  module Presentation
+    # View is the base class for all screen view implementations. It provides assign injection (via `initialize`),
+    # rendering hooks, layout composition helpers (`row`, `column`, `render_component`, `yield_content`),
+    # and access to controller theme, style, and focus state from within views.
+    class View
+      # Initializes the view with named assigns injected as instance-local accessor methods via
+      # `define_singleton_method`. Called when a controller instantiates a view for rendering.
+      def initialize(**assigns)
+        @assigns = assigns
+        define_assign_readers
+      end
+
+      # Returns all view assigns as a hash, used by layouts to compose the full template (content + screen + controller).
+      def layout_assigns
+        assigns
+      end
+
+      # Renders the view's body. Default is empty — subclasses override to return visible text.
+      def render
+        ""
+      end
+
+      # Delegates focus checking to the controller in assigns, allowing views to determine which slot (sidebar, content) has focus.
+      def focused?(slot)
+        ctrl = assigns[:focus_controller] || assigns[:controller]
+        ctrl ? ctrl.focused?(slot) : false
+      end
+
+      private
+
+      attr_reader :assigns
+
+      # Returns the shared UI style configuration used by components and views for visual rendering (colors, borders).
+      def style
+        UI.style
+      end
+
+      # Returns the active theme: uses `theme` from assigns or controller, falling back to `UI::Theme.default`.
+      def theme
+        assigns[:theme] || assigns[:controller]&.theme || UI::Theme.default
+      end
+
+      # Outputs styled text through the view's rendering pipeline. Accepts a named `style:` for inline formatting.
+      # Appends the rendered value to the output buffer and returns it.
+      def text(value, style: nil)
+        rendered = apply_style(value.to_s, style)
+        append_to_buffer(rendered)
+        rendered
+      end
+
+      # Renders a box with optional styling. Accepts an inline block for complex content or a plain value.
+      # Used for bordered containers and field groups in views.
+      def box(value = nil, style: nil, &)
+        content = block_given? ? capture(&) : value.to_s
+        apply_style(content, style)
+      end
+
+      # Joins items horizontally (side-by-side) using the UI rendering engine. Supports a `gap:` parameter.
+      def row(*items, gap: 0)
+        UI.join_horizontal(*items, gap: gap)
+      end
+
+      # Stacks items vertically using the UI rendering engine. Supports a `gap:` parameter for spacing.
+      def column(*items, gap: 0)
+        UI.join_vertical(*items, gap: gap)
+      end
+
+      # Renders a component (e.g., a ProgressBar, Spinner, Modal) and returns its string output.
+      def render_component(component)
+        component.render.to_s
+      end
+
+      # Renders a partial view component. An alias for `render_component` used in layout templates.
+      def render_partial(partial)
+        render_component(partial)
+      end
+
+      # Yields the layout's `content` slot — used by view templates to inject their body into a layout wrapper (e.g., sidebar).
+      def yield_content
+        assigns.fetch(:content, "")
+      end
+
+      # Evaluates a block in the view's context with a clean output buffer. Captures text written via `text`/`box`
+      # and returns joined content. Resets buffer afterward for parent rendering.
+      def capture(&)
+        previous_buffer = @output_buffer
+        @output_buffer = []
+        result = instance_eval(&)
+        @output_buffer.empty? ? result.to_s : @output_buffer.join("\n")
+      ensure
+        @output_buffer = previous_buffer
+      end
+
+      # Appends a value to the current output buffer (if one is active). Used by rendering helpers.
+      def append_to_buffer(value)
+        @output_buffer << value if @output_buffer
+      end
+
+      # Applies a style object's `render` method to a string, returning styled output or raw text when style is nil.
+      def apply_style(value, style_object)
+        style_object ? style_object.render(value) : value
+      end
+
+      # Dynamically defines read-only accessor methods for each assign key as singleton methods on self.
+      # Skips keys where the view already responds (controller methods take precedence).
+      def define_assign_readers
+        assigns.each_key do |name|
+          next if respond_to?(name, true)
+
+          define_singleton_method(name) { assigns.fetch(name) }
+        end
+      end
+    end
+  end
+end

data/lib/charming/runtime.rb

@@ -76,16 +76,16 @@ module Charming
     end
 
     def controller(event: nil)
-      @route.controller_class.new(application: @application, event: event, params: @route.params, screen: screen)
+      @route.controller_class.new(application: @application, event: event, params: @route.params, screen: screen, route: @route)
     end
 
     # Type-based dispatcher: routes resize, task, timer, mouse, and key events
     # to the appropriate handler. Falls back to key dispatch for unclassified events.
     def dispatch_event(event)
-      return dispatch_resize(event) if event.is_a?(ResizeEvent)
-      return dispatch_task(event) if event.is_a?(TaskEvent)
-      return dispatch_timer(event) if event.is_a?(TimerEvent)
-      return dispatch_mouse(event) if event.is_a?(MouseEvent)
+      return dispatch_resize(event) if event.is_a?(Events::ResizeEvent)
+      return dispatch_task(event) if event.is_a?(Events::TaskEvent)
+      return dispatch_timer(event) if event.is_a?(Events::TimerEvent)
+      return dispatch_mouse(event) if event.is_a?(Events::MouseEvent)
 
       dispatch_key(event)
     end
@@ -133,7 +133,7 @@ module Charming
 
       now = clock_now
       timer[:next_at] = now + timer.fetch(:binding).interval
-      TimerEvent.new(name: timer.fetch(:binding).name, now: now)
+      Events::TimerEvent.new(name: timer.fetch(:binding).name, now: now)
     end
 
     # Pops a task event from the thread-safe queue if one is available.
@@ -161,7 +161,7 @@ module Charming
 
     # Constructs a task executor: supports explicit instances, callable factories, or the default Threaded executor.
     def build_task_executor(task_executor)
-      return TaskExecutor::Threaded.new(@task_queue) unless task_executor
+      return Tasks::ThreadedExecutor.new(@task_queue) unless task_executor
       return task_executor if task_executor.respond_to?(:submit)
       return task_executor.call(@task_queue) if task_executor.respond_to?(:call) && !task_executor.respond_to?(:new)
 

data/lib/charming/screen.rb

@@ -4,5 +4,9 @@ module Charming
   # Screen represents the terminal viewport dimensions as a simple Data class.
   # The `width` and `height` values flow from the backend through the runtime
   # loop into every controller dispatch for layout calculations.
-  Screen = Data.define(:width, :height)
+  Screen = Data.define(:width, :height) do
+    def narrow?(below:, min_height: nil)
+      width < below && (min_height.nil? || height >= min_height)
+    end
+  end
 end

data/lib/charming/tasks/inline_executor.rb

@@ -0,0 +1,28 @@
+# frozen_string_literal: true
+
+module Charming
+  module Tasks
+    class InlineExecutor
+      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)
+        Events::TaskEvent.new(name: task.name, value: task.call)
+      rescue StandardError, ScriptError => e
+        Events::TaskEvent.new(name: task.name, error: e)
+      end
+    end
+  end
+end

data/lib/charming/tasks/task.rb

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

data/lib/charming/{task_executor.rb → tasks/threaded_executor.rb}

@@ -1,8 +1,8 @@
 # frozen_string_literal: true
 
 module Charming
-  module TaskExecutor
-    class Threaded
+  module Tasks
+    class ThreadedExecutor
       def initialize(queue)
         @queue = queue
         @threads = []
@@ -30,32 +30,9 @@ module Charming
       private
 
       def run(task)
-        TaskEvent.new(name: task.name, value: task.call)
+        Events::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)
+        Events::TaskEvent.new(name: task.name, error: e)
       end
     end
   end

data/lib/charming/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Charming
-  VERSION = "0.1.0"
+  VERSION = "0.1.1"
 end

data/lib/charming.rb

@@ -6,6 +6,7 @@ loader = Zeitwerk::Loader.for_gem
 loader.inflector.inflect(
   "cli" => "CLI",
   "ui" => "UI",
+  "erb_handler" => "ErbHandler",
   "tty_backend" => "TTYBackend"
 )
 loader.setup
@@ -22,3 +23,6 @@ module Charming
     key.to_sym
   end
 end
+
+Charming::Presentation::Templates.register ".tui.erb", Charming::Presentation::Templates::ErbHandler
+Charming::Presentation::Templates.register ".txt.erb", Charming::Presentation::Templates::ErbHandler

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: charming
 version: !ruby/object:Gem::Version
-  version: 0.1.0
+  version: 0.1.1
 platform: ruby
 authors:
 - pando
@@ -29,6 +29,68 @@ dependencies:
     - - ">="
       - !ruby/object:Gem::Version
         version: 8.1.2
+- !ruby/object:Gem::Dependency
+  name: activerecord
+  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: kramdown
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.5'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.5'
+- !ruby/object:Gem::Dependency
+  name: rouge
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '5.0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '5.0'
+- !ruby/object:Gem::Dependency
+  name: sqlite3
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.0'
 - !ruby/object:Gem::Dependency
   name: tty-cursor
   requirement: !ruby/object:Gem::Requirement
@@ -141,35 +203,33 @@ files:
 - exe/charming
 - lib/charming.rb
 - lib/charming/application.rb
-- lib/charming/application_model.rb
+- lib/charming/application_state.rb
 - lib/charming/cli.rb
-- lib/charming/component.rb
-- lib/charming/components/activity_indicator.rb
-- lib/charming/components/command_palette.rb
-- lib/charming/components/keyboard_handler.rb
-- lib/charming/components/list.rb
-- lib/charming/components/modal.rb
-- lib/charming/components/progressbar.rb
-- lib/charming/components/spinner.rb
-- lib/charming/components/table.rb
-- lib/charming/components/text_input.rb
-- lib/charming/components/viewport.rb
 - lib/charming/controller.rb
+- lib/charming/database_commands.rb
+- lib/charming/database_installer.rb
+- lib/charming/events/key_event.rb
+- lib/charming/events/mouse_event.rb
+- lib/charming/events/resize_event.rb
+- lib/charming/events/task_event.rb
+- lib/charming/events/timer_event.rb
 - lib/charming/focus.rb
-- lib/charming/generators.rb
 - lib/charming/generators/app_file_generator.rb
 - lib/charming/generators/app_generator.rb
 - lib/charming/generators/app_generator/app_spec_templates.rb
 - lib/charming/generators/app_generator/basic_templates.rb
 - lib/charming/generators/app_generator/component_templates.rb
 - lib/charming/generators/app_generator/controller_template.rb
+- lib/charming/generators/app_generator/database_templates.rb
 - lib/charming/generators/app_generator/layout_template.rb
-- lib/charming/generators/app_generator/model_templates.rb
 - lib/charming/generators/app_generator/screen_spec_templates.rb
+- lib/charming/generators/app_generator/state_templates.rb
 - lib/charming/generators/app_generator/view_template.rb
 - lib/charming/generators/base.rb
 - lib/charming/generators/component_generator.rb
 - lib/charming/generators/controller_generator.rb
+- lib/charming/generators/error.rb
+- lib/charming/generators/model_generator.rb
 - lib/charming/generators/name.rb
 - lib/charming/generators/screen_generator.rb
 - lib/charming/generators/view_generator.rb
@@ -178,25 +238,50 @@ files:
 - lib/charming/internal/terminal/adapter.rb
 - lib/charming/internal/terminal/memory_backend.rb
 - lib/charming/internal/terminal/tty_backend.rb
-- lib/charming/key_event.rb
-- lib/charming/mouse_event.rb
-- lib/charming/resize_event.rb
+- lib/charming/presentation/component.rb
+- lib/charming/presentation/components/activity_indicator.rb
+- lib/charming/presentation/components/command_palette.rb
+- lib/charming/presentation/components/empty_state.rb
+- lib/charming/presentation/components/form.rb
+- lib/charming/presentation/components/form/builder.rb
+- lib/charming/presentation/components/form/confirm.rb
+- lib/charming/presentation/components/form/field.rb
+- lib/charming/presentation/components/form/input.rb
+- lib/charming/presentation/components/form/note.rb
+- lib/charming/presentation/components/form/select.rb
+- lib/charming/presentation/components/form/textarea.rb
+- lib/charming/presentation/components/keyboard_handler.rb
+- lib/charming/presentation/components/list.rb
+- lib/charming/presentation/components/markdown.rb
+- lib/charming/presentation/components/modal.rb
+- lib/charming/presentation/components/progressbar.rb
+- lib/charming/presentation/components/spinner.rb
+- lib/charming/presentation/components/table.rb
+- lib/charming/presentation/components/text_area.rb
+- lib/charming/presentation/components/text_input.rb
+- lib/charming/presentation/components/viewport.rb
+- lib/charming/presentation/layout.rb
+- lib/charming/presentation/markdown.rb
+- lib/charming/presentation/markdown/renderer.rb
+- lib/charming/presentation/markdown/syntax_highlighter.rb
+- lib/charming/presentation/template_view.rb
+- lib/charming/presentation/templates.rb
+- lib/charming/presentation/templates/erb_handler.rb
+- lib/charming/presentation/ui.rb
+- lib/charming/presentation/ui/border.rb
+- lib/charming/presentation/ui/style.rb
+- lib/charming/presentation/ui/theme.rb
+- lib/charming/presentation/ui/themes/phosphor.json
+- lib/charming/presentation/ui/width.rb
+- lib/charming/presentation/view.rb
 - lib/charming/response.rb
 - lib/charming/router.rb
 - lib/charming/runtime.rb
 - lib/charming/screen.rb
-- lib/charming/task.rb
-- lib/charming/task_event.rb
-- lib/charming/task_executor.rb
-- lib/charming/timer_event.rb
-- lib/charming/ui.rb
-- lib/charming/ui/border.rb
-- lib/charming/ui/style.rb
-- lib/charming/ui/theme.rb
-- lib/charming/ui/themes/phosphor.json
-- lib/charming/ui/width.rb
+- lib/charming/tasks/inline_executor.rb
+- lib/charming/tasks/task.rb
+- lib/charming/tasks/threaded_executor.rb
 - lib/charming/version.rb
-- lib/charming/view.rb
 - sig/charming.rbs
 homepage: https://github.com/pandorocks/charming
 licenses:

data/lib/charming/component.rb

@@ -1,8 +0,0 @@
-# frozen_string_literal: true
-
-module Charming
-  # Component is the base class for all reusable terminal widgets. It inherits from View to gain assigns,
-  # helper methods (text, box, row, column, etc.), and rendering via render.
-  class Component < View
-  end
-end

data/lib/charming/components/activity_indicator.rb

@@ -1,158 +0,0 @@
-# frozen_string_literal: true
-
-module Charming
-  module Components
-    # ActivityIndicator renders a color-gradient progress or loading indicator
-    # as styled text. It produces a fixed-width row of characters whose colors
-    # interpolate between two gradient endpoints (or cycle through a single
-    # color). A label can be appended after the bar and an ellipsis that cycles
-    # through frames, useful for "loading" state display. Call `tick` to advance
-    # the frame counter, and call `render` to produce the styled output string.
-    class ActivityIndicator < Component
-      # Default character pool used for generating each position's character via stable hashing.
-      DEFAULT_CHARS = "0123456789abcdefABCDEF~!@#$%^&*+=_".chars.freeze
-
-      # The default two-color gradient applied across the bar width (red to cyan).
-      # The cyan endpoint mirrors the Phosphor theme palette's "cyan" token so the bar
-      # remains legible on Phosphor's dark navy background; gradient: accepts raw hex,
-      # so callers using a different theme should pass their own endpoints.
-      DEFAULT_GRADIENT = ["#ff0000", "#6FD0E3"].freeze
-
-      # The default label color for ellipsis and text portions when no custom
-      # label_style is provided.
-      DEFAULT_LABEL_COLOR = "#cccccc"
-
-      # Ellipsis frame sequence: four states cycle through "., "..", "...", and "" (empty).
-      ELLIPSIS_FRAMES = [".", "..", "...", ""].freeze
-
-      # Number of frames in the animation cycle before the indicator pattern repeats.
-      FRAME_COUNT = 10
-
-      # FNV-1a variant constants used by stable_hash for reproducible character selection per position.
-      FNV_OFFSET = 2_166_136_261
-      FNV_PRIME = 16_777_619
-      FNV_MASK = 0xffffffff
-
-      attr_reader :width, :label, :index, :seed, :chars, :gradient, :label_style
-
-      # Initializes a new ActivityIndicator with configurable visual parameters.
-      # width       — Display width of the gradient bar in characters (minimum 1). Default: 10.
-      # label       — Optional text label shown adjacent to the indicator.
-      # index       — Initial frame index for the ellipsis/frame animations. Default: 0.
-      # seed        — Hash seed that determines which characters appear at each position.
-      # chars       — Character pool to draw from (default is DEFAULT_CHARS).
-      # gradient    — Two-element array of hex color strings ["#rrggbb", "#rrggbb"] for interpolation.
-      # label_style — A Style object to use for rendering the label text; falls back to a gray foreground.
-      def initialize(width: 10, label: nil, index: 0, seed: 0, chars: DEFAULT_CHARS,
-        gradient: DEFAULT_GRADIENT, label_style: nil)
-        super()
-        raise ArgumentError, "chars cannot be empty" if chars.empty?
-
-        @width = [width.to_i, 1].max
-        @label = label
-        @index = index.to_i
-        @seed = seed
-        @chars = chars.map(&:to_s)
-        @gradient = gradient
-        @label_style = label_style
-      end
-
-      # Advances the frame counter forward by +count+ steps, allowing the displayed pattern to change.
-      # Accepts an integer count (converted via +to_i+). Returns self for chaining.
-      def tick(count = 1)
-        @index += count.to_i
-        self
-      end
-
-      # Renders the activity indicator as a styled string. If a label was provided,
-      # produces "bar ellipsis" alongside it; otherwise produces only the gradient bar.
-      # Returns a formatted string suitable for terminal rendering.
-      def render
-        return indicator unless label
-
-        "#{indicator} #{styled_label}#{styled_ellipsis}"
-      end
-
-      private
-
-      # Renders the full gradient bar as an array of styled characters joined into a single string.
-      # Each character at +position+ is selected by hashing together seed, frame, and position —
-      # making the pattern stable across renders — then styled with the interpolated gradient color
-      # at that position.
-      def indicator
-        Array.new(width) { |position| styled_char(position) }.join
-      end
-
-      # Selects a character for the bar at the given +position+, styles it with the gradient color
-      # interpolated for that position, and returns the result as a formatted string via +render+.
-      def styled_char(position)
-        style.foreground(color_at(position)).render(char_at(position))
-      end
-
-      # Chooses a character from self.chars by hashing seed:frame:position together with a stable
-      # FNV-1a hash. The resulting index is modulated against the character pool length, ensuring
-      # reproducible output across renders.
-      def char_at(position)
-        chars.fetch(stable_hash("#{seed}:#{frame}:#{position}") % chars.length)
-      end
-
-      # Renders the label text in its own style (or fallback gray color) via a Style renderer call.
-      def styled_label
-        label_style_or_default.render(label.to_s)
-      end
-
-      # Renders an ellipsis frame (".", "..", "...", or empty) based on (index / 4) mod 4, styled with the label style.
-      def styled_ellipsis
-        label_style_or_default.render(ellipsis_frame)
-      end
-
-      # Returns the current ellipsis frame string: one of ".", "..", "...", "". Cycles through four frames per tick.
-      def ellipsis_frame
-        ELLIPSIS_FRAMES.fetch((index / 4) % ELLIPSIS_FRAMES.length)
-      end
-
-      # Returns the label style if set, otherwise produces a gray foreground style for fallback rendering.
-      def label_style_or_default
-        label_style || style.foreground(DEFAULT_LABEL_COLOR)
-      end
-
-      # Interpolates between gradient[0] and gradient[1] at the fractional +position+ (0.0 to 1.0).
-      # Returns the first gradient color if width is 1; otherwise returns a blended hex string based on position.
-      def color_at(position)
-        return gradient.first unless width > 1
-
-        blend(gradient.first, gradient.last, position / (width - 1).to_f)
-      end
-
-      # Blends two hex colors by interpolating their red/green/blue components at fractional +amount+.
-      # Accepts strings like "#ff0000" and produces a new "#rrggbb" string.
-      def blend(start_hex, end_hex, amount)
-        start_rgb = rgb(start_hex)
-        end_rgb = rgb(end_hex)
-        mixed = start_rgb.zip(end_rgb).map { |from, to| (from + ((to - from) * amount)).round }
-        "#%02x%02x%02x" % mixed
-      end
-
-      # Decomposes a hex color string ("#rrggbb") into an array of three integers [r, g, b].
-      def rgb(hex)
-        value = hex.to_s.delete_prefix("#")
-        raise ArgumentError, "gradient colors must be #rrggbb" unless value.match?(/\A[0-9a-fA-F]{6}\z/)
-
-        [value[0..1], value[2..3], value[4..5]].map { |part| part.to_i(16) }
-      end
-
-      # Advances the animation frame counter, wrapping around after +FRAME_COUNT+ (10) steps.
-      def frame
-        index % FRAME_COUNT
-      end
-
-      # Produces a deterministic integer hash from the input string using FNV-1a hashing, ensuring the same
-      # characters appear at the same positions across multiple renderings of this indicator.
-      def stable_hash(value)
-        value.bytes.reduce(FNV_OFFSET) do |hash, byte|
-          ((hash ^ byte) * FNV_PRIME) & FNV_MASK
-        end
-      end
-    end
-  end
-end