sashite-pin 2.0.1 → 2.0.2

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 0335d119541a7fa271689c6235a9c785a4c46f6c70e9577d4cddcc597d520dd5
-  data.tar.gz: 7d95e04c803457156561bfe0fd8e270db5df1929b58721b9ed8266646f60e7e1
+  metadata.gz: 70bbc211cb1dd38efa9f0c39b2d0e1b0fd09c2dcf2d7ac3773719ce11786a5ac
+  data.tar.gz: cd6831f22ee3e9fd8ce559f5535bbcbb1d9ca13ba9083a9d9c1fe66d41e2eef9
 SHA512:
-  metadata.gz: 6904c80bee041595400f4074ed48a975ad6337c3c5a8c66f9d18ad7864f19e23d04e34b30c725d37ce9c4bfde58667328a82bbd1c38208c123cb44a9da00b283
-  data.tar.gz: 32289d6453d81ff2e1920aeb7d69eedfac6bc61f9acdd1929e7ca4bc09c6988bb2a64bc3620130cfb63024977e0508b7c5ffce695590382eac3420d85454c67a
+  metadata.gz: d0808aac8a46423256ec3546a4eb71d5882d3535b4a74929680cd31f84294ffd406716565f53ef072ff35c5c1131bb2612ab93398001d3d80772bb34a3dc3d07
+  data.tar.gz: ba7ecb1765c03c801f014bdbb9792fcae5dacd8d119890b0c73f0e550a345a8fc307cb39a82b803c986ef7fa50f76ad5fff39c6a7bffc5fe39e1b06bebe6b809

data/README.md

@@ -204,6 +204,7 @@ crossed_soldier.to_s                              # => "+P"
 #### Creation and Parsing
 - `Sashite::Pin::Piece.new(type, side, state = :normal)` - Create piece instance
 - `Sashite::Pin::Piece.parse(pin_string)` - Parse PIN string (same as module method)
+- `Sashite::Pin::Piece.valid?(pin_string)` - Validate PIN string (class method)
 
 #### Attribute Access
 - `#type` - Get piece type (symbol :A to :Z, always uppercase)
@@ -258,7 +259,7 @@ piece2.letter  # => "k" (lowercase display)
 - `#==(other)` - Full equality comparison
 
 ### Constants
-- `Sashite::Pin::PIN_REGEX` - Regular expression for PIN validation
+- `Sashite::Pin::Piece::PIN_PATTERN` - Regular expression for PIN validation (internal use)
 
 ## Advanced Usage
 

data/lib/sashite/pin/piece.rb

@@ -106,6 +106,23 @@ module Sashite
         new(piece_type, piece_side, piece_state)
       end
 
+      # Check if a string is a valid PIN notation
+      #
+      # @param pin_string [String] The string to validate
+      # @return [Boolean] true if valid PIN, false otherwise
+      #
+      # @example
+      #   Sashite::Pin::Piece.valid?("K")    # => true
+      #   Sashite::Pin::Piece.valid?("+R")   # => true
+      #   Sashite::Pin::Piece.valid?("-p")   # => true
+      #   Sashite::Pin::Piece.valid?("KK")   # => false
+      #   Sashite::Pin::Piece.valid?("++K")  # => false
+      def self.valid?(pin_string)
+        return false unless pin_string.is_a?(::String)
+
+        pin_string.match?(PIN_PATTERN)
+      end
+
       # Convert the piece to its PIN string representation
       #
       # @return [String] PIN notation string
@@ -190,9 +207,9 @@ module Sashite
         self.class.new(type, side, NORMAL_STATE)
       end
 
-      # Create a new piece with opposite ownership (case)
+      # Create a new piece with opposite side
       #
-      # @return [Piece] new piece instance with flipped case
+      # @return [Piece] new piece instance with opposite side
       # @example
       #   piece.flip  # (:K, :first, :normal) => (:K, :second, :normal)
       def flip

data/lib/sashite/pin.rb

@@ -20,13 +20,9 @@ module Sashite
   #
   # See: https://sashite.dev/specs/pin/1.0.0/
   module Pin
-    # Regular expression for PIN validation
-    # Matches: optional state modifier followed by a single letter
-    PIN_REGEX = /\A[-+]?[A-Za-z]\z/
-
     # Check if a string is a valid PIN notation
     #
-    # @param pin [String] The string to validate
+    # @param pin_string [String] The string to validate
     # @return [Boolean] true if valid PIN, false otherwise
     #
     # @example
@@ -35,10 +31,8 @@ module Sashite
     #   Sashite::Pin.valid?("-p")   # => true
     #   Sashite::Pin.valid?("KK")   # => false
     #   Sashite::Pin.valid?("++K")  # => false
-    def self.valid?(pin)
-      return false unless pin.is_a?(::String)
-
-      pin.match?(PIN_REGEX)
+    def self.valid?(pin_string)
+      Piece.valid?(pin_string)
     end
 
     # Parse a PIN string into a Piece object

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: sashite-pin
 version: !ruby/object:Gem::Version
-  version: 2.0.1
+  version: 2.0.2
 platform: ruby
 authors:
 - Cyril Kato