@mirasen/chessboard 1.0.0-rc.0 → 1.0.1

package/CHANGELOG.md

@@ -1,5 +1,25 @@
 # @mirasen/chessboard
 
+## 1.0.1
+
+### Patch Changes
+
+- be927e3: Call `preventDefault()` for board-handled input events to suppress native browser behavior.
+
+## 1.0.0
+
+### Major Changes
+
+- 2609920: First v1.0.0 release with the new extension-driven architecture, built-in chess interaction baseline, promotion flow, and auto-promote support.
+
+### Patch Changes
+
+- 31364b7: dependabot: directory '/', update @sveltejs/kit
+- 31364b7: dependabot: directory '/', update @vitest/browser-playwright
+- 31364b7: dependabot: directory '/', update eslint-plugin-svelte
+- 31364b7: dependabot: directory '/', update svelte
+- 2609920: Added promotion and auto-promotion to queen extensions
+
 ## 1.0.0-rc.0
 
 ### Major Changes

package/README.md

@@ -55,6 +55,15 @@ That means the board already covers a meaningful baseline chess UX instead of st
 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)
+- [Legal moves example](https://mirasen.io/chessboard/examples/legal-moves.html)
+- [Promotion example](https://mirasen.io/chessboard/examples/promotion.html)
+
 ## Usage
 
 ### Minimal example
@@ -77,10 +86,21 @@ board.setMovability({
 });
 ```
 
-### Explicit built-in interaction extensions
+### Explicit extensions
 
 ```ts
-import { createBoard } from '@mirasen/chessboard';
+import { createBoard, type Chessboard, type ChessboardExtensionInput } from '@mirasen/chessboard';
+
+const extensionList = [
+	// Always add renderer first, otherwise nothing will be rendered
+	'renderer',
+	'lastMove',
+	// Keep autoPromote before promotion, otherwise promotion may defer the move first
+	'autoPromote',
+	'promotion'
+	// customExtensionDefinition
+] as const satisfies readonly ChessboardExtensionInput[];
+let board: Chessboard<typeof extensionList> | null = null;
 
 const element = document.getElementById('board');
 
@@ -88,20 +108,9 @@ if (!element) {
 	throw new Error('Missing board element');
 }
 
-const board = createBoard({
+board = createBoard({
 	element,
-	extensions: [
-		// Always add renderer first, otherwise nothing will be rendered
-		'renderer',
-		'selectedSquare',
-		'activeTarget',
-		'legalMoves',
-		'lastMove',
-		'events',
-		// Keep autoPromote before promotion, otherwise promotion may defer the move first
-		'autoPromote',
-		'promotion'
-	]
+	extensions: extensionList
 });
 ```
 
@@ -226,6 +235,22 @@ These are separate extensions on purpose:
 
 This separation is a good example of the architecture: common chess UX can be built in without collapsing everything into one hardcoded board layer.
 
+```ts
+import { createBoard } from '@mirasen/chessboard';
+
+const element = document.getElementById('board');
+
+if (!element) {
+	throw new Error('Missing board element');
+}
+
+const board = createBoard({
+	element
+});
+
+board.extensions.autoPromote.toQueen = true;
+```
+
 ## Architecture
 
 `@mirasen/chessboard` is built around explicit boundaries:
@@ -255,19 +280,23 @@ A board that handles everything internally without clean boundaries becomes diff
 - clean internal architecture
 - extension-driven feature growth
 
-## Status
+## Project direction
 
-Release candidate for version `1.0.0`, focused on a strong built-in interaction baseline and extension-driven architecture.
+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.
 
-## Roadmap after RC
+## Artwork
 
-After the first release candidate, the next steps are expected to include:
+### Chessnut piece set
 
-- remaining test hardening
-- documentation expansion
-- more examples
-- further polish toward final `1.0.0`
+This project uses the Chessnut chess piece set.
 
-## Project direction
+This is the current default piece set used by the library.
 
-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.
+- Author: Alexis Luengas — https://github.com/LexLuengas
+- Source: https://github.com/LexLuengas/chessnut-pieces
+- License: Apache License 2.0 — https://github.com/LexLuengas/chessnut-pieces/blob/master/LICENSE.txt
+
+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/build/index.d.ts

@@ -0,0 +1,21 @@
+export { clearElementChildren, createSvgElement, updateElementAttributes } from '../../render/svg/helpers.js';
+export type { RuntimeReadonlyMutationSession } from '../../runtime/mutation/types.js';
+export { isNonEmptyPieceCode } from '../../state/board/check.js';
+export { fileOf, rankOf, squareOf } from '../../state/board/coords.js';
+export { denormalizeMove } from '../../state/board/denormalize.js';
+export { normalizePiece } from '../../state/board/normalize.js';
+export { fromPieceCode, toPieceCode } from '../../state/board/piece.js';
+export type { ColorCode, EmptyPieceCode, NonEmptyPieceCode, PieceCode, RoleCode, RolePromotionCode, Square, SquareFile, SquareRank } from '../../state/board/types/internal.js';
+export type { MoveOutput } from '../../state/board/types/output.js';
+export type { MovabilityModeCode } from '../../state/interaction/types/internal.js';
+export { extensionCreateInternalBase, extensionDestroyBase, extensionIsDestroyedBase, extensionIsMountedBase, extensionMountBase, extensionUnmountBase } from '../first-party/common/helpers.js';
+export type { ExtensionInternalBase, OpaqueColor } from '../first-party/common/types.js';
+export type { PieceUrlsInput } from '../first-party/main-renderer/types/input.js';
+export type { PieceUrls } from '../first-party/main-renderer/types/internal.js';
+export type { PromotionPieceCode } from '../first-party/promotion/types/internal.js';
+export type { ExtensionSlotName, ExtensionSlotSvgRoots } from '../types/basic/mount.js';
+export { isFrameMounted, isFrameRenderable } from '../types/basic/update.js';
+export type { UpdateFrameSnapshot } from '../types/basic/update.js';
+export { isUpdateContextMounted, isUpdateContextRenderable } from '../types/context/update.js';
+export type { ExtensionCreateInstanceOptions, ExtensionDefinition, ExtensionInstance } from '../types/extension.js';
+export type { ExtensionRuntimeSurface } from '../types/surface/main.js';

package/dist/extensions/build/index.js

@@ -0,0 +1,9 @@
+export { clearElementChildren, createSvgElement, updateElementAttributes } from '../../render/svg/helpers.js';
+export { isNonEmptyPieceCode } from '../../state/board/check.js';
+export { fileOf, rankOf, squareOf } from '../../state/board/coords.js';
+export { denormalizeMove } from '../../state/board/denormalize.js';
+export { normalizePiece } from '../../state/board/normalize.js';
+export { fromPieceCode, toPieceCode } from '../../state/board/piece.js';
+export { extensionCreateInternalBase, extensionDestroyBase, extensionIsDestroyedBase, extensionIsMountedBase, extensionMountBase, extensionUnmountBase } from '../first-party/common/helpers.js';
+export { isFrameMounted, isFrameRenderable } from '../types/basic/update.js';
+export { isUpdateContextMounted, isUpdateContextRenderable } from '../types/context/update.js';

package/dist/extensions/first-party/active-target/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 createActiveTarget(config = {}) {
     const mergedConfig = toMerged(DEFAULT_CONFIG, config);
@@ -31,7 +31,7 @@ function createActiveTargetInstance(config) {
     return {
         id: EXTENSION_ID,
         mount(env) {
-            extensionMount(internalState, env.slotRoots);
+            extensionMountBase(internalState, env.slotRoots);
         },
         onUpdate(context) {
             const needsRender = context.mutation.hasMutation({
@@ -98,11 +98,11 @@ function createActiveTargetInstance(config) {
             }
         },
         unmount() {
-            extensionUnmount(internalState);
+            extensionUnmountBase(internalState);
             extensionClean(internalState);
         },
         destroy() {
-            extensionDestroy(internalState);
+            extensionDestroyBase(internalState);
             extensionClean(internalState);
         }
     };

package/dist/extensions/first-party/active-target/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", "overPieces"];
 export type ExtensionSlotsType = typeof EXTENSION_SLOTS;
 export declare const EXTENSION_ID: "activeTarget";
@@ -15,7 +15,7 @@ export declare const DEFAULT_CONFIG: ActiveTargetConfig;
 export type ActiveTargetInitConfig = PartialDeep<ActiveTargetConfig>;
 export type ActiveTargetDefinition = ExtensionDefinition<typeof EXTENSION_ID, typeof EXTENSION_SLOTS, never>;
 export type ActiveTargetInstance = ExtensionInstance<typeof EXTENSION_ID, typeof EXTENSION_SLOTS, never>;
-export interface ActiveTargetInstanceInternal extends ExtensionInternal<ExtensionSlotsType> {
+export interface ActiveTargetInstanceInternal extends ExtensionInternalBase<ExtensionSlotsType> {
     svgRect: SVGRectElement | null;
     svgCircle: SVGCircleElement | null;
     readonly config: ActiveTargetConfig;

package/dist/extensions/first-party/active-target/types.js

@@ -1,4 +1,7 @@
-export const EXTENSION_SLOTS = ['underPieces', 'overPieces'];
+export const EXTENSION_SLOTS = [
+    'underPieces',
+    'overPieces'
+];
 export const EXTENSION_ID = 'activeTarget';
 export const DEFAULT_CONFIG = {
     squareColor: {

package/dist/extensions/first-party/auto-promote/types.d.ts

@@ -1,4 +1,3 @@
-import { ExtensionSlotSvgRoots } from '../../types/basic/mount.js';
 import { ExtensionDefinition, ExtensionInstance } from '../../types/extension.js';
 export declare const EXTENSION_SLOTS: readonly [];
 export type ExtensionSlotsType = typeof EXTENSION_SLOTS;
@@ -8,7 +7,6 @@ export interface AutoPromotePublic {
     toQueen: boolean;
 }
 export type AutoPromoteInstance = ExtensionInstance<typeof EXTENSION_ID, typeof EXTENSION_SLOTS, AutoPromotePublic>;
-export type AutoPromoteSlotRoots = ExtensionSlotSvgRoots<typeof EXTENSION_SLOTS>;
 export interface AutoPromoteInstanceInternal {
     toQueen: boolean;
 }

package/dist/extensions/first-party/board-events/types.d.ts

@@ -1,6 +1,5 @@
 import { RuntimeReadonlyMutationSession } from '../../../runtime/mutation/types.js';
 import { MoveOutput } from '../../../state/board/types/output.js';
-import { ExtensionSlotSvgRoots } from '../../types/basic/mount.js';
 import { UpdateFrameSnapshot } from '../../types/basic/update.js';
 import { ExtensionDefinition, ExtensionInstance } from '../../types/extension.js';
 export declare const EXTENSION_SLOTS: readonly [];
@@ -19,7 +18,6 @@ export interface BoardEventsPublic {
     setOnRawUpdate(callback: OnRawUpdateCallback | null): void;
 }
 export type BoardEventsInstance = ExtensionInstance<typeof EXTENSION_ID, typeof EXTENSION_SLOTS, BoardEventsPublic>;
-export type BoardEventsSlotRoots = ExtensionSlotSvgRoots<typeof EXTENSION_SLOTS>;
 export interface BoardEventsInstanceInternal {
     onUIMove: OnUIMoveCallback | null;
     onRawUpdate: OnRawUpdateCallback | null;

package/dist/extensions/first-party/common/helpers.d.ts

@@ -1,8 +1,8 @@
 import { ExtensionSlotName } from '../../types/basic/mount.js';
-import { ExtensionInternal } from './types.js';
-export declare function extensionCreateInternalBase<TSlots extends readonly ExtensionSlotName[]>(): ExtensionInternal<TSlots>;
-export declare function extensionIsMounted<TSlots extends readonly ExtensionSlotName[]>(state: ExtensionInternal<TSlots>): boolean;
-export declare function extensionIsDestroyed<TSlots extends readonly ExtensionSlotName[]>(state: ExtensionInternal<TSlots>): boolean;
-export declare function extensionMount<TSlots extends readonly ExtensionSlotName[]>(state: ExtensionInternal<TSlots>, slotRoots: NonNullable<ExtensionInternal<TSlots>['slotRoots']>): void;
-export declare function extensionUnmount<TSlots extends readonly ExtensionSlotName[]>(state: ExtensionInternal<TSlots>): void;
-export declare function extensionDestroy<TSlots extends readonly ExtensionSlotName[]>(state: ExtensionInternal<TSlots>): void;
+import { ExtensionInternalBase } from './types.js';
+export declare function extensionCreateInternalBase<TSlots extends readonly ExtensionSlotName[]>(): ExtensionInternalBase<TSlots>;
+export declare function extensionIsMountedBase<TSlots extends readonly ExtensionSlotName[]>(state: ExtensionInternalBase<TSlots>): boolean;
+export declare function extensionIsDestroyedBase<TSlots extends readonly ExtensionSlotName[]>(state: ExtensionInternalBase<TSlots>): boolean;
+export declare function extensionMountBase<TSlots extends readonly ExtensionSlotName[]>(state: ExtensionInternalBase<TSlots>, slotRoots: NonNullable<ExtensionInternalBase<TSlots>['slotRoots']>): void;
+export declare function extensionUnmountBase<TSlots extends readonly ExtensionSlotName[]>(state: ExtensionInternalBase<TSlots>): void;
+export declare function extensionDestroyBase<TSlots extends readonly ExtensionSlotName[]>(state: ExtensionInternalBase<TSlots>): void;

package/dist/extensions/first-party/common/helpers.js

@@ -6,28 +6,28 @@ export function extensionCreateInternalBase() {
         destroyed: false
     };
 }
-export function extensionIsMounted(state) {
+export function extensionIsMountedBase(state) {
     return state.slotRoots !== null;
 }
-export function extensionIsDestroyed(state) {
+export function extensionIsDestroyedBase(state) {
     return state.destroyed;
 }
-export function extensionMount(state, slotRoots) {
-    assert(!extensionIsMounted(state), 'Extension is already mounted');
-    assert(!extensionIsDestroyed(state), 'Extension is destroyed');
+export function extensionMountBase(state, slotRoots) {
+    assert(!extensionIsMountedBase(state), 'Extension is already mounted');
+    assert(!extensionIsDestroyedBase(state), 'Extension is destroyed');
     state.slotRoots = slotRoots;
 }
-export function extensionUnmount(state) {
-    assert(extensionIsMounted(state), 'Extension is not mounted');
+export function extensionUnmountBase(state) {
+    assert(extensionIsMountedBase(state), 'Extension is not mounted');
     for (const slotRoot of Object.values(state.slotRoots ?? {})) {
         clearElementChildren(slotRoot);
     }
     state.slotRoots = null;
 }
-export function extensionDestroy(state) {
-    assert(!extensionIsDestroyed(state), 'Extension is already destroyed');
-    if (extensionIsMounted(state)) {
-        extensionUnmount(state);
+export function extensionDestroyBase(state) {
+    assert(!extensionIsDestroyedBase(state), 'Extension is already destroyed');
+    if (extensionIsMountedBase(state)) {
+        extensionUnmountBase(state);
     }
     state.destroyed = true;
 }

package/dist/extensions/first-party/common/types.d.ts

@@ -1,10 +1,9 @@
 import { ExtensionSlotName, ExtensionSlotSvgRoots } from '../../types/basic/mount.js';
-export interface ExtensionInternal<TSlots extends readonly ExtensionSlotName[]> {
+export interface ExtensionInternalBase<TSlots extends readonly ExtensionSlotName[]> {
     slotRoots: ExtensionSlotSvgRoots<TSlots> | null;
     destroyed: boolean;
 }
-export type AnyExtensionInternal = ExtensionInternal<readonly ExtensionSlotName[]>;
 export interface OpaqueColor {
     color: string;
-    opacity: number;
+    opacity: number | string;
 }

package/dist/extensions/first-party/last-move/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 createLastMove(config = {}) {
     const mergedConfig = toMerged(DEFAULT_CONFIG, config);
@@ -31,7 +31,7 @@ function createLastMoveInstance(config) {
     return {
         id: EXTENSION_ID,
         mount(env) {
-            extensionMount(internalState, env.slotRoots);
+            extensionMountBase(internalState, env.slotRoots);
         },
         onUpdate(context) {
             const needsRender = context.mutation.hasMutation({
@@ -95,11 +95,11 @@ function createLastMoveInstance(config) {
             }
         },
         unmount() {
-            extensionUnmount(internalState);
+            extensionUnmountBase(internalState);
             extensionClean(internalState);
         },
         destroy() {
-            extensionDestroy(internalState);
+            extensionDestroyBase(internalState);
             extensionClean(internalState);
         }
     };

package/dist/extensions/first-party/last-move/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: "lastMove";
@@ -9,7 +9,7 @@ export declare const DEFAULT_CONFIG: LastMoveConfig;
 export type LastMoveInitConfig = PartialDeep<LastMoveConfig>;
 export type LastMoveDefinition = ExtensionDefinition<typeof EXTENSION_ID, typeof EXTENSION_SLOTS, never>;
 export type LastMoveInstance = ExtensionInstance<typeof EXTENSION_ID, typeof EXTENSION_SLOTS, never>;
-export interface LastMoveInstanceInternal extends ExtensionInternal<ExtensionSlotsType> {
+export interface LastMoveInstanceInternal extends ExtensionInternalBase<ExtensionSlotsType> {
     svgRectFrom: SVGRectElement | null;
     svgRectTo: SVGRectElement | null;
     readonly config: LastMoveConfig;

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

@@ -4,7 +4,7 @@ import { clearElementChildren, createSvgElement } from '../../../render/svg/help
 import { isNonEmptyPieceCode } from '../../../state/board/check.js';
 import { fromPieceCode } from '../../../state/board/piece.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 createLegalMoves(config = {}) {
     const mergedConfig = toMerged(DEFAULT_CONFIG, config);
@@ -31,7 +31,7 @@ function createLegalMovesInstance(config) {
     return {
         id: EXTENSION_ID,
         mount(env) {
-            extensionMount(internalState, env.slotRoots);
+            extensionMountBase(internalState, env.slotRoots);
         },
         onUpdate(context) {
             const needsRender = context.mutation.hasMutation({
@@ -90,11 +90,11 @@ function createLegalMovesInstance(config) {
             }
         },
         unmount() {
-            extensionUnmount(internalState);
+            extensionUnmountBase(internalState);
             extensionClean(internalState);
         },
         destroy() {
-            extensionDestroy(internalState);
+            extensionDestroyBase(internalState);
             extensionClean(internalState);
         }
     };

package/dist/extensions/first-party/legal-moves/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 ["overPieces"];
 export type ExtensionSlotsType = typeof EXTENSION_SLOTS;
 export declare const EXTENSION_ID: "legalMoves";
@@ -19,7 +19,7 @@ export declare const DEFAULT_CONFIG: LegalMovesConfig;
 export type LegalMovesInitConfig = PartialDeep<LegalMovesConfig>;
 export type LegalMovesDefinition = ExtensionDefinition<typeof EXTENSION_ID, typeof EXTENSION_SLOTS, never>;
 export type LegalMovesInstance = ExtensionInstance<typeof EXTENSION_ID, typeof EXTENSION_SLOTS, never>;
-export interface LegalMovesInstanceInternal extends ExtensionInternal<ExtensionSlotsType> {
+export interface LegalMovesInstanceInternal extends ExtensionInternalBase<ExtensionSlotsType> {
     destroyed: boolean;
     svgCircles: SVGCircleElement[];
     readonly config: LegalMovesConfig;

package/dist/extensions/first-party/main-renderer/factory.js

@@ -1,5 +1,5 @@
 import { toMerged } from 'es-toolkit';
-import { extensionCreateInternalBase, extensionDestroy, extensionMount, extensionUnmount } from '../common/helpers.js';
+import { extensionCreateInternalBase, extensionDestroyBase, extensionMountBase, extensionUnmountBase } from '../common/helpers.js';
 import { createMainRendererAnimation } from './animation/factory.js';
 import { createMainRendererBoard } from './board/factory.js';
 import { createMainRendererCoordinates } from './coordinates/factory.js';
@@ -51,7 +51,7 @@ function createMainRendererInstance(options, config) {
     return {
         id: EXTENSION_ID,
         mount(env) {
-            extensionMount(internalState, env.slotRoots);
+            extensionMountBase(internalState, env.slotRoots);
         },
         onUpdate(context) {
             internalState.board.onUpdate(context);
@@ -85,11 +85,11 @@ function createMainRendererInstance(options, config) {
         },
         unmount() {
             extensionUnmountLocal(internalState);
-            extensionUnmount(internalState);
+            extensionUnmountBase(internalState);
         },
         destroy() {
             extensionUnmountLocal(internalState);
-            extensionDestroy(internalState);
+            extensionDestroyBase(internalState);
         }
     };
 }

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

@@ -1,12 +1,12 @@
 import { ExtensionRuntimeSurface } from '../../../types/surface/main.js';
-import { ExtensionInternal } from '../../common/types.js';
+import { ExtensionInternalBase } from '../../common/types.js';
 import { MainRendererAnimation } from '../animation/types.js';
 import { MainRendererBoard } from '../board/types.js';
 import { MainRendererCoordinates } from '../coordinates/types.js';
 import { MainRendererDrag } from '../drag/types.js';
 import { MainRendererPieces } from '../pieces/types.js';
 import { ExtensionSlotsType } from './extension.js';
-export interface MainRendererInstanceInternal extends ExtensionInternal<ExtensionSlotsType> {
+export interface MainRendererInstanceInternal extends ExtensionInternalBase<ExtensionSlotsType> {
     readonly board: MainRendererBoard;
     readonly coordinates: MainRendererCoordinates;
     readonly pieces: MainRendererPieces;

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

@@ -3,7 +3,7 @@ import { createSvgElement, updateElementAttributes } from '../../../render/svg/h
 import { fileOf, rankOf, squareOf } from '../../../state/board/coords.js';
 import { toPieceCode } from '../../../state/board/piece.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 { normalizePromotionConfig } from './normalize.js';
 import { EXTENSION_ID, EXTENSION_SLOTS } from './types/main.js';
 export function createPromotion(config = {}) {
@@ -57,7 +57,7 @@ function createPromotionInstance(options, config) {
     return {
         id: EXTENSION_ID,
         mount(env) {
-            extensionMount(internalState, env.slotRoots);
+            extensionMountBase(internalState, env.slotRoots);
         },
         onUIMoveRequest(context) {
             const request = context.request;
@@ -208,11 +208,11 @@ function createPromotionInstance(options, config) {
             internalState.runtimeSurface.commands.cancelDeferredUIMoveRequest();
         },
         unmount() {
-            extensionUnmount(internalState);
+            extensionUnmountBase(internalState);
             extensionClean(internalState);
         },
         destroy() {
-            extensionDestroy(internalState);
+            extensionDestroyBase(internalState);
             extensionClean(internalState);
         }
     };

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

@@ -1,7 +1,7 @@
 import { RolePromotionCode, Square } from '../../../../state/board/types/internal.js';
 import { ExtensionDefinition, ExtensionInstance } from '../../../types/extension.js';
 import { ExtensionRuntimeSurface } from '../../../types/surface/main.js';
-import { ExtensionInternal } from '../../common/types.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;
@@ -12,7 +12,7 @@ export interface PromotionPieceNode {
     readonly svg: SVGImageElement;
     readonly rect: SVGRectElement;
 }
-export interface PromotionInstanceInternal extends ExtensionInternal<ExtensionSlotsType> {
+export interface PromotionInstanceInternal extends ExtensionInternalBase<ExtensionSlotsType> {
     readonly config: PromotionConfig;
     readonly svgPromotionPieces: Map<RolePromotionCode, PromotionPieceNode>;
     readonly activePromotionSquares: Map<Square, RolePromotionCode>;

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({
@@ -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 { builtInExtensionFactoryMap, BuiltInExtensionId } 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/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/runtime/input/controller/factory.js

@@ -11,6 +11,7 @@ export function createInteractionController(options) {
         onEvent(context) {
             internalState.surface.onEvent(context);
             if (context.rawEvent.defaultPrevented) {
+                transmitTransientInput(internalState, context);
                 return; // The event has been handled by the surface (extensions)
             }
             switch (context.rawEvent.type) {
@@ -28,6 +29,10 @@ export function createInteractionController(options) {
                     break;
             }
             transmitTransientInput(internalState, context);
+            if (!context.rawEvent.defaultPrevented && context.rawEvent.cancelable) {
+                // Suppress native browser behavior for board-handled events.
+                context.rawEvent.preventDefault();
+            }
         }
     };
 }

package/package.json

@@ -1,7 +1,7 @@
 {
 	"name": "@mirasen/chessboard",
 	"description": "Framework-agnostic TypeScript chessboard platform with real chess interaction built in.",
-	"version": "1.0.0-rc.0",
+	"version": "1.0.1",
 	"license": "MIT",
 	"author": {
 		"name": "Mirasen",
@@ -38,7 +38,11 @@
 			"types": "./dist/extensions/index.d.ts",
 			"import": "./dist/extensions/index.js"
 		},
-		"./unstable/*.js": {
+		"./extensions/build": {
+			"types": "./dist/extensions/build/index.d.ts",
+			"import": "./dist/extensions/build/index.js"
+		},
+		"./unstable/*": {
 			"types": "./dist/*.d.ts",
 			"import": "./dist/*.js"
 		}
@@ -52,10 +56,8 @@
 		"lint": "prettier --check . && eslint .",
 		"check": "tsc --skipLibCheck --noEmit",
 		"check:test": "tsc --project tsconfig-test.json --skipLibCheck --noEmit",
-		"test": "echo 'No tests for now...'",
-		"test-backup": "npm run check:test && vitest run --run",
-		"coverage": "echo 'No tests for now...'",
-		"coverage-backup": "vitest run --coverage",
+		"test": "npm run check:test && vitest run --run",
+		"coverage": "vitest run --coverage",
 		"changeset:version": "changeset version && npm install && npm run format && git add --all",
 		"changeset:publish": "changeset publish"
 	},
@@ -91,7 +93,7 @@
 		"vitest": "^4.0.18"
 	},
 	"engines": {
-		"node": ">=22"
+		"node": ">=20"
 	},
 	"dependencies": {
 		"@echecs/fen": "^2.1.0",