@dxos/plugin-game 0.10.0 → 0.11.1

package/dx.config.ts

@@ -36,5 +36,6 @@ export default Config2.make({
         dark: 'https://customer-5rxcjpyab08avpmn.cloudflarestream.com/2797d56edc9658d018ad75fe48a47f27/iframe?poster=https%3A%2F%2Fcustomer-5rxcjpyab08avpmn.cloudflarestream.com%2F2797d56edc9658d018ad75fe48a47f27%2Fthumbnails%2Fthumbnail.jpg%3Ftime%3D%26height%3D600',
       },
     ],
+    tags: ['alpha'],
   },
 });

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@dxos/plugin-game",
-  "version": "0.10.0",
+  "version": "0.11.1",
   "description": "Game plugin for DXOS Composer (unifies game variants like chess, tic-tac-toe).",
   "homepage": "https://dxos.org",
   "bugs": "https://github.com/dxos/dxos/issues",
@@ -16,22 +16,22 @@
     "#capabilities": {
       "source": "./src/capabilities/index.ts",
       "types": "./dist/types/src/capabilities/index.d.ts",
-      "default": "./dist/lib/neutral/capabilities/index.mjs"
+      "default": "./dist/lib/capabilities.mjs"
     },
     "#components": {
       "source": "./src/components/index.ts",
       "types": "./dist/types/src/components/index.d.ts",
-      "default": "./dist/lib/neutral/components/index.mjs"
+      "default": "./dist/lib/components.mjs"
     },
     "#containers": {
       "source": "./src/containers/index.ts",
       "types": "./dist/types/src/containers/index.d.ts",
-      "default": "./dist/lib/neutral/containers/index.mjs"
+      "default": "./dist/lib/containers.mjs"
     },
     "#meta": {
       "source": "./src/meta.ts",
       "types": "./dist/types/src/meta.d.ts",
-      "default": "./dist/lib/neutral/meta.mjs"
+      "default": "./dist/lib/meta.mjs"
     },
     "#plugin": {
       "source": {
@@ -40,19 +40,19 @@
         "default": "./src/GamePlugin.tsx"
       },
       "types": "./dist/types/src/GamePlugin.d.ts",
-      "workerd": "./dist/lib/neutral/GamePlugin.workerd.mjs",
-      "node": "./dist/lib/neutral/GamePlugin.node.mjs",
-      "default": "./dist/lib/neutral/GamePlugin.mjs"
+      "workerd": "./dist/lib/GamePlugin.workerd.mjs",
+      "node": "./dist/lib/GamePlugin.node.mjs",
+      "default": "./dist/lib/GamePlugin.mjs"
     },
     "#translations": {
       "source": "./src/translations.ts",
       "types": "./dist/types/src/translations.d.ts",
-      "default": "./dist/lib/neutral/translations.mjs"
+      "default": "./dist/lib/translations.mjs"
     },
     "#types": {
       "source": "./src/types/index.ts",
       "types": "./dist/types/src/types/index.d.ts",
-      "default": "./dist/lib/neutral/types/index.mjs"
+      "default": "./dist/lib/types.mjs"
     },
     "#util": "./src/util/index.ts"
   },
@@ -60,23 +60,23 @@
     ".": {
       "source": "./src/index.ts",
       "types": "./dist/types/src/index.d.ts",
-      "default": "./dist/lib/neutral/index.mjs"
+      "import": "./dist/lib/index.mjs"
     },
     "./assets/PLUGIN.mdl": "./PLUGIN.mdl",
     "./plugin": {
       "source": "./src/plugin.ts",
       "types": "./dist/types/src/plugin.d.ts",
-      "default": "./dist/lib/neutral/plugin.mjs"
+      "import": "./dist/lib/plugin.mjs"
     },
     "./translations": {
       "source": "./src/translations.ts",
       "types": "./dist/types/src/translations.d.ts",
-      "default": "./dist/lib/neutral/translations.mjs"
+      "import": "./dist/lib/translations.mjs"
     },
     "./types": {
       "source": "./src/types/index.ts",
       "types": "./dist/types/src/types/index.d.ts",
-      "default": "./dist/lib/neutral/types/index.mjs"
+      "import": "./dist/lib/types.mjs"
     }
   },
   "types": "dist/types/src/index.d.ts",
@@ -88,35 +88,36 @@
   ],
   "dependencies": {
     "effect": "3.21.4",
-    "@dxos/app-framework": "0.10.0",
-    "@dxos/compute": "0.10.0",
-    "@dxos/app-toolkit": "0.10.0",
-    "@dxos/echo": "0.10.0",
-    "@dxos/log": "0.10.0",
-    "@dxos/echo-react": "0.10.0",
-    "@dxos/invariant": "0.10.0",
-    "@dxos/react-ui-form": "0.10.0",
-    "@dxos/keys": "0.10.0",
-    "@dxos/plugin-space": "0.10.0",
-    "@dxos/react-ui": "0.10.0",
-    "@dxos/react-ui-search": "0.10.0",
-    "@dxos/util": "0.10.0"
+    "@dxos/app-framework": "0.11.1",
+    "@dxos/app-toolkit": "0.11.1",
+    "@dxos/compute": "0.11.1",
+    "@dxos/echo": "0.11.1",
+    "@dxos/echo-react": "0.11.1",
+    "@dxos/invariant": "0.11.1",
+    "@dxos/keys": "0.11.1",
+    "@dxos/log": "0.11.1",
+    "@dxos/plugin-space": "0.11.1",
+    "@dxos/react-ui": "0.11.1",
+    "@dxos/react-ui-form": "0.11.1",
+    "@dxos/react-ui-search": "0.11.1",
+    "@dxos/schema": "0.11.1",
+    "@dxos/util": "0.11.1"
   },
   "devDependencies": {
     "@types/react": "~19.2.17",
     "@types/react-dom": "~19.2.3",
     "react": "~19.2.7",
     "react-dom": "~19.2.7",
-    "vite": "^8.0.16",
-    "@dxos/plugin-testing": "0.10.0",
-    "@dxos/plugin-theme": "0.10.0",
-    "@dxos/ui-theme": "0.10.0"
+    "vite": "^8.1.4",
+    "@dxos/plugin-testing": "0.11.1",
+    "@dxos/plugin-theme": "0.11.1",
+    "@dxos/ui-theme": "0.11.1"
   },
   "peerDependencies": {
     "react": "~19.2.7",
     "react-dom": "~19.2.7",
-    "@dxos/react-ui": "0.10.0",
-    "@dxos/ui-theme": "0.10.0"
+    "@dxos/react-ui": "^0.11.1",
+    "@dxos/ui-theme": "^0.11.1"
   },
   "publishConfig": {
     "access": "public"

package/src/GamePlugin.node.tsx

@@ -16,7 +16,7 @@ import { Game } from '#types';
  * downstream bundlers don't resolve cleanly under nested pnpm symlinks.
  */
 export const GamePlugin = Plugin.define(meta).pipe(
-  AppPlugin.addSchemaModule({ schema: [Game] }),
+  AppPlugin.addSchemaModule({ schema: [Game.Game] }),
   AppPlugin.addTranslationsModule({ translations }),
   Plugin.make,
 );

package/src/GamePlugin.tsx

@@ -15,7 +15,7 @@ import pluginSpec from '../PLUGIN.mdl?raw';
 
 export const GamePlugin = Plugin.define(meta).pipe(
   AppPlugin.addCreateObjectModule({ activate: CreateObject }),
-  AppPlugin.addSchemaModule({ schema: [Game] }),
+  AppPlugin.addSchemaModule({ schema: [Game.Game] }),
   AppPlugin.addSurfaceModule({ activate: ReactSurface }),
   AppPlugin.addTranslationsModule({ translations }),
   AppPlugin.addPluginAssetModule({

package/src/GamePlugin.workerd.tsx

@@ -8,6 +8,6 @@ import { AppPlugin } from '@dxos/app-toolkit';
 import { meta } from '#meta';
 import { Game } from '#types';
 
-export const GamePlugin = Plugin.define(meta).pipe(AppPlugin.addSchemaModule({ schema: [Game] }), Plugin.make);
+export const GamePlugin = Plugin.define(meta).pipe(AppPlugin.addSchemaModule({ schema: [Game.Game] }), Plugin.make);
 
 export default GamePlugin;

package/src/capabilities/create-object.ts

@@ -13,14 +13,14 @@ import { SpaceCapabilities } from '@dxos/plugin-space';
 
 import { CreateGamePanel } from '#components';
 
-import { Game, GameCapabilities, make as makeGame } from '../types';
+import { Game, GameCapabilities } from '../types';
 
 type CreateOptions = Parameters<SpaceCapabilities.CreateObjectEntry['createObject']>[1];
 
 export default Capability.makeModule(
   Effect.fnUntraced(function* () {
     return Capability.contributes(SpaceCapabilities.CreateObjectEntry, {
-      id: Type.getTypename(Game),
+      id: Type.getTypename(Game.Game),
       customPanel: CreateGamePanel,
       createObject: (
         { variantId, input }: { variantId: string; input?: Record<string, any> },
@@ -44,7 +44,7 @@ export default Capability.makeModule(
             targetNodeId: options.targetNodeId,
           });
 
-          const game = makeGame({
+          const game = Game.make({
             name: typeof input?.name === 'string' ? input.name : undefined,
             variant: stateObject,
           });

package/src/capabilities/{react-surface.tsx → react-surface.ts}

@@ -3,7 +3,6 @@
 //
 
 import * as Effect from 'effect/Effect';
-import React from 'react';
 
 import { Capabilities, Capability } from '@dxos/app-framework';
 import { Surface } from '@dxos/app-framework/ui';
@@ -19,17 +18,17 @@ export default Capability.makeModule(() =>
       Surface.create({
         id: 'game',
         filter: AppSurface.oneOf(
-          AppSurface.object(AppSurface.Article, Game),
-          AppSurface.object(AppSurface.Section, Game),
-        ),
-        component: ({ data, role }) => (
-          <GameArticle role={role} subject={data.subject} attendableId={data.attendableId} />
+          AppSurface.object(AppSurface.Article, Game.Game),
+          AppSurface.object(AppSurface.Section, Game.Game),
         ),
+        component: GameArticle,
+        props: ({ role, data: { subject, attendableId } }) => ({ role, subject, attendableId }),
       }),
       Surface.create({
         id: 'gameCard',
-        filter: AppSurface.object(AppSurface.CardContent, Game),
-        component: ({ data, role }) => <GameCard role={role} subject={data.subject} />,
+        filter: AppSurface.object(AppSurface.CardContent, Game.Game),
+        component: GameCard,
+        props: ({ role, data: { subject } }) => ({ role, subject }),
       }),
     ]),
   ),

package/src/components/CreateGamePanel.stories.tsx

@@ -7,6 +7,7 @@ import * as Effect from 'effect/Effect';
 import * as Schema from 'effect/Schema';
 import React, { useState } from 'react';
 
+import { withPluginManager } from '@dxos/app-framework/testing';
 import { DXN, Obj, Type } from '@dxos/echo';
 import { Dialog } from '@dxos/react-ui';
 import { withLayout, withTheme } from '@dxos/react-ui/testing';
@@ -81,7 +82,7 @@ const DefaultStory = () => {
 const meta = {
   title: 'plugins/plugin-game/components/CreateGamePanel',
   component: DefaultStory,
-  decorators: [withTheme(), withLayout({ layout: 'fullscreen' })],
+  decorators: [withTheme(), withLayout({ layout: 'fullscreen' }), withPluginManager()],
   parameters: { layout: 'fullscreen', translations },
 } satisfies Meta<typeof DefaultStory>;
 

package/src/containers/GameArticle/GameArticle.tsx

@@ -6,24 +6,20 @@ import React from 'react';
 
 import { useCapabilities } from '@dxos/app-framework/ui';
 import { type AppSurface } from '@dxos/app-toolkit/ui';
-import { Obj, type Ref } from '@dxos/echo';
-import { useObject } from '@dxos/echo-react';
+import { Obj } from '@dxos/echo';
+import { useResolveRef } from '@dxos/echo-react';
 import { useTranslation } from '@dxos/react-ui';
 
 import { meta } from '#meta';
 import { type Game, GameCapabilities } from '#types';
 
-export type GameArticleProps = AppSurface.ObjectArticleProps<Game>;
+export type GameArticleProps = AppSurface.ObjectArticleProps<Game.Game>;
 
 export const GameArticle = ({ role, attendableId, subject: game }: GameArticleProps) => {
   const { t } = useTranslation(meta.profile.key);
   const variants = useCapabilities(GameCapabilities.VariantProvider);
-  const ref = game.variant as Ref.Ref<Obj.Unknown>;
-  // Subscribe via useObject so the article re-renders when the variant ref loads or changes.
-  // The snapshot is discarded; we pass the live ref target to variant components so they can
-  // subscribe to their own properties via useObject(state, 'prop').
-  useObject(ref);
-  const variant = ref?.target as Obj.Unknown | undefined;
+  // Resolved live rather than as a snapshot: variants mutate their state, and a snapshot is frozen.
+  const variant = useResolveRef(game.variant);
 
   if (!variant) {
     return null;
@@ -40,3 +36,5 @@ export const GameArticle = ({ role, attendableId, subject: game }: GameArticlePr
   const Component = match.article;
   return <Component game={game} variant={variant} role={role} attendableId={attendableId} />;
 };
+
+GameArticle.displayName = 'GameArticle';

package/src/containers/GameCard/GameCard.tsx

@@ -6,19 +6,17 @@ import React from 'react';
 
 import { useCapabilities } from '@dxos/app-framework/ui';
 import { type AppSurface } from '@dxos/app-toolkit/ui';
-import { Obj, type Ref } from '@dxos/echo';
-import { useObject } from '@dxos/echo-react';
+import { Obj } from '@dxos/echo';
+import { useResolveRef } from '@dxos/echo-react';
 
 import { type Game, GameCapabilities } from '#types';
 
-export type GameCardProps = AppSurface.ObjectCardProps<Game>;
+export type GameCardProps = AppSurface.ObjectCardProps<Game.Game>;
 
 export const GameCard = ({ role, subject: game }: GameCardProps) => {
   const variants = useCapabilities(GameCapabilities.VariantProvider);
-  const ref = game.variant as Ref.Ref<Obj.Unknown>;
-  // Subscribe for re-renders; pass the live ref target down to variant components.
-  useObject(ref);
-  const variant = ref?.target as Obj.Unknown | undefined;
+  // Resolved live rather than as a snapshot: variants mutate their state, and a snapshot is frozen.
+  const variant = useResolveRef(game.variant);
 
   if (!variant) {
     return null;
@@ -33,3 +31,5 @@ export const GameCard = ({ role, subject: game }: GameCardProps) => {
   const Component = match.card;
   return <Component game={game} variant={variant} role={role} />;
 };
+
+GameCard.displayName = 'GameCard';

package/src/translations.ts

@@ -11,7 +11,7 @@ import { Game } from '#types';
 export const translations = [
   {
     'en-US': {
-      [Type.getTypename(Game)]: {
+      [Type.getTypename(Game.Game)]: {
         'typename.label': 'Game',
         'typename.label_zero': 'Games',
         'typename.label_one': 'Game',

package/src/types/Game.ts

@@ -4,9 +4,11 @@
 
 import * as Schema from 'effect/Schema';
 
-import { AppAnnotation } from '@dxos/app-toolkit';
 import { Annotation, DXN, Obj, Ref, Type } from '@dxos/echo';
 import { FormInputAnnotation, LabelAnnotation } from '@dxos/echo/Annotation';
+import { CardAnnotation } from '@dxos/schema';
+
+// @import-as-namespace
 
 /**
  * A player in a game.
@@ -49,7 +51,7 @@ export class Game extends Type.makeObject<Game>(DXN.make('org.dxos.type.game', '
   }).pipe(
     LabelAnnotation.set(['name']),
     Annotation.IconAnnotation.set({ icon: 'ph--sword--regular', hue: 'indigo' }),
-    AppAnnotation.CardAnnotation.set(true),
+    CardAnnotation.set(true),
     // Delegate the graph-node icon to the referenced variant state's schema. Falls back to
     // the static `ph--sword--regular` above while the variant ref is still loading.
     Annotation.IconFromRefAnnotation.set('variant'),

package/src/types/index.ts

@@ -2,7 +2,7 @@
 // Copyright 2026 DXOS.org
 //
 
-export { Game, GameRef, Player, make } from './Game';
+export * as Game from './Game';
 export * from './types';
 export { GameVariantMismatchError, loadGame } from '../util/load-game';
 

package/src/types/types.ts

@@ -8,10 +8,10 @@ import type { ComponentType } from 'react';
 
 import type { Database, Obj, Type } from '@dxos/echo';
 
-import type { Game } from './Game';
+import * as Game from './Game';
 
 /**
- * Contribution from a variant plugin (e.g. plugin-chess, plugin-tictactoe).
+ * Contribution from a variant plugin (e.g. plugin-chess).
  * Defines how a game variant is created, rendered, and the roles its players take.
  */
 export type GameVariant = {
@@ -43,9 +43,13 @@ export type GameVariant = {
 
 export type GameVariantSurfaceProps = {
   /** The base Game object (may be a snapshot from useObject/Surface). */
-  game: Obj.Snapshot<Game> | Game;
-  /** The resolved variant state object (may be a snapshot from useObject). */
-  variant: Obj.Snapshot<Obj.Unknown> | Obj.Unknown;
+  game: Obj.Snapshot<Game.Game> | Game.Game;
+  /**
+   * The resolved variant state object, live rather than a snapshot so variants can write to it.
+   * Reads must subscribe via `useObject(variant, prop)` — the host re-renders only when the ref
+   * resolves, not on every mutation.
+   */
+  variant: Obj.Unknown;
   /** Surface role passed through from the host. */
   role?: string;
   /** Attendable id passed through from the host. */

package/src/util/load-game.ts

@@ -6,7 +6,7 @@ import * as Effect from 'effect/Effect';
 
 import { Database, Obj, type Ref, Type } from '@dxos/echo';
 
-import { Game } from '../types/Game';
+import * as Game from '../types/Game';
 
 export class GameVariantMismatchError extends Error {
   readonly _tag = 'GameVariantMismatchError';
@@ -26,9 +26,9 @@ export class GameVariantMismatchError extends Error {
  * Use in operation handlers that declare `input.game: GameRef<MyVariantState>`.
  */
 export const loadGame = <S extends Type.AnyObj>(
-  ref: Ref.Ref<Game>,
+  ref: Ref.Ref<Game.Game>,
   variantType: S,
-): Effect.Effect<{ game: Game; variant: Type.InstanceType<S> }, Error, Database.Service> =>
+): Effect.Effect<{ game: Game.Game; variant: Type.InstanceType<S> }, Error, Database.Service> =>
   Effect.gen(function* () {
     const game = yield* Database.load(ref);
     const variant = yield* Database.load(game.variant);

package/dist/lib/neutral/GameArticle-AUJ4YDKW.mjs

@@ -1,40 +0,0 @@
-import "./chunk-J5LGTIGS.mjs";
-
-// src/containers/GameArticle/GameArticle.tsx
-import React from "react";
-import { useCapabilities } from "@dxos/app-framework/ui";
-import { Obj } from "@dxos/echo";
-import { useObject } from "@dxos/echo-react";
-import { useTranslation } from "@dxos/react-ui";
-import { meta } from "#meta";
-import { GameCapabilities } from "#types";
-var GameArticle = ({ role, attendableId, subject: game }) => {
-  const { t } = useTranslation(meta.profile.key);
-  const variants = useCapabilities(GameCapabilities.VariantProvider);
-  const ref = game.variant;
-  useObject(ref);
-  const variant = ref?.target;
-  if (!variant) {
-    return null;
-  }
-  const variantTypename = Obj.getTypename(variant);
-  const match = variants.find((v) => v.id === variantTypename);
-  if (!match?.article) {
-    return /* @__PURE__ */ React.createElement("div", {
-      className: "p-4 text-sm"
-    }, t("unsupported-variant.label", {
-      defaultValue: "Unsupported game variant"
-    }));
-  }
-  const Component = match.article;
-  return /* @__PURE__ */ React.createElement(Component, {
-    game,
-    variant,
-    role,
-    attendableId
-  });
-};
-export {
-  GameArticle as default
-};
-//# sourceMappingURL=GameArticle-AUJ4YDKW.mjs.map

package/dist/lib/neutral/GameArticle-AUJ4YDKW.mjs.map

@@ -1,7 +0,0 @@
-{
-  "version": 3,
-  "sources": ["../../../src/containers/GameArticle/GameArticle.tsx"],
-  "sourcesContent": ["//\n// Copyright 2026 DXOS.org\n//\n\nimport React from 'react';\n\nimport { useCapabilities } from '@dxos/app-framework/ui';\nimport { type AppSurface } from '@dxos/app-toolkit/ui';\nimport { Obj, type Ref } from '@dxos/echo';\nimport { useObject } from '@dxos/echo-react';\nimport { useTranslation } from '@dxos/react-ui';\n\nimport { meta } from '#meta';\nimport { type Game, GameCapabilities } from '#types';\n\nexport type GameArticleProps = AppSurface.ObjectArticleProps<Game>;\n\nexport const GameArticle = ({ role, attendableId, subject: game }: GameArticleProps) => {\n  const { t } = useTranslation(meta.profile.key);\n  const variants = useCapabilities(GameCapabilities.VariantProvider);\n  const ref = game.variant as Ref.Ref<Obj.Unknown>;\n  // Subscribe via useObject so the article re-renders when the variant ref loads or changes.\n  // The snapshot is discarded; we pass the live ref target to variant components so they can\n  // subscribe to their own properties via useObject(state, 'prop').\n  useObject(ref);\n  const variant = ref?.target as Obj.Unknown | undefined;\n\n  if (!variant) {\n    return null;\n  }\n\n  const variantTypename = Obj.getTypename(variant);\n  const match = variants.find((v) => v.id === variantTypename);\n  if (!match?.article) {\n    return (\n      <div className='p-4 text-sm'>{t('unsupported-variant.label', { defaultValue: 'Unsupported game variant' })}</div>\n    );\n  }\n\n  const Component = match.article;\n  return <Component game={game} variant={variant} role={role} attendableId={attendableId} />;\n};\n"],
-  "mappings": ";;;AAIA,OAAOA,WAAW;AAElB,SAASC,uBAAuB;AAEhC,SAASC,WAAqB;AAC9B,SAASC,iBAAiB;AAC1B,SAASC,sBAAsB;AAE/B,SAASC,YAAY;AACrB,SAAoBC,wBAAwB;AAIrC,IAAMC,cAAc,CAAC,EAAEC,MAAMC,cAAcC,SAASC,KAAI,MAAoB;AACjF,QAAM,EAAEC,EAAC,IAAKR,eAAeC,KAAKQ,QAAQC,GAAG;AAC7C,QAAMC,WAAWd,gBAAgBK,iBAAiBU,eAAe;AACjE,QAAMC,MAAMN,KAAKO;AAIjBf,YAAUc,GAAAA;AACV,QAAMC,UAAUD,KAAKE;AAErB,MAAI,CAACD,SAAS;AACZ,WAAO;EACT;AAEA,QAAME,kBAAkBlB,IAAImB,YAAYH,OAAAA;AACxC,QAAMI,QAAQP,SAASQ,KAAK,CAACC,MAAMA,EAAEC,OAAOL,eAAAA;AAC5C,MAAI,CAACE,OAAOI,SAAS;AACnB,WACE,sBAAA,cAACC,OAAAA;MAAIC,WAAU;OAAehB,EAAE,6BAA6B;MAAEiB,cAAc;IAA2B,CAAA,CAAA;EAE5G;AAEA,QAAMC,YAAYR,MAAMI;AACxB,SAAO,sBAAA,cAACI,WAAAA;IAAUnB;IAAYO;IAAkBV;IAAYC;;AAC9D;",
-  "names": ["React", "useCapabilities", "Obj", "useObject", "useTranslation", "meta", "GameCapabilities", "GameArticle", "role", "attendableId", "subject", "game", "t", "profile", "key", "variants", "VariantProvider", "ref", "variant", "target", "variantTypename", "getTypename", "match", "find", "v", "id", "article", "div", "className", "defaultValue", "Component"]
-}

package/dist/lib/neutral/GameCard-QBKHIL4Q.mjs

@@ -1,32 +0,0 @@
-import "./chunk-J5LGTIGS.mjs";
-
-// src/containers/GameCard/GameCard.tsx
-import React from "react";
-import { useCapabilities } from "@dxos/app-framework/ui";
-import { Obj } from "@dxos/echo";
-import { useObject } from "@dxos/echo-react";
-import { GameCapabilities } from "#types";
-var GameCard = ({ role, subject: game }) => {
-  const variants = useCapabilities(GameCapabilities.VariantProvider);
-  const ref = game.variant;
-  useObject(ref);
-  const variant = ref?.target;
-  if (!variant) {
-    return null;
-  }
-  const variantTypename = Obj.getTypename(variant);
-  const match = variants.find((v) => v.id === variantTypename);
-  if (!match?.card) {
-    return null;
-  }
-  const Component = match.card;
-  return /* @__PURE__ */ React.createElement(Component, {
-    game,
-    variant,
-    role
-  });
-};
-export {
-  GameCard as default
-};
-//# sourceMappingURL=GameCard-QBKHIL4Q.mjs.map

package/dist/lib/neutral/GameCard-QBKHIL4Q.mjs.map

@@ -1,7 +0,0 @@
-{
-  "version": 3,
-  "sources": ["../../../src/containers/GameCard/GameCard.tsx"],
-  "sourcesContent": ["//\n// Copyright 2026 DXOS.org\n//\n\nimport React from 'react';\n\nimport { useCapabilities } from '@dxos/app-framework/ui';\nimport { type AppSurface } from '@dxos/app-toolkit/ui';\nimport { Obj, type Ref } from '@dxos/echo';\nimport { useObject } from '@dxos/echo-react';\n\nimport { type Game, GameCapabilities } from '#types';\n\nexport type GameCardProps = AppSurface.ObjectCardProps<Game>;\n\nexport const GameCard = ({ role, subject: game }: GameCardProps) => {\n  const variants = useCapabilities(GameCapabilities.VariantProvider);\n  const ref = game.variant as Ref.Ref<Obj.Unknown>;\n  // Subscribe for re-renders; pass the live ref target down to variant components.\n  useObject(ref);\n  const variant = ref?.target as Obj.Unknown | undefined;\n\n  if (!variant) {\n    return null;\n  }\n\n  const variantTypename = Obj.getTypename(variant);\n  const match = variants.find((v) => v.id === variantTypename);\n  if (!match?.card) {\n    return null;\n  }\n\n  const Component = match.card;\n  return <Component game={game} variant={variant} role={role} />;\n};\n"],
-  "mappings": ";;;AAIA,OAAOA,WAAW;AAElB,SAASC,uBAAuB;AAEhC,SAASC,WAAqB;AAC9B,SAASC,iBAAiB;AAE1B,SAAoBC,wBAAwB;AAIrC,IAAMC,WAAW,CAAC,EAAEC,MAAMC,SAASC,KAAI,MAAiB;AAC7D,QAAMC,WAAWR,gBAAgBG,iBAAiBM,eAAe;AACjE,QAAMC,MAAMH,KAAKI;AAEjBT,YAAUQ,GAAAA;AACV,QAAMC,UAAUD,KAAKE;AAErB,MAAI,CAACD,SAAS;AACZ,WAAO;EACT;AAEA,QAAME,kBAAkBZ,IAAIa,YAAYH,OAAAA;AACxC,QAAMI,QAAQP,SAASQ,KAAK,CAACC,MAAMA,EAAEC,OAAOL,eAAAA;AAC5C,MAAI,CAACE,OAAOI,MAAM;AAChB,WAAO;EACT;AAEA,QAAMC,YAAYL,MAAMI;AACxB,SAAO,sBAAA,cAACC,WAAAA;IAAUb;IAAYI;IAAkBN;;AAClD;",
-  "names": ["React", "useCapabilities", "Obj", "useObject", "GameCapabilities", "GameCard", "role", "subject", "game", "variants", "VariantProvider", "ref", "variant", "target", "variantTypename", "getTypename", "match", "find", "v", "id", "card", "Component"]
-}

package/dist/lib/neutral/GamePlugin.mjs

@@ -1,38 +0,0 @@
-import "./chunk-J5LGTIGS.mjs";
-
-// src/GamePlugin.tsx
-import { Plugin } from "@dxos/app-framework";
-import { AppPlugin } from "@dxos/app-toolkit";
-import { CreateObject, ReactSurface } from "#capabilities";
-import { meta } from "#meta";
-import { translations } from "#translations";
-import { Game } from "#types";
-
-// raw-loader:/__w/dxos/dxos/packages/plugins/plugin-game/PLUGIN.mdl
-var PLUGIN_default = '---\nid: org.dxos.plugin.game\nname: GamePlugin\nversion: 0.1.0\n---\n\nA generic game host plugin for `DXOS` Composer that provides shared infrastructure for\nmulti-player, local-first turn-based games. Variant plugins (e.g. plugin-chess,\nplugin-tictactoe) contribute a `GameVariant` capability and game-specific surfaces;\nplugin-game supplies the `Game` ECHO type, create flow, and dispatch scaffolding.\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\n## Types\n\n```mdl\ntype Player\n  fields:\n    role: string          # variant-defined (e.g. "white", "x"); required\n    identity?: string     # DID of a human player; absent for AI / empty seats\n    name?: string         # display label for AI or guest players\n```\n\n```mdl\ntype Game\n  fields:\n    name?: string\n    players?: Player[]    # populated during or after creation\n    variant: Ref<Unknown> # reference to variant-specific state object (e.g. Chess.State)\n  typename: org.dxos.type.game\n  version: 0.1.0\n```\n\n```mdl\ntype GameVariant\n  desc: |\n    Contribution interface from a variant plugin. Registered via\n    `Capability.contributes(GameCapabilities.VariantProvider, variant)`.\n  fields:\n    id: string                  # stable variant id; matches the variant state typename\n    label: string               # human-readable name shown in the picker\n    icon?: string               # Phosphor icon name\n    variantSchema: Schema       # Effect/Schema for the ECHO state object\n    inputSchema?: Schema        # optional form schema shown after variant is selected\n    roles: string[]             # player roles (e.g. ["white", "black"])\n    createVariant: Effect       # factory that builds the variant ECHO state object\n    card?: ComponentType        # optional Card surface component\n    article?: ComponentType     # optional Article/Section surface component\n```\n\n## Components\n\n```mdl\ncomponent CreateGamePanel\n  desc: |\n    Two-stage creation panel. Stage 1 shows a searchable variant picker.\n    Stage 2 (optional) shows a form rendered from the variant\'s inputSchema.\n  props:\n    target: Space | Obj\n    onCreateObject: (args: { variantId: string; input?: Record }) => void\n    variants?: GameVariant[]    # override; defaults to GameCapabilities.VariantProvider\n  state:\n    selectedId?: string         # id of the variant chosen in stage 1\n  actions:\n    selectVariant(id: string)\n    submitForm(input: Record)\n  layout: |\n    \u250C\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2510\n    \u2502 Stage 1: Variant Picker \u2502\n    \u2502  \u250C\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2510  \u2502\n    \u2502  \u2502 Search input      \u2502  \u2502\n    \u2502  \u251C\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2524  \u2502\n    \u2502  \u2502 variant row       \u2502  \u2502\n    \u2502  \u2502 variant row       \u2502  \u2502\n    \u2502  \u2514\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2518  \u2502\n    \u251C\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2524\n    \u2502 Stage 2: Input Form     \u2502\n    \u2502  (rendered from schema) \u2502\n    \u2502  [Submit]               \u2502\n    \u2514\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2518\n```\n\n```mdl\ncomponent GameArticle\n  desc: |\n    Article / Section surface for Game objects. Resolves the variant via\n    `game.variant` ref, finds the matching `GameVariant` by typename, and\n    delegates rendering to `variant.article`.\n  props:\n    game: Game\n    role?: string\n    attendableId?: string\n  state:\n    variant: Unknown            # live variant state object from the Ref\n    match?: GameVariant         # resolved GameVariant from capabilities\n  layout: |\n    \u250C\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2510\n    \u2502 [variant.article]       \u2502\n    \u2502  (fallback: unsupported \u2502\n    \u2502   variant message)      \u2502\n    \u2514\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2518\n```\n\n```mdl\ncomponent GameCard\n  desc: |\n    Card surface for Game objects. Follows the same variant-resolution\n    logic as GameArticle and delegates to `variant.card`.\n  props:\n    game: Game\n    role?: string\n  state:\n    variant: Unknown\n    match?: GameVariant\n```\n\n## Operations\n\n```mdl\nop createGame\n  desc: |\n    Creates a variant state object via `variant.createVariant`, adds it\n    to the space as a hidden object, then wraps it in a top-level Game.\n    If the second write fails the variant state object is rolled back.\n  input:\n    variantId: string\n    input?: Record              # variant-specific form values\n    target: Space | Obj\n    targetNodeId?: string\n  output: Game\n  errors:\n    UnknownVariant: no registered GameVariant matches variantId\n  effects: [echo:write]\n  requires: [GameCapabilities.VariantProvider, SpaceOperation.AddObject, SpaceOperation.RemoveObjects]\n  note: |\n    Invoked by CreateObjectEntry.createObject.\n    Variant state is added with `hidden: true` so it does not appear\n    as a top-level item in the user\'s space graph.\n```\n\n## Features\n\n```mdl\nfeat F-1: Variant Registration\n\n  req F-1.1:\n    when: a variant plugin loads\n    then: it contributes a GameVariant via `Capability.contributes(GameCapabilities.VariantProvider, \u2026)`\n\n  req F-1.2:\n    when: GameCapabilities.VariantProvider contributions are queried\n    then: all registered variants are returned as an ordered list\n```\n\n```mdl\nfeat F-2: Game Creation\n\n  req F-2.1:\n    when: user opens the create-object flow for type `org.dxos.type.game`\n    then: CreateGamePanel is shown with a searchable list of available variants\n\n  req F-2.2:\n    when: user selects a variant with no inputSchema\n    then: op:createGame is invoked immediately with empty input\n\n  req F-2.3:\n    when: user selects a variant that has an inputSchema\n    then: a form rendered from the schema is shown; op:createGame is invoked on submit\n\n  req F-2.4:\n    when: op:createGame completes\n    then: a Game object appears in the space graph; variant state is hidden\n```\n\n```mdl\nfeat F-3: Game Article / Card Rendering\n\n  req F-3.1:\n    when: Composer navigates to a Game object\n    then: GameArticle resolves `game.variant` and delegates to the matching `variant.article`\n\n  req F-3.2:\n    when: a Game object is shown in a Card layout\n    then: GameCard resolves `game.variant` and delegates to `variant.card`\n\n  req F-3.3:\n    when: no matching variant is found for the loaded state object\n    then: GameArticle renders an "Unsupported game variant" fallback message\n\n  req F-3.4:\n    when: the variant ref is not yet loaded\n    then: neither GameArticle nor GameCard renders (returns null)\n```\n\n## Acceptance\n\n```mdl\ntest T-1: Variant picker shows all contributions\n  given: two variant plugins have contributed GameVariants\n  when: the user opens the create-game panel\n  then:\n    - CreateGamePanel lists both variants\n    - variants are sorted alphabetically\n```\n\n```mdl\ntest T-2: Create game without form\n  given: a variant with no inputSchema is selected\n  when: user clicks the variant item\n  then:\n    - onCreateObject is called immediately with { variantId }\n    - no form is shown\n```\n\n```mdl\ntest T-3: Create game with form\n  given: a variant with an inputSchema is selected\n  when: user fills and submits the form\n  then:\n    - onCreateObject is called with { variantId, input: <form values> }\n```\n\n```mdl\ntest T-4: Atomic game creation\n  given: a valid variantId and target space\n  when: op:createGame is invoked\n  then:\n    - variant state object added to space (hidden)\n    - Game object added with game.variant pointing to the state object\n    - both writes are visible to other peers via ECHO replication\n```\n\n```mdl\ntest T-5: Rollback on second write failure\n  given: variant state is successfully written\n  when: the second write (Game object) fails\n  then:\n    - RemoveObjects is invoked for the variant state\n    - no orphaned state object remains in the space\n```\n\n```mdl\ntest T-6: Unknown variant rejected\n  given: op:createGame is invoked with an unregistered variantId\n  when: the handler runs\n  then: UnknownVariant error is returned; no ECHO writes occur\n```\n\n```mdl\ntest T-7: Unsupported variant fallback\n  given: a Game whose variant typename has no registered GameVariant\n  when: GameArticle renders\n  then: "Unsupported game variant" message is shown instead of crashing\n```\n\n---\n\n## Appendix: Extension Definitions\n\nExtension block types used in this document are defined below using\nthe core `ext` primitive \u2014 the only construct the base language provides.\n\n```mdl\next type\n  uri: org.dxos.mdl.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: org.dxos.mdl.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: org.dxos.mdl.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';
-
-// src/GamePlugin.tsx
-var GamePlugin = Plugin.define(meta).pipe(AppPlugin.addCreateObjectModule({
-  activate: CreateObject
-}), AppPlugin.addSchemaModule({
-  schema: [
-    Game
-  ]
-}), AppPlugin.addSurfaceModule({
-  activate: ReactSurface
-}), AppPlugin.addTranslationsModule({
-  translations
-}), AppPlugin.addPluginAssetModule({
-  asset: {
-    pluginId: meta.profile.key,
-    path: "PLUGIN.mdl",
-    content: PLUGIN_default,
-    mimeType: "application/x-mdl"
-  }
-}), Plugin.make);
-var GamePlugin_default = GamePlugin;
-export {
-  GamePlugin,
-  GamePlugin_default as default
-};
-//# sourceMappingURL=GamePlugin.mjs.map

package/dist/lib/neutral/GamePlugin.mjs.map

@@ -1,7 +0,0 @@
-{
-  "version": 3,
-  "sources": ["../../../src/GamePlugin.tsx", "raw-loader:/__w/dxos/dxos/packages/plugins/plugin-game/PLUGIN.mdl"],
-  "sourcesContent": ["//\n// Copyright 2026 DXOS.org\n//\n\nimport { Plugin } from '@dxos/app-framework';\nimport { AppPlugin } from '@dxos/app-toolkit';\n\nimport { CreateObject, ReactSurface } from '#capabilities';\nimport { meta } from '#meta';\nimport { translations } from '#translations';\nimport { Game } from '#types';\n\n// eslint-disable-next-line import/no-relative-packages\nimport pluginSpec from '../PLUGIN.mdl?raw';\n\nexport const GamePlugin = Plugin.define(meta).pipe(\n  AppPlugin.addCreateObjectModule({ activate: CreateObject }),\n  AppPlugin.addSchemaModule({ schema: [Game] }),\n  AppPlugin.addSurfaceModule({ activate: ReactSurface }),\n  AppPlugin.addTranslationsModule({ translations }),\n  AppPlugin.addPluginAssetModule({\n    asset: { pluginId: meta.profile.key, path: 'PLUGIN.mdl', content: pluginSpec, mimeType: 'application/x-mdl' },\n  }),\n  Plugin.make,\n);\n\nexport default GamePlugin;\n", "---\nid: org.dxos.plugin.game\nname: GamePlugin\nversion: 0.1.0\n---\n\nA generic game host plugin for `DXOS` Composer that provides shared infrastructure for\nmulti-player, local-first turn-based games. Variant plugins (e.g. plugin-chess,\nplugin-tictactoe) contribute a `GameVariant` capability and game-specific surfaces;\nplugin-game supplies the `Game` ECHO type, create flow, and dispatch scaffolding.\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\n## Types\n\n```mdl\ntype Player\n  fields:\n    role: string          # variant-defined (e.g. \"white\", \"x\"); required\n    identity?: string     # DID of a human player; absent for AI / empty seats\n    name?: string         # display label for AI or guest players\n```\n\n```mdl\ntype Game\n  fields:\n    name?: string\n    players?: Player[]    # populated during or after creation\n    variant: Ref<Unknown> # reference to variant-specific state object (e.g. Chess.State)\n  typename: org.dxos.type.game\n  version: 0.1.0\n```\n\n```mdl\ntype GameVariant\n  desc: |\n    Contribution interface from a variant plugin. Registered via\n    `Capability.contributes(GameCapabilities.VariantProvider, variant)`.\n  fields:\n    id: string                  # stable variant id; matches the variant state typename\n    label: string               # human-readable name shown in the picker\n    icon?: string               # Phosphor icon name\n    variantSchema: Schema       # Effect/Schema for the ECHO state object\n    inputSchema?: Schema        # optional form schema shown after variant is selected\n    roles: string[]             # player roles (e.g. [\"white\", \"black\"])\n    createVariant: Effect       # factory that builds the variant ECHO state object\n    card?: ComponentType        # optional Card surface component\n    article?: ComponentType     # optional Article/Section surface component\n```\n\n## Components\n\n```mdl\ncomponent CreateGamePanel\n  desc: |\n    Two-stage creation panel. Stage 1 shows a searchable variant picker.\n    Stage 2 (optional) shows a form rendered from the variant's inputSchema.\n  props:\n    target: Space | Obj\n    onCreateObject: (args: { variantId: string; input?: Record }) => void\n    variants?: GameVariant[]    # override; defaults to GameCapabilities.VariantProvider\n  state:\n    selectedId?: string         # id of the variant chosen in stage 1\n  actions:\n    selectVariant(id: string)\n    submitForm(input: Record)\n  layout: |\n    \u250C\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2510\n    \u2502 Stage 1: Variant Picker \u2502\n    \u2502  \u250C\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2510  \u2502\n    \u2502  \u2502 Search input      \u2502  \u2502\n    \u2502  \u251C\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2524  \u2502\n    \u2502  \u2502 variant row       \u2502  \u2502\n    \u2502  \u2502 variant row       \u2502  \u2502\n    \u2502  \u2514\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2518  \u2502\n    \u251C\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2524\n    \u2502 Stage 2: Input Form     \u2502\n    \u2502  (rendered from schema) \u2502\n    \u2502  [Submit]               \u2502\n    \u2514\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2518\n```\n\n```mdl\ncomponent GameArticle\n  desc: |\n    Article / Section surface for Game objects. Resolves the variant via\n    `game.variant` ref, finds the matching `GameVariant` by typename, and\n    delegates rendering to `variant.article`.\n  props:\n    game: Game\n    role?: string\n    attendableId?: string\n  state:\n    variant: Unknown            # live variant state object from the Ref\n    match?: GameVariant         # resolved GameVariant from capabilities\n  layout: |\n    \u250C\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2510\n    \u2502 [variant.article]       \u2502\n    \u2502  (fallback: unsupported \u2502\n    \u2502   variant message)      \u2502\n    \u2514\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2518\n```\n\n```mdl\ncomponent GameCard\n  desc: |\n    Card surface for Game objects. Follows the same variant-resolution\n    logic as GameArticle and delegates to `variant.card`.\n  props:\n    game: Game\n    role?: string\n  state:\n    variant: Unknown\n    match?: GameVariant\n```\n\n## Operations\n\n```mdl\nop createGame\n  desc: |\n    Creates a variant state object via `variant.createVariant`, adds it\n    to the space as a hidden object, then wraps it in a top-level Game.\n    If the second write fails the variant state object is rolled back.\n  input:\n    variantId: string\n    input?: Record              # variant-specific form values\n    target: Space | Obj\n    targetNodeId?: string\n  output: Game\n  errors:\n    UnknownVariant: no registered GameVariant matches variantId\n  effects: [echo:write]\n  requires: [GameCapabilities.VariantProvider, SpaceOperation.AddObject, SpaceOperation.RemoveObjects]\n  note: |\n    Invoked by CreateObjectEntry.createObject.\n    Variant state is added with `hidden: true` so it does not appear\n    as a top-level item in the user's space graph.\n```\n\n## Features\n\n```mdl\nfeat F-1: Variant Registration\n\n  req F-1.1:\n    when: a variant plugin loads\n    then: it contributes a GameVariant via `Capability.contributes(GameCapabilities.VariantProvider, \u2026)`\n\n  req F-1.2:\n    when: GameCapabilities.VariantProvider contributions are queried\n    then: all registered variants are returned as an ordered list\n```\n\n```mdl\nfeat F-2: Game Creation\n\n  req F-2.1:\n    when: user opens the create-object flow for type `org.dxos.type.game`\n    then: CreateGamePanel is shown with a searchable list of available variants\n\n  req F-2.2:\n    when: user selects a variant with no inputSchema\n    then: op:createGame is invoked immediately with empty input\n\n  req F-2.3:\n    when: user selects a variant that has an inputSchema\n    then: a form rendered from the schema is shown; op:createGame is invoked on submit\n\n  req F-2.4:\n    when: op:createGame completes\n    then: a Game object appears in the space graph; variant state is hidden\n```\n\n```mdl\nfeat F-3: Game Article / Card Rendering\n\n  req F-3.1:\n    when: Composer navigates to a Game object\n    then: GameArticle resolves `game.variant` and delegates to the matching `variant.article`\n\n  req F-3.2:\n    when: a Game object is shown in a Card layout\n    then: GameCard resolves `game.variant` and delegates to `variant.card`\n\n  req F-3.3:\n    when: no matching variant is found for the loaded state object\n    then: GameArticle renders an \"Unsupported game variant\" fallback message\n\n  req F-3.4:\n    when: the variant ref is not yet loaded\n    then: neither GameArticle nor GameCard renders (returns null)\n```\n\n## Acceptance\n\n```mdl\ntest T-1: Variant picker shows all contributions\n  given: two variant plugins have contributed GameVariants\n  when: the user opens the create-game panel\n  then:\n    - CreateGamePanel lists both variants\n    - variants are sorted alphabetically\n```\n\n```mdl\ntest T-2: Create game without form\n  given: a variant with no inputSchema is selected\n  when: user clicks the variant item\n  then:\n    - onCreateObject is called immediately with { variantId }\n    - no form is shown\n```\n\n```mdl\ntest T-3: Create game with form\n  given: a variant with an inputSchema is selected\n  when: user fills and submits the form\n  then:\n    - onCreateObject is called with { variantId, input: <form values> }\n```\n\n```mdl\ntest T-4: Atomic game creation\n  given: a valid variantId and target space\n  when: op:createGame is invoked\n  then:\n    - variant state object added to space (hidden)\n    - Game object added with game.variant pointing to the state object\n    - both writes are visible to other peers via ECHO replication\n```\n\n```mdl\ntest T-5: Rollback on second write failure\n  given: variant state is successfully written\n  when: the second write (Game object) fails\n  then:\n    - RemoveObjects is invoked for the variant state\n    - no orphaned state object remains in the space\n```\n\n```mdl\ntest T-6: Unknown variant rejected\n  given: op:createGame is invoked with an unregistered variantId\n  when: the handler runs\n  then: UnknownVariant error is returned; no ECHO writes occur\n```\n\n```mdl\ntest T-7: Unsupported variant fallback\n  given: a Game whose variant typename has no registered GameVariant\n  when: GameArticle renders\n  then: \"Unsupported game variant\" message is shown instead of crashing\n```\n\n---\n\n## Appendix: Extension Definitions\n\nExtension block types used in this document are defined below using\nthe core `ext` primitive \u2014 the only construct the base language provides.\n\n```mdl\next type\n  uri: org.dxos.mdl.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: org.dxos.mdl.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: org.dxos.mdl.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"],
-  "mappings": ";;;AAIA,SAASA,cAAc;AACvB,SAASC,iBAAiB;AAE1B,SAASC,cAAcC,oBAAoB;AAC3C,SAASC,YAAY;AACrB,SAASC,oBAAoB;AAC7B,SAASC,YAAY;;;ACVrB;;;ADeO,IAAMC,aAAaC,OAAOC,OAAOC,IAAAA,EAAMC,KAC5CC,UAAUC,sBAAsB;EAAEC,UAAUC;AAAa,CAAA,GACzDH,UAAUI,gBAAgB;EAAEC,QAAQ;IAACC;;AAAM,CAAA,GAC3CN,UAAUO,iBAAiB;EAAEL,UAAUM;AAAa,CAAA,GACpDR,UAAUS,sBAAsB;EAAEC;AAAa,CAAA,GAC/CV,UAAUW,qBAAqB;EAC7BC,OAAO;IAAEC,UAAUf,KAAKgB,QAAQC;IAAKC,MAAM;IAAcC,SAASC;IAAYC,UAAU;EAAoB;AAC9G,CAAA,GACAvB,OAAOwB,IAAI;AAGb,IAAA,qBAAezB;",
-  "names": ["Plugin", "AppPlugin", "CreateObject", "ReactSurface", "meta", "translations", "Game", "GamePlugin", "Plugin", "define", "meta", "pipe", "AppPlugin", "addCreateObjectModule", "activate", "CreateObject", "addSchemaModule", "schema", "Game", "addSurfaceModule", "ReactSurface", "addTranslationsModule", "translations", "addPluginAssetModule", "asset", "pluginId", "profile", "key", "path", "content", "pluginSpec", "mimeType", "make"]
-}