smallchesslib/smallchesslib.h

#ifndef SMALLCHESSLIB_H
#define SMALLCHESSLIB_H

/**
  @file smallchesslib.h

  Small and simple single header C99 public domain chess library and engine.

  author: Miloslav Ciz (drummyfish)
  license: CC0 1.0 (public domain)
           found at https://creativecommons.org/publicdomain/zero/1.0/
           + additional waiver of all IP
  version: 0.8d

  Default notation format for this library is a coordinate one, i.e.
  
    squarefrom squareto [promotedpiece]

  e.g.: e2e4 or A2A1q

  This work's goal is to never be encumbered by any exclusive intellectual
  property rights. The work is therefore provided under CC0 1.0 + additional
  WAIVER OF ALL INTELLECTUAL PROPERTY RIGHTS that waives the rest of
  intellectual property rights not already waived by CC0 1.0. The WAIVER OF ALL
  INTELLECTUAL PROPERTY RGHTS is as follows:

  Each contributor to this work agrees that they waive any exclusive rights,
  including but not limited to copyright, patents, trademark, trade dress,
  industrial design, plant varieties and trade secrets, to any and all ideas,
  concepts, processes, discoveries, improvements and inventions conceived,
  discovered, made, designed, researched or developed by the contributor either
  solely or jointly with others, which relate to this work or result from this
  work. Should any waiver of such right be judged legally invalid or
  ineffective under applicable law, the contributor hereby grants to each
  affected person a royalty-free, non transferable, non sublicensable, non
  exclusive, irrevocable and unconditional license to this right.
*/

#include <stdint.h>

#ifndef SCL_DEBUG_AI
/** AI will print out a Newick-like tree of searched moves. */
  #define SCL_DEBUG_AI 0
#endif

/**
  Maximum number of moves a chess piece can have (a queen in the middle of the
  board).
*/
#define SCL_CHESS_PIECE_MAX_MOVES 25
#define SCL_BOARD_SQUARES 64

typedef uint8_t (*SCL_RandomFunction)(void);

#if SCL_COUNT_EVALUATED_POSITIONS
  uint32_t SCL_positionsEvaluated = 0; /**< If enabled by 
                                            SCL_COUNT_EVALUATED_POSITIONS, this
                                            will increment with every
                                            dynamically evaluated position (e.g.
                                            when AI computes its move). */
#endif

#ifndef SCL_CALL_WDT_RESET
  #define SCL_CALL_WDT_RESET 0 /**< Option that should be enabled on some
                                    Arduinos. If 1, call to watchdog timer
                                    reset will be performed during dynamic
                                    evaluation (without it if AI takes long the
                                    program will reset). */
#endif

/**
  Returns a pseudorandom byte. This function has a period 256 and returns each
  possible byte value exactly once in the period.
*/
uint8_t SCL_randomSimple(void);
void SCL_randomSimpleSeed(uint8_t seed);

/**
  Like SCL_randomSimple, but internally uses a 16 bit value, so the period is
  65536.
*/
uint8_t SCL_randomBetter(void);
void SCL_randomBetterSeed(uint16_t seed);

#ifndef SCL_EVALUATION_FUNCTION
  /**
    If defined, AI will always use the static evaluation function with this
    name. This helps avoid pointers to functions and can be faster but the
    function can't be changed at runtime.
  */
  #define SCL_EVALUATION_FUNCTION
  #undef SCL_EVALUATION_FUNCTION
#endif

#ifndef SCL_960_CASTLING
  /**
    If set, chess 960 (Fisher random) castling will be considered by the library
    rather than normal castling. 960 castling is slightly different (e.g.
    requires the inital rook positions to be stored in board state). The
    castling move is performed as "capturing own rook".
  */
  #define SCL_960_CASTLING 0
#endif

#ifndef SCL_ALPHA_BETA
  /**
    Turns alpha-beta pruning (AI optimization) on or off. This can gain
    performance and should normally be turned on. AI behavior should not
    change at all.
  */
  #define SCL_ALPHA_BETA 1
#endif

/**
  A set of game squares as a bit array, each bit representing one game square.
  Useful for representing e.g. possible moves. To easily iterate over the set
  use provided macros (SCL_SQUARE_SET_ITERATE, ...).
*/
typedef uint8_t SCL_SquareSet[8];

#define SCL_SQUARE_SET_EMPTY {0, 0, 0, 0, 0, 0, 0, 0}

void SCL_squareSetClear(SCL_SquareSet squareSet);
void SCL_squareSetAdd(SCL_SquareSet squareSet, uint8_t square);
uint8_t SCL_squareSetContains(const SCL_SquareSet squareSet, uint8_t square);
uint8_t SCL_squareSetSize(const SCL_SquareSet squareSet);
uint8_t SCL_squareSetEmpty(const SCL_SquareSet squareSet);

/**
  Returns a random square from a square set.
*/
uint8_t SCL_squareSetGetRandom(const SCL_SquareSet squareSet,
  SCL_RandomFunction randFunc);

#define SCL_SQUARE_SET_ITERATE_BEGIN(squareSet) \
  { uint8_t iteratedSquare = 0;\
    uint8_t iterationEnd = 0;\
    for (int8_t _i = 0; _i < 8 && !iterationEnd; ++_i) {\
      uint8_t _row = squareSet[_i];\
      if (_row == 0) { iteratedSquare += 8; continue; }\
      \
      for (uint8_t _j = 0; _j < 8 && !iterationEnd; ++_j) {\
        if (_row & 0x01) {
/*
  Between SCL_SQUARE_SET_ITERATE_BEGIN and _END iteratedSquare variable
  represents the next square contained in the set. To break out of the
  iteration set iterationEnd to 1.
*/

#define SCL_SQUARE_SET_ITERATE_END }\
  _row >>= 1;\
  iteratedSquare++;}\
  } /*for*/ }

#define SCL_SQUARE_SET_ITERATE(squareSet,command)\
  SCL_SQUARE_SET_ITERATE_BEGIN(squareSet)\
  { command }\
  SCL_SQUARE_SET_ITERATE_END
 
#define SCL_BOARD_STATE_SIZE 69

/**
  Represents chess board state as a string in this format:
  - First 64 characters represent the chess board (A1, B1, ... H8), each field
    can be either a piece (PRNBKQprnbkq) or empty ('.'). I.e. the state looks
    like this:

      0 (A1) RNBQKBNR 
             PPPPPPPP
             ........
             ........
             ........
             ........
             pppppppp
             rnbqkbnr 63 (H8)

  - After this more bytes follow to represent global state, these are:
    - 64: bits holding en-passant and castling related information:
      - bits 0-3 (lsb): Column of the pawn that can, in current turn, be
        taken by en-passant (0xF means no pawn can be taken this way).
      - bit 4: Whether white is not prevented from short castling by previous
        king or rook movement.
      - bit 5: Same as 4, but for long castling.
      - bit 6: Same as 4, but for black.
      - bit 7: Same as 4, but for black and long castling.
    - 65: Number saying the number of ply (half-moves) that have already been
      played, also determining whose turn it currently is.
    - 66: Move counter used in the 50 move rule, says the number of ply since
      the last pawn move or capture.
    - 67: Extra byte, left for storing additional info in variants. For normal
      chess this byte should always be 0.
    - 68: The last byte is always 0 to properly terminate the string in case
      someone tries to print it.
  - The state is designed so as to be simple and also print-friendly, i.e. you
    can simply print it with line break after 8 characters to get a human
    readable representation of the board.

  NOTE: there is a much more compact representation which however trades some
  access speed which would affect the AI performance and isn't print friendly,
  so we don't use it. In it each square takes 4 bits, using 15 out of 16
  possible values (empty square and W and B pieces including 2 types of pawns,
  one "en-passant takeable"). Then only one extra byte needed is for castling
  info (4 bits) and ply count (4 bits).
*/
typedef char SCL_Board[SCL_BOARD_STATE_SIZE];

#define SCL_BOARD_ENPASSANT_CASTLE_BYTE 64
#define SCL_BOARD_PLY_BYTE 65
#define SCL_BOARD_MOVE_COUNT_BYTE 66
#define SCL_BOARD_EXTRA_BYTE 67

#if SCL_960_CASTLING
  #define _SCL_EXTRA_BYTE_VALUE (0 | (7 << 3)) // rooks on classic positions
#else
  #define _SCL_EXTRA_BYTE_VALUE 0
#endif

#define SCL_BOARD_START_STATE \
  {82, 78, 66, 81, 75, 66, 78, 82,\
   80, 80, 80, 80, 80, 80, 80, 80,\
   46, 46, 46, 46, 46, 46, 46, 46,\
   46, 46, 46, 46, 46, 46, 46, 46,\
   46, 46, 46, 46, 46, 46, 46, 46,\
   46, 46, 46, 46, 46, 46, 46, 46,\
   112,112,112,112,112,112,112,112,\
   114,110,98, 113,107,98, 110,114,\
   (char) 0xff,0,0,_SCL_EXTRA_BYTE_VALUE,0}

#define SCL_FEN_START \
  "rnbqkbnr/pppppppp/8/8/8/8/PPPPPPPP/RNBQKBNR w KQkq - 0 1"

#define SCL_FEN_HORDE \
  "ppp2ppp/pppppppp/pppppppp/pppppppp/3pp3/8/PPPPPPPP/RNBQKBNR w KQ - 0 1"

#define SCL_FEN_UPSIDE_DOWN \
  "RNBKQBNR/PPPPPPPP/8/8/8/8/pppppppp/rnbkqbnr w - - 0 1"

#define SCL_FEN_PEASANT_REVOLT \
  "1nn1k1n1/4p3/8/8/8/8/PPPPPPPP/4K3 w - - 0 1"

#define SCL_FEN_ENDGAME \
  "4k3/pppppppp/8/8/8/8/PPPPPPPP/4K3 w - - 0 1"

#define SCL_FEN_KNIGHTS \
  "N6n/1N4n1/2N2n2/3Nn3/k2nN2K/2n2N2/1n4N1/n6N w - - 0 1"

/**
  Holds an info required to undo a single move.
*/
typedef struct
{
  uint8_t squareFrom;      ///< start square
  uint8_t squareTo;        ///< target square
  char enPassantCastle;    ///< previous en passant/castle byte
  char moveCount;          ///< previous values of the move counter byte
  uint8_t other;           /**< lowest 7 bits: previous value of target square,
                                highest bit: if 1 then the move was promotion or
                                en passant */
} SCL_MoveUndo;

#define SCL_GAME_STATE_PLAYING         0x00
#define SCL_GAME_STATE_WHITE_WIN       0x01
#define SCL_GAME_STATE_BLACK_WIN       0x02
#define SCL_GAME_STATE_DRAW            0x10 ///< further unspecified draw
#define SCL_GAME_STATE_DRAW_STALEMATE  0x11 ///< draw by stalemate
#define SCL_GAME_STATE_DRAW_REPETITION 0x12 ///< draw by repetition
#define SCL_GAME_STATE_DRAW_50         0x13 ///< draw by 50 move rule
#define SCL_GAME_STATE_DRAW_DEAD       0x14 ///< draw by dead position
#define SCL_GAME_STATE_END             0xff ///< end without known result

/**
  Converts square in common notation (e.g. 'c' 8) to square number. Only accepts
  lowercase column.
*/
#define SCL_SQUARE(colChar,rowInt) (((rowInt) - 1) * 8 + ((colChar) - 'a'))
#define SCL_S(c,r) SCL_SQUARE(c,r)

void SCL_boardInit(SCL_Board board);
void SCL_boardCopy(const SCL_Board boardFrom, SCL_Board boardTo);

/**
  Initializes given chess 960 (Fisher random) position. If SCL_960_CASTLING
  is not set, castling will be disabled by this function.
*/
void SCL_boardInit960(SCL_Board board, uint16_t positionNumber);

void SCL_boardDisableCastling(SCL_Board board);

uint32_t SCL_boardHash32(const SCL_Board board);

#define SCL_PHASE_OPENING 0
#define SCL_PHASE_MIDGAME 1
#define SCL_PHASE_ENDGAME 2

/**
  Estimates the game phase: opening, midgame or endgame.
*/
uint8_t SCL_boardEstimatePhase(SCL_Board board);

/**
  Sets the board position. The input string should be 64 characters long zero
  terminated C string representing the board as squares A1, A2, ..., H8 with
  each char being either a piece (RKBKQPrkbkqp) or an empty square ('.').
*/
void SCL_boardSetPosition(SCL_Board board, const char *pieces,
  uint8_t castlingEnPassant, uint8_t moveCount, uint8_t ply);

uint8_t SCL_boardsDiffer(SCL_Board b1, SCL_Board b2);

/**
  Gets a random move on given board for the player whose move it is.
*/
void SCL_boardRandomMove(SCL_Board board, SCL_RandomFunction randFunc,
  uint8_t *squareFrom, uint8_t *squareTo, char *resultProm);

#define SCL_FEN_MAX_LENGTH 90

/**
  Converts a position to FEN (Forsyth–Edwards Notation) string. The string has
  to have at least SCL_FEN_MAX_LENGTH bytes allocated to guarantee the
  function won't write to unallocated memory. The string will be terminated by
  0 (this is included in SCL_FEN_MAX_LENGTH). The number of bytes written
  (including the terminating 0) is returned.
*/
uint8_t SCL_boardToFEN(SCL_Board board, char *string);

/**
  Loads a board from FEN (Forsyth–Edwards Notation) string. Returns 1 on
  success, 0 otherwise. XFEN isn't supported fully but a start position in
  chess960 can be loaded with this function. 
*/
uint8_t SCL_boardFromFEN(SCL_Board board, const char *string);

/**
  Returns an approximate/heuristic board rating as a number, 0 meaning equal
  chances for both players, positive favoring white, negative favoring black.
*/
typedef int16_t (*SCL_StaticEvaluationFunction)(SCL_Board);

/* 
  NOTE: int8_t as a return value was tried for evaluation function, which would
  be simpler, but it fails to capture important non-material position
  differences counted in fractions of pawn values, hence we have to use int16_t.
*/

/**
  Basic static evaluation function. WARNING: this function supposes a standard
  chess game, for non-standard positions it may either not work well or even
  crash the program. You should use a different function for non-standard games.
*/
int16_t SCL_boardEvaluateStatic(SCL_Board board);

/**
  Dynamic evaluation function (search), i.e. unlike SCL_boardEvaluateStatic,
  this one performs a recursive search for deeper positions to get a more
  accurate score. Of course, this is much slower and hugely dependent on
  baseDepth (you mostly want to keep this under 5).
*/
int16_t SCL_boardEvaluateDynamic(SCL_Board board, uint8_t baseDepth,
  uint8_t extensionExtraDepth, SCL_StaticEvaluationFunction evalFunction);

#define SCL_EVALUATION_MAX_SCORE 32600 // don't increase this, we need a margin

/**
  Checks if the board position is dead, i.e. mate is impossible (e.g. due to
  insufficient material), which by the rules results in a draw. WARNING: This
  function may fail to detect some dead positions as this is a non-trivial task.
*/
uint8_t SCL_boardDead(SCL_Board board);

/**
  Tests whether given player is in check.
*/
uint8_t SCL_boardCheck(SCL_Board board, uint8_t white);

/**
  Checks whether given move resets the move counter (used in the 50 move rule).
*/
uint8_t SCL_boardMoveResetsCount(SCL_Board board,
  uint8_t squareFrom, uint8_t squareTo);

uint8_t SCL_boardMate(SCL_Board board);

/**
  Performs a move on a board WITHOUT checking if the move is legal. Returns an
  info with which the move can be undone.
*/
SCL_MoveUndo SCL_boardMakeMove(SCL_Board board, uint8_t squareFrom, uint8_t squareTo,
  char promotePiece);

void SCL_boardUndoMove(SCL_Board board, SCL_MoveUndo moveUndo);

/**
  Checks if the game is over, i.e. the current player to move has no legal
  moves, the game is in dead position etc.
*/
uint8_t SCL_boardGameOver(SCL_Board board);

/**
  Checks if given move is legal.
*/
uint8_t SCL_boardMoveIsLegal(SCL_Board board, uint8_t squareFrom,
  uint8_t squareTo);

/**
  Checks if the player to move has at least one legal move.
*/
uint8_t SCL_boardMovePossible(SCL_Board board);

#define SCL_POSITION_NORMAL    0x00
#define SCL_POSITION_CHECK     0x01
#define SCL_POSITION_MATE      0x02
#define SCL_POSITION_STALEMATE 0x03
#define SCL_POSITION_DEAD      0x04

uint8_t SCL_boardGetPosition(SCL_Board board);

/**
  Returns 1 if the square is attacked by player of given color. This is used to
  examine checks, so for performance reasons the functions only checks whether
  or not the square is attacked (not the number of attackers).
*/
uint8_t SCL_boardSquareAttacked(SCL_Board board, uint8_t square,
  uint8_t byWhite);

/**
  Gets pseudo moves of a piece: all possible moves WITHOUT eliminating moves
  that lead to own check. To get only legal moves use SCL_boardGetMoves.
*/
void SCL_boardGetPseudoMoves(
  SCL_Board board,
  uint8_t pieceSquare,
  uint8_t checkCastling,
  SCL_SquareSet result);

/**
  Gets all legal moves of given piece.
*/
void SCL_boardGetMoves(
  SCL_Board board,
  uint8_t pieceSquare,
  SCL_SquareSet result);

static inline uint8_t SCL_boardWhitesTurn(SCL_Board board);

static inline uint8_t SCL_pieceIsWhite(char piece); 
static inline uint8_t SCL_squareIsWhite(uint8_t square);
char SCL_pieceToColor(uint8_t piece, uint8_t toWhite);

/**
  Converts square coordinates to square number. Each coordinate must be a number
  <1,8>. Validity of the coordinates is NOT checked.
*/
static inline uint8_t SCL_coordsToSquare(uint8_t row, uint8_t column);

#ifndef SCL_VALUE_PAWN
  #define SCL_VALUE_PAWN 256
#endif

#ifndef SCL_VALUE_KNIGHT
  #define SCL_VALUE_KNIGHT 768
#endif

#ifndef SCL_VALUE_BISHOP
  #define SCL_VALUE_BISHOP 800
#endif

#ifndef SCL_VALUE_ROOK
  #define SCL_VALUE_ROOK 1280
#endif

#ifndef SCL_VALUE_QUEEN
  #define SCL_VALUE_QUEEN 2304
#endif

#ifndef SCL_VALUE_KING
  #define SCL_VALUE_KING 0
#endif

#define SCL_ENDGAME_MATERIAL_LIMIT \
  (2 * (SCL_VALUE_PAWN * 4 + SCL_VALUE_QUEEN + \
  SCL_VALUE_KING + SCL_VALUE_ROOK + SCL_VALUE_KNIGHT))

#define SCL_START_MATERIAL \
  (16 * SCL_VALUE_PAWN + 4 * SCL_VALUE_ROOK + 4 * SCL_VALUE_KNIGHT + \
    4 * SCL_VALUE_BISHOP + 2 * SCL_VALUE_QUEEN + 2 * SCL_VALUE_KING)

#ifndef SCL_RECORD_MAX_LENGTH
  #define SCL_RECORD_MAX_LENGTH 256
#endif

#define SCL_RECORD_MAX_SIZE (SCL_RECORD_MAX_LENGTH * 2)

/**
  Records a single chess game. The format is following:

  Each record item consists of 2 bytes which record a single move (ply):

  abxxxxxx cdyyyyyy

    xxxxxx  Start square of the move, counted as A0, A1, ...
    yyyyyy  End square of the move in the same format as the start square.
    ab      00 means this move isn't the last move of the game, other possible
            values are 01: white wins, 10: black wins, 11: draw or end for
            other reasons.
    cd      In case of pawn promotion move this encodes the promoted piece as
            00: queen, 01: rook, 10: bishop, 11: knight (pawn isn't allowed by
            chess rules).

  Every record should be ended by an ending move (ab != 00), empty record should
  have one move where xxxxxx == yyyyyy == 0 and ab == 11.
*/
typedef uint8_t SCL_Record[SCL_RECORD_MAX_SIZE];

#define SCL_RECORD_CONT 0x00
#define SCL_RECORD_W_WIN 0x40
#define SCL_RECORD_B_WIN 0x80
#define SCL_RECORD_END 0xc0

#define SCL_RECORD_PROM_Q 0x00
#define SCL_RECORD_PROM_R 0x40
#define SCL_RECORD_PROM_B 0x80
#define SCL_RECORD_PROM_N 0xc0

#define SCL_RECORD_ITEM(s0,s1,p,e) ((e) | (s0)),((p) | (s1))

void SCL_recordInit(SCL_Record r);

void SCL_recordCopy(SCL_Record recordFrom, SCL_Record recordTo);

/**
  Represents a complete game of chess (or a variant with different staring
  position). This struct along with associated functions allows to easily
  implement a chess game that allows undoing moves, detecting draws, recording
  the moves etc. On platforms with extremely little RAM one can reduce
  SCL_RECORD_MAX_LENGTH to reduce the size of this struct (which will however
  possibly limit how many moves can be undone).
*/
typedef struct
{
  SCL_Board board;
  SCL_Record record;          /**< Holds the game record. This record is here 
                              firstly because games are usually recorded and
                              secondly this allows undoing moves up to the 
                              beginning of the game. This infinite undoing will
                              only work as long as the record is able to hold
                              the whole game; if the record is full, undoing is
                              no longet possible. */
  uint16_t state;
  uint16_t ply;               ///< ply count (board ply counter is only 8 bit)

  uint32_t prevMoves[14];     ///< stores last moves, for repetition detection

  const char *startState;     /**< Optional pointer to the starting board state.
                              If this is null, standard chess start position is
                              assumed. This is needed for undoing moves with
                              game record. */
} SCL_Game;

/**
  Initializes a new chess game. The startState parameter is optional and allows
  for setting up chess variants that differ by starting positions, setting this
  to 0 will assume traditional starting position. WARNING: if startState is
  provided, the pointed to board mustn't be deallocated afterwards, the string
  is not internally copied (for memory saving reasons).
*/
void SCL_gameInit(SCL_Game *game, const SCL_Board startState);

void SCL_gameMakeMove(SCL_Game *game, uint8_t squareFrom, uint8_t squareTo,
  char promoteTo);

uint8_t SCL_gameUndoMove(SCL_Game *game);

/**
  Gets a move which if played now would cause a draw by repetition. Returns 1
  if such move exists, 0 otherwise. The results parameters can be set to 0 in
  which case they will be ignored and only the existence of a draw move will be
  tested.
*/
uint8_t SCL_gameGetRepetiotionMove(SCL_Game *game,
  uint8_t *squareFrom, uint8_t *squareTo);

/**
  Leads a game record from PGN string. The function will probably not strictly
  adhere to the PGN input format, but should accept most sanely written PGN
  strings.
*/
void SCL_recordFromPGN(SCL_Record r, const char *pgn);

uint16_t SCL_recordLength(const SCL_Record r);

/**
  Gets the move out of a game record, returns the end state of the move
  (SCL_RECORD_CONT, SCL_RECORD_END etc.)
*/
uint8_t SCL_recordGetMove(const SCL_Record r,  uint16_t index,
  uint8_t *squareFrom, uint8_t *squareTo, char *promotedPiece);

/**
  Adds another move to the game record. Terminating the record is handled so
  that the last move is always marked with end flag, endState is here to only
  indicate possible game result (otherwise pass SCL_RECORD_CONT). Returns 1 if
  the item was added, otherwise 0 (replay was already of maximum size).
*/
uint8_t SCL_recordAdd(SCL_Record r, uint8_t squareFrom,
  uint8_t squareTo, char promotePiece, uint8_t endState);

/**
  Removes the last move from the record, returns 1 if the replay is non-empty
  after the removal, otherwise 0.
*/
uint8_t SCL_recordRemoveLast(SCL_Record r);

/**
  Applies given number of half-moves (ply) to a given board (the board is
  automatically initialized at the beginning).
*/
void SCL_recordApply(const SCL_Record r, SCL_Board b, uint16_t moves);

int16_t SCL_pieceValue(char piece);
int16_t SCL_pieceValuePositive(char piece);

#define SCL_PRINT_FORMAT_NONE 0
#define SCL_PRINT_FORMAT_NORMAL 1
#define SCL_PRINT_FORMAT_COMPACT 2
#define SCL_PRINT_FORMAT_UTF8 3
#define SCL_PRINT_FORMAT_COMPACT_UTF8 4

/**
  Gets the best move for the currently moving player as computed by AI. The
  return value is the value of the move (with the same semantics as the value
  of an evaluation function). baseDepth is depth in plys to which all moves will
  be checked. If baseDepth 0 is passed, the function makes a random move and
  returns the evaluation of the board. extensionExtraDepth is extra depth for
  checking specific situations like exchanges and checks. endgameExtraDepth is
  extra depth which is added to baseDepth in the endgame. If the randomness
  function is 0, AI will always make the first best move it finds, if it is
  not 0 and randomness is 0, AI will randomly pick between the equally best
  moves, if it is not 0 and randomness is positive, AI will randomly choose
  between best moves with some bias (may not pick the best rated move).
*/
int16_t SCL_getAIMove(
  SCL_Board board,
  uint8_t baseDepth,
  uint8_t extensionExtraDepth,
  uint8_t endgameExtraDepth,
  SCL_StaticEvaluationFunction evalFunc,
  SCL_RandomFunction randFunc,
  uint8_t randomness,
  uint8_t repetitionMoveFrom,
  uint8_t repetitionMoveTo,
  uint8_t *resultFrom,
  uint8_t *resultTo,
  char *resultProm);

/**
  Function that prints out a single character. This is passed to printing
  functions.
*/
typedef void (*SCL_PutCharFunction)(char);

/**
  Prints given chessboard using given format and an abstract printing function.
*/
void SCL_printBoard(
  SCL_Board board,
  SCL_PutCharFunction putCharFunc,
  SCL_SquareSet highlightSquares,
  uint8_t selectSquare,
  uint8_t format,
  uint8_t offset,
  uint8_t labels,
  uint8_t blackDown);

void SCL_printBoardSimple(
  SCL_Board board,
  SCL_PutCharFunction putCharFunc,
  uint8_t selectSquare,
  uint8_t format);

void SCL_printSquareUTF8(uint8_t square, SCL_PutCharFunction putCharFunc);
void SCL_printPGN(SCL_Record r, SCL_PutCharFunction putCharFunc,
  SCL_Board initialState);

/**
  Reads a move from string (the notation format is described at the top of this
  file). The function is safe as long as the string is 0 terminated. Returns 1
  on success or 0 on fail (invalid move string).
*/
uint8_t SCL_stringToMove(const char *moveString, uint8_t *resultFrom, 
  uint8_t *resultTo, char *resultPromotion);

char *SCL_moveToString(SCL_Board board, uint8_t s0, uint8_t s1,
  char promotion, char *string);

/**
  Function used in drawing, it is called to draw the next pixel. The first
  parameter is the pixel color, the second one if the sequential number of the
  pixel.
*/
typedef void (*SCL_PutPixelFunction)(uint8_t, uint16_t);

#define SCL_BOARD_PICTURE_WIDTH 64

/**
  Draws a simple 1bit 64x64 pixels board using a provided abstract function for
  drawing pixels. The function renders from top left to bottom right, i.e. no
  frame buffer is required.
*/
void SCL_drawBoard(
  SCL_Board board,
  SCL_PutPixelFunction putPixel,
  uint8_t selectedSquare,
  SCL_SquareSet highlightSquares,
  uint8_t blackDown);

/**
  Converts square number to string representation (e.g. "d2"). This function
  will modify exactly the first two bytes of the provided string.
*/
static inline char *SCL_squareToString(uint8_t square, char *string);

/**
  Converts a string, such as "A1" or "b4", to square number. The string must
  start with a letter (lower or upper case) and be followed by a number <1,8>.
  Validity of the string is NOT checked.
*/
uint8_t SCL_stringToSquare(const char *square);

//=============================================================================
// privates:

#define SCL_UNUSED(v) (void)(v)

uint8_t SCL_currentRandom8 = 0;

uint16_t SCL_currentRandom16 = 0;

void SCL_randomSimpleSeed(uint8_t seed)
{
  SCL_currentRandom8 = seed;
}

uint8_t SCL_randomSimple(void)
{
  SCL_currentRandom8 *= 13;
  SCL_currentRandom8 += 7;
  return SCL_currentRandom8;
}

uint8_t SCL_randomBetter(void)
{
  SCL_currentRandom16 *= 13;
  SCL_currentRandom16 += 7;
  return (SCL_currentRandom16 % 256) ^ (SCL_currentRandom16 / 256);
}

void SCL_randomBetterSeed(uint16_t seed)
{
  SCL_currentRandom16 = seed;
}

void SCL_squareSetClear(SCL_SquareSet squareSet)
{
  for (uint8_t i = 0; i < 8; ++i)
    squareSet[i] = 0;
}

uint8_t SCL_stringToSquare(const char *square)
{
  return (square[1] - '1') * 8 +
    (square[0] - ((square[0] >= 'A' && square[0] <= 'Z') ? 'A' : 'a'));
}

char *SCL_moveToString(SCL_Board board, uint8_t s0, uint8_t s1,
  char promotion, char *string)
{
  char *result = string;

  SCL_squareToString(s0,string);
  string += 2;
  string = SCL_squareToString(s1,string);
  string += 2;

  char c = board[s0];

  if (c == 'p' || c == 'P')
  {
    uint8_t rank = s1 / 8;

    if (rank == 0 || rank == 7)
    {
      *string = promotion;
      string++;
    }
  }

  *string = 0;

  return result;
}

uint8_t SCL_boardWhitesTurn(SCL_Board board)
{
  return (board[SCL_BOARD_PLY_BYTE] % 2) == 0;
}

uint8_t SCL_coordsToSquare(uint8_t row, uint8_t column)
{
  return row * 8 + column; 
}

uint8_t SCL_pieceIsWhite(char piece)
{
  return piece < 'a';
}

char *SCL_squareToString(uint8_t square, char *string)
{
  string[0] = 'a' + square % 8;
  string[1] = '1' + square / 8;

  return string;
}
  
uint8_t SCL_squareIsWhite(uint8_t square)
{
  return (square % 2) != ((square / 8) % 2);
}

char SCL_pieceToColor(uint8_t piece, uint8_t toWhite)
{
  return (SCL_pieceIsWhite(piece) == toWhite) ?
    piece : (piece + (toWhite ? -32 : 32));
}

/**
  Records the rook starting positions in the board state. This is required in
  chess 960 in order to be able to correctly perform castling (castling rights
  knowledge isn't enough as one rook might have moved to the other side and we
  wouldn't know which one can castle and which not).
*/
void _SCL_board960RememberRookPositions(SCL_Board board)
{
  uint8_t pos = 0;
  uint8_t rooks = 2;

  while (pos < 8 && rooks != 0)
  {
    if (board[pos] == 'R')
    {
      board[SCL_BOARD_EXTRA_BYTE] = rooks == 2 ? pos :
        (board[SCL_BOARD_EXTRA_BYTE] | (pos << 3));

      rooks--;
    }

    pos++;
  }
}

void SCL_boardInit(SCL_Board board)
{
  /*
    We might use SCL_BOARD_START_STATE and copy it to the board, but that might
    waste RAM on Arduino, so we init the board by code.
  */

  char *b = board;

  *b = 'R'; b++; *b = 'N'; b++;
  *b = 'B'; b++; *b = 'Q'; b++;
  *b = 'K'; b++; *b = 'B'; b++;
  *b = 'N'; b++; *b = 'R'; b++;

  char *b2 = board + 48;

  for (uint8_t i = 0; i < 8; ++i, b++, b2++)
  {
    *b = 'P';
    *b2 = 'p';
  }

  for (uint8_t i = 0; i < 32; ++i, b++)
    *b = '.';

  b += 8;

  *b = 'r'; b++; *b = 'n'; b++;
  *b = 'b'; b++; *b = 'q'; b++;
  *b = 'k'; b++; *b = 'b'; b++;
  *b = 'n'; b++; *b = 'r'; b++;

  for (uint8_t i = 0; i < SCL_BOARD_STATE_SIZE - SCL_BOARD_SQUARES; ++i, ++b)
    *b = 0;

  board[SCL_BOARD_ENPASSANT_CASTLE_BYTE] = (char) 0xff;

#if SCL_960_CASTLING
  _SCL_board960RememberRookPositions(board);
#endif
}

void _SCL_boardPlaceOnNthAvailable(SCL_Board board, uint8_t pos, char piece)
{
  char *c = board;

  while (1)
  {
    if (*c == '.')
    {
      if (pos == 0)
        break;

      pos--;
    }

    c++;
  }

  *c = piece;
}

void SCL_boardInit960(SCL_Board board, uint16_t positionNumber)
{
  SCL_Board b;

  SCL_boardInit(b);

  for (uint8_t i = 0; i < SCL_BOARD_STATE_SIZE; ++i)
    board[i] = ((i >= 8 && i < 56) || i >= 64) ? b[i] : '.';

  uint8_t helper = positionNumber % 16;

  board[(helper / 4) * 2] = 'B';
  board[1 + (helper % 4) * 2] = 'B';

  helper = positionNumber / 16;

  // maybe there's a simpler way :)

  _SCL_boardPlaceOnNthAvailable(board,helper % 6,'Q');
  _SCL_boardPlaceOnNthAvailable(board,0,helper <= 23 ? 'N' : 'R');

  _SCL_boardPlaceOnNthAvailable(board,0,
    (helper >= 7 && helper <= 23) ? 'R' :
      (helper > 41 ? 'K' : 'N' ));

  _SCL_boardPlaceOnNthAvailable(board,0,
    (helper <= 5 || helper >= 54) ? 'R' : 
      (((helper >= 12 && helper <= 23) ||
      (helper >= 30 && helper <= 41)) ? 'K' : 'N'));

  _SCL_boardPlaceOnNthAvailable(board,0,
    (helper <= 11 || (helper <= 29 && helper >= 24)) ? 'K' :
      (
        (
          (helper >= 18 && helper <= 23) ||
          (helper >= 36 && helper <= 41) ||
          (helper >= 48 && helper <= 53)
        ) ? 'R' : 'N'
      )
    );

  uint8_t rooks = 0;

  for (uint8_t i = 0; i < 8; ++i)
    if (board[i] == 'R')
      rooks++;

  _SCL_boardPlaceOnNthAvailable(board,0,rooks == 2 ? 'N' : 'R');
  
  for (uint8_t i = 0; i < 8; ++i)
    board[56 + i] = SCL_pieceToColor(board[i],0);

#if SCL_960_CASTLING
  _SCL_board960RememberRookPositions(board);
#else
  SCL_boardDisableCastling(board);
#endif
}

uint8_t SCL_boardsDiffer(SCL_Board b1, SCL_Board b2)
{
  const char *p1 = b1, *p2 = b2;

  while (p1 < b1 + SCL_BOARD_STATE_SIZE)
  {
    if (*p1 != *p2)
      return 1;

    p1++;
    p2++;
  }

  return 0;
}

void SCL_recordInit(SCL_Record r)
{
  r[0] = 0 | SCL_RECORD_END;
  r[1] = 0;
}

void SCL_recordFromPGN(SCL_Record r, const char *pgn)
{
  SCL_Board board;

  SCL_boardInit(board);

  SCL_recordInit(r);

  uint8_t state = 0;
  uint8_t evenMove = 0;

  while (*pgn != 0)
  {
    switch (state)
    {
      case 0: // skipping tags and spaces, outside []
        if (*pgn == '1')
          state = 2;
        else if (*pgn == '[')
          state = 1;

        break;

      case 1: // skipping tags and spaces, inside []
        if (*pgn == ']')
          state = 0;

        break;

      case 2: // reading move number
        if (*pgn == '{')
          state = 3;
        else if ((*pgn >= 'a' && *pgn <= 'h') || (*pgn >= 'A' && *pgn <= 'Z'))
        {
          state = 4;
          pgn--;
        }

        break;

      case 3: // initial comment
        if (*pgn == '}')
          state = 2;

        break;

      case 4: // reading move
      {
        char piece = 'p';
        char promoteTo = 'q';
        uint8_t castle = 0;
        uint8_t promotion = 0;

        int8_t coords[4];

        uint8_t ranks = 0, files = 0;

        for (uint8_t i = 0; i < 4; ++i)
          coords[i] = -1;

        while (*pgn != ' ' && *pgn != '\n' && 
          *pgn != '\t' && *pgn != '{' && *pgn != 0)
        {
          if (*pgn == '=')
            promotion = 1;
          if (*pgn == 'O' || *pgn == '0')
            castle++;
          if (*pgn >= 'A' && *pgn <= 'Z')
          {
            if (promotion)
              promoteTo = *pgn;
            else
              piece = *pgn;
          }
          else if (*pgn >= 'a' && *pgn <= 'h')
          {
            coords[files * 2] = *pgn - 'a';
            files++;
          }
          else if (*pgn >= '1' && *pgn <= '8')
          {
            coords[1 + ranks * 2] = *pgn - '1';
            ranks++;
          }

          pgn++;
        }

        if (castle)
        {
          piece = 'K';

          coords[0] = 4;
          coords[1] = 0;
          coords[2] = castle < 3 ? 6 : 2;
          coords[3] = 0;

          if (evenMove)
          {
            coords[1] = 7;
            coords[3] = 7;
          }
        }

        piece = SCL_pieceToColor(piece,evenMove == 0);

        if (coords[2] < 0)
        {
          coords[2] = coords[0];
          coords[0] = -1;
        }

        if (coords[3] < 0)
        {
          coords[3] = coords[1];
          coords[1] = -1;
        }
          
        uint8_t squareTo = coords[3] * 8 + coords[2];

        if (coords[0] < 0 || coords[1] < 0)
        {
          // without complete starting coords we have to find the piece

          for (int i = 0; i < SCL_BOARD_SQUARES; ++i)
            if (board[i] == piece)
            {
              SCL_SquareSet s;

              SCL_squareSetClear(s);

              SCL_boardGetMoves(board,i,s);

              if (SCL_squareSetContains(s,squareTo) &&
                (coords[0] < 0 || coords[0] == i % 8) &&
                (coords[1] < 0 || coords[1] == i / 8))
              {
                coords[0] = i % 8;
                coords[1] = i / 8;
                break;
              }
            }
        }

        uint8_t squareFrom = coords[1] * 8 + coords[0];

        SCL_boardMakeMove(board,squareFrom,squareTo,promoteTo);

// for some reason tcc bugs here, the above line sets squareFrom to 0 lol
// can be fixed with doing "squareFrom = coords[1] * 8 + coords[0];" again

        SCL_recordAdd(r,squareFrom,squareTo,promoteTo,SCL_RECORD_CONT);

        while (*pgn == ' ' || *pgn == '\n' || *pgn == '\t' || *pgn == '{')
        {
          if (*pgn == '{')
            while (*pgn != '}')
              pgn++;

          pgn++;
        }

        if (*pgn == 0)
          return;

        pgn--;

        if (evenMove)
          state = 2;

        evenMove = !evenMove;

        break;
      }

      default: break;
    }

    pgn++;
  }
}

uint16_t SCL_recordLength(const SCL_Record r)
{
  if ((r[0] & 0x3f) == (r[1] & 0x3f)) // empty record that's only terminator
    return 0;

  uint16_t result = 0;

  while ((r[result] & 0xc0) == 0)
    result += 2;

  return (result / 2) + 1;
}

uint8_t SCL_recordGetMove(const SCL_Record r,  uint16_t index,
  uint8_t *squareFrom, uint8_t *squareTo, char *promotedPiece)
{ 
  index *= 2;
 
  uint8_t b = r[index];

  *squareFrom = b & 0x3f;
  uint8_t result = b & 0xc0;

  index++;

  b = r[index];
 
  *squareTo = b & 0x3f;

  b &= 0xc0;

  switch (b)
  {
    case SCL_RECORD_PROM_Q: *promotedPiece = 'q'; break;
    case SCL_RECORD_PROM_R: *promotedPiece = 'r'; break;
    case SCL_RECORD_PROM_B: *promotedPiece = 'b'; break;
    case SCL_RECORD_PROM_N: 
    default:            *promotedPiece = 'n'; break;
  }

  return result;
}

uint8_t SCL_recordAdd(SCL_Record r, uint8_t squareFrom,
  uint8_t squareTo, char promotePiece, uint8_t endState)
{
  uint16_t l = SCL_recordLength(r);

  if (l >= SCL_RECORD_MAX_LENGTH)
    return 0;

  l *= 2;

  if (l != 0)
    r[l - 2] &= 0x3f; // remove the end flag from previous item

  if (endState == SCL_RECORD_CONT)
    endState = SCL_RECORD_END;

  r[l] = squareFrom | endState;

  uint8_t p;

  switch (promotePiece)
  {
    case 'n': case 'N': p = SCL_RECORD_PROM_N; break;
    case 'b': case 'B': p = SCL_RECORD_PROM_B; break;
    case 'r': case 'R': p = SCL_RECORD_PROM_R; break;
    case 'q': case 'Q': 
    default:            p = SCL_RECORD_PROM_Q; break;
  }

  l++;

  r[l] = squareTo | p;

  return 1;
}

uint8_t SCL_recordRemoveLast(SCL_Record r)
{
  uint16_t l = SCL_recordLength(r);
  
  if (l == 0)
    return 0;

  if (l == 1)
    SCL_recordInit(r);
  else
  {
    l = (l - 2) * 2;

    r[l] = (r[l] & 0x3f) | SCL_RECORD_END;
  }
  
  return 1;
}

void SCL_recordApply(const SCL_Record r, SCL_Board b, uint16_t moves)
{
  SCL_boardInit(b);

  uint16_t l = SCL_recordLength(r);

  if (moves > l)
    moves = l;

  for (uint16_t i = 0; i < moves; ++i)
  {
    uint8_t s0, s1;
    char p;

     SCL_recordGetMove(r,i,&s0,&s1,&p);
     SCL_boardMakeMove(b,s0,s1,p);
  }
}

void SCL_boardUndoMove(SCL_Board board, SCL_MoveUndo moveUndo)
{
#if SCL_960_CASTLING
  char squareToNow = board[moveUndo.squareTo];
#endif

  board[moveUndo.squareFrom] = board[moveUndo.squareTo];
  board[moveUndo.squareTo] = moveUndo.other & 0x7f;
  board[SCL_BOARD_PLY_BYTE]--;
  board[SCL_BOARD_ENPASSANT_CASTLE_BYTE] = moveUndo.enPassantCastle;
  board[SCL_BOARD_MOVE_COUNT_BYTE] = moveUndo.moveCount;

  if (moveUndo.other & 0x80)
  {
    moveUndo.squareTo /= 8;

    if (moveUndo.squareTo == 0 || moveUndo.squareTo == 7)
      board[moveUndo.squareFrom] = SCL_pieceIsWhite(board[moveUndo.squareFrom]) 
        ? 'P' : 'p';
      // ^ was promotion
    else
      board[(moveUndo.squareFrom / 8) * 8 + (moveUndo.enPassantCastle & 0x0f)] =
        (board[moveUndo.squareFrom] == 'P') ? 'p' : 'P'; // was en passant
  }
#if !SCL_960_CASTLING
  else if (board[moveUndo.squareFrom] == 'k' && // black castling
    moveUndo.squareFrom == 60)
  {
    if (moveUndo.squareTo == 58)
    {
      board[59] = '.';
      board[56] = 'r';
    } 
    else if (moveUndo.squareTo == 62)
    {
      board[61] = '.';
      board[63] = 'r';
    } 
  }
  else if (board[moveUndo.squareFrom] == 'K' && // white castling
    moveUndo.squareFrom == 4)
  {
    if (moveUndo.squareTo == 2)
    {
      board[3] = '.';
      board[0] = 'R';
    } 
    else if (moveUndo.squareTo == 6)
    {
      board[5] = '.';
      board[7] = 'R';
    } 
  }
#else // 960 castling
  else if (((moveUndo.other & 0x7f) == 'r') && // black castling
    (squareToNow == '.' || !SCL_pieceIsWhite(squareToNow)))
  {
    board[moveUndo.squareTo < moveUndo.squareFrom ? 59 : 61] = '.';
    board[moveUndo.squareTo < moveUndo.squareFrom ? 58 : 62] = '.';

    board[moveUndo.squareFrom] = 'k';
    board[moveUndo.squareTo] = 'r';
  }
  else if (((moveUndo.other & 0x7f) == 'R') && // white castling
    (squareToNow == '.' || SCL_pieceIsWhite(squareToNow)))
  {
    board[moveUndo.squareTo < moveUndo.squareFrom ? 3 : 5] = '.';
    board[moveUndo.squareTo < moveUndo.squareFrom ? 2 : 6] = '.';

    board[moveUndo.squareFrom] = 'K';
    board[moveUndo.squareTo] = 'R';
  }
#endif
}

/**
  Potentially disables castling rights according to whether something moved from
  or to a square with a rook.
*/
void _SCL_handleRookActivity(SCL_Board board, uint8_t rookSquare)
{
#if !SCL_960_CASTLING
  switch (rookSquare)
  {
    case 0:  board[SCL_BOARD_ENPASSANT_CASTLE_BYTE] &= (uint8_t) ~0x20; break;
    case 7:  board[SCL_BOARD_ENPASSANT_CASTLE_BYTE] &= (uint8_t) ~0x10; break;
    case 56: board[SCL_BOARD_ENPASSANT_CASTLE_BYTE] &= (uint8_t) ~0x80; break;
    case 63: board[SCL_BOARD_ENPASSANT_CASTLE_BYTE] &= (uint8_t) ~0x40; break;
    default: break;
  }
#else // 960 castling
  if (rookSquare == (board[SCL_BOARD_EXTRA_BYTE] & 0x07))
    board[SCL_BOARD_ENPASSANT_CASTLE_BYTE] &= (uint8_t) ~0x20;
  else if (rookSquare == (board[SCL_BOARD_EXTRA_BYTE] >> 3))
    board[SCL_BOARD_ENPASSANT_CASTLE_BYTE] &= (uint8_t) ~0x10;
  else if (rookSquare == 56 + (board[SCL_BOARD_EXTRA_BYTE] & 0x07))
    board[SCL_BOARD_ENPASSANT_CASTLE_BYTE] &= (uint8_t) ~0x80;
  else if (rookSquare == 56 + (board[SCL_BOARD_EXTRA_BYTE] >> 3))
    board[SCL_BOARD_ENPASSANT_CASTLE_BYTE] &= (uint8_t) ~0x40;
#endif
}

SCL_MoveUndo SCL_boardMakeMove(SCL_Board board, uint8_t squareFrom, uint8_t squareTo, 
  char promotePiece)
{
  char s = board[squareFrom];

  SCL_MoveUndo moveUndo;

  moveUndo.squareFrom = squareFrom;
  moveUndo.squareTo = squareTo; 
  moveUndo.moveCount = board[SCL_BOARD_MOVE_COUNT_BYTE];
  moveUndo.enPassantCastle = board[SCL_BOARD_ENPASSANT_CASTLE_BYTE];
  moveUndo.other = board[squareTo];

  // reset the en-passant state
  board[SCL_BOARD_ENPASSANT_CASTLE_BYTE] |= 0x0f;

  if (SCL_boardMoveResetsCount(board,squareFrom,squareTo))
    board[SCL_BOARD_MOVE_COUNT_BYTE] = 0;
  else
    board[SCL_BOARD_MOVE_COUNT_BYTE]++;

#if SCL_960_CASTLING
  uint8_t castled = 0;
#endif

  if ((s == 'k') || (s == 'K'))
  {
#if !SCL_960_CASTLING
    if ((squareFrom == 4) || (squareFrom == 60)) // check castling
    {
      int8_t difference = squareTo - squareFrom;

      char rook = SCL_pieceToColor('r',SCL_pieceIsWhite(s));

      if (difference == 2) // short
      {
        board[squareTo - 1] = rook;
        board[squareTo + 1] = '.';
      }
      else if (difference == -2) // long
      {
        board[squareTo - 2] = '.';
        board[squareTo + 1] = rook;
      }
    }
#else // 960 castling
    uint8_t isWhite = SCL_pieceIsWhite(s);
    char rook = SCL_pieceToColor('r',isWhite);

    if (board[squareTo] == rook)
    {
      castled = 1;
        
      board[squareFrom] = '.';
      board[squareTo] = '.';

      if (squareTo > squareFrom) // short
      {
        board[isWhite ? 6 : (56 + 6)] = s;
        board[isWhite ? 5 : (56 + 5)] = rook;
      }
      else // long
      {
        board[isWhite ? 2 : (56 + 2)] = s;
        board[isWhite ? 3 : (56 + 3)] = rook;
      }
    }
#endif

    // after king move disable castling
    board[SCL_BOARD_ENPASSANT_CASTLE_BYTE] &= ~(0x03 << ((s == 'K') ? 4 : 6));
  }
  else if ((s == 'p') || (s == 'P'))
  {
    uint8_t row = squareTo / 8;

    int8_t rowDiff = squareFrom / 8 - row;

    if (rowDiff == 2 || rowDiff == -2) // record en passant column
    {
      board[SCL_BOARD_ENPASSANT_CASTLE_BYTE] = 
        (board[SCL_BOARD_ENPASSANT_CASTLE_BYTE] & 0xf0) | (squareFrom % 8);
    }

    if (row == 0 || row == 7)
    {
      // promotion
      s = SCL_pieceToColor(promotePiece,SCL_pieceIsWhite(s));

      moveUndo.other |= 0x80;
    }
    else
    { 
      // check en passant move

      int8_t columnDiff = (squareTo % 8) - (squareFrom % 8);

      if ((columnDiff != 0) && (board[squareTo] == '.'))
      {
        board[squareFrom + columnDiff] = '.'; 
        moveUndo.other |= 0x80;
      }
    }
  }
  else if ((s == 'r') || (s == 'R'))
    _SCL_handleRookActivity(board,squareFrom);

  char taken = board[squareTo];

  // taking a rook may also disable castling:

  if (taken == 'R' || taken == 'r')
    _SCL_handleRookActivity(board,squareTo);

#if SCL_960_CASTLING
  if (!castled)
#endif
  {
    board[squareTo] = s;
    board[squareFrom] = '.';
  }

  board[SCL_BOARD_PLY_BYTE]++; // increase ply count

  return moveUndo;
}

void SCL_boardSetPosition(SCL_Board board, const char *pieces,
  uint8_t castlingEnPassant, uint8_t moveCount, uint8_t ply)
{
  for (uint8_t i = 0; i < SCL_BOARD_SQUARES; ++i, pieces++)
    if (*pieces != 0)
      board[i] = *pieces;
    else
      break;

  board[SCL_BOARD_ENPASSANT_CASTLE_BYTE] = castlingEnPassant;
  board[SCL_BOARD_PLY_BYTE] = ply;
  board[SCL_BOARD_MOVE_COUNT_BYTE] = moveCount;
  board[SCL_BOARD_STATE_SIZE - 1] = 0;
}

void SCL_squareSetAdd(SCL_SquareSet squareSet, uint8_t square)
{
  squareSet[square / 8] |= 0x01 << (square % 8);
}

uint8_t SCL_squareSetContains(const SCL_SquareSet squareSet, uint8_t square)
{
  return squareSet[square / 8] & (0x01 << (square % 8));
}

uint8_t SCL_squareSetSize(const SCL_SquareSet squareSet)
{
  uint8_t result = 0;

  for (uint8_t i = 0; i < 8; ++i)
  {
    uint8_t byte = squareSet[i];

    for (uint8_t j = 0; j < 8; ++j)
    {
      result += byte & 0x01;
      byte >>= 1;
    }
  }

  return result;
}

uint8_t SCL_squareSetEmpty(const SCL_SquareSet squareSet)
{
  for (uint8_t i = 0; i < 8; ++i)
    if (squareSet[i] != 0)
      return 0;  

  return 1;
}

uint8_t SCL_squareSetGetRandom(
  const SCL_SquareSet squareSet, SCL_RandomFunction randFunc)
{
  uint8_t size = SCL_squareSetSize(squareSet);

  if (size == 0)
    return 0;

  uint8_t n = (randFunc() % size) + 1;
  uint8_t i = 0;

  while (i < SCL_BOARD_SQUARES)
  {
    if (SCL_squareSetContains(squareSet,i))
    {
      n--;

      if (n == 0)
        break;
    }

    ++i;
  }

  return i;
}

void SCL_boardCopy(const SCL_Board boardFrom, SCL_Board boardTo)
{
  for (uint8_t i = 0; i < SCL_BOARD_STATE_SIZE; ++i)
    boardTo[i] = boardFrom[i]; 
}

uint8_t SCL_boardSquareAttacked(
  SCL_Board board,
  uint8_t square,
  uint8_t byWhite)
{
  const char *currentSquare = board;

  /* We need to place a temporary piece on the tested square in order to test if
     the square is attacked (consider testing if attacked by a pawn). */

  char previous = board[square];

  board[square] = SCL_pieceToColor('r',!byWhite);

  for (uint8_t i = 0; i < SCL_BOARD_SQUARES; ++i, ++currentSquare)
  {
    char s = *currentSquare;
 
    if ((s == '.') || (SCL_pieceIsWhite(s) != byWhite))
      continue;

    SCL_SquareSet moves;
    SCL_boardGetPseudoMoves(board,i,0,moves);

    if (SCL_squareSetContains(moves,square))
    {
      board[square] = previous;
      return 1;
    }
  }
      
  board[square] = previous;    
  return 0;
}

uint8_t SCL_boardCheck(SCL_Board board,uint8_t white)
{
  const char *square = board;
  char kingChar = white ? 'K' : 'k';

  for (uint8_t i = 0; i < SCL_BOARD_SQUARES; ++i, ++square)
    if ((*square == kingChar && 
      SCL_boardSquareAttacked(board,i,!white)))
        return 1;

  return 0;
}

uint8_t SCL_boardGameOver(SCL_Board board)
{
  uint8_t position = SCL_boardGetPosition(board);

  return (position == SCL_POSITION_MATE) ||
         (position == SCL_POSITION_STALEMATE) ||
         (position == SCL_POSITION_DEAD);
}

uint8_t SCL_boardMovePossible(SCL_Board board)
{
  uint8_t white = SCL_boardWhitesTurn(board);

  for (uint8_t i = 0; i < SCL_BOARD_SQUARES; ++i)
  {
    char s = board[i];

    if ((s != '.') && (SCL_pieceIsWhite(s) == white))
    {
      SCL_SquareSet moves;

      SCL_boardGetMoves(board,i,moves);

      if (SCL_squareSetSize(moves) != 0)
        return 1;
    }
  }

  return 0;
}

uint8_t SCL_boardMate(SCL_Board board)
{
  return SCL_boardGetPosition(board) == SCL_POSITION_MATE;
}

void SCL_boardGetPseudoMoves(
  SCL_Board board,
  uint8_t pieceSquare,
  uint8_t checkCastling,
  SCL_SquareSet result)
{
  char piece = board[pieceSquare];

  SCL_squareSetClear(result);

  uint8_t isWhite = SCL_pieceIsWhite(piece);
  int8_t horizontalPosition = pieceSquare % 8;
  int8_t pawnOffset = -8;

  switch (piece)
  {
    case 'P':
      pawnOffset = 8;
    case 'p':
    {
      uint8_t square = pieceSquare + pawnOffset;
      uint8_t verticalPosition = pieceSquare / 8;

      if (board[square] == '.') // forward move
      {
        SCL_squareSetAdd(result,square);

        if (verticalPosition == (1 + (piece == 'p') * 5)) // start position?
        {
          uint8_t square2 = square + pawnOffset;

          if (board[square2] == '.')
            SCL_squareSetAdd(result,square2);
        }
      }

      #define checkDiagonal(hor,add) \
        if (horizontalPosition != hor) \
        { \
          uint8_t square2 = square + add; \
          char c = board[square2]; \
          if (c != '.' && SCL_pieceIsWhite(c) != isWhite) \
            SCL_squareSetAdd(result,square2); \
        }

      // diagonal moves
      checkDiagonal(0,-1)
      checkDiagonal(7,1)

      uint8_t enPassantRow = 4;
      uint8_t enemyPawn = 'p';

      if (piece == 'p')
      {
        enPassantRow = 3;
        enemyPawn = 'P';
      }

      // en-passant moves
      if (verticalPosition == enPassantRow)
      {
        uint8_t enPassantColumn = board[SCL_BOARD_ENPASSANT_CASTLE_BYTE] & 0x0f;
        uint8_t column = pieceSquare % 8;

        for (int8_t offset = -1; offset < 2; offset += 2)
          if ((enPassantColumn == column + offset) &&
              (board[pieceSquare + offset] == enemyPawn))
          {
            SCL_squareSetAdd(result,pieceSquare + pawnOffset + offset);
            break;
          }
      } 

      #undef checkDiagonal
    }
      break;

    case 'r': // rook
    case 'R':
    case 'b': // bishop
    case 'B':
    case 'q': // queen
    case 'Q':
    {
      const int8_t offsets[8] =    {-8, 1, 8, -1, -7, 9, -9, 7};
      const int8_t columnDirs[8] = { 0, 1, 0, -1,  1, 1, -1,-1};

      uint8_t from = (piece == 'b' || piece == 'B') * 4;
      uint8_t to = 4 + (piece != 'r' && piece != 'R') * 4;

      for (uint8_t i = from; i < to; ++i)
      {
        int8_t offset = offsets[i];
        int8_t columnDir = columnDirs[i];
        int8_t square = pieceSquare;
        int8_t col = horizontalPosition;

        while (1)
        {
          square += offset;
          col += columnDir;

          if (square < 0 || square > 63 || col < 0 || col > 7)
            break;

          char squareC = board[square];

          if (squareC == '.')
            SCL_squareSetAdd(result,square);
          else
          {
            if (SCL_pieceIsWhite(squareC) != isWhite)
              SCL_squareSetAdd(result,square);

            break;
          }
        }
      }
    }
      break;

    case 'n': // knight
    case 'N':
    {
      const int8_t offsets[4] = {6, 10, 15, 17};
      const int8_t columnsMinus[4] = {2,-2,1,-1};
      const int8_t columnsPlus[4] = {-2,2,-1,1};
      const int8_t *off, *col;

      #define checkOffsets(op,comp,limit,dir)\
        off = offsets;\
        col = columns ## dir;\
        for (uint8_t i = 0; i < 4; ++i, ++off, ++col)\
        {\
          int8_t square = pieceSquare op (*off);\
          if (square comp limit) /* out of board? */\
            break;\
          int8_t horizontalCheck = horizontalPosition + (*col);\
          if (horizontalCheck < 0 || horizontalCheck >= 8)\
            continue;\
          char squareC = board[square];\
          if ((squareC == '.') || (SCL_pieceIsWhite(squareC) != isWhite))\
            SCL_squareSetAdd(result,square);\
        }

      checkOffsets(-,<,0,Minus)
      checkOffsets(+,>=,SCL_BOARD_SQUARES,Plus)

      #undef checkOffsets
    } 
      break; 

    case 'k': // king
    case 'K':
    {
      uint8_t verticalPosition = pieceSquare / 8;

      uint8_t
        u = verticalPosition != 0,
        d = verticalPosition != 7,
        l = horizontalPosition != 0,
        r = horizontalPosition != 7;

      uint8_t square2 = pieceSquare - 9;

      #define checkSquare(cond,add) \
        if (cond && ((board[square2] == '.') || \
            (SCL_pieceIsWhite(board[square2])) != isWhite))\
          SCL_squareSetAdd(result,square2);\
        square2 += add;

      checkSquare(l && u,1)
      checkSquare(u,1)
      checkSquare(r && u,6)
      checkSquare(l,2)
      checkSquare(r,6)
      checkSquare(l && d,1)
      checkSquare(d,1)
      checkSquare(r && d,0)

      #undef checkSquare

      // castling:

      if (checkCastling)
      {
        uint8_t bitShift = 4 + 2 * (!isWhite);

        if ((board[SCL_BOARD_ENPASSANT_CASTLE_BYTE] & (0x03 << bitShift)) &&
          !SCL_boardSquareAttacked(board,pieceSquare,!isWhite)) // no check?
        { 
#if !SCL_960_CASTLING
          // short castle:
          pieceSquare++;
            
          if ((board[SCL_BOARD_ENPASSANT_CASTLE_BYTE] & (0x01 << bitShift)) &&
              (board[pieceSquare] == '.') &&
              (board[pieceSquare + 1] == '.') &&
              (board[pieceSquare + 2] == SCL_pieceToColor('r',isWhite)) &&
              !SCL_boardSquareAttacked(board,pieceSquare,!isWhite))
            SCL_squareSetAdd(result,pieceSquare + 1);

          /* note: don't check the final square for check, it will potentially
             be removed later (can't end up in check) */

          // long castle:
          pieceSquare -= 2;

          if ((board[SCL_BOARD_ENPASSANT_CASTLE_BYTE] & (0x02 << bitShift)) &&
              (board[pieceSquare] == '.') &&
              (board[pieceSquare - 1] == '.') &&
              (board[pieceSquare - 2] == '.') &&
              (board[pieceSquare - 3] == SCL_pieceToColor('r',isWhite)) &&
              !SCL_boardSquareAttacked(board,pieceSquare,!isWhite))
            SCL_squareSetAdd(result,pieceSquare - 1);
#else // 960 castling
          for (int i = 0; i < 2; ++i) // short and long
            if (board[SCL_BOARD_ENPASSANT_CASTLE_BYTE] & ((i + 1) << bitShift))
            {
              uint8_t 
                rookPos = board[SCL_BOARD_EXTRA_BYTE] >> 3,
                targetPos = 5;

              if (i == 1)
              {
                rookPos = board[SCL_BOARD_EXTRA_BYTE] & 0x07,
                targetPos = 3;
              }

              if (!isWhite)
              {
                rookPos += 56;
                targetPos += 56;
              }

              uint8_t ok = board[rookPos] == SCL_pieceToColor('r',isWhite);

              if (!ok)
                continue;

              int8_t inc = 1 - 2 * (targetPos > rookPos);

              while (targetPos != rookPos) // check vacant squares for the rook
              {
                if (board[targetPos] != '.' && 
                    targetPos != pieceSquare)
                {
                  ok = 0;
                  break;
                }

                targetPos += inc;
              }

              if (!ok) 
                continue;

              targetPos = i == 0 ? 6 : 2;

              if (!isWhite)
                targetPos += 56;

              inc = 1 - 2 * (targetPos > pieceSquare);

              while (targetPos != pieceSquare) // check squares for the king
              {
                if ((board[targetPos] != '.' && 
                     targetPos != rookPos) ||
                     SCL_boardSquareAttacked(board,targetPos,!isWhite))
                {
                  ok = 0;
                  break;
                }

                targetPos += inc;
              }

              if (ok)
                SCL_squareSetAdd(result,rookPos);
            }
#endif
        }
      }
    }
      break;

    default:
      break;
  }
}

void SCL_printSquareSet(SCL_SquareSet set, SCL_PutCharFunction putCharFunc)
{
  uint8_t first = 1;

  putCharFunc('(');

  for (uint8_t i = 0; i < SCL_BOARD_SQUARES; ++i)
  {
    if (!SCL_squareSetContains(set, i))
      continue;

    if (!first)
      putCharFunc(',');
    else
      first = 0;

    putCharFunc('A' + i % 8);
    putCharFunc('1' + i / 8);
  }

  putCharFunc(')');
}

void SCL_printSquareUTF8(uint8_t square, SCL_PutCharFunction putCharFunc)
{
  uint32_t val = 0;

  switch (square)
  {
    case 'r': val = 0x9c99e200; break;
    case 'n': val = 0x9e99e200; break;
    case 'b': val = 0x9d99e200; break;
    case 'q': val = 0x9b99e200; break;
    case 'k': val = 0x9a99e200; break;
    case 'p': val = 0x9f99e200; break;
    case 'R': val = 0x9699e200; break;
    case 'N': val = 0x9899e200; break;
    case 'B': val = 0x9799e200; break;
    case 'Q': val = 0x9599e200; break;
    case 'K': val = 0x9499e200; break;
    case 'P': val = 0x9999e200; break;
    case '.': val = 0x9296e200; break;
    case ',': val = 0x9196e200; break;
    default:  putCharFunc(square); return; break;
  }

  uint8_t count = 4;

  while ((val % 256 == 0) && (count > 0))
  {
    val /= 256;
    count--;
  }

  while (count > 0)
  {
    putCharFunc(val % 256);
    val /= 256;
    count--;
  }
}

void SCL_boardGetMoves(
  SCL_Board board,
  uint8_t pieceSquare,
  SCL_SquareSet result)
{
  SCL_SquareSet allMoves;

  SCL_squareSetClear(allMoves);

  for (uint8_t i = 0; i < 8; ++i)
    result[i] = 0;

  SCL_boardGetPseudoMoves(board,pieceSquare,1,allMoves);

  // Now only keep moves that don't lead to one's check:

  SCL_SQUARE_SET_ITERATE_BEGIN(allMoves)

    SCL_MoveUndo undo = SCL_boardMakeMove(board,pieceSquare,iteratedSquare,'q');

    if (!SCL_boardCheck(board,!SCL_boardWhitesTurn(board)))
      SCL_squareSetAdd(result,iteratedSquare);

    SCL_boardUndoMove(board,undo);

  SCL_SQUARE_SET_ITERATE_END
}

uint8_t SCL_boardDead(SCL_Board board)
{
  /*
    This byte represents material by bits:

    MSB _ _ _ _ _ _ _ _ LSB
          | | |   | | \_ white knight
          | | |   |  \__ white bishop on white
          | | |    \____ white bishop on black
          | |  \________ black knight
          |  \__________ black bishop on white
           \____________ black bishop on black
  */
  uint8_t material = 0;

  const char *p = board;

  for (uint8_t i = 0; i < SCL_BOARD_SQUARES; ++i)
  {
    char c = *p;

    switch (c)
    {
      case 'n': material |= 0x01; break;
      case 'N': material |= 0x10; break;
      case 'b': material |= (0x02 << (!SCL_squareIsWhite(i))); break;
      case 'B': material |= (0x20 << (!SCL_squareIsWhite(i))); break;
      case 'p':
      case 'P': 
      case 'r':
      case 'R': 
      case 'q':
      case 'Q': 
        return 0; // REMOVE later if more complex check are performed
        break;

      default: break;
    }

    p++;
  }

  // TODO: add other checks than only insufficient material

  // possible combinations of insufficient material:

  return
    (material == 0x00) || // king vs king
    (material == 0x01) || // king and knight vs king 
    (material == 0x10) || // king and knight vs king
    (material == 0x02) || // king and bishop vs king
    (material == 0x20) || // king and bishop vs king
    (material == 0x04) || // king and bishop vs king
    (material == 0x40) || // king and bishop vs king
    (material == 0x22) || // king and bishop vs king and bishop (same color)
    (material == 0x44);   // king and bishop vs king and bishop (same color)
}

uint8_t SCL_boardGetPosition(SCL_Board board)
{
  uint8_t check = SCL_boardCheck(board,SCL_boardWhitesTurn(board)); 
  uint8_t moves = SCL_boardMovePossible(board);

  if (check)
    return moves ? SCL_POSITION_CHECK : SCL_POSITION_MATE;
  else if (!moves)
    return SCL_POSITION_STALEMATE;

  if (SCL_boardDead(board))
    return SCL_POSITION_DEAD;

  return SCL_POSITION_NORMAL;
}

uint8_t SCL_stringToMove(const char *moveString, uint8_t *resultFrom, 
  uint8_t *resultTo, char *resultPromotion)
{
  char c;

  uint8_t *dst = resultFrom;

  for (uint8_t i = 0; i < 2; ++i)
  {
    c = *moveString;
  
    *dst = (c >= 'a') ? (c - 'a') : (c - 'A');

    if (*dst > 7)
      return 0;

    moveString++;    
    c = *moveString;
  
    *dst += 8 * (c - '1');
  
    if (*dst > 63)
      return 0;
  
    moveString++;    

    dst = resultTo;
  }

  c = *moveString;

  if (c < 'A')
    c = c - 'A' + 'a';

  switch (c)
  {
    case 'N': case 'n': *resultPromotion = 'n'; break;
    case 'B': case 'b': *resultPromotion = 'b'; break;
    case 'R': case 'r': *resultPromotion = 'r'; break;
    case 'Q': case 'q':
    default: *resultPromotion = 'q'; break;
  }
  
  return 1;
}

void SCL_printBoard(
  SCL_Board board,
  SCL_PutCharFunction putCharFunc,
  SCL_SquareSet highlightSquares,
  uint8_t selectSquare,
  uint8_t format,
  uint8_t offset,
  uint8_t labels,
  uint8_t blackDown)
{
  if (labels)
  {
    for (uint8_t i = 0; i < offset + 2; ++i)
      putCharFunc(' ');

    for (uint8_t i = 0; i < 8; ++i)
    {
      if ((format != SCL_PRINT_FORMAT_COMPACT) &&
          (format != SCL_PRINT_FORMAT_COMPACT_UTF8))
        putCharFunc(' ');

      putCharFunc(blackDown ? ('H' - i) : ('A' + i));
    }     

    putCharFunc('\n');
  }   
 
  int8_t i = 7;
  int8_t add = 1;

  if (!blackDown)
  {
    i = 56;
    add = -1;
  }

  for (int8_t row = 0; row < 8; ++row)
  {
    for (uint8_t j = 0; j < offset; ++j)
      putCharFunc(' ');

    if (labels)
    {
      putCharFunc(!blackDown ? ('8' - row) : ('1' + row));
      putCharFunc(' ');
    }

    const char *square = board + i;

    for (int8_t col = 0; col < 8; ++col)
    {
      switch (format)
      {
        case SCL_PRINT_FORMAT_COMPACT:
          putCharFunc(
            (*square == '.') ? (
            ((i != selectSquare) ?
              (!SCL_squareSetContains(highlightSquares,i) ? *square : '*')
              : '#')) : *square);
          break;

        case SCL_PRINT_FORMAT_UTF8:
        {
          char squareChar = SCL_squareIsWhite(i) ? '.' : ',';
          char pieceChar = (*square == '.') ? squareChar : *square;

          if (i == selectSquare)
          {
            putCharFunc('(');

            if (*square == '.')
              putCharFunc(')');
            else
              SCL_printSquareUTF8(pieceChar,putCharFunc);
          }
          else if (!SCL_squareSetContains(highlightSquares,i))
          {
            SCL_printSquareUTF8(squareChar,putCharFunc);
            SCL_printSquareUTF8(pieceChar,putCharFunc);
          }
          else
          {
            putCharFunc('[');

            if (*square == '.')
              putCharFunc(']');
            else
              SCL_printSquareUTF8(*square,putCharFunc);
          }

          break;
        }

        case SCL_PRINT_FORMAT_COMPACT_UTF8:
          SCL_printSquareUTF8(
            (*square == '.') ? (
              SCL_squareSetContains(highlightSquares,i) ? '*' :
              (i == selectSquare ? '#' : ((SCL_squareIsWhite(i) ? '.' : ',')))
            ) : *square,putCharFunc);
          break;

        case SCL_PRINT_FORMAT_NORMAL:
        default:
        {
          uint8_t c = *square;

          char squareColor = SCL_squareIsWhite(i) ? ' ' : ':';

          putCharFunc((i != selectSquare) ?
            (!SCL_squareSetContains(highlightSquares,i) ?
            squareColor : '#') : '@');

          putCharFunc(c == '.' ? squareColor : *square);
          break;
        }
      }

      i -= add;
      square -= add;
    }
        
    putCharFunc('\n');

    i += add * 16;  
  } // for rows
}

int16_t SCL_pieceValuePositive(char piece)
{
  switch (piece)
  {
    case 'p':
    case 'P': return SCL_VALUE_PAWN; break;
    case 'n':
    case 'N': return SCL_VALUE_KNIGHT; break;
    case 'b':
    case 'B': return SCL_VALUE_BISHOP; break;
    case 'r':
    case 'R': return SCL_VALUE_ROOK; break;
    case 'q':
    case 'Q': return SCL_VALUE_QUEEN; break;
    case 'k':
    case 'K': return SCL_VALUE_KING; break;
    default: break;
  }

  return 0;
}

int16_t SCL_pieceValue(char piece)
{
  switch (piece)
  {
    case 'P': return SCL_VALUE_PAWN; break;
    case 'N': return SCL_VALUE_KNIGHT; break;
    case 'B': return SCL_VALUE_BISHOP; break;
    case 'R': return SCL_VALUE_ROOK; break;
    case 'Q': return SCL_VALUE_QUEEN; break;
    case 'K': return SCL_VALUE_KING; break;
    case 'p': return -1 * SCL_VALUE_PAWN; break;
    case 'n': return -1 * SCL_VALUE_KNIGHT; break;
    case 'b': return -1 * SCL_VALUE_BISHOP; break;
    case 'r': return -1 * SCL_VALUE_ROOK; break;
    case 'q': return -1 * SCL_VALUE_QUEEN; break;
    case 'k': return -1 * SCL_VALUE_KING; break;
    default: break;
  }

  return 0;
}

#define ATTACK_BONUS 3
#define MOBILITY_BONUS 10
#define CENTER_BONUS 7
#define CHECK_BONUS 5
#define KING_CASTLED_BONUS 30
#define KING_BACK_BONUS 15
#define KING_NOT_CENTER_BONUS 15
#define PAWN_NON_DOUBLE_BONUS 3
#define PAWN_PAIR_BONUS 3
#define KING_CENTERNESS 10

int16_t _SCL_rateKingEndgamePosition(uint8_t position)
{
  int16_t result = 0;
  uint8_t rank = position / 8;
  position %= 8;

  if (position > 1 && position < 6)
    result += KING_CENTERNESS;

  if (rank > 1 && rank < 6)
    result += KING_CENTERNESS;

  return result;
}

int16_t SCL_boardEvaluateStatic(SCL_Board board)
{
  uint8_t position = SCL_boardGetPosition(board);
  
  int16_t total = 0;                        

  switch (position)
  {
    case SCL_POSITION_MATE:
      return SCL_boardWhitesTurn(board) ? 
        -1 * SCL_EVALUATION_MAX_SCORE : SCL_EVALUATION_MAX_SCORE;
      break;

    case SCL_POSITION_STALEMATE:
    case SCL_POSITION_DEAD:
      return 0;
      break;

    /*
      main points are assigned as follows:
      - points for material as a sum of all material on board
      - for playing side: if a piece attacks piece of greater value, a fraction
        of the value difference is gained (we suppose exchange), this is only
        gained once per every attacking piece (maximum gain is taken), we only
        take fraction so that actually taking the piece is favored
      - ATTACK_BONUS points for any attacked piece

      other points are assigned as follows (in total these shouldn't be more
      than the value of one pawn)
      - mobility: MOBILITY_BONUS points for each piece with at least 4 possible
        moves
      - center control: CENTER_BONUS points for a piece on a center square
      - CHECK_BONUS points for check
      - king:
        - safety (non endgame): KING_BACK_BONUS points for king on staring rank,
          additional KING_CASTLED_BONUS if the kind if on castled square or
          closer to the edge, additional KING_NOT_CENTER_BONUS for king not on
          its start neighbouring center square
        - center closeness (endgame): up to 2 * KING_CENTERNESS points for
          being closer to center
      - non-doubled pawns: PAWN_NON_DOUBLE_BONUS points for each pawn without
        same color pawn directly in front of it 
      - pawn structure: PAWN_PAIR_BONUS points for each pawn guarding own pawn
      - advancing pawns: 1 point for each pawn's rank in its move
        direction
    */

    case SCL_POSITION_CHECK:
      total += SCL_boardWhitesTurn(board) ? -1 * CHECK_BONUS : CHECK_BONUS;
    case SCL_POSITION_NORMAL:
    default:
    {
      SCL_SquareSet moves;

      const char *p = board;

      int16_t positiveMaterial = 0;
      uint8_t endgame = 0;

      // first count material to see if this is endgame or not
      for (uint8_t i = 0; i < SCL_BOARD_SQUARES; ++i, ++p)
      {
        char s = *p;

        if (s != '.')
        {
          positiveMaterial += SCL_pieceValuePositive(s);
          total += SCL_pieceValue(s);
        }
      }

      endgame = positiveMaterial <= SCL_ENDGAME_MATERIAL_LIMIT;

      p = board;

      for (uint8_t i = 0; i < SCL_BOARD_SQUARES; ++i, ++p)
      {
        char s = *p;

        if (s != '.')
        {
          uint8_t white = SCL_pieceIsWhite(s);

          switch (s)
          {
            case 'k': // king safety
              if (endgame)
                total -= _SCL_rateKingEndgamePosition(i);
              else if (i >= 56)
              {
                total -= KING_BACK_BONUS;

                if (i != 59)
                {
                  total -= KING_NOT_CENTER_BONUS;

                  if (i >= 62 || i <= 58)
                    total -= KING_CASTLED_BONUS;
                }
              }
            break;

            case 'K':
              if (endgame)
                total += _SCL_rateKingEndgamePosition(i);
              else if (i <= 7)
              {
                total += KING_BACK_BONUS;

                if (i != 3)
                {
                  total += KING_NOT_CENTER_BONUS;

                  if (i <= 2 || i >= 6)
                    total += KING_CASTLED_BONUS;
                }
              }
            break;

            case 'P': // pawns
            case 'p':
            {
              int8_t rank = i / 8;

              if (rank != 0 && rank != 7)
              {
                if (s == 'P')
                {
                  total += rank;

                  char *tmp = board + i + 8;

                  if (*tmp != 'P')
                    total += PAWN_NON_DOUBLE_BONUS;

                  if (i % 8 != 7)
                  {
                    tmp++;

                    if (*tmp == 'P')
                      total += PAWN_PAIR_BONUS;

                    if (*(tmp - 16) == 'P')
                      total += PAWN_PAIR_BONUS;
                  }
                }
                else
                {
                  total -= 7 - rank;

                  char *tmp = board + i - 8;

                  if (*tmp != 'p')
                    total -= PAWN_NON_DOUBLE_BONUS;

                  if (i % 8 != 7)
                  {
                    tmp += 17;

                    if (*tmp == 'p')
                      total -= PAWN_PAIR_BONUS;

                    if (*(tmp - 16) == 'p')
                      total -= PAWN_PAIR_BONUS;
                  }
                }
              }
           
              break;
            }

            default: break;
          }

          if (i >= 27 && i <= 36 && (i >= 35 || i <= 28)) // center control
            total += white ? CENTER_BONUS : (-1 * CENTER_BONUS);

          // for performance we only take pseudo moves
          SCL_boardGetPseudoMoves(board,i,0,moves);

          if (SCL_squareSetSize(moves) >= 4) // mobility
            total += white ? 
              MOBILITY_BONUS : (-1 * MOBILITY_BONUS);

          int16_t exchangeBonus = 0;

          SCL_SQUARE_SET_ITERATE_BEGIN(moves)

            if (board[iteratedSquare] != '.')
            {
              total += white ? 
                ATTACK_BONUS : (- 1 * ATTACK_BONUS);

              if (SCL_boardWhitesTurn(board) == white)
              {
                int16_t valueDiff = 
                  SCL_pieceValuePositive(board[iteratedSquare]) - 
                  SCL_pieceValuePositive(s);

                valueDiff /= 4; // only take a fraction to favor taking

                if (valueDiff > exchangeBonus)
                  exchangeBonus = valueDiff;
              }
            }

          SCL_SQUARE_SET_ITERATE_END

          if (exchangeBonus != 0)
            total += white ? exchangeBonus : -1 * exchangeBonus;
        }
      } // for each square

      return total;

      break;

    } // normal position
  } // switch

  return 0;
}

#undef ATTACK_BONUS
#undef MOBILITY_BONUS
#undef CENTER_BONUS
#undef CHECK_BONUS
#undef KING_CASTLED_BONUS
#undef KING_BACK_BONUS
#undef PAWN_NON_DOUBLE_BONUS
#undef PAWN_PAIR_BONUS
#undef KING_CENTERNESS

SCL_StaticEvaluationFunction _SCL_staticEvaluationFunction;
int16_t _SCL_currentEval;
int8_t _SCL_depthHardLimit;

/**
  Inner recursive function for SCL_boardEvaluateDynamic. It is passed a square
  (or -1) at which last capture happened, to implement capture extension.
*/
int16_t _SCL_boardEvaluateDynamic(SCL_Board board, int8_t depth,
  int16_t alphaBeta, int8_t takenSquare)
{
#if SCL_COUNT_EVALUATED_POSITIONS
  SCL_positionsEvaluated++;
#endif

#if SCL_CALL_WDT_RESET
  wdt_reset();
#endif

  uint8_t whitesTurn = SCL_boardWhitesTurn(board);
  int8_t valueMultiply = whitesTurn ? 1 : -1;
  int16_t bestMoveValue = -1 * SCL_EVALUATION_MAX_SCORE;
  uint8_t shouldCompute = depth > 0;
  uint8_t extended = 0;
  uint8_t positionType = SCL_boardGetPosition(board);

  if (!shouldCompute)
  {
    /* here we do two extensions (deeper search): taking on a same square 
      (exchanges) and checks (good for mating and preventing mates): */
    extended =
      (depth > _SCL_depthHardLimit) &&
      (takenSquare >= 0 ||
      (SCL_boardGetPosition(board) == SCL_POSITION_CHECK));

    shouldCompute = extended;
  }

#if SCL_DEBUG_AI
  char moveStr[8];
  uint8_t debugFirst = 1;
#endif

  if (shouldCompute &&
    (positionType == SCL_POSITION_NORMAL || positionType == SCL_POSITION_CHECK))
  {
#if SCL_DEBUG_AI
    putchar('(');
#endif

    alphaBeta *= valueMultiply;
    uint8_t end = 0;
    const char *b = board;

    depth--;

    for (uint8_t i = 0; i < SCL_BOARD_SQUARES; ++i, ++b)
    {
      char s = *b;

      if (s != '.' && SCL_pieceIsWhite(s) == whitesTurn)
      {
        SCL_SquareSet moves;

        SCL_squareSetClear(moves);

        SCL_boardGetMoves(board,i,moves);

        if (!SCL_squareSetEmpty(moves))
        {
          SCL_SQUARE_SET_ITERATE_BEGIN(moves)

            int8_t captureExtension = -1;
            
            if (board[iteratedSquare] != '.' &&   // takes a piece
              (takenSquare == -1 ||               // extend on first taken sq. 
              (extended && takenSquare != -1) ||  // ignore check extension
              (iteratedSquare == takenSquare)))   // extend on same sq. taken
              captureExtension = iteratedSquare;

            SCL_MoveUndo undo = SCL_boardMakeMove(board,i,iteratedSquare,'q');

            uint8_t s0Dummy, s1Dummy;
            char pDummy;

            SCL_UNUSED(s0Dummy);
            SCL_UNUSED(s1Dummy);
            SCL_UNUSED(pDummy);

#if SCL_DEBUG_AI
            if (debugFirst)
              debugFirst = 0;
            else
              putchar(',');

            if (extended)
              putchar('*');

            printf("%s ",SCL_moveToString(board,i,iteratedSquare,'q',moveStr));
#endif

            int16_t value = _SCL_boardEvaluateDynamic(
              board,
              depth, // this is depth - 1, we decremented it
#if SCL_ALPHA_BETA
              valueMultiply * bestMoveValue,
#else
              0,
#endif      
              captureExtension
              ) * valueMultiply;

            SCL_boardUndoMove(board,undo);

            if (value > bestMoveValue) 
            {
              bestMoveValue = value;

#if SCL_ALPHA_BETA
              // alpha-beta pruning:

              if (value > alphaBeta) // no, >= can't be here
              {
                end = 1;
                iterationEnd = 1;
              }
#endif
            }

          SCL_SQUARE_SET_ITERATE_END
        } // !squre set empty?
      } // valid piece?

      if (end)
        break;

    } // for each square

#if SCL_DEBUG_AI
  putchar(')');
#endif
  }
  else // don't dive recursively, evaluate statically
  {
    bestMoveValue = valueMultiply *
  #ifndef SCL_EVALUATION_FUNCTION
      _SCL_staticEvaluationFunction(board);
  #else
      SCL_EVALUATION_FUNCTION(board);
  #endif

    /* For stalemate return the opposite value of the board, i.e. if the
       position is good for white, then stalemate is good for black and vice
       versa. */
    if (positionType == SCL_POSITION_STALEMATE)
      bestMoveValue *= -1;
  }

  /* Here we either improve (if the move worsens the situation) or devalve (if
     it improves the situation) the result: this needs to be done so that good
     moves far away are seen as worse compared to equally good moves achieved
     in fewer moves. Without this an AI in winning situation may just repeat
     random moves and draw by repetition even if it has mate in 1 (it sees all
     moves as leading to mate). */
  bestMoveValue += bestMoveValue > _SCL_currentEval * valueMultiply ? -1 : 1;

#if SCL_DEBUG_AI
  printf("%d",bestMoveValue * valueMultiply);
#endif

  return bestMoveValue * valueMultiply;
}

int16_t SCL_boardEvaluateDynamic(SCL_Board board, uint8_t baseDepth,
  uint8_t extensionExtraDepth, SCL_StaticEvaluationFunction evalFunction)
{
  _SCL_staticEvaluationFunction = evalFunction;
  _SCL_currentEval = evalFunction(board);
  _SCL_depthHardLimit = 0;
  _SCL_depthHardLimit -= extensionExtraDepth;

  return _SCL_boardEvaluateDynamic(
    board,
    baseDepth,
    SCL_boardWhitesTurn(board) ? 
      SCL_EVALUATION_MAX_SCORE : (-1 * SCL_EVALUATION_MAX_SCORE),-1); 
}

void SCL_boardRandomMove(SCL_Board board, SCL_RandomFunction randFunc,
  uint8_t *squareFrom, uint8_t *squareTo, char *resultProm)
{
  *resultProm = (randFunc() < 128) ? 
    ((randFunc() < 128) ? 'r' : 'n') : 
    ((randFunc() < 128) ? 'b' : 'q');

  SCL_SquareSet set;
  uint8_t white = SCL_boardWhitesTurn(board);
  const char *s = board;

  SCL_squareSetClear(set);

  // find squares with pieces that have legal moves

  for (uint8_t i = 0; i < SCL_BOARD_SQUARES; ++i, ++s)
  {
    char c = *s;

    if (c != '.' && SCL_pieceIsWhite(c) == white)
    {
      SCL_SquareSet moves;

      SCL_boardGetMoves(board,i,moves);

      if (SCL_squareSetSize(moves) != 0)
        SCL_squareSetAdd(set,i);
    }
  }
 
  *squareFrom = SCL_squareSetGetRandom(set,randFunc);

  SCL_boardGetMoves(board,*squareFrom,set);

  *squareTo = SCL_squareSetGetRandom(set,randFunc);
}

void SCL_printBoardSimple(
  SCL_Board board,
  SCL_PutCharFunction putCharFunc,
  uint8_t selectSquare,
  uint8_t format)
{
  SCL_SquareSet s;

  SCL_squareSetClear(s);

  SCL_printBoard(board,putCharFunc,s,selectSquare,format,1,1,0);
}

int16_t SCL_getAIMove(
  SCL_Board board,
  uint8_t baseDepth,
  uint8_t extensionExtraDepth,
  uint8_t endgameExtraDepth,
  SCL_StaticEvaluationFunction evalFunc,
  SCL_RandomFunction randFunc,
  uint8_t randomness,
  uint8_t repetitionMoveFrom,
  uint8_t repetitionMoveTo,
  uint8_t *resultFrom,
  uint8_t *resultTo,
  char *resultProm)
{
#if SCL_DEBUG_AI
  puts("===== AI debug =====");
  putchar('(');
  unsigned char debugFirst = 1;
  char moveStr[8];
#endif 

  if (baseDepth == 0)
  {
    SCL_boardRandomMove(board,randFunc,resultFrom,resultTo,resultProm);
#ifndef SCL_EVALUATION_FUNCTION
    return evalFunc(board);
#else
    return SCL_EVALUATION_FUNCTION(board);
#endif
  }

  if (SCL_boardEstimatePhase(board) == SCL_PHASE_ENDGAME)
    baseDepth += endgameExtraDepth;

  *resultFrom = 0;
  *resultTo = 0;
  *resultProm = 'q';

  int16_t bestScore =
    SCL_boardWhitesTurn(board) ?
    -1 * SCL_EVALUATION_MAX_SCORE - 1 : (SCL_EVALUATION_MAX_SCORE + 1);

  for (uint8_t i = 0; i < SCL_BOARD_SQUARES; ++i)
    if (board[i] != '.' && 
      SCL_boardWhitesTurn(board) == SCL_pieceIsWhite(board[i]))
    {
      SCL_SquareSet moves;

      SCL_squareSetClear(moves);

      SCL_boardGetMoves(board,i,moves);

      SCL_SQUARE_SET_ITERATE_BEGIN(moves)

        int16_t score = 0;

#if SCL_DEBUG_AI
      if (debugFirst)
        debugFirst = 0;
      else
        putchar(',');

printf("%s ",SCL_moveToString(
board,i,iteratedSquare,'q',moveStr));

#endif

        if (i != repetitionMoveFrom || iteratedSquare != repetitionMoveTo)
        {
          SCL_MoveUndo undo = SCL_boardMakeMove(board,i,iteratedSquare,'q');

          score = SCL_boardEvaluateDynamic(board,baseDepth - 1,
            extensionExtraDepth,evalFunc);

          SCL_boardUndoMove(board,undo);
        }

        if (randFunc != 0 &&
          randomness > 1 &&
          score < 16000 && 
          score > -16000)
        {
          /*^ We limit randomizing by about half the max score for two reasons:
            to prevent over/under flows and secondly we don't want to alter
            the highest values for checkmate -- these are modified by tiny
            values depending on their depth so as to prevent endless loops in
            which most moves are winning, biasing such values would completely
            kill that algorithm */

          int16_t bias = randFunc();
          bias = (bias - 128) / 2;
          bias *= randomness - 1;
          score += bias;
        }

        uint8_t comparison =
          score == bestScore;

        if ((comparison != 1) &&
          (
            (SCL_boardWhitesTurn(board) && score > bestScore) ||
            (!SCL_boardWhitesTurn(board) && score < bestScore)
          ))
          comparison = 2;

        uint8_t replace = 0;

        if (randFunc == 0)
          replace = comparison == 2;
        else
          replace = (comparison == 2) ||
          ((comparison == 1) && (randFunc() < 160)); // not uniform distr. but simple

        if (replace)
        {
          *resultFrom = i;
          *resultTo = iteratedSquare;
          bestScore = score;
        }

      SCL_SQUARE_SET_ITERATE_END
    }

#if SCL_DEBUG_AI
  printf(")%d %s\n",bestScore,SCL_moveToString(board,*resultFrom,*resultTo,'q',moveStr));
  puts("===== AI debug end ===== ");
#endif 

  return bestScore;
}

uint8_t SCL_boardToFEN(SCL_Board board, char *string)
{
  uint8_t square = 56;
  uint8_t spaces = 0;
  uint8_t result = 0;
 
  #define put(c) { *string = (c); string++; result++; }

  while (1) // pieces
  {
    char s = board[square];

    if (s == '.')
    {
      spaces++;
    }
    else
    {
      if (spaces != 0)
      {
        put('0' + spaces)
        spaces = 0; 
      }

      put(s)
    }

    square++;

    if (square % 8 == 0)
    {
      if (spaces != 0)
      {
        put('0' + spaces)
        spaces = 0; 
      }

      if (square == 8)
        break;
   
      put('/'); 

      square -= 16;
    }
  }

  put(' ');
  put(SCL_boardWhitesTurn(board) ? 'w' : 'b');
  put(' ');

  uint8_t b = board[SCL_BOARD_ENPASSANT_CASTLE_BYTE] & 0xf0;

  if (b != 0) // castling
  {
    if (b & 0x10) put('K');
    if (b & 0x20) put('Q');
    if (b & 0x40) put('k');
    if (b & 0x80) put('q');
  }
  else
    put('-');

  put(' ');

  b = board[SCL_BOARD_ENPASSANT_CASTLE_BYTE] & 0x0f;

  if (b < 8)
  {
    put('a' + b);
    put(SCL_boardWhitesTurn(board) ? '6' : '3');
  }
  else
    put('-');

  for (uint8_t i = 0; i < 2; ++i)
  {
    put(' ');

    uint8_t moves = i == 0 ?
      ((uint8_t) board[SCL_BOARD_MOVE_COUNT_BYTE]) :
      (((uint8_t) board[SCL_BOARD_PLY_BYTE]) / 2 + 1);

    uint8_t hundreds = moves / 100;
    uint8_t tens = (moves % 100) / 10;

    if (hundreds != 0)
    {
      put('0' + hundreds);
      put('0' + tens);
    }
    else if (tens != 0)
      put('0' + tens);

    put('0' + moves % 10);
    
  }

  *string = 0; // terminate the string

  return result + 1;

  #undef put
}

uint8_t SCL_boardFromFEN(SCL_Board board, const char *string)
{
  uint8_t square = 56;

  while (1)
  {
    char c = *string;

    if (c == 0)
      return 0;

    if (c != '/' && c != ' ') // ignore line separators
    {
      if (c < '9') // empty square sequence
      {
        while (c > '0')
        {
          board[square] = '.';
          square++;
          c--;
        }
      }
      else // piece
      {
        board[square] = c;
        square++;
      }
    }
    else
    {
      if (square == 8)
        break;

      square -= 16;
    }

    string++;
  }

#define nextChar string++; if (*string == 0) return 0;

  nextChar // space

  board[SCL_BOARD_PLY_BYTE] = *string == 'b';
  nextChar

  nextChar // space

  uint8_t castleEnPassant = 0x0;

  while (*string != ' ')
  {
    switch (*string)
    {
      case 'K': castleEnPassant |= 0x10; break;
      case 'Q': castleEnPassant |= 0x20; break;
      case 'k': castleEnPassant |= 0x40; break;
      case 'q': castleEnPassant |= 0x80; break;
      default: castleEnPassant |= 0xf0; break;  // for partial XFEN compat.
    }

    nextChar
  }

  nextChar // space

  if (*string != '-')
  {
    castleEnPassant |= *string - 'a';
    nextChar
  }
  else
    castleEnPassant |= 0x0f;

  nextChar

  board[SCL_BOARD_ENPASSANT_CASTLE_BYTE] = castleEnPassant;

  for (uint8_t i = 0; i < 2; ++i)
  {
    nextChar // space

    uint8_t ply = 0;

    while (1)
    {
      char c = *string;

      if (c < '0' || c > '9')
        break;

      ply = ply * 10 + (c - '0'); 

      string++;
    }

    if (i == 0 && *string == 0)
      return 0;

    if (i == 0)
      board[SCL_BOARD_MOVE_COUNT_BYTE] = ply;
    else
      board[SCL_BOARD_PLY_BYTE] += (ply - 1) * 2;
  }

#if SCL_960_CASTLING
  _SCL_board960RememberRookPositions(board);
#endif

  return 1;
#undef nextChar
}

uint8_t SCL_boardEstimatePhase(SCL_Board board)
{
  uint16_t totalMaterial = 0;

  uint8_t ply = board[SCL_BOARD_PLY_BYTE];

  for (uint8_t i = 0; i < SCL_BOARD_SQUARES; ++i)
  {
    char s = *board;

    if (s != '.')
    {
      int16_t v = SCL_pieceValue(s);

      if (!SCL_pieceIsWhite(s))
        v *= -1;

      totalMaterial += v;
    }

    board++;
  }

  if (totalMaterial < SCL_ENDGAME_MATERIAL_LIMIT)
    return SCL_PHASE_ENDGAME;

  if (ply <= 10 && (totalMaterial >= SCL_START_MATERIAL - 3 * SCL_VALUE_PAWN))
    return SCL_PHASE_OPENING;    

  return SCL_PHASE_MIDGAME;
}

#define SCL_IMAGE_COUNT 12

static const uint8_t SCL_images[8 * SCL_IMAGE_COUNT] =
{
  0xff,0xff,0xff,0xff,0xff,0xff,0xff,0xff,0xff,0xff,0xff,0xff,
  0xff,0x81,0xff,0xff,0xff,0xff,0xff,0x81,0xff,0xff,0xff,0xff,
  0xff,0x81,0xe7,0xf7,0xf7,0xaa,0xff,0xbd,0xe7,0xf7,0xf7,0xaa,
  0xff,0xc3,0xc3,0xe3,0xc1,0x80,0xff,0x99,0xdb,0xeb,0xc9,0x94,
  0xe7,0xc3,0x81,0xc1,0x94,0x80,0xe7,0xdb,0xbd,0xdd,0xbe,0xbe,
  0xc3,0xc3,0x91,0xe3,0x80,0x80,0xdb,0x99,0x8d,0xeb,0xaa,0xbe,
  0xc3,0x81,0xe1,0xc1,0xc1,0xc1,0xdb,0xbd,0xdd,0xe3,0xdd,0xdd,
  0x81,0x81,0xc1,0x9c,0xc1,0xc1,0x81,0x81,0xc1,0x9c,0xc1,0xc1
};

void SCL_drawBoard(
  SCL_Board board,
  SCL_PutPixelFunction putPixel,
  uint8_t selectedSquare,
  SCL_SquareSet highlightSquares,
  uint8_t blackDown)
{
  uint8_t row = 0;
  uint8_t col = 0;
  uint8_t x = 0;
  uint8_t y = 0;
  uint16_t n = 0;
  uint8_t s = 0;

  uint8_t pictureLine = 0;
  uint8_t loadLine = 1;

  while (row < 8)
  {
    if (loadLine)
    {
      s = blackDown ? (row * 8 + (7 - col)) : ((7 - row) * 8 + col);

      char piece = board[s];

      if (piece == '.')
        pictureLine = (y == 4) ? 0xef : 0xff;
      else
      {
        uint8_t offset = SCL_pieceIsWhite(piece) ? 6 : 0;
        piece = SCL_pieceToColor(piece,1);

        switch (piece)
        {
          case 'R': offset += 1; break;
          case 'N': offset += 2; break;
          case 'B': offset += 3; break;
          case 'K': offset += 4; break;
          case 'Q': offset += 5; break;
          default: break;
        }
      
        pictureLine = SCL_images[y * SCL_IMAGE_COUNT + offset];
      }

      if (SCL_squareSetContains(highlightSquares,s))
        pictureLine &= (y % 2) ? 0xaa : 0x55;
      
      if (s == selectedSquare)
        pictureLine &= (y == 0 || y == 7) ? 0x00 : ~0x81;

      loadLine = 0;
    }

    putPixel(pictureLine & 0x80,n);
    pictureLine <<= 1;

    n++;
    x++;

    if (x == 8)
    {
      col++;
      loadLine = 1;
      x = 0;
    }

    if (col == 8)
    {
      y++;
      col = 0;
      x = 0;
    }

    if (y == 8)
    {
      row++;
      y = 0;
    }
  }
}

uint32_t SCL_boardHash32(const SCL_Board board)
{
  uint32_t result = (board[SCL_BOARD_PLY_BYTE] & 0x01) +
    (((uint32_t) ((uint8_t) board[SCL_BOARD_ENPASSANT_CASTLE_BYTE])) << 24) +
    board[SCL_BOARD_MOVE_COUNT_BYTE];

  const char *b = board;

  for (uint8_t i = 0; i < SCL_BOARD_SQUARES; ++i, ++b)
  {
    switch (*b)
    {
#define C(p,n) case p: result ^= (i + 1) * n; break;
      // the below number are primes
      C('P',4003)
      C('R',84673)
      C('N',93911)
      C('B',999331)
      C('Q',909091)
      C('K',2796203)
      C('p',4793)
      C('r',19391)
      C('n',391939)
      C('b',108301)
      C('q',174763)
      C('k',2474431)
#undef C
      default: break;
    }
  }

  // for extra spread of values we swap the low/high parts:
  result = (result >> 16) | (result << 16);

  return result;
}

void SCL_boardDisableCastling(SCL_Board board)
{
  board[SCL_BOARD_ENPASSANT_CASTLE_BYTE] &= 0x0f;
}

uint8_t SCL_boardMoveResetsCount(SCL_Board board,
  uint8_t squareFrom, uint8_t squareTo)
{
  return board[squareFrom] == 'P' || board[squareFrom] == 'p' ||
    board[squareTo] != '.';
}

void SCL_printPGN(SCL_Record r, SCL_PutCharFunction putCharFunc,
  SCL_Board initialState)
{
  if (SCL_recordLength(r) == 0)
    return;

  uint16_t pos = 0;

  SCL_Board board;

  if (initialState != 0)
    for (uint8_t i = 0; i < SCL_BOARD_STATE_SIZE; ++i)
      board[i] = initialState[i];
  else
    SCL_boardInit(board);

  while (1)
  {
    uint8_t s0, s1;
    char p;

    uint8_t state = SCL_recordGetMove(r,pos,&s0,&s1,&p);

    pos++;

    if (pos % 2)
    {
      uint8_t move = pos / 2 + 1;

      if (move / 100 != 0)
        putCharFunc('0' + move / 100);

      if (move / 10 != 0 || move / 100 != 0)
        putCharFunc('0' + (move % 100) / 10);

      putCharFunc('0' + move % 10);

      putCharFunc('.');
      putCharFunc(' ');
    }

#if !SCL_960_CASTLING
    if ((board[s0] == 'K' && s0 == 4 && (s1 == 2 || s1 == 6)) ||
      (board[s0] == 'k' && s0 == 60 && (s1 == 62 || s1 == 58)))
#else
    if ((board[s0] == 'K' && board[s1] == 'R') ||
        (board[s0] == 'k' && board[s1] == 'r'))
#endif
    {
      putCharFunc('O');
      putCharFunc('-');
      putCharFunc('O');

#if !SCL_960_CASTLING
      if (s1 == 58 || s1 == 2)
#else
      if ((s1 == (board[SCL_BOARD_EXTRA_BYTE] & 0x07)) ||
          (s1 == 56 + (board[SCL_BOARD_EXTRA_BYTE] & 0x07)))
#endif
      {
        putCharFunc('-');
        putCharFunc('O');
      }
    }
    else
    {
      uint8_t pawn = board[s0] == 'P' || board[s0] == 'p';

      if (!pawn)
      {
        putCharFunc(SCL_pieceToColor(board[s0],1));

        // disambiguation:

        uint8_t specify = 0;

        for (int i = 0; i < SCL_BOARD_SQUARES; ++i)
          if (i != s0 && board[i] == board[s0])
          {
            SCL_SquareSet s;
            
            SCL_squareSetClear(s);

            SCL_boardGetMoves(board,i,s);

            if (SCL_squareSetContains(s,s1))
              specify |= (s0 % 8 != s1 % 8) ? 1 : 2;
          }

        if (specify & 0x01)
          putCharFunc('a' + s0 % 8);

        if (specify & 0x02)
          putCharFunc('1' + s0 / 8);
      }

      if (board[s1] != '.' ||
       (pawn && s0 % 8 != s1 % 8 && board[s1] == '.')) // capture?
      {
        if (pawn)
          putCharFunc('a' + s0 % 8);
          
        putCharFunc('x');
      }
      
      putCharFunc('a' + s1 % 8);
      putCharFunc('1' + s1 / 8);

      if (pawn && (s1 >= 56 || s1 <= 7)) // promotion?
      {
        putCharFunc('=');
        putCharFunc(SCL_pieceToColor(p,1));
      }
    }

    SCL_boardMakeMove(board,s0,s1,p);

    uint8_t position = SCL_boardGetPosition(board);
 
    if (position == SCL_POSITION_CHECK)
      putCharFunc('+');

    if (position == SCL_POSITION_MATE)
    {
      putCharFunc('#');
      break;
    }
    else if (state != SCL_RECORD_CONT)
    {
      putCharFunc('*');
      break;
    }
      
    putCharFunc(' ');
  }
}

void SCL_recordCopy(SCL_Record recordFrom, SCL_Record recordTo)
{
  for (uint16_t i = 0; i < SCL_RECORD_MAX_SIZE; ++i)
    recordTo[i] = recordFrom[i];
}

void SCL_gameInit(SCL_Game *game, const SCL_Board startState)
{
  game->startState = startState;

  if (startState != 0)
    SCL_boardCopy(startState,game->board);
  else
    SCL_boardInit(game->board);

  SCL_recordInit(game->record);

  for (uint8_t i = 0; i < 14; ++i)
    game->prevMoves[i] = 0;
 
  game->state = SCL_GAME_STATE_PLAYING;
  game->ply = 0;

  SCL_recordInit(game->record);
}

uint8_t SCL_gameGetRepetiotionMove(SCL_Game *game,
  uint8_t *squareFrom, uint8_t *squareTo)
{
  if (squareFrom != 0 && squareTo != 0)
  {
      *squareFrom = 0;
      *squareTo = 0;
  }

  /*  pos. 1st         2nd         3rd
            |           |           |
            v           v           v       
             01 23 45 67 89 AB CD EF
     move    ab cd ba dc ab cd ba dc */

  if (game->ply >= 7 &&
    game->prevMoves[0] == game->prevMoves[5] &&
    game->prevMoves[0] == game->prevMoves[8] &&
    game->prevMoves[0] == game->prevMoves[13] &&

    game->prevMoves[1] == game->prevMoves[4] &&
    game->prevMoves[1] == game->prevMoves[9] &&
    game->prevMoves[1] == game->prevMoves[12] &&

    game->prevMoves[2] == game->prevMoves[7] &&
    game->prevMoves[2] == game->prevMoves[10] &&

    game->prevMoves[3] == game->prevMoves[6] &&
    game->prevMoves[3] == game->prevMoves[11]
    )
  {
    if (squareFrom != 0 && squareTo != 0)
    {
      *squareFrom = game->prevMoves[3];
      *squareTo = game->prevMoves[2];
    }

    return 1;
  } 

  return 0;
}

void SCL_gameMakeMove(SCL_Game *game, uint8_t squareFrom, uint8_t squareTo,
  char promoteTo)
{
  uint8_t repetitionS0, repetitionS1;

  SCL_gameGetRepetiotionMove(game,&repetitionS0,&repetitionS1);
  SCL_boardMakeMove(game->board,squareFrom,squareTo,promoteTo);
  SCL_recordAdd(game->record,squareFrom,squareTo,promoteTo,SCL_RECORD_CONT);
  // ^ TODO: SCL_RECORD_CONT

  game->ply++;

  for (uint8_t i = 0; i < 14 - 2; ++i)
    game->prevMoves[i] = game->prevMoves[i + 2];

  game->prevMoves[12] = squareFrom;
  game->prevMoves[13] = squareTo;

  if (squareFrom == repetitionS0 && squareTo == repetitionS1)
    game->state = SCL_GAME_STATE_DRAW_REPETITION;
  else if (game->board[SCL_BOARD_MOVE_COUNT_BYTE] >= 50)
    game->state = SCL_GAME_STATE_DRAW_50;
  else
  {
    uint8_t position = SCL_boardGetPosition(game->board);

    switch (position)
    {
      case SCL_POSITION_MATE:
        game->state = SCL_boardWhitesTurn(game->board) ?
          SCL_GAME_STATE_BLACK_WIN : SCL_GAME_STATE_WHITE_WIN;
        break;

      case SCL_POSITION_STALEMATE:
        game->state = SCL_GAME_STATE_DRAW_STALEMATE;
        break;

      case SCL_POSITION_DEAD:
        game->state = SCL_GAME_STATE_DRAW_DEAD;
        break;

      default: break;
    }
  }
}

uint8_t SCL_gameUndoMove(SCL_Game *game)
{
  if (game->ply == 0)
    return 0;

  if ((game->ply - 1) > SCL_recordLength(game->record))
    return 0; // can't undo, lacking record

  SCL_Record r;

  SCL_recordCopy(game->record,r);

  uint16_t applyMoves = game->ply - 1;

  SCL_gameInit(game,game->startState);

  for (uint16_t i = 0; i < applyMoves; ++i)
  {
    uint8_t s0, s1;
    char p;

    SCL_recordGetMove(r,i,&s0,&s1,&p);
    SCL_gameMakeMove(game,s0,s1,p);
  }
    
  return 1;
}

uint8_t SCL_boardMoveIsLegal(SCL_Board board, uint8_t squareFrom,
  uint8_t squareTo)
{
  if (squareFrom >= SCL_BOARD_SQUARES || squareTo >= SCL_BOARD_SQUARES)
    return 0;

  char piece = board[squareFrom];

  if ((piece == '.') ||
    (SCL_boardWhitesTurn(board) != SCL_pieceIsWhite(piece)))
    return 0;

  SCL_SquareSet moves;

  SCL_boardGetMoves(board,squareFrom,moves);

  return SCL_squareSetContains(moves,squareTo);
}

#endif // guard