sashite-pin 3.2.0 → 4.0.0

data/lib/sashite/pin/constants.rb

@@ -0,0 +1,35 @@
+# frozen_string_literal: true
+
+module Sashite
+  module Pin
+    # Constants for PIN (Piece Identifier Notation).
+    #
+    # This module defines the valid values for PIN attributes.
+    module Constants
+      # Valid piece types (uppercase symbols A-Z).
+      VALID_TYPES = %i[A B C D E F G H I J K L M N O P Q R S T U V W X Y Z].freeze
+
+      # Valid player sides.
+      VALID_SIDES = %i[first second].freeze
+
+      # Valid piece states.
+      VALID_STATES = %i[normal enhanced diminished].freeze
+
+      # Maximum length of a valid PIN string.
+      # Corresponds to "+K^" (state modifier + letter + terminal marker).
+      MAX_STRING_LENGTH = 3
+
+      # State modifier for enhanced state.
+      ENHANCED_PREFIX = "+"
+
+      # State modifier for diminished state.
+      DIMINISHED_PREFIX = "-"
+
+      # Empty string (no modifier).
+      EMPTY_STRING = ""
+
+      # Terminal marker suffix.
+      TERMINAL_SUFFIX = "^"
+    end
+  end
+end

data/lib/sashite/pin/errors/argument/messages.rb

@@ -0,0 +1,28 @@
+# frozen_string_literal: true
+
+module Sashite
+  module Pin
+    module Errors
+      class Argument < ::ArgumentError
+        # Centralized error messages for PIN parsing and validation.
+        #
+        # @example
+        #   raise Errors::Argument, Messages::EMPTY_INPUT
+        module Messages
+          # Parsing errors
+          EMPTY_INPUT = "empty input"
+          INPUT_TOO_LONG = "input exceeds 3 characters"
+          MUST_CONTAIN_ONE_LETTER = "must contain exactly one letter"
+          INVALID_STATE_MODIFIER = "invalid state modifier"
+          INVALID_TERMINAL_MARKER = "invalid terminal marker"
+
+          # Validation errors (constructor)
+          INVALID_TYPE = "type must be a symbol from :A to :Z"
+          INVALID_SIDE = "side must be :first or :second"
+          INVALID_STATE = "state must be :normal, :enhanced, or :diminished"
+          INVALID_TERMINAL = "terminal must be true or false"
+        end
+      end
+    end
+  end
+end

data/lib/sashite/pin/errors/argument.rb

@@ -0,0 +1,16 @@
+# frozen_string_literal: true
+
+require_relative "argument/messages"
+
+module Sashite
+  module Pin
+    module Errors
+      # Error raised when PIN parsing or validation fails.
+      #
+      # @example
+      #   raise Argument, Argument::Messages::EMPTY_INPUT
+      class Argument < ::ArgumentError
+      end
+    end
+  end
+end

data/lib/sashite/pin/errors.rb

@@ -0,0 +1,3 @@
+# frozen_string_literal: true
+
+require_relative "errors/argument"