@dxos/plugin-chess 0.12.0-next-73daef452f1464b62efdbca75fb0067c1066f264 → 0.13.0

package/PLUGIN.mdl

@@ -15,11 +15,11 @@ Each extension is defined in the Appendix or resolved via its URI.
 |-------------|--------------------------------|
 | `type`      | `org.dxos.mdl.type@1.0`       |
 | `feat`      | `org.dxos.mdl.feat@1.0`       |
-| `test`      | `org.dxos.mdl.test@1.0`       |
+| `scenario`  | `org.dxos.mdl.scenario@1.0`   |
 | `component` | `org.dxos.mdl.component@1.0`  |
 | `op`        | `org.dxos.mdl.op@1.1`         |
 | `service`   | `org.dxos.mdl.service@1.0`    |
-| `flow`      | `org.dxos.mdl.flow@1.0`       |
+| `test`      | `org.dxos.mdl.test@1.0`       |
 | `step`      | `org.dxos.mdl.step@1.0`       |
 
 ## Types
@@ -389,7 +389,7 @@ feat F-6: Game Persistence
 ## Acceptance
 
 ```mdl
-test T-1: New game starting position
+scenario T-1: New game starting position
   given: a new game is started
   then:
     - Board.turn === white
@@ -398,14 +398,14 @@ test T-1: New game starting position
 ```
 
 ```mdl
-test T-2: Illegal move rejected
+scenario T-2: Illegal move rejected
   given: it is white's turn
   when: white attempts to move a black piece
   then: WrongTurn error; Board unchanged
 ```
 
 ```mdl
-test T-3: Create and join game
+scenario T-3: Create and join game
   given: two players are in the Lobby
   when: player A creates a game, player B joins it
   then:
@@ -416,7 +416,7 @@ test T-3: Create and join game
 ```
 
 ```mdl
-test T-4: Legal move highlight
+scenario T-4: Legal move highlight
   given: Gameboard is shown, it is white's turn
   when: white selects the e2 pawn
   then:
@@ -425,7 +425,7 @@ test T-4: Legal move highlight
 ```
 
 ```mdl
-test T-5: Pawn promotion
+scenario T-5: Pawn promotion
   given: white pawn is on e7, it is white's turn
   when: white moves pawn to e8
   then:
@@ -435,7 +435,7 @@ test T-5: Pawn promotion
 ```
 
 ```mdl
-test T-6: Submit valid move
+scenario T-6: Submit valid move
   given: active game, white's turn, white player logged in
   when: white submits pawn e2→e4
   then:
@@ -446,7 +446,7 @@ test T-6: Submit valid move
 ```
 
 ```mdl
-test T-7: Submit invalid move rejected atomically
+scenario T-7: Submit invalid move rejected atomically
   given: active game, white's turn
   when: white submits an illegal move (e2→e5)
   then:
@@ -456,7 +456,7 @@ test T-7: Submit invalid move rejected atomically
 ```
 
 ```mdl
-test T-8: Legal moves highlighted
+scenario T-8: Legal moves highlighted
   given: new game, white's turn, Gameboard shown
   when: player selects e2
   then:
@@ -467,11 +467,11 @@ test T-8: Legal moves highlighted
 
 ## QA
 
-Executable flows. Each step carries a human instruction (`do`) and, where the step maps to an
-invocable operation, an agent binding (`invoke`). Report failures by flow and step number.
+Executable tests. Each step carries a human instruction (`do`) and, where the step maps to an
+invocable operation, an agent binding (`invoke`). Report failures by test and step number.
 
 ```mdl
-flow QA-1: Start a game and play the opening
+test QA-1: Start a game and play the opening
   desc: The core chess round-trip — create a game, play the first few moves, read the position back.
   actors: human
   covers: [F-1.1, F-2.1]
@@ -483,14 +483,17 @@ flow QA-1: Start a game and play the opening
     - plugin-chess is enabled — it is OFF by default, and no chess operation is registered until
       it is on. Enabling is a UI action (Settings -> plugin registry); `manager.enable()` returns
       without error from the debug port and does not enable it.
-    - no game named "QA Game" exists — ABORT rather than deleting one this flow did not create
-  test:
+    - no game named "QA Game" exists — ABORT rather than deleting one this test did not create
+    - game: the Game object the human creates in step 1 (named "QA Game"), resolved by the runner
+      after that step so later steps can reference it — there is no create operation to `capture`
+      it from
+  steps:
     - name: Create the game
       do: In the navtree, click + on a collection and choose Chess. Name it "QA Game".
       expect: a Game appears under the collection with pieces in their starting positions, white to move
       note: |
         NO `invoke` — [op:startGame] has no runtime counterpart (see its note), so this step is
-        human-only and the flow is `actors: human` until chess gains a create operation. That is
+        human-only and the test is `actors: human` until chess gains a create operation. That is
         the finding, not an omission.
     - name: Play 1. e4
       do: Drag the e2 pawn to e4.
@@ -536,7 +539,7 @@ the core `ext` primitive — the only construct the base language provides.
 
 ```mdl
 ext type
-  uri: dxos.spec/ext/type@1.0
+  uri: org.dxos.mdl.type@1.0
   desc: A named data structure with typed fields and optional literals.
   fields:
     desc?: Prose
@@ -547,7 +550,7 @@ ext type
 
 ```mdl
 ext feat
-  uri: dxos.spec/ext/feat@1.0
+  uri: org.dxos.mdl.feat@1.0
   desc: A named feature grouping one or more requirements.
   fields:
     desc?: Prose
@@ -556,8 +559,8 @@ ext feat
 ```
 
 ```mdl
-ext test
-  uri: dxos.spec/ext/test@1.0
+ext scenario
+  uri: org.dxos.mdl.scenario@1.0
   desc: An acceptance scenario expressed as given / when / then steps.
   fields:
     given?: Step | Step[]

package/dist/lib/Chess.mjs

@@ -3,7 +3,6 @@ import * as Skill from "@dxos/compute/Skill";
 import { Annotation, DXN, Obj, Type } from "@dxos/echo";
 import { Chess } from "chess.js";
 import * as Schema from "effect/Schema";
-import { FormInputAnnotation, HiddenAnnotation } from "@dxos/echo/Annotation";
 import { log } from "@dxos/log";
 //#region src/types/Chess.ts
 var Chess_exports = /* @__PURE__ */ __exportAll({
@@ -18,12 +17,12 @@ var SKILL_KEY = "org.dxos.skill.chess";
 * Players, name, and other game-shared fields live on the base `Game`.
 */
 var State = class extends Type.makeObject(DXN.make("org.dxos.type.chess.state", "0.1.0"))(Schema.Struct({
-	pgn: Schema.String.annotate({ description: "Portable Game Notation." }).pipe(FormInputAnnotation.set(false), Schema.optional),
-	fen: Schema.String.annotate({ description: "Forsyth-Edwards Notation." }).pipe(FormInputAnnotation.set(false), Schema.optional)
+	pgn: Schema.String.annotate({ description: "Portable Game Notation." }).pipe(Annotation.FormInputAnnotation.set(false), Schema.optional),
+	fen: Schema.String.annotate({ description: "Forsyth-Edwards Notation." }).pipe(Annotation.FormInputAnnotation.set(false), Schema.optional)
 }).pipe(Annotation.IconAnnotation.set({
 	icon: "ph--shield-chevron--regular",
 	hue: "amber"
-}), Skill.SkillsAnnotation.set([SKILL_KEY]), HiddenAnnotation.set(true))) {};
+}), Skill.SkillsAnnotation.set([SKILL_KEY]))) {};
 var make = ({ pgn, fen } = {}) => {
 	const chess = new Chess();
 	if (pgn) try {
@@ -32,7 +31,7 @@ var make = ({ pgn, fen } = {}) => {
 		log.warn(pgn, void 0, {
 			"~LogMeta": "~LogMeta",
 			F: __dxlog_file,
-			L: 44,
+			L: 38,
 			S: void 0
 		});
 	}

package/dist/lib/Chess.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"Chess.mjs","names":[],"sources":["../../src/types/Chess.ts"],"sourcesContent":["//\n// Copyright 2024 DXOS.org\n//\n\nimport { Chess as ChessJS } from 'chess.js';\nimport * as Schema from 'effect/Schema';\n\nimport * as Skill from '@dxos/compute/Skill';\nimport { Annotation, DXN, Obj, Type } from '@dxos/echo';\nimport { FormInputAnnotation, HiddenAnnotation } from '@dxos/echo/Annotation';\nimport { log } from '@dxos/log';\n\nexport const SKILL_KEY = 'org.dxos.skill.chess';\n\n/**\n * Chess variant state. Referenced by the base `Game` object via `Game.variant`.\n * Players, name, and other game-shared fields live on the base `Game`.\n */\nexport class State extends Type.makeObject<State>(DXN.make('org.dxos.type.chess.state', '0.1.0'))(\n  Schema.Struct({\n    pgn: Schema.String.annotate({\n      description: 'Portable Game Notation.',\n    }).pipe(FormInputAnnotation.set(false), Schema.optional),\n    fen: Schema.String.annotate({\n      description: 'Forsyth-Edwards Notation.',\n    }).pipe(FormInputAnnotation.set(false), Schema.optional),\n  }).pipe(\n    Annotation.IconAnnotation.set({ icon: 'ph--shield-chevron--regular', hue: 'amber' }),\n    Skill.SkillsAnnotation.set([SKILL_KEY]),\n    // Implementation detail of the unified `Game` schema. The user-facing object is `Game`;\n    // this state is only ever referenced via `Game.variant`. HiddenAnnotation keeps it out of the\n    // navtree's typed branches so an orphaned state object doesn't reappear after the\n    // wrapping Game is deleted.\n    HiddenAnnotation.set(true),\n  ),\n) {}\n\nexport const make = ({ pgn, fen }: { pgn?: string; fen?: string } = {}): State => {\n  const chess = new ChessJS();\n  if (pgn) {\n    try {\n      chess.loadPgn(pgn);\n    } catch {\n      log.warn(pgn);\n    }\n  }\n\n  return Obj.make(State, {\n    pgn,\n    fen,\n  });\n};\n"],"mappings":";;;;;;;;;;;;;;AAYA,IAAa,YAAY;;;;;AAMzB,IAAa,QAAb,cAA2B,KAAK,WAAkB,IAAI,KAAK,6BAA6B,OAAO,CAAC,CAAC,CAC/F,OAAO,OAAO;CACZ,KAAK,OAAO,OAAO,SAAS,EAC1B,aAAa,0BACf,CAAC,CAAC,CAAC,KAAK,oBAAoB,IAAI,KAAK,GAAG,OAAO,QAAQ;CACvD,KAAK,OAAO,OAAO,SAAS,EAC1B,aAAa,4BACf,CAAC,CAAC,CAAC,KAAK,oBAAoB,IAAI,KAAK,GAAG,OAAO,QAAQ;AACzD,CAAC,CAAC,CAAC,KACD,WAAW,eAAe,IAAI;CAAE,MAAM;CAA+B,KAAK;AAAQ,CAAC,GACnF,MAAM,iBAAiB,IAAI,CAAC,SAAS,CAAC,GAKtC,iBAAiB,IAAI,IAAI,CAC3B,CACF,CAAC,CAAC,CAAC;AAEH,IAAa,QAAQ,EAAE,KAAK,QAAwC,CAAC,MAAa;CAChF,MAAM,QAAQ,IAAI,MAAQ;CAC1B,IAAI,KACF,IAAI;EACF,MAAM,QAAQ,GAAG;CACnB,QAAQ;EACN,IAAI,KAAK,KAAE,KAAA,GAAA;GAAA,YAAA;GAAA,GAAA;GAAA,GAAA;GAAA,GAAA,KAAA;EAAA,CAAC;CACd;CAGF,OAAO,IAAI,KAAK,OAAO;EACrB;EACA;CACF,CAAC;AACH"}
+{"version":3,"file":"Chess.mjs","names":[],"sources":["../../src/types/Chess.ts"],"sourcesContent":["//\n// Copyright 2024 DXOS.org\n//\n\nimport { Chess as ChessJS } from 'chess.js';\nimport * as Schema from 'effect/Schema';\n\nimport * as Skill from '@dxos/compute/Skill';\nimport { Annotation, DXN, Obj, Type } from '@dxos/echo';\nimport { log } from '@dxos/log';\n\nexport const SKILL_KEY = 'org.dxos.skill.chess';\n\n/**\n * Chess variant state. Referenced by the base `Game` object via `Game.variant`.\n * Players, name, and other game-shared fields live on the base `Game`.\n */\nexport class State extends Type.makeObject<State>(DXN.make('org.dxos.type.chess.state', '0.1.0'))(\n  Schema.Struct({\n    pgn: Schema.String.annotate({\n      description: 'Portable Game Notation.',\n    }).pipe(Annotation.FormInputAnnotation.set(false), Schema.optional),\n    fen: Schema.String.annotate({\n      description: 'Forsyth-Edwards Notation.',\n    }).pipe(Annotation.FormInputAnnotation.set(false), Schema.optional),\n  }).pipe(\n    Annotation.IconAnnotation.set({ icon: 'ph--shield-chevron--regular', hue: 'amber' }),\n    Skill.SkillsAnnotation.set([SKILL_KEY]),\n  ),\n) {}\n\nexport const make = ({ pgn, fen }: { pgn?: string; fen?: string } = {}): State => {\n  const chess = new ChessJS();\n  if (pgn) {\n    try {\n      chess.loadPgn(pgn);\n    } catch {\n      log.warn(pgn);\n    }\n  }\n\n  return Obj.make(State, {\n    pgn,\n    fen,\n  });\n};\n"],"mappings":";;;;;;;;;;;;;AAWA,IAAa,YAAY;;;;;AAMzB,IAAa,QAAb,cAA2B,KAAK,WAAkB,IAAI,KAAK,6BAA6B,OAAO,CAAC,CAAC,CAC/F,OAAO,OAAO;CACZ,KAAK,OAAO,OAAO,SAAS,EAC1B,aAAa,0BACf,CAAC,CAAC,CAAC,KAAK,WAAW,oBAAoB,IAAI,KAAK,GAAG,OAAO,QAAQ;CAClE,KAAK,OAAO,OAAO,SAAS,EAC1B,aAAa,4BACf,CAAC,CAAC,CAAC,KAAK,WAAW,oBAAoB,IAAI,KAAK,GAAG,OAAO,QAAQ;AACpE,CAAC,CAAC,CAAC,KACD,WAAW,eAAe,IAAI;CAAE,MAAM;CAA+B,KAAK;AAAQ,CAAC,GACnF,MAAM,iBAAiB,IAAI,CAAC,SAAS,CAAC,CACxC,CACF,CAAC,CAAC,CAAC;AAEH,IAAa,QAAQ,EAAE,KAAK,QAAwC,CAAC,MAAa;CAChF,MAAM,QAAQ,IAAI,MAAQ;CAC1B,IAAI,KACF,IAAI;EACF,MAAM,QAAQ,GAAG;CACnB,QAAQ;EACN,IAAI,KAAK,KAAE,KAAA,GAAA;GAAA,YAAA;GAAA,GAAA;GAAA,GAAA;GAAA,GAAA,KAAA;EAAA,CAAC;CACd;CAGF,OAAO,IAAI,KAAK,OAAO;EACrB;EACA;CACF,CAAC;AACH"}

package/dist/lib/ChessOperation.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"ChessOperation.mjs","names":[],"sources":["../../src/types/ChessOperation.ts"],"sourcesContent":["//\n// Copyright 2025 DXOS.org\n//\n\n// @import-as-namespace\n\nimport * as Schema from 'effect/Schema';\n\nimport * as Operation from '@dxos/compute/Operation';\nimport { Database, DXN, Ref } from '@dxos/echo';\nimport * as Game from '@dxos/plugin-game/Game';\n\nimport * as Chess from './Chess';\nimport * as PlayerReview from './PlayerReview';\n\nexport const Move = Operation.make({\n  meta: {\n    key: DXN.make('org.dxos.operation.chess.move'),\n    name: 'Move',\n    description: 'Makes a move in the given chess game.',\n    icon: 'ph--play--regular',\n  },\n  input: Schema.Struct({\n    game: Game.GameRef(Chess.State).annotate({\n      description: 'The ID of the game object (variant must be Chess).',\n    }),\n    move: Schema.String.annotate({\n      description: 'The move to make in the chess game.',\n      examples: ['e4', 'Bf3'],\n    }),\n  }),\n  output: Schema.Struct({\n    pgn: Schema.String.annotate({\n      description: 'The PGN of the game after the move was played.',\n    }),\n  }),\n  services: [Database.Service],\n});\n\nexport const Play = Operation.make({\n  meta: {\n    key: DXN.make('org.dxos.operation.chess.play'),\n    name: 'Play',\n    description: 'Uses the chess engine to play the next move.',\n    icon: 'ph--play--regular',\n  },\n  input: Schema.Struct({\n    game: Game.GameRef(Chess.State).annotate({\n      description: 'The ID of the game object (variant must be Chess).',\n    }),\n    side: Schema.optional(Schema.Literals(['white', 'black', 'any'])).annotate({\n      description: 'The side to play.',\n      defaultValue: 'any',\n    }),\n  }),\n  output: Schema.Struct({\n    pgn: Schema.String.annotate({\n      description: 'The PGN of the game after the move was played.',\n    }),\n    move: Schema.optional(Schema.String).annotate({\n      description: 'The move that was played.',\n    }),\n  }),\n  services: [Database.Service],\n});\n\nexport const Print = Operation.make({\n  meta: {\n    key: DXN.make('org.dxos.operation.chess.print'),\n    name: 'Print game',\n    description: 'Prints the chess game to ASCII.',\n    icon: 'ph--clipboard-text--regular',\n  },\n  input: Schema.Struct({\n    pgn: Schema.optional(\n      Schema.String.annotate({\n        description: 'Portable Game Notation.',\n      }),\n    ),\n    fen: Schema.optional(\n      Schema.String.annotate({\n        description: 'Forsyth-Edwards Notation.',\n      }),\n    ),\n  }),\n  output: Schema.Struct({\n    ascii: Schema.String,\n  }),\n});\n\n/** Rebuilds a player review position index from all chess games in the space. */\nexport const RebuildPositionIndex = Operation.make({\n  meta: {\n    key: DXN.make('org.dxos.operation.chess.rebuildPositionIndex'),\n    name: 'Rebuild Position Index',\n    description: 'Scans chess games and updates the player review position index.',\n    icon: 'ph--arrows-clockwise--regular',\n  },\n  services: [Database.Service],\n  input: Schema.Struct({\n    review: Ref.Ref(PlayerReview.Review).annotate({\n      description: 'Player review whose position index should be rebuilt.',\n    }),\n  }),\n  output: Schema.Struct({\n    gamesScanned: Schema.Number,\n    positionsUpdated: Schema.Number,\n  }),\n}).pipe(Operation.visible);\n"],"mappings":";;;;;;;;;;;;;;AAeA,IAAa,OAAO,UAAU,KAAK;CACjC,MAAM;EACJ,KAAK,IAAI,KAAK,+BAA+B;EAC7C,MAAM;EACN,aAAa;EACb,MAAM;CACR;CACA,OAAO,OAAO,OAAO;EACnB,MAAM,KAAK,QAAQ,KAAW,CAAC,CAAC,SAAS,EACvC,aAAa,qDACf,CAAC;EACD,MAAM,OAAO,OAAO,SAAS;GAC3B,aAAa;GACb,UAAU,CAAC,MAAM,KAAK;EACxB,CAAC;CACH,CAAC;CACD,QAAQ,OAAO,OAAO,EACpB,KAAK,OAAO,OAAO,SAAS,EAC1B,aAAa,iDACf,CAAC,EACH,CAAC;CACD,UAAU,CAAC,SAAS,OAAO;AAC7B,CAAC;AAED,IAAa,OAAO,UAAU,KAAK;CACjC,MAAM;EACJ,KAAK,IAAI,KAAK,+BAA+B;EAC7C,MAAM;EACN,aAAa;EACb,MAAM;CACR;CACA,OAAO,OAAO,OAAO;EACnB,MAAM,KAAK,QAAQ,KAAW,CAAC,CAAC,SAAS,EACvC,aAAa,qDACf,CAAC;EACD,MAAM,OAAO,SAAS,OAAO,SAAS;GAAC;GAAS;GAAS;EAAK,CAAC,CAAC,CAAC,CAAC,SAAS;GACzE,aAAa;GACb,cAAc;EAChB,CAAC;CACH,CAAC;CACD,QAAQ,OAAO,OAAO;EACpB,KAAK,OAAO,OAAO,SAAS,EAC1B,aAAa,iDACf,CAAC;EACD,MAAM,OAAO,SAAS,OAAO,MAAM,CAAC,CAAC,SAAS,EAC5C,aAAa,4BACf,CAAC;CACH,CAAC;CACD,UAAU,CAAC,SAAS,OAAO;AAC7B,CAAC;AAED,IAAa,QAAQ,UAAU,KAAK;CAClC,MAAM;EACJ,KAAK,IAAI,KAAK,gCAAgC;EAC9C,MAAM;EACN,aAAa;EACb,MAAM;CACR;CACA,OAAO,OAAO,OAAO;EACnB,KAAK,OAAO,SACV,OAAO,OAAO,SAAS,EACrB,aAAa,0BACf,CAAC,CACH;EACA,KAAK,OAAO,SACV,OAAO,OAAO,SAAS,EACrB,aAAa,4BACf,CAAC,CACH;CACF,CAAC;CACD,QAAQ,OAAO,OAAO,EACpB,OAAO,OAAO,OAChB,CAAC;AACH,CAAC;;AAGD,IAAa,uBAAuB,UAAU,KAAK;CACjD,MAAM;EACJ,KAAK,IAAI,KAAK,+CAA+C;EAC7D,MAAM;EACN,aAAa;EACb,MAAM;CACR;CACA,UAAU,CAAC,SAAS,OAAO;CAC3B,OAAO,OAAO,OAAO,EACnB,QAAQ,IAAI,IAAI,MAAmB,CAAC,CAAC,SAAS,EAC5C,aAAa,wDACf,CAAC,EACH,CAAC;CACD,QAAQ,OAAO,OAAO;EACpB,cAAc,OAAO;EACrB,kBAAkB,OAAO;CAC3B,CAAC;AACH,CAAC,CAAC,CAAC,KAAK,UAAU,OAAO"}
+{"version":3,"file":"ChessOperation.mjs","names":[],"sources":["../../src/types/ChessOperation.ts"],"sourcesContent":["//\n// Copyright 2025 DXOS.org\n//\n\n// @import-as-namespace\n\nimport * as Schema from 'effect/Schema';\n\nimport * as Operation from '@dxos/compute/Operation';\nimport { Database, DXN, Ref } from '@dxos/echo';\nimport * as Game from '@dxos/plugin-game/Game';\n\nimport * as Chess from './Chess.ts';\nimport * as PlayerReview from './PlayerReview.ts';\n\nexport const Move = Operation.make({\n  meta: {\n    key: DXN.make('org.dxos.operation.chess.move'),\n    name: 'Move',\n    description: 'Makes a move in the given chess game.',\n    icon: 'ph--play--regular',\n  },\n  input: Schema.Struct({\n    game: Game.GameRef(Chess.State).annotate({\n      description: 'The ID of the game object (variant must be Chess).',\n    }),\n    move: Schema.String.annotate({\n      description: 'The move to make in the chess game.',\n      examples: ['e4', 'Bf3'],\n    }),\n  }),\n  output: Schema.Struct({\n    pgn: Schema.String.annotate({\n      description: 'The PGN of the game after the move was played.',\n    }),\n  }),\n  services: [Database.Service],\n});\n\nexport const Play = Operation.make({\n  meta: {\n    key: DXN.make('org.dxos.operation.chess.play'),\n    name: 'Play',\n    description: 'Uses the chess engine to play the next move.',\n    icon: 'ph--play--regular',\n  },\n  input: Schema.Struct({\n    game: Game.GameRef(Chess.State).annotate({\n      description: 'The ID of the game object (variant must be Chess).',\n    }),\n    side: Schema.optional(Schema.Literals(['white', 'black', 'any'])).annotate({\n      description: 'The side to play.',\n      defaultValue: 'any',\n    }),\n  }),\n  output: Schema.Struct({\n    pgn: Schema.String.annotate({\n      description: 'The PGN of the game after the move was played.',\n    }),\n    move: Schema.optional(Schema.String).annotate({\n      description: 'The move that was played.',\n    }),\n  }),\n  services: [Database.Service],\n});\n\nexport const Print = Operation.make({\n  meta: {\n    key: DXN.make('org.dxos.operation.chess.print'),\n    name: 'Print game',\n    description: 'Prints the chess game to ASCII.',\n    icon: 'ph--clipboard-text--regular',\n  },\n  input: Schema.Struct({\n    pgn: Schema.optional(\n      Schema.String.annotate({\n        description: 'Portable Game Notation.',\n      }),\n    ),\n    fen: Schema.optional(\n      Schema.String.annotate({\n        description: 'Forsyth-Edwards Notation.',\n      }),\n    ),\n  }),\n  output: Schema.Struct({\n    ascii: Schema.String,\n  }),\n});\n\n/** Rebuilds a player review position index from all chess games in the space. */\nexport const RebuildPositionIndex = Operation.make({\n  meta: {\n    key: DXN.make('org.dxos.operation.chess.rebuildPositionIndex'),\n    name: 'Rebuild Position Index',\n    description: 'Scans chess games and updates the player review position index.',\n    icon: 'ph--arrows-clockwise--regular',\n  },\n  services: [Database.Service],\n  input: Schema.Struct({\n    review: Ref.Ref(PlayerReview.Review).annotate({\n      description: 'Player review whose position index should be rebuilt.',\n    }),\n  }),\n  output: Schema.Struct({\n    gamesScanned: Schema.Number,\n    positionsUpdated: Schema.Number,\n  }),\n}).pipe(Operation.visible);\n"],"mappings":";;;;;;;;;;;;;;AAeA,IAAa,OAAO,UAAU,KAAK;CACjC,MAAM;EACJ,KAAK,IAAI,KAAK,+BAA+B;EAC7C,MAAM;EACN,aAAa;EACb,MAAM;CACR;CACA,OAAO,OAAO,OAAO;EACnB,MAAM,KAAK,QAAQ,KAAW,CAAC,CAAC,SAAS,EACvC,aAAa,qDACf,CAAC;EACD,MAAM,OAAO,OAAO,SAAS;GAC3B,aAAa;GACb,UAAU,CAAC,MAAM,KAAK;EACxB,CAAC;CACH,CAAC;CACD,QAAQ,OAAO,OAAO,EACpB,KAAK,OAAO,OAAO,SAAS,EAC1B,aAAa,iDACf,CAAC,EACH,CAAC;CACD,UAAU,CAAC,SAAS,OAAO;AAC7B,CAAC;AAED,IAAa,OAAO,UAAU,KAAK;CACjC,MAAM;EACJ,KAAK,IAAI,KAAK,+BAA+B;EAC7C,MAAM;EACN,aAAa;EACb,MAAM;CACR;CACA,OAAO,OAAO,OAAO;EACnB,MAAM,KAAK,QAAQ,KAAW,CAAC,CAAC,SAAS,EACvC,aAAa,qDACf,CAAC;EACD,MAAM,OAAO,SAAS,OAAO,SAAS;GAAC;GAAS;GAAS;EAAK,CAAC,CAAC,CAAC,CAAC,SAAS;GACzE,aAAa;GACb,cAAc;EAChB,CAAC;CACH,CAAC;CACD,QAAQ,OAAO,OAAO;EACpB,KAAK,OAAO,OAAO,SAAS,EAC1B,aAAa,iDACf,CAAC;EACD,MAAM,OAAO,SAAS,OAAO,MAAM,CAAC,CAAC,SAAS,EAC5C,aAAa,4BACf,CAAC;CACH,CAAC;CACD,UAAU,CAAC,SAAS,OAAO;AAC7B,CAAC;AAED,IAAa,QAAQ,UAAU,KAAK;CAClC,MAAM;EACJ,KAAK,IAAI,KAAK,gCAAgC;EAC9C,MAAM;EACN,aAAa;EACb,MAAM;CACR;CACA,OAAO,OAAO,OAAO;EACnB,KAAK,OAAO,SACV,OAAO,OAAO,SAAS,EACrB,aAAa,0BACf,CAAC,CACH;EACA,KAAK,OAAO,SACV,OAAO,OAAO,SAAS,EACrB,aAAa,4BACf,CAAC,CACH;CACF,CAAC;CACD,QAAQ,OAAO,OAAO,EACpB,OAAO,OAAO,OAChB,CAAC;AACH,CAAC;;AAGD,IAAa,uBAAuB,UAAU,KAAK;CACjD,MAAM;EACJ,KAAK,IAAI,KAAK,+CAA+C;EAC7D,MAAM;EACN,aAAa;EACb,MAAM;CACR;CACA,UAAU,CAAC,SAAS,OAAO;CAC3B,OAAO,OAAO,OAAO,EACnB,QAAQ,IAAI,IAAI,MAAmB,CAAC,CAAC,SAAS,EAC5C,aAAa,wDACf,CAAC,EACH,CAAC;CACD,QAAQ,OAAO,OAAO;EACpB,cAAc,OAAO;EACrB,kBAAkB,OAAO;CAC3B,CAAC;AACH,CAAC,CAAC,CAAC,KAAK,UAAU,OAAO"}

package/dist/lib/ChessOperationHandlerSet.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"ChessOperationHandlerSet.mjs","names":[],"sources":["../../src/operations/ChessOperationHandlerSet.ts"],"sourcesContent":["//\n// Copyright 2024 DXOS.org\n//\n\nimport * as Operation from '@dxos/compute/Operation';\nimport * as OperationHandlerSet from '@dxos/compute/OperationHandlerSet';\n\nimport { ChessOperation } from '#types';\n\nexport const handlers = OperationHandlerSet.lazy([\n  ChessOperation.Move.pipe(Operation.lazyHandler(() => import('./move'))),\n  ChessOperation.Play.pipe(Operation.lazyHandler(() => import('./play'))),\n  ChessOperation.Print.pipe(Operation.lazyHandler(() => import('./print'))),\n  ChessOperation.RebuildPositionIndex.pipe(Operation.lazyHandler(() => import('./rebuild-position-index'))),\n]);\n"],"mappings":";;;;;;AASA,IAAa,WAAW,oBAAoB,KAAK;CAC/C,eAAe,KAAK,KAAK,UAAU,kBAAkB,OAAO,mBAAS,CAAC;CACtE,eAAe,KAAK,KAAK,UAAU,kBAAkB,OAAO,mBAAS,CAAC;CACtE,eAAe,MAAM,KAAK,UAAU,kBAAkB,OAAO,oBAAU,CAAC;CACxE,eAAe,qBAAqB,KAAK,UAAU,kBAAkB,OAAO,qCAA2B,CAAC;AAC1G,CAAC"}
+{"version":3,"file":"ChessOperationHandlerSet.mjs","names":[],"sources":["../../src/operations/ChessOperationHandlerSet.ts"],"sourcesContent":["//\n// Copyright 2024 DXOS.org\n//\n\n// @import-as-namespace\n\nimport * as Operation from '@dxos/compute/Operation';\nimport * as OperationHandlerSet from '@dxos/compute/OperationHandlerSet';\n\nimport { ChessOperation } from '#types';\n\nexport const handlers = OperationHandlerSet.lazy([\n  ChessOperation.Move.pipe(Operation.lazyHandler(() => import('./move.ts'))),\n  ChessOperation.Play.pipe(Operation.lazyHandler(() => import('./play.ts'))),\n  ChessOperation.Print.pipe(Operation.lazyHandler(() => import('./print.ts'))),\n  ChessOperation.RebuildPositionIndex.pipe(Operation.lazyHandler(() => import('./rebuild-position-index.ts'))),\n]);\n"],"mappings":";;;;;;AAWA,IAAa,WAAW,oBAAoB,KAAK;CAC/C,eAAe,KAAK,KAAK,UAAU,kBAAkB,OAAO,mBAAY,CAAC;CACzE,eAAe,KAAK,KAAK,UAAU,kBAAkB,OAAO,mBAAY,CAAC;CACzE,eAAe,MAAM,KAAK,UAAU,kBAAkB,OAAO,oBAAa,CAAC;CAC3E,eAAe,qBAAqB,KAAK,UAAU,kBAAkB,OAAO,qCAA8B,CAAC;AAC7G,CAAC"}

package/dist/lib/ChessPositionIndex.mjs

@@ -1,7 +1,6 @@
 import { t as __exportAll } from "./chunk-rolldown-runtime.mjs";
 import { Annotation, DXN, Obj, Ref, Type } from "@dxos/echo";
 import * as Schema from "effect/Schema";
-import { FormInputAnnotation } from "@dxos/echo/Annotation";
 import * as Game from "@dxos/plugin-game/Game";
 //#region src/types/ChessPositionIndex.ts
 var ChessPositionIndex_exports = /* @__PURE__ */ __exportAll({
@@ -15,7 +14,7 @@ var ChessPositionIndex_exports = /* @__PURE__ */ __exportAll({
 /** Side the reviewed player may play in indexed games. */
 var Side = Schema.Literals(["white", "black"]);
 /** Games that reached a normalized FEN while the reviewed player was on this side. */
-var PositionEntry = Schema.Struct({ games: Schema.mutable(Schema.Array(Ref.Ref(Game.Game))).pipe(FormInputAnnotation.set(false)) });
+var PositionEntry = Schema.Struct({ games: Schema.mutable(Schema.Array(Ref.Ref(Game.Game))).pipe(Annotation.FormInputAnnotation.set(false)) });
 /** FEN-keyed lookup of {@link PositionEntry} for one side. */
 var SideIndex = Schema.Record(Schema.String, PositionEntry);
 /** Per-side position reach counts for a player review. */
@@ -27,7 +26,7 @@ var Index = Schema.Struct({
 * Aggregated chess positions reached by a player across indexed games.
 * Stored as a child of {@link PlayerReview}.
 */
-var PositionIndex = class extends Type.makeObject(DXN.make("org.dxos.type.chess.positionIndex", "0.1.0"))(Schema.Struct({ index: Index.pipe(FormInputAnnotation.set(false)) }).pipe(Annotation.IconAnnotation.set({
+var PositionIndex = class extends Type.makeObject(DXN.make("org.dxos.type.chess.positionIndex", "0.1.0"))(Schema.Struct({ index: Index.pipe(Annotation.FormInputAnnotation.set(false)) }).pipe(Annotation.IconAnnotation.set({
 	icon: "ph--map-trifold--regular",
 	hue: "amber"
 }))) {};

package/dist/lib/ChessPositionIndex.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"ChessPositionIndex.mjs","names":[],"sources":["../../src/types/ChessPositionIndex.ts"],"sourcesContent":["//\n// Copyright 2026 DXOS.org\n//\n\n// @import-as-namespace\n\nimport * as Schema from 'effect/Schema';\n\nimport { Annotation, DXN, Obj, Ref, Type } from '@dxos/echo';\nimport { FormInputAnnotation } from '@dxos/echo/Annotation';\nimport * as Game from '@dxos/plugin-game/Game';\n\n/** Side the reviewed player may play in indexed games. */\nexport const Side = Schema.Literals(['white', 'black']);\nexport type Side = Schema.Schema.Type<typeof Side>;\n\n/** Games that reached a normalized FEN while the reviewed player was on this side. */\nexport const PositionEntry = Schema.Struct({\n  games: Schema.mutable(Schema.Array(Ref.Ref(Game.Game))).pipe(FormInputAnnotation.set(false)),\n});\n\nexport type PositionEntry = Schema.Schema.Type<typeof PositionEntry>;\n\n/** FEN-keyed lookup of {@link PositionEntry} for one side. */\nexport const SideIndex = Schema.Record(Schema.String, PositionEntry);\n\nexport type SideIndex = Schema.Schema.Type<typeof SideIndex>;\n\n/** Per-side position reach counts for a player review. */\nexport const Index = Schema.Struct({\n  white: SideIndex,\n  black: SideIndex,\n});\n\nexport type Index = Schema.Schema.Type<typeof Index>;\n\n/**\n * Aggregated chess positions reached by a player across indexed games.\n * Stored as a child of {@link PlayerReview}.\n */\nexport class PositionIndex extends Type.makeObject<PositionIndex>(\n  DXN.make('org.dxos.type.chess.positionIndex', '0.1.0'),\n)(\n  Schema.Struct({\n    index: Index.pipe(FormInputAnnotation.set(false)),\n  }).pipe(Annotation.IconAnnotation.set({ icon: 'ph--map-trifold--regular', hue: 'amber' })),\n) {}\n\n/** Creates an empty position index. */\nexport const make = (): PositionIndex =>\n  Obj.make(PositionIndex, {\n    index: { white: {}, black: {} },\n  });\n"],"mappings":";;;;;;;;;;;;;;;AAaA,IAAa,OAAO,OAAO,SAAS,CAAC,SAAS,OAAO,CAAC;;AAItD,IAAa,gBAAgB,OAAO,OAAO,EACzC,OAAO,OAAO,QAAQ,OAAO,MAAM,IAAI,IAAI,KAAK,IAAI,CAAC,CAAC,CAAC,CAAC,KAAK,oBAAoB,IAAI,KAAK,CAAC,EAC7F,CAAC;;AAKD,IAAa,YAAY,OAAO,OAAO,OAAO,QAAQ,aAAa;;AAKnE,IAAa,QAAQ,OAAO,OAAO;CACjC,OAAO;CACP,OAAO;AACT,CAAC;;;;;AAQD,IAAa,gBAAb,cAAmC,KAAK,WACtC,IAAI,KAAK,qCAAqC,OAAO,CACvD,CAAC,CACC,OAAO,OAAO,EACZ,OAAO,MAAM,KAAK,oBAAoB,IAAI,KAAK,CAAC,EAClD,CAAC,CAAC,CAAC,KAAK,WAAW,eAAe,IAAI;CAAE,MAAM;CAA4B,KAAK;AAAQ,CAAC,CAAC,CAC3F,CAAC,CAAC,CAAC;;AAGH,IAAa,aACX,IAAI,KAAK,eAAe,EACtB,OAAO;CAAE,OAAO,CAAC;CAAG,OAAO,CAAC;AAAE,EAChC,CAAC"}
+{"version":3,"file":"ChessPositionIndex.mjs","names":[],"sources":["../../src/types/ChessPositionIndex.ts"],"sourcesContent":["//\n// Copyright 2026 DXOS.org\n//\n\n// @import-as-namespace\n\nimport * as Schema from 'effect/Schema';\n\nimport { Annotation, DXN, Obj, Ref, Type } from '@dxos/echo';\nimport * as Game from '@dxos/plugin-game/Game';\n\n/** Side the reviewed player may play in indexed games. */\nexport const Side = Schema.Literals(['white', 'black']);\nexport type Side = Schema.Schema.Type<typeof Side>;\n\n/** Games that reached a normalized FEN while the reviewed player was on this side. */\nexport const PositionEntry = Schema.Struct({\n  games: Schema.mutable(Schema.Array(Ref.Ref(Game.Game))).pipe(Annotation.FormInputAnnotation.set(false)),\n});\n\nexport type PositionEntry = Schema.Schema.Type<typeof PositionEntry>;\n\n/** FEN-keyed lookup of {@link PositionEntry} for one side. */\nexport const SideIndex = Schema.Record(Schema.String, PositionEntry);\n\nexport type SideIndex = Schema.Schema.Type<typeof SideIndex>;\n\n/** Per-side position reach counts for a player review. */\nexport const Index = Schema.Struct({\n  white: SideIndex,\n  black: SideIndex,\n});\n\nexport type Index = Schema.Schema.Type<typeof Index>;\n\n/**\n * Aggregated chess positions reached by a player across indexed games.\n * Stored as a child of {@link PlayerReview}.\n */\nexport class PositionIndex extends Type.makeObject<PositionIndex>(\n  DXN.make('org.dxos.type.chess.positionIndex', '0.1.0'),\n)(\n  Schema.Struct({\n    index: Index.pipe(Annotation.FormInputAnnotation.set(false)),\n  }).pipe(Annotation.IconAnnotation.set({ icon: 'ph--map-trifold--regular', hue: 'amber' })),\n) {}\n\n/** Creates an empty position index. */\nexport const make = (): PositionIndex =>\n  Obj.make(PositionIndex, {\n    index: { white: {}, black: {} },\n  });\n"],"mappings":";;;;;;;;;;;;;;AAYA,IAAa,OAAO,OAAO,SAAS,CAAC,SAAS,OAAO,CAAC;;AAItD,IAAa,gBAAgB,OAAO,OAAO,EACzC,OAAO,OAAO,QAAQ,OAAO,MAAM,IAAI,IAAI,KAAK,IAAI,CAAC,CAAC,CAAC,CAAC,KAAK,WAAW,oBAAoB,IAAI,KAAK,CAAC,EACxG,CAAC;;AAKD,IAAa,YAAY,OAAO,OAAO,OAAO,QAAQ,aAAa;;AAKnE,IAAa,QAAQ,OAAO,OAAO;CACjC,OAAO;CACP,OAAO;AACT,CAAC;;;;;AAQD,IAAa,gBAAb,cAAmC,KAAK,WACtC,IAAI,KAAK,qCAAqC,OAAO,CACvD,CAAC,CACC,OAAO,OAAO,EACZ,OAAO,MAAM,KAAK,WAAW,oBAAoB,IAAI,KAAK,CAAC,EAC7D,CAAC,CAAC,CAAC,KAAK,WAAW,eAAe,IAAI;CAAE,MAAM;CAA4B,KAAK;AAAQ,CAAC,CAAC,CAC3F,CAAC,CAAC,CAAC;;AAGH,IAAa,aACX,IAAI,KAAK,eAAe,EACtB,OAAO;CAAE,OAAO,CAAC;CAAG,OAAO,CAAC;AAAE,EAChC,CAAC"}

package/dist/lib/ChessSkill.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"ChessSkill.mjs","names":[],"sources":["../../src/skills/ChessSkill.ts"],"sourcesContent":["//\n// Copyright 2025 DXOS.org\n//\n\nimport * as Skill from '@dxos/compute/Skill';\nimport * as Template from '@dxos/compute/Template';\nimport { trim } from '@dxos/util';\n\nimport { Chess, ChessOperation } from '#types';\n\nconst operations = [ChessOperation.Move, ChessOperation.Play, ChessOperation.Print];\n\nexport const key = Chess.SKILL_KEY;\n\nexport const make = (): Skill.Skill =>\n  Skill.make({\n    key: Chess.SKILL_KEY,\n    name: 'Chess',\n    tools: Skill.toolDefinitions({ operations }),\n    instructions: Template.make({\n      source: trim`\n        You are an expert chess player.\n        To analyze a game you can access the \"pgn\" property by loading the context object that represents the current game.\n        You could suggest a good next move or offer to play a move.\n        Don't actually make a move unless you are asked to.\n\n        When setting a chess position, always set the \"pgn\" field (move list in standard PGN notation) on the org.dxos.type.chess.state object.\n        The \"fen\" field is not used by the UI for display — the board is driven exclusively from \"pgn\".\n        Setting \"fen\" alone or leaving \"pgn\" empty will result in the initial position being shown.\n      `,\n    }),\n  });\n"],"mappings":";;;;;;;;;;AAUA,IAAM,aAAa;CAAC,eAAe;CAAM,eAAe;CAAM,eAAe;AAAK;AAElF,IAAa,MAAM,MAAM;AAEzB,IAAa,aACX,MAAM,KAAK;CACT,KAAK,MAAM;CACX,MAAM;CACN,OAAO,MAAM,gBAAgB,EAAE,WAAW,CAAC;CAC3C,cAAc,SAAS,KAAK,EAC1B,QAAQ,IAAI;;;;;;;;;QAUd,CAAC;AACH,CAAC"}
+{"version":3,"file":"ChessSkill.mjs","names":[],"sources":["../../src/skills/ChessSkill.ts"],"sourcesContent":["//\n// Copyright 2025 DXOS.org\n//\n\n// @import-as-namespace\n\nimport * as Skill from '@dxos/compute/Skill';\nimport * as Template from '@dxos/compute/Template';\nimport { trim } from '@dxos/util';\n\nimport { Chess, ChessOperation } from '#types';\n\nconst operations = [ChessOperation.Move, ChessOperation.Play, ChessOperation.Print];\n\nexport const key = Chess.SKILL_KEY;\n\nexport const make = (): Skill.Skill =>\n  Skill.make({\n    key: Chess.SKILL_KEY,\n    name: 'Chess',\n    tools: Skill.toolDefinitions({ operations }),\n    instructions: Template.make({\n      source: trim`\n        You are an expert chess player.\n        To analyze a game you can access the \"pgn\" property by loading the context object that represents the current game.\n        You could suggest a good next move or offer to play a move.\n        Don't actually make a move unless you are asked to.\n\n        When setting a chess position, always set the \"pgn\" field (move list in standard PGN notation) on the org.dxos.type.chess.state object.\n        The \"fen\" field is not used by the UI for display — the board is driven exclusively from \"pgn\".\n        Setting \"fen\" alone or leaving \"pgn\" empty will result in the initial position being shown.\n      `,\n    }),\n  });\n"],"mappings":";;;;;;;;;;AAYA,IAAM,aAAa;CAAC,eAAe;CAAM,eAAe;CAAM,eAAe;AAAK;AAElF,IAAa,MAAM,MAAM;AAEzB,IAAa,aACX,MAAM,KAAK;CACT,KAAK,MAAM;CACX,MAAM;CACN,OAAO,MAAM,gBAAgB,EAAE,WAAW,CAAC;CAC3C,cAAc,SAAS,KAAK,EAC1B,QAAQ,IAAI;;;;;;;;;QAUd,CAAC;AACH,CAAC"}

package/dist/lib/PlayerReview.mjs

@@ -2,7 +2,6 @@ import { t as __exportAll } from "./chunk-rolldown-runtime.mjs";
 import { PositionIndex, make } from "./ChessPositionIndex.mjs";
 import { Annotation, DXN, Obj, Ref, Type } from "@dxos/echo";
 import * as Schema from "effect/Schema";
-import { FormInputAnnotation, LabelAnnotation } from "@dxos/echo/Annotation";
 //#region src/types/PlayerReview.ts
 var PlayerReview_exports = /* @__PURE__ */ __exportAll({
 	Review: () => Review,
@@ -15,15 +14,15 @@ var PlayerReview_exports = /* @__PURE__ */ __exportAll({
 var Review = class extends Type.makeObject(DXN.make("org.dxos.type.chess.playerReview", "0.1.0"))(Schema.Struct({
 	name: Schema.optional(Schema.String),
 	/** DID of the reviewed player; matched against {@link org.dxos.type.game} players. */
-	playerIdentity: Schema.String.pipe(FormInputAnnotation.set(false), Schema.optional),
+	playerIdentity: Schema.String.pipe(Annotation.FormInputAnnotation.set(false), Schema.optional),
 	/** Display name fallback when identity is absent (e.g. Chess.com username). */
 	playerName: Schema.String.pipe(Schema.optional),
 	/** Owned index: `SetParent` cascades it with the review. */
-	positionIndex: Ref.Ref(PositionIndex).pipe(Annotation.SetParent.set(true), FormInputAnnotation.set(false))
-}).pipe(LabelAnnotation.set(["name"]), Annotation.IconAnnotation.set({
+	positionIndex: Ref.Ref(PositionIndex).pipe(Annotation.SetParent.set(), Annotation.FormInputAnnotation.set(false))
+}).pipe(Annotation.LabelAnnotation.set(["name"]), Annotation.IconAnnotation.set({
 	icon: "ph--chart-polar--regular",
 	hue: "amber"
-}))) {};
+}), Annotation.UserType.set())) {};
 /** Creates a player review with an empty child position index. */
 var makeReview = (props = {}) => {
 	const positionIndex = make();

package/dist/lib/PlayerReview.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"PlayerReview.mjs","names":[],"sources":["../../src/types/PlayerReview.ts"],"sourcesContent":["//\n// Copyright 2026 DXOS.org\n//\n\n// @import-as-namespace\n\nimport * as Schema from 'effect/Schema';\n\nimport { Annotation, DXN, Obj, Ref, Type } from '@dxos/echo';\nimport { FormInputAnnotation, LabelAnnotation } from '@dxos/echo/Annotation';\n\nimport * as ChessPositionIndex from './ChessPositionIndex';\n\n/**\n * Personal chess opening/position review for a single player.\n * Indexes all reachable positions (by side) across games in the space.\n */\nexport class Review extends Type.makeObject<Review>(DXN.make('org.dxos.type.chess.playerReview', '0.1.0'))(\n  Schema.Struct({\n    name: Schema.optional(Schema.String),\n    /** DID of the reviewed player; matched against {@link org.dxos.type.game} players. */\n    playerIdentity: Schema.String.pipe(FormInputAnnotation.set(false), Schema.optional),\n    /** Display name fallback when identity is absent (e.g. Chess.com username). */\n    playerName: Schema.String.pipe(Schema.optional),\n    /** Owned index: `SetParent` cascades it with the review. */\n    positionIndex: Ref.Ref(ChessPositionIndex.PositionIndex).pipe(\n      Annotation.SetParent.set(true),\n      FormInputAnnotation.set(false),\n    ),\n  }).pipe(\n    LabelAnnotation.set(['name']),\n    Annotation.IconAnnotation.set({ icon: 'ph--chart-polar--regular', hue: 'amber' }),\n  ),\n) {}\n\nexport type MakeReviewProps = {\n  name?: string;\n  playerIdentity?: string;\n  playerName?: string;\n};\n\n/** Creates a player review with an empty child position index. */\nexport const makeReview = (props: MakeReviewProps = {}): Review => {\n  const positionIndex = ChessPositionIndex.make();\n  return Obj.make(Review, {\n    ...props,\n    name: props.name ?? props.playerName ?? 'Player review',\n    positionIndex: Ref.make(positionIndex),\n  });\n};\n"],"mappings":";;;;;;;;;;;;;;AAiBA,IAAa,SAAb,cAA4B,KAAK,WAAmB,IAAI,KAAK,oCAAoC,OAAO,CAAC,CAAC,CACxG,OAAO,OAAO;CACZ,MAAM,OAAO,SAAS,OAAO,MAAM;;CAEnC,gBAAgB,OAAO,OAAO,KAAK,oBAAoB,IAAI,KAAK,GAAG,OAAO,QAAQ;;CAElF,YAAY,OAAO,OAAO,KAAK,OAAO,QAAQ;;CAE9C,eAAe,IAAI,IAAI,aAAgC,CAAC,CAAC,KACvD,WAAW,UAAU,IAAI,IAAI,GAC7B,oBAAoB,IAAI,KAAK,CAC/B;AACF,CAAC,CAAC,CAAC,KACD,gBAAgB,IAAI,CAAC,MAAM,CAAC,GAC5B,WAAW,eAAe,IAAI;CAAE,MAAM;CAA4B,KAAK;AAAQ,CAAC,CAClF,CACF,CAAC,CAAC,CAAC;;AASH,IAAa,cAAc,QAAyB,CAAC,MAAc;CACjE,MAAM,gBAAgB,KAAwB;CAC9C,OAAO,IAAI,KAAK,QAAQ;EACtB,GAAG;EACH,MAAM,MAAM,QAAQ,MAAM,cAAc;EACxC,eAAe,IAAI,KAAK,aAAa;CACvC,CAAC;AACH"}
+{"version":3,"file":"PlayerReview.mjs","names":[],"sources":["../../src/types/PlayerReview.ts"],"sourcesContent":["//\n// Copyright 2026 DXOS.org\n//\n\n// @import-as-namespace\n\nimport * as Schema from 'effect/Schema';\n\nimport { Annotation, DXN, Obj, Ref, Type } from '@dxos/echo';\n\nimport * as ChessPositionIndex from './ChessPositionIndex.ts';\n\n/**\n * Personal chess opening/position review for a single player.\n * Indexes all reachable positions (by side) across games in the space.\n */\nexport class Review extends Type.makeObject<Review>(DXN.make('org.dxos.type.chess.playerReview', '0.1.0'))(\n  Schema.Struct({\n    name: Schema.optional(Schema.String),\n    /** DID of the reviewed player; matched against {@link org.dxos.type.game} players. */\n    playerIdentity: Schema.String.pipe(Annotation.FormInputAnnotation.set(false), Schema.optional),\n    /** Display name fallback when identity is absent (e.g. Chess.com username). */\n    playerName: Schema.String.pipe(Schema.optional),\n    /** Owned index: `SetParent` cascades it with the review. */\n    positionIndex: Ref.Ref(ChessPositionIndex.PositionIndex).pipe(\n      Annotation.SetParent.set(),\n      Annotation.FormInputAnnotation.set(false),\n    ),\n  }).pipe(\n    Annotation.LabelAnnotation.set(['name']),\n    Annotation.IconAnnotation.set({ icon: 'ph--chart-polar--regular', hue: 'amber' }),\n    Annotation.UserType.set(),\n  ),\n) {}\n\nexport type MakeReviewProps = {\n  name?: string;\n  playerIdentity?: string;\n  playerName?: string;\n};\n\n/** Creates a player review with an empty child position index. */\nexport const makeReview = (props: MakeReviewProps = {}): Review => {\n  const positionIndex = ChessPositionIndex.make();\n  return Obj.make(Review, {\n    ...props,\n    name: props.name ?? props.playerName ?? 'Player review',\n    positionIndex: Ref.make(positionIndex),\n  });\n};\n"],"mappings":";;;;;;;;;;;;;AAgBA,IAAa,SAAb,cAA4B,KAAK,WAAmB,IAAI,KAAK,oCAAoC,OAAO,CAAC,CAAC,CACxG,OAAO,OAAO;CACZ,MAAM,OAAO,SAAS,OAAO,MAAM;;CAEnC,gBAAgB,OAAO,OAAO,KAAK,WAAW,oBAAoB,IAAI,KAAK,GAAG,OAAO,QAAQ;;CAE7F,YAAY,OAAO,OAAO,KAAK,OAAO,QAAQ;;CAE9C,eAAe,IAAI,IAAI,aAAgC,CAAC,CAAC,KACvD,WAAW,UAAU,IAAI,GACzB,WAAW,oBAAoB,IAAI,KAAK,CAC1C;AACF,CAAC,CAAC,CAAC,KACD,WAAW,gBAAgB,IAAI,CAAC,MAAM,CAAC,GACvC,WAAW,eAAe,IAAI;CAAE,MAAM;CAA4B,KAAK;AAAQ,CAAC,GAChF,WAAW,SAAS,IAAI,CAC1B,CACF,CAAC,CAAC,CAAC;;AASH,IAAa,cAAc,QAAyB,CAAC,MAAc;CACjE,MAAM,gBAAgB,KAAwB;CAC9C,OAAO,IAAI,KAAK,QAAQ;EACtB,GAAG;EACH,MAAM,MAAM,QAAQ,MAAM,cAAc;EACxC,eAAe,IAAI,KAAK,aAAa;CACvC,CAAC;AACH"}

package/dist/lib/capabilities.browser.mjs

@@ -0,0 +1,32 @@
+import { t as PLUGIN_default } from "./chunk-PLUGIN.mjs";
+import * as ActivationEvents from "@dxos/app-framework/ActivationEvents";
+import * as AppCapability from "@dxos/app-toolkit/AppCapability";
+import { translations } from "#translations";
+import * as Capability from "@dxos/app-framework/Capability";
+import * as GameCapabilities from "@dxos/plugin-game/GameCapabilities";
+import * as GameEvents from "@dxos/plugin-game/GameEvents";
+import { meta } from "#meta";
+//#region src/capabilities/gen/browser.ts
+var Schema = AppCapability.schema(() => import("./chunk-schema.mjs"));
+var SkillDefinition = AppCapability.skillDefinition(() => import("./chunk-skill-definition.mjs"), { environments: [
+	"browser",
+	"node",
+	"tauri"
+] });
+var GameVariant = Capability.lazyModule("GameVariant", {
+	provides: [GameCapabilities.VariantProvider],
+	activatesOn: GameEvents.Start,
+	environments: ["browser", "tauri"]
+}, () => import("./chunk-game-variant.mjs"));
+var OperationHandler = AppCapability.operationHandler(() => import("./chunk-operation-handler.mjs"), { activatesOn: ActivationEvents.Idle });
+var PluginAsset = AppCapability.pluginAsset({
+	pluginId: meta.profile.key,
+	path: "PLUGIN.mdl",
+	content: PLUGIN_default,
+	mimeType: "application/x-mdl"
+});
+var Translations = AppCapability.translations(translations);
+//#endregion
+export { GameVariant, OperationHandler, PluginAsset, Schema, SkillDefinition, Translations };
+
+//# sourceMappingURL=capabilities.browser.mjs.map

package/dist/lib/capabilities.browser.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"capabilities.browser.mjs","names":[],"sources":["../../src/capabilities/gen/browser.ts"],"sourcesContent":["//\n// Copyright 2026 DXOS.org\n//\n\n// GENERATED by dx-plugin — do not edit. Sliced from ../index.ts for the 'browser' condition.\n\nimport * as ActivationEvents from '@dxos/app-framework/ActivationEvents';\nimport * as Capability from '@dxos/app-framework/Capability';\nimport * as AppCapability from '@dxos/app-toolkit/AppCapability';\nimport * as GameCapabilities from '@dxos/plugin-game/GameCapabilities';\nimport * as GameEvents from '@dxos/plugin-game/GameEvents';\n\nimport { meta } from '#meta';\nimport { translations } from '#translations';\n\nimport pluginSpec from '../../../PLUGIN.mdl?raw';\n\nexport const Schema = AppCapability.schema(() => import('../schema.ts'));\n\nexport const SkillDefinition = AppCapability.skillDefinition(() => import('../skill-definition.ts'), {\n  environments: ['browser', 'node', 'tauri'],\n});\n\n// Browser-only: the variant descriptor carries the `card`/`article` React components the game\n// host renders, so the module cannot load without a DOM.\nexport const GameVariant = Capability.lazyModule(\n  'GameVariant',\n  { provides: [GameCapabilities.VariantProvider], activatesOn: GameEvents.Start, environments: ['browser', 'tauri'] },\n  () => import('../game-variant.ts'),\n);\n\nexport const OperationHandler = AppCapability.operationHandler(() => import('../operation-handler.ts'), {\n  activatesOn: ActivationEvents.Idle,\n});\n\nexport const PluginAsset = AppCapability.pluginAsset({\n  pluginId: meta.profile.key,\n  path: 'PLUGIN.mdl',\n  content: pluginSpec,\n  mimeType: 'application/x-mdl',\n});\n\nexport const Translations = AppCapability.translations(translations);\n"],"mappings":";;;;;;;;;AAiBA,IAAa,SAAS,cAAc,aAAa,OAAO,qBAAe;AAEvE,IAAa,kBAAkB,cAAc,sBAAsB,OAAO,iCAA2B,EACnG,cAAc;CAAC;CAAW;CAAQ;AAAO,EAC3C,CAAC;AAID,IAAa,cAAc,WAAW,WACpC,eACA;CAAE,UAAU,CAAC,iBAAiB,eAAe;CAAG,aAAa,WAAW;CAAO,cAAc,CAAC,WAAW,OAAO;AAAE,SAC5G,OAAO,2BACf;AAEA,IAAa,mBAAmB,cAAc,uBAAuB,OAAO,kCAA4B,EACtG,aAAa,iBAAiB,KAChC,CAAC;AAED,IAAa,cAAc,cAAc,YAAY;CACnD,UAAU,KAAK,QAAQ;CACvB,MAAM;CACN,SAAS;CACT,UAAU;AACZ,CAAC;AAED,IAAa,eAAe,cAAc,aAAa,YAAY"}

package/dist/lib/capabilities.mjs

@@ -1,3 +1,4 @@
+import { t as PLUGIN_default } from "./chunk-PLUGIN.mjs";
 import * as ActivationEvents from "@dxos/app-framework/ActivationEvents";
 import * as AppCapability from "@dxos/app-toolkit/AppCapability";
 import { translations } from "#translations";
@@ -5,16 +6,17 @@ import * as Capability from "@dxos/app-framework/Capability";
 import * as GameCapabilities from "@dxos/plugin-game/GameCapabilities";
 import * as GameEvents from "@dxos/plugin-game/GameEvents";
 import { meta } from "#meta";
-//#region PLUGIN.mdl?raw
-var PLUGIN_default = "---\nid: org.dxos.plugin.chess\nname: ChessPlugin\nversion: 0.1.0\n---\n\nA two-player chess game plugin for `DXOS` Composer.\n\n## Extensions\n\nThe following extension dialects are used in this document.\nEach extension is defined in the Appendix or resolved via its URI.\n\n| Term        | URI                            |\n|-------------|--------------------------------|\n| `type`      | `org.dxos.mdl.type@1.0`       |\n| `feat`      | `org.dxos.mdl.feat@1.0`       |\n| `test`      | `org.dxos.mdl.test@1.0`       |\n| `component` | `org.dxos.mdl.component@1.0`  |\n| `op`        | `org.dxos.mdl.op@1.1`         |\n| `service`   | `org.dxos.mdl.service@1.0`    |\n| `flow`      | `org.dxos.mdl.flow@1.0`       |\n| `step`      | `org.dxos.mdl.step@1.0`       |\n\n## Types\n\n```mdl\ntype Color\n  literals: white | black\n```\n\n```mdl\ntype PieceKind\n  literals: pawn | rook | knight | bishop | queen | king\n```\n\n```mdl\ntype Piece\n  fields:\n    kind: PieceKind\n    color: Color\n```\n\n```mdl\ntype Square\n  fields:\n    file: a | b | c | d | e | f | g | h\n    rank: 1..8\n    piece?: Piece\n```\n\n```mdl\ntype Move\n  fields:\n    from: Square\n    to: Square\n    promotion?: PieceKind   # only valid for pawn reaching back rank\n```\n\n```mdl\ntype Board\n  fields:\n    squares: Square[8][8]\n    turn: Color\n    status: playing | check | checkmate | stalemate\n    moves: Move[]           # full move history\n```\n\n```mdl\ntype Player\n  fields:\n    id: string\n    name: string\n    color: Color\n```\n\n```mdl\ntype GameStatus\n  literals: waiting | active | finished\n```\n\n```mdl\ntype Game\n  fields:\n    id: string\n    players: Player[2]\n    board: Board\n    status: GameStatus\n    winner?: Player\n```\n\n## Components\n\n```mdl\ncomponent Lobby\n  desc: Entry point where players create or join a game.\n  props:\n    playerId: string\n  state:\n    games: Game[]               # list of open/active games\n    selected?: Game\n  slots:\n    header?: ReactNode\n    empty?: ReactNode           # shown when games list is empty\n  actions:\n    createGame() → Game\n    joinGame(game: Game) → Game\n    spectate(game: Game)\n  emits:\n    onJoin(game: Game)\n  layout: |\n    ┌─────────────────────────┐\n    │ [header slot]           │\n    ├─────────────────────────┤\n    │ Game list               │\n    │  ┌───────────────────┐  │\n    │  │ game row          │  │\n    │  └───────────────────┘  │\n    │  [empty slot]           │\n    ├─────────────────────────┤\n    │ [Create Game]           │\n    └─────────────────────────┘\n```\n\n```mdl\ncomponent Gameboard\n  desc: Interactive chess board for an active game.\n  props:\n    game: Game\n    playerId: string            # identifies which side the viewer plays\n  state:\n    selected?: Square           # currently selected square\n    highlights: Square[]        # legal move targets for selected piece\n    perspective: Color          # which side is at the bottom (default: player's color)\n  slots:\n    toolbar?: ReactNode\n    sidebar?: ReactNode\n    overlay?: ReactNode         # e.g. checkmate / promotion dialogs\n  actions:\n    selectSquare(square: Square)\n    submitMove(move: Move)\n    flipBoard()\n  emits:\n    onMove(move: Move)\n    onResign()\n  layout: |\n    ┌─────────────────────────┐\n    │ [toolbar slot]          │\n    ├──────────┬──────────────┤\n    │          │ [sidebar]    │\n    │  8×8     │              │\n    │  board   │ move history │\n    │          │              │\n    ├──────────┴──────────────┤\n    │ [overlay slot]          │\n    └─────────────────────────┘\n```\n\n## Services\n\n```mdl\nservice ChessEngine\n  desc: Validates moves and computes game state. May be local (WASM) or remote.\n  loading: lazy\n  ops:\n    validate(board: Board, move: Move) → Move\n    legalMoves(board: Board, square: Square) → Square[]\n    applyMove(board: Board, move: Move) → Board\n  errors:\n    EngineNotReady: engine has not finished loading\n```\n\n```mdl\nservice GameStore\n  desc: Persists and replicates Game state via ECHO.\n  ops:\n    create(white: Player, black: Player) → Game\n    load(id: string) → Game\n    save(game: Game) → Game\n    list() → Game[]\n  effects: [echo:write, echo:read]\n```\n\n## Operations\n\nPure operations (no effects, no service dependencies) — safe to call anywhere.\n\n```mdl\nop getLegalMoves\n  desc: Returns legal target squares for the piece on the given square.\n  input:\n    board: Board\n    square: Square\n  output: Square[]\n  errors:\n    EmptySquare: no piece on square\n    WrongSide: piece does not belong to the active side\n  requires: [ChessEngine]\n```\n\n```mdl\nop validateMove\n  desc: Checks a move against chess rules without mutating state.\n  input:\n    board: Board\n    move: Move\n  output: Move\n  errors:\n    IllegalMove: move violates chess rules\n    WrongTurn: piece does not belong to the active side\n    GameOver: game has already ended\n  requires: [ChessEngine]\n```\n\n```mdl\nop applyMove\n  desc: Applies a validated move and returns the next board state.\n  input:\n    board: Board\n    move: Move                  # must be pre-validated\n  output: Board\n  requires: [ChessEngine]\n  note: does not persist; use submitMove for the full transactional flow\n```\n\nEffectful operations — mutate persistent state.\n\n```mdl\nop startGame\n  desc: Creates a new Game with two players and an initial Board.\n  input:\n    white: Player\n    black: Player\n  output: Game\n  effects: [echo:write]\n  requires: [GameStore]\n  note: |\n    NO `key` — this operation does not exist at runtime. A game is constructed with `Game.make`\n    and placed with `space.addObject`; the UI route is the navtree's create action, which opens\n    the generic object form. An agent therefore cannot start a game through an operation, which is\n    what [QA-1] step 1 records.\n```\n\n```mdl\nop playEngineMove\n  key: org.dxos.operation.chess.play\n  desc: Uses the chess engine to play the next move for a side.\n  input:\n    game: Ref<Game>\n    side?: white | black | any\n  output: { pgn: string, move?: string }\n  effects: [echo:write]\n  requires: [Database.Service]\n```\n\n```mdl\nop submitMove\n  key: org.dxos.operation.chess.move\n  desc: Validates and applies a move, then persists the updated Game.\n  input:\n    game: Game\n    player: Player\n    move: Move\n  output: Game\n  errors:\n    WrongTurn: player is not the active side\n    IllegalMove: move violates chess rules\n    GameOver: game has already ended\n  effects: [echo:write]\n  requires: [ChessEngine, GameStore]\n  note: |\n    Composes validateMove → applyMove → GameStore.save.\n    Atomic: Game is not persisted if validation fails.\n```\n\n```mdl\nop resignGame\n  desc: Player forfeits; opponent wins.\n  input:\n    game: Game\n    player: Player\n  output: Game                  # Game.status === finished, Game.winner set\n  errors:\n    GameOver: game has already ended\n  effects: [echo:write]\n  requires: [GameStore]\n```\n\n## Features\n\n```mdl\nfeat F-1: Start Game\n\n  req F-1.1: New Board created with pieces in standard starting positions.\n  req F-1.2: White moves first.\n```\n\n```mdl\nfeat F-2: Make Move\n\n  req F-2.1:\n    when: player submits a Move on their turn\n    then: Move validated against chess rules\n    errors: [InvalidMove, WrongTurn, GameOver]\n\n  req F-2.2:\n    when: Move is valid\n    then: Board updated; turn advances to opponent\n\n  req F-2.3:\n    when: resulting position leaves opponent's king in check\n    then: Board.status set to check\n\n  req F-2.4:\n    when: no legal moves remain for the side to move\n    then: Board.status set to checkmate (if in check) or stalemate\n```\n\n```mdl\nfeat F-3: Lobby\n\n  req F-3.1: Player sees list of open games on entering the Lobby.\n  req F-3.2:\n    when: player creates a game\n    then: new Game created with status waiting; player assigned white\n\n  req F-3.3:\n    when: second player joins an open game\n    then: Game.status transitions to active; joining player assigned black\n\n  req F-3.4:\n    when: Game.status becomes active\n    then: both players navigated to Gameboard\n```\n\n```mdl\nfeat F-4: Gameboard\n\n  req F-4.1:\n    when: player selects a square containing their piece\n    then: legal move targets highlighted on board\n\n  req F-4.2:\n    when: player selects a highlighted target square\n    then: Move submitted via submitMove(); board updated on success\n\n  req F-4.3:\n    when: pawn reaches the back rank\n    then: promotion dialog shown via overlay slot; player selects piece kind\n\n  req F-4.4:\n    when: Game.status is finished\n    then: result overlay shown (winner or draw); further moves disabled\n```\n\n```mdl\nfeat F-5: Move Validation\n\n  req F-5.1:\n    when: Gameboard calls submitMove\n    then: op:validateMove runs before any state change\n\n  req F-5.2:\n    when: validation fails\n    then: error returned to caller; Game state unchanged\n\n  req F-5.3:\n    when: square is selected on Gameboard\n    then: op:getLegalMoves called; results drive component:Gameboard.highlights\n```\n\n```mdl\nfeat F-6: Game Persistence\n\n  req F-6.1:\n    when: op:startGame completes\n    then: Game written to ECHO and visible in component:Lobby game list\n\n  req F-6.2:\n    when: op:submitMove completes\n    then: updated Game replicated to all peers via ECHO\n\n  req F-6.3:\n    when: peer receives a Game update\n    then: component:Gameboard re-renders with new Board state\n    tags: [collaborative]\n```\n\n## Acceptance\n\n```mdl\ntest T-1: New game starting position\n  given: a new game is started\n  then:\n    - Board.turn === white\n    - Board.status === playing\n    - each player has 16 pieces in standard positions\n```\n\n```mdl\ntest T-2: Illegal move rejected\n  given: it is white's turn\n  when: white attempts to move a black piece\n  then: WrongTurn error; Board unchanged\n```\n\n```mdl\ntest T-3: Create and join game\n  given: two players are in the Lobby\n  when: player A creates a game, player B joins it\n  then:\n    - Game.status === active\n    - Game.players[0].color === white   # creator\n    - Game.players[1].color === black   # joiner\n    - both players see the Gameboard\n```\n\n```mdl\ntest T-4: Legal move highlight\n  given: Gameboard is shown, it is white's turn\n  when: white selects the e2 pawn\n  then:\n    - squares e3 and e4 are highlighted\n    - no other squares are highlighted\n```\n\n```mdl\ntest T-5: Pawn promotion\n  given: white pawn is on e7, it is white's turn\n  when: white moves pawn to e8\n  then:\n    - promotion overlay appears\n    - after player selects queen, Move recorded with promotion: queen\n    - board shows white queen on e8\n```\n\n```mdl\ntest T-6: Submit valid move\n  given: active game, white's turn, white player logged in\n  when: white submits pawn e2→e4\n  then:\n    - op:validateMove returns move without error\n    - Board updated: e4 occupied by white pawn, e2 empty\n    - Game.board.turn === black\n    - Game persisted to ECHO\n```\n\n```mdl\ntest T-7: Submit invalid move rejected atomically\n  given: active game, white's turn\n  when: white submits an illegal move (e2→e5)\n  then:\n    - IllegalMove error returned\n    - Game.board unchanged\n    - no ECHO write occurs\n```\n\n```mdl\ntest T-8: Legal moves highlighted\n  given: new game, white's turn, Gameboard shown\n  when: player selects e2\n  then:\n    - op:getLegalMoves returns [e3, e4]\n    - Gameboard.highlights === [e3, e4]\n```\n\n\n## QA\n\nExecutable flows. Each step carries a human instruction (`do`) and, where the step maps to an\ninvocable operation, an agent binding (`invoke`). Report failures by flow and step number.\n\n```mdl\nflow QA-1: Start a game and play the opening\n  desc: The core chess round-trip — create a game, play the first few moves, read the position back.\n  actors: human\n  covers: [F-1.1, F-2.1]\n  status: passing            # 2026-08-23; step 1 performed by a human (no create operation exists)\n  given:\n    - an identity exists\n    - space: a space is open\n    - collection: a collection in that space, to create into\n    - plugin-chess is enabled — it is OFF by default, and no chess operation is registered until\n      it is on. Enabling is a UI action (Settings -> plugin registry); `manager.enable()` returns\n      without error from the debug port and does not enable it.\n    - no game named \"QA Game\" exists — ABORT rather than deleting one this flow did not create\n  test:\n    - name: Create the game\n      do: In the navtree, click + on a collection and choose Chess. Name it \"QA Game\".\n      expect: a Game appears under the collection with pieces in their starting positions, white to move\n      note: |\n        NO `invoke` — [op:startGame] has no runtime counterpart (see its note), so this step is\n        human-only and the flow is `actors: human` until chess gains a create operation. That is\n        the finding, not an omission.\n    - name: Play 1. e4\n      do: Drag the e2 pawn to e4.\n      invoke: [op:submitMove] { game: $given.game, move: \"e4\" }\n      capture: afterE4\n      expect: the pawn stands on e4, the move list reads \"1. e4\", and it is black's turn\n      assert: return $result.pgn.includes('1. e4');\n    - name: Play 1... e5\n      do: Drag the black e7 pawn to e5.\n      invoke: [op:submitMove] { game: $given.game, move: \"e5\" }\n      expect: the move list reads \"1. e4 e5\" and it is white's turn again\n      assert: return $result.pgn.includes('e5');\n    - name: Play 2. Nf3\n      do: Drag the g1 knight to f3.\n      invoke: [op:submitMove] { game: $given.game, move: \"Nf3\" }\n      expect: the knight stands on f3 and the move list reads \"1. e4 e5 2. Nf3\"\n      assert: return $result.pgn.includes('Nf3');\n    - name: Reject an illegal move\n      do: Try to drag the a8 rook two squares up the a-file, onto a6 — its own pawn is in the way.\n      invoke: [op:submitMove] { game: $given.game, move: \"Ra6\" }\n      expect: the move is refused, the board is unchanged, and the game reports an invalid move\n      assert: |\n        // Passes when the invocation FAILS — an accepted illegal move is the defect.\n        return /Invalid move/.test($error?.message ?? '');\n      note: |\n        SAN is side-relative, so the move in `do` and the move in `invoke` must denote the same one.\n        This step first read \"drag the f3 knight to f6\" against `Nf6`, which after 1. e4 e5 2. Nf3 is\n        BLACK's knight and perfectly legal (Petrov) — the human and agent paths described different\n        moves and the step failed against a correct engine.\n  after:\n    - name: Delete the game\n      do: Right-click \"QA Game\" in the navtree and choose Delete.\n      invoke: org.dxos.operation.space.removeObjects { objects: [$given.game], target: $given.collection }\n      expect: the row leaves the navtree and its plank closes\n```\n\n---\n\n## Appendix: Extension Definitions\n\nExtension block types used in this document are defined below using\nthe core `ext` primitive — the only construct the base language provides.\n\n```mdl\next type\n  uri: dxos.spec/ext/type@1.0\n  desc: A named data structure with typed fields and optional literals.\n  fields:\n    desc?: Prose\n    fields?: FieldMap        # name[?]: TypeExpr  (# inline comment)\n    literals?: UnionList     # a | b | c\n    extends?: TypeRef[]\n```\n\n```mdl\next feat\n  uri: dxos.spec/ext/feat@1.0\n  desc: A named feature grouping one or more requirements.\n  fields:\n    desc?: Prose\n    req: RequirementList\n  nesting: self              # feat blocks may contain feat blocks\n```\n\n```mdl\next test\n  uri: dxos.spec/ext/test@1.0\n  desc: An acceptance scenario expressed as given / when / then steps.\n  fields:\n    given?: Step | Step[]\n    when?: Step | Step[]\n    then: Step | Step[]\n    tags?: TagList\n```\n\n```mdl\next component\n  uri: org.dxos.mdl.component@1.0\n  desc: A UI component with props, internal state, slots, actions, and events.\n  fields:\n    desc?: Prose\n    props?: FieldMap            # external inputs (immutable inside component)\n    state?: FieldMap            # internal reactive state\n    slots?: FieldMap            # named ReactNode injection points\n    actions?: ActionMap         # methods the component exposes or handles\n    emits?: EventMap            # events the component raises to its parent\n    layout?: CodeBlock          # ASCII sketch of visual structure (non-normative)\n```\n\n```mdl\next op\n  uri: org.dxos.mdl.op@1.0\n  desc: |\n    A named operation with typed inputs, outputs, and declared errors.\n    Pure ops have no effects or requires. Effectful ops declare both.\n  fields:\n    desc?: Prose\n    input?: FieldMap            # named input parameters\n    output?: TypeExpr           # return type\n    errors?: ErrorMap           # name: Prose  (when this error occurs)\n    effects?: EffectList        # echo:read | echo:write | http | fs | ...\n    requires?: ServiceList      # injected service dependencies\n    note?: Prose                # implementation guidance (non-normative)\n```\n\n```mdl\next service\n  uri: org.dxos.mdl.service@1.0\n  desc: An external or system-level dependency providing named operations.\n  fields:\n    desc?: Prose\n    loading?: eager | lazy\n    ops?: OpMap                 # name(params) → ReturnType\n    errors?: ErrorMap\n    note?: Prose\n```\n";
-//#endregion
 //#region src/capabilities/index.ts
 var Schema = AppCapability.schema(() => import("./chunk-schema.mjs"));
-var SkillDefinition = AppCapability.skillDefinition(() => import("./chunk-skill-definition.mjs"), { environments: ["node"] });
+var SkillDefinition = AppCapability.skillDefinition(() => import("./chunk-skill-definition.mjs"), { environments: [
+	"browser",
+	"node",
+	"tauri"
+] });
 var GameVariant = Capability.lazyModule("GameVariant", {
 	provides: [GameCapabilities.VariantProvider],
 	activatesOn: GameEvents.Start,
-	environments: []
+	environments: ["browser", "tauri"]
 }, () => import("./chunk-game-variant.mjs"));
 var OperationHandler = AppCapability.operationHandler(() => import("./chunk-operation-handler.mjs"), { activatesOn: ActivationEvents.Idle });
 var PluginAsset = AppCapability.pluginAsset({

package/dist/lib/capabilities.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"capabilities.mjs","names":[],"sources":["../../src/capabilities/index.ts"],"sourcesContent":["//\n// Copyright 2025 DXOS.org\n//\n\nimport * as ActivationEvents from '@dxos/app-framework/ActivationEvents';\nimport * as Capability from '@dxos/app-framework/Capability';\nimport * as AppCapability from '@dxos/app-toolkit/AppCapability';\nimport * as GameCapabilities from '@dxos/plugin-game/GameCapabilities';\nimport * as GameEvents from '@dxos/plugin-game/GameEvents';\n\nimport { meta } from '#meta';\nimport { translations } from '#translations';\n\n// eslint-disable-next-line import/no-relative-packages\nimport pluginSpec from '../../PLUGIN.mdl?raw';\n\nexport const Schema = AppCapability.schema(() => import('./schema'));\nexport const SkillDefinition = AppCapability.skillDefinition(() => import('./skill-definition'), {\n  environments: ['node'],\n});\n// Browser-only: the variant descriptor carries the `card`/`article` React components the game\n// host renders, so the module cannot load without a DOM.\nexport const GameVariant = Capability.lazyModule(\n  'GameVariant',\n  { provides: [GameCapabilities.VariantProvider], activatesOn: GameEvents.Start, environments: [] },\n  () => import('./game-variant'),\n);\nexport const OperationHandler = AppCapability.operationHandler(() => import('./operation-handler'), {\n  activatesOn: ActivationEvents.Idle,\n});\nexport const PluginAsset = AppCapability.pluginAsset({\n  pluginId: meta.profile.key,\n  path: 'PLUGIN.mdl',\n  content: pluginSpec,\n  mimeType: 'application/x-mdl',\n});\nexport const Translations = AppCapability.translations(translations);\n"],"mappings":";;;;;;;;;;;AAgBA,IAAa,SAAS,cAAc,aAAa,OAAO,qBAAW;AACnE,IAAa,kBAAkB,cAAc,sBAAsB,OAAO,iCAAuB,EAC/F,cAAc,CAAC,MAAM,EACvB,CAAC;AAGD,IAAa,cAAc,WAAW,WACpC,eACA;CAAE,UAAU,CAAC,iBAAiB,eAAe;CAAG,aAAa,WAAW;CAAO,cAAc,CAAC;AAAE,SAC1F,OAAO,2BACf;AACA,IAAa,mBAAmB,cAAc,uBAAuB,OAAO,kCAAwB,EAClG,aAAa,iBAAiB,KAChC,CAAC;AACD,IAAa,cAAc,cAAc,YAAY;CACnD,UAAU,KAAK,QAAQ;CACvB,MAAM;CACN,SAAS;CACT,UAAU;AACZ,CAAC;AACD,IAAa,eAAe,cAAc,aAAa,YAAY"}
+{"version":3,"file":"capabilities.mjs","names":[],"sources":["../../src/capabilities/index.ts"],"sourcesContent":["//\n// Copyright 2025 DXOS.org\n//\n\nimport * as ActivationEvents from '@dxos/app-framework/ActivationEvents';\nimport * as Capability from '@dxos/app-framework/Capability';\nimport * as AppCapability from '@dxos/app-toolkit/AppCapability';\nimport * as GameCapabilities from '@dxos/plugin-game/GameCapabilities';\nimport * as GameEvents from '@dxos/plugin-game/GameEvents';\n\nimport { meta } from '#meta';\nimport { translations } from '#translations';\n\n// eslint-disable-next-line import/no-relative-packages\nimport pluginSpec from '../../PLUGIN.mdl?raw';\n\nexport const Schema = AppCapability.schema(() => import('./schema.ts'));\nexport const SkillDefinition = AppCapability.skillDefinition(() => import('./skill-definition.ts'), {\n  environments: ['browser', 'node', 'tauri'],\n});\n// Browser-only: the variant descriptor carries the `card`/`article` React components the game\n// host renders, so the module cannot load without a DOM.\nexport const GameVariant = Capability.lazyModule(\n  'GameVariant',\n  { provides: [GameCapabilities.VariantProvider], activatesOn: GameEvents.Start, environments: ['browser', 'tauri'] },\n  () => import('./game-variant.ts'),\n);\nexport const OperationHandler = AppCapability.operationHandler(() => import('./operation-handler.ts'), {\n  activatesOn: ActivationEvents.Idle,\n});\nexport const PluginAsset = AppCapability.pluginAsset({\n  pluginId: meta.profile.key,\n  path: 'PLUGIN.mdl',\n  content: pluginSpec,\n  mimeType: 'application/x-mdl',\n});\nexport const Translations = AppCapability.translations(translations);\n"],"mappings":";;;;;;;;;AAgBA,IAAa,SAAS,cAAc,aAAa,OAAO,qBAAc;AACtE,IAAa,kBAAkB,cAAc,sBAAsB,OAAO,iCAA0B,EAClG,cAAc;CAAC;CAAW;CAAQ;AAAO,EAC3C,CAAC;AAGD,IAAa,cAAc,WAAW,WACpC,eACA;CAAE,UAAU,CAAC,iBAAiB,eAAe;CAAG,aAAa,WAAW;CAAO,cAAc,CAAC,WAAW,OAAO;AAAE,SAC5G,OAAO,2BACf;AACA,IAAa,mBAAmB,cAAc,uBAAuB,OAAO,kCAA2B,EACrG,aAAa,iBAAiB,KAChC,CAAC;AACD,IAAa,cAAc,cAAc,YAAY;CACnD,UAAU,KAAK,QAAQ;CACvB,MAAM;CACN,SAAS;CACT,UAAU;AACZ,CAAC;AACD,IAAa,eAAe,cAAc,aAAa,YAAY"}

package/dist/lib/capabilities.node.mjs

@@ -3,7 +3,11 @@ import * as AppCapability from "@dxos/app-toolkit/AppCapability";
 import { translations } from "#translations";
 //#region src/capabilities/gen/node.ts
 var Schema = AppCapability.schema(() => import("./chunk-schema.mjs"));
-var SkillDefinition = AppCapability.skillDefinition(() => import("./chunk-skill-definition.mjs"), { environments: ["node"] });
+var SkillDefinition = AppCapability.skillDefinition(() => import("./chunk-skill-definition.mjs"), { environments: [
+	"browser",
+	"node",
+	"tauri"
+] });
 var OperationHandler = AppCapability.operationHandler(() => import("./chunk-operation-handler.mjs"), { activatesOn: ActivationEvents.Idle });
 var Translations = AppCapability.translations(translations);
 var GameVariant = void 0;

package/dist/lib/capabilities.node.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"capabilities.node.mjs","names":[],"sources":["../../src/capabilities/gen/node.ts"],"sourcesContent":["//\n// Copyright 2026 DXOS.org\n//\n\n// GENERATED by dx-plugin — do not edit. Sliced from ../index.ts for the 'node' condition.\n\nimport * as ActivationEvents from '@dxos/app-framework/ActivationEvents';\nimport * as AppCapability from '@dxos/app-toolkit/AppCapability';\n\nimport { translations } from '#translations';\n\nexport const Schema = AppCapability.schema(() => import('../schema'));\n\nexport const SkillDefinition = AppCapability.skillDefinition(() => import('../skill-definition'), {\n  environments: ['node'],\n});\n\nexport const OperationHandler = AppCapability.operationHandler(() => import('../operation-handler'), {\n  activatesOn: ActivationEvents.Idle,\n});\n\nexport const Translations = AppCapability.translations(translations);\n\nexport const GameVariant = undefined;\nexport const PluginAsset = undefined;\n"],"mappings":";;;;AAWA,IAAa,SAAS,cAAc,aAAa,OAAO,qBAAY;AAEpE,IAAa,kBAAkB,cAAc,sBAAsB,OAAO,iCAAwB,EAChG,cAAc,CAAC,MAAM,EACvB,CAAC;AAED,IAAa,mBAAmB,cAAc,uBAAuB,OAAO,kCAAyB,EACnG,aAAa,iBAAiB,KAChC,CAAC;AAED,IAAa,eAAe,cAAc,aAAa,YAAY;AAEnE,IAAa,cAAc,KAAA;AAC3B,IAAa,cAAc,KAAA"}
+{"version":3,"file":"capabilities.node.mjs","names":[],"sources":["../../src/capabilities/gen/node.ts"],"sourcesContent":["//\n// Copyright 2026 DXOS.org\n//\n\n// GENERATED by dx-plugin — do not edit. Sliced from ../index.ts for the 'node' condition.\n\nimport * as ActivationEvents from '@dxos/app-framework/ActivationEvents';\nimport * as AppCapability from '@dxos/app-toolkit/AppCapability';\n\nimport { translations } from '#translations';\n\nexport const Schema = AppCapability.schema(() => import('../schema.ts'));\n\nexport const SkillDefinition = AppCapability.skillDefinition(() => import('../skill-definition.ts'), {\n  environments: ['browser', 'node', 'tauri'],\n});\n\nexport const OperationHandler = AppCapability.operationHandler(() => import('../operation-handler.ts'), {\n  activatesOn: ActivationEvents.Idle,\n});\n\nexport const Translations = AppCapability.translations(translations);\n\nexport const GameVariant = undefined;\nexport const PluginAsset = undefined;\n"],"mappings":";;;;AAWA,IAAa,SAAS,cAAc,aAAa,OAAO,qBAAe;AAEvE,IAAa,kBAAkB,cAAc,sBAAsB,OAAO,iCAA2B,EACnG,cAAc;CAAC;CAAW;CAAQ;AAAO,EAC3C,CAAC;AAED,IAAa,mBAAmB,cAAc,uBAAuB,OAAO,kCAA4B,EACtG,aAAa,iBAAiB,KAChC,CAAC;AAED,IAAa,eAAe,cAAc,aAAa,YAAY;AAEnE,IAAa,cAAc,KAAA;AAC3B,IAAa,cAAc,KAAA"}

package/dist/lib/capabilities.tauri.mjs

@@ -0,0 +1,32 @@
+import { t as PLUGIN_default } from "./chunk-PLUGIN.mjs";
+import * as ActivationEvents from "@dxos/app-framework/ActivationEvents";
+import * as AppCapability from "@dxos/app-toolkit/AppCapability";
+import { translations } from "#translations";
+import * as Capability from "@dxos/app-framework/Capability";
+import * as GameCapabilities from "@dxos/plugin-game/GameCapabilities";
+import * as GameEvents from "@dxos/plugin-game/GameEvents";
+import { meta } from "#meta";
+//#region src/capabilities/gen/tauri.ts
+var Schema = AppCapability.schema(() => import("./chunk-schema.mjs"));
+var SkillDefinition = AppCapability.skillDefinition(() => import("./chunk-skill-definition.mjs"), { environments: [
+	"browser",
+	"node",
+	"tauri"
+] });
+var GameVariant = Capability.lazyModule("GameVariant", {
+	provides: [GameCapabilities.VariantProvider],
+	activatesOn: GameEvents.Start,
+	environments: ["browser", "tauri"]
+}, () => import("./chunk-game-variant.mjs"));
+var OperationHandler = AppCapability.operationHandler(() => import("./chunk-operation-handler.mjs"), { activatesOn: ActivationEvents.Idle });
+var PluginAsset = AppCapability.pluginAsset({
+	pluginId: meta.profile.key,
+	path: "PLUGIN.mdl",
+	content: PLUGIN_default,
+	mimeType: "application/x-mdl"
+});
+var Translations = AppCapability.translations(translations);
+//#endregion
+export { GameVariant, OperationHandler, PluginAsset, Schema, SkillDefinition, Translations };
+
+//# sourceMappingURL=capabilities.tauri.mjs.map

package/dist/lib/capabilities.tauri.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"capabilities.tauri.mjs","names":[],"sources":["../../src/capabilities/gen/tauri.ts"],"sourcesContent":["//\n// Copyright 2026 DXOS.org\n//\n\n// GENERATED by dx-plugin — do not edit. Sliced from ../index.ts for the 'tauri' condition.\n\nimport * as ActivationEvents from '@dxos/app-framework/ActivationEvents';\nimport * as Capability from '@dxos/app-framework/Capability';\nimport * as AppCapability from '@dxos/app-toolkit/AppCapability';\nimport * as GameCapabilities from '@dxos/plugin-game/GameCapabilities';\nimport * as GameEvents from '@dxos/plugin-game/GameEvents';\n\nimport { meta } from '#meta';\nimport { translations } from '#translations';\n\nimport pluginSpec from '../../../PLUGIN.mdl?raw';\n\nexport const Schema = AppCapability.schema(() => import('../schema.ts'));\n\nexport const SkillDefinition = AppCapability.skillDefinition(() => import('../skill-definition.ts'), {\n  environments: ['browser', 'node', 'tauri'],\n});\n\n// Browser-only: the variant descriptor carries the `card`/`article` React components the game\n// host renders, so the module cannot load without a DOM.\nexport const GameVariant = Capability.lazyModule(\n  'GameVariant',\n  { provides: [GameCapabilities.VariantProvider], activatesOn: GameEvents.Start, environments: ['browser', 'tauri'] },\n  () => import('../game-variant.ts'),\n);\n\nexport const OperationHandler = AppCapability.operationHandler(() => import('../operation-handler.ts'), {\n  activatesOn: ActivationEvents.Idle,\n});\n\nexport const PluginAsset = AppCapability.pluginAsset({\n  pluginId: meta.profile.key,\n  path: 'PLUGIN.mdl',\n  content: pluginSpec,\n  mimeType: 'application/x-mdl',\n});\n\nexport const Translations = AppCapability.translations(translations);\n"],"mappings":";;;;;;;;;AAiBA,IAAa,SAAS,cAAc,aAAa,OAAO,qBAAe;AAEvE,IAAa,kBAAkB,cAAc,sBAAsB,OAAO,iCAA2B,EACnG,cAAc;CAAC;CAAW;CAAQ;AAAO,EAC3C,CAAC;AAID,IAAa,cAAc,WAAW,WACpC,eACA;CAAE,UAAU,CAAC,iBAAiB,eAAe;CAAG,aAAa,WAAW;CAAO,cAAc,CAAC,WAAW,OAAO;AAAE,SAC5G,OAAO,2BACf;AAEA,IAAa,mBAAmB,cAAc,uBAAuB,OAAO,kCAA4B,EACtG,aAAa,iBAAiB,KAChC,CAAC;AAED,IAAa,cAAc,cAAc,YAAY;CACnD,UAAU,KAAK,QAAQ;CACvB,MAAM;CACN,SAAS;CACT,UAAU;AACZ,CAAC;AAED,IAAa,eAAe,cAAc,aAAa,YAAY"}

package/dist/lib/capabilities.workerd.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"capabilities.workerd.mjs","names":[],"sources":["../../src/capabilities/gen/workerd.ts"],"sourcesContent":["//\n// Copyright 2026 DXOS.org\n//\n\n// GENERATED by dx-plugin — do not edit. Sliced from ../index.ts for the 'workerd' condition.\n\nimport * as ActivationEvents from '@dxos/app-framework/ActivationEvents';\nimport * as AppCapability from '@dxos/app-toolkit/AppCapability';\n\nimport { translations } from '#translations';\n\nexport const Schema = AppCapability.schema(() => import('../schema'));\n\nexport const OperationHandler = AppCapability.operationHandler(() => import('../operation-handler'), {\n  activatesOn: ActivationEvents.Idle,\n});\n\nexport const Translations = AppCapability.translations(translations);\n\nexport const GameVariant = undefined;\nexport const PluginAsset = undefined;\nexport const SkillDefinition = undefined;\n"],"mappings":";;;;AAWA,IAAa,SAAS,cAAc,aAAa,OAAO,qBAAY;AAEpE,IAAa,mBAAmB,cAAc,uBAAuB,OAAO,kCAAyB,EACnG,aAAa,iBAAiB,KAChC,CAAC;AAED,IAAa,eAAe,cAAc,aAAa,YAAY;AAEnE,IAAa,cAAc,KAAA;AAC3B,IAAa,cAAc,KAAA;AAC3B,IAAa,kBAAkB,KAAA"}
+{"version":3,"file":"capabilities.workerd.mjs","names":[],"sources":["../../src/capabilities/gen/workerd.ts"],"sourcesContent":["//\n// Copyright 2026 DXOS.org\n//\n\n// GENERATED by dx-plugin — do not edit. Sliced from ../index.ts for the 'workerd' condition.\n\nimport * as ActivationEvents from '@dxos/app-framework/ActivationEvents';\nimport * as AppCapability from '@dxos/app-toolkit/AppCapability';\n\nimport { translations } from '#translations';\n\nexport const Schema = AppCapability.schema(() => import('../schema.ts'));\n\nexport const OperationHandler = AppCapability.operationHandler(() => import('../operation-handler.ts'), {\n  activatesOn: ActivationEvents.Idle,\n});\n\nexport const Translations = AppCapability.translations(translations);\n\nexport const GameVariant = undefined;\nexport const PluginAsset = undefined;\nexport const SkillDefinition = undefined;\n"],"mappings":";;;;AAWA,IAAa,SAAS,cAAc,aAAa,OAAO,qBAAe;AAEvE,IAAa,mBAAmB,cAAc,uBAAuB,OAAO,kCAA4B,EACtG,aAAa,iBAAiB,KAChC,CAAC;AAED,IAAa,eAAe,cAAc,aAAa,YAAY;AAEnE,IAAa,cAAc,KAAA;AAC3B,IAAa,cAAc,KAAA;AAC3B,IAAa,kBAAkB,KAAA"}

package/dist/lib/chunk-ChessArticle.mjs

@@ -2,16 +2,19 @@ import { meta } from "#meta";
 import { Chess } from "#types";
 import { useCallback, useRef, useState } from "react";
 import { useObject } from "@dxos/echo-react";
-import { Panel, Toolbar, useTranslation } from "@dxos/react-ui";
+import * as Button from "@dxos/react-ui/Button";
+import * as Hooks from "@dxos/react-ui/Hooks";
 import { mx } from "@dxos/ui-theme";
 import { jsx, jsxs } from "react/jsx-runtime";
 import { Obj } from "@dxos/echo";
 import { Chess as Chess$1 } from "chess.js";
-import { AppSurface } from "@dxos/app-toolkit/ui";
+import * as AppSurface from "@dxos/app-toolkit/AppSurface";
+import * as Panel from "@dxos/react-ui/Panel";
+import * as Toolbar from "@dxos/react-ui/Toolbar";
 import { Chessboard } from "#components";
 //#region src/containers/ChessArticle/ChessArticle.tsx
 var ChessArticle = ({ role, variant }) => {
-	const { t } = useTranslation(meta.profile.key);
+	const { t } = Hooks.useTranslation(meta.profile.key);
 	const [orientation, setOrientation] = useState("white");
 	const [showInfo, setShowInfo] = useState(true);
 	const controller = useRef(null);
@@ -46,24 +49,21 @@ var ChessArticle = ({ role, variant }) => {
 		children: /* @__PURE__ */ jsxs(Panel.Root, {
 			role,
 			classNames: "@container",
-			children: [/* @__PURE__ */ jsx(Panel.Toolbar, {
-				asChild: true,
-				children: /* @__PURE__ */ jsxs(Toolbar.Root, { children: [
-					isGameOver && /* @__PURE__ */ jsx(Toolbar.Button, {
-						onClick: handleNewGame,
-						children: t("new-game.button")
-					}),
-					/* @__PURE__ */ jsx("div", { className: "grow" }),
-					/* @__PURE__ */ jsx(Toolbar.IconButton, {
-						icon: "ph--info--regular",
-						iconOnly: true,
-						label: t("toggle-info.button"),
-						classNames: mx("invisible @4xl:visible"),
-						onClick: () => setShowInfo((open) => !open)
-					})
-				] })
-			}), /* @__PURE__ */ jsx(Panel.Content, { children: /* @__PURE__ */ jsxs("div", {
-				className: mx("grid h-full w-full", showInfo && "@4xl:grid-cols-[1fr_320px] gap-8", role === AppSurface.Article.role && "p-4", role === AppSurface.Section.role && "aspect-square", role === AppSurface.Section.role && showInfo && "@4xl:aspect-auto"),
+			children: [role === AppSurface.Article.role && /* @__PURE__ */ jsx(Panel.Header, { children: /* @__PURE__ */ jsxs(Toolbar.Root, { children: [
+				isGameOver && /* @__PURE__ */ jsx(Button.Root, {
+					onClick: handleNewGame,
+					children: t("new-game.button")
+				}),
+				/* @__PURE__ */ jsx("div", { className: "grow" }),
+				/* @__PURE__ */ jsx(Button.Root, {
+					icon: "ph--info--regular",
+					iconOnly: true,
+					label: t("toggle-info.button"),
+					classNames: mx("invisible @4xl:visible"),
+					onClick: () => setShowInfo((open) => !open)
+				})
+			] }) }), /* @__PURE__ */ jsx(Panel.Body, { children: /* @__PURE__ */ jsxs("div", {
+				className: mx("grid dx-fill", showInfo && "@4xl:grid-cols-[1fr_320px] gap-8", role === AppSurface.Article.role && "p-4", role === AppSurface.Section.role && "aspect-square w-full max-h-full min-h-0", role === AppSurface.Section.role && showInfo && "@4xl:aspect-auto"),
 				children: [/* @__PURE__ */ jsx(Chessboard.Content, { children: /* @__PURE__ */ jsx(Chessboard.Board, {
 					classNames: "border rounded-xs",
 					orientation
@@ -74,7 +74,7 @@ var ChessArticle = ({ role, variant }) => {
 						min: 8,
 						max: 8,
 						onOrientationChange: setOrientation,
-						onClose: () => setShowInfo(false),
+						onClose: role === AppSurface.Article.role ? () => setShowInfo(false) : void 0,
 						onSelect: handleSelect
 					})
 				})]