@dxos/plugin-game 0.10.0 → 0.11.1

package/dist/lib/GamePlugin.mjs

@@ -0,0 +1,18 @@
+import { Plugin } from "@dxos/app-framework";
+import { meta } from "#meta";
+import { AppPlugin } from "@dxos/app-toolkit";
+import { CreateObject, ReactSurface } from "#capabilities";
+import { translations } from "#translations";
+import { Game } from "#types";
+//#endregion
+//#region src/GamePlugin.tsx
+var GamePlugin = Plugin.define(meta).pipe(AppPlugin.addCreateObjectModule({ activate: CreateObject }), AppPlugin.addSchemaModule({ schema: [Game.Game] }), AppPlugin.addSurfaceModule({ activate: ReactSurface }), AppPlugin.addTranslationsModule({ translations }), AppPlugin.addPluginAssetModule({ asset: {
+	pluginId: meta.profile.key,
+	path: "PLUGIN.mdl",
+	content: "---\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    ┌─────────────────────────┐\n    │ Stage 1: Variant Picker │\n    │  ┌───────────────────┐  │\n    │  │ Search input      │  │\n    │  ├───────────────────┤  │\n    │  │ variant row       │  │\n    │  │ variant row       │  │\n    │  └───────────────────┘  │\n    ├─────────────────────────┤\n    │ Stage 2: Input Form     │\n    │  (rendered from schema) │\n    │  [Submit]               │\n    └─────────────────────────┘\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    ┌─────────────────────────┐\n    │ [variant.article]       │\n    │  (fallback: unsupported │\n    │   variant message)      │\n    └─────────────────────────┘\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, …)`\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 — 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",
+	mimeType: "application/x-mdl"
+} }), Plugin.make);
+//#endregion
+export { GamePlugin, GamePlugin as default };
+
+//# sourceMappingURL=GamePlugin.mjs.map

package/dist/lib/GamePlugin.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"GamePlugin.mjs","names":[],"sources":["../../src/GamePlugin.tsx"],"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.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"],"mappings":";;;;;;;;AAeA,IAAa,aAAa,OAAO,OAAO,IAAI,CAAC,CAAC,KAC5C,UAAU,sBAAsB,EAAE,UAAU,aAAa,CAAC,GAC1D,UAAU,gBAAgB,EAAE,QAAQ,CAAC,KAAK,IAAI,EAAE,CAAC,GACjD,UAAU,iBAAiB,EAAE,UAAU,aAAa,CAAC,GACrD,UAAU,sBAAsB,EAAE,aAAa,CAAC,GAChD,UAAU,qBAAqB,EAC7B,OAAO;CAAE,UAAU,KAAK,QAAQ;CAAK,MAAM;CAAc,SAAS;CAAY,UAAU;AAAoB,EAC9G,CAAC,GACD,OAAO,IACT"}

package/dist/lib/GamePlugin.node.mjs

@@ -0,0 +1,17 @@
+import { Plugin } from "@dxos/app-framework";
+import { meta } from "#meta";
+import { AppPlugin } from "@dxos/app-toolkit";
+import { translations } from "#translations";
+import { Game } from "#types";
+//#region src/GamePlugin.node.tsx
+/**
+* Headless variant of GamePlugin (no React surfaces / CreateObject panel).
+* Used in node contexts (CLI, agents, tests) where rendering is unavailable —
+* the full variant lazy-loads `CreateGamePanel` from `react-ui-search` which
+* downstream bundlers don't resolve cleanly under nested pnpm symlinks.
+*/
+var GamePlugin = Plugin.define(meta).pipe(AppPlugin.addSchemaModule({ schema: [Game.Game] }), AppPlugin.addTranslationsModule({ translations }), Plugin.make);
+//#endregion
+export { GamePlugin, GamePlugin as default };
+
+//# sourceMappingURL=GamePlugin.node.mjs.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"GamePlugin.node.mjs","names":[],"sources":["../../src/GamePlugin.node.tsx"],"sourcesContent":["//\n// Copyright 2026 DXOS.org\n//\n\nimport { Plugin } from '@dxos/app-framework';\nimport { AppPlugin } from '@dxos/app-toolkit';\n\nimport { meta } from '#meta';\nimport { translations } from '#translations';\nimport { Game } from '#types';\n\n/**\n * Headless variant of GamePlugin (no React surfaces / CreateObject panel).\n * Used in node contexts (CLI, agents, tests) where rendering is unavailable —\n * the full variant lazy-loads `CreateGamePanel` from `react-ui-search` which\n * downstream bundlers don't resolve cleanly under nested pnpm symlinks.\n */\nexport const GamePlugin = Plugin.define(meta).pipe(\n  AppPlugin.addSchemaModule({ schema: [Game.Game] }),\n  AppPlugin.addTranslationsModule({ translations }),\n  Plugin.make,\n);\n\nexport default GamePlugin;\n"],"mappings":";;;;;;;;;;;;AAiBA,IAAa,aAAa,OAAO,OAAO,IAAI,CAAC,CAAC,KAC5C,UAAU,gBAAgB,EAAE,QAAQ,CAAC,KAAK,IAAI,EAAE,CAAC,GACjD,UAAU,sBAAsB,EAAE,aAAa,CAAC,GAChD,OAAO,IACT"}

package/dist/lib/GamePlugin.workerd.mjs

@@ -0,0 +1,10 @@
+import { Plugin } from "@dxos/app-framework";
+import { meta } from "#meta";
+import { AppPlugin } from "@dxos/app-toolkit";
+import { Game } from "#types";
+//#region src/GamePlugin.workerd.tsx
+var GamePlugin = Plugin.define(meta).pipe(AppPlugin.addSchemaModule({ schema: [Game.Game] }), Plugin.make);
+//#endregion
+export { GamePlugin, GamePlugin as default };
+
+//# sourceMappingURL=GamePlugin.workerd.mjs.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"GamePlugin.workerd.mjs","names":[],"sources":["../../src/GamePlugin.workerd.tsx"],"sourcesContent":["//\n// Copyright 2026 DXOS.org\n//\n\nimport { Plugin } from '@dxos/app-framework';\nimport { AppPlugin } from '@dxos/app-toolkit';\n\nimport { meta } from '#meta';\nimport { Game } from '#types';\n\nexport const GamePlugin = Plugin.define(meta).pipe(AppPlugin.addSchemaModule({ schema: [Game.Game] }), Plugin.make);\n\nexport default GamePlugin;\n"],"mappings":";;;;;AAUA,IAAa,aAAa,OAAO,OAAO,IAAI,CAAC,CAAC,KAAK,UAAU,gBAAgB,EAAE,QAAQ,CAAC,KAAK,IAAI,EAAE,CAAC,GAAG,OAAO,IAAI"}

package/dist/lib/capabilities.mjs

@@ -0,0 +1,8 @@
+import { Capability } from "@dxos/app-framework";
+//#region src/capabilities/index.ts
+var CreateObject = Capability.lazy("CreateObject", () => import("./chunk-create-object.mjs"));
+var ReactSurface = Capability.lazy("ReactSurface", () => import("./chunk-react-surface.mjs"));
+//#endregion
+export { CreateObject, ReactSurface };
+
+//# sourceMappingURL=capabilities.mjs.map

package/dist/lib/capabilities.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"capabilities.mjs","names":[],"sources":["../../src/capabilities/index.ts"],"sourcesContent":["//\n// Copyright 2026 DXOS.org\n//\n\nimport { Capability } from '@dxos/app-framework';\n\nexport const CreateObject = Capability.lazy('CreateObject', () => import('./create-object'));\nexport const ReactSurface = Capability.lazy('ReactSurface', () => import('./react-surface'));\n"],"mappings":";;AAMA,IAAa,eAAe,WAAW,KAAK,sBAAsB,OAAO,4BAAkB;AAC3F,IAAa,eAAe,WAAW,KAAK,sBAAsB,OAAO,4BAAkB"}

package/dist/lib/chunk-GameArticle.mjs

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

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

@@ -0,0 +1 @@
+{"version":3,"file":"chunk-GameArticle.mjs","names":[],"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 } from '@dxos/echo';\nimport { useResolveRef } 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.Game>;\n\nexport const GameArticle = ({ role, attendableId, subject: game }: GameArticleProps) => {\n  const { t } = useTranslation(meta.profile.key);\n  const variants = useCapabilities(GameCapabilities.VariantProvider);\n  // Resolved live rather than as a snapshot: variants mutate their state, and a snapshot is frozen.\n  const variant = useResolveRef(game.variant);\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\nGameArticle.displayName = 'GameArticle';\n"],"mappings":";;;;;;;;;AAiBA,IAAa,eAAe,EAAE,MAAM,cAAc,SAAS,WAA6B;CACtF,MAAM,EAAE,MAAM,eAAe,KAAK,QAAQ,GAAG;CAC7C,MAAM,WAAW,gBAAgB,iBAAiB,eAAe;CAEjE,MAAM,UAAU,cAAc,KAAK,OAAO;CAE1C,IAAI,CAAC,SACH,OAAO;CAGT,MAAM,kBAAkB,IAAI,YAAY,OAAO;CAC/C,MAAM,QAAQ,SAAS,MAAM,MAAM,EAAE,OAAO,eAAe;CAC3D,IAAI,CAAC,OAAO,SACV,OACE,oBAAC,OAAD;EAAK,WAAU;YAAe,EAAE,6BAA6B,EAAE,cAAc,2BAA2B,CAAC;CAAO,CAAA;CAIpH,MAAM,YAAY,MAAM;CACxB,OAAO,oBAAC,WAAD;EAAiB;EAAe;EAAe;EAAoB;CAAe,CAAA;AAC3F;AAEA,YAAY,cAAc"}

package/dist/lib/chunk-GameCard.mjs

@@ -0,0 +1,26 @@
+import { Obj } from "@dxos/echo";
+import { GameCapabilities } from "#types";
+import "react";
+import { useCapabilities } from "@dxos/app-framework/ui";
+import { jsx } from "react/jsx-runtime";
+import { useResolveRef } from "@dxos/echo-react";
+//#region src/containers/GameCard/GameCard.tsx
+var GameCard = ({ role, subject: game }) => {
+	const variants = useCapabilities(GameCapabilities.VariantProvider);
+	const variant = useResolveRef(game.variant);
+	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__ */ jsx(Component, {
+		game,
+		variant,
+		role
+	});
+};
+GameCard.displayName = "GameCard";
+//#endregion
+export { GameCard as default };
+
+//# sourceMappingURL=chunk-GameCard.mjs.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"chunk-GameCard.mjs","names":[],"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 } from '@dxos/echo';\nimport { useResolveRef } from '@dxos/echo-react';\n\nimport { type Game, GameCapabilities } from '#types';\n\nexport type GameCardProps = AppSurface.ObjectCardProps<Game.Game>;\n\nexport const GameCard = ({ role, subject: game }: GameCardProps) => {\n  const variants = useCapabilities(GameCapabilities.VariantProvider);\n  // Resolved live rather than as a snapshot: variants mutate their state, and a snapshot is frozen.\n  const variant = useResolveRef(game.variant);\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\nGameCard.displayName = 'GameCard';\n"],"mappings":";;;;;;;AAeA,IAAa,YAAY,EAAE,MAAM,SAAS,WAA0B;CAClE,MAAM,WAAW,gBAAgB,iBAAiB,eAAe;CAEjE,MAAM,UAAU,cAAc,KAAK,OAAO;CAE1C,IAAI,CAAC,SACH,OAAO;CAGT,MAAM,kBAAkB,IAAI,YAAY,OAAO;CAC/C,MAAM,QAAQ,SAAS,MAAM,MAAM,EAAE,OAAO,eAAe;CAC3D,IAAI,CAAC,OAAO,MACV,OAAO;CAGT,MAAM,YAAY,MAAM;CACxB,OAAO,oBAAC,WAAD;EAAiB;EAAe;EAAe;CAAO,CAAA;AAC/D;AAEA,SAAS,cAAc"}

package/dist/lib/chunk-create-object.mjs

@@ -0,0 +1,45 @@
+import { a as make, n as VariantProvider, r as Game } from "./chunk-types.mjs";
+import { Capability } from "@dxos/app-framework";
+import { Database, Type } from "@dxos/echo";
+import * as Effect from "effect/Effect";
+import { Operation } from "@dxos/compute";
+import { invariant } from "@dxos/invariant";
+import { SpaceCapabilities, SpaceOperation } from "@dxos/plugin-space";
+import { CreateGamePanel } from "#components";
+//#region src/capabilities/create-object.ts
+var __dxlog_file = "/__w/dxos/dxos/packages/plugins/plugin-game/src/capabilities/create-object.ts";
+var create_object_default = Capability.makeModule(Effect.fnUntraced(function* () {
+	return Capability.contributes(SpaceCapabilities.CreateObjectEntry, {
+		id: Type.getTypename(Game),
+		customPanel: CreateGamePanel,
+		createObject: ({ variantId, input }, options) => Effect.gen(function* () {
+			const variant = (yield* Capability.getAll(VariantProvider)).find((v) => v.id === variantId);
+			invariant(variant, `Unknown game variant: ${variantId}`, {
+				"~LogMeta": "~LogMeta",
+				F: __dxlog_file,
+				L: 32,
+				S: this,
+				A: ["variant", "`Unknown game variant: ${variantId}`"]
+			});
+			const stateObject = yield* variant.createVariant(input ?? {}).pipe(Effect.provideService(Database.Service, Database.makeService(options.db)));
+			yield* Operation.invoke(SpaceOperation.AddObject, {
+				object: stateObject,
+				target: options.target,
+				targetNodeId: options.targetNodeId
+			});
+			const game = make({
+				name: typeof input?.name === "string" ? input.name : void 0,
+				variant: stateObject
+			});
+			return yield* Operation.invoke(SpaceOperation.AddObject, {
+				object: game,
+				target: options.target,
+				targetNodeId: options.targetNodeId
+			}).pipe(Effect.tapError(() => Operation.invoke(SpaceOperation.RemoveObjects, { objects: [stateObject] }).pipe(Effect.ignore)));
+		})
+	});
+}));
+//#endregion
+export { create_object_default as default };
+
+//# sourceMappingURL=chunk-create-object.mjs.map

package/dist/lib/chunk-create-object.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"chunk-create-object.mjs","names":[],"sources":["../../src/capabilities/create-object.ts"],"sourcesContent":["//\n// Copyright 2026 DXOS.org\n//\n\nimport * as Effect from 'effect/Effect';\n\nimport { Capability } from '@dxos/app-framework';\nimport { Operation } from '@dxos/compute';\nimport { Database, Type } from '@dxos/echo';\nimport { invariant } from '@dxos/invariant';\nimport { SpaceOperation } from '@dxos/plugin-space';\nimport { SpaceCapabilities } from '@dxos/plugin-space';\n\nimport { CreateGamePanel } from '#components';\n\nimport { Game, GameCapabilities } from '../types';\n\ntype CreateOptions = Parameters<SpaceCapabilities.CreateObjectEntry['createObject']>[1];\n\nexport default Capability.makeModule(\n  Effect.fnUntraced(function* () {\n    return Capability.contributes(SpaceCapabilities.CreateObjectEntry, {\n      id: Type.getTypename(Game.Game),\n      customPanel: CreateGamePanel,\n      createObject: (\n        { variantId, input }: { variantId: string; input?: Record<string, any> },\n        options: CreateOptions,\n      ) =>\n        Effect.gen(function* () {\n          const variants = yield* Capability.getAll(GameCapabilities.VariantProvider);\n          const variant = variants.find((v) => v.id === variantId);\n          invariant(variant, `Unknown game variant: ${variantId}`);\n\n          // Build variant state object via the variant's factory.\n          const stateObject = yield* variant\n            .createVariant(input ?? {})\n            .pipe(Effect.provideService(Database.Service, Database.makeService(options.db)));\n\n          // Add variant state to the database. Stays hidden — it's referenced by Game and\n          // shouldn't appear as a top-level item in the user's space.\n          yield* Operation.invoke(SpaceOperation.AddObject, {\n            object: stateObject,\n            target: options.target,\n            targetNodeId: options.targetNodeId,\n          });\n\n          const game = Game.make({\n            name: typeof input?.name === 'string' ? input.name : undefined,\n            variant: stateObject,\n          });\n\n          // Add the user-facing Game wrapper. Not hidden — this is the object the user sees\n          // and navigates to. If this second write fails, roll back the variant state so we\n          // don't leak an orphaned object into the space.\n          return yield* Operation.invoke(SpaceOperation.AddObject, {\n            object: game,\n            target: options.target,\n            targetNodeId: options.targetNodeId,\n          }).pipe(\n            Effect.tapError(() =>\n              Operation.invoke(SpaceOperation.RemoveObjects, { objects: [stateObject] }).pipe(Effect.ignore),\n            ),\n          );\n        }),\n    });\n  }),\n);\n"],"mappings":";;;;;;;;;;AAmBA,IAAA,wBAAe,WAAW,WACxB,OAAO,WAAW,aAAa;CAC7B,OAAO,WAAW,YAAY,kBAAkB,mBAAmB;EACjE,IAAI,KAAK,YAAY,IAAS;EAC9B,aAAa;EACb,eACE,EAAE,WAAW,SACb,YAEA,OAAO,IAAI,aAAa;GAEtB,MAAM,WAAU,OADQ,WAAW,OAAO,eAAgC,EAAA,CACjD,MAAM,MAAM,EAAE,OAAO,SAAS;GACvD,UAAU,SAAS,yBAAyB,aAAU;IAAA,YAAA;IAAA,GAAA;IAAA,GAAA;IAAA,GAAA;IAAA,GAAA,CAAA,WAAA,sCAAA;GAAA,CAAC;GAGvD,MAAM,cAAc,OAAO,QACxB,cAAc,SAAS,CAAC,CAAC,CAAA,CACzB,KAAK,OAAO,eAAe,SAAS,SAAS,SAAS,YAAY,QAAQ,EAAE,CAAC,CAAC;GAIjF,OAAO,UAAU,OAAO,eAAe,WAAW;IAChD,QAAQ;IACR,QAAQ,QAAQ;IAChB,cAAc,QAAQ;GACxB,CAAC;GAED,MAAM,OAAO,KAAU;IACrB,MAAM,OAAO,OAAO,SAAS,WAAW,MAAM,OAAO,KAAA;IACrD,SAAS;GACX,CAAC;GAKD,OAAO,OAAO,UAAU,OAAO,eAAe,WAAW;IACvD,QAAQ;IACR,QAAQ,QAAQ;IAChB,cAAc,QAAQ;GACxB,CAAC,CAAC,CAAC,KACD,OAAO,eACL,UAAU,OAAO,eAAe,eAAe,EAAE,SAAS,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC,KAAK,OAAO,MAAM,CAC/F,CACF;EACF,CAAC;CACL,CAAC;AACH,CAAC,CACH"}

package/dist/lib/chunk-load-game.mjs

@@ -0,0 +1,38 @@
+import { Database, Obj, Type } from "@dxos/echo";
+import * as Effect from "effect/Effect";
+//#region src/util/load-game.ts
+var GameVariantMismatchError = class extends Error {
+	gameId;
+	expectedTypename;
+	actualTypename;
+	_tag = "GameVariantMismatchError";
+	constructor(gameId, expectedTypename, actualTypename) {
+		super(`Game ${gameId} variant typename mismatch: expected ${expectedTypename}, got ${actualTypename}.`);
+		this.gameId = gameId;
+		this.expectedTypename = expectedTypename;
+		this.actualTypename = actualTypename;
+	}
+};
+/**
+* Loads a Game from a Ref and resolves its variant state, asserting the variant matches
+* the expected type. Returns the typed pair.
+*
+* Use in operation handlers that declare `input.game: GameRef<MyVariantState>`.
+*/
+var loadGame = (ref, variantType) => Effect.gen(function* () {
+	const game = yield* Database.load(ref);
+	const variant = yield* Database.load(game.variant);
+	if (!Obj.instanceOf(variantType, variant)) {
+		const expected = Type.getTypename(variantType) ?? "unknown";
+		const actual = Obj.getTypename(variant) ?? "unknown";
+		return yield* Effect.fail(new GameVariantMismatchError(game.id, expected, actual));
+	}
+	return {
+		game,
+		variant
+	};
+});
+//#endregion
+export { loadGame as n, GameVariantMismatchError as t };
+
+//# sourceMappingURL=chunk-load-game.mjs.map

package/dist/lib/chunk-load-game.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"chunk-load-game.mjs","names":[],"sources":["../../src/util/load-game.ts"],"sourcesContent":["//\n// Copyright 2026 DXOS.org\n//\n\nimport * as Effect from 'effect/Effect';\n\nimport { Database, Obj, type Ref, Type } from '@dxos/echo';\n\nimport * as Game from '../types/Game';\n\nexport class GameVariantMismatchError extends Error {\n  readonly _tag = 'GameVariantMismatchError';\n  constructor(\n    readonly gameId: string,\n    readonly expectedTypename: string,\n    readonly actualTypename: string,\n  ) {\n    super(`Game ${gameId} variant typename mismatch: expected ${expectedTypename}, got ${actualTypename}.`);\n  }\n}\n\n/**\n * Loads a Game from a Ref and resolves its variant state, asserting the variant matches\n * the expected type. Returns the typed pair.\n *\n * Use in operation handlers that declare `input.game: GameRef<MyVariantState>`.\n */\nexport const loadGame = <S extends Type.AnyObj>(\n  ref: Ref.Ref<Game.Game>,\n  variantType: S,\n): Effect.Effect<{ game: Game.Game; variant: Type.InstanceType<S> }, Error, Database.Service> =>\n  Effect.gen(function* () {\n    const game = yield* Database.load(ref);\n    const variant = yield* Database.load(game.variant);\n    if (!Obj.instanceOf(variantType, variant)) {\n      const expected = Type.getTypename(variantType) ?? 'unknown';\n      const actual = Obj.getTypename(variant as Obj.Any) ?? 'unknown';\n      return yield* Effect.fail(new GameVariantMismatchError(game.id, expected, actual));\n    }\n    return { game, variant: variant as Type.InstanceType<S> };\n  });\n"],"mappings":";;;AAUA,IAAa,2BAAb,cAA8C,MAAM;CAGvC;CACA;CACA;CAJX,OAAgB;CAChB,YACE,QACA,kBACA,gBACA;EACA,MAAM,QAAQ,OAAO,uCAAuC,iBAAiB,QAAQ,eAAe,EAAE;EAJ7F,KAAA,SAAA;EACA,KAAA,mBAAA;EACA,KAAA,iBAAA;CAGX;AACF;;;;;;;AAQA,IAAa,YACX,KACA,gBAEA,OAAO,IAAI,aAAa;CACtB,MAAM,OAAO,OAAO,SAAS,KAAK,GAAG;CACrC,MAAM,UAAU,OAAO,SAAS,KAAK,KAAK,OAAO;CACjD,IAAI,CAAC,IAAI,WAAW,aAAa,OAAO,GAAG;EACzC,MAAM,WAAW,KAAK,YAAY,WAAW,KAAK;EAClD,MAAM,SAAS,IAAI,YAAY,OAAkB,KAAK;EACtD,OAAO,OAAO,OAAO,KAAK,IAAI,yBAAyB,KAAK,IAAI,UAAU,MAAM,CAAC;CACnF;CACA,OAAO;EAAE;EAAe;CAAgC;AAC1D,CAAC"}

package/dist/lib/{neutral/chunk-R4V5PVU7.mjs → chunk-meta.mjs}

@@ -1,15 +1,12 @@
-// src/meta.ts
 import { Plugin } from "@dxos/app-framework";
-
-// dx.config.ts
 import { Config2 } from "@dxos/app-framework/config";
 import { trim } from "@dxos/util";
-var dx_config_default = Config2.make({
-  plugin: {
-    key: "org.dxos.plugin.game",
-    name: "Game",
-    author: "DXOS",
-    description: trim`
+//#region dx.config.ts
+var dx_config_default = Config2.make({ plugin: {
+	key: "org.dxos.plugin.game",
+	name: "Game",
+	author: "DXOS",
+	description: trim`
       Generic game host plugin that provides shared infrastructure for local-first,
       multi-player turn-based games inside DXOS Composer. The plugin owns the base
       \`Game\` ECHO type — which stores players and a reference to variant-specific
@@ -27,24 +24,19 @@ var dx_config_default = Config2.make({
       items in the user's space graph. The entire creation flow is atomic: if the
       Game write fails, the variant state is rolled back automatically.
     `,
-    source: "https://github.com/dxos/dxos/tree/main/packages/plugins/plugin-game",
-    icon: {
-      key: "ph--sword--regular",
-      hue: "indigo"
-    },
-    spec: "PLUGIN.mdl",
-    screenshots: [
-      {
-        dark: "https://customer-5rxcjpyab08avpmn.cloudflarestream.com/2797d56edc9658d018ad75fe48a47f27/iframe?poster=https%3A%2F%2Fcustomer-5rxcjpyab08avpmn.cloudflarestream.com%2F2797d56edc9658d018ad75fe48a47f27%2Fthumbnails%2Fthumbnail.jpg%3Ftime%3D%26height%3D600"
-      }
-    ]
-  }
-});
-
-// src/meta.ts
+	source: "https://github.com/dxos/dxos/tree/main/packages/plugins/plugin-game",
+	icon: {
+		key: "ph--sword--regular",
+		hue: "indigo"
+	},
+	spec: "PLUGIN.mdl",
+	screenshots: [{ 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"]
+} });
+//#endregion
+//#region src/meta.ts
 var meta = Plugin.getMetaFromConfig(dx_config_default);
+//#endregion
+export { meta as t };
 
-export {
-  meta
-};
-//# sourceMappingURL=chunk-R4V5PVU7.mjs.map
+//# sourceMappingURL=chunk-meta.mjs.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"chunk-meta.mjs","names":[],"sources":["../../dx.config.ts","../../src/meta.ts"],"sourcesContent":["//\n// Copyright 2026 DXOS.org\n//\n\nimport { Config2 } from '@dxos/app-framework/config';\nimport { trim } from '@dxos/util';\n\nexport default Config2.make({\n  plugin: {\n    key: 'org.dxos.plugin.game',\n    name: 'Game',\n    author: 'DXOS',\n    description: trim`\n      Generic game host plugin that provides shared infrastructure for local-first,\n      multi-player turn-based games inside DXOS Composer. The plugin owns the base\n      \\`Game\\` ECHO type — which stores players and a reference to variant-specific\n      state — and drives the two-stage game-creation flow (variant picker + optional\n      input form).\n\n      Game variants (chess, tic-tac-toe, and others) are contributed by separate\n      plugins via the \\`GameCapabilities.VariantProvider\\` capability. Each variant supplies\n      its own state schema, player roles, create factory, and surface components\n      (Article and Card). Plugin-game resolves the correct variant at runtime and\n      delegates rendering, keeping the host layer fully decoupled from game logic.\n\n      Variant state objects are stored as hidden ECHO objects alongside the top-level\n      \\`Game\\`, ensuring they replicate to all peers but do not appear as independent\n      items in the user's space graph. The entire creation flow is atomic: if the\n      Game write fails, the variant state is rolled back automatically.\n    `,\n    source: 'https://github.com/dxos/dxos/tree/main/packages/plugins/plugin-game',\n    icon: { key: 'ph--sword--regular', hue: 'indigo' },\n    spec: 'PLUGIN.mdl',\n    screenshots: [\n      {\n        dark: 'https://customer-5rxcjpyab08avpmn.cloudflarestream.com/2797d56edc9658d018ad75fe48a47f27/iframe?poster=https%3A%2F%2Fcustomer-5rxcjpyab08avpmn.cloudflarestream.com%2F2797d56edc9658d018ad75fe48a47f27%2Fthumbnails%2Fthumbnail.jpg%3Ftime%3D%26height%3D600',\n      },\n    ],\n    tags: ['alpha'],\n  },\n});\n","//\n// Copyright 2026 DXOS.org\n//\n\nimport { Plugin } from '@dxos/app-framework';\n\nimport config from '../dx.config';\n\nexport const meta = Plugin.getMetaFromConfig(config);\n"],"mappings":";;;;AAOA,IAAA,oBAAe,QAAQ,KAAK,EAC1B,QAAQ;CACN,KAAK;CACL,MAAM;CACN,QAAQ;CACR,aAAa,IAAI;;;;;;;;;;;;;;;;;;CAkBjB,QAAQ;CACR,MAAM;EAAE,KAAK;EAAsB,KAAK;CAAS;CACjD,MAAM;CACN,aAAa,CACX,EACE,MAAM,8PACR,CACF;CACA,MAAM,CAAC,OAAO;AAChB,EACF,CAAC;;;AChCD,IAAa,OAAO,OAAO,kBAAkB,iBAAM"}

package/dist/lib/chunk-react-surface.mjs

@@ -0,0 +1,29 @@
+import { r as Game } from "./chunk-types.mjs";
+import { Capabilities, Capability } from "@dxos/app-framework";
+import * as Effect from "effect/Effect";
+import { Surface } from "@dxos/app-framework/ui";
+import { AppSurface } from "@dxos/app-toolkit/ui";
+import { GameArticle, GameCard } from "#containers";
+//#region src/capabilities/react-surface.ts
+var react_surface_default = Capability.makeModule(() => Effect.succeed(Capability.contributes(Capabilities.ReactSurface, [Surface.create({
+	id: "game",
+	filter: AppSurface.oneOf(AppSurface.object(AppSurface.Article, Game), AppSurface.object(AppSurface.Section, Game)),
+	component: GameArticle,
+	props: ({ role, data: { subject, attendableId } }) => ({
+		role,
+		subject,
+		attendableId
+	})
+}), Surface.create({
+	id: "gameCard",
+	filter: AppSurface.object(AppSurface.CardContent, Game),
+	component: GameCard,
+	props: ({ role, data: { subject } }) => ({
+		role,
+		subject
+	})
+})])));
+//#endregion
+export { react_surface_default as default };
+
+//# sourceMappingURL=chunk-react-surface.mjs.map

package/dist/lib/chunk-react-surface.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"chunk-react-surface.mjs","names":[],"sources":["../../src/capabilities/react-surface.ts"],"sourcesContent":["//\n// Copyright 2026 DXOS.org\n//\n\nimport * as Effect from 'effect/Effect';\n\nimport { Capabilities, Capability } from '@dxos/app-framework';\nimport { Surface } from '@dxos/app-framework/ui';\nimport { AppSurface } from '@dxos/app-toolkit/ui';\n\nimport { GameArticle, GameCard } from '#containers';\n\nimport { Game } from '../types';\n\nexport default Capability.makeModule(() =>\n  Effect.succeed(\n    Capability.contributes(Capabilities.ReactSurface, [\n      Surface.create({\n        id: 'game',\n        filter: AppSurface.oneOf(\n          AppSurface.object(AppSurface.Article, Game.Game),\n          AppSurface.object(AppSurface.Section, Game.Game),\n        ),\n        component: GameArticle,\n        props: ({ role, data: { subject, attendableId } }) => ({ role, subject, attendableId }),\n      }),\n      Surface.create({\n        id: 'gameCard',\n        filter: AppSurface.object(AppSurface.CardContent, Game.Game),\n        component: GameCard,\n        props: ({ role, data: { subject } }) => ({ role, subject }),\n      }),\n    ]),\n  ),\n);\n"],"mappings":";;;;;;;AAcA,IAAA,wBAAe,WAAW,iBACxB,OAAO,QACL,WAAW,YAAY,aAAa,cAAc,CAChD,QAAQ,OAAO;CACb,IAAI;CACJ,QAAQ,WAAW,MACjB,WAAW,OAAO,WAAW,SAAS,IAAS,GAC/C,WAAW,OAAO,WAAW,SAAS,IAAS,CACjD;CACA,WAAW;CACX,QAAQ,EAAE,MAAM,MAAM,EAAE,SAAS,sBAAsB;EAAE;EAAM;EAAS;CAAa;AACvF,CAAC,GACD,QAAQ,OAAO;CACb,IAAI;CACJ,QAAQ,WAAW,OAAO,WAAW,aAAa,IAAS;CAC3D,WAAW;CACX,QAAQ,EAAE,MAAM,MAAM,EAAE,iBAAiB;EAAE;EAAM;CAAQ;AAC3D,CAAC,CACH,CAAC,CACH,CACF"}

package/dist/lib/chunk-types.mjs

@@ -0,0 +1,83 @@
+import "./chunk-load-game.mjs";
+import { Capability } from "@dxos/app-framework";
+import * as Schema from "effect/Schema";
+import { Annotation, DXN, Obj, Ref, Type } from "@dxos/echo";
+import { FormInputAnnotation, LabelAnnotation } from "@dxos/echo/Annotation";
+import { CardAnnotation } from "@dxos/schema";
+import { meta } from "#meta";
+//#region \0rolldown/runtime.js
+var __defProp = Object.defineProperty;
+var __exportAll = (all, no_symbols) => {
+	let target = {};
+	for (var name in all) __defProp(target, name, {
+		get: all[name],
+		enumerable: true
+	});
+	if (!no_symbols) __defProp(target, Symbol.toStringTag, { value: "Module" });
+	return target;
+};
+//#endregion
+//#region src/types/Game.ts
+var Game_exports = /* @__PURE__ */ __exportAll({
+	Game: () => Game,
+	GameRef: () => GameRef,
+	Player: () => Player,
+	make: () => make
+});
+/**
+* A player in a game.
+* `role` is variant-defined (e.g. 'white' | 'black' for chess, 'x' | 'o' for tictactoe).
+* `identity` is the optional DID of a human player; absent for AI or empty seats.
+* `name` is an optional display label (useful for AI/guest players).
+*/
+var Player = Schema.Struct({
+	role: Schema.String.annotations({ description: "Variant-defined player role (e.g. \"white\", \"x\")." }),
+	identity: Schema.optional(Schema.String.annotations({ description: "DID of the player; absent for AI or empty seats." })),
+	name: Schema.optional(Schema.String.annotations({ description: "Optional display name for the player." }))
+});
+/**
+* Base Game object. Variant-specific state lives in a separate referenced object.
+* Unifies all game variants (chess, tic-tac-toe, ...) under one typename so they share
+* graph node, create flow, and shared surface scaffolding.
+*/
+var Game = class extends Type.makeObject(DXN.make("org.dxos.type.game", "0.1.0"))(Schema.Struct({
+	name: Schema.optional(Schema.String),
+	players: Schema.mutable(Schema.Array(Player)).annotations({ description: "Players in the game." }).pipe(FormInputAnnotation.set(false), Schema.optional),
+	variant: Ref.Ref(Obj.Unknown).annotations({ description: "Reference to variant-specific state object." }).pipe(FormInputAnnotation.set(false))
+}).pipe(LabelAnnotation.set(["name"]), Annotation.IconAnnotation.set({
+	icon: "ph--sword--regular",
+	hue: "indigo"
+}), CardAnnotation.set(true), Annotation.IconFromRefAnnotation.set("variant"))) {};
+var GameRef = (_variantType) => Ref.Ref(Game);
+/**
+* Build a base `Game` object referencing the given variant-state ECHO object.
+*
+* The variant is stored as a `Ref` so the underlying state (e.g. `Chess.State`,
+* `TicTacToe.State`) lives as its own ECHO object alongside the Game.
+*
+* @param name Optional display name shown in the graph node and Properties form.
+* @param variant Variant-specific state object (e.g. `Chess.State`, `TicTacToe.State`).
+* @param players Optional initial players; copied into a mutable array on the Game.
+* @returns A new `Game` object with `variant` stored as a Ref.
+*/
+var make = ({ name, players, variant }) => {
+	return Obj.make(Game, {
+		name,
+		players: players ? [...players] : [],
+		variant: Ref.make(variant)
+	});
+};
+//#endregion
+//#region src/types/GameCapabilities.ts
+var GameCapabilities_exports = /* @__PURE__ */ __exportAll({ VariantProvider: () => VariantProvider });
+/**
+* A game variant contribution. Each variant plugin (chess, tic-tac-toe, ...)
+* contributes one of these via `Capability.contributes(GameCapabilities.VariantProvider, variant)`.
+* Consumers iterate via `Capability.getAll(GameCapabilities.VariantProvider)` (Effect) or
+* `useCapabilities(GameCapabilities.VariantProvider)` (React).
+*/
+var VariantProvider = Capability.make(`${meta.profile.key}.capability.variant`);
+//#endregion
+export { make as a, Game_exports as i, VariantProvider as n, Game as r, GameCapabilities_exports as t };
+
+//# sourceMappingURL=chunk-types.mjs.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"chunk-types.mjs","names":[],"sources":["../../src/types/Game.ts","../../src/types/GameCapabilities.ts"],"sourcesContent":["//\n// Copyright 2026 DXOS.org\n//\n\nimport * as Schema from 'effect/Schema';\n\nimport { Annotation, DXN, Obj, Ref, Type } from '@dxos/echo';\nimport { FormInputAnnotation, LabelAnnotation } from '@dxos/echo/Annotation';\nimport { CardAnnotation } from '@dxos/schema';\n\n// @import-as-namespace\n\n/**\n * A player in a game.\n * `role` is variant-defined (e.g. 'white' | 'black' for chess, 'x' | 'o' for tictactoe).\n * `identity` is the optional DID of a human player; absent for AI or empty seats.\n * `name` is an optional display label (useful for AI/guest players).\n */\nexport const Player = Schema.Struct({\n  role: Schema.String.annotations({\n    description: 'Variant-defined player role (e.g. \"white\", \"x\").',\n  }),\n  identity: Schema.optional(\n    Schema.String.annotations({\n      description: 'DID of the player; absent for AI or empty seats.',\n    }),\n  ),\n  name: Schema.optional(\n    Schema.String.annotations({\n      description: 'Optional display name for the player.',\n    }),\n  ),\n});\n\nexport type Player = Schema.Schema.Type<typeof Player>;\n\n/**\n * Base Game object. Variant-specific state lives in a separate referenced object.\n * Unifies all game variants (chess, tic-tac-toe, ...) under one typename so they share\n * graph node, create flow, and shared surface scaffolding.\n */\nexport class Game extends Type.makeObject<Game>(DXN.make('org.dxos.type.game', '0.1.0'))(\n  Schema.Struct({\n    name: Schema.optional(Schema.String),\n    players: Schema.mutable(Schema.Array(Player))\n      .annotations({ description: 'Players in the game.' })\n      .pipe(FormInputAnnotation.set(false), Schema.optional),\n    variant: Ref.Ref(Obj.Unknown)\n      .annotations({ description: 'Reference to variant-specific state object.' })\n      .pipe(FormInputAnnotation.set(false)),\n  }).pipe(\n    LabelAnnotation.set(['name']),\n    Annotation.IconAnnotation.set({ icon: 'ph--sword--regular', hue: 'indigo' }),\n    CardAnnotation.set(true),\n    // Delegate the graph-node icon to the referenced variant state's schema. Falls back to\n    // the static `ph--sword--regular` above while the variant ref is still loading.\n    Annotation.IconFromRefAnnotation.set('variant'),\n  ),\n) {}\n\n/**\n * Variant-narrowed reference to a Game.\n *\n * Encodes — at the type level — that the variant ref points to a specific state type.\n * Runtime narrowing is performed by `loadGame(ref, variantType)` which validates and\n * returns the resolved Game together with its typed variant state.\n *\n * @example\n * ```ts\n * input: Schema.Struct({\n *   game: GameRef(Chess.State),\n * }),\n * // handler:\n * const { game, variant } = yield* loadGame(input.game, Chess.State);\n * // `variant` is typed as Chess.State.\n * ```\n */\nexport type GameRef<_V> = Ref.Ref<Game>;\n\nexport const GameRef = <S extends Type.AnyObj>(_variantType: S) =>\n  Ref.Ref(Game) as Schema.Schema<GameRef<Type.InstanceType<S>>, any, never>;\n\n/**\n * Build a base `Game` object referencing the given variant-state ECHO object.\n *\n * The variant is stored as a `Ref` so the underlying state (e.g. `Chess.State`,\n * `TicTacToe.State`) lives as its own ECHO object alongside the Game.\n *\n * @param name Optional display name shown in the graph node and Properties form.\n * @param variant Variant-specific state object (e.g. `Chess.State`, `TicTacToe.State`).\n * @param players Optional initial players; copied into a mutable array on the Game.\n * @returns A new `Game` object with `variant` stored as a Ref.\n */\nexport const make = ({\n  name,\n  players,\n  variant,\n}: {\n  name?: string;\n  players?: ReadonlyArray<Player>;\n  variant: Obj.Unknown;\n}): Game => {\n  return Obj.make(Game, {\n    name,\n    players: players ? [...players] : [],\n    variant: Ref.make(variant),\n  });\n};\n","//\n// Copyright 2026 DXOS.org\n//\n\n// @import-as-namespace\n\nimport { Capability } from '@dxos/app-framework';\n\nimport { meta } from '#meta';\n\nimport type { GameVariant } from './types';\n\n/**\n * A game variant contribution. Each variant plugin (chess, tic-tac-toe, ...)\n * contributes one of these via `Capability.contributes(GameCapabilities.VariantProvider, variant)`.\n * Consumers iterate via `Capability.getAll(GameCapabilities.VariantProvider)` (Effect) or\n * `useCapabilities(GameCapabilities.VariantProvider)` (React).\n */\nexport const VariantProvider = Capability.make<GameVariant>(`${meta.profile.key}.capability.variant`);\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAkBA,IAAa,SAAS,OAAO,OAAO;CAClC,MAAM,OAAO,OAAO,YAAY,EAC9B,aAAa,uDACf,CAAC;CACD,UAAU,OAAO,SACf,OAAO,OAAO,YAAY,EACxB,aAAa,mDACf,CAAC,CACH;CACA,MAAM,OAAO,SACX,OAAO,OAAO,YAAY,EACxB,aAAa,wCACf,CAAC,CACH;AACF,CAAC;;;;;;AASD,IAAa,OAAb,cAA0B,KAAK,WAAiB,IAAI,KAAK,sBAAsB,OAAO,CAAC,CAAC,CACtF,OAAO,OAAO;CACZ,MAAM,OAAO,SAAS,OAAO,MAAM;CACnC,SAAS,OAAO,QAAQ,OAAO,MAAM,MAAM,CAAC,CAAA,CACzC,YAAY,EAAE,aAAa,uBAAuB,CAAC,CAAA,CACnD,KAAK,oBAAoB,IAAI,KAAK,GAAG,OAAO,QAAQ;CACvD,SAAS,IAAI,IAAI,IAAI,OAAO,CAAA,CACzB,YAAY,EAAE,aAAa,8CAA8C,CAAC,CAAA,CAC1E,KAAK,oBAAoB,IAAI,KAAK,CAAC;AACxC,CAAC,CAAC,CAAC,KACD,gBAAgB,IAAI,CAAC,MAAM,CAAC,GAC5B,WAAW,eAAe,IAAI;CAAE,MAAM;CAAsB,KAAK;AAAS,CAAC,GAC3E,eAAe,IAAI,IAAI,GAGvB,WAAW,sBAAsB,IAAI,SAAS,CAChD,CACF,CAAC,CAAC,CAAC;AAqBH,IAAa,WAAkC,iBAC7C,IAAI,IAAI,IAAI;;;;;;;;;;;;AAad,IAAa,QAAQ,EACnB,MACA,SACA,cAKU;CACV,OAAO,IAAI,KAAK,MAAM;EACpB;EACA,SAAS,UAAU,CAAC,GAAG,OAAO,IAAI,CAAC;EACnC,SAAS,IAAI,KAAK,OAAO;CAC3B,CAAC;AACH;;;;;;;;;;ACzFA,IAAa,kBAAkB,WAAW,KAAkB,GAAG,KAAK,QAAQ,IAAI,oBAAoB"}

package/dist/lib/components.mjs

@@ -0,0 +1,82 @@
+import { Obj } from "@dxos/echo";
+import { meta } from "#meta";
+import { GameCapabilities } from "#types";
+import { useCallback, useMemo, useState } from "react";
+import { useCapabilities } from "@dxos/app-framework/ui";
+import { Column, useTranslation } from "@dxos/react-ui";
+import { Form, omitId } from "@dxos/react-ui-form";
+import { SearchList, useSearchListResults } from "@dxos/react-ui-search";
+import { jsx, jsxs } from "react/jsx-runtime";
+//#region src/components/CreateGamePanel.tsx
+/**
+* Two-stage create panel for games:
+*   1. Variant picker (SearchList over contributed `GameVariant[]`).
+*   2. Variant-specific input form (rendered from variant.inputSchema).
+*
+* On submit, calls `onCreateObject({ variantId, name, input })` where `input` is the
+* variant-specific form values. Plugin-game's CreateObjectEntry.createObject resolves
+* the variantId, builds the variant state object via variant.createVariant, then wraps
+* it in a Game.
+*/
+var CreateGamePanel = ({ target, onCreateObject, variants: variantsProp }) => {
+	const capabilityVariants = useCapabilities(GameCapabilities.VariantProvider);
+	const variants = variantsProp ?? capabilityVariants;
+	const [selectedId, setSelectedId] = useState(void 0);
+	const selected = useMemo(() => variants.find((v) => v.id === selectedId), [variants, selectedId]);
+	const handleSelect = useCallback((id) => {
+		const variant = variants.find((v) => v.id === id);
+		if (!variant) return;
+		if (!variant.inputSchema) {
+			onCreateObject({ variantId: id });
+			return;
+		}
+		setSelectedId(id);
+	}, [variants, onCreateObject]);
+	const handleSubmit = useCallback((input) => {
+		if (!selected) return;
+		onCreateObject({
+			variantId: selected.id,
+			input
+		});
+	}, [selected, onCreateObject]);
+	if (!selected) return /* @__PURE__ */ jsx(VariantPicker, {
+		variants,
+		onSelect: handleSelect
+	});
+	const schema = selected.inputSchema ? omitId(selected.inputSchema) : void 0;
+	if (!schema) return null;
+	return /* @__PURE__ */ jsx(Form.Root, {
+		autoFocus: true,
+		schema,
+		defaultValues: {},
+		db: Obj.isObject(target) ? Obj.getDatabase(target) : target,
+		onSave: handleSubmit,
+		testId: "create-game-form",
+		children: /* @__PURE__ */ jsx(Column.Center, { children: /* @__PURE__ */ jsxs(Form.Content, { children: [/* @__PURE__ */ jsx(Form.FieldSet, {}), /* @__PURE__ */ jsx(Form.Submit, {})] }) })
+	});
+};
+var VariantPicker = ({ variants, onSelect }) => {
+	const { t } = useTranslation(meta.profile.key);
+	const { results, handleSearch } = useSearchListResults({
+		items: useMemo(() => [...variants].sort((a, b) => a.label.localeCompare(b.label)), [variants]),
+		extract: (variant) => variant.label
+	});
+	return /* @__PURE__ */ jsxs(SearchList.Root, {
+		onSearch: handleSearch,
+		children: [/* @__PURE__ */ jsx(SearchList.Input, {
+			classNames: "mb-form-gap",
+			autoFocus: true,
+			"data-testid": "create-game-panel.variant-input",
+			placeholder: t("create-panel.variant.placeholder")
+		}), /* @__PURE__ */ jsx(SearchList.Viewport, { children: results.map((variant) => /* @__PURE__ */ jsx(SearchList.Item, {
+			value: variant.id,
+			label: variant.label,
+			icon: variant.icon ?? "ph--sword--regular",
+			onSelect: () => onSelect(variant.id)
+		}, variant.id)) })]
+	});
+};
+//#endregion
+export { CreateGamePanel };
+
+//# sourceMappingURL=components.mjs.map

package/dist/lib/components.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"components.mjs","names":[],"sources":["../../src/components/CreateGamePanel.tsx"],"sourcesContent":["//\n// Copyright 2026 DXOS.org\n//\n\nimport React, { useCallback, useMemo, useState } from 'react';\n\nimport { useCapabilities } from '@dxos/app-framework/ui';\nimport { Obj } from '@dxos/echo';\nimport { type SpaceCapabilities } from '@dxos/plugin-space';\nimport { Column, useTranslation } from '@dxos/react-ui';\nimport { Form, omitId } from '@dxos/react-ui-form';\nimport { SearchList, useSearchListResults } from '@dxos/react-ui-search';\n\nimport { meta } from '#meta';\nimport { GameCapabilities, type GameVariant } from '#types';\n\nexport type CreateGamePanelProps = SpaceCapabilities.CreateObjectCustomPanelProps & {\n  /** Optional override (primarily for stories/tests). Defaults to GameCapabilities.VariantProvider. */\n  variants?: GameVariant[];\n};\n\n/**\n * Two-stage create panel for games:\n *   1. Variant picker (SearchList over contributed `GameVariant[]`).\n *   2. Variant-specific input form (rendered from variant.inputSchema).\n *\n * On submit, calls `onCreateObject({ variantId, name, input })` where `input` is the\n * variant-specific form values. Plugin-game's CreateObjectEntry.createObject resolves\n * the variantId, builds the variant state object via variant.createVariant, then wraps\n * it in a Game.\n */\nexport const CreateGamePanel = ({ target, onCreateObject, variants: variantsProp }: CreateGamePanelProps) => {\n  const capabilityVariants = useCapabilities(GameCapabilities.VariantProvider);\n  const variants = variantsProp ?? capabilityVariants;\n  const [selectedId, setSelectedId] = useState<string | undefined>(undefined);\n  const selected = useMemo(() => variants.find((v) => v.id === selectedId), [variants, selectedId]);\n\n  const handleSelect = useCallback(\n    (id: string) => {\n      const variant = variants.find((v) => v.id === id);\n      if (!variant) {\n        return;\n      }\n      if (!variant.inputSchema) {\n        void onCreateObject({ variantId: id });\n        return;\n      }\n      setSelectedId(id);\n    },\n    [variants, onCreateObject],\n  );\n\n  const handleSubmit = useCallback(\n    (input: Record<string, any>) => {\n      if (!selected) {\n        return;\n      }\n      void onCreateObject({ variantId: selected.id, input });\n    },\n    [selected, onCreateObject],\n  );\n\n  if (!selected) {\n    return <VariantPicker variants={variants} onSelect={handleSelect} />;\n  }\n\n  const schema = selected.inputSchema ? omitId(selected.inputSchema) : undefined;\n  if (!schema) {\n    return null;\n  }\n\n  return (\n    <Form.Root\n      autoFocus\n      schema={schema}\n      defaultValues={{}}\n      db={Obj.isObject(target) ? Obj.getDatabase(target) : target}\n      onSave={handleSubmit}\n      testId='create-game-form'\n    >\n      {/* Rendered inside the create dialog's Dialog.Body (which owns the gutter Column); use\n          Column.Center to align with the dialog title rather than nesting another Column.Root. */}\n      <Column.Center>\n        <Form.Content>\n          <Form.FieldSet />\n          <Form.Submit />\n        </Form.Content>\n      </Column.Center>\n    </Form.Root>\n  );\n};\n\ntype VariantPickerProps = {\n  variants: GameVariant[];\n  onSelect: (id: string) => void;\n};\n\nconst VariantPicker = ({ variants, onSelect }: VariantPickerProps) => {\n  const { t } = useTranslation(meta.profile.key);\n  const sorted = useMemo(() => [...variants].sort((a, b) => a.label.localeCompare(b.label)), [variants]);\n  const { results, handleSearch } = useSearchListResults({\n    items: sorted,\n    extract: (variant) => variant.label,\n  });\n\n  return (\n    <SearchList.Root onSearch={handleSearch}>\n      <SearchList.Input\n        classNames='mb-form-gap'\n        autoFocus\n        data-testid='create-game-panel.variant-input'\n        placeholder={t('create-panel.variant.placeholder')}\n      />\n      <SearchList.Viewport>\n        {results.map((variant) => (\n          <SearchList.Item\n            key={variant.id}\n            value={variant.id}\n            label={variant.label}\n            icon={variant.icon ?? 'ph--sword--regular'}\n            onSelect={() => onSelect(variant.id)}\n          />\n        ))}\n      </SearchList.Viewport>\n    </SearchList.Root>\n  );\n};\n"],"mappings":";;;;;;;;;;;;;;;;;;;;AA+BA,IAAa,mBAAmB,EAAE,QAAQ,gBAAgB,UAAU,mBAAyC;CAC3G,MAAM,qBAAqB,gBAAgB,iBAAiB,eAAe;CAC3E,MAAM,WAAW,gBAAgB;CACjC,MAAM,CAAC,YAAY,iBAAiB,SAA6B,KAAA,CAAS;CAC1E,MAAM,WAAW,cAAc,SAAS,MAAM,MAAM,EAAE,OAAO,UAAU,GAAG,CAAC,UAAU,UAAU,CAAC;CAEhG,MAAM,eAAe,aAClB,OAAe;EACd,MAAM,UAAU,SAAS,MAAM,MAAM,EAAE,OAAO,EAAE;EAChD,IAAI,CAAC,SACH;EAEF,IAAI,CAAC,QAAQ,aAAa;GACxB,eAAoB,EAAE,WAAW,GAAG,CAAC;GACrC;EACF;EACA,cAAc,EAAE;CAClB,GACA,CAAC,UAAU,cAAc,CAC3B;CAEA,MAAM,eAAe,aAClB,UAA+B;EAC9B,IAAI,CAAC,UACH;EAEF,eAAoB;GAAE,WAAW,SAAS;GAAI;EAAM,CAAC;CACvD,GACA,CAAC,UAAU,cAAc,CAC3B;CAEA,IAAI,CAAC,UACH,OAAO,oBAAC,eAAD;EAAyB;EAAU,UAAU;CAAe,CAAA;CAGrE,MAAM,SAAS,SAAS,cAAc,OAAO,SAAS,WAAW,IAAI,KAAA;CACrE,IAAI,CAAC,QACH,OAAO;CAGT,OACE,oBAAC,KAAK,MAAN;EACE,WAAA;EACQ;EACR,eAAe,CAAC;EAChB,IAAI,IAAI,SAAS,MAAM,IAAI,IAAI,YAAY,MAAM,IAAI;EACrD,QAAQ;EACR,QAAO;YAIP,oBAAC,OAAO,QAAR,EAAA,UACE,qBAAC,KAAK,SAAN,EAAA,UAAA,CACE,oBAAC,KAAK,UAAN,CAAgB,CAAA,GAChB,oBAAC,KAAK,QAAN,CAAc,CAAA,CACF,EAAA,CAAA,EACD,CAAA;CACN,CAAA;AAEf;AAOA,IAAM,iBAAiB,EAAE,UAAU,eAAmC;CACpE,MAAM,EAAE,MAAM,eAAe,KAAK,QAAQ,GAAG;CAE7C,MAAM,EAAE,SAAS,iBAAiB,qBAAqB;EACrD,OAFa,cAAc,CAAC,GAAG,QAAQ,CAAC,CAAC,MAAM,GAAG,MAAM,EAAE,MAAM,cAAc,EAAE,KAAK,CAAC,GAAG,CAAC,QAAQ,CAE3F;EACP,UAAU,YAAY,QAAQ;CAChC,CAAC;CAED,OACE,qBAAC,WAAW,MAAZ;EAAiB,UAAU;YAA3B,CACE,oBAAC,WAAW,OAAZ;GACE,YAAW;GACX,WAAA;GACA,eAAY;GACZ,aAAa,EAAE,kCAAkC;EAClD,CAAA,GACD,oBAAC,WAAW,UAAZ,EAAA,UACG,QAAQ,KAAK,YACZ,oBAAC,WAAW,MAAZ;GAEE,OAAO,QAAQ;GACf,OAAO,QAAQ;GACf,MAAM,QAAQ,QAAQ;GACtB,gBAAgB,SAAS,QAAQ,EAAE;EACpC,GALM,QAAQ,EAKd,CACF,EACkB,CAAA,CACN;;AAErB"}

package/dist/lib/containers.mjs

@@ -0,0 +1,8 @@
+import { lazy } from "react";
+//#region src/containers/index.ts
+var GameArticle = lazy(() => import("./chunk-GameArticle.mjs"));
+var GameCard = lazy(() => import("./chunk-GameCard.mjs"));
+//#endregion
+export { GameArticle, GameCard };
+
+//# sourceMappingURL=containers.mjs.map

package/dist/lib/containers.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"containers.mjs","names":[],"sources":["../../src/containers/index.ts"],"sourcesContent":["//\n// Copyright 2026 DXOS.org\n//\n\nimport { type ComponentType, lazy } from 'react';\n\nexport const GameArticle: ComponentType<any> = lazy(() => import('./GameArticle'));\nexport const GameCard: ComponentType<any> = lazy(() => import('./GameCard'));\n"],"mappings":";;AAMA,IAAa,cAAkC,WAAW,OAAO,0BAAgB;AACjF,IAAa,WAA+B,WAAW,OAAO,uBAAa"}

package/dist/lib/index.mjs

@@ -0,0 +1,4 @@
+import { i as Game_exports, t as GameCapabilities_exports } from "./chunk-types.mjs";
+import { t as meta } from "./chunk-meta.mjs";
+import { n as loadGame, t as GameVariantMismatchError } from "./chunk-load-game.mjs";
+export { Game_exports as Game, GameCapabilities_exports as GameCapabilities, GameVariantMismatchError, loadGame, meta };

package/dist/lib/meta.mjs

@@ -0,0 +1,2 @@
+import { t as meta } from "./chunk-meta.mjs";
+export { meta };

package/dist/lib/plugin.mjs

@@ -0,0 +1,8 @@
+import { t as meta } from "./chunk-meta.mjs";
+import { Plugin } from "@dxos/app-framework";
+//#region src/plugin.ts
+var GamePlugin = Plugin.lazy(meta, () => import("#plugin"));
+//#endregion
+export { GamePlugin };
+
+//# sourceMappingURL=plugin.mjs.map

package/dist/lib/plugin.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"plugin.mjs","names":[],"sources":["../../src/plugin.ts"],"sourcesContent":["//\n// Copyright 2026 DXOS.org\n//\n\nimport { Plugin } from '@dxos/app-framework';\n\nimport { meta } from './meta';\n\nexport const GamePlugin = Plugin.lazy(meta, () => import('#plugin'));\n"],"mappings":";;;AAQA,IAAa,aAAa,OAAO,KAAK,YAAY,OAAO,UAAU"}