@dxos/plugin-chess 0.8.4-main.c4373fc → 0.8.4-main.c85a9c8dae

package/src/capabilities/react-surface/react-surface.tsx

@@ -0,0 +1,33 @@
+//
+// Copyright 2025 DXOS.org
+//
+
+import * as Effect from 'effect/Effect';
+import React from 'react';
+
+import { Capabilities, Capability } from '@dxos/app-framework';
+import { Surface } from '@dxos/app-framework/ui';
+import { Obj } from '@dxos/echo';
+
+import { ChessArticle, ChessCard } from '../../containers';
+import { meta } from '../../meta';
+import { Chess } from '../../types';
+
+export default Capability.makeModule(() =>
+  Effect.succeed(
+    Capability.contributes(Capabilities.ReactSurface, [
+      Surface.create({
+        id: meta.id,
+        role: ['article', 'section'],
+        filter: (data): data is { subject: Chess.Game } => Obj.instanceOf(Chess.Game, data.subject),
+        component: ({ data, role }) => <ChessArticle role={role} subject={data.subject} />,
+      }),
+      Surface.create({
+        id: meta.id,
+        role: ['card--content'],
+        filter: (data): data is { subject: Chess.Game } => Obj.instanceOf(Chess.Game, data.subject),
+        component: ({ data, role }) => <ChessCard role={role} subject={data.subject} />,
+      }),
+    ]),
+  ),
+);

package/src/cli/index.ts

@@ -0,0 +1,5 @@
+//
+// Copyright 2025 DXOS.org
+//
+
+export * from './plugin';

package/src/cli/plugin.ts

@@ -0,0 +1,27 @@
+//
+// Copyright 2025 DXOS.org
+//
+
+import * as Effect from 'effect/Effect';
+
+import { Plugin } from '@dxos/app-framework';
+import { AppPlugin } from '@dxos/app-toolkit';
+import { type CreateObject } from '@dxos/plugin-space/types';
+
+import { meta } from '../meta';
+import { Chess } from '../types';
+
+// TODO(wittjosiah): Factor out shared modules.
+export const ChessPlugin = Plugin.define(meta).pipe(
+  AppPlugin.addMetadataModule({
+    metadata: {
+      id: Chess.Game.typename,
+      metadata: {
+        createObject: ((props) => Effect.sync(() => Chess.make(props))) satisfies CreateObject,
+        addToCollectionOnCreate: true,
+      },
+    },
+  }),
+  AppPlugin.addSchemaModule({ schema: [Chess.Game] }),
+  Plugin.make,
+);

package/src/components/{Chessboard.tsx → Chessboard/Chessboard.tsx}

@@ -2,10 +2,12 @@
 // Copyright 2024 DXOS.org
 //
 
+import { RegistryContext } from '@effect-atom/atom-react';
 import React, {
   type PropsWithChildren,
   forwardRef,
   useCallback,
+  useContext,
   useEffect,
   useImperativeHandle,
   useMemo,
@@ -13,9 +15,10 @@ import React, {
 } from 'react';
 
 import { addEventListener } from '@dxos/async';
+import { useObject } from '@dxos/echo-react';
 import { type ThemedClassName } from '@dxos/react-ui';
 import {
-  ChessModel,
+  type ChessModel,
   Gameboard,
   type GameboardRootProps,
   Chessboard as NaturalChessboard,
@@ -24,22 +27,17 @@ import {
   useGameboardContext,
 } from '@dxos/react-ui-gameboard';
 import { useSoundEffect } from '@dxos/react-ui-sfx';
-import { mx } from '@dxos/react-ui-theme';
+import { mx } from '@dxos/ui-theme';
 
-import { type Chess } from '../types';
+import { type Chess } from '../../types';
 
 import { Info, type InfoProps } from './Info';
+import { ExtendedChessModel } from './types';
 
 export interface ChessboardController {
   setMoveNumber(index: number): void;
 }
 
-export class ExtendedChessModel extends ChessModel {
-  constructor(readonly object: Chess.Game) {
-    super();
-  }
-}
-
 //
 // Root
 //
@@ -49,8 +47,10 @@ type RootProps = PropsWithChildren<{
 }>;
 
 const Root = forwardRef<ChessboardController, RootProps>(({ game, children }, forwardedRef) => {
-  const model = useMemo(() => new ExtendedChessModel(game), []);
+  const registry = useContext(RegistryContext);
+  const model = useMemo(() => new ExtendedChessModel(registry, game), [registry]);
   const click = useSoundEffect('Click');
+  const [pgn, updatePgn] = useObject(game, 'pgn');
 
   // Controller.
   useImperativeHandle(forwardedRef, () => {
@@ -59,17 +59,21 @@ const Root = forwardRef<ChessboardController, RootProps>(({ game, children }, fo
     };
   }, [model]);
 
+  // TODO(wittjosiah): Rather than useEffect to sync ECHO object to model, create an alternative model implementation.
+  //   This model would take the ECHO object and derive game state directly from that.
+  //   Mutation methods would mutate the ECHO object and other state would be derived from that.
+
   // External change.
   // NOTE: Warning if user has not interacted with the board.
   useEffect(() => {
-    if (model.pgn !== getRawPgn(game.pgn ?? '')) {
+    if (model.pgn !== getRawPgn(pgn ?? '')) {
       const silent = model.pgn === '*';
-      model.update(game.pgn);
+      model.update(pgn);
       if (!silent) {
         void click.play();
       }
     }
-  }, [game.pgn]);
+  }, [pgn]);
 
   // Move.
   const handleDrop = useCallback<NonNullable<GameboardRootProps<ChessModel>['onDrop']>>(
@@ -79,7 +83,7 @@ const Root = forwardRef<ChessboardController, RootProps>(({ game, children }, fo
       }
 
       void click.play();
-      game.pgn = model.pgn;
+      updatePgn(() => model.pgn);
       return true;
     },
     [model],
@@ -96,16 +100,17 @@ const Root = forwardRef<ChessboardController, RootProps>(({ game, children }, fo
 // Content
 //
 
-type Role = 'card--popover' | 'card--intrinsic' | 'card--extrinsic';
+type Role = 'card--content';
 
 type ContentProps = ThemedClassName<PropsWithChildren<{ role?: Role }>>;
 
 const Content = ({ classNames, children, role }: ContentProps) => {
   return (
     <Gameboard.Content
-      classNames={mx(classNames, role === 'card--popover' && 'size-container popover-square')}
-      grow={!role || role === 'card--extrinsic'}
-      contain={!role || role === 'card--extrinsic' || role === 'card--popover'}
+      classNames={mx(
+        classNames,
+        role === 'card--content' ? 'dx-size-container dx-card-square' : 'flex flex-col justify-center',
+      )}
     >
       {children}
     </Gameboard.Content>
@@ -116,10 +121,13 @@ const Content = ({ classNames, children, role }: ContentProps) => {
 // Board
 //
 
+const BOARD_NAME = 'Chessboard.Board';
+
 type BoardProps = NaturalChessboardProps;
 
 const Board = (props: BoardProps) => {
-  const { model } = useGameboardContext<ChessModel>(Board.displayName);
+  const registry = useContext(RegistryContext);
+  const { model } = useGameboardContext<ChessModel>(BOARD_NAME);
 
   // Keyboard navigation.
   const ref = useRef<HTMLDivElement>(null);
@@ -132,6 +140,7 @@ const Board = (props: BoardProps) => {
     ref.current.setAttribute('data-arrow-keys', 'all');
 
     return addEventListener(ref.current, 'keydown', (ev) => {
+      const moveIndex = registry.get(model.moveIndex);
       switch (ev.key) {
         case 'ArrowUp':
           model.setMoveIndex(0);
@@ -140,23 +149,23 @@ const Board = (props: BoardProps) => {
           model.setMoveIndex(model.game.history().length);
           break;
         case 'ArrowLeft':
-          if (model.moveIndex.value > 0) {
-            model.setMoveIndex(model.moveIndex.value - 1);
+          if (moveIndex > 0) {
+            model.setMoveIndex(moveIndex - 1);
           }
           break;
         case 'ArrowRight':
-          if (model.moveIndex.value < model.game.history().length) {
-            model.setMoveIndex(model.moveIndex.value + 1);
+          if (moveIndex < model.game.history().length) {
+            model.setMoveIndex(moveIndex + 1);
           }
           break;
       }
     });
-  }, [model]);
+  }, [registry, model]);
 
-  return <NaturalChessboard ref={ref} {...props} />;
+  return <NaturalChessboard {...props} ref={ref} />;
 };
 
-Board.displayName = 'Chessboard.Board';
+Board.displayName = BOARD_NAME;
 
 //
 // Chessboard

package/src/components/{Info.tsx → Chessboard/Info.tsx}

@@ -2,17 +2,21 @@
 // Copyright 2023 DXOS.org
 //
 
+import { useAtomValue } from '@effect-atom/atom-react';
 import React, { type JSX, type PropsWithChildren, useEffect, useMemo, useRef } from 'react';
 
 import { generateName } from '@dxos/display-name';
-import { type SpaceMember, getSpace, useMembers } from '@dxos/react-client/echo';
+import { Obj } from '@dxos/echo';
+import { type SpaceMember, useMembers } from '@dxos/react-client/echo';
 import { Icon, IconButton, Select, type ThemedClassName, useTranslation } from '@dxos/react-ui';
 import { type Player, useGameboardContext } from '@dxos/react-ui-gameboard';
-import { mx } from '@dxos/react-ui-theme';
+import { mx } from '@dxos/ui-theme';
 
-import { meta } from '../meta';
+import { meta } from '../../meta';
 
-import { type ExtendedChessModel } from './Chessboard';
+import { type ExtendedChessModel } from './types';
+
+const INFO_NAME = 'Chessboard.Info';
 
 export type InfoProps = ThemedClassName<
   {
@@ -24,13 +28,14 @@ export type InfoProps = ThemedClassName<
 
 export const Info = ({ classNames, orientation = 'white', onOrientationChange, onClose, ...props }: InfoProps) => {
   const { t } = useTranslation(meta.id);
-  const { model } = useGameboardContext<ExtendedChessModel>(Info.displayName);
-  const members = useMembers(getSpace(model.object)?.key);
+  const { model } = useGameboardContext<ExtendedChessModel>(INFO_NAME);
+  const db = Obj.getDatabase(model.object);
+  const members = useMembers(db?.spaceId);
 
   return (
     <div
       className={mx(
-        'grid grid-rows-[min-content_1fr_min-content] is-full min-is-[18rem] p-2 overflow-hidden bg-groupSurface rounded-sm',
+        'grid grid-rows-[min-content_1fr_min-content] w-full min-w-[18rem] p-2 overflow-hidden bg-group-surface rounded-xs',
         classNames,
       )}
     >
@@ -46,7 +51,9 @@ export const Info = ({ classNames, orientation = 'white', onOrientationChange, o
         <PlayerSelector
           value={model.object.players?.[orientation === 'white' ? 'black' : 'white']}
           onValueChange={(value) => {
-            model.object.players![orientation === 'white' ? 'black' : 'white'] = value;
+            Obj.change(model.object, (obj) => {
+              obj.players![orientation === 'white' ? 'black' : 'white'] = value;
+            });
           }}
           members={members}
         />
@@ -73,7 +80,9 @@ export const Info = ({ classNames, orientation = 'white', onOrientationChange, o
         <PlayerSelector
           value={model.object.players?.[orientation]}
           onValueChange={(value) => {
-            model.object.players![orientation] = value;
+            Obj.change(model.object, (obj) => {
+              obj.players![orientation] = value;
+            });
           }}
           members={members}
         />
@@ -82,7 +91,7 @@ export const Info = ({ classNames, orientation = 'white', onOrientationChange, o
   );
 };
 
-Info.displayName = 'Chessboard.Info';
+Info.displayName = INFO_NAME;
 
 //
 // History
@@ -97,6 +106,7 @@ type HistoryProps = ThemedClassName<{
 
 const History = ({ classNames, model, min, max, onSelect }: HistoryProps) => {
   const { t } = useTranslation(meta.id);
+  const moveIndex = useAtomValue(model.moveIndex);
   const label = model.game.isGameOver()
     ? model.game.isCheckmate()
       ? t('game.checkmate label')
@@ -130,28 +140,28 @@ const History = ({ classNames, model, min, max, onSelect }: HistoryProps) => {
   }, [history.length]);
 
   useEffect(() => {
-    const div = scrollerRef.current?.querySelector(`[data-index="${model.moveIndex.value - 1}"]`);
+    const div = scrollerRef.current?.querySelector(`[data-index="${moveIndex - 1}"]`);
     scrollerRef.current?.classList.add('scrollbar-none');
     div?.scrollIntoView({ behavior: 'smooth' });
     scrollerRef.current?.classList.remove('scrollbar-none');
-  }, [model.moveIndex.value]);
+  }, [moveIndex]);
 
   return (
     <div
       ref={scrollerRef}
-      className={mx('overflow-y-scroll', classNames)}
+      className={mx('overflow-y-auto', classNames)}
       style={{
         minHeight: min === undefined ? 'auto' : `${min * 24}px`,
         maxHeight: max === undefined ? 'auto' : `${max * 24}px`,
       }}
     >
       {moves.map(([a, b], index) => (
-        <div key={index} className='grid grid-cols-[3rem_1fr_1fr_1rem] gap-2 pis-4 leading-1'>
+        <div key={index} className='grid grid-cols-[3rem_1fr_1fr_1rem] gap-2 ps-4 leading-1'>
           <div className='content-center text-xs text-subdued'>{index + 1}</div>
           {a && (
             <div
               data-index={a.index}
-              className={mx('pis-2 cursor-pointer', a.index === model.moveIndex.value - 1 && 'bg-primary-500')}
+              className={mx('ps-2 cursor-pointer', a.index === moveIndex - 1 && 'bg-primary-500')}
               onClick={() => onSelect?.(a.index + 1)}
             >
               {a.move}
@@ -160,7 +170,7 @@ const History = ({ classNames, model, min, max, onSelect }: HistoryProps) => {
           {b && (
             <div
               data-index={b.index}
-              className={mx('pis-2 cursor-pointer', b.index === model.moveIndex.value - 1 && 'bg-primary-500')}
+              className={mx('ps-2 cursor-pointer', b.index === moveIndex - 1 && 'bg-primary-500')}
               onClick={() => onSelect?.(b.index + 1)}
             >
               {b.move}
@@ -186,7 +196,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 bs-[--rail-size] pis-1 pie-1 flex items-center overflow-hidden'>
+    <div className='grid grid-cols-[2rem_1fr_2rem] 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/index.ts

@@ -0,0 +1,5 @@
+//
+// Copyright 2023 DXOS.org
+//
+
+export * from './Chessboard';

package/src/components/Chessboard/types.ts

@@ -0,0 +1,18 @@
+//
+// Copyright 2024 DXOS.org
+//
+
+import { type Registry } from '@effect-atom/atom-react';
+
+import { ChessModel } from '@dxos/react-ui-gameboard';
+
+import { type Chess } from '../../types';
+
+export class ExtendedChessModel extends ChessModel {
+  constructor(
+    registry: Registry.Registry,
+    readonly object: Chess.Game,
+  ) {
+    super(registry);
+  }
+}

package/src/components/index.ts

@@ -1,9 +1,5 @@
 //
-// Copyright 2023 DXOS.org
+// Copyright 2026 DXOS.org
 //
 
-import { lazy } from 'react';
-
 export * from './Chessboard';
-
-export const ChessboardContainer = lazy(() => import('./ChessboardContainer'));

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

@@ -0,0 +1,53 @@
+//
+// Copyright 2023 DXOS.org
+//
+
+import { type Meta, type StoryObj } from '@storybook/react-vite';
+import React, { useMemo } from 'react';
+
+import { withClientProvider } from '@dxos/react-client/testing';
+import { withLayout, withTheme } from '@dxos/react-ui/testing';
+
+import { translations } from '../../translations';
+import { Chess } from '../../types';
+
+import { ChessArticle } from './ChessArticle';
+
+type StoryProps = {
+  pgn?: string;
+};
+
+const DefaultStory = ({ pgn }: StoryProps) => {
+  const game = useMemo(() => Chess.make(pgn ? { pgn } : undefined), [pgn]);
+  return <ChessArticle subject={game} />;
+};
+
+const meta = {
+  title: 'plugins/plugin-chess/containers/ChessArticle',
+  component: DefaultStory,
+  decorators: [withTheme(), withLayout({ layout: 'fullscreen' }), withClientProvider({ createIdentity: true })],
+  parameters: {
+    layout: 'fullscreen',
+    translations,
+  },
+} satisfies Meta<typeof DefaultStory>;
+
+export default meta;
+
+type Story = StoryObj<typeof meta>;
+
+export const Default: Story = {
+  args: {},
+};
+
+export const EndGame: Story = {
+  args: {
+    pgn: '1. e4 e5 2. Nf3 Nc6 3. Bc4 Bc5 4. c3 Nf6 5. d4 exd4 6. cxd4 Bb4+ 7. Nc3 d5 8. exd5 Nxd5 9. O-O Be6 10. Qb3 Na5 11. Qa4+ c6 12. Bxd5 Bxc3 13. Bxe6 fxe6 *',
+  },
+};
+
+export const Promption: Story = {
+  args: {
+    pgn: '1. e4 e5 2. Nf3 Nc6 3. Bc4 Bc5 4. c3 Nf6 5. d4 exd4 6. cxd4 Bb4+ 7. Nc3 d5 8. exd5 Nxd5 9. O-O Be6 10. Qb3 Na5 11. Qa4+ c6 12. Bxd5 Bxc3 13. Bxe6 fxe6 14. d5 Qg5 15. dxe6 Qg4 16. e7 Kf7 17. bxc3 Kg6 *',
+  },
+};

package/src/containers/ChessArticle/ChessArticle.tsx

@@ -0,0 +1,72 @@
+//
+// Copyright 2024 DXOS.org
+//
+
+import React, { useCallback, useRef, useState } from 'react';
+
+import { type SurfaceComponentProps } from '@dxos/app-toolkit/ui';
+import { Panel, Toolbar, useTranslation } from '@dxos/react-ui';
+import { type Player } from '@dxos/react-ui-gameboard';
+import { mx } from '@dxos/ui-theme';
+
+import { Chessboard, type ChessboardController, type ChessboardInfoProps } from '../../components';
+import { meta } from '../../meta';
+import { type Chess } from '../../types';
+
+export type ChessArticleProps = SurfaceComponentProps<Chess.Game>;
+
+export const ChessArticle = ({ role, subject: game }: ChessArticleProps) => {
+  const { t } = useTranslation(meta.id);
+  const [orientation, setOrientation] = useState<Player>('white');
+  const [open, setOpen] = useState(true);
+  const controller = useRef<ChessboardController>(null);
+
+  const handleSelect = useCallback<NonNullable<ChessboardInfoProps['onSelect']>>((index) => {
+    controller.current?.setMoveNumber(index);
+  }, []);
+
+  return (
+    <Chessboard.Root game={game} ref={controller}>
+      <Panel.Root role={role} classNames='@container'>
+        <Panel.Toolbar asChild>
+          <Toolbar.Root>
+            <Toolbar.IconButton
+              icon='ph--info--regular'
+              iconOnly
+              label={t('toggle info button')}
+              disabled={open}
+              classNames={mx('invisible @3xl:visible')}
+              onClick={() => setOpen((open) => !open)}
+            />
+          </Toolbar.Root>
+        </Panel.Toolbar>
+        <Panel.Content>
+          <div
+            className={mx(
+              'grid h-full w-full gap-2',
+              open && '@3xl:grid-cols-[1fr_320px]',
+              role === 'section' && 'aspect-square',
+              role === 'section' && open && '@3xl:aspect-auto',
+            )}
+          >
+            <Chessboard.Content>
+              <Chessboard.Board classNames='m-4 rounded-xs overflow-hidden' orientation={orientation} />
+            </Chessboard.Content>
+            {open && (
+              <div className='hidden @3xl:flex flex-col p-8 justify-center items-center overflow-hidden'>
+                <Chessboard.Info
+                  orientation={orientation}
+                  min={8}
+                  max={8}
+                  onOrientationChange={setOrientation}
+                  onClose={() => setOpen(false)}
+                  onSelect={handleSelect}
+                />
+              </div>
+            )}
+          </div>
+        </Panel.Content>
+      </Panel.Root>
+    </Chessboard.Root>
+  );
+};

package/src/containers/ChessArticle/index.ts

@@ -0,0 +1,7 @@
+//
+// Copyright 2026 DXOS.org
+//
+
+import { ChessArticle } from './ChessArticle';
+
+export default ChessArticle;

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

@@ -0,0 +1,42 @@
+//
+// Copyright 2025 DXOS.org
+//
+
+import { type Meta, type StoryObj } from '@storybook/react-vite';
+import React, { useMemo } from 'react';
+
+import { withLayout, withTheme } from '@dxos/react-ui/testing';
+import { CardContainer } from '@dxos/react-ui-mosaic/testing';
+
+import { meta as pluginMeta } from '../../meta';
+import { Chess } from '../../types';
+
+import { ChessCard } from './ChessCard';
+
+const SAMPLE_PGN =
+  '1. e4 e5 2. Nf3 Nc6 3. Bc4 Bc5 4. c3 Nf6 5. d4 exd4 6. cxd4 Bb4+ 7. Nc3 d5 8. exd5 Nxd5 9. O-O Be6 10. Qb3 Na5 11. Qa4+ c6 12. Bxd5 Bxc3 13. Bxe6 fxe6 14. d5 Qg5 15. dxe6 Qg4 16. e7 Kf7 17. bxc3 Kg6 *';
+
+const CardStory = () => {
+  const game = useMemo(() => Chess.make({ pgn: SAMPLE_PGN }), []);
+  return (
+    <CardContainer role='popover' icon={pluginMeta.icon}>
+      <ChessCard subject={game} />
+    </CardContainer>
+  );
+};
+
+const meta = {
+  title: 'plugins/plugin-chess/containers/ChessCard',
+  render: () => <CardStory />,
+  decorators: [withTheme(), withLayout({ layout: 'column' })],
+  parameters: {
+    layout: 'fullscreen',
+  },
+  tags: ['cards'],
+} satisfies Meta;
+
+export default meta;
+
+type Story = StoryObj<typeof meta>;
+
+export const Popover: Story = {};

package/src/containers/ChessCard/ChessCard.tsx

@@ -0,0 +1,22 @@
+//
+// Copyright 2024 DXOS.org
+//
+
+import React from 'react';
+
+import { type SurfaceComponentProps } from '@dxos/app-toolkit/ui';
+
+import { Chessboard } from '../../components';
+import { type Chess } from '../../types';
+
+export type ChessCardProps = SurfaceComponentProps<Chess.Game>;
+
+export const ChessCard = ({ subject: game }: ChessCardProps) => {
+  return (
+    <Chessboard.Root game={game}>
+      <Chessboard.Content>
+        <Chessboard.Board />
+      </Chessboard.Content>
+    </Chessboard.Root>
+  );
+};

package/src/containers/ChessCard/index.ts

@@ -0,0 +1,7 @@
+//
+// Copyright 2026 DXOS.org
+//
+
+import { ChessCard } from './ChessCard';
+
+export default ChessCard;

package/src/containers/index.ts

@@ -0,0 +1,8 @@
+//
+// Copyright 2024 DXOS.org
+//
+
+import { type ComponentType, lazy } from 'react';
+
+export const ChessArticle: ComponentType<any> = lazy(() => import('./ChessArticle'));
+export const ChessCard: ComponentType<any> = lazy(() => import('./ChessCard'));

package/src/index.ts

@@ -2,9 +2,9 @@
 // Copyright 2023 DXOS.org
 //
 
+export * from './blueprints';
 export * from './capabilities';
-export * from './components';
-export * from './functions';
+export * from './components/Chessboard';
 export * from './meta';
 export * from './types';
 

package/src/meta.ts

@@ -2,16 +2,18 @@
 // Copyright 2023 DXOS.org
 //
 
-import { type PluginMeta } from '@dxos/app-framework';
+import { type Plugin } from '@dxos/app-framework';
 import { trim } from '@dxos/util';
 
-export const meta: PluginMeta = {
+export const meta: Plugin.Meta = {
   id: 'dxos.org/plugin/chess',
   name: 'Chess',
   description: trim`
-    Play chess with friends or practice with the AI.
+    Full-featured chess game supporting multiplayer matches with friends or practice sessions against AI opponents.
+    Track game history and analyze moves in real-time.
   `,
   icon: 'ph--shield-chevron--regular',
+  iconHue: 'amber',
   source: 'https://github.com/dxos/dxos/tree/main/packages/plugins/plugin-chess',
   screenshots: ['https://dxos.network/plugin-details-chess-dark.png'],
 };