@mirasen/chessboard 0.1.0 → 1.0.0-rc.0

package/dist/extensions/types/context/animation.d.ts

@@ -1,6 +1,6 @@
-import { ExtensionInvalidationState } from '../../invalidation/types';
-import { ExtensionAnimationSession } from '../basic/animation';
-import { ExtensionRenderContext } from './render';
+import { ExtensionInvalidationState } from '../../invalidation/types.js';
+import { ExtensionAnimationSession } from '../basic/animation.js';
+import { ExtensionRenderContext } from './render.js';
 export interface ExtensionSubmittedAnimationSession extends ExtensionAnimationSession {
     readonly status: 'submitted';
 }

package/dist/extensions/types/context/events.d.ts

@@ -0,0 +1,5 @@
+import { SceneEvent } from '../basic/events.js';
+export interface ExtensionOnEventContext {
+    rawEvent: Event;
+    sceneEvent: SceneEvent | null;
+}

package/dist/extensions/types/context/events.js

@@ -0,0 +1 @@
+export {};

package/dist/extensions/types/context/render.d.ts

@@ -1,5 +1,5 @@
-import { ExtensionReadonlyInvalidationState } from '../../invalidation/types';
-import { RenderFrameSnapshot } from '../basic/render';
+import { ExtensionReadonlyInvalidationState } from '../../invalidation/types.js';
+import { RenderFrameSnapshot } from '../basic/render.js';
 export interface ExtensionRenderContext {
     readonly currentFrame: RenderFrameSnapshot;
     readonly invalidation: ExtensionReadonlyInvalidationState;

package/dist/extensions/types/context/transient-visuals.d.ts

@@ -1,6 +1,6 @@
 import { ReadonlyDeep } from 'type-fest';
-import { RenderFrameSnapshot } from '../basic/render';
-import { TransientInput } from '../basic/transient-visuals';
+import { RenderFrameSnapshot } from '../basic/render.js';
+import { TransientInput } from '../basic/transient-visuals.js';
 export interface ExtensionRenderTransientVisualsContext {
     readonly currentFrame: RenderFrameSnapshot;
     readonly transientInput: ReadonlyDeep<TransientInput>;

package/dist/extensions/types/context/ui-move.d.ts

@@ -1,16 +1,4 @@
-import { MoveRequest, Square } from '../../../state/board/types/internal';
-import { MoveDestinationSnapshot } from '../../../state/interaction/types/internal';
-export type ExtensionUIMoveRequestStatus = 'unresolved' | 'deferred' | 'resolved';
-export interface ExtensionUIMoveRequestContextSnapshot {
-    readonly status: ExtensionUIMoveRequestStatus;
-    readonly sourceSquare: Square;
-    readonly destination: MoveDestinationSnapshot;
-    readonly canBeAutoResolved: boolean;
-    readonly resolvedMoveRequest: MoveRequest | null;
-}
-export interface ExtensionUIMoveRequestContext extends ExtensionUIMoveRequestContextSnapshot {
-    defer(): void;
-    resolve(request: MoveRequest): void;
-    autoresolve(): void;
-    getSnapshot(): ExtensionUIMoveRequestContextSnapshot;
+import { PendingUIMoveRequest } from '../../../state/change/types/ui-move.js';
+export interface ExtensionPendingUIMoveRequestContext {
+    readonly request: PendingUIMoveRequest;
 }

package/dist/extensions/types/context/update.d.ts

@@ -1,7 +1,7 @@
-import { RuntimeReadonlyMutationSession } from '../../../runtime/mutation/types';
-import { ExtensionInvalidationState } from '../../invalidation/types';
-import { RenderFrameSnapshot } from '../basic/render';
-import { UpdateFrameSnapshot, UpdateFrameSnapshotMounted, UpdateFrameSnapshotUnmounted } from '../basic/update';
+import { RuntimeReadonlyMutationSession } from '../../../runtime/mutation/types.js';
+import { ExtensionInvalidationState } from '../../invalidation/types.js';
+import { RenderFrameSnapshot } from '../basic/render.js';
+import { UpdateFrameSnapshot, UpdateFrameSnapshotMounted, UpdateFrameSnapshotUnmounted } from '../basic/update.js';
 export interface ExtensionUpdateContextCommon {
     readonly previousFrame: UpdateFrameSnapshot | null;
     readonly mutation: RuntimeReadonlyMutationSession;

package/dist/extensions/types/context/update.js

@@ -1,4 +1,4 @@
-import { isFrameMounted, isFrameRenderable } from '../basic/update';
+import { isFrameMounted, isFrameRenderable } from '../basic/update.js';
 export function isUpdateContextCommonMounted(context) {
     return isFrameMounted(context.currentFrame);
 }

package/dist/extensions/types/extension.d.ts

@@ -1,25 +1,27 @@
-import { SceneEvent } from './basic/events';
-import { ExtensionInstanceMountOptions, ExtensionSlotName } from './basic/mount';
-import { ExtensionAnimationFinishedContext, ExtensionCleanAnimationContext, ExtensionPrepareAnimationContext, ExtensionRenderAnimationContext } from './context/animation';
-import { ExtensionRenderContext } from './context/render';
-import { ExtensionRenderTransientVisualsContext } from './context/transient-visuals';
-import { ExtensionUIMoveRequestContext } from './context/ui-move';
-import { ExtensionUpdateContext } from './context/update';
-import { ExtensionRuntimeSurface } from './surface/main';
+import { ExtensionDragSessionSnapshot } from './basic/interaction.js';
+import { ExtensionInstanceMountOptions, ExtensionSlotName } from './basic/mount.js';
+import { ExtensionAnimationFinishedContext, ExtensionCleanAnimationContext, ExtensionPrepareAnimationContext, ExtensionRenderAnimationContext } from './context/animation.js';
+import { ExtensionOnEventContext } from './context/events.js';
+import { ExtensionRenderContext } from './context/render.js';
+import { ExtensionRenderTransientVisualsContext } from './context/transient-visuals.js';
+import { ExtensionPendingUIMoveRequestContext } from './context/ui-move.js';
+import { ExtensionUpdateContext } from './context/update.js';
+import { ExtensionRuntimeSurface } from './surface/main.js';
 interface ExtensionInstanceBase<TId extends string, TSlots extends readonly ExtensionSlotName[]> {
     readonly id: TId;
-    mount(env: ExtensionInstanceMountOptions<TSlots>): void;
-    unmount(): void;
-    destroy(): void;
-    onUpdate(context: ExtensionUpdateContext): void;
-    onUIMoveRequest?(context: ExtensionUIMoveRequestContext): void;
+    mount?(env: ExtensionInstanceMountOptions<TSlots>): void;
+    unmount?(): void;
+    destroy?(): void;
+    onUpdate?(context: ExtensionUpdateContext): void;
     render?(context: ExtensionRenderContext): void;
     prepareAnimation?(context: ExtensionPrepareAnimationContext): void;
     renderAnimation?(context: ExtensionRenderAnimationContext): void;
     onAnimationFinished?(context: ExtensionAnimationFinishedContext): void;
     cleanAnimation?(context: ExtensionCleanAnimationContext): void;
+    completeDrag?(session: ExtensionDragSessionSnapshot): void;
     renderTransientVisuals?(context: ExtensionRenderTransientVisualsContext): void;
-    onEvent?(event: SceneEvent): void;
+    onUIMoveRequest?(context: ExtensionPendingUIMoveRequestContext): void;
+    onEvent?(context: ExtensionOnEventContext): void;
 }
 type ExtensionInstancePublicPart<TPublic> = [TPublic] extends [never] ? Record<never, never> : {
     getPublic(): TPublic;

package/dist/extensions/types/main.d.ts

@@ -1,11 +1,13 @@
-import { RuntimeReadonlyMutationSession } from '../../runtime/mutation/types';
-import { ExtensionInvalidationState } from '../invalidation/types';
-import { ExtensionAnimationControllerInternalSurface } from './basic/animation';
-import { SceneEventType } from './basic/events';
-import { UpdateFrameSnapshot } from './basic/update';
-import { ExtensionUIMoveRequestContext } from './context/ui-move';
-import { AnyExtensionDefinition, AnyExtensionInstance } from './extension';
-import { ExtensionRuntimeSurfaceCommands } from './surface/commands';
+import { RuntimeReadonlyMutationSession } from '../../runtime/mutation/types.js';
+import { DragSessionExtensionOwned } from '../../state/interaction/types/internal.js';
+import { ExtensionInvalidationState } from '../invalidation/types.js';
+import { ExtensionAnimationControllerInternalSurface } from './basic/animation.js';
+import { UpdateFrameSnapshot } from './basic/update.js';
+import { ExtensionOnEventContext } from './context/events.js';
+import { ExtensionPendingUIMoveRequestContext } from './context/ui-move.js';
+import { AnyExtensionDefinition, AnyExtensionInstance } from './extension.js';
+import { ExtensionRuntimeSurfaceCommandsInternalSurface } from './surface/commands.js';
+import { ExtensionRuntimeSurfaceEvents } from './surface/events.js';
 export interface ExtensionSystemExtensionRecord {
     readonly id: string;
     readonly definition: AnyExtensionDefinition;
@@ -14,13 +16,14 @@ export interface ExtensionSystemExtensionRecord {
     readonly animation: ExtensionAnimationControllerInternalSurface;
 }
 export interface ExtensionSystemInitOptions {
-    extensionRuntimeSurfaceCommands: ExtensionRuntimeSurfaceCommands;
+    extensionRuntimeSurfaceCommands: ExtensionRuntimeSurfaceCommandsInternalSurface;
+    extensionRuntimeSurfaceEvents: ExtensionRuntimeSurfaceEvents;
     extensions?: readonly AnyExtensionDefinition[];
 }
 export interface ExtensionSystemInternal {
     readonly extensions: Map<string, ExtensionSystemExtensionRecord>;
     readonly transientVisualsSubscribers: Set<string>;
-    readonly eventSubscribers: Map<string, Set<SceneEventType>>;
+    readonly eventSubscribers: Map<string, Set<string>>;
     currentFrame: UpdateFrameSnapshot | null;
 }
 export interface ExtensionSystemUpdateRequest {
@@ -37,7 +40,9 @@ export interface ExtensionSystem {
     getPublicRecord(): Readonly<Record<string, unknown>>;
     getSharedDataForRenderSystem(): ExtensionSystemSharedDataForRenderSystem;
     onUpdate(request: ExtensionSystemUpdateRequest): void;
-    onUIMoveRequest(context: ExtensionUIMoveRequestContext): void;
+    onUIMoveRequest(context: ExtensionPendingUIMoveRequestContext): void;
+    onEvent(context: ExtensionOnEventContext): void;
+    completeDrag(session: DragSessionExtensionOwned): void;
     onUnmount(): void;
     onDestroy(): void;
 }

package/dist/extensions/types/surface/commands.d.ts

@@ -1,8 +1,11 @@
-import { LayoutSnapshot } from '../../../layout/types';
-import { ColorInput, MoveRequestInput, PiecePositionInput, PositionInput, SquareString } from '../../../state/board/types/input';
-import { Move } from '../../../state/board/types/internal';
-import { MovabilityInput } from '../../../state/interaction/types/input';
-import { RuntimeStateSnapshot } from '../../../state/types';
+import { LayoutSnapshot } from '../../../layout/types.js';
+import { ColorInput, MoveRequestInput, PiecePositionInput, PositionInput, SquareString } from '../../../state/board/types/input.js';
+import { Move } from '../../../state/board/types/internal.js';
+import { DeferredUIMoveResolutionDetails } from '../../../state/change/types/ui-move.js';
+import { MovabilityInput } from '../../../state/interaction/types/input.js';
+import { DragSessionExtensionOwned } from '../../../state/interaction/types/internal.js';
+import { RuntimeStateSnapshot } from '../../../state/types.js';
+import { ExtensionDragSession } from '../basic/interaction.js';
 export interface ExtensionRuntimeSurfaceCommandsSnapshot {
     readonly state: RuntimeStateSnapshot;
     readonly layout: LayoutSnapshot;
@@ -19,8 +22,14 @@ export interface ExtensionRuntimeSurfaceCommands {
     setOrientation(orientation: ColorInput): boolean;
     setMovability(movability: MovabilityInput): boolean;
     select(square: SquareString | null): boolean;
+    startDrag(session: ExtensionDragSession): boolean;
     clearActiveInteraction(): boolean;
     clearInteraction(): boolean;
+    resolveDeferredUIMoveRequest(details: DeferredUIMoveResolutionDetails): Move;
+    cancelDeferredUIMoveRequest(): boolean;
     requestRender(request: ExtensionRuntimeSurfaceCommandsRenderRequest): void;
     getSnapshot(): ExtensionRuntimeSurfaceCommandsSnapshot;
 }
+export interface ExtensionRuntimeSurfaceCommandsInternalSurface extends ExtensionRuntimeSurfaceCommands {
+    startDrag(session: DragSessionExtensionOwned): boolean;
+}

package/dist/extensions/types/surface/events.d.ts

@@ -1,5 +1,4 @@
-import { SceneEventType } from '../basic/events';
 export interface ExtensionRuntimeSurfaceEvents {
-    subscribe(events: Iterable<SceneEventType>): void;
-    unsubscribe(events?: Iterable<SceneEventType>): void;
+    subscribeEvent<K extends keyof HTMLElementEventMap>(type: K): void;
+    unsubscribeEvent<K extends keyof HTMLElementEventMap>(type: K): void;
 }

package/dist/extensions/types/surface/main.d.ts

@@ -1,7 +1,7 @@
-import { ExtensionAnimationController } from '../basic/animation';
-import { ExtensionRuntimeSurfaceCommands } from './commands';
-import { ExtensionRuntimeSurfaceEvents } from './events';
-import { ExtensionRuntimeSurfaceTransientVisuals } from './transient-visuals';
+import { ExtensionAnimationController } from '../basic/animation.js';
+import { ExtensionRuntimeSurfaceCommands } from './commands.js';
+import { ExtensionRuntimeSurfaceEvents } from './events.js';
+import { ExtensionRuntimeSurfaceTransientVisuals } from './transient-visuals.js';
 export interface ExtensionRuntimeSurface {
     readonly commands: ExtensionRuntimeSurfaceCommands;
     readonly animation: ExtensionAnimationController;

package/dist/extensions/types/wrapper.d.ts

@@ -1,26 +1,27 @@
 /**
  * Public built-in extension ids accepted by createBoard({ extensions })
  */
-import { ActiveTargetDefinition } from '../first-party/active-target/types';
-import { BoardEventsDefinition } from '../first-party/board-events/types';
-import { LastMoveDefinition } from '../first-party/last-move/types';
-import { LegalMovesDefinition } from '../first-party/legal-moves/types';
-import { MainRendererDefinition } from '../first-party/main-renderer/types/extension';
-import { SelectedSquareDefinition } from '../first-party/selected-square/types';
-export declare const DefaultBuiltinChessboardExtensions: readonly ["mainRenderer", "events", "selectedSquare", "activeTarget", "legalMoves", "lastMove"];
-export type BuiltInExtensionId = (typeof DefaultBuiltinChessboardExtensions)[number];
-/**
- * Default built-in extensions used when createBoard(...) receives no extensions option
- */
+import { createActiveTarget } from '../first-party/active-target/factory.js';
+import { createAutoPromote } from '../first-party/auto-promote/factory.js';
+import { createBoardEvents } from '../first-party/board-events/factory.js';
+import { createLastMove } from '../first-party/last-move/factory.js';
+import { createLegalMoves } from '../first-party/legal-moves/factory.js';
+import { createMainRenderer } from '../first-party/main-renderer/factory.js';
+import { createPromotion } from '../first-party/promotion/factory.js';
+import { createSelectedSquare } from '../first-party/selected-square/factory.js';
+export declare const builtInExtensionFactoryMap: {
+    renderer: typeof createMainRenderer;
+    selectedSquare: typeof createSelectedSquare;
+    lastMove: typeof createLastMove;
+    activeTarget: typeof createActiveTarget;
+    legalMoves: typeof createLegalMoves;
+    events: typeof createBoardEvents;
+    autoPromote: typeof createAutoPromote;
+    promotion: typeof createPromotion;
+};
+export type BuiltInExtensionId = keyof typeof builtInExtensionFactoryMap;
+export type BuiltInExtensionDefinitionMap = {
+    [Id in BuiltInExtensionId]: ReturnType<(typeof builtInExtensionFactoryMap)[Id]>;
+};
+export declare const DefaultBuiltinChessboardExtensions: readonly ["renderer", "selectedSquare", "lastMove", "activeTarget", "legalMoves", "events", "autoPromote", "promotion"];
 export type DefaultBuiltinChessboardExtensions = typeof DefaultBuiltinChessboardExtensions;
-/**
- * Map built-in public ids -> concrete extension definition types
- */
-export interface BuiltInExtensionDefinitionMap {
-    mainRenderer: MainRendererDefinition;
-    events: BoardEventsDefinition;
-    selectedSquare: SelectedSquareDefinition;
-    activeTarget: ActiveTargetDefinition;
-    legalMoves: LegalMovesDefinition;
-    lastMove: LastMoveDefinition;
-}

package/dist/extensions/types/wrapper.js

@@ -1,11 +1,39 @@
 /**
  * Public built-in extension ids accepted by createBoard({ extensions })
  */
+import { createActiveTarget } from '../first-party/active-target/factory.js';
+import { EXTENSION_ID as EXTENSION_ID_ACTIVE_TARGET } from '../first-party/active-target/types.js';
+import { createAutoPromote } from '../first-party/auto-promote/factory.js';
+import { EXTENSION_ID as EXTENSION_ID_AUTO_PROMOTE } from '../first-party/auto-promote/types.js';
+import { createBoardEvents } from '../first-party/board-events/factory.js';
+import { EXTENSION_ID as EXTENSION_ID_BOARD_EVENTS } from '../first-party/board-events/types.js';
+import { createLastMove } from '../first-party/last-move/factory.js';
+import { EXTENSION_ID as EXTENSION_ID_LAST_MOVE } from '../first-party/last-move/types.js';
+import { createLegalMoves } from '../first-party/legal-moves/factory.js';
+import { EXTENSION_ID as EXTENSION_ID_LEGAL_MOVES } from '../first-party/legal-moves/types.js';
+import { createMainRenderer } from '../first-party/main-renderer/factory.js';
+import { EXTENSION_ID as EXTENSION_ID_RENDERER } from '../first-party/main-renderer/types/extension.js';
+import { createPromotion } from '../first-party/promotion/factory.js';
+import { EXTENSION_ID as EXTENSION_ID_PROMOTION } from '../first-party/promotion/types/main.js';
+import { createSelectedSquare } from '../first-party/selected-square/factory.js';
+import { EXTENSION_ID as EXTENSION_ID_SELECTED_SQUARE } from '../first-party/selected-square/types.js';
+export const builtInExtensionFactoryMap = {
+    [EXTENSION_ID_RENDERER]: createMainRenderer,
+    [EXTENSION_ID_SELECTED_SQUARE]: createSelectedSquare,
+    [EXTENSION_ID_LAST_MOVE]: createLastMove,
+    [EXTENSION_ID_ACTIVE_TARGET]: createActiveTarget,
+    [EXTENSION_ID_LEGAL_MOVES]: createLegalMoves,
+    [EXTENSION_ID_BOARD_EVENTS]: createBoardEvents,
+    [EXTENSION_ID_AUTO_PROMOTE]: createAutoPromote,
+    [EXTENSION_ID_PROMOTION]: createPromotion
+};
 export const DefaultBuiltinChessboardExtensions = [
-    'mainRenderer',
-    'events',
-    'selectedSquare',
-    'activeTarget',
-    'legalMoves',
-    'lastMove'
+    EXTENSION_ID_RENDERER,
+    EXTENSION_ID_SELECTED_SQUARE,
+    EXTENSION_ID_LAST_MOVE,
+    EXTENSION_ID_ACTIVE_TARGET,
+    EXTENSION_ID_LEGAL_MOVES,
+    EXTENSION_ID_BOARD_EVENTS,
+    EXTENSION_ID_AUTO_PROMOTE,
+    EXTENSION_ID_PROMOTION
 ];

package/dist/extensions/update.d.ts

@@ -1,4 +1,4 @@
-import { ExtensionUIMoveRequestContext } from './types/context/ui-move';
-import { ExtensionSystemInternal, ExtensionSystemUpdateRequest } from './types/main';
+import { ExtensionPendingUIMoveRequestContext } from './types/context/ui-move.js';
+import { ExtensionSystemInternal, ExtensionSystemUpdateRequest } from './types/main.js';
 export declare function extensionSystemUpdateState(state: ExtensionSystemInternal, request: ExtensionSystemUpdateRequest): void;
-export declare function extensionSystemUpdateUIMoveRequest(state: ExtensionSystemInternal, context: ExtensionUIMoveRequestContext): void;
+export declare function extensionSystemUpdateUIMoveRequest(state: ExtensionSystemInternal, context: ExtensionPendingUIMoveRequestContext): void;

package/dist/extensions/update.js

@@ -1,4 +1,4 @@
-import { isUpdateContextCommonMounted } from './types/context/update';
+import { isUpdateContextCommonMounted } from './types/context/update.js';
 export function extensionSystemUpdateState(state, request) {
     // Prepare base context
     const contextCommon = {
@@ -16,7 +16,7 @@ export function extensionSystemUpdateState(state, request) {
             : {
                 ...contextCommon
             };
-        extension.instance.onUpdate(context);
+        extension.instance.onUpdate?.(context);
     }
     state.currentFrame = request.state;
 }

package/dist/index.d.ts

@@ -1,4 +1,4 @@
-export { createBoard } from './wrapper/factory';
-export type { Chessboard, ChessboardExtensionInput, ChessboardInitOptions, ChessboardRuntimeSurface } from './wrapper/types';
-export type { MoveRequestInput, PiecePositionRecordString } from './state/board/types/input';
-export type { RuntimeStateInitOptions } from './state/types';
+export { createBoard } from './wrapper/factory.js';
+export type { Chessboard, ChessboardExtensionInput, ChessboardInitOptions, ChessboardRuntimeSurface } from './wrapper/types.js';
+export type { MoveRequestInput, PiecePositionRecordString } from './state/board/types/input.js';
+export type { RuntimeStateInitOptions } from './state/types.js';

package/dist/index.js

@@ -1 +1 @@
-export { createBoard } from './wrapper/factory';
+export { createBoard } from './wrapper/factory.js';

package/dist/layout/factory.d.ts

@@ -1,2 +1,2 @@
-import { Layout } from './types';
+import { Layout } from './types.js';
 export declare function createLayout(): Layout;

package/dist/layout/factory.js

@@ -1,8 +1,8 @@
 import { cloneDeep } from 'es-toolkit/object';
-import { layoutRefreshGeometry } from './reducers';
+import { layoutRefreshGeometry } from './reducers.js';
 function createLayoutInternal() {
     return {
-        boardSize: 0,
+        sceneSize: null,
         orientation: 0 /* ColorCode.White */,
         geometry: null,
         layoutEpoch: 0
@@ -11,8 +11,8 @@ function createLayoutInternal() {
 export function createLayout() {
     const internalState = createLayoutInternal();
     return {
-        get boardSize() {
-            return internalState.boardSize;
+        get sceneSize() {
+            return internalState.sceneSize;
         },
         get orientation() {
             return internalState.orientation;

package/dist/layout/geometry/factory.d.ts

@@ -1,12 +1,3 @@
-import { ColorCode } from '../../state/board/types/internal';
-import { RenderGeometry } from './types';
-/**
- * Create RenderGeometry for a given board size (in px) and orientation.
- * - Geometry uses an SVG-local coordinate system with origin at top-left.
- * - Orientation mapping:
- *   - 'white': files increase left→right (a..h), ranks increase bottom→top (1..8).
- *              yIndex = 7 - rank, xIndex = file
- *   - 'black': files increase right→left (a..h), ranks increase top→bottom (1..8).
- *              yIndex = rank, xIndex = 7 - file
- */
-export declare function createRenderGeometry(boardSize: number, orientation: ColorCode): RenderGeometry;
+import { ColorCode } from '../../state/board/types/internal.js';
+import { SceneRenderGeometry, Size } from './types.js';
+export declare function createRenderGeometry(sceneSize: Size, orientation: ColorCode): SceneRenderGeometry;

package/dist/layout/geometry/factory.js

@@ -1,32 +1,31 @@
-import { fileOf, rankOf } from '../../state/board/coords';
-/**
- * Create RenderGeometry for a given board size (in px) and orientation.
- * - Geometry uses an SVG-local coordinate system with origin at top-left.
- * - Orientation mapping:
- *   - 'white': files increase left→right (a..h), ranks increase bottom→top (1..8).
- *              yIndex = 7 - rank, xIndex = file
- *   - 'black': files increase right→left (a..h), ranks increase top→bottom (1..8).
- *              yIndex = rank, xIndex = 7 - file
- */
-export function createRenderGeometry(boardSize, orientation) {
-    if (!(boardSize > 0 && Number.isFinite(boardSize))) {
-        throw new RangeError(`Invalid boardSize: ${boardSize}`);
+import { fileOf, rankOf } from '../../state/board/coords.js';
+import { makeBoardRect, measureBoardSize } from './helpers.js';
+export function createRenderGeometry(sceneSize, orientation) {
+    if (!(sceneSize.height > 0 &&
+        Number.isFinite(sceneSize.height) &&
+        sceneSize.width > 0 &&
+        Number.isFinite(sceneSize.width))) {
+        throw new RangeError(`Invalid sceneSize: ${JSON.stringify(sceneSize)}`);
     }
+    const boardSize = measureBoardSize(sceneSize);
+    const boardRect = makeBoardRect(sceneSize);
     const squareSize = boardSize / 8;
     const white = orientation === 0 /* ColorCode.White */;
     return {
-        boardSize,
+        sceneSize: { ...sceneSize },
+        boardRect,
         squareSize,
         orientation,
-        squareRect(sq) {
+        getSquareRect(sq) {
             const f = fileOf(sq);
             const r = rankOf(sq);
             const xIndex = white ? f : 7 - f;
             const yIndex = white ? 7 - r : r;
             return {
-                x: xIndex * squareSize,
-                y: yIndex * squareSize,
-                size: squareSize
+                x: boardRect.x + xIndex * squareSize,
+                y: boardRect.y + yIndex * squareSize,
+                width: squareSize,
+                height: squareSize
             };
         }
     };

package/dist/layout/geometry/helpers.d.ts

@@ -0,0 +1,5 @@
+import { Rect, RectSnapshot, Size, SizeSnapshot } from './types.js';
+export declare function sceneRectsEqual(rect1: RectSnapshot | null, rect2: RectSnapshot | null): boolean;
+export declare function sceneSizesEqual(size1: SizeSnapshot | null, size2: SizeSnapshot | null): boolean;
+export declare function measureBoardSize(sceneSize: Size): number;
+export declare function makeBoardRect(sceneSize: Size): Rect;

package/dist/layout/geometry/helpers.js

@@ -0,0 +1,33 @@
+export function sceneRectsEqual(rect1, rect2) {
+    if (rect1 === null && rect2 === null) {
+        return true;
+    }
+    if (rect1 === null || rect2 === null) {
+        return false;
+    }
+    return (rect1.x === rect2.x &&
+        rect1.y === rect2.y &&
+        rect1.width === rect2.width &&
+        rect1.height === rect2.height);
+}
+export function sceneSizesEqual(size1, size2) {
+    if (size1 === null && size2 === null) {
+        return true;
+    }
+    if (size1 === null || size2 === null) {
+        return false;
+    }
+    return size1.width === size2.width && size1.height === size2.height;
+}
+export function measureBoardSize(sceneSize) {
+    return Math.min(sceneSize.width, sceneSize.height);
+}
+export function makeBoardRect(sceneSize) {
+    const boardSize = measureBoardSize(sceneSize);
+    return {
+        x: (sceneSize.width - boardSize) / 2,
+        y: (sceneSize.height - boardSize) / 2,
+        width: boardSize,
+        height: boardSize
+    };
+}

package/dist/layout/geometry/types.d.ts

@@ -1,20 +1,21 @@
 import { ReadonlyDeep } from 'type-fest';
-import { ColorCode, Square } from '../../state/board/types/internal';
-export interface SquareRect {
+import { ColorCode, Square } from '../../state/board/types/internal.js';
+export interface Size {
+    width: number;
+    height: number;
+}
+export type SizeSnapshot = ReadonlyDeep<Size>;
+export interface Rect {
     x: number;
     y: number;
-    size: number;
+    width: number;
+    height: number;
 }
-export type SquareRectSnapshot = ReadonlyDeep<SquareRect>;
-/**
- * RenderGeometry represents the derived geometry of the rendered chessboard.
- * It includes the board size, square size, orientation, and square rectangle mapping.
- *
- * It is computed from layout inputs and used by rendering and interaction code.
- */
-export interface RenderGeometry {
-    readonly boardSize: number;
+export type RectSnapshot = ReadonlyDeep<Rect>;
+export interface SceneRenderGeometry {
+    readonly sceneSize: SizeSnapshot;
+    readonly boardRect: RectSnapshot;
     readonly squareSize: number;
     readonly orientation: ColorCode;
-    squareRect(sq: Square): SquareRectSnapshot;
+    getSquareRect(sq: Square): RectSnapshot;
 }

package/dist/layout/helpers.d.ts

@@ -1,4 +1,3 @@
-/**
- * Measure board size from container (square board fits within host).
- */
-export declare function measureBoardSize(container: HTMLElement): number;
+import { Size } from './geometry/types.js';
+export declare function measureSceneSize(container: HTMLElement): Size;
+export declare function isSceneSizeValid(size: Size | null): boolean;

package/dist/layout/helpers.js

@@ -1,6 +1,6 @@
-/**
- * Measure board size from container (square board fits within host).
- */
-export function measureBoardSize(container) {
-    return Math.min(container.clientWidth, container.clientHeight);
+export function measureSceneSize(container) {
+    return { width: container.clientWidth, height: container.clientHeight };
+}
+export function isSceneSizeValid(size) {
+    return size !== null && size.width > 0 && size.height > 0;
 }

package/dist/layout/mutation.d.ts

@@ -1,4 +1,4 @@
-import type { MutationSession } from '../mutation/types';
+import type { MutationSession } from '../mutation/types.js';
 export type LayoutMutationPayloadByCause = {
     'layout.refreshGeometry': undefined;
 };

package/dist/layout/reducers.d.ts

@@ -1,2 +1,2 @@
-import { LayoutInternal, LayoutRefreshOptions } from './types';
+import { LayoutInternal, LayoutRefreshOptions } from './types.js';
 export declare function layoutRefreshGeometry(state: LayoutInternal, options: LayoutRefreshOptions): boolean;

package/dist/layout/reducers.js

@@ -1,5 +1,6 @@
-import { createRenderGeometry } from './geometry/factory';
-import { measureBoardSize } from './helpers';
+import { createRenderGeometry } from './geometry/factory.js';
+import { sceneSizesEqual } from './geometry/helpers.js';
+import { isSceneSizeValid, measureSceneSize } from './helpers.js';
 export function layoutRefreshGeometry(state, options) {
     const orientation = options.orientation ?? state.orientation;
     if (orientation === null) {
@@ -7,23 +8,23 @@ export function layoutRefreshGeometry(state, options) {
         // For now we throw
         throw new Error('Orientation is expected to be provided on the first pass of layout.refreshGeometry');
     }
-    let boardSize = options.container ? measureBoardSize(options.container) : state.boardSize;
-    if (boardSize !== null && boardSize <= 0)
-        boardSize = null;
-    const changed = boardSize !== state.boardSize || orientation !== state.orientation;
+    let sceneSize = options.container ? measureSceneSize(options.container) : state.sceneSize;
+    if (sceneSize !== null && !isSceneSizeValid(sceneSize))
+        sceneSize = null;
+    const changed = !sceneSizesEqual(sceneSize, state.sceneSize) || orientation !== state.orientation;
     if (!changed) {
         return false; // no-op, no relevant changes
     }
     // Update the state
-    state.boardSize = boardSize;
+    state.sceneSize = sceneSize;
     state.orientation = orientation;
-    if (boardSize === null || orientation === null) {
+    if (sceneSize === null || orientation === null) {
         // General invalid-geometry rule. Orientation is currently guarded above,
         // but this branch stays explicit in case null orientation is allowed later.
         state.geometry = null;
     }
     else {
-        state.geometry = createRenderGeometry(boardSize, orientation);
+        state.geometry = createRenderGeometry(sceneSize, orientation);
     }
     state.layoutEpoch++;
     return true;