@mirasen/chessboard 0.1.0

package/dist/wrapper/factory.js

@@ -0,0 +1,61 @@
+import { createActiveTarget } from '../extensions/first-party/active-target/factory';
+import { createBoardEvents } from '../extensions/first-party/board-events/factory';
+import { createLastMove } from '../extensions/first-party/last-move/factory';
+import { createLegalMoves } from '../extensions/first-party/legal-moves/factory';
+import { createMainRenderer } from '../extensions/first-party/main-renderer/factory';
+import { createSelectedSquare } from '../extensions/first-party/selected-square/factory';
+import { DefaultBuiltinChessboardExtensions } from '../extensions/types/wrapper';
+import { createRuntime } from '../runtime/factory/main';
+function createBuiltInExtensionDefinition(id) {
+    switch (id) {
+        case 'mainRenderer':
+            return createMainRenderer();
+        case 'events':
+            return createBoardEvents();
+        case 'selectedSquare':
+            return createSelectedSquare();
+        case 'activeTarget':
+            return createActiveTarget();
+        case 'legalMoves':
+            return createLegalMoves();
+        case 'lastMove':
+            return createLastMove();
+        default:
+            throw new Error(`Unknown built-in extension id: ${id}`);
+    }
+}
+export function createBoard(options) {
+    // prepare init options for runtime
+    const extensionsInput = options.extensions ?? DefaultBuiltinChessboardExtensions;
+    const extensions = extensionsInput.map((ext) => {
+        if (typeof ext === 'string') {
+            // built-in extension, convert to definition
+            return createBuiltInExtensionDefinition(ext);
+        }
+        // assume it's already a definition
+        return ext;
+    });
+    const doc = 'document' in options && options.document ? options.document : options.element.ownerDocument;
+    const runtime = createRuntime({
+        doc,
+        state: options.state,
+        extensions
+    });
+    if ('element' in options && options.element) {
+        runtime.mount(options.element);
+    }
+    return {
+        mount: runtime.mount,
+        unmount: runtime.unmount,
+        destroy: runtime.destroy,
+        setPosition: runtime.setPosition,
+        setPiecePosition: runtime.setPiecePosition,
+        setTurn: runtime.setTurn,
+        move: runtime.move,
+        setOrientation: runtime.setOrientation,
+        setMovability: runtime.setMovability,
+        select: runtime.select,
+        getSnapshot: runtime.getSnapshot,
+        extensions: runtime.getExtensionsPublicRecord()
+    };
+}

package/dist/wrapper/types.d.ts

@@ -0,0 +1,56 @@
+import type { AnyExtensionDefinition, ExtensionDefinitionId, ExtensionDefinitionPublicApi } from '../extensions/types/extension';
+import { BuiltInExtensionDefinitionMap, BuiltInExtensionId, DefaultBuiltinChessboardExtensions } from '../extensions/types/wrapper';
+import { Runtime } from '../runtime/types/main';
+import { RuntimeStateInitOptions } from '../state/types';
+/**
+ * What createBoard accepts in options.extensions
+ */
+export type ChessboardExtensionInput = BuiltInExtensionId | AnyExtensionDefinition;
+/**
+ * Resolve one public input item into a concrete extension definition type
+ */
+export type ResolveChessboardExtensionInput<T> = T extends keyof BuiltInExtensionDefinitionMap ? BuiltInExtensionDefinitionMap[T] : T extends AnyExtensionDefinition ? T : never;
+/**
+ * Resolve an input tuple into a tuple of concrete extension definitions
+ */
+export type ResolveChessboardExtensionsTuple<TExtensions extends readonly ChessboardExtensionInput[]> = {
+    [K in keyof TExtensions]: ResolveChessboardExtensionInput<TExtensions[K]>;
+};
+/**
+ * Extract only extensions that actually expose public API
+ */
+type ExtensionDefinitionHasPublicApi<T> = [ExtensionDefinitionPublicApi<T>] extends [never] ? false : true;
+/**
+ * Public map for already-resolved extension definitions
+ */
+type ExtensionsPublicMap<TExtensions extends readonly AnyExtensionDefinition[]> = {
+    [TDef in TExtensions[number] as ExtensionDefinitionHasPublicApi<TDef> extends true ? ExtensionDefinitionId<TDef> : never]: ExtensionDefinitionPublicApi<TDef>;
+};
+/**
+ * Public map for createBoard input extensions
+ */
+export type ChessboardExtensionsPublicMap<TExtensions extends readonly ChessboardExtensionInput[]> = ExtensionsPublicMap<Extract<ResolveChessboardExtensionsTuple<TExtensions>, readonly AnyExtensionDefinition[]>>;
+/**
+ * Public createBoard options
+ */
+interface ChessboardInitOptionsDocument {
+    readonly document: Document;
+    readonly element?: never;
+}
+interface ChessboardInitOptionsElement {
+    readonly element: HTMLElement;
+    readonly document?: never;
+}
+type ChessboardInitTarget = ChessboardInitOptionsDocument | ChessboardInitOptionsElement;
+export type ChessboardInitOptions<TExtensions extends readonly ChessboardExtensionInput[] = DefaultBuiltinChessboardExtensions> = ChessboardInitTarget & {
+    readonly state?: RuntimeStateInitOptions;
+    readonly extensions?: TExtensions;
+};
+/**
+ * Public board interface returned by createBoard(...)
+ */
+export type ChessboardRuntimeSurface = Pick<Runtime, 'mount' | 'unmount' | 'destroy' | 'move' | 'setPosition' | 'setPiecePosition' | 'setTurn' | 'setOrientation' | 'setMovability' | 'select' | 'getSnapshot'>;
+export interface Chessboard<TExtensions extends readonly ChessboardExtensionInput[] = DefaultBuiltinChessboardExtensions> extends ChessboardRuntimeSurface {
+    readonly extensions: ChessboardExtensionsPublicMap<TExtensions>;
+}
+export {};

package/dist/wrapper/types.js

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

package/package.json

@@ -0,0 +1,98 @@
+{
+	"name": "@mirasen/chessboard",
+	"description": "Mirasen Chessboard — open-source chessboard UI library.",
+	"version": "0.1.0",
+	"license": "MIT",
+	"author": {
+		"name": "Mirasen",
+		"email": "konstantin@mirasen.io"
+	},
+	"keywords": [
+		"mirasen",
+		"chessboard",
+		"chess-ui",
+		"chess",
+		"svg",
+		"typescript"
+	],
+	"homepage": "https://mirasen.io/chessboard",
+	"repository": {
+		"type": "git",
+		"url": "git+https://github.com/mirasen-io/chessboard.git"
+	},
+	"bugs": {
+		"url": "https://github.com/mirasen-io/chessboard/issues"
+	},
+	"type": "module",
+	"types": "./dist/index.d.ts",
+	"exports": {
+		".": {
+			"types": "./dist/index.d.ts",
+			"import": "./dist/index.js"
+		},
+		"./extensions": {
+			"types": "./dist/extensions/index.d.ts",
+			"import": "./dist/extensions/index.js"
+		},
+		"./unstable/*.js": {
+			"types": "./dist/*.d.ts",
+			"import": "./dist/*.js"
+		}
+	},
+	"scripts": {
+		"build": "rimraf ./dist && tsc --project tsconfig.json && npm run prepack",
+		"build:release": "rimraf ./dist && tsc --project tsconfig-release.json && npm run prepack",
+		"prepare": "bash ./scripts/npm-link.sh",
+		"prepack": "publint",
+		"format": "prettier --write .",
+		"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",
+		"changeset:version": "changeset version && npm install && git add --all",
+		"changeset:publish": "changeset publish"
+	},
+	"files": [
+		"dist",
+		"assets",
+		"README.md",
+		"CHANGELOG.md",
+		"LICENSE",
+		"!dist/**/*.test.*",
+		"!dist/**/*.spec.*",
+		"!tests",
+		"!examples",
+		"!benchmarks"
+	],
+	"devDependencies": {
+		"@changesets/cli": "^2.28.1",
+		"@eslint/compat": "^2.0.2",
+		"@eslint/js": "^10.0.1",
+		"@types/node": "^25.5.0",
+		"@vitest/coverage-istanbul": "^4.1.0",
+		"eslint": "^10.0.2",
+		"eslint-config-prettier": "^10.1.2",
+		"globals": "^17.4.0",
+		"jsdom": "^29.0.0",
+		"prettier": "^3.5.3",
+		"publint": "^0.3.11",
+		"rimraf": "^6.0.1",
+		"serve": "^14.2.6",
+		"tsc-alias": "^1.8.15",
+		"typescript": "^5.8.2",
+		"typescript-eslint": "^8.57.0",
+		"vitest": "^4.0.18"
+	},
+	"engines": {
+		"node": ">=22"
+	},
+	"dependencies": {
+		"@echecs/fen": "^2.1.0",
+		"@ktarmyshov/assert": "^0.1.9",
+		"es-toolkit": "^1.45.1",
+		"type-fest": "^5.5.0"
+	}
+}