@dxos/plugin-chess 0.10.0 → 0.11.1

package/dx.config.ts

@@ -17,7 +17,7 @@ export default Config2.make({
     source: 'https://github.com/dxos/dxos/tree/main/packages/plugins/plugin-chess',
     icon: { key: 'ph--shield-chevron--regular', hue: 'amber' },
     spec: 'PLUGIN.mdl',
-    tags: ['game'],
+    tags: ['alpha', 'game'],
     screenshots: [{ dark: 'https://dxos.network/plugin-details-chess-dark.png' }],
     dependsOn: ['org.dxos.plugin.game'],
   },

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@dxos/plugin-chess",
-  "version": "0.10.0",
+  "version": "0.11.1",
   "description": "Chess for new plugin",
   "homepage": "https://dxos.org",
   "bugs": "https://github.com/dxos/dxos/issues",
@@ -16,32 +16,36 @@
     "#skills": {
       "source": "./src/skills/index.ts",
       "types": "./dist/types/src/skills/index.d.ts",
-      "default": "./dist/lib/neutral/skills/index.mjs"
+      "default": "./dist/lib/skills.mjs"
     },
     "#capabilities": {
-      "source": "./src/capabilities/index.ts",
+      "source": {
+        "node": "./src/capabilities/node.ts",
+        "default": "./src/capabilities/index.ts"
+      },
       "types": "./dist/types/src/capabilities/index.d.ts",
-      "default": "./dist/lib/neutral/capabilities/index.mjs"
+      "node": "./dist/lib/capabilities/node.mjs",
+      "default": "./dist/lib/capabilities.mjs"
     },
     "#components": {
       "source": "./src/components/index.ts",
       "types": "./dist/types/src/components/index.d.ts",
-      "default": "./dist/lib/neutral/components/index.mjs"
+      "default": "./dist/lib/components.mjs"
     },
     "#containers": {
       "source": "./src/containers/index.ts",
       "types": "./dist/types/src/containers/index.d.ts",
-      "default": "./dist/lib/neutral/containers/index.mjs"
+      "default": "./dist/lib/containers.mjs"
     },
     "#meta": {
       "source": "./src/meta.ts",
       "types": "./dist/types/src/meta.d.ts",
-      "default": "./dist/lib/neutral/meta.mjs"
+      "default": "./dist/lib/meta.mjs"
     },
     "#operations": {
       "source": "./src/operations/index.ts",
       "types": "./dist/types/src/operations/index.d.ts",
-      "default": "./dist/lib/neutral/operations/index.mjs"
+      "default": "./dist/lib/operations.mjs"
     },
     "#plugin": {
       "source": {
@@ -50,52 +54,52 @@
         "default": "./src/ChessPlugin.tsx"
       },
       "types": "./dist/types/src/ChessPlugin.d.ts",
-      "workerd": "./dist/lib/neutral/ChessPlugin.workerd.mjs",
-      "node": "./dist/lib/neutral/ChessPlugin.node.mjs",
-      "default": "./dist/lib/neutral/ChessPlugin.mjs"
+      "workerd": "./dist/lib/ChessPlugin.workerd.mjs",
+      "node": "./dist/lib/ChessPlugin.node.mjs",
+      "default": "./dist/lib/ChessPlugin.mjs"
     },
     "#translations": {
       "source": "./src/translations.ts",
       "types": "./dist/types/src/translations.d.ts",
-      "default": "./dist/lib/neutral/translations.mjs"
+      "default": "./dist/lib/translations.mjs"
     },
     "#types": {
       "source": "./src/types/index.ts",
       "types": "./dist/types/src/types/index.d.ts",
-      "default": "./dist/lib/neutral/types/index.mjs"
+      "default": "./dist/lib/types.mjs"
     }
   },
   "exports": {
     ".": {
       "source": "./src/index.ts",
       "types": "./dist/types/src/index.d.ts",
-      "default": "./dist/lib/neutral/index.mjs"
+      "import": "./dist/lib/index.mjs"
     },
     "./assets/PLUGIN.mdl": "./PLUGIN.mdl",
     "./skills": {
       "source": "./src/skills/index.ts",
       "types": "./dist/types/src/skills/index.d.ts",
-      "default": "./dist/lib/neutral/skills/index.mjs"
+      "import": "./dist/lib/skills.mjs"
     },
     "./plugin": {
       "source": "./src/plugin.ts",
       "types": "./dist/types/src/plugin.d.ts",
-      "default": "./dist/lib/neutral/plugin.mjs"
+      "import": "./dist/lib/plugin.mjs"
     },
     "./testing": {
       "source": "./src/testing.ts",
       "types": "./dist/types/src/testing.d.ts",
-      "default": "./dist/lib/neutral/testing.mjs"
+      "import": "./dist/lib/testing.mjs"
     },
     "./translations": {
       "source": "./src/translations.ts",
       "types": "./dist/types/src/translations.d.ts",
-      "default": "./dist/lib/neutral/translations.mjs"
+      "import": "./dist/lib/translations.mjs"
     },
     "./types": {
       "source": "./src/types/index.ts",
       "types": "./dist/types/src/types/index.d.ts",
-      "default": "./dist/lib/neutral/types/index.mjs"
+      "import": "./dist/lib/types.mjs"
     }
   },
   "types": "dist/types/src/index.d.ts",
@@ -106,43 +110,46 @@
     "PLUGIN.mdl"
   ],
   "dependencies": {
+    "@effect-atom/atom": "^0.5.3",
     "@effect-atom/atom-react": "^0.5.0",
     "chess.js": "^1.0.0",
     "effect": "3.21.4",
-    "@dxos/app-framework": "0.10.0",
-    "@dxos/app-toolkit": "0.10.0",
-    "@dxos/async": "0.10.0",
-    "@dxos/compute": "0.10.0",
-    "@dxos/echo": "0.10.0",
-    "@dxos/invariant": "0.10.0",
-    "@dxos/echo-react": "0.10.0",
-    "@dxos/log": "0.10.0",
-    "@dxos/keys": "0.10.0",
-    "@dxos/plugin-client": "0.10.0",
-    "@dxos/plugin-game": "0.10.0",
-    "@dxos/react-client": "0.10.0",
-    "@dxos/react-ui-audio": "0.10.0",
-    "@dxos/react-ui-gameboard": "0.10.0",
-    "@dxos/util": "0.10.0",
-    "@dxos/react-ui-mosaic": "0.10.0"
+    "@dxos/app-framework": "0.11.1",
+    "@dxos/app-toolkit": "0.11.1",
+    "@dxos/async": "0.11.1",
+    "@dxos/compute": "0.11.1",
+    "@dxos/echo": "0.11.1",
+    "@dxos/echo-react": "0.11.1",
+    "@dxos/invariant": "0.11.1",
+    "@dxos/keys": "0.11.1",
+    "@dxos/log": "0.11.1",
+    "@dxos/plugin-client": "0.11.1",
+    "@dxos/plugin-game": "0.11.1",
+    "@dxos/react-client": "0.11.1",
+    "@dxos/react-ui-audio": "0.11.1",
+    "@dxos/react-ui-gameboard": "0.11.1",
+    "@dxos/react-ui-mosaic": "0.11.1",
+    "@dxos/util": "0.11.1"
   },
   "devDependencies": {
     "@types/react": "~19.2.17",
     "@types/react-dom": "~19.2.3",
     "react": "~19.2.7",
     "react-dom": "~19.2.7",
-    "vite": "^8.0.16",
-    "@dxos/plugin-testing": "0.10.0",
-    "@dxos/react-ui": "0.10.0",
-    "@dxos/storybook-utils": "0.10.0",
-    "@dxos/ui-theme": "0.10.0",
-    "@dxos/plugin-theme": "0.10.0"
+    "vite": "^8.1.4",
+    "@dxos/agent-runtime": "0.11.1",
+    "@dxos/effect": "0.11.1",
+    "@dxos/plugin-testing": "0.11.1",
+    "@dxos/plugin-theme": "0.11.1",
+    "@dxos/react-ui": "0.11.1",
+    "@dxos/storybook-utils": "0.11.1",
+    "@dxos/ui-theme": "0.11.1"
   },
   "peerDependencies": {
     "react": "~19.2.7",
     "react-dom": "~19.2.7",
-    "@dxos/react-ui": "0.10.0",
-    "@dxos/ui-theme": "0.10.0"
+    "@dxos/react-ui": "^0.11.1",
+    "@dxos/ui-theme": "^0.11.1"
   },
   "publishConfig": {
     "access": "public"

package/src/ChessPlugin.node.ts

@@ -7,14 +7,14 @@ import { AppPlugin } from '@dxos/app-toolkit';
 
 import { OperationHandler, SkillDefinition } from '#capabilities';
 import { meta } from '#meta';
-import { Chess } from '#types';
+import { Chess, ChessPositionIndex, PlayerReview } from '#types';
 
 /**
  * Headless variant of ChessPlugin (no React surfaces / GameVariant).
  * Used in node contexts (CLI, agents) where rendering is unavailable.
  */
 export const ChessPlugin = Plugin.define(meta).pipe(
-  AppPlugin.addSchemaModule({ schema: [Chess.State] }),
+  AppPlugin.addSchemaModule({ schema: [Chess.State, ChessPositionIndex.PositionIndex, PlayerReview.Review] }),
   AppPlugin.addSkillDefinitionModule({ activate: SkillDefinition }),
   AppPlugin.addOperationHandlerModule({ activate: OperationHandler }),
   Plugin.make,

package/src/ChessPlugin.tsx

@@ -8,7 +8,7 @@ import { AppActivationEvents, AppPlugin } from '@dxos/app-toolkit';
 import { GameVariant, OperationHandler, SkillDefinition } from '#capabilities';
 import { meta } from '#meta';
 import { translations } from '#translations';
-import { Chess } from '#types';
+import { Chess, ChessPositionIndex, PlayerReview } from '#types';
 
 // eslint-disable-next-line import/no-relative-packages
 import pluginSpec from '../PLUGIN.mdl?raw';
@@ -24,7 +24,7 @@ export const ChessPlugin = Plugin.define(meta).pipe(
   AppPlugin.addPluginAssetModule({
     asset: { pluginId: meta.profile.key, path: 'PLUGIN.mdl', content: pluginSpec, mimeType: 'application/x-mdl' },
   }),
-  AppPlugin.addSchemaModule({ schema: [Chess.State] }),
+  AppPlugin.addSchemaModule({ schema: [Chess.State, ChessPositionIndex.PositionIndex, PlayerReview.Review] }),
   AppPlugin.addTranslationsModule({ translations }),
   Plugin.make,
 );

package/src/ChessPlugin.workerd.ts

@@ -7,11 +7,11 @@ import { AppPlugin } from '@dxos/app-toolkit';
 
 import { OperationHandler } from '#capabilities';
 import { meta } from '#meta';
-import { Chess } from '#types';
+import { Chess, ChessPositionIndex, PlayerReview } from '#types';
 
 export const ChessPlugin = Plugin.define(meta).pipe(
   AppPlugin.addOperationHandlerModule({ activate: OperationHandler }),
-  AppPlugin.addSchemaModule({ schema: [Chess.State] }),
+  AppPlugin.addSchemaModule({ schema: [Chess.State, ChessPositionIndex.PositionIndex, PlayerReview.Review] }),
   Plugin.make,
 );
 

package/src/capabilities/node.ts

@@ -0,0 +1,16 @@
+//
+// Copyright 2026 DXOS.org
+//
+
+import { Capability } from '@dxos/app-framework';
+import type { OperationHandlerSet } from '@dxos/compute';
+
+// The capabilities `ChessPlugin.node` activates, and only those. `Capability.lazy` defers the
+// import at runtime but a bundler still walks it, so listing the React surfaces here would pull
+// the plugin's components into every node and bun build.
+
+export const SkillDefinition = Capability.lazy('SkillDefinition', () => import('./skill-definition'));
+export const OperationHandler = Capability.lazy<OperationHandlerSet.OperationHandlerSet>(
+  'OperationHandler',
+  () => import('./operation-handler'),
+);

package/src/components/Chessboard/Info.tsx

@@ -30,7 +30,7 @@ export const Info = ({ classNames, orientation = 'white', onOrientationChange, o
   return (
     <div
       className={mx(
-        'grid grid-rows-[min-content_1fr_min-content] w-full min-w-[18rem] p-2 overflow-hidden bg-group-surface rounded-xs',
+        'grid grid-rows-[min-content_1fr_min-content] w-full min-w-[18rem] p-2 overflow-hidden dx-group-surface rounded-xs',
         classNames,
       )}
     >
@@ -180,7 +180,7 @@ type PlayerIndicatorProps = PropsWithChildren<{
 const PlayerIndicator = ({ children, model, player, icon }: PlayerIndicatorProps) => {
   const turn = player === (model.game.turn() === 'w' ? 'white' : 'black');
   return (
-    <div className='grid grid-cols-[2rem_1fr_2rem] gap-2 h-(--dx-rail-size) px-1 flex items-center overflow-hidden'>
+    <div className='grid grid-cols-[var(--dx-rail-item)_1fr_var(--dx-rail-item)] gap-2 h-(--dx-rail-size) px-1 flex items-center overflow-hidden'>
       <div className='place-items-center'>
         <Icon
           icon={turn ? 'ph--circle--fill' : 'ph--circle--thin'}

package/src/components/Chessboard/types.ts

@@ -2,7 +2,7 @@
 // Copyright 2024 DXOS.org
 //
 
-import { type Registry } from '@effect-atom/atom-react';
+import { type Registry } from '@effect-atom/atom';
 
 import { ChessModel } from '@dxos/react-ui-gameboard';
 

package/src/containers/ChessArticle/ChessArticle.stories.tsx

@@ -6,7 +6,7 @@ import { type Meta, type StoryObj } from '@storybook/react-vite';
 import React, { useMemo } from 'react';
 
 import { type Obj } from '@dxos/echo';
-import { make as makeGame } from '@dxos/plugin-game';
+import { Game } from '@dxos/plugin-game';
 import { withClientProvider } from '@dxos/react-client/testing';
 import { withLayout, withTheme } from '@dxos/react-ui/testing';
 
@@ -22,7 +22,7 @@ type StoryArgs = {
 const DefaultStory = ({ pgn }: StoryArgs) => {
   const { game, state } = useMemo(() => {
     const state = Chess.make(pgn ? { pgn } : undefined);
-    const game = makeGame({ name: 'Story game', variant: state as Obj.Unknown });
+    const game = Game.make({ name: 'Story game', variant: state as Obj.Unknown });
     return { game, state };
   }, [pgn]);
   return <ChessArticle role='article' attendableId='story' game={game} variant={state} />;

package/src/containers/ChessArticle/ChessArticle.tsx

@@ -7,6 +7,7 @@ import React, { useCallback, useRef, useState } from 'react';
 
 import { AppSurface } from '@dxos/app-toolkit/ui';
 import { Obj } from '@dxos/echo';
+import { useObject } from '@dxos/echo-react';
 import { type GameVariantSurfaceProps } from '@dxos/plugin-game/types';
 import { Panel, Toolbar, useTranslation } from '@dxos/react-ui';
 import { type Player } from '@dxos/react-ui-gameboard';
@@ -28,16 +29,20 @@ export const ChessArticle = ({ role, variant }: ChessArticleProps) => {
     controller.current?.setMoveNumber(index);
   }, []);
 
+  const state = Obj.instanceOf(Chess.State, variant) ? variant : undefined;
+  const [pgn] = useObject(state, 'pgn');
+  const [fen] = useObject(state, 'fen');
+
   const isGameOver = (() => {
-    if (!Obj.instanceOf(Chess.State, variant) || (!variant.pgn && !variant.fen)) {
+    if (!pgn && !fen) {
       return false;
     }
     try {
       const chess = new ChessJS();
-      if (variant.pgn) {
-        chess.loadPgn(variant.pgn);
-      } else if (variant.fen) {
-        chess.load(variant.fen);
+      if (pgn) {
+        chess.loadPgn(pgn);
+      } else if (fen) {
+        chess.load(fen);
       }
       return chess.isGameOver();
     } catch {
@@ -46,22 +51,21 @@ export const ChessArticle = ({ role, variant }: ChessArticleProps) => {
   })();
 
   const handleNewGame = useCallback(() => {
-    if (!Obj.instanceOf(Chess.State, variant)) {
+    if (!state) {
       return;
     }
-    Obj.update(variant, (variant) => {
-      const mutable = variant as Obj.Mutable<typeof variant>;
-      mutable.pgn = undefined;
-      mutable.fen = undefined;
+    Obj.update(state, (state) => {
+      state.pgn = undefined;
+      state.fen = undefined;
     });
-  }, [variant]);
+  }, [state]);
 
-  if (!Obj.instanceOf(Chess.State, variant)) {
+  if (!state) {
     return null;
   }
 
   return (
-    <Chessboard.Root state={variant} ref={controller}>
+    <Chessboard.Root state={state} ref={controller}>
       <Panel.Root role={role} classNames='@container'>
         <Panel.Toolbar asChild>
           <Toolbar.Root>
@@ -107,3 +111,5 @@ export const ChessArticle = ({ role, variant }: ChessArticleProps) => {
     </Chessboard.Root>
   );
 };
+
+ChessArticle.displayName = 'ChessArticle';

package/src/containers/ChessCard/ChessCard.stories.tsx

@@ -5,7 +5,7 @@
 import { type Meta, type StoryObj } from '@storybook/react-vite';
 import React, { useMemo } from 'react';
 
-import { make as makeGame } from '@dxos/plugin-game';
+import { Game } from '@dxos/plugin-game';
 import { CardContainer } from '@dxos/react-ui-mosaic/testing';
 import { withLayout, withTheme } from '@dxos/react-ui/testing';
 
@@ -20,7 +20,7 @@ const SAMPLE_PGN =
 const CardStory = () => {
   const { game, state } = useMemo(() => {
     const state = Chess.make({ pgn: SAMPLE_PGN });
-    const game = makeGame({ name: 'Story game', variant: state });
+    const game = Game.make({ name: 'Story game', variant: state });
     return { game, state };
   }, []);
   return (

package/src/containers/ChessCard/ChessCard.tsx

@@ -32,3 +32,5 @@ export const ChessCard = ({ variant }: ChessCardProps) => {
     </Card.Body>
   );
 };
+
+ChessCard.displayName = 'ChessCard';

package/src/internal/position-index.ts

@@ -0,0 +1,148 @@
+//
+// Copyright 2026 DXOS.org
+//
+
+import { Chess as ChessJS } from 'chess.js';
+
+import { Obj, Ref } from '@dxos/echo';
+import { type Game } from '@dxos/plugin-game/types';
+
+import * as ChessPositionIndex from '../types/ChessPositionIndex';
+import * as PlayerReview from '../types/PlayerReview';
+
+/** Normalizes a FEN to the position key (board, side, castling, en passant). */
+export const normalizeFen = (fen: string): string => fen.split(' ').slice(0, 4).join(' ');
+
+const sideToTurn = (side: ChessPositionIndex.Side): 'w' | 'b' => (side === 'white' ? 'w' : 'b');
+
+/** Maximum full moves per game indexed (opening window). */
+export const OPENING_FULL_MOVE_LIMIT = 10;
+
+/** Half-move cap for the opening window. */
+export const OPENING_PLY_LIMIT = OPENING_FULL_MOVE_LIMIT * 2;
+
+/**
+ * Positions where `side` is to move, derived from chess state PGN/FEN.
+ * Only positions within the first {@link OPENING_FULL_MOVE_LIMIT} full moves are indexed.
+ */
+export const positionsForSide = ({
+  pgn,
+  fen,
+  side,
+}: {
+  pgn?: string;
+  fen?: string;
+  side: ChessPositionIndex.Side;
+}): string[] => {
+  const probe = new ChessJS();
+  const chess = new ChessJS();
+  try {
+    if (pgn) {
+      probe.loadPgn(pgn);
+    } else if (fen) {
+      // A FEN-only game has no move history to replay, so index from the supplied position itself.
+      probe.load(fen);
+      chess.load(fen);
+    }
+  } catch {
+    // chess.js throws on malformed PGN/FEN; a single bad record must not abort the rebuild.
+    return [];
+  }
+
+  const moves = probe.history().slice(0, OPENING_PLY_LIMIT);
+  const turn = sideToTurn(side);
+  const fens: string[] = [];
+
+  if (chess.turn() === turn) {
+    fens.push(normalizeFen(chess.fen()));
+  }
+
+  for (const move of moves) {
+    chess.move(move);
+    if (chess.turn() === turn) {
+      fens.push(normalizeFen(chess.fen()));
+    }
+  }
+
+  return fens;
+};
+
+/** Resolves which side the reviewed player played in a game, if any. */
+export const playerSideInGame = (review: PlayerReview.Review, game: Game.Game): ChessPositionIndex.Side | undefined => {
+  for (const player of game.players ?? []) {
+    if (review.playerIdentity && player.identity === review.playerIdentity) {
+      return player.role === 'black' ? 'black' : 'white';
+    }
+    if (review.playerName && player.name?.trim().toLowerCase() === review.playerName.trim().toLowerCase()) {
+      return player.role === 'black' ? 'black' : 'white';
+    }
+  }
+  return undefined;
+};
+
+export type BuiltSideIndex = Record<string, Game.Game[]>;
+
+export type BuiltIndex = Record<ChessPositionIndex.Side, BuiltSideIndex>;
+
+/** Builds a fresh side→fen→games index from processed games. */
+export const buildIndex = (
+  entries: ReadonlyArray<{ game: Game.Game; side: ChessPositionIndex.Side; fens: readonly string[] }>,
+): BuiltIndex => {
+  const index: BuiltIndex = { white: {}, black: {} };
+  for (const { game, side, fens } of entries) {
+    for (const fen of fens) {
+      const bucket = index[side][fen] ?? [];
+      if (!bucket.some((existing) => existing.id === game.id)) {
+        bucket.push(game);
+      }
+      index[side][fen] = bucket;
+    }
+  }
+  return index;
+};
+
+const gameIdsKey = (games: ReadonlyArray<{ id: string }>): string =>
+  games
+    .map((game) => game.id)
+    .toSorted()
+    .join('\0');
+
+const refsGameIdsKey = (games: ReadonlyArray<Ref.Ref<Game.Game>>): string =>
+  games
+    .map((gameRef) => gameRef.target?.id ?? gameRef.uri)
+    .toSorted()
+    .join('\0');
+
+/**
+ * Applies a rebuilt index onto an existing {@link ChessPositionIndex.PositionIndex},
+ * mutating only FEN leaves whose game sets changed and removing stale FEN keys.
+ */
+export const applyIndexDiff = (positionIndex: ChessPositionIndex.PositionIndex, next: BuiltIndex): number => {
+  let updatedLeaves = 0;
+
+  Obj.update(positionIndex, (positionIndex) => {
+    for (const side of ['white', 'black'] as const) {
+      const sideIndex = positionIndex.index[side];
+      const nextSide = next[side];
+
+      for (const fen of Object.keys(sideIndex)) {
+        if (!nextSide[fen]) {
+          delete sideIndex[fen];
+          updatedLeaves++;
+        }
+      }
+
+      for (const [fen, games] of Object.entries(nextSide)) {
+        const existing = sideIndex[fen];
+        if (existing && refsGameIdsKey(existing.games) === gameIdsKey(games)) {
+          continue;
+        }
+
+        sideIndex[fen] = { games: games.map((game) => Ref.make(game)) };
+        updatedLeaves++;
+      }
+    }
+  });
+
+  return updatedLeaves;
+};

package/src/operations/index.ts

@@ -8,4 +8,5 @@ export const ChessOperationHandlerSet = OperationHandlerSet.lazy(
   () => import('./move'),
   () => import('./play'),
   () => import('./print'),
+  () => import('./rebuild-position-index'),
 );

package/src/operations/move.ts

@@ -25,8 +25,7 @@ const handler: Operation.WithHandler<typeof ChessOperation.Move> = ChessOperatio
       chess.move(move, { strict: false });
       const pgn = chess.pgn();
       Obj.update(variant, (variant) => {
-        const mutable = variant as Obj.Mutable<typeof variant>;
-        mutable.pgn = pgn;
+        variant.pgn = pgn;
       });
       return { pgn };
     }),

package/src/operations/play.ts

@@ -34,8 +34,7 @@ const handler: Operation.WithHandler<typeof ChessOperation.Play> = ChessOperatio
       chess.move(move, { strict: false });
       const pgn = chess.pgn();
       Obj.update(variant, (variant) => {
-        const mutable = variant as Obj.Mutable<typeof variant>;
-        mutable.pgn = pgn;
+        variant.pgn = pgn;
       });
       return { move, pgn };
     }),