@dxos/plugin-chess 0.11.0 → 0.12.0-next-bbabc02363f18d7643ea4160e3a7a7809870fd0d

package/dist/lib/Chess.mjs

@@ -0,0 +1,47 @@
+import { t as __exportAll } from "./chunk-rolldown-runtime.mjs";
+import { Chess } from "chess.js";
+import * as Schema from "effect/Schema";
+import * as AppAnnotation from "@dxos/app-toolkit/AppAnnotation";
+import { Annotation, DXN, Obj, Type } from "@dxos/echo";
+import { FormInputAnnotation, HiddenAnnotation } from "@dxos/echo/Annotation";
+import { log } from "@dxos/log";
+//#region src/types/Chess.ts
+var Chess_exports = /* @__PURE__ */ __exportAll({
+	SKILL_KEY: () => SKILL_KEY,
+	State: () => State,
+	make: () => make
+});
+var __dxlog_file = "/__w/dxos/dxos/packages/plugins/plugin-chess/src/types/Chess.ts";
+var SKILL_KEY = "org.dxos.skill.chess";
+/**
+* Chess variant state. Referenced by the base `Game` object via `Game.variant`.
+* 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.annotations({ description: "Portable Game Notation." }).pipe(FormInputAnnotation.set(false), Schema.optional),
+	fen: Schema.String.annotations({ description: "Forsyth-Edwards Notation." }).pipe(FormInputAnnotation.set(false), Schema.optional)
+}).pipe(Annotation.IconAnnotation.set({
+	icon: "ph--shield-chevron--regular",
+	hue: "amber"
+}), AppAnnotation.SkillsAnnotation.set([SKILL_KEY]), HiddenAnnotation.set(true))) {};
+var make = ({ pgn, fen } = {}) => {
+	const chess = new Chess();
+	if (pgn) try {
+		chess.loadPgn(pgn);
+	} catch {
+		log.warn(pgn, void 0, {
+			"~LogMeta": "~LogMeta",
+			F: __dxlog_file,
+			L: 44,
+			S: void 0
+		});
+	}
+	return Obj.make(State, {
+		pgn,
+		fen
+	});
+};
+//#endregion
+export { SKILL_KEY, State, make, Chess_exports as t };
+
+//# sourceMappingURL=Chess.mjs.map

package/dist/lib/Chess.mjs.map

@@ -0,0 +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 AppAnnotation from '@dxos/app-toolkit/AppAnnotation';\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.annotations({\n      description: 'Portable Game Notation.',\n    }).pipe(FormInputAnnotation.set(false), Schema.optional),\n    fen: Schema.String.annotations({\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    AppAnnotation.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,YAAY,EAC7B,aAAa,0BACf,CAAC,CAAC,CAAC,KAAK,oBAAoB,IAAI,KAAK,GAAG,OAAO,QAAQ;CACvD,KAAK,OAAO,OAAO,YAAY,EAC7B,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,cAAc,iBAAiB,IAAI,CAAC,SAAS,CAAC,GAK9C,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"}

package/dist/lib/ChessEvents.mjs

@@ -0,0 +1,15 @@
+import { t as __exportAll } from "./chunk-rolldown-runtime.mjs";
+import * as ActivationEvent from "@dxos/app-framework/ActivationEvent";
+import { meta } from "#meta";
+//#region src/types/ChessEvents.ts
+var ChessEvents_exports = /* @__PURE__ */ __exportAll({ Start: () => Start });
+/**
+* The feature's start event: the plugin's start-gated modules (and cross-plugin
+* contributions consumed by this feature) activate here. Fired on demand and by the
+* host's idle trickle.
+*/
+var Start = ActivationEvent.pluginStart(meta.profile.key);
+//#endregion
+export { Start, ChessEvents_exports as t };
+
+//# sourceMappingURL=ChessEvents.mjs.map

package/dist/lib/ChessEvents.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"ChessEvents.mjs","names":[],"sources":["../../src/types/ChessEvents.ts"],"sourcesContent":["//\n// Copyright 2026 DXOS.org\n//\n\n// @import-as-namespace\n\nimport * as ActivationEvent from '@dxos/app-framework/ActivationEvent';\n\nimport { meta } from '#meta';\n\n/**\n * The feature's start event: the plugin's start-gated modules (and cross-plugin\n * contributions consumed by this feature) activate here. Fired on demand and by the\n * host's idle trickle.\n */\nexport const Start = ActivationEvent.pluginStart(meta.profile.key);\n"],"mappings":";;;;;;;;;;AAeA,IAAa,QAAQ,gBAAgB,YAAY,KAAK,QAAQ,GAAG"}

package/dist/lib/ChessOperation.mjs

@@ -0,0 +1,83 @@
+import { t as __exportAll } from "./chunk-rolldown-runtime.mjs";
+import { State } from "./Chess.mjs";
+import { Review } from "./PlayerReview.mjs";
+import * as Schema from "effect/Schema";
+import { DXN, Database, Ref } from "@dxos/echo";
+import * as Operation from "@dxos/compute/Operation";
+import * as Game from "@dxos/plugin-game/Game";
+//#region src/types/ChessOperation.ts
+var ChessOperation_exports = /* @__PURE__ */ __exportAll({
+	Move: () => Move,
+	Play: () => Play,
+	Print: () => Print,
+	RebuildPositionIndex: () => RebuildPositionIndex
+});
+var Move = Operation.make({
+	meta: {
+		key: DXN.make("org.dxos.function.chess.move"),
+		name: "Move",
+		description: "Makes a move in the given chess game.",
+		icon: "ph--play--regular"
+	},
+	input: Schema.Struct({
+		game: Game.GameRef(State).annotations({ description: "The ID of the game object (variant must be Chess)." }),
+		move: Schema.String.annotations({
+			description: "The move to make in the chess game.",
+			examples: ["e4", "Bf3"]
+		})
+	}),
+	output: Schema.Struct({ pgn: Schema.String.annotations({ description: "The PGN of the game after the move was played." }) }),
+	services: [Database.Service]
+});
+var Play = Operation.make({
+	meta: {
+		key: DXN.make("org.dxos.function.chess.play"),
+		name: "Play",
+		description: "Uses the chess engine to play the next move.",
+		icon: "ph--play--regular"
+	},
+	input: Schema.Struct({
+		game: Game.GameRef(State).annotations({ description: "The ID of the game object (variant must be Chess)." }),
+		side: Schema.optional(Schema.Literal("white", "black", "any")).annotations({
+			description: "The side to play.",
+			defaultValue: "any"
+		})
+	}),
+	output: Schema.Struct({
+		pgn: Schema.String.annotations({ description: "The PGN of the game after the move was played." }),
+		move: Schema.optional(Schema.String).annotations({ description: "The move that was played." })
+	}),
+	services: [Database.Service]
+});
+var Print = Operation.make({
+	meta: {
+		key: DXN.make("org.dxos.function.chess.print"),
+		name: "Print game",
+		description: "Prints the chess game to ASCII.",
+		icon: "ph--clipboard-text--regular"
+	},
+	input: Schema.Struct({
+		pgn: Schema.optional(Schema.String.annotations({ description: "Portable Game Notation." })),
+		fen: Schema.optional(Schema.String.annotations({ description: "Forsyth-Edwards Notation." }))
+	}),
+	output: Schema.Struct({ ascii: Schema.String })
+});
+/** Rebuilds a player review position index from all chess games in the space. */
+var RebuildPositionIndex = Operation.make({
+	meta: {
+		key: DXN.make("org.dxos.plugin.chess.operation.rebuildPositionIndex"),
+		name: "Rebuild Position Index",
+		description: "Scans chess games and updates the player review position index.",
+		icon: "ph--arrows-clockwise--regular"
+	},
+	services: [Database.Service],
+	input: Schema.Struct({ review: Ref.Ref(Review).annotations({ description: "Player review whose position index should be rebuilt." }) }),
+	output: Schema.Struct({
+		gamesScanned: Schema.Number,
+		positionsUpdated: Schema.Number
+	})
+}).pipe(Operation.visible);
+//#endregion
+export { Move, Play, Print, RebuildPositionIndex, ChessOperation_exports as t };
+
+//# sourceMappingURL=ChessOperation.mjs.map

package/dist/lib/ChessOperation.mjs.map

@@ -0,0 +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.function.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).annotations({\n      description: 'The ID of the game object (variant must be Chess).',\n    }),\n    move: Schema.String.annotations({\n      description: 'The move to make in the chess game.',\n      examples: ['e4', 'Bf3'],\n    }),\n  }),\n  output: Schema.Struct({\n    pgn: Schema.String.annotations({\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.function.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).annotations({\n      description: 'The ID of the game object (variant must be Chess).',\n    }),\n    side: Schema.optional(Schema.Literal('white', 'black', 'any')).annotations({\n      description: 'The side to play.',\n      defaultValue: 'any',\n    }),\n  }),\n  output: Schema.Struct({\n    pgn: Schema.String.annotations({\n      description: 'The PGN of the game after the move was played.',\n    }),\n    move: Schema.optional(Schema.String).annotations({\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.function.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.annotations({\n        description: 'Portable Game Notation.',\n      }),\n    ),\n    fen: Schema.optional(\n      Schema.String.annotations({\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.plugin.chess.operation.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).annotations({\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,8BAA8B;EAC5C,MAAM;EACN,aAAa;EACb,MAAM;CACR;CACA,OAAO,OAAO,OAAO;EACnB,MAAM,KAAK,QAAQ,KAAW,CAAC,CAAC,YAAY,EAC1C,aAAa,qDACf,CAAC;EACD,MAAM,OAAO,OAAO,YAAY;GAC9B,aAAa;GACb,UAAU,CAAC,MAAM,KAAK;EACxB,CAAC;CACH,CAAC;CACD,QAAQ,OAAO,OAAO,EACpB,KAAK,OAAO,OAAO,YAAY,EAC7B,aAAa,iDACf,CAAC,EACH,CAAC;CACD,UAAU,CAAC,SAAS,OAAO;AAC7B,CAAC;AAED,IAAa,OAAO,UAAU,KAAK;CACjC,MAAM;EACJ,KAAK,IAAI,KAAK,8BAA8B;EAC5C,MAAM;EACN,aAAa;EACb,MAAM;CACR;CACA,OAAO,OAAO,OAAO;EACnB,MAAM,KAAK,QAAQ,KAAW,CAAC,CAAC,YAAY,EAC1C,aAAa,qDACf,CAAC;EACD,MAAM,OAAO,SAAS,OAAO,QAAQ,SAAS,SAAS,KAAK,CAAC,CAAC,CAAC,YAAY;GACzE,aAAa;GACb,cAAc;EAChB,CAAC;CACH,CAAC;CACD,QAAQ,OAAO,OAAO;EACpB,KAAK,OAAO,OAAO,YAAY,EAC7B,aAAa,iDACf,CAAC;EACD,MAAM,OAAO,SAAS,OAAO,MAAM,CAAC,CAAC,YAAY,EAC/C,aAAa,4BACf,CAAC;CACH,CAAC;CACD,UAAU,CAAC,SAAS,OAAO;AAC7B,CAAC;AAED,IAAa,QAAQ,UAAU,KAAK;CAClC,MAAM;EACJ,KAAK,IAAI,KAAK,+BAA+B;EAC7C,MAAM;EACN,aAAa;EACb,MAAM;CACR;CACA,OAAO,OAAO,OAAO;EACnB,KAAK,OAAO,SACV,OAAO,OAAO,YAAY,EACxB,aAAa,0BACf,CAAC,CACH;EACA,KAAK,OAAO,SACV,OAAO,OAAO,YAAY,EACxB,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,sDAAsD;EACpE,MAAM;EACN,aAAa;EACb,MAAM;CACR;CACA,UAAU,CAAC,SAAS,OAAO;CAC3B,OAAO,OAAO,OAAO,EACnB,QAAQ,IAAI,IAAI,MAAmB,CAAC,CAAC,YAAY,EAC/C,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/ChessPlugin.node.mjs

@@ -1,18 +1,20 @@
-import { Chess, ChessPositionIndex, PlayerReview } from "#types";
-import { Plugin } from "@dxos/app-framework";
-import { AppPlugin } from "@dxos/app-toolkit";
-import { OperationHandler, SkillDefinition } from "#capabilities";
+import { State } from "./Chess.mjs";
+import { PositionIndex } from "./ChessPositionIndex.mjs";
+import { Review } from "./PlayerReview.mjs";
+import * as Plugin from "@dxos/app-framework/Plugin";
 import { meta } from "#meta";
+import * as AppCapability from "@dxos/app-toolkit/AppCapability";
+import { OperationHandler, SkillDefinition } from "#capabilities";
 //#region src/ChessPlugin.node.ts
 /**
 * Headless variant of ChessPlugin (no React surfaces / GameVariant).
 * Used in node contexts (CLI, agents) where rendering is unavailable.
 */
-var ChessPlugin = Plugin.define(meta).pipe(AppPlugin.addSchemaModule({ schema: [
-	Chess.State,
-	ChessPositionIndex.PositionIndex,
-	PlayerReview.Review
-] }), AppPlugin.addSkillDefinitionModule({ activate: SkillDefinition }), AppPlugin.addOperationHandlerModule({ activate: OperationHandler }), Plugin.make);
+var ChessPlugin = Plugin.define(meta).pipe(Plugin.addModule(AppCapability.schema([
+	State,
+	PositionIndex,
+	Review
+])), Plugin.addModule(SkillDefinition), Plugin.addModule(OperationHandler), Plugin.make);
 //#endregion
 export { ChessPlugin, ChessPlugin as default };
 

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

@@ -1 +1 @@
-{"version":3,"file":"ChessPlugin.node.mjs","names":[],"sources":["../../src/ChessPlugin.node.ts"],"sourcesContent":["//\n// Copyright 2026 DXOS.org\n//\n\nimport { Plugin } from '@dxos/app-framework';\nimport { AppPlugin } from '@dxos/app-toolkit';\n\nimport { OperationHandler, SkillDefinition } from '#capabilities';\nimport { meta } from '#meta';\nimport { Chess, ChessPositionIndex, PlayerReview } from '#types';\n\n/**\n * Headless variant of ChessPlugin (no React surfaces / GameVariant).\n * Used in node contexts (CLI, agents) where rendering is unavailable.\n */\nexport const ChessPlugin = Plugin.define(meta).pipe(\n  AppPlugin.addSchemaModule({ schema: [Chess.State, ChessPositionIndex.PositionIndex, PlayerReview.Review] }),\n  AppPlugin.addSkillDefinitionModule({ activate: SkillDefinition }),\n  AppPlugin.addOperationHandlerModule({ activate: OperationHandler }),\n  Plugin.make,\n);\n\nexport default ChessPlugin;\n"],"mappings":";;;;;;;;;;AAeA,IAAa,cAAc,OAAO,OAAO,IAAI,CAAC,CAAC,KAC7C,UAAU,gBAAgB,EAAE,QAAQ;CAAC,MAAM;CAAO,mBAAmB;CAAe,aAAa;AAAM,EAAE,CAAC,GAC1G,UAAU,yBAAyB,EAAE,UAAU,gBAAgB,CAAC,GAChE,UAAU,0BAA0B,EAAE,UAAU,iBAAiB,CAAC,GAClE,OAAO,IACT"}
+{"version":3,"file":"ChessPlugin.node.mjs","names":[],"sources":["../../src/ChessPlugin.node.ts"],"sourcesContent":["//\n// Copyright 2026 DXOS.org\n//\n\nimport * as Plugin from '@dxos/app-framework/Plugin';\nimport * as AppCapability from '@dxos/app-toolkit/AppCapability';\n\nimport { OperationHandler, SkillDefinition } from '#capabilities';\nimport { meta } from '#meta';\n\nimport * as Chess from './types/Chess';\nimport * as ChessPositionIndex from './types/ChessPositionIndex';\nimport * as PlayerReview from './types/PlayerReview';\n\n/**\n * Headless variant of ChessPlugin (no React surfaces / GameVariant).\n * Used in node contexts (CLI, agents) where rendering is unavailable.\n */\nexport const ChessPlugin = Plugin.define(meta).pipe(\n  Plugin.addModule(AppCapability.schema([Chess.State, ChessPositionIndex.PositionIndex, PlayerReview.Review])),\n  Plugin.addModule(SkillDefinition),\n  Plugin.addModule(OperationHandler),\n  Plugin.make,\n);\n\nexport default ChessPlugin;\n"],"mappings":";;;;;;;;;;;;AAkBA,IAAa,cAAc,OAAO,OAAO,IAAI,CAAC,CAAC,KAC7C,OAAO,UAAU,cAAc,OAAO;CAAC;CAAa;CAAkC;AAAmB,CAAC,CAAC,GAC3G,OAAO,UAAU,eAAe,GAChC,OAAO,UAAU,gBAAgB,GACjC,OAAO,IACT"}

package/dist/lib/ChessPlugin.workerd.mjs

@@ -1,14 +1,16 @@
-import { Chess, ChessPositionIndex, PlayerReview } from "#types";
-import { Plugin } from "@dxos/app-framework";
-import { AppPlugin } from "@dxos/app-toolkit";
-import { OperationHandler } from "#capabilities";
+import { State } from "./Chess.mjs";
+import { PositionIndex } from "./ChessPositionIndex.mjs";
+import { Review } from "./PlayerReview.mjs";
+import * as Plugin from "@dxos/app-framework/Plugin";
 import { meta } from "#meta";
+import * as AppCapability from "@dxos/app-toolkit/AppCapability";
+import { OperationHandler } from "#capabilities";
 //#region src/ChessPlugin.workerd.ts
-var ChessPlugin = Plugin.define(meta).pipe(AppPlugin.addOperationHandlerModule({ activate: OperationHandler }), AppPlugin.addSchemaModule({ schema: [
-	Chess.State,
-	ChessPositionIndex.PositionIndex,
-	PlayerReview.Review
-] }), Plugin.make);
+var ChessPlugin = Plugin.define(meta).pipe(Plugin.addModule(OperationHandler), Plugin.addModule(AppCapability.schema([
+	State,
+	PositionIndex,
+	Review
+])), Plugin.make);
 //#endregion
 export { ChessPlugin, ChessPlugin as default };
 

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

@@ -1 +1 @@
-{"version":3,"file":"ChessPlugin.workerd.mjs","names":[],"sources":["../../src/ChessPlugin.workerd.ts"],"sourcesContent":["//\n// Copyright 2026 DXOS.org\n//\n\nimport { Plugin } from '@dxos/app-framework';\nimport { AppPlugin } from '@dxos/app-toolkit';\n\nimport { OperationHandler } from '#capabilities';\nimport { meta } from '#meta';\nimport { Chess, ChessPositionIndex, PlayerReview } from '#types';\n\nexport const ChessPlugin = Plugin.define(meta).pipe(\n  AppPlugin.addOperationHandlerModule({ activate: OperationHandler }),\n  AppPlugin.addSchemaModule({ schema: [Chess.State, ChessPositionIndex.PositionIndex, PlayerReview.Review] }),\n  Plugin.make,\n);\n\nexport default ChessPlugin;\n"],"mappings":";;;;;;AAWA,IAAa,cAAc,OAAO,OAAO,IAAI,CAAC,CAAC,KAC7C,UAAU,0BAA0B,EAAE,UAAU,iBAAiB,CAAC,GAClE,UAAU,gBAAgB,EAAE,QAAQ;CAAC,MAAM;CAAO,mBAAmB;CAAe,aAAa;AAAM,EAAE,CAAC,GAC1G,OAAO,IACT"}
+{"version":3,"file":"ChessPlugin.workerd.mjs","names":[],"sources":["../../src/ChessPlugin.workerd.ts"],"sourcesContent":["//\n// Copyright 2026 DXOS.org\n//\n\nimport * as Plugin from '@dxos/app-framework/Plugin';\nimport * as AppCapability from '@dxos/app-toolkit/AppCapability';\n\nimport { OperationHandler } from '#capabilities';\nimport { meta } from '#meta';\n\nimport * as Chess from './types/Chess';\nimport * as ChessPositionIndex from './types/ChessPositionIndex';\nimport * as PlayerReview from './types/PlayerReview';\n\nexport const ChessPlugin = Plugin.define(meta).pipe(\n  Plugin.addModule(OperationHandler),\n  Plugin.addModule(AppCapability.schema([Chess.State, ChessPositionIndex.PositionIndex, PlayerReview.Review])),\n  Plugin.make,\n);\n\nexport default ChessPlugin;\n"],"mappings":";;;;;;;;AAcA,IAAa,cAAc,OAAO,OAAO,IAAI,CAAC,CAAC,KAC7C,OAAO,UAAU,gBAAgB,GACjC,OAAO,UAAU,cAAc,OAAO;CAAC;CAAa;CAAkC;AAAmB,CAAC,CAAC,GAC3G,OAAO,IACT"}

package/dist/lib/ChessPositionIndex.mjs

@@ -0,0 +1,45 @@
+import { t as __exportAll } from "./chunk-rolldown-runtime.mjs";
+import * as Schema from "effect/Schema";
+import { Annotation, DXN, Obj, Ref, Type } from "@dxos/echo";
+import { FormInputAnnotation } from "@dxos/echo/Annotation";
+import * as Game from "@dxos/plugin-game/Game";
+//#region src/types/ChessPositionIndex.ts
+var ChessPositionIndex_exports = /* @__PURE__ */ __exportAll({
+	Index: () => Index,
+	PositionEntry: () => PositionEntry,
+	PositionIndex: () => PositionIndex,
+	Side: () => Side,
+	SideIndex: () => SideIndex,
+	make: () => make
+});
+/** Side the reviewed player may play in indexed games. */
+var Side = Schema.Literal("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)) });
+/** FEN-keyed lookup of {@link PositionEntry} for one side. */
+var SideIndex = Schema.Record({
+	key: Schema.String,
+	value: PositionEntry
+});
+/** Per-side position reach counts for a player review. */
+var Index = Schema.Struct({
+	white: SideIndex,
+	black: SideIndex
+});
+/**
+* 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({
+	icon: "ph--map-trifold--regular",
+	hue: "amber"
+}))) {};
+/** Creates an empty position index. */
+var make = () => Obj.make(PositionIndex, { index: {
+	white: {},
+	black: {}
+} });
+//#endregion
+export { Index, PositionEntry, PositionIndex, Side, SideIndex, make, ChessPositionIndex_exports as t };
+
+//# sourceMappingURL=ChessPositionIndex.mjs.map

package/dist/lib/ChessPositionIndex.mjs.map

@@ -0,0 +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.Literal('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({ key: Schema.String, value: 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,QAAQ,SAAS,OAAO;;AAInD,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;CAAE,KAAK,OAAO;CAAQ,OAAO;AAAc,CAAC;;AAKnF,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"}

package/dist/lib/PlayerReview.mjs

@@ -0,0 +1,40 @@
+import { t as __exportAll } from "./chunk-rolldown-runtime.mjs";
+import { PositionIndex, make } from "./ChessPositionIndex.mjs";
+import * as Schema from "effect/Schema";
+import { Annotation, DXN, Obj, Ref, Type } from "@dxos/echo";
+import { FormInputAnnotation, LabelAnnotation } from "@dxos/echo/Annotation";
+//#region src/types/PlayerReview.ts
+var PlayerReview_exports = /* @__PURE__ */ __exportAll({
+	Review: () => Review,
+	makeReview: () => makeReview
+});
+/**
+* Personal chess opening/position review for a single player.
+* Indexes all reachable positions (by side) across games in the space.
+*/
+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),
+	/** Display name fallback when identity is absent (e.g. Chess.com username). */
+	playerName: Schema.String.pipe(Schema.optional),
+	positionIndex: Ref.Ref(PositionIndex).pipe(FormInputAnnotation.set(false))
+}).pipe(LabelAnnotation.set(["name"]), Annotation.IconAnnotation.set({
+	icon: "ph--chart-polar--regular",
+	hue: "amber"
+}))) {};
+/** Creates a player review with an empty child position index. */
+var makeReview = (props = {}) => {
+	const positionIndex = make();
+	const review = Obj.make(Review, {
+		...props,
+		name: props.name ?? props.playerName ?? "Player review",
+		positionIndex: Ref.make(positionIndex)
+	});
+	Obj.setParent(positionIndex, review);
+	return review;
+};
+//#endregion
+export { Review, makeReview, PlayerReview_exports as t };
+
+//# sourceMappingURL=PlayerReview.mjs.map

package/dist/lib/PlayerReview.mjs.map

@@ -0,0 +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    positionIndex: Ref.Ref(ChessPositionIndex.PositionIndex).pipe(FormInputAnnotation.set(false)),\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  const review = Obj.make(Review, {\n    ...props,\n    name: props.name ?? props.playerName ?? 'Player review',\n    positionIndex: Ref.make(positionIndex),\n  });\n  Obj.setParent(positionIndex, review);\n  return review;\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;CAC9C,eAAe,IAAI,IAAI,aAAgC,CAAC,CAAC,KAAK,oBAAoB,IAAI,KAAK,CAAC;AAC9F,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,MAAM,SAAS,IAAI,KAAK,QAAQ;EAC9B,GAAG;EACH,MAAM,MAAM,QAAQ,MAAM,cAAc;EACxC,eAAe,IAAI,KAAK,aAAa;CACvC,CAAC;CACD,IAAI,UAAU,eAAe,MAAM;CACnC,OAAO;AACT"}

package/dist/lib/capabilities/node.mjs

@@ -1,7 +1,8 @@
-import { Capability } from "@dxos/app-framework";
+import * as AppCapability from "@dxos/app-toolkit/AppCapability";
+import * as ActivationEvents from "@dxos/app-framework/ActivationEvents";
 //#region src/capabilities/node.ts
-var SkillDefinition = Capability.lazy("SkillDefinition", () => import("../chunk-skill-definition.mjs"));
-var OperationHandler = Capability.lazy("OperationHandler", () => import("../chunk-operation-handler.mjs"));
+var SkillDefinition = AppCapability.skillDefinition(() => import("../chunk-skill-definition.mjs"));
+var OperationHandler = AppCapability.operationHandler(() => import("../chunk-operation-handler.mjs"), { activatesOn: ActivationEvents.Idle });
 //#endregion
 export { OperationHandler, SkillDefinition };
 

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

@@ -1 +1 @@
-{"version":3,"file":"node.mjs","names":[],"sources":["../../../src/capabilities/node.ts"],"sourcesContent":["//\n// Copyright 2026 DXOS.org\n//\n\nimport { Capability } from '@dxos/app-framework';\nimport type { OperationHandlerSet } from '@dxos/compute';\n\n// The capabilities `ChessPlugin.node` activates, and only those. `Capability.lazy` defers the\n// import at runtime but a bundler still walks it, so listing the React surfaces here would pull\n// the plugin's components into every node and bun build.\n\nexport const SkillDefinition = Capability.lazy('SkillDefinition', () => import('./skill-definition'));\nexport const OperationHandler = Capability.lazy<OperationHandlerSet.OperationHandlerSet>(\n  'OperationHandler',\n  () => import('./operation-handler'),\n);\n"],"mappings":";;AAWA,IAAa,kBAAkB,WAAW,KAAK,yBAAyB,OAAO,gCAAqB;AACpG,IAAa,mBAAmB,WAAW,KACzC,0BACM,OAAO,iCACf"}
+{"version":3,"file":"node.mjs","names":[],"sources":["../../../src/capabilities/node.ts"],"sourcesContent":["//\n// Copyright 2026 DXOS.org\n//\n\nimport * as ActivationEvents from '@dxos/app-framework/ActivationEvents';\nimport * as AppCapability from '@dxos/app-toolkit/AppCapability';\n\n// The capabilities `ChessPlugin.node` activates, and only those. A lazy module defers its import at\n// runtime but a bundler still walks it, so listing the React surfaces here — including `GameVariant`,\n// which contributes them — would pull the plugin's components into every node and bun build.\n\nexport const SkillDefinition = AppCapability.skillDefinition(() => import('./skill-definition'));\nexport const OperationHandler = AppCapability.operationHandler(() => import('./operation-handler'), {\n  activatesOn: ActivationEvents.Idle,\n});\n"],"mappings":";;;AAWA,IAAa,kBAAkB,cAAc,sBAAsB,OAAO,gCAAqB;AAC/F,IAAa,mBAAmB,cAAc,uBAAuB,OAAO,mCAAwB,EAClG,aAAa,iBAAiB,KAChC,CAAC"}

package/dist/lib/capabilities.mjs

@@ -1,8 +1,15 @@
-import { Capability } from "@dxos/app-framework";
+import * as AppCapability from "@dxos/app-toolkit/AppCapability";
+import * as ActivationEvents from "@dxos/app-framework/ActivationEvents";
+import * as Capability from "@dxos/app-framework/Capability";
+import * as GameCapabilities from "@dxos/plugin-game/GameCapabilities";
+import * as GameEvents from "@dxos/plugin-game/GameEvents";
 //#region src/capabilities/index.ts
-var SkillDefinition = Capability.lazy("SkillDefinition", () => import("./chunk-skill-definition.mjs"));
-var GameVariant = Capability.lazy("GameVariant", () => import("./chunk-game-variant.mjs"));
-var OperationHandler = Capability.lazy("OperationHandler", () => import("./chunk-operation-handler.mjs"));
+var SkillDefinition = AppCapability.skillDefinition(() => import("./chunk-skill-definition.mjs"));
+var GameVariant = Capability.lazyModule("GameVariant", {
+	provides: [GameCapabilities.VariantProvider],
+	activatesOn: GameEvents.Start
+}, () => import("./chunk-game-variant.mjs"));
+var OperationHandler = AppCapability.operationHandler(() => import("./chunk-operation-handler.mjs"), { activatesOn: ActivationEvents.Idle });
 //#endregion
 export { GameVariant, OperationHandler, SkillDefinition };
 

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 { Capability } from '@dxos/app-framework';\nimport type { OperationHandlerSet } from '@dxos/compute';\n\nexport const SkillDefinition = Capability.lazy('SkillDefinition', () => import('./skill-definition'));\nexport const GameVariant = Capability.lazy('GameVariant', () => import('./game-variant'));\nexport const OperationHandler = Capability.lazy<OperationHandlerSet.OperationHandlerSet>(\n  'OperationHandler',\n  () => import('./operation-handler'),\n);\n"],"mappings":";;AAOA,IAAa,kBAAkB,WAAW,KAAK,yBAAyB,OAAO,+BAAqB;AACpG,IAAa,cAAc,WAAW,KAAK,qBAAqB,OAAO,2BAAiB;AACxF,IAAa,mBAAmB,WAAW,KACzC,0BACM,OAAO,gCACf"}
+{"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\nexport const SkillDefinition = AppCapability.skillDefinition(() => import('./skill-definition'));\nexport const GameVariant = Capability.lazyModule(\n  'GameVariant',\n  { provides: [GameCapabilities.VariantProvider], activatesOn: GameEvents.Start },\n  () => import('./game-variant'),\n);\nexport const OperationHandler = AppCapability.operationHandler(() => import('./operation-handler'), {\n  activatesOn: ActivationEvents.Idle,\n});\n"],"mappings":";;;;;;AAUA,IAAa,kBAAkB,cAAc,sBAAsB,OAAO,+BAAqB;AAC/F,IAAa,cAAc,WAAW,WACpC,eACA;CAAE,UAAU,CAAC,iBAAiB,eAAe;CAAG,aAAa,WAAW;AAAM,SACxE,OAAO,2BACf;AACA,IAAa,mBAAmB,cAAc,uBAAuB,OAAO,kCAAwB,EAClG,aAAa,iBAAiB,KAChC,CAAC"}

package/dist/lib/chunk-ChessArticle.mjs

@@ -1,5 +1,5 @@
-import { Chess } from "#types";
-import { Chess as Chess$1 } from "chess.js";
+import { State } from "./Chess.mjs";
+import { Chess } from "chess.js";
 import { Obj } from "@dxos/echo";
 import { meta } from "#meta";
 import { useCallback, useRef, useState } from "react";
@@ -18,13 +18,13 @@ var ChessArticle = ({ role, variant }) => {
 	const handleSelect = useCallback((index) => {
 		controller.current?.setMoveNumber(index);
 	}, []);
-	const state = Obj.instanceOf(Chess.State, variant) ? variant : void 0;
+	const state = Obj.instanceOf(State, variant) ? variant : void 0;
 	const [pgn] = useObject(state, "pgn");
 	const [fen] = useObject(state, "fen");
 	const isGameOver = (() => {
 		if (!pgn && !fen) return false;
 		try {
-			const chess = new Chess$1();
+			const chess = new Chess();
 			if (pgn) chess.loadPgn(pgn);
 			else if (fen) chess.load(fen);
 			return chess.isGameOver();

package/dist/lib/chunk-ChessArticle.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"chunk-ChessArticle.mjs","names":[],"sources":["../../src/containers/ChessArticle/ChessArticle.tsx"],"sourcesContent":["//\n// Copyright 2024 DXOS.org\n//\n\nimport { Chess as ChessJS } from 'chess.js';\nimport React, { useCallback, useRef, useState } from 'react';\n\nimport { AppSurface } from '@dxos/app-toolkit/ui';\nimport { Obj } from '@dxos/echo';\nimport { useObject } from '@dxos/echo-react';\nimport { type GameVariantSurfaceProps } from '@dxos/plugin-game/types';\nimport { Panel, Toolbar, useTranslation } from '@dxos/react-ui';\nimport { type Player } from '@dxos/react-ui-gameboard';\nimport { mx } from '@dxos/ui-theme';\n\nimport { Chessboard, type ChessboardController, type ChessboardInfoProps } from '#components';\nimport { meta } from '#meta';\nimport { Chess } from '#types';\n\nexport type ChessArticleProps = GameVariantSurfaceProps;\n\nexport const ChessArticle = ({ role, variant }: ChessArticleProps) => {\n  const { t } = useTranslation(meta.profile.key);\n  const [orientation, setOrientation] = useState<Player>('white');\n  const [showInfo, setShowInfo] = useState(true);\n  const controller = useRef<ChessboardController>(null);\n\n  const handleSelect = useCallback<NonNullable<ChessboardInfoProps['onSelect']>>((index) => {\n    controller.current?.setMoveNumber(index);\n  }, []);\n\n  const state = Obj.instanceOf(Chess.State, variant) ? variant : undefined;\n  const [pgn] = useObject(state, 'pgn');\n  const [fen] = useObject(state, 'fen');\n\n  const isGameOver = (() => {\n    if (!pgn && !fen) {\n      return false;\n    }\n    try {\n      const chess = new ChessJS();\n      if (pgn) {\n        chess.loadPgn(pgn);\n      } else if (fen) {\n        chess.load(fen);\n      }\n      return chess.isGameOver();\n    } catch {\n      return false;\n    }\n  })();\n\n  const handleNewGame = useCallback(() => {\n    if (!state) {\n      return;\n    }\n    Obj.update(state, (state) => {\n      state.pgn = undefined;\n      state.fen = undefined;\n    });\n  }, [state]);\n\n  if (!state) {\n    return null;\n  }\n\n  return (\n    <Chessboard.Root state={state} ref={controller}>\n      <Panel.Root role={role} classNames='@container'>\n        <Panel.Toolbar asChild>\n          <Toolbar.Root>\n            {isGameOver && <Toolbar.Button onClick={handleNewGame}>{t('new-game.button')}</Toolbar.Button>}\n            <div className='grow' />\n            <Toolbar.IconButton\n              icon='ph--info--regular'\n              iconOnly\n              label={t('toggle-info.button')}\n              classNames={mx('invisible @4xl:visible')}\n              onClick={() => setShowInfo((open) => !open)}\n            />\n          </Toolbar.Root>\n        </Panel.Toolbar>\n        <Panel.Content>\n          <div\n            className={mx(\n              'grid h-full w-full',\n              showInfo && '@4xl:grid-cols-[1fr_320px] gap-8',\n              role === AppSurface.Article.role && 'p-4',\n              role === AppSurface.Section.role && 'aspect-square',\n              role === AppSurface.Section.role && showInfo && '@4xl:aspect-auto',\n            )}\n          >\n            <Chessboard.Content>\n              <Chessboard.Board classNames='border rounded-xs' orientation={orientation} />\n            </Chessboard.Content>\n            {showInfo && (\n              <div className='hidden @4xl:flex flex-col justify-center items-center overflow-hidden'>\n                <Chessboard.Info\n                  orientation={orientation}\n                  min={8}\n                  max={8}\n                  onOrientationChange={setOrientation}\n                  onClose={() => setShowInfo(false)}\n                  onSelect={handleSelect}\n                />\n              </div>\n            )}\n          </div>\n        </Panel.Content>\n      </Panel.Root>\n    </Chessboard.Root>\n  );\n};\n\nChessArticle.displayName = 'ChessArticle';\n"],"mappings":";;;;;;;;;;;;AAqBA,IAAa,gBAAgB,EAAE,MAAM,cAAiC;CACpE,MAAM,EAAE,MAAM,eAAe,KAAK,QAAQ,GAAG;CAC7C,MAAM,CAAC,aAAa,kBAAkB,SAAiB,OAAO;CAC9D,MAAM,CAAC,UAAU,eAAe,SAAS,IAAI;CAC7C,MAAM,aAAa,OAA6B,IAAI;CAEpD,MAAM,eAAe,aAA2D,UAAU;EACxF,WAAW,SAAS,cAAc,KAAK;CACzC,GAAG,CAAC,CAAC;CAEL,MAAM,QAAQ,IAAI,WAAW,MAAM,OAAO,OAAO,IAAI,UAAU,KAAA;CAC/D,MAAM,CAAC,OAAO,UAAU,OAAO,KAAK;CACpC,MAAM,CAAC,OAAO,UAAU,OAAO,KAAK;CAEpC,MAAM,oBAAoB;EACxB,IAAI,CAAC,OAAO,CAAC,KACX,OAAO;EAET,IAAI;GACF,MAAM,QAAQ,IAAI,QAAQ;GAC1B,IAAI,KACF,MAAM,QAAQ,GAAG;QACZ,IAAI,KACT,MAAM,KAAK,GAAG;GAEhB,OAAO,MAAM,WAAW;EAC1B,QAAQ;GACN,OAAO;EACT;CACF,EAAA,CAAG;CAEH,MAAM,gBAAgB,kBAAkB;EACtC,IAAI,CAAC,OACH;EAEF,IAAI,OAAO,QAAQ,UAAU;GAC3B,MAAM,MAAM,KAAA;GACZ,MAAM,MAAM,KAAA;EACd,CAAC;CACH,GAAG,CAAC,KAAK,CAAC;CAEV,IAAI,CAAC,OACH,OAAO;CAGT,OACE,oBAAC,WAAW,MAAZ;EAAwB;EAAO,KAAK;YAClC,qBAAC,MAAM,MAAP;GAAkB;GAAM,YAAW;aAAnC,CACE,oBAAC,MAAM,SAAP;IAAe,SAAA;cACb,qBAAC,QAAQ,MAAT,EAAA,UAAA;KACG,cAAc,oBAAC,QAAQ,QAAT;MAAgB,SAAS;gBAAgB,EAAE,iBAAiB;KAAkB,CAAA;KAC7F,oBAAC,OAAD,EAAK,WAAU,OAAQ,CAAA;KACvB,oBAAC,QAAQ,YAAT;MACE,MAAK;MACL,UAAA;MACA,OAAO,EAAE,oBAAoB;MAC7B,YAAY,GAAG,wBAAwB;MACvC,eAAe,aAAa,SAAS,CAAC,IAAI;KAC3C,CAAA;IACW,EAAA,CAAA;GACD,CAAA,GACf,oBAAC,MAAM,SAAP,EAAA,UACE,qBAAC,OAAD;IACE,WAAW,GACT,sBACA,YAAY,oCACZ,SAAS,WAAW,QAAQ,QAAQ,OACpC,SAAS,WAAW,QAAQ,QAAQ,iBACpC,SAAS,WAAW,QAAQ,QAAQ,YAAY,kBAClD;cAPF,CASE,oBAAC,WAAW,SAAZ,EAAA,UACE,oBAAC,WAAW,OAAZ;KAAkB,YAAW;KAAiC;IAAc,CAAA,EAC1D,CAAA,GACnB,YACC,oBAAC,OAAD;KAAK,WAAU;eACb,oBAAC,WAAW,MAAZ;MACe;MACb,KAAK;MACL,KAAK;MACL,qBAAqB;MACrB,eAAe,YAAY,KAAK;MAChC,UAAU;KACX,CAAA;IACE,CAAA,CAEJ;MACQ,CAAA,CACL;;CACG,CAAA;AAErB;AAEA,aAAa,cAAc"}
+{"version":3,"file":"chunk-ChessArticle.mjs","names":[],"sources":["../../src/containers/ChessArticle/ChessArticle.tsx"],"sourcesContent":["//\n// Copyright 2024 DXOS.org\n//\n\nimport { Chess as ChessJS } from 'chess.js';\nimport React, { useCallback, useRef, useState } from 'react';\n\nimport { AppSurface } from '@dxos/app-toolkit/ui';\nimport { Obj } from '@dxos/echo';\nimport { useObject } from '@dxos/echo-react';\nimport * as GameCapabilities from '@dxos/plugin-game/GameCapabilities';\nimport { Panel, Toolbar, useTranslation } from '@dxos/react-ui';\nimport { type Player } from '@dxos/react-ui-gameboard';\nimport { mx } from '@dxos/ui-theme';\n\nimport { Chessboard, type ChessboardController, type ChessboardInfoProps } from '#components';\nimport { meta } from '#meta';\n\nimport * as Chess from '../../types/Chess';\n\nexport type ChessArticleProps = GameCapabilities.GameVariantSurfaceProps;\n\nexport const ChessArticle = ({ role, variant }: ChessArticleProps) => {\n  const { t } = useTranslation(meta.profile.key);\n  const [orientation, setOrientation] = useState<Player>('white');\n  const [showInfo, setShowInfo] = useState(true);\n  const controller = useRef<ChessboardController>(null);\n\n  const handleSelect = useCallback<NonNullable<ChessboardInfoProps['onSelect']>>((index) => {\n    controller.current?.setMoveNumber(index);\n  }, []);\n\n  const state = Obj.instanceOf(Chess.State, variant) ? variant : undefined;\n  const [pgn] = useObject(state, 'pgn');\n  const [fen] = useObject(state, 'fen');\n\n  const isGameOver = (() => {\n    if (!pgn && !fen) {\n      return false;\n    }\n    try {\n      const chess = new ChessJS();\n      if (pgn) {\n        chess.loadPgn(pgn);\n      } else if (fen) {\n        chess.load(fen);\n      }\n      return chess.isGameOver();\n    } catch {\n      return false;\n    }\n  })();\n\n  const handleNewGame = useCallback(() => {\n    if (!state) {\n      return;\n    }\n    Obj.update(state, (state) => {\n      state.pgn = undefined;\n      state.fen = undefined;\n    });\n  }, [state]);\n\n  if (!state) {\n    return null;\n  }\n\n  return (\n    <Chessboard.Root state={state} ref={controller}>\n      <Panel.Root role={role} classNames='@container'>\n        <Panel.Toolbar asChild>\n          <Toolbar.Root>\n            {isGameOver && <Toolbar.Button onClick={handleNewGame}>{t('new-game.button')}</Toolbar.Button>}\n            <div className='grow' />\n            <Toolbar.IconButton\n              icon='ph--info--regular'\n              iconOnly\n              label={t('toggle-info.button')}\n              classNames={mx('invisible @4xl:visible')}\n              onClick={() => setShowInfo((open) => !open)}\n            />\n          </Toolbar.Root>\n        </Panel.Toolbar>\n        <Panel.Content>\n          <div\n            className={mx(\n              'grid h-full w-full',\n              showInfo && '@4xl:grid-cols-[1fr_320px] gap-8',\n              role === AppSurface.Article.role && 'p-4',\n              role === AppSurface.Section.role && 'aspect-square',\n              role === AppSurface.Section.role && showInfo && '@4xl:aspect-auto',\n            )}\n          >\n            <Chessboard.Content>\n              <Chessboard.Board classNames='border rounded-xs' orientation={orientation} />\n            </Chessboard.Content>\n            {showInfo && (\n              <div className='hidden @4xl:flex flex-col justify-center items-center overflow-hidden'>\n                <Chessboard.Info\n                  orientation={orientation}\n                  min={8}\n                  max={8}\n                  onOrientationChange={setOrientation}\n                  onClose={() => setShowInfo(false)}\n                  onSelect={handleSelect}\n                />\n              </div>\n            )}\n          </div>\n        </Panel.Content>\n      </Panel.Root>\n    </Chessboard.Root>\n  );\n};\n\nChessArticle.displayName = 'ChessArticle';\n"],"mappings":";;;;;;;;;;;;AAsBA,IAAa,gBAAgB,EAAE,MAAM,cAAiC;CACpE,MAAM,EAAE,MAAM,eAAe,KAAK,QAAQ,GAAG;CAC7C,MAAM,CAAC,aAAa,kBAAkB,SAAiB,OAAO;CAC9D,MAAM,CAAC,UAAU,eAAe,SAAS,IAAI;CAC7C,MAAM,aAAa,OAA6B,IAAI;CAEpD,MAAM,eAAe,aAA2D,UAAU;EACxF,WAAW,SAAS,cAAc,KAAK;CACzC,GAAG,CAAC,CAAC;CAEL,MAAM,QAAQ,IAAI,WAAW,OAAa,OAAO,IAAI,UAAU,KAAA;CAC/D,MAAM,CAAC,OAAO,UAAU,OAAO,KAAK;CACpC,MAAM,CAAC,OAAO,UAAU,OAAO,KAAK;CAEpC,MAAM,oBAAoB;EACxB,IAAI,CAAC,OAAO,CAAC,KACX,OAAO;EAET,IAAI;GACF,MAAM,QAAQ,IAAI,MAAQ;GAC1B,IAAI,KACF,MAAM,QAAQ,GAAG;QACZ,IAAI,KACT,MAAM,KAAK,GAAG;GAEhB,OAAO,MAAM,WAAW;EAC1B,QAAQ;GACN,OAAO;EACT;CACF,EAAA,CAAG;CAEH,MAAM,gBAAgB,kBAAkB;EACtC,IAAI,CAAC,OACH;EAEF,IAAI,OAAO,QAAQ,UAAU;GAC3B,MAAM,MAAM,KAAA;GACZ,MAAM,MAAM,KAAA;EACd,CAAC;CACH,GAAG,CAAC,KAAK,CAAC;CAEV,IAAI,CAAC,OACH,OAAO;CAGT,OACE,oBAAC,WAAW,MAAZ;EAAwB;EAAO,KAAK;YAClC,qBAAC,MAAM,MAAP;GAAkB;GAAM,YAAW;aAAnC,CACE,oBAAC,MAAM,SAAP;IAAe,SAAA;cACb,qBAAC,QAAQ,MAAT,EAAA,UAAA;KACG,cAAc,oBAAC,QAAQ,QAAT;MAAgB,SAAS;gBAAgB,EAAE,iBAAiB;KAAkB,CAAA;KAC7F,oBAAC,OAAD,EAAK,WAAU,OAAQ,CAAA;KACvB,oBAAC,QAAQ,YAAT;MACE,MAAK;MACL,UAAA;MACA,OAAO,EAAE,oBAAoB;MAC7B,YAAY,GAAG,wBAAwB;MACvC,eAAe,aAAa,SAAS,CAAC,IAAI;KAC3C,CAAA;IACW,EAAA,CAAA;GACD,CAAA,GACf,oBAAC,MAAM,SAAP,EAAA,UACE,qBAAC,OAAD;IACE,WAAW,GACT,sBACA,YAAY,oCACZ,SAAS,WAAW,QAAQ,QAAQ,OACpC,SAAS,WAAW,QAAQ,QAAQ,iBACpC,SAAS,WAAW,QAAQ,QAAQ,YAAY,kBAClD;cAPF,CASE,oBAAC,WAAW,SAAZ,EAAA,UACE,oBAAC,WAAW,OAAZ;KAAkB,YAAW;KAAiC;IAAc,CAAA,EAC1D,CAAA,GACnB,YACC,oBAAC,OAAD;KAAK,WAAU;eACb,oBAAC,WAAW,MAAZ;MACe;MACb,KAAK;MACL,KAAK;MACL,qBAAqB;MACrB,eAAe,YAAY,KAAK;MAChC,UAAU;KACX,CAAA;IACE,CAAA,CAEJ;MACQ,CAAA,CACL;;CACG,CAAA;AAErB;AAEA,aAAa,cAAc"}

package/dist/lib/chunk-ChessCard.mjs

@@ -1,4 +1,4 @@
-import { Chess } from "#types";
+import { State } from "./Chess.mjs";
 import { Obj } from "@dxos/echo";
 import "react";
 import { Card } from "@dxos/react-ui";
@@ -6,7 +6,7 @@ import { jsx } from "react/jsx-runtime";
 import { Chessboard } from "#components";
 //#region src/containers/ChessCard/ChessCard.tsx
 var ChessCard = ({ variant }) => {
-	if (!Obj.instanceOf(Chess.State, variant)) return null;
+	if (!Obj.instanceOf(State, variant)) return null;
 	return /* @__PURE__ */ jsx(Card.Body, { children: /* @__PURE__ */ jsx(Card.Section, {
 		classNames: "aspect-square",
 		children: /* @__PURE__ */ jsx(Card.Row, {

package/dist/lib/chunk-ChessCard.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"chunk-ChessCard.mjs","names":[],"sources":["../../src/containers/ChessCard/ChessCard.tsx"],"sourcesContent":["//\n// Copyright 2024 DXOS.org\n//\n\nimport React from 'react';\n\nimport { Obj } from '@dxos/echo';\nimport { type GameVariantSurfaceProps } from '@dxos/plugin-game/types';\nimport { Card } from '@dxos/react-ui';\n\nimport { Chessboard } from '#components';\nimport { Chess } from '#types';\n\nexport type ChessCardProps = GameVariantSurfaceProps;\n\nexport const ChessCard = ({ variant }: ChessCardProps) => {\n  if (!Obj.instanceOf(Chess.State, variant)) {\n    return null;\n  }\n\n  return (\n    <Card.Body>\n      <Card.Section classNames='aspect-square'>\n        <Card.Row fullWidth>\n          <Chessboard.Root state={variant}>\n            <Chessboard.Content>\n              <Chessboard.Board />\n            </Chessboard.Content>\n          </Chessboard.Root>\n        </Card.Row>\n      </Card.Section>\n    </Card.Body>\n  );\n};\n\nChessCard.displayName = 'ChessCard';\n"],"mappings":";;;;;;;AAeA,IAAa,aAAa,EAAE,cAA8B;CACxD,IAAI,CAAC,IAAI,WAAW,MAAM,OAAO,OAAO,GACtC,OAAO;CAGT,OACE,oBAAC,KAAK,MAAN,EAAA,UACE,oBAAC,KAAK,SAAN;EAAc,YAAW;YACvB,oBAAC,KAAK,KAAN;GAAU,WAAA;aACR,oBAAC,WAAW,MAAZ;IAAiB,OAAO;cACtB,oBAAC,WAAW,SAAZ,EAAA,UACE,oBAAC,WAAW,OAAZ,CAAmB,CAAA,EACD,CAAA;GACL,CAAA;EACT,CAAA;CACE,CAAA,EACL,CAAA;AAEf;AAEA,UAAU,cAAc"}
+{"version":3,"file":"chunk-ChessCard.mjs","names":[],"sources":["../../src/containers/ChessCard/ChessCard.tsx"],"sourcesContent":["//\n// Copyright 2024 DXOS.org\n//\n\nimport React from 'react';\n\nimport { Obj } from '@dxos/echo';\nimport * as GameCapabilities from '@dxos/plugin-game/GameCapabilities';\nimport { Card } from '@dxos/react-ui';\n\nimport { Chessboard } from '#components';\n\nimport * as Chess from '../../types/Chess';\n\nexport type ChessCardProps = GameCapabilities.GameVariantSurfaceProps;\n\nexport const ChessCard = ({ variant }: ChessCardProps) => {\n  if (!Obj.instanceOf(Chess.State, variant)) {\n    return null;\n  }\n\n  return (\n    <Card.Body>\n      <Card.Section classNames='aspect-square'>\n        <Card.Row fullWidth>\n          <Chessboard.Root state={variant}>\n            <Chessboard.Content>\n              <Chessboard.Board />\n            </Chessboard.Content>\n          </Chessboard.Root>\n        </Card.Row>\n      </Card.Section>\n    </Card.Body>\n  );\n};\n\nChessCard.displayName = 'ChessCard';\n"],"mappings":";;;;;;;AAgBA,IAAa,aAAa,EAAE,cAA8B;CACxD,IAAI,CAAC,IAAI,WAAW,OAAa,OAAO,GACtC,OAAO;CAGT,OACE,oBAAC,KAAK,MAAN,EAAA,UACE,oBAAC,KAAK,SAAN;EAAc,YAAW;YACvB,oBAAC,KAAK,KAAN;GAAU,WAAA;aACR,oBAAC,WAAW,MAAZ;IAAiB,OAAO;cACtB,oBAAC,WAAW,SAAZ,EAAA,UACE,oBAAC,WAAW,OAAZ,CAAmB,CAAA,EACD,CAAA;GACL,CAAA;EACT,CAAA;CACE,CAAA,EACL,CAAA;AAEf;AAEA,UAAU,cAAc"}

package/dist/lib/chunk-ChessPlugin.mjs

@@ -1,25 +1,23 @@
-import { Chess, ChessPositionIndex, PlayerReview } from "#types";
-import { Plugin } from "@dxos/app-framework";
-import { AppActivationEvents, AppPlugin } from "@dxos/app-toolkit";
-import { GameVariant, OperationHandler, SkillDefinition } from "#capabilities";
+import { State } from "./Chess.mjs";
+import { PositionIndex } from "./ChessPositionIndex.mjs";
+import { Review } from "./PlayerReview.mjs";
+import * as Plugin from "@dxos/app-framework/Plugin";
 import { meta } from "#meta";
+import * as AppCapability from "@dxos/app-toolkit/AppCapability";
+import { GameVariant, OperationHandler, SkillDefinition } from "#capabilities";
 import { translations } from "#translations";
 //#endregion
 //#region src/ChessPlugin.tsx
-var ChessPlugin = Plugin.define(meta).pipe(Plugin.addModule({
-	id: "game-variant",
-	activatesOn: AppActivationEvents.SetupSchema,
-	activate: GameVariant
-}), AppPlugin.addSkillDefinitionModule({ activate: SkillDefinition }), AppPlugin.addOperationHandlerModule({ activate: OperationHandler }), AppPlugin.addPluginAssetModule({ asset: {
+var ChessPlugin = Plugin.define(meta).pipe(Plugin.addModule(GameVariant), Plugin.addModule(SkillDefinition), Plugin.addModule(OperationHandler), Plugin.addModule(AppCapability.pluginAsset({
 	pluginId: meta.profile.key,
 	path: "PLUGIN.mdl",
 	content: "---\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.0`         |\n| `service`   | `org.dxos.mdl.service@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```\n\n```mdl\nop submitMove\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\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",
 	mimeType: "application/x-mdl"
-} }), AppPlugin.addSchemaModule({ schema: [
-	Chess.State,
-	ChessPositionIndex.PositionIndex,
-	PlayerReview.Review
-] }), AppPlugin.addTranslationsModule({ translations }), Plugin.make);
+})), Plugin.addModule(AppCapability.schema([
+	State,
+	PositionIndex,
+	Review
+])), Plugin.addModule(AppCapability.translations(translations)), Plugin.make);
 //#endregion
 export { ChessPlugin as t };
 

package/dist/lib/chunk-ChessPlugin.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"chunk-ChessPlugin.mjs","names":[],"sources":["../../src/ChessPlugin.tsx"],"sourcesContent":["//\n// Copyright 2023 DXOS.org\n//\n\nimport { Plugin } from '@dxos/app-framework';\nimport { AppActivationEvents, AppPlugin } from '@dxos/app-toolkit';\n\nimport { GameVariant, OperationHandler, SkillDefinition } from '#capabilities';\nimport { meta } from '#meta';\nimport { translations } from '#translations';\nimport { Chess, ChessPositionIndex, PlayerReview } from '#types';\n\n// eslint-disable-next-line import/no-relative-packages\nimport pluginSpec from '../PLUGIN.mdl?raw';\n\nexport const ChessPlugin = Plugin.define(meta).pipe(\n  Plugin.addModule({\n    id: 'game-variant',\n    activatesOn: AppActivationEvents.SetupSchema,\n    activate: GameVariant,\n  }),\n  AppPlugin.addSkillDefinitionModule({ activate: SkillDefinition }),\n  AppPlugin.addOperationHandlerModule({ activate: OperationHandler }),\n  AppPlugin.addPluginAssetModule({\n    asset: { pluginId: meta.profile.key, path: 'PLUGIN.mdl', content: pluginSpec, mimeType: 'application/x-mdl' },\n  }),\n  AppPlugin.addSchemaModule({ schema: [Chess.State, ChessPositionIndex.PositionIndex, PlayerReview.Review] }),\n  AppPlugin.addTranslationsModule({ translations }),\n  Plugin.make,\n);\n\nexport default ChessPlugin;\n"],"mappings":";;;;;;;;AAeA,IAAa,cAAc,OAAO,OAAO,IAAI,CAAC,CAAC,KAC7C,OAAO,UAAU;CACf,IAAI;CACJ,aAAa,oBAAoB;CACjC,UAAU;AACZ,CAAC,GACD,UAAU,yBAAyB,EAAE,UAAU,gBAAgB,CAAC,GAChE,UAAU,0BAA0B,EAAE,UAAU,iBAAiB,CAAC,GAClE,UAAU,qBAAqB,EAC7B,OAAO;CAAE,UAAU,KAAK,QAAQ;CAAK,MAAM;CAAc,SAAS;CAAY,UAAU;AAAoB,EAC9G,CAAC,GACD,UAAU,gBAAgB,EAAE,QAAQ;CAAC,MAAM;CAAO,mBAAmB;CAAe,aAAa;AAAM,EAAE,CAAC,GAC1G,UAAU,sBAAsB,EAAE,aAAa,CAAC,GAChD,OAAO,IACT"}
+{"version":3,"file":"chunk-ChessPlugin.mjs","names":[],"sources":["../../src/ChessPlugin.tsx"],"sourcesContent":["//\n// Copyright 2023 DXOS.org\n//\n\nimport * as Plugin from '@dxos/app-framework/Plugin';\nimport * as AppCapability from '@dxos/app-toolkit/AppCapability';\n\nimport { GameVariant, OperationHandler, SkillDefinition } from '#capabilities';\nimport { meta } from '#meta';\nimport { translations } from '#translations';\n\n// eslint-disable-next-line import/no-relative-packages\nimport pluginSpec from '../PLUGIN.mdl?raw';\nimport * as Chess from './types/Chess';\nimport * as ChessPositionIndex from './types/ChessPositionIndex';\nimport * as PlayerReview from './types/PlayerReview';\n\nexport const ChessPlugin = Plugin.define(meta).pipe(\n  Plugin.addModule(GameVariant),\n  Plugin.addModule(SkillDefinition),\n  Plugin.addModule(OperationHandler),\n  Plugin.addModule(\n    AppCapability.pluginAsset({\n      pluginId: meta.profile.key,\n      path: 'PLUGIN.mdl',\n      content: pluginSpec,\n      mimeType: 'application/x-mdl',\n    }),\n  ),\n  Plugin.addModule(AppCapability.schema([Chess.State, ChessPositionIndex.PositionIndex, PlayerReview.Review])),\n  Plugin.addModule(AppCapability.translations(translations)),\n  Plugin.make,\n);\n\nexport default ChessPlugin;\n"],"mappings":";;;;;;;;;;AAiBA,IAAa,cAAc,OAAO,OAAO,IAAI,CAAC,CAAC,KAC7C,OAAO,UAAU,WAAW,GAC5B,OAAO,UAAU,eAAe,GAChC,OAAO,UAAU,gBAAgB,GACjC,OAAO,UACL,cAAc,YAAY;CACxB,UAAU,KAAK,QAAQ;CACvB,MAAM;CACN,SAAS;CACT,UAAU;AACZ,CAAC,CACH,GACA,OAAO,UAAU,cAAc,OAAO;CAAC;CAAa;CAAkC;AAAmB,CAAC,CAAC,GAC3G,OAAO,UAAU,cAAc,aAAa,YAAY,CAAC,GACzD,OAAO,IACT"}