@mirasen/chessboard 0.1.1 → 1.0.0

package/dist/extensions/first-party/promotion/normalize.js

@@ -0,0 +1,37 @@
+import assert from '@ktarmyshov/assert';
+import { normalizePiece } from '../../../state/board/normalize.js';
+import { ALL_NON_EMPTY_PROMOTION_PIECE_CODES, DEFAULT_CONFIG } from './types/internal.js';
+function assertPieceUrlsComplete(pieceUrls) {
+    for (const pieceCode of ALL_NON_EMPTY_PROMOTION_PIECE_CODES) {
+        assert(pieceCode in pieceUrls, `Missing URL for piece code: ${pieceCode}`);
+    }
+}
+function assertPieceCodeIsPromotionPieceCode(pieceCode) {
+    assert(pieceCode === 5 /* PieceCode.WhiteQueen */ ||
+        pieceCode === 4 /* PieceCode.WhiteRook */ ||
+        pieceCode === 3 /* PieceCode.WhiteBishop */ ||
+        pieceCode === 2 /* PieceCode.WhiteKnight */ ||
+        pieceCode === 13 /* PieceCode.BlackQueen */ ||
+        pieceCode === 12 /* PieceCode.BlackRook */ ||
+        pieceCode === 11 /* PieceCode.BlackBishop */ ||
+        pieceCode === 10 /* PieceCode.BlackKnight */, `Invalid promotion piece code: ${pieceCode}`);
+}
+function normalizePromotionPieceUrls(input) {
+    const normalized = {};
+    for (const [key, url] of Object.entries(input)) {
+        const pieceCode = normalizePiece(key);
+        assertPieceCodeIsPromotionPieceCode(pieceCode);
+        normalized[pieceCode] = url;
+    }
+    assertPieceUrlsComplete(normalized);
+    return normalized;
+}
+export function normalizePromotionConfig(config) {
+    return {
+        squareColor: config.squareColor ?? DEFAULT_CONFIG.squareColor,
+        hoverColor: config.hoverColor ?? DEFAULT_CONFIG.hoverColor,
+        pieceUrls: config.pieceUrls
+            ? normalizePromotionPieceUrls(config.pieceUrls)
+            : DEFAULT_CONFIG.pieceUrls
+    };
+}

package/dist/extensions/first-party/promotion/types/input.d.ts

@@ -0,0 +1,10 @@
+import { ColorShort, RolePromotionShort } from '../../../../state/board/types/input.js';
+import { OpaqueColor } from '../../common/types.js';
+import { PieceUrlsInput } from '../../main-renderer/types/input.js';
+export type PromotionPieceString = `${ColorShort}${RolePromotionShort}`;
+export type PromotionPieceUrlsInput = Pick<PieceUrlsInput, PromotionPieceString>;
+export interface PromotionInitConfig {
+    squareColor?: OpaqueColor;
+    hoverColor?: OpaqueColor;
+    pieceUrls?: PromotionPieceUrlsInput;
+}

package/dist/extensions/first-party/promotion/types/internal.d.ts

@@ -0,0 +1,12 @@
+import { NonEmptyPieceCode, PieceCode } from '../../../../state/board/types/internal.js';
+import { OpaqueColor } from '../../common/types.js';
+export type PromotionPieceCode = Exclude<NonEmptyPieceCode, PieceCode.WhitePawn | PieceCode.BlackPawn | PieceCode.BlackKing | PieceCode.WhiteKing>;
+export type PromotionPieceUrls = Record<PromotionPieceCode, string>;
+export interface PromotionConfig {
+    squareColor: OpaqueColor;
+    hoverColor: OpaqueColor;
+    pieceUrls: PromotionPieceUrls;
+}
+export declare const PROMOTION_CHESSNUT_PIECE_URLS: PromotionPieceUrls;
+export declare const ALL_NON_EMPTY_PROMOTION_PIECE_CODES: PromotionPieceCode[];
+export declare const DEFAULT_CONFIG: PromotionConfig;

package/dist/extensions/first-party/promotion/types/internal.js

@@ -0,0 +1,22 @@
+export const PROMOTION_CHESSNUT_PIECE_URLS = {
+    [5 /* PieceCode.WhiteQueen */]: new URL('../../../../../assets/pieces/chessnut/wQ.svg', import.meta.url).toString(),
+    [4 /* PieceCode.WhiteRook */]: new URL('../../../../../assets/pieces/chessnut/wR.svg', import.meta.url).toString(),
+    [3 /* PieceCode.WhiteBishop */]: new URL('../../../../../assets/pieces/chessnut/wB.svg', import.meta.url).toString(),
+    [2 /* PieceCode.WhiteKnight */]: new URL('../../../../../assets/pieces/chessnut/wN.svg', import.meta.url).toString(),
+    [13 /* PieceCode.BlackQueen */]: new URL('../../../../../assets/pieces/chessnut/bQ.svg', import.meta.url).toString(),
+    [12 /* PieceCode.BlackRook */]: new URL('../../../../../assets/pieces/chessnut/bR.svg', import.meta.url).toString(),
+    [11 /* PieceCode.BlackBishop */]: new URL('../../../../../assets/pieces/chessnut/bB.svg', import.meta.url).toString(),
+    [10 /* PieceCode.BlackKnight */]: new URL('../../../../../assets/pieces/chessnut/bN.svg', import.meta.url).toString()
+};
+export const ALL_NON_EMPTY_PROMOTION_PIECE_CODES = Object.keys(PROMOTION_CHESSNUT_PIECE_URLS).map((code) => Number(code));
+export const DEFAULT_CONFIG = {
+    squareColor: {
+        color: 'rgba(255, 255, 255)',
+        opacity: 1
+    },
+    hoverColor: {
+        color: '#000000',
+        opacity: 0.15
+    },
+    pieceUrls: PROMOTION_CHESSNUT_PIECE_URLS
+};

package/dist/extensions/first-party/promotion/types/main.d.ts

@@ -0,0 +1,24 @@
+import { RolePromotionCode, Square } from '../../../../state/board/types/internal.js';
+import { ExtensionDefinition, ExtensionInstance } from '../../../types/extension.js';
+import { ExtensionRuntimeSurface } from '../../../types/surface/main.js';
+import { ExtensionInternalBase } from '../../common/types.js';
+import { PromotionConfig } from './internal.js';
+export declare const EXTENSION_SLOTS: readonly ["animation"];
+export type ExtensionSlotsType = typeof EXTENSION_SLOTS;
+export declare const EXTENSION_ID: "promotion";
+export type PromotionDefinition = ExtensionDefinition<typeof EXTENSION_ID, typeof EXTENSION_SLOTS, never>;
+export type PromotionInstance = ExtensionInstance<typeof EXTENSION_ID, typeof EXTENSION_SLOTS, never>;
+export interface PromotionPieceNode {
+    readonly svg: SVGImageElement;
+    readonly rect: SVGRectElement;
+}
+export interface PromotionInstanceInternal extends ExtensionInternalBase<ExtensionSlotsType> {
+    readonly config: PromotionConfig;
+    readonly svgPromotionPieces: Map<RolePromotionCode, PromotionPieceNode>;
+    readonly activePromotionSquares: Map<Square, RolePromotionCode>;
+    svgHoverRect: SVGRectElement | null;
+    readonly runtimeSurface: ExtensionRuntimeSurface;
+}
+export declare const enum DirtyLayer {
+    Promotion = 1
+}

package/dist/extensions/first-party/promotion/types/main.js

@@ -0,0 +1,2 @@
+export const EXTENSION_SLOTS = ['animation'];
+export const EXTENSION_ID = 'promotion';

package/dist/extensions/first-party/selected-square/factory.js

@@ -2,7 +2,7 @@ import assert from '@ktarmyshov/assert';
 import { toMerged } from 'es-toolkit';
 import { createSvgElement, updateElementAttributes } from '../../../render/svg/helpers.js';
 import { isUpdateContextRenderable } from '../../types/context/update.js';
-import { extensionCreateInternalBase, extensionDestroy, extensionMount, extensionUnmount } from '../common/helpers.js';
+import { extensionCreateInternalBase, extensionDestroyBase, extensionMountBase, extensionUnmountBase } from '../common/helpers.js';
 import { DEFAULT_CONFIG, EXTENSION_ID, EXTENSION_SLOTS } from './types.js';
 export function createSelectedSquare(config = {}) {
     const mergedConfig = toMerged(DEFAULT_CONFIG, config);
@@ -29,7 +29,7 @@ function createSelectedSquareInstance(config) {
     return {
         id: EXTENSION_ID,
         mount(env) {
-            extensionMount(internalState, env.slotRoots);
+            extensionMountBase(internalState, env.slotRoots);
         },
         onUpdate(context) {
             const needsRender = context.mutation.hasMutation({
@@ -55,12 +55,12 @@ function createSelectedSquareInstance(config) {
                 return;
             }
             const geometry = context.currentFrame.layout.geometry;
-            const r = geometry.squareRect(selectedSquare);
+            const r = geometry.getSquareRect(selectedSquare);
             const rectAttributes = {
                 x: r.x.toString(),
                 y: r.y.toString(),
-                width: r.size.toString(),
-                height: r.size.toString(),
+                width: r.width.toString(),
+                height: r.height.toString(),
                 fill: internalState.config.color,
                 'fill-opacity': internalState.config.opacity.toString(),
                 'shape-rendering': 'crispEdges'
@@ -77,11 +77,11 @@ function createSelectedSquareInstance(config) {
             }
         },
         unmount() {
-            extensionUnmount(internalState);
+            extensionUnmountBase(internalState);
             extensionClean(internalState);
         },
         destroy() {
-            extensionDestroy(internalState);
+            extensionDestroyBase(internalState);
             extensionClean(internalState);
         }
     };

package/dist/extensions/first-party/selected-square/types.d.ts

@@ -1,6 +1,6 @@
 import { PartialDeep } from 'type-fest';
 import { ExtensionDefinition, ExtensionInstance } from '../../types/extension.js';
-import { ExtensionInternal, OpaqueColor } from '../common/types.js';
+import { ExtensionInternalBase, OpaqueColor } from '../common/types.js';
 export declare const EXTENSION_SLOTS: readonly ["underPieces"];
 export type ExtensionSlotsType = typeof EXTENSION_SLOTS;
 export declare const EXTENSION_ID: "selectedSquare";
@@ -9,7 +9,7 @@ export declare const DEFAULT_CONFIG: SelectedSquareConfig;
 export type SelectedSquareInitConfig = PartialDeep<SelectedSquareConfig>;
 export type SelectedSquareDefinition = ExtensionDefinition<typeof EXTENSION_ID, typeof EXTENSION_SLOTS, never>;
 export type SelectedSquareInstance = ExtensionInstance<typeof EXTENSION_ID, typeof EXTENSION_SLOTS, never>;
-export interface SelectedSquareInstanceInternal extends ExtensionInternal<ExtensionSlotsType> {
+export interface SelectedSquareInstanceInternal extends ExtensionInternalBase<ExtensionSlotsType> {
     svgRect: SVGRectElement | null;
     readonly config: SelectedSquareConfig;
 }

package/dist/extensions/index.d.ts

@@ -1,8 +1 @@
-export { createActiveTarget } from './first-party/active-target/factory.js';
-export { createBoardEvents } from './first-party/board-events/factory.js';
-export { createLastMove } from './first-party/last-move/factory.js';
-export { createLegalMoves } from './first-party/legal-moves/factory.js';
-export { createMainRenderer } from './first-party/main-renderer/factory.js';
-export { createSelectedSquare } from './first-party/selected-square/factory.js';
-export type { AnyExtensionDefinition, ExtensionDefinitionId, ExtensionDefinitionPublicApi } from './types/extension.js';
-export type { BuiltInExtensionId, DefaultBuiltinChessboardExtensions } from './types/wrapper.js';
+export { builtInExtensionFactoryMap, type BuiltInExtensionId } from './types/wrapper.js';

package/dist/extensions/index.js

@@ -1,6 +1 @@
-export { createActiveTarget } from './first-party/active-target/factory.js';
-export { createBoardEvents } from './first-party/board-events/factory.js';
-export { createLastMove } from './first-party/last-move/factory.js';
-export { createLegalMoves } from './first-party/legal-moves/factory.js';
-export { createMainRenderer } from './first-party/main-renderer/factory.js';
-export { createSelectedSquare } from './first-party/selected-square/factory.js';
+export { builtInExtensionFactoryMap } from './types/wrapper.js';

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

@@ -1,34 +1,11 @@
 import { Square } from '../../../state/board/types/internal.js';
 import { ScenePoint } from '../basic/transient-visuals.js';
-interface SceneEventBase {
-    readonly defaultPrevented: boolean;
-    preventDefault(): void;
+export interface ScenePointerEvent {
+    readonly type: 'pointercancel' | 'pointerdown' | 'pointerenter' | 'pointerleave' | 'pointermove' | 'pointerout' | 'pointerover' | 'pointerrawupdate' | 'pointerup';
+    readonly point: ScenePoint;
+    readonly clampedPoint: ScenePoint;
+    readonly boardClampedPoint: ScenePoint | null;
+    readonly targetSquare: Square | null;
 }
-export interface ScenePointerEvent extends SceneEventBase {
-    readonly type: 'pointerdown' | 'pointermove' | 'pointerup' | 'pointercancel' | 'pointerleave';
-    readonly pointerId: number;
-    readonly isPrimary: boolean;
-    readonly button: number;
-    readonly buttons: number;
-    readonly ctrlKey: boolean;
-    readonly altKey: boolean;
-    readonly shiftKey: boolean;
-    readonly metaKey: boolean;
-    readonly rawPoint: ScenePoint | null;
-    readonly clampedPoint: ScenePoint | null;
-    readonly target: Square | null;
-}
-export type ScenePointerEventType = ScenePointerEvent['type'];
-export declare const SCENE_POINTER_EVENT_TYPES: ScenePointerEventType[];
-export interface SceneKeyboardEvent extends SceneEventBase {
-    readonly type: 'keydown' | 'keyup';
-    readonly key: string;
-    readonly repeat: boolean;
-    readonly ctrlKey: boolean;
-    readonly altKey: boolean;
-    readonly shiftKey: boolean;
-    readonly metaKey: boolean;
-}
-export type SceneEvent = ScenePointerEvent | SceneKeyboardEvent;
-export type SceneEventType = SceneEvent['type'];
-export {};
+export declare const ALL_SCENE_POINTER_EVENT_TYPES: ReadonlySet<string>;
+export type SceneEvent = ScenePointerEvent;

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

@@ -1,7 +1,11 @@
-export const SCENE_POINTER_EVENT_TYPES = [
+export const ALL_SCENE_POINTER_EVENT_TYPES = new Set([
+    'pointercancel',
     'pointerdown',
+    'pointerenter',
+    'pointerleave',
     'pointermove',
-    'pointerup',
-    'pointercancel',
-    'pointerleave'
-];
+    'pointerout',
+    'pointerover',
+    'pointerrawupdate',
+    'pointerup'
+]);

package/dist/extensions/types/basic/interaction.d.ts

@@ -0,0 +1,21 @@
+import { ReadonlyDeep } from 'type-fest';
+import type { PieceCode, Square } from '../../../state/board/types/internal.js';
+export interface ExtensionDragSessionBase {
+    sourceSquare: Square | null;
+    sourcePieceCode: PieceCode | null;
+    targetSquare: Square | null;
+}
+export interface ExtensionDragSessionLiftedPiece extends ExtensionDragSessionBase {
+    type: 'lifted-piece-drag';
+    sourcePieceCode: PieceCode;
+}
+export interface ExtensionDragSessionReleaseTargeting extends ExtensionDragSessionBase {
+    type: 'release-targeting';
+}
+type ExtensionCustomDragSessionType = `ext:${string}`;
+export interface ExtensionDragSessionCustom extends ExtensionDragSessionBase {
+    type: ExtensionCustomDragSessionType;
+}
+export type ExtensionDragSession = ExtensionDragSessionLiftedPiece | ExtensionDragSessionReleaseTargeting | ExtensionDragSessionCustom;
+export type ExtensionDragSessionSnapshot = ReadonlyDeep<ExtensionDragSession>;
+export {};

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

@@ -5,6 +5,7 @@ export interface ScenePoint {
 }
 export interface TransientInput {
     target: Square | null;
-    rawPoint: ScenePoint;
+    point: ScenePoint;
     clampedPoint: ScenePoint;
+    boardClampedPoint: ScenePoint;
 }

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/ui-move.d.ts

@@ -1,16 +1,4 @@
-import { MoveRequest, Square } from '../../../state/board/types/internal.js';
-import { MoveDestinationSnapshot } from '../../../state/interaction/types/internal.js';
-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/extension.d.ts

@@ -1,25 +1,27 @@
-import { SceneEvent } from './basic/events.js';
+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 { ExtensionUIMoveRequestContext } from './context/ui-move.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.js';
+import { DragSessionExtensionOwned } from '../../state/interaction/types/internal.js';
 import { ExtensionInvalidationState } from '../invalidation/types.js';
 import { ExtensionAnimationControllerInternalSurface } from './basic/animation.js';
-import { SceneEventType } from './basic/events.js';
 import { UpdateFrameSnapshot } from './basic/update.js';
-import { ExtensionUIMoveRequestContext } from './context/ui-move.js';
+import { ExtensionOnEventContext } from './context/events.js';
+import { ExtensionPendingUIMoveRequestContext } from './context/ui-move.js';
 import { AnyExtensionDefinition, AnyExtensionInstance } from './extension.js';
-import { ExtensionRuntimeSurfaceCommands } from './surface/commands.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.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.js';
 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/wrapper.d.ts

@@ -1,26 +1,27 @@
 /**
  * Public built-in extension ids accepted by createBoard({ extensions })
  */
-import { ActiveTargetDefinition } from '../first-party/active-target/types.js';
-import { BoardEventsDefinition } from '../first-party/board-events/types.js';
-import { LastMoveDefinition } from '../first-party/last-move/types.js';
-import { LegalMovesDefinition } from '../first-party/legal-moves/types.js';
-import { MainRendererDefinition } from '../first-party/main-renderer/types/extension.js';
-import { SelectedSquareDefinition } from '../first-party/selected-square/types.js';
-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.js';
+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

@@ -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,3 @@
 export { createBoard } from './wrapper/factory.js';
-export type { Chessboard, ChessboardExtensionInput, ChessboardInitOptions, ChessboardRuntimeSurface } from './wrapper/types.js';
+export type { Chessboard, ChessboardExtensionInput, ChessboardInitOptions } from './wrapper/types.js';
 export type { MoveRequestInput, PiecePositionRecordString } from './state/board/types/input.js';
-export type { RuntimeStateInitOptions } from './state/types.js';

package/dist/layout/factory.js

@@ -2,7 +2,7 @@ import { cloneDeep } from 'es-toolkit/object';
 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.js';
-import { RenderGeometry } from './types.js';
-/**
- * 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 { SceneRenderGeometry, Size } from './types.js';
+export declare function createRenderGeometry(sceneSize: Size, orientation: ColorCode): SceneRenderGeometry;