squared 0.5.25 → 0.6.0

data/README.md

@@ -1,4 +1,4 @@
-# squared 0.5
+# squared 0.6
 
 * [source](https://github.com/anpham6/squared-ruby)
 * [docs](https://squared.readthedocs.io)
@@ -14,6 +14,7 @@
 | 2025-06-16 |   0.5.0 |  2.5.0 |  3.4.3 |
 | ---------- |   ----- |  ----- |  ----- |
 | 2025-08-23 |   0.5.5 |        |  3.4.5 |
+| 2025-10-31 |   0.6.0 |        |  3.4.7 |
 
 The range chart indicates the latest Ruby tested against at the time of release.
 
@@ -23,9 +24,23 @@ The range chart indicates the latest Ruby tested against at the time of release.
 gem install squared
 ```
 
+### Optional
+
+* [Repo](https://source.android.com/docs/setup/reference/repo)
+* https://github.com/anpham6/squared-repo
+* Python 3.6
+* Not compatible with Windows
+
+```sh
+mkdir -p ~/.bin
+PATH="${HOME}/.bin:${PATH}"
+curl https://storage.googleapis.com/git-repo-downloads/repo > ~/.bin/repo
+chmod a+rx ~/.bin/repo
+```
+
 ## Example - Rakefile
 
-Projects from any accessible folder can be added relative to the parent directory or absolutely. Missing projects will simply be excluded from the task runner.
+Projects from any accessible folder can be added relative to the parent directory (e.g. *REPO_ROOT*) or absolutely. The same Rakefile can also manage other similarly cloned `Repo` repositories remotely by setting the `REPO_ROOT` environment variable to the location. Missing projects will simply be excluded from the task runner.
 
 ```ruby
 require "squared"
@@ -41,6 +56,14 @@ require "squared/app"                                # All workspace related mod
 
 # NODE_ENV  = production
 
+# REPO_ROOT = /workspaces                            |
+# REPO_HOME = /workspaces/squared                    | Dir.pwd
+# rake      = /workspaces/squared/Rakefile           | main?
+# OR
+# REPO_ROOT = /workspaces                            | Dir.pwd
+# rake      = /workspaces/Rakefile                   |
+# REPO_HOME = /workspaces/squared                    | main: "squared"
+
 # pathname  = /workspaces/pathname
 # optparse  = /workspaces/optparse
 # log       = /workspaces/logger
@@ -55,6 +78,7 @@ require "squared/app"                                # All workspace related mod
 Workspace::Application
   .new(Dir.pwd, main: "squared") # Dir.pwd? (main? is implicitly basename)
   .banner("group", "project", styles: ["yellow", "black"], border: "bold") # name | project | path | ref | group? | parent? | version?
+  .repo("https://github.com/anpham6/squared-repo", "nightly", script: ["build:dev", "build:prod"], ref: :node) # Repo (optional)
   .run("rake install", ref: :ruby)
   .depend(false, group: "default")
   .clean("rake clean", group: "default")
@@ -68,7 +92,7 @@ Workspace::Application
   .add("e-mc", "emc", copy: { from: "publish", scope: "@e-mc", also: [:pir, "squared-express/"] }, ref: :node) # Node
   .add("pi-r", "pir", copy: { from: "publish", scope: "@pi-r" }, clean: ["publish/**/*.js", "tmp/"]) # Trailing slash required for directories
   .add("pi-r2", "pir2", copy: { from: :npm, also: %i[squared express], files: ["LICENSE", ["README.md.ruby", "README.md"]] }) # Uses dist files from NPM package spec
-  .add("squared", init: "pnpm", script: ["build:stage1", "build:stage2"], group: "app") do # Use pnpm/yarn/berry for depend + Copy target (main)
+  .add("squared", init: 'pnpm', script: ["build:stage1", "build:stage2"], group: "app") do # Use pnpm/yarn/berry for depend + Copy target (main)
     # Repo (global)
     as(:run, "build:dev", "dev")                                             # npm run build:dev -> npm run dev
     as(:run, { "build:dev": "dev", "build:prod": "prod" })
@@ -119,20 +143,59 @@ Workspace::Application
 # android   = /workspaces/android-docs
 # chrome    = /workspaces/chrome-docs
 
+# ...symbol?, string, ...string?, ...symbol?
+#    extend     name       args     project
+
+Node = Workspace::Project::Node                                      # tsc
+Node.options("build:dev", "target=es2022", project: "tsconfig.json") # :node (ref)
+Node.options("build:dev", "outDir=tmp", :squared)                    # squared (project name)
+
+Ruby = Workspace::Project::Ruby                                      # ruby | gem | rake | bundle | irb
+Ruby.options("lint", "rubocop", opts: ["gemfile=Gemfile"])           # :ruby
+Ruby.options("lint", "--parallel", :squared)
+
+Python = Workspace::Project::Python                                   # pip
+Python.options("build", opts: ["r=requirements.txt"])                 # :python
+Python.options(:build, "build:dev", opts: ["no-deps"])
+
 Workspace::Application
-  .new(ENV["SQUARED_HOME"], prefix: "rb", common: false) # Local styles
+  .new(ENV["SQUARED_HOME"], prefix: "rb", common: false)             # Local styles
   .group("ruby", "default", run: "rake build", copy: "rake install", clean: "rake clean", ref: :ruby, override: {
     pathname: {
-      run: "rake compile"                                # rake rb:pathname:build
+      run: "rake compile"                                            # rake rb:pathname:build
     }
   })
-  .with(:python, editable: false) do                     # ref=Symbol | group=String
-    banner([:name, ": ", :version], "path")              # chrome-docs: 0.1.0 | /workspaces/chrome-docs
-    doc("make html")                                     # rake rb:doc:python
-    run(false)                                           # rake rb:build:python (disabled)
-    exclude(%i[base git])                                # Project::Git.ref (superclass)
-    add("android-docs", "android")                       # rake rb:android:doc
-    add("chrome-docs", "chrome")                         # rake rb:chrome:doc
+  .add("squared") do
+    apply :run, proc {                                               # rake rb:squared:build
+      tsc(with: scriptname || "build:dev", verbose: true)            # Repo (global)
+      # OR
+      tsc("target=es2022", "outDir=tmp", project: "tsconfig.json")   # 1
+      tsc("clean=true", "./sqd/tsconfig.json", build: true)          # 2
+      run("npm run build:dev", { "RUBYOPT" => "-W2" }, from: :run)   # 3
+
+      # Parallel
+      [
+        Thread.new { tsc(sync: false) },
+        Thread.new { tsc(sync: false) },
+        Thread.new { run(sync: false) }
+      ]
+      .each(&:join)
+    }
+    apply :lint, proc {
+      bundle("exec", "-A --cache=true", with: "lint", verbose: true) # bundle exec --gemfile='/squared/Gemfile' rubocop --parallel -A --cache=true
+    }
+  end
+  .with(:python, editable: false) do                                 # ref=Symbol | group=String
+    banner([:name, ": ", :version], "path")                          # chrome-docs: 0.1.0 | /workspaces/chrome-docs
+    doc("make html")                                                 # rake rb:doc:python
+    run(false)                                                       # rake rb:build:python (disabled)
+    exclude(%i[base git])                                            # Project::Git.ref (superclass)
+    add("android-docs", "android")                                   # rake rb:android:doc
+    add("chrome-docs", "chrome") do                                  # rake rb:chrome:doc
+      apply :run, proc {
+        pip("wheel", with: "build:dev")                              # pip wheel -r '/chrome-docs/requirements.txt' --no-deps
+      }
+    end
   end
   .style("inline", "bold")
   .build
@@ -473,28 +536,28 @@ Non-task:
 
 Most project classes will inherit from `Git` which enables these tasks:
 
-| Task       | Git              | Command                                       |
-| :--------- | :--------------- | :-------------------------------------------- |
-| branch     | branch           | create track delete move copy list current    |
-| checkout   | checkout         | commit branch track detach path               |
-| commit     | commit           | add all amend amend-orig fixup                |
-| diff       | diff             | head branch files view between contain        |
-| fetch      | fetch            | origin remote all                             |
-| files      | ls-files         | cached modified deleted others                |
-| git        |                  | add blame clean mv revert rm status           |
-| log        | log              | view between contain                          |
-| merge      | merge            | commit no-commit send                         |
-| pull       | pull             | origin remote all                             |
-| rebase     | rebase           | branch onto send                              |
-| refs       | ls-remote --refs | heads tags remote                             |
-| reset      | reset            | commit index patch mode undo                  |
-| restore    | restore          | source staged worktree                        |
-| rev        | rev              | commit build output                           |
-| show       | show             | format oneline textconv                       |
-| stash      | stash            | push pop apply branch drop clear list all     |
-| submodule  | submodule        | status update branch url sync                 |
-| switch     | switch           | branch create detach                          |
-| tag        | tag              | add sign delete list                          |
+| Task       | Git              | Command                                                   |
+| :--------- | :--------------- | :-------------------------------------------------------- |
+| branch     | branch           | create track delete move copy list current                |
+| checkout   | checkout         | commit branch track detach path                           |
+| commit     | commit           | add all amend amend-orig fixup                            |
+| diff       | diff             | head branch files view between contain                    |
+| fetch      | fetch            | origin remote all                                         |
+| files      | ls-files         | cached modified deleted others                            |
+| git        |                  | add blame clean grep mv revert rm status                  |
+| log        | log              | view between contain                                      |
+| merge      | merge            | commit no-commit send                                     |
+| pull       | pull             | origin remote all                                         |
+| rebase     | rebase           | branch onto send                                          |
+| refs       | ls-remote --refs | heads tags remote                                         |
+| reset      | reset            | commit index patch mode undo                              |
+| restore    | restore          | source staged worktree                                    |
+| rev        | rev              | commit build output                                       |
+| show       | show             | format oneline textconv                                   |
+| stash      | stash            | push pop apply branch drop clear list all staged worktree |
+| submodule  | submodule        | status update branch url sync                             |
+| switch     | switch           | branch create detach                                      |
+| tag        | tag              | add sign delete list                                      |
 
 You can disable all of them at once using the `exclude` property.
 
@@ -521,7 +584,7 @@ Commands which use commit hashes are parsed using a ":" prefix as to not be conf
 
 ```sh
 rake squared:log:view[:af012345]                   # git log af012345
-rake squared:log:view[H1,HEAD^5,all,lib,./H12345]  # git log --all @~1 @^5 -- "lib" "H12345"
+rake squared:log:view[H1,HEAD^5,all,lib,./H12345]  # git log --all @~1 @^5 -- 'lib' 'H12345'
 ```
 
 ## Environment
@@ -609,7 +672,7 @@ LOG_LEVEL                    # See gem "logger"
 
 ### Git
 
-* Version: [2.50](https://github.com/git/git/blob/v2.50.0/Documentation/RelNotes/2.50.0.adoc)
+* Version: [2.51](https://github.com/git/git/blob/v2.51.0/Documentation/RelNotes/2.51.0.adoc)
 
 ```sh
 GIT_OPTIONS=q,strategy=ort  # all
@@ -676,7 +739,7 @@ DOCKER_ALL=1                             # list every image/container
 DOCKER_Y=1                               # confirm all
 
 BUILD_SQUARED_OPTS="NODE_TAG=24 RUBY_VERSION=3.4.0" DOCKER_SQUARED_OPTS="--no-cache --label=v1" rake squared:build
-docker build --no-cache --label=v1 --build-arg="NODE_TAG=24" --build-arg="RUBY_VERSION=3.4.0" .
+docker build --no-cache --label=v1 --build-arg='NODE_TAG=24' --build-arg='RUBY_VERSION=3.4.0' .
 ```
 
 | Command    | Flag              | ENV                                             |
@@ -707,58 +770,27 @@ Workspace::Application
 
 ### Repo
 
-* [Repo](https://source.android.com/docs/setup/reference/repo)
-* https://github.com/anpham6/squared-repo
-* Python 3.6
-* Not compatible with Windows
-
-```sh
-mkdir -p ~/.bin
-PATH="${HOME}/.bin:${PATH}"
-curl https://storage.googleapis.com/git-repo-downloads/repo > ~/.bin/repo
-chmod a+rx ~/.bin/repo
-```
-
-```ruby
-# REPO_ROOT = /workspaces                            |
-# REPO_HOME = /workspaces/squared                    | Dir.pwd
-# rake      = /workspaces/squared/Rakefile           | main?
-#
-# OR
-#
-# REPO_ROOT = /workspaces                            | Dir.pwd
-# rake      = /workspaces/Rakefile                   |
-# REPO_HOME = /workspaces/squared                    | main: "squared"
-
-Workspace::Application
-  .new(main: "squared")
-  .repo("https://github.com/anpham6/squared-repo", "nightly", script: ["build:dev", "prod"], ref: :node)
-  .add("squared", script: ["build:stage1", "build:stage2"])
-  .build
-```
-
-These global options also can target the application main suffix `${NAME}`. (e.g. *REPO_ROOT_SQUARED*)
+These global options also can target the application main suffix `${NAME}`. (e.g. REPO_ROOT_SQUARED)
 
 ```sh
 REPO_ROOT            # parent dir
 REPO_HOME            # project dir (main)
-REPO_BUILD           # run,script
+REPO_BUILD           # script,run (e.g. build:dev | build:dev,make install | make)
 REPO_GROUP           # string
 REPO_REF             # e.g. ruby,node
 REPO_DEV             # pattern,0,1
 REPO_PROD            # pattern,0,1
 REPO_WARN            # 0,1
 REPO_SYNC            # 0,1
-REPO_GIT             # manifest repository
+REPO_URL             # manifest repository
 REPO_MANIFEST        # e.g. latest,nightly,prod
 REPO_GROUPS          # e.g. base,prod,docs
 REPO_STAGE           # 0,1,2,3,4
 REPO_SUBMODULLES     # 0,1
+REPO_Y               # 0,1
 REPO_TIMEOUT         # confirm dialog (seconds)
 ```
 
-Other similarly cloned `Repo` repositories can be managed remotely by setting the `REPO_ROOT` environment variable to the location.
-
 ## LICENSE
 
 BSD 3-Clause

data/lib/squared/common/base.rb

@@ -17,6 +17,7 @@ module Squared
       GRAPH: ['|', '-', '|', '\\', '-'].freeze,
       BORDER: ['|', '-', '-', '-', '-', '-', '|', '|', '-', '-'].freeze,
       VIEW: 'view',
+      BACKTRACE: $DEBUG || !$VERBOSE.nil?,
       LEVEL: ENV.fetch('LOG_LEVEL', 0).to_i,
       COLOR: ENV.fetch('NO_COLOR', '').empty?
     }
@@ -97,27 +98,5 @@ module Squared
       VAR[:theme].each_value { |val| val.freeze.each_value(&:freeze) }
       VAR.freeze
     end
-
-    module_function
-
-    def as_a(obj, *meth, flat: nil, compact: false, &blk)
-      return [] if obj.nil?
-
-      unless obj.is_a?(::Array)
-        obj = if obj.respond_to?(:to_ary)
-                obj.to_ary
-              elsif obj.respond_to?(:to_a) && !obj.is_a?(::Hash) && (val = obj.to_a).is_a?(::Array)
-                val
-              else
-                [obj]
-              end
-      end
-      obj = flat.is_a?(::Numeric) ? obj.flatten(flat) : obj.flatten if flat
-      obj = obj.compact if compact
-      obj = obj.map(&meth.shift) until meth.empty?
-      return obj unless block_given?
-
-      obj.select(&blk)
-    end
   end
 end

data/lib/squared/common/format.rb

@@ -39,6 +39,10 @@ module Squared
       TEXT_STYLE = [:bold, :dim, :italic, :underline, :blinking, nil, :inverse, :hidden, :strikethrough].freeze
       private_constant :AIX_TERM, :BOX_GRAPH, :BOX_BORDER, :TEXT_STYLE
 
+      String.define_method(:stripstyle) { gsub(/\x1B\[(?:\d+;?)+m/, '') }
+      String.define_method(:stripext) { File.basename(self, '.*') }
+      String.define_method(:subhint) { |s| s.nil? || (s.is_a?(::String) && s.empty?) ? self : "#{self} (#{s})" }
+
       def enable_aixterm
         unless (colors = __get__(:colors)).frozen?
           colors.update(AIX_TERM)
@@ -67,7 +71,6 @@ module Squared
         end
         wrap = ->(s, n) { "\x1B[#{n.join(';')}m#{s}\x1B[0m" }
         code = []
-        args.clear if args.size == 1 && args.first.nil?
         args.concat(Array(styles)).flatten.each_with_index do |type, i|
           next unless type
 
@@ -86,7 +89,7 @@ module Squared
             end
           else
             t = type.to_sym
-            if (c = __get__(:colors)[t])
+            if (c = __get__(:colors)[t] || __get__(:colors)[t.to_s.sub('bright_', '').to_sym])
               if index == -1
                 s = wrap.call(s, [c])
               else
@@ -95,7 +98,7 @@ module Squared
             else
               next unless (n = TEXT_STYLE.index(t))
 
-              s = "\x1B[#{n + 1}m#{s}\x1B[#{n == 0 ? 22 : n + 21}m"
+              s = "\x1B[#{n.succ}m#{s}\x1B[#{n == 0 ? 22 : n + 21}m"
             end
           end
           if index == -1
@@ -127,8 +130,8 @@ module Squared
         colors = __get__(:colors)
         Array(args).flatten.compact.each do |val|
           if !val.is_a?(::Numeric)
-            val = val.to_sym
-            ret << val if colors.key?(val) || TEXT_STYLE.include?(val)
+            k = val.to_sym
+            ret << k if colors.key?(k) || colors.key?(k.to_s.sub('bright_', '').to_sym) || TEXT_STYLE.include?(k)
           elsif val.between?(0, 256)
             ret << val
           elsif val < 0 && (b = val.to_s.split('.')[1])
@@ -152,6 +155,10 @@ module Squared
         end
       end
 
+      def opt_style(styles, pat = nil, index = 1)
+        { styles: styles, pat: pat, index: index }
+      end
+
       def log_sym(level)
         if level.is_a?(::Numeric)
           case level
@@ -181,22 +188,23 @@ module Squared
         args = args.map(&:to_s)
         if level.is_a?(::Numeric)
           if append && respond_to?(:log)
-            ref = log rescue nil
-            ref.add(level, message(subject, *args, hint: hint, space: ', ')) if ref.is_a?(::Logger)
+            (log rescue nil).tap do |ref|
+              ref.add(level, message(subject, *args, hint: hint, space: ', ')) if ref.is_a?(::Logger)
+            end
           end
-          return false unless pass || level >= ARG[:LEVEL]
+          return false if !pass && level < ARG[:LEVEL]
         end
-        if hint.nil? ? args.size > 1 : !hint
+        if (args.size > 1 && !hint) || hint == false
           title = log_title(level, color: false)
-          if color
-            sub = [{ pat: /\A(#{Regexp.escape(title)})(.*)\z/m, styles: __get__(:theme)[:logger][log_sym(level)] }]
-          end
-          emphasize(args, title: title + (subject ? " #{subject}" : ''), sub: sub, pipe: -1)
+          emphasize(args,
+                    title: title + (subject ? " #{subject}" : ''),
+                    pipe: -1,
+                    sub: if color
+                           opt_style(__get__(:theme)[:logger][log_sym(level)], /\A(#{Regexp.escape(title)})(.*)\z/m)
+                         end)
         else
           msg = [log_title(level, color: color)]
-          if subject
-            msg << (color ? sub_style(subject.to_s, (@theme.is_a?(::Hash) && @theme[:subject]) || :bold) : subject)
-          end
+          msg << (color ? sub_style(subject.to_s, styles: (@theme && @theme[:subject]) || :bold) : subject) if subject
           msg << args.shift if msg.size == 1
           message(msg.join(' '), *args, hint: hint)
         end
@@ -209,7 +217,7 @@ module Squared
           begin
             File.open(pipe, 'a') do |f|
               br = File::SEPARATOR == '\\' ? "\r\n" : "\n"
-              args.flatten.each { |val| f.write(strip_style(val.chomp) + br) }
+              args.flatten.each { |val| f.write(val.chomp.stripstyle + br) }
             end
             return
           rescue StandardError
@@ -219,17 +227,16 @@ module Squared
         (pipe == 2 ? $stderr : $stdout).puts(*args)
       end
 
-      alias puts_oe log_console
-
       module_function
 
       def message(*args, hint: nil, empty: false, space: ARG[:SPACE])
         (empty ? args.reject { |val| val.nil? || (val.respond_to?(:empty?) && val.empty?) } : args)
-          .join(space) + (hint ? " (#{hint})" : '')
+          .join(space)
+          .subhint(hint)
       end
 
       def emphasize(val, title: nil, footer: nil, right: false, cols: nil, sub: nil, pipe: nil,
-                    border: @theme.is_a?(::Hash) && @theme[:border])
+                    border: @theme && @theme[:border])
         n = 0
         max = ->(a) { n = [n, a.max_by(&:size).size].max }
         set = ->(s) { Array(s).map(&:to_s).tap { |a| max.call(a) } }
@@ -241,9 +248,7 @@ module Squared
           lines = val.to_s.lines(chomp: true)
           lines[0] = "#{val.class}: #{lines.first}" if (err = val.is_a?(::StandardError))
         end
-        return if lines.empty?
-
-        n = cols || max.call(lines)
+        n = (cols.is_a?(::Array) ? cols.map(&:size).max : cols) || max.call(lines)
         if $stdout.tty?
           require 'io/console'
           (n = [n, $stdout.winsize[1] - 4].min) rescue nil
@@ -261,14 +266,14 @@ module Squared
           sub.each { |h| s = sub_style(s, **h) }
           s = "#{b0} #{s} #{b0}"
           if border
-            s = sub_style(s, pat: /\A(#{Regexp.escape(b0)})(.+)\z/om, styles: border)
-            s = sub_style(s, pat: /\A(.+)(#{Regexp.escape(b0)})\z/om, styles: border, index: 2)
+            s = sub_style(s, **opt_style(border, /\A(#{Regexp.escape(b0)})(.+)\z/m))
+            s = sub_style(s, **opt_style(border, /\A(.+)(#{Regexp.escape(b0)})\z/m, 2))
           end
           s
         end
         out << draw.call(b2, b3)
         if title
-          out.concat(title.map { |t| pr.call(t) })
+          out.concat(title.map! { |t| pr.call(t) })
           out << draw.call(b6, b7)
         end
         lines.each { |line| out << pr.call(line) }
@@ -296,22 +301,19 @@ module Squared
           else
             pipe = $stdout unless pipe.respond_to?(:puts)
           end
-          pipe.puts(out)
+          pipe.puts out
         else
           err ? warn(out) : puts(out)
         end
       end
 
-      def strip_style(val)
-        val.gsub(/\x1B\[(\d+;?)+m/, '')
-      end
-
-      def stripext(val)
-        File.basename(val, '.*')
-      end
-
-      def raise_error(*args, hint: nil, kind: ArgumentError)
-        raise kind, message(*args, hint: hint, empty: true), caller_locations(1).map(&:to_s)
+      def raise_error(*args, hint: nil, kind: RuntimeError, start: 0)
+        kind = args.shift if args.first.is_a?(::Class) && args.first < ::Exception
+        raise kind, message(*args, hint: hint, empty: true), if ARG[:BACKTRACE]
+                                                               caller(start.succ)
+                                                             else
+                                                               caller_locations(start.succ, 1).first&.base_label
+                                                             end
       end
     end
   end

data/lib/squared/common/prompt.rb

@@ -1,12 +1,25 @@
 # frozen_string_literal: true
 
+unless defined?(Readline)
+  if RUBY_ENGINE == 'ruby' && RUBY_VERSION < '2.7'
+    require 'readline'
+  else
+    begin
+      require 'reline'
+      Object.send(:remove_const, :Readline) if Object.const_defined?(:Readline)
+      Readline = Reline
+    rescue LoadError
+      require 'readline'
+    end
+  end
+end
+
 module Squared
   module Common
     module Prompt
       module_function
 
-      def confirm(msg, default = nil, agree: 'Y', cancel: 'N', attempts: 5, timeout: 30)
-        require 'readline'
+      def confirm(msg, default = nil, agree: 'Y', cancel: 'N', attempts: 3, timeout: 60)
         require 'timeout'
         if agree == 'Y' && cancel == 'N' && !msg.match?(%r{\[(?:Yn|nY|Y/n|y/N)\]})
           case default
@@ -38,9 +51,8 @@ module Squared
         end
       end
 
-      def choice(msg, list = nil, min: 1, max: 1, multiple: false, force: true, grep: nil, auto: true,
-                 attempts: 5, timeout: 0)
-        require 'readline'
+      def choice(msg, list = nil, min: 1, max: 1, multiple: false, index: false, grep: nil, border: nil, auto: true,
+                 force: true, attempts: 3, timeout: 0)
         require 'timeout'
         if list
           grep &&= Array(grep).map { |val| Regexp.new(val) }
@@ -52,40 +64,51 @@ module Squared
             puts '%2d. %s' % [items.size, val]
           end
           max = items.size
-          raise_error 'empty selection list' if max == 0
+          raise ArgumentError, 'empty selection list' if max == 0
+
           min = grep ? 1 : [min, max].min
           if auto
-            msg = "#{msg}: [#{min}-#{max}#{if multiple
-                                             "|,#{multiple.is_a?(::Numeric) ? "{#{multiple}}" : ''}"
-                                           end}] "
+            auto.times { puts } if auto.is_a?(::Numeric)
+            if border == true
+              puts print_footer
+            elsif border
+              puts print_footer(border: border)
+            end
+            msg = "#{msg + (force ? ':' : '?')} [#{min}-#{max}#{if (n = multiple)
+                                                                  "|,#{n.is_a?(::Numeric) ? "{#{n}}" : '*'}"
+                                                                end}] "
           end
         end
-        valid = ->(s) { s.match?(/^\d+$/) && s.to_i.between?(min, max) }
+        between = ->(s) { s.match?(/^\d+$/) && s.to_i.between?(min, max) }
         Timeout.timeout(timeout) do
           while (ch = Readline.readline(msg))
             unless (ch = ch.strip).empty?
               if multiple
-                a = ch.split(',')
-                b = a.map do |s|
-                  s.strip!
-                  if s =~ /^(\d+)-(\d+)$/
-                    next unless valid.call($1) && valid.call($2)
+                k = if ch == '*'
+                      (min..max).to_a
+                    else
+                      ch.split(/\s*,\s*/).map! do |s|
+                        if s =~ /^(\d+)-(\d+)$/
+                          next unless between.call($1) && between.call($2)
 
-                    c = $1.to_i
-                    d = $2.to_i
-                    next (c..d).to_a if c < d
-                  elsif valid.call(s)
-                    s.to_i
+                          i = $1.to_i
+                          j = $2.to_i
+                          next (i..j).to_a if i < j
+                        elsif between.call(s)
+                          s.to_i
+                        end
+                      end
+                    end
+                unless k.include?(nil)
+                  k.flatten!
+                  k.uniq!
+                  k.sort!
+                  unless multiple.is_a?(::Numeric) && multiple != k.size
+                    return index || !items ? k : k.map! { |i| items[i.pred] }
                   end
                 end
-                unless b.include?(nil)
-                  b.flatten!
-                  b.uniq!
-                  b.sort!
-                  return items ? b.map! { |i| items[i - 1] } : b unless multiple.is_a?(::Numeric) && multiple != b.size
-                end
-              elsif valid.call(ch)
-                return items ? items[ch.to_i - 1] : ch.to_i
+              elsif between.call(ch)
+                return index || !items ? ch.to_i : items[ch.to_i.pred]
               end
             end
             attempts -= 1
@@ -98,12 +121,11 @@ module Squared
           puts
           exit 0
         else
-          multiple ? [] : nil
+          [] if multiple
         end
       end
 
       def readline(msg, history = false, force: nil, multiline: nil, &blk)
-        require 'readline'
         multiline = if multiline && Readline.respond_to?(:readmultiline)
                       multiline.is_a?(::Enumerable) || block_given? ? multiline : [multiline.to_s]
                     end
@@ -113,20 +135,16 @@ module Squared
           elsif block_given?
             Readline.readmultiline(msg, history, &blk)
           else
-            Readline.readmultiline(msg, history) do |line|
-              next if line.strip.empty?
-
-              multiline.any? { |val| line.split.last.end_with?(val.to_s) }
-            end
+            Readline.readmultiline(msg, history) { |line| multiline.any? { |val| line.split.last.end_with?(val.to_s) } }
           end
         end
         case force
         when ::TrueClass, ::FalseClass
-          msg = "#{msg} %s " % if multiline
-                                 multiline.is_a?(::Enumerable) ? "{#{multiline.to_a.join('|')}}" : multiline
-                               else
-                                 "(#{force ? 'required' : 'optional'}):"
-                               end
+          msg = "#{msg}%s%s " % if multiline
+                                  [' ', multiline.is_a?(::Enumerable) ? "{#{multiline.to_a.join('|')}}" : multiline]
+                                else
+                                  [force ? ':' : '?', '']
+                                end
           ret = (prompt.call || '').strip
           multiline.each { |val| break if ret.delete_suffix!(val.to_s) } if multiline.is_a?(::Enumerable)
           exit 1 if force && ret.empty?