1. Sashité for Developers
2. Specifications
3. PAN
4. 1.0.0
5. Examples

PAN Examples

Practical examples demonstrating Portable Action Notation v1.0.0 with detailed explanations of explicit and implicit effects.

---

Pass Action

Syntax

...

Description

The pass action explicitly changes the active player without altering the board state. Used when a player chooses to skip their turn (when permitted by game rules).

Example

...

• Explicit effects:
  • Active player changes from current to opponent
• Implicit effects: None
• Usage: Common in Go when no beneficial moves remain

---

Movement Actions

Simple Movement

Syntax

<source>-<destination>

Example: Pawn Advance

e2-e4

• Explicit effects:
  • Piece moves from e2 to empty square e4
  • Active player changes
• Implicit effects:
  • En passant vulnerability may be set (chess rules)
• Note: The piece is not specified; context determines it’s a pawn

Example: Knight Jump

b1-c3

• Explicit effects:
  • Piece moves from b1 to empty square c3
  • Active player changes
• Implicit effects: None
• Note: Knights jump over intervening pieces

Movement with Explicit Promotion

Syntax

<source>-<destination>=<piece>

Example: Pawn Promotion to Queen

e7-e8=Q

• Explicit effects:
  • Pawn moves from e7 to e8
  • Pawn transforms into a queen
  • Active player changes
• Implicit effects: None
• Note: The =Q explicitly specifies the promotion choice

Example: Shōgi Silver Promotion

c6-b7=+S

• Explicit effects:
  • Silver moves from c6 to b7
  • Silver becomes enhanced (promoted silver)
  • Active player changes
• Implicit effects: None
• Note: The +S indicates enhanced state in EPIN notation

---

Capture Actions

Capture with Movement

Syntax

<source>+<destination>

Example: Bishop Captures Rook

c1+f4

• Explicit effects:
  • Piece at c1 moves to f4
  • Piece at f4 is captured to active player’s reserve
  • Active player changes
• Implicit effects:
  • Captured piece may change ownership (shōgi)
• Note: The + operator indicates capture at destination

Static Capture

Syntax

+<square>

Example: Custodian Capture

+d4

• Explicit effects:
  • Piece at d4 is captured to active player’s reserve
  • Active player changes
• Implicit effects: None
• Usage: Used in games with custodian capture or area effects

---

Drop Actions

Drop to Empty Square

Syntax (Explicit Piece)

<piece>*<destination>

Example: Shōgi Pawn Drop

P*e5

• Explicit effects:
  • Pawn from reserve placed on empty square e5
  • Reserve decreases by one pawn
  • Active player changes
• Implicit effects: None
• Note: Common in shōgi where captured pieces can be dropped

Syntax (Inferred Piece)

*<destination>

Example: Contextual Drop

*d4

• Explicit effects:
  • Piece from reserve placed on d4
  • Context determines which piece (e.g., only one type in reserve)
  • Active player changes
• Implicit effects: None

Drop with Capture

Syntax

<piece>.<destination>

Example: Lance Drop with Capture

L.b4

• Explicit effects:
  • Lance from reserve placed on b4
  • Existing piece at b4 captured to active player’s reserve
  • Active player changes
• Implicit effects:
  • Captured piece may change attributes
• Usage: Rare but possible in variant games

---

In-Place Modifications

Syntax

<square>=<piece>

Example: Piece Enhancement

e4=+P

• Explicit effects:
  • Piece at e4 transforms to enhanced pawn
  • Active player changes
• Implicit effects: None
• Usage: Status changes, delayed promotions

Example: Style Conversion

c3=S'

• Explicit effects:
  • Piece at c3 adopts foreign style (opponent’s style system)
  • Active player changes
• Implicit effects: None
• Note: The ' indicates foreign style in EPIN notation

---

Complex Scenarios with Implicit Effects

Chess Castling

King-side Castling

e1-g1

• Explicit effects:
  • King moves from e1 to g1
  • Active player changes
• Implicit effects (chess rules):
  • Rook automatically moves from h1 to f1
  • Castling rights are lost
• Note: Only the king’s movement is notated; rook movement is implicit

Chess En Passant

White Captures En Passant

e5-f6

• Explicit effects:
  • Pawn moves from e5 to f6 (empty square)
  • Active player changes
• Implicit effects (chess en passant rule):
  • Black pawn at f5 is captured
• Note: The capture happens as an implicit consequence, not explicit in notation

Mandatory Promotion Zone

Shōgi Pawn Enters Promotion Zone

g8-g9

• Explicit effects:
  • Pawn moves from g8 to g9
  • Active player changes
• Implicit effects (shōgi rules):
  • Pawn automatically promotes to tokin (mandatory)
• Note: No = needed when promotion is mandatory by rules

---

Active Player Change Examples

Single Action Sequence

e2-e4  # White pawn moves, turn passes to black

• Before action: White is active player
• After action: Black is active player

Multiple Actions in a Game

e2-e4  # White → Black
e7-e5  # Black → White
g1-f3  # White → Black
b8-c6  # Black → White

Each action explicitly changes the active player, maintaining proper turn alternation.

Pass Move

...    # Current player passes, turn passes to opponent

• Before pass: Player A is active
• After pass: Player B is active

---

Key Concepts Summary

Explicit Effects

All PAN actions have these explicit effects:

1. The primary transformation (movement, capture, modification, drop, or pass)
2. Direct consequences of that transformation
3. Active player change (per Sashité Protocol)

Examples:

• Movement: piece displacement + active player change
• Capture: piece displacement + capture to reserve + active player change
• Pass: active player change only

Implicit Effects

Implicit effects are determined by game rules:

• Secondary movements (castling rook)
• Indirect captures (en passant)
• Mandatory promotions
• Status changes (losing castling rights)
• Ownership changes (shōgi captures)

Important: Active player change is NOT an implicit effect - it is always explicit per protocol.

Operator Usage

Operator	Meaning	Explicit Effects
-	Movement	Displacement + turn change
+	Capture	Displacement + capture + turn change
*	Drop	Placement + turn change
.	Drop capture	Placement + capture + turn change
=	Modification	Transformation + turn change
...	Pass	Turn change only

When to Use Each Action Type

• Use - when moving to an empty square
• Use + when capturing during movement
• Use +<square> for captures without movement
• Use * when placing from reserve
• Use . when dropping onto an occupied square
• Use = when piece attributes change
• Use ... to pass the turn

All actions change the active player as an explicit effect.

---

Implementation Notes

1. Context matters: Some notations require game context for complete interpretation
2. One action per notation: Each PAN string represents a single atomic action
3. Explicit turn change: Every action changes active player (per protocol)
4. Implicit handling: Game engines must implement implicit effects based on rules
5. EPIN integration: Piece specifications follow EPIN format for states and styles
6. Active player tracking: Implementations must update active player after each action