clack 0.1.0 → 0.1.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 82be7312cfdade424ca896c9ddb5c70e2bfadadc5f61c411a073d01d1daa73c5
-  data.tar.gz: 2322b602de289654d8ba79925b804027b49a2027eb1e76fe8708d315527706a6
+  metadata.gz: a9749ca99273a0ed19da8274041da1b04f7355f523761169b509e3234737be7b
+  data.tar.gz: 8a097667af010ba054486e6a22407fefdb021752a9ce018ac2a0489f060f4140
 SHA512:
-  metadata.gz: 2412c28b3f625313df7249154a2a7a72cd039e336f3ee2764130e7dc52a5f932358a1576bc793d8fa33b5862d60cf5dff319a5b6495546bd59cef24714c93b1f
-  data.tar.gz: dc26d51d23d264c510c913383e448b3b8552312d1a1a78db7cba71e69ace120cc8638f69adc615fb844652065520947286a46cf75657a6a8ecdbcb499ee58bfc
+  metadata.gz: 6aa1f190f08a4fc285e682f6838518951ddc25647eaf034e06bdf7d1b1d06b15b0cc7cb2de3bd4c5ead11adcaea00b7cd8e2c6e8d03f28287b084f187766dd28
+  data.tar.gz: f6b11ea693a6ba6440a907c01b25a33ade736d074eaed61095998b873385466ee1c086ad2bb78546287e2e038a56a4cab23f509c678e3c9ecb752bca6c540907

data/CHANGELOG.md

@@ -2,16 +2,17 @@
 
 ## [Unreleased]
 
-### Added
-- Full prompt library: text, password, confirm, select, multiselect, autocomplete, path, select_key, spinner, progress, tasks, group_multiselect
-- `Clack.group` for chaining prompts with shared results
-- `Clack.stream` for streaming output from commands and iterables
-- Vim-style navigation (`hjkl`) alongside arrow keys
-- Zero runtime dependencies
+## [0.1.1]
+
+### Fixed
+- Path prompt now correctly rejects paths outside root (fixed boundary check bug)
+- Password backspace properly removes Unicode grapheme clusters, not just bytes
+- Terminal cleanup handles closed output streams gracefully
+- SIGWINCH handler uses explicit signal check instead of rescue
 
-### Changed
-- Ruby 3.2+ support
+### Added
+- Terminal resize support via SIGWINCH signal handling
 
 ## [0.1.0]
 
-Initial release.
+Initial release with full prompt library.

data/LICENSE

@@ -1,6 +1,6 @@
 MIT License
 
-Copyright (c) 2024 Steve Whittaker
+Copyright (c) 2026 Steve Whittaker
 
 This project is a Ruby port of Clack (https://github.com/bombshell-dev/clack)
 Originally created by Nate Moore and contributors, licensed under MIT.

data/README.md

@@ -10,7 +10,6 @@ A faithful Ruby port of [@clack/prompts](https://github.com/bombshell-dev/clack)
 
 ## Why Clack?
 
-- **Zero dependencies** - Pure Ruby, stdlib only
 - **Beautiful by default** - Thoughtfully designed prompts that just look right
 - **Vim-friendly** - Navigate with `hjkl` or arrow keys
 - **Accessible** - Graceful ASCII fallbacks for limited terminals

data/lib/clack/core/prompt.rb

@@ -27,6 +27,36 @@ module Clack
     #   end
     #
     class Prompt
+      # Track active prompts for SIGWINCH notification.
+      # Signal handler may fire during register/unregister. We can't use
+      # .dup (allocates, forbidden in trap context) so we accept a benign
+      # race: worst case, a prompt misses one resize notification.
+      @active_prompts = []
+
+      class << self
+        attr_reader :active_prompts
+
+        # Register a prompt instance for resize notifications
+        def register(prompt)
+          @active_prompts << prompt
+        end
+
+        def unregister(prompt)
+          @active_prompts.delete(prompt)
+        end
+
+        # Set up SIGWINCH handler (called once on load).
+        # Signal handlers must avoid mutex/complex operations.
+        def setup_signal_handler
+          return if Clack::Environment.windows?
+          return unless Signal.list.key?("WINCH")
+
+          Signal.trap("WINCH") do
+            @active_prompts.each(&:request_redraw)
+          end
+        end
+      end
+
       # @return [Symbol] current state (:initial, :active, :error, :submit, :cancel)
       attr_reader :state
       # @return [Object] the current/final value
@@ -48,6 +78,13 @@ module Clack
         @error_message = nil
         @prev_frame = nil
         @cursor = 0
+        @needs_redraw = false
+      end
+
+      # Request a full redraw on next render cycle.
+      # Called by SIGWINCH handler when terminal is resized.
+      def request_redraw
+        @needs_redraw = true
       end
 
       # Run the prompt interaction loop.
@@ -57,6 +94,7 @@ module Clack
       #
       # @return [Object, Clack::CANCEL] the submitted value or CANCEL sentinel
       def run
+        Prompt.register(self)
         setup_terminal
         render
         @state = :active
@@ -72,6 +110,7 @@ module Clack
         finalize
         (terminal_state? && @state == :cancel) ? CANCEL : @value
       ensure
+        Prompt.unregister(self)
         cleanup_terminal
       end
 
@@ -121,9 +160,16 @@ module Clack
       end
 
       # Render the current frame using differential rendering.
-      # Only redraws if the frame content has changed.
+      # Only redraws if the frame content has changed or redraw was requested.
       def render
         frame = build_frame
+
+        # Force redraw if terminal was resized
+        if @needs_redraw
+          @needs_redraw = false
+          @prev_frame = nil
+        end
+
         return if frame == @prev_frame
 
         if @state == :initial
@@ -176,6 +222,8 @@ module Clack
 
       def cleanup_terminal
         @output.print Cursor.show
+      rescue IOError, SystemCallError
+        # Output unavailable - terminal may need manual reset
       end
 
       def restore_cursor

data/lib/clack/prompts/password.rb

@@ -30,7 +30,8 @@ module Clack
         return unless Core::Settings.printable?(key)
 
         if Core::Settings.backspace?(key)
-          @value = @value.chop
+          clusters = @value.grapheme_clusters
+          @value = (clusters.length > 0) ? clusters[0..-2].join : ""
         else
           @value += key
         end
@@ -53,7 +54,7 @@ module Clack
         lines << "#{bar}\n"
         lines << "#{symbol_for_state}  #{@message}\n"
 
-        masked = @mask * @value.length
+        masked = @mask * @value.grapheme_clusters.length
         display = (@state == :cancel) ? Colors.strikethrough(Colors.dim(masked)) : Colors.dim(masked)
         lines << "#{bar}  #{display}\n"
 
@@ -63,7 +64,7 @@ module Clack
       private
 
       def masked_display
-        masked = @mask * @value.length
+        masked = @mask * @value.grapheme_clusters.length
         return cursor_block if masked.empty?
 
         "#{masked}#{cursor_block}"

data/lib/clack/prompts/path.rb

@@ -92,6 +92,12 @@ module Clack
       def submit_selection
         path = @value.empty? ? @root : resolve_path(@value)
 
+        unless path_within_root?(path)
+          @error_message = "Path must be within #{@root}"
+          @state = :error
+          return
+        end
+
         if @validate
           result = @validate.call(path)
           if result
@@ -138,6 +144,13 @@ module Clack
 
       def update_suggestions
         base_path = resolve_path(@value)
+
+        # Only show suggestions for paths within root
+        unless path_within_root?(base_path)
+          @suggestions = []
+          return
+        end
+
         search_dir = File.directory?(base_path) ? base_path : File.dirname(base_path)
         prefix = File.directory?(base_path) ? "" : File.basename(base_path).downcase
 
@@ -157,10 +170,10 @@ module Clack
 
       def format_entry(dir, entry)
         full_path = File.join(dir, entry)
-        if full_path.start_with?(@root)
+        if full_path == @root || full_path.start_with?("#{@root}/")
           # Show relative path without leading ./
           path = full_path[@root.length..]
-          path = path.sub(%r{^/}, "") # Remove leading slash
+          path = path.sub(%r{^/}, "")
           path = entry if path.empty?
         else
           path = full_path
@@ -172,13 +185,21 @@ module Clack
       def resolve_path(input)
         return @root if input.empty?
 
-        if input.start_with?("/")
+        path = if input.start_with?("/")
           input
         elsif input.start_with?("~")
           File.expand_path(input)
         else
           File.join(@root, input)
         end
+
+        # Canonicalize to resolve .. and symlinks
+        File.expand_path(path)
+      end
+
+      def path_within_root?(path)
+        expanded = File.expand_path(path)
+        expanded == @root || expanded.start_with?("#{@root}/")
       end
 
       def visible_suggestions

data/lib/clack/prompts/progress.rb

@@ -35,7 +35,6 @@ module Clack
         @message = message
         @output = output
         @started = false
-        @rendered_once = false
         @width = 40
       end
 
@@ -106,17 +105,13 @@ module Clack
       def render
         return unless @started
 
-        # Move cursor up and clear line if not first render
-        if @rendered_once
-          @output.print "\e[1A\e[2K"
-        end
-        @rendered_once = true
-        @output.puts "#{symbol}  #{progress_bar} #{percentage}#{message_text}"
+        @output.print "\r\e[2K"  # Return to start of line and clear it
+        @output.print "#{symbol}  #{progress_bar} #{percentage}#{message_text}"
+        @output.flush
       end
 
       def render_final(state)
-        # Move up and clear the progress line
-        @output.print "\e[1A\e[2K" if @rendered_once
+        @output.print "\r\e[2K"  # Clear the progress line
         sym = (state == :success) ? Colors.green(Symbols::S_STEP_SUBMIT) : Colors.red(Symbols::S_STEP_CANCEL)
         @output.puts "#{sym}  #{@message}"
       end

data/lib/clack/version.rb

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

data/lib/clack.rb

@@ -574,3 +574,6 @@ previous_int_handler = trap("INT") do
   else exit(130)
   end
 end
+
+# Set up SIGWINCH handler for terminal resize
+Clack::Core::Prompt.setup_signal_handler

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: clack
 version: !ruby/object:Gem::Version
-  version: 0.1.0
+  version: 0.1.1
 platform: ruby
 authors:
 - Steve Whittaker