@mirasen/chessboard 1.1.5 → 1.2.1

package/dist/extensions/first-party/main-renderer/pieces/render.d.ts

@@ -1,3 +1,3 @@
 import { ExtensionRenderContext } from '../../../types/context/render.js';
 import { MainRendererPiecesInternal } from './types.js';
-export declare function rendererPiecesRender(state: MainRendererPiecesInternal, context: ExtensionRenderContext, layer: SVGElement): void;
+export declare function rendererPiecesRender(state: MainRendererPiecesInternal, context: ExtensionRenderContext, slot: SVGGElement): void;

package/dist/extensions/first-party/main-renderer/pieces/render.js

@@ -1,8 +1,8 @@
-import { createSvgElement, updateElementAttributes } from '../../../../render/svg/helpers.js';
+import { createSvgElement, updateSvgElementAttributes } from '../../../../render/svg/helpers.js';
 import { isNonEmptyPieceCode } from '../../../../state/board/check.js';
 import { SQUARE_COUNT } from '../../../../state/board/types/internal.js';
 import { DirtyLayer } from '../types/extension.js';
-export function rendererPiecesRender(state, context, layer) {
+export function rendererPiecesRender(state, context, slot) {
     if ((context.invalidation.dirtyLayers & DirtyLayer.Pieces) === 0) {
         return;
     }
@@ -13,22 +13,22 @@ export function rendererPiecesRender(state, context, layer) {
         const existing = state.pieceNodes.get(sq) || null;
         const suppressed = state.suppressedSquares.has(sq);
         if (isNonEmptyPieceCode(pieceCode) && !suppressed) {
-            const url = state.config[pieceCode];
+            const href = state.resolver.getHref(pieceCode);
             const r = geometry.getSquareRect(sq);
             if (existing !== null) {
-                updateElementAttributes(existing.root, {
+                updateSvgElementAttributes(existing.root, {
                     x: r.x.toString(),
                     y: r.y.toString(),
                     width: r.width.toString(),
                     height: r.height.toString(),
-                    href: url
+                    href
                 });
             }
             else {
                 state.pieceNodes.set(sq, {
-                    root: createSvgElement(layer, 'image', {
+                    root: createSvgElement(slot, 'use', {
                         'data-chessboard-id': `piece-${pieceCode}-${sq}`,
-                        href: url,
+                        href,
                         x: r.x.toString(),
                         y: r.y.toString(),
                         width: r.width.toString(),
@@ -38,7 +38,7 @@ export function rendererPiecesRender(state, context, layer) {
             }
         }
         else if (existing !== null) {
-            layer.removeChild(existing.root);
+            slot.removeChild(existing.root);
             state.pieceNodes.delete(sq);
         }
     }

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

@@ -2,19 +2,19 @@ import { Square } from '../../../../state/board/types/internal.js';
 import { ExtensionCleanAnimationContext } from '../../../types/context/animation.js';
 import { ExtensionRenderContext } from '../../../types/context/render.js';
 import { ExtensionUpdateContext } from '../../../types/context/update.js';
-import { PieceUrls } from '../types/internal.js';
+import type { PieceSymbolResolver } from '../piece-symbols.js';
 type PieceNodeRecord = {
-    root: SVGImageElement;
+    root: SVGUseElement;
 };
 export interface MainRendererPiecesInternal {
-    readonly config: PieceUrls;
+    readonly resolver: PieceSymbolResolver;
     readonly pieceNodes: Map<Square, PieceNodeRecord>;
     suppressedSquares: ReadonlySet<Square>;
 }
 export interface MainRendererPieces {
     onUpdate(context: ExtensionUpdateContext, animationSuppressedSquares: ReadonlySet<Square>): void;
     refreshSuppressedSquares(context: ExtensionCleanAnimationContext, animationSuppressedSquares: ReadonlySet<Square>): void;
-    render(context: ExtensionRenderContext, layer: SVGElement): void;
+    render(context: ExtensionRenderContext, slot: SVGGElement): void;
     unmount(): void;
 }
 export {};

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

@@ -1,7 +1,7 @@
 import { ExtensionDefinition, ExtensionInstance } from '../../../types/extension.js';
 import { MainRendererConfigInput } from './input.js';
 export type MainRendererInitOptions = Partial<MainRendererConfigInput>;
-export declare const EXTENSION_SLOTS: readonly ["board", "coordinates", "pieces", "animation", "drag"];
+export declare const EXTENSION_SLOTS: readonly ["defs", "board", "coordinates", "pieces", "animation", "drag"];
 export type ExtensionSlotsType = typeof EXTENSION_SLOTS;
 export declare const EXTENSION_ID: "renderer";
 export type MainRendererDefinition = ExtensionDefinition<typeof EXTENSION_ID, typeof EXTENSION_SLOTS, never>;

package/dist/extensions/first-party/main-renderer/types/extension.js

@@ -1,4 +1,11 @@
-export const EXTENSION_SLOTS = ['board', 'coordinates', 'pieces', 'animation', 'drag'];
+export const EXTENSION_SLOTS = [
+    'defs',
+    'board',
+    'coordinates',
+    'pieces',
+    'animation',
+    'drag'
+];
 export const EXTENSION_ID = 'renderer';
 export var DirtyLayer;
 (function (DirtyLayer) {

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

@@ -4,6 +4,7 @@ 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 type { PieceSymbolResolver } from '../piece-symbols.js';
 import { MainRendererPieces } from '../pieces/types.js';
 import { ExtensionSlotsType } from './extension.js';
 export interface MainRendererInstanceInternal extends ExtensionInternalBase<ExtensionSlotsType> {
@@ -13,4 +14,5 @@ export interface MainRendererInstanceInternal extends ExtensionInternalBase<Exte
     readonly drag: MainRendererDrag;
     readonly animation: MainRendererAnimation;
     readonly runtimeSurface: ExtensionRuntimeSurface;
+    readonly pieceSymbolResolver: PieceSymbolResolver;
 }

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

@@ -1,5 +1,5 @@
 import assert from '@ktarmyshov/assert';
-import { createSvgElement, updateElementAttributes } from '../../../render/svg/helpers.js';
+import { createSvgElement, updateSvgElementAttributes } from '../../../render/svg/helpers.js';
 import { fileOf, rankOf, squareOf } from '../../../state/board/coords.js';
 import { toPieceCode } from '../../../state/board/piece.js';
 import { isUpdateContextRenderable } from '../../types/context/update.js';
@@ -18,7 +18,7 @@ export function createPromotion(config = {}) {
 }
 function createPromotionInternal(options, config) {
     return {
-        ...extensionCreateInternalBase(),
+        ...extensionCreateInternalBase(options),
         svgPromotionPieces: new Map(),
         activePromotionSquares: new Map(),
         svgHoverRect: null,
@@ -117,7 +117,7 @@ function createPromotionInstance(options, config) {
             }
             // Create or update a node for each promotion role
             assert(internalState.slotRoots, 'Slot roots should be available when render is called');
-            const layer = internalState.slotRoots.animation;
+            const slot = internalState.slotRoots.animation;
             for (let i = 0; i < promotedToSorted.length; i++) {
                 const roleCode = promotedToSorted[i];
                 const displayRank = (targetRank + i * rankStep);
@@ -144,15 +144,15 @@ function createPromotionInstance(options, config) {
                 internalState.activePromotionSquares.set(displaySquare, roleCode);
                 const existing = internalState.svgPromotionPieces.get(roleCode) ?? null;
                 if (existing !== null) {
-                    updateElementAttributes(existing.rect, rectAttrs);
-                    updateElementAttributes(existing.svg, imageAttrs);
+                    updateSvgElementAttributes(existing.rect, rectAttrs);
+                    updateSvgElementAttributes(existing.svg, imageAttrs);
                 }
                 else {
-                    const rect = createSvgElement(layer, 'rect', {
+                    const rect = createSvgElement(slot, 'rect', {
                         'data-chessboard-id': `promotion-bg-${roleCode}`,
                         ...rectAttrs
                     });
-                    const svg = createSvgElement(layer, 'image', {
+                    const svg = createSvgElement(slot, 'image', {
                         'data-chessboard-id': `promotion-piece-${roleCode}`,
                         ...imageAttrs
                     });
@@ -176,12 +176,12 @@ function createPromotionInstance(options, config) {
                     'shape-rendering': 'crispEdges'
                 };
                 if (internalState.svgHoverRect) {
-                    updateElementAttributes(internalState.svgHoverRect, attrs);
+                    updateSvgElementAttributes(internalState.svgHoverRect, attrs);
                 }
                 else {
                     assert(internalState.slotRoots, 'Slot roots should be available when renderTransientVisuals is called');
-                    const layer = internalState.slotRoots.animation;
-                    internalState.svgHoverRect = createSvgElement(layer, 'rect', {
+                    const slot = internalState.slotRoots.animation;
+                    internalState.svgHoverRect = createSvgElement(slot, 'rect', {
                         'data-chessboard-id': 'promotion-hover',
                         ...attrs
                     });

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

@@ -1,6 +1,6 @@
 import assert from '@ktarmyshov/assert';
 import { toMerged } from 'es-toolkit';
-import { createSvgElement, updateElementAttributes } from '../../../render/svg/helpers.js';
+import { createSvgElement, updateSvgElementAttributes } from '../../../render/svg/helpers.js';
 import { isUpdateContextRenderable } from '../../types/context/update.js';
 import { extensionCreateInternalBase, extensionDestroyBase, extensionMountBase, extensionUnmountBase } from '../common/helpers.js';
 import { DEFAULT_CONFIG, EXTENSION_ID, EXTENSION_SLOTS } from './types.js';
@@ -9,14 +9,14 @@ export function createSelectedSquare(config = {}) {
     return {
         id: EXTENSION_ID,
         slots: EXTENSION_SLOTS,
-        createInstance() {
-            return createSelectedSquareInstance(mergedConfig);
+        createInstance(options) {
+            return createSelectedSquareInstance(options, mergedConfig);
         }
     };
 }
-function createSelectedSquareInternal(config) {
+function createSelectedSquareInternal(options, config) {
     return {
-        ...extensionCreateInternalBase(),
+        ...extensionCreateInternalBase(options),
         svgRect: null,
         config
     };
@@ -24,8 +24,8 @@ function createSelectedSquareInternal(config) {
 function extensionClean(state) {
     state.svgRect = null;
 }
-function createSelectedSquareInstance(config) {
-    const internalState = createSelectedSquareInternal(config);
+function createSelectedSquareInstance(options, config) {
+    const internalState = createSelectedSquareInternal(options, config);
     return {
         id: EXTENSION_ID,
         mount(env) {
@@ -73,7 +73,7 @@ function createSelectedSquareInstance(config) {
                 });
             }
             else {
-                updateElementAttributes(internalState.svgRect, rectAttributes);
+                updateSvgElementAttributes(internalState.svgRect, rectAttributes);
             }
         },
         unmount() {

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

@@ -1,5 +1,5 @@
 import assert from '@ktarmyshov/assert';
-import { createSvgElement, updateElementAttributes } from '../../../render/svg/helpers.js';
+import { createSvgElement, updateSvgElementAttributes } from '../../../render/svg/helpers.js';
 import { isUpdateContextRenderable } from '../../types/context/update.js';
 import { extensionCreateInternalBase, extensionDestroyBase, extensionMountBase, extensionUnmountBase } from '../common/helpers.js';
 import { EXTENSION_ID, EXTENSION_SLOTS } from './types.js';
@@ -7,14 +7,14 @@ export function createWatermark() {
     return {
         id: EXTENSION_ID,
         slots: EXTENSION_SLOTS,
-        createInstance() {
-            return createWatermarkInstance();
+        createInstance(options) {
+            return createWatermarkInstance(options);
         }
     };
 }
-function createWatermarkInternal() {
+function createWatermarkInternal(options) {
     return {
-        ...extensionCreateInternalBase(),
+        ...extensionCreateInternalBase(options),
         svgWatermark: null
     };
 }
@@ -24,8 +24,8 @@ function extensionClean(state) {
 const watermarkUrl = new URL('../../../../assets/watermark/mirasen.svg', import.meta.url).toString();
 const squareRatio = 0.8; // watermark size relative to square size
 const opacity = '0.3';
-function createWatermarkInstance() {
-    const internalState = createWatermarkInternal();
+function createWatermarkInstance(options) {
+    const internalState = createWatermarkInternal(options);
     return {
         id: EXTENSION_ID,
         mount(env) {
@@ -67,7 +67,7 @@ function createWatermarkInstance() {
                 });
             }
             else {
-                updateElementAttributes(internalState.svgWatermark, watermarkAttributes);
+                updateSvgElementAttributes(internalState.svgWatermark, watermarkAttributes);
             }
         },
         unmount() {

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

@@ -1,7 +1,7 @@
-import { Square } from '../../../state/board/types/internal.js';
-import { ScenePoint } from '../basic/transient-visuals.js';
+import type { Square } from '../../../state/board/types/internal.js';
+import type { ScenePoint } from '../basic/transient-visuals.js';
 export interface ScenePointerEvent {
-    readonly type: 'pointercancel' | 'pointerdown' | 'pointerenter' | 'pointerleave' | 'pointermove' | 'pointerout' | 'pointerover' | 'pointerrawupdate' | 'pointerup';
+    readonly type: 'pointercancel' | 'pointerdown' | 'pointerenter' | 'pointerleave' | 'pointermove' | 'pointerout' | 'pointerover' | 'pointerrawupdate' | 'pointerup' | 'contextmenu';
     readonly point: ScenePoint;
     readonly clampedPoint: ScenePoint;
     readonly boardClampedPoint: ScenePoint | null;
@@ -9,3 +9,32 @@ export interface ScenePointerEvent {
 }
 export declare const ALL_SCENE_POINTER_EVENT_TYPES: ReadonlySet<string>;
 export type SceneEvent = ScenePointerEvent;
+export type RuntimeInteractionActionStartLiftedDrag = {
+    type: 'startLiftedDrag';
+    source: Square;
+    target: Square;
+};
+export type RuntimeInteractionActionStartReleaseTargetingDrag = {
+    type: 'startReleaseTargetingDrag';
+    source: Square;
+    target: Square;
+};
+export type RuntimeInteractionActionCompleteCoreDrag = {
+    type: 'completeCoreDragTo';
+    target: Square;
+};
+export type RuntimeInteractionActionCompleteExtensionDrag = {
+    type: 'completeExtensionDrag';
+    target: Square | null;
+};
+export type RuntimeInteractionActionUpdateDragSessionCurrentTarget = {
+    type: 'updateDragSessionCurrentTarget';
+    target: Square | null;
+};
+export type RuntimeInteractionActionCancelActiveInteraction = {
+    type: 'cancelActiveInteraction';
+};
+export type RuntimeInteractionActionCancelInteraction = {
+    type: 'cancelInteraction';
+};
+export type RuntimeInteractionAction = RuntimeInteractionActionStartLiftedDrag | RuntimeInteractionActionStartReleaseTargetingDrag | RuntimeInteractionActionCompleteCoreDrag | RuntimeInteractionActionCompleteExtensionDrag | RuntimeInteractionActionUpdateDragSessionCurrentTarget | RuntimeInteractionActionCancelActiveInteraction | RuntimeInteractionActionCancelInteraction;

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

@@ -7,5 +7,6 @@ export const ALL_SCENE_POINTER_EVENT_TYPES = new Set([
     'pointerout',
     'pointerover',
     'pointerrawupdate',
-    'pointerup'
+    'pointerup',
+    'contextmenu'
 ]);

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

@@ -1,6 +1,9 @@
-export type ExtensionSlotName = 'defs' | 'board' | 'coordinates' | 'underPieces' | 'pieces' | 'overPieces' | 'animation' | 'underDrag' | 'drag' | 'overDrag';
 export declare const ALL_EXTENSION_SLOTS: readonly ["defs", "board", "coordinates", "underPieces", "pieces", "overPieces", "animation", "underDrag", "drag", "overDrag"];
-export type ExtensionSlotSvgRoots<TSlots extends readonly ExtensionSlotName[]> = Readonly<Record<TSlots[number], SVGGElement>>;
+export type ExtensionSlotName = (typeof ALL_EXTENSION_SLOTS)[number];
+export type ExtensionSlotSvgRoot<TSlot extends ExtensionSlotName> = TSlot extends 'defs' ? SVGDefsElement : SVGGElement;
+export type ExtensionSlotSvgRoots<TSlots extends readonly ExtensionSlotName[]> = Readonly<{
+    [TSlot in TSlots[number]]: ExtensionSlotSvgRoot<TSlot>;
+}>;
 export type ExtensionAllocatedSlotsInternal = Partial<ExtensionSlotSvgRoots<readonly ExtensionSlotName[]>>;
 export interface ExtensionInstanceMountOptions<TSlots extends readonly ExtensionSlotName[]> {
     slotRoots: ExtensionSlotSvgRoots<TSlots>;

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

@@ -10,5 +10,3 @@ export const ALL_EXTENSION_SLOTS = [
     'drag',
     'overDrag'
 ];
-// eslint-disable-next-line @typescript-eslint/no-unused-vars
-const _checkAllExtensionSlotsExact = true;

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

@@ -1,4 +1,4 @@
-import { Square } from '../../../state/board/types/internal.js';
+import type { Square } from '../../../state/board/types/internal.js';
 export interface ScenePoint {
     readonly x: number;
     readonly y: number;

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

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

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

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

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

@@ -1,11 +1,12 @@
-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';
+import type { RuntimeReadonlyMutationSession } from '../../../runtime/mutation/types.js';
+import type { ExtensionInvalidationState } from '../../invalidation/types.js';
+import type { RenderFrameSnapshot } from '../basic/render.js';
+import type { UpdateFrameSnapshot, UpdateFrameSnapshotMounted, UpdateFrameSnapshotUnmounted } from '../basic/update.js';
 export interface ExtensionUpdateContextCommon {
     readonly previousFrame: UpdateFrameSnapshot | null;
     readonly mutation: RuntimeReadonlyMutationSession;
     readonly currentFrame: UpdateFrameSnapshot;
+    readonly invalidation: ExtensionInvalidationState;
 }
 export interface ExtensionUpdateContextCommonUnmounted extends ExtensionUpdateContextCommon {
     readonly currentFrame: UpdateFrameSnapshotUnmounted;
@@ -14,9 +15,7 @@ export interface ExtensionUpdateContextCommonMounted extends ExtensionUpdateCont
     readonly currentFrame: UpdateFrameSnapshotMounted;
 }
 export type ExtensionUpdateContextUnmounted = ExtensionUpdateContextCommonUnmounted;
-export interface ExtensionUpdateContextMounted extends ExtensionUpdateContextCommonMounted {
-    readonly invalidation: ExtensionInvalidationState;
-}
+export type ExtensionUpdateContextMounted = ExtensionUpdateContextCommonMounted;
 export type ExtensionUpdateContext = ExtensionUpdateContextUnmounted | ExtensionUpdateContextMounted;
 export declare function isUpdateContextCommonMounted<T extends ExtensionUpdateContextCommon>(context: T): context is T & ExtensionUpdateContextCommonMounted;
 export declare function isUpdateContextMounted<T extends ExtensionUpdateContext>(context: T): context is T & ExtensionUpdateContextMounted;

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

@@ -1,3 +1,4 @@
+import type { SvgIdResolver } from '../../render/svg/ids.js';
 import { ExtensionDragSessionSnapshot } from './basic/interaction.js';
 import { ExtensionInstanceMountOptions, ExtensionSlotName } from './basic/mount.js';
 import { ExtensionAnimationFinishedContext, ExtensionCleanAnimationContext, ExtensionPrepareAnimationContext, ExtensionRenderAnimationContext } from './context/animation.js';
@@ -19,6 +20,7 @@ interface ExtensionInstanceBase<TId extends string, TSlots extends readonly Exte
     onAnimationFinished?(context: ExtensionAnimationFinishedContext): void;
     cleanAnimation?(context: ExtensionCleanAnimationContext): void;
     completeDrag?(session: ExtensionDragSessionSnapshot): void;
+    cancelDrag?(session: ExtensionDragSessionSnapshot): void;
     renderTransientVisuals?(context: ExtensionRenderTransientVisualsContext): void;
     onUIMoveRequest?(context: ExtensionPendingUIMoveRequestContext): void;
     onEvent?(context: ExtensionOnEventContext): void;
@@ -30,6 +32,7 @@ export type ExtensionInstance<TId extends string, TSlots extends readonly Extens
 export type AnyExtensionInstance = ExtensionInstance<string, readonly ExtensionSlotName[], unknown>;
 export interface ExtensionCreateInstanceOptions {
     runtimeSurface: ExtensionRuntimeSurface;
+    svgIds: SvgIdResolver;
 }
 export interface ExtensionDefinition<TId extends string, TSlots extends readonly ExtensionSlotName[], TPublic> {
     readonly id: TId;

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

@@ -43,6 +43,7 @@ export interface ExtensionSystem {
     onUIMoveRequest(context: ExtensionPendingUIMoveRequestContext): void;
     onEvent(context: ExtensionOnEventContext): void;
     completeDrag(session: DragSessionExtensionOwned): void;
+    cancelDrag(session: DragSessionExtensionOwned): void;
     onUnmount(): void;
     onDestroy(): void;
 }

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

@@ -27,7 +27,7 @@ export interface ExtensionRuntimeSurfaceCommands {
     clearInteraction(): boolean;
     resolveDeferredUIMoveRequest(details: DeferredUIMoveResolutionDetails): Move;
     cancelDeferredUIMoveRequest(): boolean;
-    requestRender(request: ExtensionRuntimeSurfaceCommandsRenderRequest): void;
+    requestRender(request: ExtensionRuntimeSurfaceCommandsRenderRequest): boolean;
     getSnapshot(): ExtensionRuntimeSurfaceCommandsSnapshot;
 }
 export interface ExtensionRuntimeSurfaceCommandsInternalSurface extends ExtensionRuntimeSurfaceCommands {

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

@@ -1,10 +1,12 @@
-import { ExtensionAnimationController } from '../basic/animation.js';
-import { ExtensionRuntimeSurfaceCommands } from './commands.js';
-import { ExtensionRuntimeSurfaceEvents } from './events.js';
-import { ExtensionRuntimeSurfaceTransientVisuals } from './transient-visuals.js';
+import type { ExtensionInvalidationState } from '../../invalidation/types.js';
+import type { ExtensionAnimationController } from '../basic/animation.js';
+import type { ExtensionRuntimeSurfaceCommands } from './commands.js';
+import type { ExtensionRuntimeSurfaceEvents } from './events.js';
+import type { ExtensionRuntimeSurfaceTransientVisuals } from './transient-visuals.js';
 export interface ExtensionRuntimeSurface {
     readonly commands: ExtensionRuntimeSurfaceCommands;
     readonly animation: ExtensionAnimationController;
     readonly events: ExtensionRuntimeSurfaceEvents;
     readonly transientVisuals: ExtensionRuntimeSurfaceTransientVisuals;
+    readonly invalidation: ExtensionInvalidationState;
 }

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

@@ -1,4 +1,5 @@
 import { createActiveTarget } from '../first-party/active-target/factory.js';
+import { createAnnotations } from '../first-party/annotations/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';
@@ -17,10 +18,11 @@ export declare const builtInExtensionFactoryMap: {
     events: typeof createBoardEvents;
     autoPromote: typeof createAutoPromote;
     promotion: typeof createPromotion;
+    annotations: typeof createAnnotations;
 };
 export type BuiltInExtensionId = keyof typeof builtInExtensionFactoryMap;
 export type BuiltInExtensionDefinitionMap = {
     [Id in BuiltInExtensionId]: ReturnType<(typeof builtInExtensionFactoryMap)[Id]>;
 };
-export declare const DefaultBuiltinChessboardExtensions: readonly ["renderer", "watermark", "selectedSquare", "lastMove", "activeTarget", "legalMoves", "events", "autoPromote", "promotion"];
+export declare const DefaultBuiltinChessboardExtensions: readonly ["renderer", "watermark", "selectedSquare", "lastMove", "activeTarget", "legalMoves", "events", "autoPromote", "promotion", "annotations"];
 export type DefaultBuiltinChessboardExtensions = typeof DefaultBuiltinChessboardExtensions;

package/dist/extensions/types/wrapper.js

@@ -1,5 +1,7 @@
 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 { createAnnotations } from '../first-party/annotations/factory.js';
+import { EXTENSION_ID as EXTENSION_ID_ANNOTATIONS } from '../first-party/annotations/types/main.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';
@@ -25,7 +27,8 @@ export const builtInExtensionFactoryMap = {
     [EXTENSION_ID_LEGAL_MOVES]: createLegalMoves,
     [EXTENSION_ID_BOARD_EVENTS]: createBoardEvents,
     [EXTENSION_ID_AUTO_PROMOTE]: createAutoPromote,
-    [EXTENSION_ID_PROMOTION]: createPromotion
+    [EXTENSION_ID_PROMOTION]: createPromotion,
+    [EXTENSION_ID_ANNOTATIONS]: createAnnotations
 };
 export const DefaultBuiltinChessboardExtensions = [
     EXTENSION_ID_RENDERER,
@@ -36,5 +39,6 @@ export const DefaultBuiltinChessboardExtensions = [
     EXTENSION_ID_LEGAL_MOVES,
     EXTENSION_ID_BOARD_EVENTS,
     EXTENSION_ID_AUTO_PROMOTE,
-    EXTENSION_ID_PROMOTION
+    EXTENSION_ID_PROMOTION,
+    EXTENSION_ID_ANNOTATIONS
 ];

package/dist/extensions/update.js

@@ -1,21 +1,17 @@
-import { isUpdateContextCommonMounted } from './types/context/update.js';
 export function extensionSystemUpdateState(state, request) {
     // Prepare base context
-    const contextCommon = {
+    const contextCommonPart = {
         previousFrame: state.currentFrame,
         mutation: request.mutation,
         currentFrame: request.state
     };
     // Update invalidation state based on the new request
     for (const extension of state.extensions.values()) {
-        const context = isUpdateContextCommonMounted(contextCommon)
-            ? {
-                ...contextCommon,
-                invalidation: extension.invalidation
-            }
-            : {
-                ...contextCommon
-            };
+        const contextCommon = {
+            ...contextCommonPart,
+            invalidation: extension.invalidation
+        };
+        const context = contextCommon;
         extension.instance.onUpdate?.(context);
     }
     state.currentFrame = request.state;

package/dist/index.d.ts

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

package/dist/render/mount.js

@@ -1,5 +1,5 @@
 import { validateIsMounted, validateIsNotMounted } from './rendering/helpers.js';
-import { clearElementChildren } from './svg/helpers.js';
+import { clearSvgElementChildren } from './svg/helpers.js';
 export function renderMount(state, element) {
     validateIsNotMounted(state);
     state.container = element;
@@ -16,8 +16,8 @@ export function renderUnmount(state) {
     for (const extensionRec of state.extensions.values()) {
         extensionRec.extension.instance.unmount?.();
         // clear the slot roots
-        for (const slotRoot of Object.values(extensionRec.render.slots)) {
-            clearElementChildren(slotRoot);
+        for (const [, slotRoot] of Object.entries(extensionRec.render.slots)) {
+            clearSvgElementChildren(slotRoot);
         }
     }
     // remove our svg root from the container

package/dist/render/rendering/state.js

@@ -1,5 +1,5 @@
 import { sceneSizesEqual } from '../../layout/geometry/helpers.js';
-import { updateElementAttributes } from '../svg/helpers.js';
+import { updateSvgElementAttributes } from '../svg/helpers.js';
 import { validateIsMounted } from './helpers.js';
 export function checkNeedsRender(state) {
     for (const extensionRec of state.extensions.values()) {
@@ -20,7 +20,7 @@ export function performRenderPass(state, request) {
     const currentSize = request.layout.geometry.sceneSize;
     const prevSize = state.currentFrame?.layout.geometry?.sceneSize ?? null;
     if (!sceneSizesEqual(currentSize, prevSize)) {
-        updateElementAttributes(state.svgRoots.svgRoot, {
+        updateSvgElementAttributes(state.svgRoots.svgRoot, {
             width: currentSize.width.toString(),
             height: currentSize.height.toString(),
             viewBox: `0 0 ${currentSize.width} ${currentSize.height}`