@mirasen/chessboard 1.1.0 → 1.1.2

package/CHANGELOG.md

@@ -1,5 +1,20 @@
 # @mirasen/chessboard
 
+## 1.1.2
+
+### Patch Changes
+
+- 6c108b6: Export public input types for wrapper packages.
+
+## 1.1.1
+
+### Patch Changes
+
+- 8b3781c: dependabot: directory '/', update @ktarmyshov/assert
+- 8b3781c: dependabot: directory '/', update es-toolkit
+- 8b3781c: dependabot: directory '/', update typescript-eslint
+- c877d35: dependabot: directory '/', update jsdom
+
 ## 1.1.0
 
 ### Minor Changes

package/README.md

@@ -8,6 +8,12 @@
 
 A framework-agnostic TypeScript chessboard platform with real chess interaction built in and an extension-driven architecture.
 
+## Try it live
+
+- [Play a chess.js game](https://mirasen.io/chessboard/examples/chessjs.html)
+- [Try the promotion flow](https://mirasen.io/chessboard/examples/promotion.html)
+- [Try the minimal example](https://mirasen.io/chessboard/examples/minimal.html)
+
 ## Why this exists
 
 Most chessboards fall into one of two buckets:
@@ -68,15 +74,6 @@ Rules and legality still belong to your game layer. Use the built-in `chess.js`
 npm install @mirasen/chessboard
 ```
 
-## Live examples
-
-Interactive examples are available on the Mirasen website:
-
-- [Examples overview](https://mirasen.io/chessboard/examples/)
-- [Minimal interactive example](https://mirasen.io/chessboard/examples/minimal.html)
-- [Promotion example](https://mirasen.io/chessboard/examples/promotion.html)
-- [chess.js game example](https://mirasen.io/chessboard/examples/chessjs.html)
-
 ## Usage
 
 ### Minimal example
@@ -297,12 +294,16 @@ A board that only renders pieces and leaves everything else to app code often fo
 
 A board that handles everything internally without clean boundaries becomes difficult to evolve, customize, or extend.
 
+### Opt out, not build up
+
 `@mirasen/chessboard` aims for a middle path:
 
 - strong built-in baseline interaction
 - clean internal architecture
 - extension-driven feature growth
 
+Common chessboard behavior is included by default: rendering, interaction, selection, legal target feedback, promotion, and animation. You start from a working interaction baseline and remove or replace extensions only when you want less or need something different.
+
 ## Project direction
 
 This platform is being built as a foundation for richer chess learning and interaction workflows, but the board itself is designed to stand as a serious open-source UI platform in its own right.
@@ -323,7 +324,3 @@ For details, see:
 
 - [./assets/pieces/chessnut/ATTRIBUTION.md](./assets/pieces/chessnut/ATTRIBUTION.md)
 - [./assets/pieces/chessnut/LICENSE.txt](./assets/pieces/chessnut/LICENSE.txt)
-
-```
-
-```

package/dist/extensions/factory/runtime.js

@@ -45,8 +45,11 @@ function createExtensionRuntimeSurfaceEvents(getInternalState, runtimeSurfaceEve
                 subscribers = new Set();
                 internalState.eventSubscribers.set(type, subscribers);
             }
+            const sizeBeforeAdd = subscribers.size;
             subscribers.add(extensionDef.id);
-            runtimeSurfaceEvents.subscribeEvent(type);
+            if (sizeBeforeAdd === 0) {
+                runtimeSurfaceEvents.subscribeEvent(type);
+            }
         },
         unsubscribeEvent(type) {
             const internalState = getInternalState();

package/dist/extensions/first-party/legal-moves/types.js

@@ -6,14 +6,14 @@ export const DEFAULT_CONFIG = {
             color: 'rgb(0, 0, 0)',
             opacity: 0.14
         },
-        radiusRatio: 0.125
-    }, // semi-transparent black
+        radiusRatio: 0.165
+    },
     captureTarget: {
         color: {
             color: 'rgb(0, 0, 0)',
             opacity: 0.14
         },
-        radiusRatio: 0.45,
-        strokeWidthRatio: 0.1
+        radiusRatio: 0.445,
+        strokeWidthRatio: 0.11
     }
 };

package/dist/index.d.ts

@@ -1,5 +1,5 @@
 export type { MoveOutput } from './extensions/build/index.js';
-export type { MoveRequestInput, PiecePositionRecordString } from './state/board/types/input.js';
-export type { MoveDestinationInput } from './state/interaction/types/input.js';
+export type { ColorInput, MoveRequestInput, PiecePositionRecordString, PositionInput } from './state/board/types/input.js';
+export type { MovabilityInput, MoveDestinationInput } from './state/interaction/types/input.js';
 export { createBoard } from './wrapper/factory.js';
 export type { Chessboard, ChessboardExtensionInput, ChessboardInitOptions } from './wrapper/types.js';

package/dist/runtime/mutation/last-move.js

@@ -11,7 +11,7 @@ export const updateLastMoveOnBoardMove = (context, mutationSession) => {
 export const clearLastMoveOnBoardSetPosition = (context, mutationSession) => {
     const { current } = context;
     if (!mutationSession.hasMutation({
-        causes: ['state.board.setPosition', 'state.board.setPiecePosition']
+        causes: ['state.board.setPosition', 'state.board.setPiecePosition', 'state.board.setTurn']
     })) {
         return;
     }

package/dist/state/board/check.d.ts

@@ -1,12 +1,13 @@
 import { Color, ColorShort, MoveRequestInput, Piece, PiecePositionInput, PiecePositionRecord, PiecePositionRecordShort, PiecePositionRecordString, PieceShort, PieceString, Role, RoleShort, SquareString } from './types/input.js';
-import { EmptyPieceCode, MoveRequest, NonEmptyPieceCode, PieceCode, RolePromotionCode, Square, SquareFile, SquareRank } from './types/internal.js';
-import { BoardStateSnapshot } from './types/main.js';
+import { EmptyPieceCode, MoveRequest, NonEmptyPieceCode, PieceCode, PiecePositionSnapshot, PositionSnapshot, RolePromotionCode, Square, SquareFile, SquareRank } from './types/internal.js';
+import type { BoardStateSnapshot } from './types/main.js';
 export declare function isWhitePieceCode(code: NonEmptyPieceCode): boolean;
 export declare function isBlackPieceCode(code: NonEmptyPieceCode): boolean;
 export declare function isOccupied(board: BoardStateSnapshot, sq: Square): boolean;
 export declare function isEmptyPieceCode(code: PieceCode): code is EmptyPieceCode;
 export declare function isNonEmptyPieceCode(code: PieceCode): code is NonEmptyPieceCode;
-export declare function piecePositionsEqual(pos1: BoardStateSnapshot, pos2: BoardStateSnapshot): boolean;
+export declare function piecePositionsEqual(pos1: PiecePositionSnapshot, pos2: PiecePositionSnapshot): boolean;
+export declare function positionsEqual(pos1: PositionSnapshot, pos2: PositionSnapshot): boolean;
 export declare function isRank(n: number): n is SquareRank;
 export declare function isFile(n: number): n is SquareFile;
 export declare function isValidSquare(n: number): n is Square;

package/dist/state/board/check.js

@@ -15,7 +15,7 @@ export function isNonEmptyPieceCode(code) {
     return code !== 0 /* PieceCode.Empty */;
 }
 export function piecePositionsEqual(pos1, pos2) {
-    if (pos1.positionEpoch !== pos2.positionEpoch)
+    if (pos1.pieces.length !== pos2.pieces.length)
         return false;
     for (let i = 0; i < pos1.pieces.length; i++) {
         if (pos1.pieces[i] !== pos2.pieces[i])
@@ -23,6 +23,11 @@ export function piecePositionsEqual(pos1, pos2) {
     }
     return true;
 }
+export function positionsEqual(pos1, pos2) {
+    if (pos1.turn !== pos2.turn)
+        return false;
+    return piecePositionsEqual(pos1, pos2);
+}
 export function isRank(n) {
     return Number.isInteger(n) && n >= 0 && n < 8;
 }

package/dist/state/board/factory.js

@@ -2,7 +2,7 @@ import { cloneDeep } from 'es-toolkit/object';
 import { isNormalizedMoveRequest } from './check.js';
 import { normalizeColor, normalizeMoveRequest } from './normalize.js';
 import { boardParsePiecePositionInput, boardParsePosition } from './position.js';
-import { boardMove, boardSetPosition, boardSetTurn } from './reducers.js';
+import { boardMove, boardSetPiecePosition, boardSetPosition, boardSetTurn } from './reducers.js';
 function createBoardStateInternal(position) {
     const parsedPosition = boardParsePosition(position);
     return {
@@ -16,13 +16,11 @@ export function createBoardState(position) {
     return {
         setPosition(input, mutationSession) {
             const position = boardParsePosition(input);
-            let changed = boardSetPosition(internalState, position.pieces);
-            changed = boardSetTurn(internalState, position.turn) || changed;
-            return mutationSession.addMutation('state.board.setPosition', changed);
+            return mutationSession.addMutation('state.board.setPosition', boardSetPosition(internalState, position));
         },
         setPiecePosition(input, mutationSession) {
             const pieces = boardParsePiecePositionInput(input);
-            return mutationSession.addMutation('state.board.setPiecePosition', boardSetPosition(internalState, pieces));
+            return mutationSession.addMutation('state.board.setPiecePosition', boardSetPiecePosition(internalState, pieces));
         },
         setTurn(turn, mutationSession) {
             const normalizedTurn = normalizeColor(turn);

package/dist/state/board/fen/main.d.ts

@@ -1,10 +1,10 @@
 import { FenString } from '../types/input.js';
-import { ParsedPosition } from '../types/internal.js';
+import { PositionSnapshot } from '../types/internal.js';
 /**
- * Parse a FEN string into a {@link ParsedPosition}.
+ * Parse a FEN string into a {@link PositionSnapshot}.
  *
  * Only the first two FEN fields (piece placement + active color) are required
  * for a board-only representation. The remaining fields (castling, en-passant,
  * half-move clock, full-move number) are accepted but ignored.
  */
-export declare function parseFen(fen: FenString): ParsedPosition;
+export declare function parseFen(fen: FenString): PositionSnapshot;

package/dist/state/board/fen/main.js

@@ -74,7 +74,7 @@ function parseTurn(turn) {
     }
 }
 /**
- * Parse a FEN string into a {@link ParsedPosition}.
+ * Parse a FEN string into a {@link PositionSnapshot}.
  *
  * Only the first two FEN fields (piece placement + active color) are required
  * for a board-only representation. The remaining fields (castling, en-passant,

package/dist/state/board/position.d.ts

@@ -1,4 +1,4 @@
 import { PiecePositionInput, PositionInput } from './types/input.js';
-import { ParsedPosition } from './types/internal.js';
+import { PositionSnapshot } from './types/internal.js';
 export declare function boardParsePiecePositionInput(input: PiecePositionInput): Uint8Array;
-export declare function boardParsePosition(input: PositionInput): ParsedPosition;
+export declare function boardParsePosition(input: PositionInput): PositionSnapshot;

package/dist/state/board/reducers.d.ts

@@ -1,8 +1,6 @@
-import { ColorCode, Move, MoveRequest } from './types/internal.js';
+import { ColorCode, Move, MoveRequest, PositionSnapshot } from './types/internal.js';
 import { BoardStateInternal } from './types/main.js';
-export declare function boardSetPosition(state: BoardStateInternal, pieces: Uint8Array): boolean;
-/**
- * Set active color turn.
- */
+export declare function boardSetPiecePosition(state: BoardStateInternal, pieces: Uint8Array): boolean;
 export declare function boardSetTurn(state: BoardStateInternal, turn: ColorCode): boolean;
+export declare function boardSetPosition(state: BoardStateInternal, position: PositionSnapshot): boolean;
 export declare function boardMove(state: BoardStateInternal, request: MoveRequest): Move;

package/dist/state/board/reducers.js

@@ -1,19 +1,26 @@
-import { isEmptyPieceCode } from './check.js';
+import { isEmptyPieceCode, piecePositionsEqual, positionsEqual } from './check.js';
 import { denormalizeSquare } from './denormalize.js';
 import { fromPieceCode, toPieceCode } from './piece.js';
-export function boardSetPosition(state, pieces) {
+export function boardSetPiecePosition(state, pieces) {
+    if (piecePositionsEqual(state, { pieces }))
+        return false; // no-op
     state.pieces = new Uint8Array(pieces);
-    // Increment position epoch to prevent false animation across position resets
     state.positionEpoch++;
     return true;
 }
-/**
- * Set active color turn.
- */
 export function boardSetTurn(state, turn) {
     if (state.turn === turn)
         return false; // no-op
     state.turn = turn;
+    state.positionEpoch++;
+    return true;
+}
+export function boardSetPosition(state, position) {
+    if (positionsEqual(state, position))
+        return false; // no-op
+    state.pieces = new Uint8Array(position.pieces);
+    state.turn = position.turn;
+    state.positionEpoch++;
     return true;
 }
 function buildMoveBase(state, request) {

package/dist/state/board/types/internal.d.ts

@@ -48,7 +48,9 @@ export type MoveBaseSnapshot = ReadonlyDeep<MoveBase>;
 export type MoveSnapshot = ReadonlyDeep<Move>;
 export declare const FILE_START: number;
 export declare const RANK_START: number;
-export type ParsedPosition = {
-    pieces: Uint8Array;
-    turn: ColorCode;
-};
+export interface PiecePositionSnapshot {
+    readonly pieces: Readonly<Uint8Array>;
+}
+export interface PositionSnapshot extends PiecePositionSnapshot {
+    readonly turn: ColorCode;
+}

package/package.json

@@ -1,7 +1,7 @@
 {
 	"name": "@mirasen/chessboard",
 	"description": "Framework-agnostic TypeScript chessboard platform with real chess interaction built in.",
-	"version": "1.1.0",
+	"version": "1.1.2",
 	"license": "MIT",
 	"author": {
 		"name": "Mirasen",
@@ -61,7 +61,7 @@
 		"check": "tsc --skipLibCheck --noEmit",
 		"check:test": "tsc --project tsconfig-test.json --skipLibCheck --noEmit",
 		"test": "npm run check:test && vitest run --run",
-		"coverage": "vitest run --coverage",
+		"coverage": "npm run check:test && vitest run --coverage",
 		"changeset:version": "changeset version && npm install && npm run format && git add --all",
 		"changeset:publish": "changeset publish"
 	},