cmdx 1.14.0 → 1.16.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 620c2c00dd483c6a4122c7b5acbbe6cf7a07d22260d0331d6f1d54b571ef7648
-  data.tar.gz: aff47b340a77b052bc4cd2e201068044a443c1d8f4609163fa45025bdba25d00
+  metadata.gz: d864a54c25ea1fd3a30f5c84b760bfa1f50207f7b26e47143876c76e2258b37a
+  data.tar.gz: f1381fc4c62e761b0553800ccdd28a1aa0315e8dab4c2504692d936635b07063
 SHA512:
-  metadata.gz: a8f6fec277ff0198937013c25a1a1c753d4cf5100ff4920c834dc92fba8df7d2adc1ef3fbcff91c999f1af8c4676c3e8702c71a29a3402efcf36d4a0236163ba
-  data.tar.gz: 2233517633c8d9afaafb7a44878b6b3fe0939dabcbe647ceafd9e7ca04450ee1e5e9f6b6f5adb2de58c305b0c2c0940e74ee2d7290f0eb202bda429d76b66992
+  metadata.gz: 3431a3d16f0ac92ebb52daa8c412d8f9e33975deab27482d6756e00935015100b3edeb008a419d28daf3daa5e3ba59456110b8ef9554a648ebda348d68152609
+  data.tar.gz: b7837730a25c052356e45d56c69f2f41baa932362031f4f3f2fb9f5302020fff4ed8d690973afd0b482ba22a38d13091fe47f11b54635f1c321372bcbbf0cf60

data/CHANGELOG.md

@@ -6,6 +6,21 @@ The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
 
 ## [Unreleased]
 
+### Added
+- Add `CMDx::Exception` alias for `CMDx::Error`
+
+### Changed
+- Renamed `exceptions.rb` file to `exception.rb` (zeitwerk issue)
+- Renamed `faults.rb` file to `fault.rb` (zeitwerk issue)
+
+## [1.15.0] - 2025-01-21
+
+### Added
+- Add attribute `Absence` validator
+- Add attribute `:description` option
+
+## [1.14.0] - 2025-01-09
+
 ### Added
 - Add Ruby 4.0 compatibility
 - Add `Context#clear!` method to remove all context data

data/README.md

@@ -6,7 +6,15 @@
 
   Build business logic that’s powerful, predictable, and maintainable.
 
-  [Documentation](https://drexed.github.io/cmdx) · [Changelog](./CHANGELOG.md) · [Report Bug](https://github.com/drexed/cmdx/issues) · [Request Feature](https://github.com/drexed/cmdx/issues) · [LLM.md](https://raw.githubusercontent.com/drexed/cmdx/refs/heads/main/LLM.md)
+  [Home](https://drexed.github.io/cmdx) ·
+  [Documentation](https://drexed.github.io/cmdx/getting_started) ·
+  [Blog](https://drexed.github.io/cmdx/blog) ·
+  [Changelog](./CHANGELOG.md) ·
+  [Report Bug](https://github.com/drexed/cmdx/issues) ·
+  [Request Feature](https://github.com/drexed/cmdx/issues) ·
+  [llms.txt](https://drexed.github.io/cmdx/llms.txt) ·
+  [llms-full.txt](https://drexed.github.io/cmdx/llms-full.txt) ·
+  [SKILL.md](https://github.com/drexed/cmdx/blob/main/docs/SKILL.md)
 
   <img alt="Version" src="https://img.shields.io/gem/v/cmdx">
   <img alt="Build" src="https://github.com/drexed/cmdx/actions/workflows/ci.yml/badge.svg">

data/lib/cmdx/attribute.rb

@@ -72,6 +72,16 @@ module CMDx
     # @rbs @types: Array[Class]
     attr_reader :types
 
+    # Returns the description of the attribute.
+    #
+    # @return [String] The description of the attribute
+    #
+    # @example
+    #   attribute.description # => "The user's name"
+    #
+    # @rbs @description: String
+    attr_reader :description
+
     # Creates a new attribute with the specified name and configuration.
     #
     # @param name [Symbol, String] The name of the attribute
@@ -79,6 +89,7 @@ module CMDx
     # @option options [Attribute] :parent The parent attribute for nested structures
     # @option options [Boolean] :required Whether the attribute is required (default: false)
     # @option options [Array<Class>, Class] :types The expected type(s) for the attribute value
+    # @option options [String] :description The description of the attribute
     # @option options [Symbol, String, Proc] :source The source of the attribute value
     # @option options [Symbol, String] :as The method name to use for this attribute
     # @option options [Symbol, String, Boolean] :prefix The prefix to add to the method name
@@ -98,6 +109,7 @@ module CMDx
       @parent = options.delete(:parent)
       @required = options.delete(:required) || false
       @types = Array(options.delete(:types) || options.delete(:type))
+      @description = options.delete(:description) || options.delete(:desc)
 
       @name = name.to_sym
       @options = options
@@ -238,13 +250,22 @@ module CMDx
     # @return [Hash] A hash representation of the attribute
     #
     # @example
-    #   attribute.to_h # => { name: :user_id, method_name: :user_id, required: true, types: [:integer], options: {}, children: [] }
+    #   attribute.to_h # => {
+    #   name: :user_id,
+    #   method_name: :current_user_id,
+    #   description: "The user's name",
+    #   required: true,
+    #   types: [:integer],
+    #   options: {},
+    #   children: []
+    # }
     #
     # @rbs () -> Hash[Symbol, untyped]
     def to_h
       {
         name: name,
         method_name: method_name,
+        description: description,
         required: required?,
         types: types,
         options: options.except(:if, :unless),

data/lib/cmdx/{exceptions.rb → exception.rb}

@@ -7,7 +7,7 @@ module CMDx
   # This serves as the root exception class for all errors raised by the CMDx
   # framework. It inherits from StandardError and provides a common base for
   # handling CMDx-specific exceptions.
-  Error = Class.new(StandardError)
+  Exception = Error = Class.new(StandardError)
 
   # Raised when attribute coercion fails during task execution.
   #

data/lib/cmdx/validator_registry.rb

@@ -29,6 +29,7 @@ module CMDx
     # @rbs (?Hash[Symbol, Class]? registry) -> void
     def initialize(registry = nil)
       @registry = registry || {
+        absence: Validators::Absence,
         exclusion: Validators::Exclusion,
         format: Validators::Format,
         inclusion: Validators::Inclusion,

data/lib/cmdx/validators/absence.rb

@@ -0,0 +1,61 @@
+# frozen_string_literal: true
+
+module CMDx
+  module Validators
+    # Validates that a value is absent or empty
+    #
+    # This validator ensures that the given value is nil, empty, or consists only of whitespace.
+    # It handles different value types appropriately:
+    # - Strings: checks for absence of non-whitespace characters
+    # - Collections: checks for empty collections
+    # - Other objects: checks for nil values
+    module Absence
+
+      extend self
+
+      # Validates that a value is absent or empty
+      #
+      # @param value [Object] The value to validate for absence
+      # @param options [Hash] Validation configuration options
+      # @option options [String] :message Custom error message
+      #
+      # @return [nil] Returns nil if validation passes
+      #
+      # @raise [ValidationError] When the value is present, not empty, or contains non-whitespace characters
+      #
+      # @example Validate string absence
+      #   Absence.call("")
+      #   # => nil (validation passes)
+      # @example Validate non-empty string
+      #   Absence.call("hello")
+      #   # => raises ValidationError
+      # @example Validate array absence
+      #   Absence.call([])
+      #   # => nil (validation passes)
+      # @example Validate non-empty array
+      #   Absence.call([1, 2, 3])
+      #   # => raises ValidationError
+      # @example Validate with custom message
+      #   Absence.call("hello", message: "Value must be empty")
+      #   # => raises ValidationError with custom message
+      #
+      # @rbs (untyped value, ?Hash[Symbol, untyped] options) -> nil
+      def call(value, options = {})
+        match =
+          if value.is_a?(String)
+            /\S/.match?(value)
+          elsif value.respond_to?(:empty?)
+            !value.empty?
+          else
+            !value.nil?
+          end
+
+        return unless match
+
+        message = options[:message] if options.is_a?(Hash)
+        raise ValidationError, message || Locale.t("cmdx.validators.absence")
+      end
+
+    end
+  end
+end

data/lib/cmdx/version.rb

@@ -5,6 +5,6 @@ module CMDx
   # @return [String] the version of the CMDx gem
   #
   # @rbs return: String
-  VERSION = "1.14.0"
+  VERSION = "1.16.0"
 
 end

data/lib/cmdx.rb

@@ -35,8 +35,8 @@ end
 loader = Zeitwerk::Loader.for_gem
 loader.inflector.inflect("cmdx" => "CMDx", "json" => "JSON")
 loader.ignore("#{__dir__}/cmdx/configuration")
-loader.ignore("#{__dir__}/cmdx/exceptions")
-loader.ignore("#{__dir__}/cmdx/faults")
+loader.ignore("#{__dir__}/cmdx/exception")
+loader.ignore("#{__dir__}/cmdx/fault")
 loader.ignore("#{__dir__}/cmdx/railtie")
 loader.ignore("#{__dir__}/generators")
 loader.ignore("#{__dir__}/locales")
@@ -48,11 +48,11 @@ require_relative "cmdx/configuration"
 
 # Pre-load exceptions to make them available at the top level
 # This ensures CMDx::Error and its descendants are always available
-require_relative "cmdx/exceptions"
+require_relative "cmdx/exception"
 
 # Pre-load fault classes to make them available at the top level
 # This ensures CMDx::FailFault and CMDx::SkipFault are always available
-require_relative "cmdx/faults"
+require_relative "cmdx/fault"
 
 # Conditionally load Rails components if Rails is available
 if defined?(Rails::Generators)

data/lib/locales/af.yml

@@ -26,6 +26,7 @@ af:
       symbol: "simbool"
       time: "tyd"
     validators:
+      absence: "moet leeg wees"
       exclusion:
         of: "moet nie een van wees nie: %{values}"
         within: "moet nie binne %{min} en %{max} wees nie"

data/lib/locales/ar.yml

@@ -26,6 +26,7 @@ ar:
       symbol: "رمز"
       time: "الوقت"
     validators:
+      absence: "يجب أن يكون فارغاً"
       exclusion:
         of: "يجب ألا يكون واحداً من: %{values}"
         within: "يجب ألا يكون بين %{min} و %{max}"

data/lib/locales/az.yml

@@ -26,6 +26,7 @@ az:
       symbol: "simvol"
       time: "vaxt"
     validators:
+      absence: "boş olmalıdır"
       exclusion:
         of: "aşağıdakılardan biri ola bilməz: %{values}"
         within: "%{min} və %{max} arasında ola bilməz"

data/lib/locales/be.yml

@@ -26,6 +26,7 @@ be:
       symbol: "сімвал"
       time: "час"
     validators:
+      absence: "павінна быць пустым"
       exclusion:
         of: "не можа быць адным з: %{values}"
         within: "не можа быць паміж %{min} і %{max}"

data/lib/locales/bg.yml

@@ -26,6 +26,7 @@ bg:
       symbol: "символ"
       time: "час"
     validators:
+      absence: "трябва да бъде празно"
       exclusion:
         of: "не може да бъде един от: %{values}"
         within: "не може да бъде между %{min} и %{max}"

data/lib/locales/bn.yml

@@ -26,6 +26,7 @@ bn:
       symbol: "প্রতীক"
       time: "সময়"
     validators:
+      absence: "খালি হতে হবে"
       exclusion:
         of: "নিম্নলিখিতগুলির মধ্যে একটি হতে পারবে না: %{values}"
         within: "%{min} এবং %{max} এর মধ্যে থাকতে পারবে না"

data/lib/locales/bs.yml

@@ -26,6 +26,7 @@ bs:
       symbol: "simbol"
       time: "vrijeme"
     validators:
+      absence: "mora biti prazno"
       exclusion:
         of: "ne smije biti jedan od: %{values}"
         within: "ne smije biti između %{min} i %{max}"

data/lib/locales/ca.yml

@@ -26,6 +26,7 @@ ca:
       symbol: "símbol"
       time: "temps"
     validators:
+      absence: "ha d'estar buit"
       exclusion:
         of: "no ha de ser un de: %{values}"
         within: "no ha d'estar entre %{min} i %{max}"

data/lib/locales/cnr.yml

@@ -26,6 +26,7 @@ cnr:
       symbol: "simbol"
       time: "vrijeme"
     validators:
+      absence: "mora biti prazan"
       exclusion:
         of: "ne smije biti jedan od: %{values}"
         within: "ne smije biti između %{min} i %{max}"

data/lib/locales/cs.yml

@@ -26,6 +26,7 @@ cs:
       symbol: "symbol"
       time: "čas"
     validators:
+      absence: "musí být prázdné"
       exclusion:
         of: "nesmí být jedním z: %{values}"
         within: "nesmí být mezi %{min} a %{max}"

data/lib/locales/cy.yml

@@ -26,6 +26,7 @@ cy:
       symbol: "symbol"
       time: "amser"
     validators:
+      absence: "rhaid iddo fod yn wag"
       exclusion:
         of: "ni all fod yn un o: %{values}"
         within: "ni all fod rhwng %{min} a %{max}"

data/lib/locales/da.yml

@@ -26,6 +26,7 @@ da:
       symbol: "symbol"
       time: "tid"
     validators:
+      absence: "skal være tom"
       exclusion:
         of: "må ikke være en af: %{values}"
         within: "må ikke være mellem %{min} og %{max}"

data/lib/locales/de.yml

@@ -26,6 +26,7 @@ de:
       symbol: "Symbol"
       time: "Zeit"
     validators:
+      absence: "muss leer sein"
       exclusion:
         of: "darf nicht einer von sein: %{values}"
         within: "darf nicht zwischen %{min} und %{max} liegen"

data/lib/locales/dz.yml

@@ -26,6 +26,7 @@ dz:
       symbol: "མཚན་མ།"
       time: "དུས་ཚིགས།"
     validators:
+      absence: "སྟོང་པོ་ཆོག་པ་ཆེད་དགོས།"
       exclusion:
         of: "འདི་ཚོའི་ནང་ནས་གཅིག་མི་ཆོག %{values}"
         within: "%{min} དང་ %{max} ཡབ་ཡུམ་ནས་མི་ཆོག"

data/lib/locales/el.yml

@@ -26,6 +26,7 @@ el:
       symbol: "σύμβολο"
       time: "ώρα"
     validators:
+      absence: "πρέπει να είναι κενό"
       exclusion:
         of: "δεν πρέπει να είναι ένα από: %{values}"
         within: "δεν πρέπει να είναι μεταξύ %{min} και %{max}"

data/lib/locales/en.yml

@@ -26,6 +26,7 @@ en:
       symbol: "symbol"
       time: "time"
     validators:
+      absence: "must be empty"
       exclusion:
         of: "must not be one of: %{values}"
         within: "must not be within %{min} and %{max}"

data/lib/locales/eo.yml

@@ -26,6 +26,7 @@ eo:
       symbol: "simbolo"
       time: "tempo"
     validators:
+      absence: "devas esti malplena"
       exclusion:
         of: "ne devas esti unu el: %{values}"
         within: "ne devas esti inter %{min} kaj %{max}"

data/lib/locales/es.yml

@@ -26,6 +26,7 @@ es:
       symbol: "símbolo"
       time: "tiempo"
     validators:
+      absence: "debe estar vacío"
       exclusion:
         of: "no debe ser uno de: %{values}"
         within: "no debe estar dentro de %{min} y %{max}"

data/lib/locales/et.yml

@@ -26,6 +26,7 @@ et:
       symbol: "sümbol"
       time: "aeg"
     validators:
+      absence: "peab olema tühi"
       exclusion:
         of: "ei tohi olla üks järgmistest: %{values}"
         within: "ei tohi olla %{min} ja %{max} vahel"

data/lib/locales/eu.yml

@@ -26,6 +26,7 @@ eu:
       symbol: "ikurra"
       time: "ordua"
     validators:
+      absence: "hutsik izan behar du"
       exclusion:
         of: "ezin da honetako bat izan: %{values}"
         within: "ezin da %{min} eta %{max} artean izan"

data/lib/locales/fa.yml

@@ -26,6 +26,7 @@ fa:
       symbol: "نماد"
       time: "زمان"
     validators:
+      absence: "باید خالی باشد"
       exclusion:
         of: "نباید یکی از اینها باشد: %{values}"
         within: "نباید بین %{min} و %{max} باشد"

data/lib/locales/fi.yml

@@ -26,6 +26,7 @@ fi:
       symbol: "symboli"
       time: "aika"
     validators:
+      absence: "täytyy olla tyhjä"
       exclusion:
         of: "ei saa olla yksi seuraavista: %{values}"
         within: "ei saa olla välillä %{min} ja %{max}"

data/lib/locales/fr.yml

@@ -26,6 +26,7 @@ fr:
       symbol: "symbole"
       time: "heure"
     validators:
+      absence: "doit être vide"
       exclusion:
         of: "ne doit pas être l'un de : %{values}"
         within: "ne doit pas être dans %{min} et %{max}"

data/lib/locales/fy.yml

@@ -26,6 +26,7 @@ fy:
       symbol: "symboal"
       time: "tiid"
     validators:
+      absence: "moat leech wêze"
       exclusion:
         of: "moat net ien fan wêze: %{values}"
         within: "moat net binnen %{min} en %{max} wêze"

data/lib/locales/gd.yml

@@ -26,6 +26,7 @@ gd:
       symbol: "samhla"
       time: "àm"
     validators:
+      absence: "feumaidh e a bhith falamh"
       exclusion:
         of: "chan fhaod a bhith aon de: %{values}"
         within: "chan fhaod a bhith taobh a-staigh %{min} agus %{max}"

data/lib/locales/gl.yml

@@ -26,6 +26,7 @@ gl:
       symbol: "símbolo"
       time: "tempo"
     validators:
+      absence: "debe estar baleiro"
       exclusion:
         of: "non debe ser un de: %{values}"
         within: "non debe estar entre %{min} e %{max}"

data/lib/locales/he.yml

@@ -26,6 +26,7 @@ he:
       symbol: "סמל"
       time: "זמן"
     validators:
+      absence: "חייב להיות ריק"
       exclusion:
         of: "לא יכול להיות אחד מ: %{values}"
         within: "לא יכול להיות בין %{min} ו-%{max}"

data/lib/locales/hi.yml

@@ -26,6 +26,7 @@ hi:
       symbol: "प्रतीक"
       time: "समय"
     validators:
+      absence: "खाली होना चाहिए"
       exclusion:
         of: "निम्नलिखित में से कोई नहीं होना चाहिए: %{values}"
         within: "%{min} और %{max} के बीच नहीं होना चाहिए"

data/lib/locales/hr.yml

@@ -26,6 +26,7 @@ hr:
       symbol: "simbol"
       time: "vrijeme"
     validators:
+      absence: "mora biti prazno"
       exclusion:
         of: "ne smije biti jedan od: %{values}"
         within: "ne smije biti između %{min} i %{max}"

data/lib/locales/hu.yml

@@ -26,6 +26,7 @@ hu:
       symbol: "szimbólum"
       time: "idő"
     validators:
+      absence: "üresnek kell lennie"
       exclusion:
         of: "nem lehet egyike a következőknek: %{values}"
         within: "nem lehet %{min} és %{max} között"

data/lib/locales/hy.yml

@@ -26,6 +26,7 @@ hy:
       symbol: "սիմվոլ"
       time: "ժամանակ"
     validators:
+      absence: "պdelays delays delays delays delays է delays delaysdelays delays delays delays"
       exclusion:
         of: "չի կարող լինել հետևյալներից մեկը: %{values}"
         within: "չի կարող լինել %{min} և %{max} միջև"

data/lib/locales/id.yml

@@ -26,6 +26,7 @@ id:
       symbol: "simbol"
       time: "waktu"
     validators:
+      absence: "harus kosong"
       exclusion:
         of: "tidak boleh salah satu dari: %{values}"
         within: "tidak boleh di antara %{min} dan %{max}"

data/lib/locales/is.yml

@@ -26,6 +26,7 @@ is:
       symbol: "tákn"
       time: "tími"
     validators:
+      absence: "verður að vera tómt"
       exclusion:
         of: "má ekki vera einn af: %{values}"
         within: "má ekki vera á milli %{min} og %{max}"

data/lib/locales/it.yml

@@ -26,6 +26,7 @@ it:
       symbol: "simbolo"
       time: "tempo"
     validators:
+      absence: "deve essere vuoto"
       exclusion:
         of: "non deve essere uno di: %{values}"
         within: "non deve essere tra %{min} e %{max}"

data/lib/locales/ja.yml

@@ -26,6 +26,7 @@ ja:
       symbol: "シンボル"
       time: "時刻"
     validators:
+      absence: "空でなければなりません"
       exclusion:
         of: "次のいずれかであってはなりません: %{values}"
         within: "%{min} と %{max} の間であってはなりません"

data/lib/locales/ka.yml

@@ -26,6 +26,7 @@ ka:
       symbol: "სიმბოლო"
       time: "დრო"
     validators:
+      absence: "უნდა იყოს ცარიელი"
       exclusion:
         of: "არ უნდა იყოს ერთ-ერთი: %{values}"
         within: "არ უნდა იყოს %{min} და %{max} შორის"

data/lib/locales/kk.yml

@@ -26,6 +26,7 @@ kk:
       symbol: "символ"
       time: "уақыт"
     validators:
+      absence: "бос болуы керек"
       exclusion:
         of: "бұлардың бірі болмасын: %{values}"
         within: "%{min} және %{max} арасында болмасын"

data/lib/locales/km.yml

@@ -26,6 +26,7 @@ km:
       symbol: "និមិត្តសញ្ញា"
       time: "ពេលវេលា"
     validators:
+      absence: "ត្រូវតែទទេរ"
       exclusion:
         of: "មិនត្រូវតែជាមួយក្នុងចំណោម: %{values} ទេ"
         within: "មិនត្រូវតែនៅចន្លោះ %{min} និង %{max} ទេ"

data/lib/locales/kn.yml

@@ -26,6 +26,7 @@ kn:
       symbol: "ಚಿಹ್ನೆ"
       time: "ಸಮಯ"
     validators:
+      absence: "ಖಾಲಿಯಾಗಿರಬೇಕು"
       exclusion:
         of: "ಈ ಕೆಳಗಿನವುಗಳಲ್ಲಿ ಒಂದಾಗಿರಬಾರದು: %{values}"
         within: "%{min} ಮತ್ತು %{max} ನಡುವೆ ಇರಬಾರದು"

data/lib/locales/ko.yml

@@ -26,6 +26,7 @@ ko:
       symbol: "심볼"
       time: "시간"
     validators:
+      absence: "비어있어야 합니다"
       exclusion:
         of: "다음 중 하나가 아니어야 합니다: %{values}"
         within: "%{min}과 %{max} 사이에 있으면 안 됩니다"

data/lib/locales/lb.yml

@@ -26,6 +26,7 @@ lb:
       symbol: "Symbol"
       time: "Zäit"
     validators:
+      absence: "muss eidel sinn"
       exclusion:
         of: "däerf net ee vun dësen sinn: %{values}"
         within: "däerf net tëscht %{min} an %{max} sinn"

data/lib/locales/lo.yml

@@ -26,6 +26,7 @@ lo:
       symbol: "ສັນຍະລັກ"
       time: "ເວລາ"
     validators:
+      absence: "ຕ້ອງເປັນຄ່າວ່າງ"
       exclusion:
         of: "ບໍ່ຕ້ອງເປັນອັນໃດອັນໜຶ່ງໃນ: %{values}"
         within: "ບໍ່ຕ້ອງຢູ່ໃນຊ່ວງ %{min} ແລະ %{max}"

data/lib/locales/lt.yml

@@ -26,6 +26,7 @@ lt:
       symbol: "simbolis"
       time: "laikas"
     validators:
+      absence: "turi būti tuščias"
       exclusion:
         of: "neturi būti vienas iš: %{values}"
         within: "neturi būti tarp %{min} ir %{max}"

data/lib/locales/lv.yml

@@ -26,6 +26,7 @@ lv:
       symbol: "simbols"
       time: "laiks"
     validators:
+      absence: "jābūt tukšam"
       exclusion:
         of: "nedrīkst būt viens no: %{values}"
         within: "nedrīkst būt starp %{min} un %{max}"

data/lib/locales/mg.yml

@@ -26,6 +26,7 @@ mg:
       symbol: "mariky"
       time: "ora"
     validators:
+      absence: "tsy maintsy ho banga"
       exclusion:
         of: "tsy maintsy ho iray amin'ireo: %{values}"
         within: "tsy maintsy ho eo anelanelan'ny %{min} sy %{max}"

data/lib/locales/mk.yml

@@ -26,6 +26,7 @@ mk:
       symbol: "симбол"
       time: "време"
     validators:
+      absence: "мора да биде празно"
       exclusion:
         of: "не смее да биде еден од: %{values}"
         within: "не смее да биде помеѓу %{min} и %{max}"

data/lib/locales/ml.yml

@@ -26,6 +26,7 @@ ml:
       symbol: "ചിഹ്നം"
       time: "സമയം"
     validators:
+      absence: "ശൂന്യമായിരിക്കണം"
       exclusion:
         of: "ഇനിപ്പറയുന്നവയിൽ ഒന്നാകാൻ പാടില്ല: %{values}"
         within: "%{min} ഉം %{max} ഉം തമ്മിൽ ആകാൻ പാടില്ല"

data/lib/locales/mn.yml

@@ -26,6 +26,7 @@ mn:
       symbol: "тэмдэг"
       time: "цаг"
     validators:
+      absence: "хоосон байх ёстой"
       exclusion:
         of: "дараах зүйлсийн аль нэг байж болохгүй: %{values}"
         within: "%{min} ба %{max} хооронд байж болохгүй"

data/lib/locales/mr-IN.yml

@@ -26,6 +26,7 @@ mr-IN:
       symbol: "चिन्ह"
       time: "वेळ"
     validators:
+      absence: "रिक्त असणे आवश्यक आहे"
       exclusion:
         of: "खालीलपैकी एक असू शकत नाही: %{values}"
         within: "%{min} आणि %{max} दरम्यान असू शकत नाही"

data/lib/locales/ms.yml

@@ -26,6 +26,7 @@ ms:
       symbol: "simbol"
       time: "masa"
     validators:
+      absence: "mesti kosong"
       exclusion:
         of: "tidak boleh menjadi salah satu daripada: %{values}"
         within: "tidak boleh berada di antara %{min} dan %{max}"

data/lib/locales/nb.yml

@@ -26,6 +26,7 @@ nb:
       symbol: "symbol"
       time: "tid"
     validators:
+      absence: "må være tom"
       exclusion:
         of: "må ikke være en av: %{values}"
         within: "må ikke være mellom %{min} og %{max}"

data/lib/locales/ne.yml

@@ -26,6 +26,7 @@ ne:
       symbol: "प्रतीक"
       time: "समय"
     validators:
+      absence: "खाली हुनुपर्छ"
       exclusion:
         of: "निम्न मध्ये एउटा हुन सक्दैन: %{values}"
         within: "%{min} र %{max} बीचमा हुन सक्दैन"

data/lib/locales/nl.yml

@@ -26,6 +26,7 @@ nl:
       symbol: "symbool"
       time: "tijd"
     validators:
+      absence: "moet leeg zijn"
       exclusion:
         of: "mag niet een van zijn: %{values}"
         within: "mag niet tussen %{min} en %{max} liggen"

data/lib/locales/nn.yml

@@ -26,6 +26,7 @@ nn:
       symbol: "symbol"
       time: "tid"
     validators:
+      absence: "må vere tom"
       exclusion:
         of: "må ikkje vere ein av: %{values}"
         within: "må ikkje vere innanfor %{min} og %{max}"

data/lib/locales/oc.yml

@@ -26,6 +26,7 @@ oc:
       symbol: "simbol"
       time: "ora"
     validators:
+      absence: "deu èsser void"
       exclusion:
         of: "deu pas èsser un de: %{values}"
         within: "deu pas èsser entre %{min} e %{max}"

data/lib/locales/or.yml

@@ -26,6 +26,7 @@ or:
       symbol: "ପ୍ରତୀକ"
       time: "ସମୟ"
     validators:
+      absence: "ଖାଲି ହୋଇଥିବା ଆବଶ୍ୟକ"
       exclusion:
         of: "ନିମ୍ନଲିଖିତ ମଧ୍ୟରୁ ଗୋଟିଏ ହୋଇପାରିବ ନାହିଁ: %{values}"
         within: "%{min} ଏବଂ %{max} ମଧ୍ୟରେ ହୋଇପାରିବ ନାହିଁ"

data/lib/locales/pa.yml

@@ -26,6 +26,7 @@ pa:
       symbol: "ਚਿੰਨ੍ਹ"
       time: "ਸਮਾਂ"
     validators:
+      absence: "ਖਾਲੀ ਹੋਣਾ ਚਾਹੀਦਾ ਹੈ"
       exclusion:
         of: "ਹੇਠਾਂ ਦਿੱਤੇ ਗਏ ਵਿੱਚੋਂ ਕੋਈ ਇੱਕ ਨਹੀਂ ਹੋ ਸਕਦਾ: %{values}"
         within: "%{min} ਅਤੇ %{max} ਦੇ ਵਿਚਕਾਰ ਨਹੀਂ ਹੋ ਸਕਦਾ"

data/lib/locales/pl.yml

@@ -26,6 +26,7 @@ pl:
       symbol: "symbol"
       time: "czas"
     validators:
+      absence: "musi być puste"
       exclusion:
         of: "nie może być jednym z: %{values}"
         within: "nie może być między %{min} a %{max}"

data/lib/locales/pt.yml

@@ -26,6 +26,7 @@ pt:
       symbol: "símbolo"
       time: "tempo"
     validators:
+      absence: "deve estar vazio"
       exclusion:
         of: "não deve ser um de: %{values}"
         within: "não deve estar entre %{min} e %{max}"

data/lib/locales/rm.yml

@@ -26,6 +26,7 @@ rm:
       symbol: "simbol"
       time: "ura"
     validators:
+      absence: "stoscha esser vid"
       exclusion:
         of: "na dastga betg esser in da: %{values}"
         within: "na dastga betg esser tranter %{min} e %{max}"

data/lib/locales/ro.yml

@@ -26,6 +26,7 @@ ro:
       symbol: "simbol"
       time: "timp"
     validators:
+      absence: "trebuie să fie gol"
       exclusion:
         of: "nu trebuie să fie unul din: %{values}"
         within: "nu trebuie să fie între %{min} și %{max}"

data/lib/locales/ru.yml

@@ -26,6 +26,7 @@ ru:
       symbol: "символ"
       time: "время"
     validators:
+      absence: "должен быть пустым"
       exclusion:
         of: "не должен быть одним из: %{values}"
         within: "не должен быть между %{min} и %{max}"

data/lib/locales/sc.yml

@@ -26,6 +26,7 @@ sc:
       symbol: "sìmbulu"
       time: "ora"
     validators:
+      absence: "deve èssere bòidu"
       exclusion:
         of: "non deve èssere unu de: %{values}"
         within: "non deve èssere intre %{min} e %{max}"

data/lib/locales/sk.yml

@@ -26,6 +26,7 @@ sk:
       symbol: "symbol"
       time: "čas"
     validators:
+      absence: "musí byť prázdne"
       exclusion:
         of: "nesmie byť jedným z: %{values}"
         within: "nesmie byť medzi %{min} a %{max}"

data/lib/locales/sl.yml

@@ -26,6 +26,7 @@ sl:
       symbol: "simbol"
       time: "čas"
     validators:
+      absence: "mora biti prazno"
       exclusion:
         of: "ne sme biti eden od: %{values}"
         within: "ne sme biti med %{min} in %{max}"

data/lib/locales/sq.yml

@@ -26,6 +26,7 @@ sq:
       symbol: "simbol"
       time: "koha"
     validators:
+      absence: "duhet të jetë bosh"
       exclusion:
         of: "nuk duhet të jetë një nga: %{values}"
         within: "nuk duhet të jetë mes %{min} dhe %{max}"

data/lib/locales/sr.yml

@@ -26,6 +26,7 @@ sr:
       symbol: "симбол"
       time: "време"
     validators:
+      absence: "мора бити празно"
       exclusion:
         of: "не сме бити један од: %{values}"
         within: "не сме бити између %{min} и %{max}"

data/lib/locales/st.yml

@@ -26,6 +26,7 @@ st:
       symbol: "mokhoa"
       time: "nako"
     validators:
+      absence: "e tlameha ho ba e se na letho"
       exclusion:
         of: "ha e tlameha ho ba e mong oa: %{values}"
         within: "ha e tlameha ho ba pakeng tsa %{min} le %{max}"

data/lib/locales/sv.yml

@@ -26,6 +26,7 @@ sv:
       symbol: "symbol"
       time: "tid"
     validators:
+      absence: "måste vara tom"
       exclusion:
         of: "får inte vara en av: %{values}"
         within: "får inte vara mellan %{min} och %{max}"

data/lib/locales/sw.yml

@@ -26,6 +26,7 @@ sw:
       symbol: "ishara"
       time: "wakati"
     validators:
+      absence: "lazima iwe tupu"
       exclusion:
         of: "haipaswi kuwa moja ya: %{values}"
         within: "haipaswi kuwa kati ya %{min} na %{max}"

data/lib/locales/ta.yml

@@ -26,6 +26,7 @@ ta:
       symbol: "குறியீடு"
       time: "நேரம்"
     validators:
+      absence: "வெறுமையாக இருக்க வேண்டும்"
       exclusion:
         of: "பின்வருவனவற்றில் ஒன்றாக இருக்கக்கூடாது: %{values}"
         within: "%{min} மற்றும் %{max} இடையே இருக்கக்கூடாது"

data/lib/locales/te.yml

@@ -26,6 +26,7 @@ te:
       symbol: "చిహ్నం"
       time: "సమయం"
     validators:
+      absence: "ఖాళీగా ఉండాలి"
       exclusion:
         of: "ఈ క్రింది వాటిలో ఒకటి కాకూడదు: %{values}"
         within: "%{min} మరియు %{max} మధ్య ఉండకూడదు"

data/lib/locales/th.yml

@@ -26,6 +26,7 @@ th:
       symbol: "สัญลักษณ์"
       time: "เวลา"
     validators:
+      absence: "ต้องเป็นค่าว่าง"
       exclusion:
         of: "ต้องไม่ใช่หนึ่งใน: %{values}"
         within: "ต้องไม่อยู่ระหว่าง %{min} และ %{max}"

data/lib/locales/tl.yml

@@ -26,6 +26,7 @@ tl:
       symbol: "symbol"
       time: "oras"
     validators:
+      absence: "dapat na walang laman"
       exclusion:
         of: "hindi dapat na isa sa: %{values}"
         within: "hindi dapat na nasa pagitan ng %{min} at %{max}"

data/lib/locales/tr.yml

@@ -26,6 +26,7 @@ tr:
       symbol: "sembol"
       time: "zaman"
     validators:
+      absence: "boş olmalıdır"
       exclusion:
         of: "şunlardan biri olmamalıdır: %{values}"
         within: "%{min} ve %{max} arasında olmamalıdır"

data/lib/locales/tt.yml

@@ -26,6 +26,7 @@ tt:
       symbol: "символ"
       time: "вакыт"
     validators:
+      absence: "буш булырга тиеш"
       exclusion:
         of: "боларның берсе булмасын: %{values}"
         within: "%{min} һәм %{max} арасында булмасын"

data/lib/locales/ug.yml

@@ -26,6 +26,7 @@ ug:
       symbol: "بەلگە"
       time: "ۋاقىت"
     validators:
+      absence: "بوش بولۇشى كېرەك"
       exclusion:
         of: "بۇلارنىڭ بىرى بولماسلىقى كېرەك: %{values}"
         within: "%{min} ۋە %{max} ئارىسىدا بولماسلىقى كېرەك"

data/lib/locales/uk.yml

@@ -26,6 +26,7 @@ uk:
       symbol: "символ"
       time: "час"
     validators:
+      absence: "має бути порожнім"
       exclusion:
         of: "не може бути одним з: %{values}"
         within: "не може бути між %{min} та %{max}"

data/lib/locales/ur.yml

@@ -26,6 +26,7 @@ ur:
       symbol: "علامت"
       time: "وقت"
     validators:
+      absence: "خالی ہونا ضروری ہے"
       exclusion:
         of: "ان میں سے کوئی ایک نہیں ہونا چاہیے: %{values}"
         within: "%{min} اور %{max} کے درمیان نہیں ہونا چاہیے"

data/lib/locales/uz.yml

@@ -26,6 +26,7 @@ uz:
       symbol: "belgi"
       time: "vaqt"
     validators:
+      absence: "bo'sh bo'lishi kerak"
       exclusion:
         of: "bularning biri bo'lmasligi kerak: %{values}"
         within: "%{min} va %{max} oralig'ida bo'lmasligi kerak"

data/lib/locales/vi.yml

@@ -26,6 +26,7 @@ vi:
       symbol: "ký hiệu"
       time: "thời gian"
     validators:
+      absence: "phải để trống"
       exclusion:
         of: "không được là một trong: %{values}"
         within: "không được nằm giữa %{min} và %{max}"

data/lib/locales/wo.yml

@@ -26,6 +26,7 @@ wo:
       symbol: "simbol"
       time: "jamono"
     validators:
+      absence: "dafa war a nekk lu nekk"
       exclusion:
         of: "duñu war a nekk benn ci: %{values}"
         within: "duñu war a nekk ci digg %{min} ak %{max}"

data/lib/locales/zh-CN.yml

@@ -26,6 +26,7 @@ zh-CN:
       symbol: "符号"
       time: "时间"
     validators:
+      absence: "必须为空"
       exclusion:
         of: "不能是以下之一: %{values}"
         within: "不能在 %{min} 和 %{max} 之间"

data/lib/locales/zh-HK.yml

@@ -26,6 +26,7 @@ zh-HK:
       symbol: "符號"
       time: "時間"
     validators:
+      absence: "必須是空白"
       exclusion:
         of: "不可以是其中一個：%{values}"
         within: "不可以在 %{min} 和 %{max} 之間"

data/lib/locales/zh-TW.yml

@@ -26,6 +26,7 @@ zh-TW:
       symbol: "符號"
       time: "時間"
     validators:
+      absence: "必須是空白"
       exclusion:
         of: "不可以是其中一個：%{values}"
         within: "不可以在 %{min} 和 %{max} 之間"

data/lib/locales/zh-YUE.yml

@@ -26,6 +26,7 @@ zh-YUE:
       symbol: "符號"
       time: "時間"
     validators:
+      absence: "必須係空白"
       exclusion:
         of: "唔可以係其中一個：%{values}"
         within: "唔可以喺 %{min} 同 %{max} 之間"

data/mkdocs.yml

@@ -11,6 +11,7 @@ copyright: Drexed, Inc. © 2025 - EoT
 
 theme:
   name: material
+  custom_dir: docs/overrides
   logo: assets/favicon.svg
   favicon: assets/favicon.ico
   icon:
@@ -99,6 +100,7 @@ plugins:
       post_date_format: long
       post_url_format: "{slug}"
       archive_date_format: MMMM yyyy
+      draft_if_future_date: true
       categories_allowed:
         - Tutorials
         - Updates
@@ -142,9 +144,7 @@ plugins:
           - workflows.md: Composing multiple tasks into sequential pipelines with conditional execution
         More:
           - tips_and_tricks.md: Best practices, patterns, and techniques for maintainable CMDx applications
-        Ecosystem:
-          - cmdx-rspec: RSpec test matchers (https://github.com/drexed/cmdx-rspec)
-
+          - comparison.md: Comparison with other command/service object frameworks
 nav:
   - Home: index.md
   - Documentation:
@@ -180,10 +180,12 @@ nav:
       - Workflows: workflows.md
     - More:
       - Tips and Tricks: tips_and_tricks.md
+      - Comparison: comparison.md
     - References:
       - API Documentation: https://drexed.github.io/cmdx/api/index.html
       - llms.txt: https://drexed.github.io/cmdx/llms.txt
       - llms-full.txt: https://drexed.github.io/cmdx/llms-full.txt
+      - SKILL.md: https://github.com/drexed/cmdx/blob/main/docs/SKILL.md
     - Ecosystem:
       - cmdx-rspec: https://github.com/drexed/cmdx-rspec
   - Blog: blog/index.md

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: cmdx
 version: !ruby/object:Gem::Version
-  version: 1.14.0
+  version: 1.16.0
 platform: ruby
 authors:
 - Juan Gomez
@@ -121,6 +121,20 @@ dependencies:
     - - ">="
       - !ruby/object:Gem::Version
         version: '0'
+- !ruby/object:Gem::Dependency
+  name: rdoc
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
 - !ruby/object:Gem::Dependency
   name: rspec
   requirement: !ruby/object:Gem::Requirement
@@ -257,9 +271,9 @@ files:
 - lib/cmdx/context.rb
 - lib/cmdx/deprecator.rb
 - lib/cmdx/errors.rb
-- lib/cmdx/exceptions.rb
+- lib/cmdx/exception.rb
 - lib/cmdx/executor.rb
-- lib/cmdx/faults.rb
+- lib/cmdx/fault.rb
 - lib/cmdx/identifier.rb
 - lib/cmdx/locale.rb
 - lib/cmdx/log_formatters/json.rb
@@ -279,6 +293,7 @@ files:
 - lib/cmdx/utils/condition.rb
 - lib/cmdx/utils/format.rb
 - lib/cmdx/validator_registry.rb
+- lib/cmdx/validators/absence.rb
 - lib/cmdx/validators/exclusion.rb
 - lib/cmdx/validators/format.rb
 - lib/cmdx/validators/inclusion.rb
@@ -405,7 +420,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 4.0.3
+rubygems_version: 4.0.4
 specification_version: 4
 summary: CMDx is a framework for building maintainable business processes.
 test_files: []