squared 0.4.16 → 0.4.17

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 42a856b40866dc4f90ff4def50a0d8ef6f7134ce5cd8f0c40064b55aea2735a4
-  data.tar.gz: 1ee4f68f6f3a40ed0d45fac5fbb7e3817787f9c86be7770331edbaff541e7ad1
+  metadata.gz: 4e41d76a0edb3135560234d2a7faf8eba688365316cad1dc9ca38d7fb353759d
+  data.tar.gz: b59fa903ae6e7282ef8d3b36039141c9b29f43c0f7d5fdc64063cd191e7cb409
 SHA512:
-  metadata.gz: ffb1e276cc3fa97d5de20158a5d0833c8cd140506cc8ee2fd61e0c19fe446e12edba1dca5cc0cda49a4e5d0e393bae4db1fa8f5320aa8bfb892c1dd8608d31ae
-  data.tar.gz: e6460b7953fd893b7560a051d93e86630faf134d831e173d25924562775186a6f46dd0a9cb13014a4adc8c2ff3ed734719925653ccd9ef140e4fa572e36db15c
+  metadata.gz: 7118f35ce60a5a8008c3163b636b7acbcbfeb637b2cea7aab9fb3be87b5a4701d0f28c8edbe2510a9e596077f578875bea537acebedc4177223a63d377ea418f
+  data.tar.gz: '025669293a2bf52bed8c2a25135264faa04363e646f2bd217a1a26e89fddaa4cab84cafedd4c31ba82045c1471d4c82da39e4c15fd353201bcc2b789bcbb0c1d'

data/CHANGELOG.md

@@ -1,5 +1,35 @@
 # Changelog
 
+## [0.4.17] - 2025-08-09
+
+### Added
+
+- Node repos can be initialized with specific package manager.
+- Docker Engine options were updated to 28.0.
+- Git commands pull and fetch action all was implemented.
+- Git command reset action undo was implemented.
+- Python command pip action upgrade was implemented.
+- Git commands refs and files can use both pathspec and pattern.
+- Git command submodule was implemented.
+- Git command status was implemented.
+- Git command switch action branch was implemented.
+
+### Changed
+
+- Project task events can be assigned to a single proc.
+- Ruby task copy uses require paths from gem specification.
+- Docker task build:bake was renamed bake:build.
+- Project global tasks can be hidden and still expose subtasks.
+- Repo command line options can be overriden with class method.
+- Repo task all variable REPO_DRYRUN was replaced with REPO_STAGE.
+- Repo command sync option no-fail was renamed fail.
+
+### Fixed
+
+- Gem command outdated did not work outside main project folder.
+- Node command bump did not reset major and minor trailing digits.
+- Docker image status message was displayed backwards.
+
 ## [0.4.16] - 2025-07-27
 
 ### Added
@@ -861,6 +891,7 @@
 
 - Changelog was created.
 
+[0.4.17]: https://github.com/anpham6/squared/releases/tag/v0.4.17-ruby
 [0.4.16]: https://github.com/anpham6/squared/releases/tag/v0.4.16-ruby
 [0.4.15]: https://github.com/anpham6/squared/releases/tag/v0.4.15-ruby
 [0.4.14]: https://github.com/anpham6/squared/releases/tag/v0.4.14-ruby

data/README.md

@@ -1,4 +1,4 @@
-# squared 5.5
+# squared 5.6
 
 ## Documentation
 
@@ -140,13 +140,13 @@ rake clone               # node + docs
 # PIPE_FAIL={0,1}
 # PORT=3000
 docker build -t squared --build-arg MANIFEST=prod --build-arg NODE_ENV=production .
-docker build -t node --build-arg NODE_TAG=22 --build-arg NODE_INSTALL=pnpm -f slim.Dockerfile .
+docker build -t node --build-arg NODE_TAG=22 --build-arg NODE_INSTALL=pnpm -f Dockerfile.slim .
 NODE=22 docker buildx bake node
 # OR
-docker build -t ruby --build-arg RUBY_TAG=3.4.0 --build-arg NODE_VERSION=22 --build-arg PIPE_FAIL=0 -f ruby.Dockerfile .
+docker build -t ruby --build-arg RUBY_TAG=3.4.0 --build-arg NODE_VERSION=22 --build-arg PIPE_FAIL=0 -f Dockerfile.ruby .
 RUBY=3.4.0 docker buildx bake ruby
 # OR
-docker build -t nginx --build-arg NGINX_VERSION=1.27 --build-arg PORT=3000 --build-arg NODE_VERSION=20 -f nginx.Dockerfile .
+docker build -t nginx --build-arg NGINX_VERSION=1.27 --build-arg PORT=3000 --build-arg NODE_VERSION=20 -f Dockerfile.nginx .
 NGINX=1.27 docker buildx bake nginx
 
 # Express
@@ -175,6 +175,9 @@ docker run -it --name debian squared /bin/bash # irb
 > * https://unpkg.com/squared/dist/squared.min.js
 > * https://unpkg.com/squared/dist/vdom-lite.framework.min.js
 
+> [!WARNING]
+> Safari is completely untested and is not an officially supported browser.
+
 ## Usage
 
 Library files are in the `/dist` folder. A minimum of **two** files are required to run *squared*.
@@ -378,7 +381,7 @@ Used primarly for developing single page layouts but can also bundle assets usin
 
 ### Example: vdom
 
-The most minimal framework possible (*55kb gzipped*) and can be useful when debugging through DevTools. The `lite` version is about half the bundle size and is recommended for most browser applications.
+The most minimal framework possible (*80kb gzipped*) and can be useful when debugging through DevTools. The `lite` version is about half the bundle size and is recommended for most browser applications.
 
 * ES2018
 
@@ -416,6 +419,7 @@ squared.settings = {
     targetAPI: 35,
     supportRTL: true,
     supportNegativeLeftTop: true,
+    supportUnicode: ["emoji"], // true | "utf-16" | "emoji"
     preloadImages: true,
     preloadFonts: true,
     preloadLocalFonts: true, // Chromium
@@ -464,6 +468,7 @@ squared.settings = {
     outputMainFileName: "activity_main.xml",
     outputFragmentFileName: "fragment_main.xml",
     /* Project - parseDocument (first only) */
+    supportUnicode: "utf-16",
     resourceQualifier: "", // "land" -> "res/layout-land" | "port" -> "res/layout-port" (appended to every "res" folder)
     resourceSystemColors: {
         "system_accent1_100": "white", // Will be converted to ARGB

data/README.ruby.md

@@ -88,7 +88,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", script: ["build:stage1", "build:stage2"], group: "app") do # 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" })
@@ -499,11 +499,11 @@ Most project classes will inherit from `Git` which enables these tasks:
 | checkout   | checkout         | commit branch track detach path               |
 | commit     | commit           | add all amend amend-orig fixup                |
 | diff       | diff             | head cached branch files between contain      |
-| fetch      | fetch            | origin remote                                 |
+| fetch      | fetch            | origin remote all                             |
 | files      | ls-files         | cached modified deleted others                |
-| git        |                  | add clean mv rm revert                        |
+| git        |                  | add blame clean mv rm revert                  |
 | merge      | merge            | commit no-commit send                         |
-| pull       | pull             | origin remote                                 |
+| pull       | pull             | origin remote all                             |
 | rebase     | rebase           | branch onto send                              |
 | refs       | ls-remote --refs | heads tags remote                             |
 | reset      | reset            | commit index patch mode                       |
@@ -511,7 +511,7 @@ Most project classes will inherit from `Git` which enables these tasks:
 | rev        | rev              | commit output                                 |
 | show       | show             | format oneline                                |
 | stash      | stash            | push pop apply branch drop clear list         |
-| switch     | switch           | create detach merge                           |
+| switch     | switch           | branch create detach                          |
 | tag        | tag              | add sign delete list                          |
 
 You can disable all of them at once using the `exclude` property.
@@ -625,6 +625,8 @@ LOG_LEVEL                    # See gem "logger"
 
 ### Git
 
+* Version: 2.50
+
 ```sh
 GIT_OPTIONS=q,strategy=ort  # all
 GIT_OPTIONS_${NAME}=v,ff    # project only
@@ -634,15 +636,15 @@ GIT_AUTOSTASH_${NAME}=0     # rebase (project only)
 
 | Command    | Flag              |  ENV                                                                  |
 | :--------- | :---------------- | :-------------------------------------------------------------------- |
-| branch     | create            | TRACK=0,1,s FORCE                                                     |
-| branch     | move copy         | FORCE                                                                 |
+| branch     | create            | TRACK=0,1,s F|FORCE                                                   |
+| branch     | move copy         | F|FORCE                                                               |
 | branch     | set delete        | COUNT=n                                                               |
 | branch     | global            | SYNC                                                                  |
 | checkout   | branch            | DETACH TRACK=s COUNT=n                                                |
 | checkout   | detach            | REFLOG=1                                                              |
 | checkout   | track             | COUNT=n                                                               |
 | checkout   | global path       | HEAD=s PATHSPEC=s                                                     |
-| checkout   | *                 | FORCE MERGE                                                           |
+| checkout   | *                 | F|FORCE MERGE                                                         |
 | clone      | *                 | DEPTH=n ORIGIN=s BRANCH=s REVISION=s LOCAL=0,1                        |
 | commit     | *                 | UPSTREAM=s DRY_RUN EDIT=0 M|MESSAGE=s                                 |
 | diff       | -between -contain | MERGE_BASE                                                            |
@@ -650,13 +652,13 @@ GIT_AUTOSTASH_${NAME}=0     # rebase (project only)
 | diff       | *                 | PATHSPEC=s                                                            |
 | fetch      | -remote           | ALL                                                                   |
 | fetch      | remote            | REFSPEC=s                                                             |
-| fetch      | *                 | FORCE RECURSE_SUBMODULES=0,1,s                                        |
+| fetch      | *                 | F|FORCE RECURSE_SUBMODULES=0,1,s                                      |
 | git        | rm                | PATHSPEC=s                                                            |
 | log        | *                 | PATHSPEC=s                                                            |
 | pull       | rebase            | AUTOSTASH                                                             |
 | pull       | remote            | REFSPEC=s                                                             |
 | pull       | -remote           | ALL                                                                   |
-| pull       | *                 | REBASE=0,1 FORCE RECURSE_SUBMODULES=0,1,s                             |
+| pull       | *                 | REBASE=0,1 F|FORCE RECURSE_SUBMODULES=0,1,s                           |
 | rebase     | branch            | HEAD=s                                                                |
 | rebase     | onto              | INTERACTIVE I HEAD=s                                                  |
 | reset      | mode (mixed)      | N REFRESH=0                                                           |
@@ -670,14 +672,16 @@ GIT_AUTOSTASH_${NAME}=0     # rebase (project only)
 | status     | global            | BRANCH LONG IGNORE_SUBMODULES=s,0-3 PATHSPEC=s                        |
 | switch     | detach            | REFLOG=1                                                              |
 | switch     | -detach           | HEAD=s                                                                |
-| switch     | *                 | FORCE                                                                 |
+| switch     | *                 | F|FORCE                                                               |
 | tag        | add               | SIGN FORCE HEAD=s M|MESSAGE=s                                         |
-| tag        | sign              | FORCE HEAD=s M|MESSAGE=s                                              |
+| tag        | sign              | F|FORCE HEAD=s M|MESSAGE=s                                            |
 | tag        | delete            | COUNT=n                                                               |
 | rev        | commit branch     | HEAD=s                                                                |
 
 ### Docker
 
+* Version: 28.3
+
 ```sh
 DOCKER_OPTIONS=q,no-cache                # all
 DOCKER_OPTIONS_${NAME}=v,no-cache=false  # project only (override)
@@ -712,7 +716,7 @@ REPO_WARN            # 0,1
 REPO_SYNC            # 0,1
 REPO_URL             # manifest repository
 REPO_MANIFEST        # e.g. latest,nightly,prod
-REPO_DRYRUN          # 0,1,2
+REPO_STAGE           # 0,1,2,3
 REPO_TIMEOUT         # confirm dialog (seconds)
 ```
 

data/lib/squared/common/system.rb

@@ -12,9 +12,9 @@ module Squared
         if RUBY_ENGINE == 'jruby' && Rake::Win32.windows?
           e = kwargs[:exception]
           if (dir = kwargs[:chdir]) && ((pwd = Dir.pwd) != dir)
-            Dir.chdir(dir)
+            Dir.chdir dir
             ret = Kernel.send(name, *args)
-            Dir.chdir(pwd)
+            Dir.chdir pwd
           else
             ret = Kernel.send(name, *args)
           end
@@ -57,23 +57,24 @@ module Squared
         soft = 0
         subdir.each do |dir, files|
           if link
-            items = files.dup
-            files.clear
-            items.each do |file|
-              if file.exist?
-                if file.symlink?
-                  next unless force
+            files.dup.tap do |items|
+              files.clear
+              items.each do |file|
+                if file.exist?
+                  if file.symlink?
+                    next unless force
+                  else
+                    files << file
+                    next
+                  end
+                end
+                if link == 'hard'
+                  FileUtils.ln(file, dir, force: force, verbose: false)
                 else
-                  files << file
-                  next
+                  FileUtils.ln_s(file, dir, force: force, verbose: false)
                 end
+                soft += 1
               end
-              if link == 'hard'
-                FileUtils.ln(file, dir, force: force, verbose: false)
-              else
-                FileUtils.ln_s(file, dir, force: force, verbose: false)
-              end
-              soft += 1
             end
           end
           next if files.empty?

data/lib/squared/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Squared
-  VERSION = '0.4.16'
+  VERSION = '0.4.17'
 end

data/lib/squared/workspace/application.rb

@@ -26,7 +26,7 @@ module Squared
             next unless base || obj < impl_project
 
             if base
-              @impl_project = obj
+              self.impl_project = obj
               impl_series.base_set(obj)
             else
               kind_project.unshift(obj)
@@ -39,7 +39,7 @@ module Squared
               impl_series.alias(*args)
             end
             if (args = obj.bannerargs)
-              @attr_banner.merge(args)
+              attr_banner.merge(args)
             end
           end
         end
@@ -691,9 +691,14 @@ module Squared
       private
 
       def __build__(default: nil, **)
-        return unless default && task_defined?(out = task_name(default))
-
-        task Rake.application.default_task_name => out
+        unless task_defined?('squared:version')
+          task 'squared:version' do
+            puts Squared::VERSION
+          end
+        end
+        if default && task_defined?(out = task_name(default))
+          task Rake.application.default_task_name => out
+        end
       end
 
       def __chain__(*)

data/lib/squared/workspace/project/base.rb

@@ -21,8 +21,8 @@ module Squared
         VAR_SET = %i[parent global script index envname desc dependfile dependindex theme archive env dev prod graph
                      pass only exclude].freeze
         BLK_SET = %i[run depend doc lint test copy clean].freeze
-        SEM_VER = /\b(\d+)(?:(\.)(\d+))?(?:(\.)(\d+)(\S+)?)?\b/.freeze
-        URI_SCHEME = %r{^([a-z][a-z\d+-.]*)://[^@:\[\]\\^<>|\s]}i.freeze
+        SEM_VER = /\b(\d+)(?:(\.)(\d+))?(?:(\.)(\d+))?-?(\S+)?\b/.freeze
+        URI_SCHEME = %r{\A([a-z][a-z\d+-.]*)://[^@:\[\]\\^<>|\s]}i.freeze
         TASK_METADATA = Rake::TaskManager.record_task_metadata
         private_constant :VAR_SET, :BLK_SET, :SEM_VER, :URI_SCHEME, :TASK_METADATA
 
@@ -208,7 +208,7 @@ module Squared
         def initialize_env(dev: nil, prod: nil, **)
           @dev = env_match('BUILD', dev, suffix: 'DEV', strict: true)
           @prod = env_match('BUILD', prod, suffix: 'PROD', strict: true)
-          if @output[2] != false && (val = env('BUILD', suffix: 'ENV'))
+          unless @output[2] == false || !(val = env('BUILD', suffix: 'ENV'))
             @output[2] = parse_json(val, hint: "BUILD_#{@envname}_ENV") || @output[2]
           end
           unless @output[0] == false || @output[0].is_a?(Array)
@@ -662,7 +662,7 @@ module Squared
                    when 128, 'sha512'
                      Digest::SHA512
                    else
-                     raise_error("invalid checksum: #{digest}", hint: name)
+                     raise_error "invalid checksum: #{digest}"
                    end
           end
           if (val = env('HEADERS')) && (val = parse_json(val, hint: "HEADERS_#{@envname}"))
@@ -994,7 +994,7 @@ module Squared
         end
 
         def run(cmd = @session, var = nil, exception: self.exception, sync: true, from: nil, banner: true, chdir: path,
-                interactive: nil, **)
+                interactive: nil, hint: nil, **)
           unless cmd
             warn log_message(Logger::WARN, 'no command given', subject: project, hint: from || 'unknown', pass: true)
             return
@@ -1022,7 +1022,7 @@ module Squared
               log&.warn "ENV discarded: #{var}" if var
               task_invoke(cmd, exception: exception, warning: warning?)
             else
-              print_item format_banner(cmd, banner: banner) if sync
+              print_item format_banner(hint ? "#{cmd} (#{hint})" : cmd, banner: banner) if sync
               if var != false && (pre = runenv)
                 case pre
                 when Hash
@@ -1261,7 +1261,7 @@ module Squared
         def session_done(cmd)
           return cmd unless cmd.respond_to?(:done)
 
-          raise_error('no args added', hint: cmd.first || name) unless cmd.size > 1
+          raise_error('no args added', hint: cmd.first) unless cmd.size > 1
           @session = nil if cmd == @session
           cmd.done
         end
@@ -1420,7 +1420,7 @@ module Squared
           unless items.empty?
             pad = items.size.to_s.size
             items.each_with_index do |val, i|
-              next unless reg.empty? || reg.any? { |pat| val[0].match?(pat) }
+              next unless matchany?(val[0], reg)
 
               out << "#{i.succ.to_s.rjust(pad)}. #{each ? each.call(val) : val[0]}"
             end
@@ -1744,6 +1744,17 @@ module Squared
           files.map { |val| val == '.' ? '.' : shell_quote(path + val) }
         end
 
+        def matchmap(list, prefix = nil)
+          list.map do |val|
+            if val.is_a?(Regexp)
+              val
+            else
+              val = ".*#{val}" if prefix && !val.sub!(/\A(\^|\\A)/, '')
+              Regexp.new("#{prefix}#{val == '*' ? '.+' : val}")
+            end
+          end
+        end
+
         def semver(val)
           return val if val[3]
 
@@ -1762,12 +1773,13 @@ module Squared
         end
 
         def semcmp(val, other)
-          a, b = [val, other].map! { |ver| ver.match(SEM_VER) }
-          return 1 unless a
-          return -1 unless b
-          return 0 if a[0] == b[0]
+          return 0 if val == other
 
-          a, b = [a, b].map! { |c| [c[1], c[3], c[5] || '0'] }
+          a, b = [val, other].map! { |ver| ver.scan(SEM_VER) }
+          return -1 if b.empty?
+          return 1 if a.empty?
+
+          a, b = [a.first, b.first].map! { |c| [c[0], c[2], c[4] || '0', c[5] ? '-1' : '0'] }
           a.each_with_index do |c, index|
             next if c == (d = b[index])
 
@@ -1776,6 +1788,10 @@ module Squared
           0
         end
 
+        def semgte?(val, other)
+          semcmp(val, other) != 1
+        end
+
         def indexitem(val)
           [$1.to_i, $2 && $2[1..-1]] if val =~ /\A[=^#{indexchar}](\d+)(:.+)?\z/
         end
@@ -1819,7 +1835,7 @@ module Squared
         def on(event, from, *args, **kwargs)
           return unless from && @events.key?(event)
 
-          @events[event][from]&.each do |obj|
+          Array(@events[event][from]).each do |obj|
             target, opts = if obj.is_a?(Array) && obj[1].is_a?(Hash)
                              [obj[0], kwargs.empty? ? obj[1] : obj[1].merge(kwargs)]
                            else
@@ -1849,13 +1865,12 @@ module Squared
           pwd = Pathname.pwd
           if block_given?
             begin
-              pass = semscan(pass).join <= RUBY_VERSION if pass.is_a?(String)
               if (path == pwd || pass == true) && (workspace.mri? || !workspace.windows?)
                 ret = yield
               else
-                Dir.chdir(path)
+                Dir.chdir path
                 ret = yield
-                Dir.chdir(pwd)
+                Dir.chdir pwd
               end
             rescue StandardError => e
               on_error(e, from, dryrun: dryrun)
@@ -1878,8 +1893,8 @@ module Squared
         end
 
         def run_set(cmd, val = nil, opts: nil, **)
-          diso = @output[1] == false && !@output[0].nil?
-          dise = @output[2] == false
+          noopt = @output[1] == false && !@output[0].nil?
+          noenv = @output[2] == false
           parse = lambda do |data|
             ret = []
             if data[:command]
@@ -1899,8 +1914,8 @@ module Squared
           case cmd
           when Array
             @output = if cmd.all? { |data| data.is_a?(Hash) }
-                        diso = false
-                        dise = false
+                        noopt = false
+                        noenv = false
                         cmd.map { |data| parse.call(data) }
                       else
                         cmd.dup
@@ -1911,14 +1926,14 @@ module Squared
           else
             @output[0] = cmd
           end
-          unless diso
+          unless noopt
             if opts == false
               @output[1] = false
             elsif opts && opts != true
               @output[1] = opts
             end
           end
-          return if dise
+          return if noenv
 
           if val.is_a?(Hash)
             @output[2] = val
@@ -2021,6 +2036,10 @@ module Squared
           @only ? !@only.include?(key) : @pass.include?(key)
         end
 
+        def matchany?(val, list, empty: true)
+          list.empty? ? empty : list.any? { |pat| val.match?(pat) }
+        end
+
         def projectpath?(val)
           val = Pathname.new(val).cleanpath
           val.absolute? ? val.to_s.start_with?(File.join(path, '')) : !val.to_s.start_with?(File.join('..', ''))