sashite-epin 1.0.0 → 1.1.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 8d4832b1fa452d2b0c5fb78091435ee12a125efd9dcf66c68de291fdc840adf3
-  data.tar.gz: c847fd7927b983c57cf019514a2a4e798cd04a0cda2ed8ef7859a725eee418ba
+  metadata.gz: b308beb3213522cf87199c0b28e1abe7a9d767260ac6ec3ee5f9581ae1ef1bdb
+  data.tar.gz: 3c965f92446dbcf1965844e7454c3bdf1152e2c3e7a74953e974e1239ae6137a
 SHA512:
-  metadata.gz: 6b5cdff7dc99229e4e72175c284eb9af3baa94196b73923b642ec223028dde914ab9f4f4709a4f4f5c12c04ae53b70e5358864f92045c62b814f0c79c83c22e8
-  data.tar.gz: 21ebf13ebecdfc8ffa165d98788daaf6e3730d082d8fa5cdab0c8ae71da8c386673741b067231407fb5cbb45d1dd85b12b70ca859ff759b434dcf2eb1e0aa39e
+  metadata.gz: 99a9d2ec0c5834a886517746e7d50206dbb1f331043133df7f1e919a47f506d71a7d5f58798680b3d005640983ab8c22ad7e892b57a0b7df04c8a6401ee28512
+  data.tar.gz: 56d10546fb4068fc8e3ccdaf5f36de9d947b7f7cb2c3cc3a4fd8c9a9c01acfeb7258de0a833a85ddd64d4f889a49e274b045a07d73892e06d774812f0d849729

data/README.md

@@ -40,7 +40,6 @@ identifier.state                               # => :normal
 identifier.native?                             # => true
 
 # Create identifiers directly
-identifier = Sashite::Epin.identifier(:K, :first) # => #<Epin::Identifier type=:K side=:first state=:normal native=true>
 identifier = Sashite::Epin::Identifier.new(:R, :second, :enhanced, false) # => #<Epin::Identifier type=:R side=:second state=:enhanced native=false>
 
 # Validate EPIN strings
@@ -159,8 +158,8 @@ Where `<pin>` follows the PIN format: `[<state>]<letter>`
 # Native styles: first=Chess, second=Shōgi
 
 # Native pieces (no derivation suffix)
-white_king = Sashite::Epin.identifier(:K, :first)          # => "K" (Chess king)
-black_king = Sashite::Epin.identifier(:K, :second)         # => "k" (Shōgi king)
+white_king = Sashite::Epin.identifier(:K, :first, :normal, true)          # => "K" (Chess king)
+black_king = Sashite::Epin.identifier(:K, :second, :normal, true)         # => "k" (Shōgi king)
 
 # Foreign pieces (with derivation suffix)
 white_shogi_king = Sashite::Epin.identifier(:K, :first, :normal, false)   # => "K'" (Shōgi king for white)
@@ -215,7 +214,7 @@ foreign_piece.to_s                               # => "r'" (black foreign rook)
 
 - `Sashite::Epin.valid?(epin_string)` - Check if string is valid EPIN notation
 - `Sashite::Epin.parse(epin_string)` - Parse EPIN string into Identifier object
-- `Sashite::Epin.identifier(type, side, state = :normal, native = true)` - Create identifier instance directly
+- `Sashite::Epin.identifier(type, side, state, native)` - Create identifier instance directly
 
 ### Identifier Class
 
@@ -304,7 +303,7 @@ foreign_chess_king.derived?                       # => true
 ### Immutable Transformations
 ```ruby
 # All transformations return new instances
-original = Sashite::Epin.identifier(:K, :first)
+original = Sashite::Epin.identifier(:K, :first, :normal, true)
 enhanced = original.enhance
 derived = original.derive
 flipped = original.flip
@@ -357,8 +356,8 @@ end
 
 # Usage
 board = CrossStyleGameBoard.new(:chess, :shogi)
-board.place("e1", Sashite::Epin.identifier(:K, :first))               # Chess king
-board.place("e8", Sashite::Epin.identifier(:K, :second))              # Shōgi king
+board.place("e1", Sashite::Epin.identifier(:K, :first, :normal, true))  # Chess king
+board.place("e8", Sashite::Epin.identifier(:K, :second, :normal, true)) # Shōgi king
 board.place("d4", Sashite::Epin.identifier(:Q, :first, :normal, false)) # Chess queen using Shōgi style
 
 analysis = board.pieces_by_style_derivation
@@ -409,7 +408,6 @@ def can_promote_in_style?(piece, target_rank, style_rules)
 end
 
 # Usage
-chess_pawn = Sashite::Epin.identifier(:P, :first)
 shogi_pawn = Sashite::Epin.identifier(:P, :first, :normal, false)
 
 style_rules = { native: :chess, foreign: :shogi }

data/lib/sashite/epin.rb

@@ -20,7 +20,7 @@ module Sashite
   #   "+R'" - First player rook (foreign style, enhanced state)
   #   "-p"  - Second player pawn (native style, diminished state)
   #
-  # See: https://sashite.dev/specs/epin/1.0.0/
+  # @see https://sashite.dev/specs/epin/1.0.0/
   module Epin
     # Check if a string is a valid EPIN notation
     #
@@ -62,7 +62,7 @@ module Sashite
     #   Sashite::Epin.identifier(:K, :first, :normal, true)      # => #<Epin::Identifier type=:K side=:first state=:normal native=true>
     #   Sashite::Epin.identifier(:R, :first, :enhanced, false)   # => #<Epin::Identifier type=:R side=:first state=:enhanced native=false>
     #   Sashite::Epin.identifier(:P, :second, :diminished, true) # => #<Epin::Identifier type=:P side=:second state=:diminished native=true>
-    def self.identifier(type, side, state = Sashite::Pin::Identifier::NORMAL_STATE, native = Identifier::NATIVE)
+    def self.identifier(type, side, state, native)
       Identifier.new(type, side, state, native)
     end
   end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: sashite-epin
 version: !ruby/object:Gem::Version
-  version: 1.0.0
+  version: 1.1.0
 platform: ruby
 authors:
 - Cyril Kato
@@ -15,14 +15,14 @@ dependencies:
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 3.0.0
+        version: 3.1.0
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 3.0.0
+        version: 3.1.0
 description: |
   EPIN (Extended Piece Identifier Notation) extends PIN to provide style-aware piece representation
   in abstract strategy board games. This gem implements the EPIN Specification v1.0.0 with