@dxos/plugin-game 0.0.0

package/LICENSE

@@ -0,0 +1,105 @@
+# Functional Source License, Version 1.1, ALv2 Future License
+
+## Abbreviation
+
+FSL-1.1-Apache-2.0
+
+## Notice
+
+Copyright 2026 DXOS
+
+## Terms and Conditions
+
+### Licensor ("We")
+
+The party offering the Software under these Terms and Conditions.
+
+### The Software
+
+The "Software" is each version of the software that we make available under
+these Terms and Conditions, as indicated by our inclusion of these Terms and
+Conditions with the Software.
+
+### License Grant
+
+Subject to your compliance with this License Grant and the Patents,
+Redistribution and Trademark clauses below, we hereby grant you the right to
+use, copy, modify, create derivative works, publicly perform, publicly display
+and redistribute the Software for any Permitted Purpose identified below.
+
+### Permitted Purpose
+
+A Permitted Purpose is any purpose other than a Competing Use. A Competing Use
+means making the Software available to others in a commercial product or
+service that:
+
+1. substitutes for the Software;
+
+2. substitutes for any other product or service we offer using the Software
+   that exists as of the date we make the Software available; or
+
+3. offers the same or substantially similar functionality as the Software.
+
+Permitted Purposes specifically include using the Software:
+
+1. for your internal use and access;
+
+2. for non-commercial education;
+
+3. for non-commercial research; and
+
+4. in connection with professional services that you provide to a licensee
+   using the Software in accordance with these Terms and Conditions.
+
+### Patents
+
+To the extent your use for a Permitted Purpose would necessarily infringe our
+patents, the license grant above includes a license under our patents. If you
+make a claim against any party that the Software infringes or contributes to
+the infringement of any patent, then your patent license to the Software ends
+immediately.
+
+### Redistribution
+
+The Terms and Conditions apply to all copies, modifications and derivatives of
+the Software.
+
+If you redistribute any copies, modifications or derivatives of the Software,
+you must include a copy of or a link to these Terms and Conditions and not
+remove any copyright notices provided in or with the Software.
+
+### Disclaimer
+
+THE SOFTWARE IS PROVIDED "AS IS" AND WITHOUT WARRANTIES OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING WITHOUT LIMITATION WARRANTIES OF FITNESS FOR A PARTICULAR
+PURPOSE, MERCHANTABILITY, TITLE OR NON-INFRINGEMENT.
+
+IN NO EVENT WILL WE HAVE ANY LIABILITY TO YOU ARISING OUT OF OR RELATED TO THE
+SOFTWARE, INCLUDING INDIRECT, SPECIAL, INCIDENTAL OR CONSEQUENTIAL DAMAGES,
+EVEN IF WE HAVE BEEN INFORMED OF THEIR POSSIBILITY IN ADVANCE.
+
+### Trademarks
+
+Except for displaying the License Details and identifying us as the origin of
+the Software, you have no right under these Terms and Conditions to use our
+trademarks, trade names, service marks or product names.
+
+## Grant of Future License
+
+We hereby irrevocably grant you an additional license to use the Software under
+the Apache License, Version 2.0 that is effective on the second anniversary of
+the date we make the Software available. On or after that date, you may use the
+Software under the Apache License, Version 2.0, in which case the following
+will apply:
+
+Licensed under the Apache License, Version 2.0 (the "License"); you may not use
+this file except in compliance with the License.
+
+You may obtain a copy of the License at
+
+http://www.apache.org/licenses/LICENSE-2.0
+
+Unless required by applicable law or agreed to in writing, software distributed
+under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR
+CONDITIONS OF ANY KIND, either express or implied. See the License for the
+specific language governing permissions and limitations under the License.

package/PLUGIN.mdl

@@ -0,0 +1,334 @@
+---
+id: org.dxos.plugin.game
+name: GamePlugin
+version: 0.1.0
+---
+
+A generic game host plugin for `DXOS` Composer that provides shared infrastructure for
+multi-player, local-first turn-based games. Variant plugins (e.g. plugin-chess,
+plugin-tictactoe) contribute a `GameVariant` capability and game-specific surfaces;
+plugin-game supplies the `Game` ECHO type, create flow, and dispatch scaffolding.
+
+## Extensions
+
+The following extension dialects are used in this document.
+Each extension is defined in the Appendix or resolved via its URI.
+
+| Term        | URI                            |
+|-------------|--------------------------------|
+| `type`      | `org.dxos.mdl.type@1.0`       |
+| `feat`      | `org.dxos.mdl.feat@1.0`       |
+| `test`      | `org.dxos.mdl.test@1.0`       |
+| `component` | `org.dxos.mdl.component@1.0`  |
+| `op`        | `org.dxos.mdl.op@1.0`         |
+
+## Types
+
+```mdl
+type Player
+  fields:
+    role: string          # variant-defined (e.g. "white", "x"); required
+    identity?: string     # DID of a human player; absent for AI / empty seats
+    name?: string         # display label for AI or guest players
+```
+
+```mdl
+type Game
+  fields:
+    name?: string
+    players?: Player[]    # populated during or after creation
+    variant: Ref<Unknown> # reference to variant-specific state object (e.g. Chess.State)
+  typename: org.dxos.type.game
+  version: 0.1.0
+```
+
+```mdl
+type GameVariant
+  desc: |
+    Contribution interface from a variant plugin. Registered via
+    `Capability.contributes(GameCapabilities.VariantProvider, variant)`.
+  fields:
+    id: string                  # stable variant id; matches the variant state typename
+    label: string               # human-readable name shown in the picker
+    icon?: string               # Phosphor icon name
+    variantSchema: Schema       # Effect/Schema for the ECHO state object
+    inputSchema?: Schema        # optional form schema shown after variant is selected
+    roles: string[]             # player roles (e.g. ["white", "black"])
+    createVariant: Effect       # factory that builds the variant ECHO state object
+    card?: ComponentType        # optional Card surface component
+    article?: ComponentType     # optional Article/Section surface component
+```
+
+## Components
+
+```mdl
+component CreateGamePanel
+  desc: |
+    Two-stage creation panel. Stage 1 shows a searchable variant picker.
+    Stage 2 (optional) shows a form rendered from the variant's inputSchema.
+  props:
+    target: Space | Obj
+    onCreateObject: (args: { variantId: string; input?: Record }) => void
+    variants?: GameVariant[]    # override; defaults to GameCapabilities.VariantProvider
+  state:
+    selectedId?: string         # id of the variant chosen in stage 1
+  actions:
+    selectVariant(id: string)
+    submitForm(input: Record)
+  layout: |
+    ┌─────────────────────────┐
+    │ Stage 1: Variant Picker │
+    │  ┌───────────────────┐  │
+    │  │ Search input      │  │
+    │  ├───────────────────┤  │
+    │  │ variant row       │  │
+    │  │ variant row       │  │
+    │  └───────────────────┘  │
+    ├─────────────────────────┤
+    │ Stage 2: Input Form     │
+    │  (rendered from schema) │
+    │  [Submit]               │
+    └─────────────────────────┘
+```
+
+```mdl
+component GameArticle
+  desc: |
+    Article / Section surface for Game objects. Resolves the variant via
+    `game.variant` ref, finds the matching `GameVariant` by typename, and
+    delegates rendering to `variant.article`.
+  props:
+    game: Game
+    role?: string
+    attendableId?: string
+  state:
+    variant: Unknown            # live variant state object from the Ref
+    match?: GameVariant         # resolved GameVariant from capabilities
+  layout: |
+    ┌─────────────────────────┐
+    │ [variant.article]       │
+    │  (fallback: unsupported │
+    │   variant message)      │
+    └─────────────────────────┘
+```
+
+```mdl
+component GameCard
+  desc: |
+    Card surface for Game objects. Follows the same variant-resolution
+    logic as GameArticle and delegates to `variant.card`.
+  props:
+    game: Game
+    role?: string
+  state:
+    variant: Unknown
+    match?: GameVariant
+```
+
+## Operations
+
+```mdl
+op createGame
+  desc: |
+    Creates a variant state object via `variant.createVariant`, adds it
+    to the space as a hidden object, then wraps it in a top-level Game.
+    If the second write fails the variant state object is rolled back.
+  input:
+    variantId: string
+    input?: Record              # variant-specific form values
+    target: Space | Obj
+    targetNodeId?: string
+  output: Game
+  errors:
+    UnknownVariant: no registered GameVariant matches variantId
+  effects: [echo:write]
+  requires: [GameCapabilities.VariantProvider, SpaceOperation.AddObject, SpaceOperation.RemoveObjects]
+  note: |
+    Invoked by CreateObjectEntry.createObject.
+    Variant state is added with `hidden: true` so it does not appear
+    as a top-level item in the user's space graph.
+```
+
+## Features
+
+```mdl
+feat F-1: Variant Registration
+
+  req F-1.1:
+    when: a variant plugin loads
+    then: it contributes a GameVariant via `Capability.contributes(GameCapabilities.VariantProvider, …)`
+
+  req F-1.2:
+    when: GameCapabilities.VariantProvider contributions are queried
+    then: all registered variants are returned as an ordered list
+```
+
+```mdl
+feat F-2: Game Creation
+
+  req F-2.1:
+    when: user opens the create-object flow for type `org.dxos.type.game`
+    then: CreateGamePanel is shown with a searchable list of available variants
+
+  req F-2.2:
+    when: user selects a variant with no inputSchema
+    then: op:createGame is invoked immediately with empty input
+
+  req F-2.3:
+    when: user selects a variant that has an inputSchema
+    then: a form rendered from the schema is shown; op:createGame is invoked on submit
+
+  req F-2.4:
+    when: op:createGame completes
+    then: a Game object appears in the space graph; variant state is hidden
+```
+
+```mdl
+feat F-3: Game Article / Card Rendering
+
+  req F-3.1:
+    when: Composer navigates to a Game object
+    then: GameArticle resolves `game.variant` and delegates to the matching `variant.article`
+
+  req F-3.2:
+    when: a Game object is shown in a Card layout
+    then: GameCard resolves `game.variant` and delegates to `variant.card`
+
+  req F-3.3:
+    when: no matching variant is found for the loaded state object
+    then: GameArticle renders an "Unsupported game variant" fallback message
+
+  req F-3.4:
+    when: the variant ref is not yet loaded
+    then: neither GameArticle nor GameCard renders (returns null)
+```
+
+## Acceptance
+
+```mdl
+test T-1: Variant picker shows all contributions
+  given: two variant plugins have contributed GameVariants
+  when: the user opens the create-game panel
+  then:
+    - CreateGamePanel lists both variants
+    - variants are sorted alphabetically
+```
+
+```mdl
+test T-2: Create game without form
+  given: a variant with no inputSchema is selected
+  when: user clicks the variant item
+  then:
+    - onCreateObject is called immediately with { variantId }
+    - no form is shown
+```
+
+```mdl
+test T-3: Create game with form
+  given: a variant with an inputSchema is selected
+  when: user fills and submits the form
+  then:
+    - onCreateObject is called with { variantId, input: <form values> }
+```
+
+```mdl
+test T-4: Atomic game creation
+  given: a valid variantId and target space
+  when: op:createGame is invoked
+  then:
+    - variant state object added to space (hidden)
+    - Game object added with game.variant pointing to the state object
+    - both writes are visible to other peers via ECHO replication
+```
+
+```mdl
+test T-5: Rollback on second write failure
+  given: variant state is successfully written
+  when: the second write (Game object) fails
+  then:
+    - RemoveObjects is invoked for the variant state
+    - no orphaned state object remains in the space
+```
+
+```mdl
+test T-6: Unknown variant rejected
+  given: op:createGame is invoked with an unregistered variantId
+  when: the handler runs
+  then: UnknownVariant error is returned; no ECHO writes occur
+```
+
+```mdl
+test T-7: Unsupported variant fallback
+  given: a Game whose variant typename has no registered GameVariant
+  when: GameArticle renders
+  then: "Unsupported game variant" message is shown instead of crashing
+```
+
+---
+
+## Appendix: Extension Definitions
+
+Extension block types used in this document are defined below using
+the core `ext` primitive — the only construct the base language provides.
+
+```mdl
+ext type
+  uri: org.dxos.mdl.type@1.0
+  desc: A named data structure with typed fields and optional literals.
+  fields:
+    desc?: Prose
+    fields?: FieldMap        # name[?]: TypeExpr  (# inline comment)
+    literals?: UnionList     # a | b | c
+    extends?: TypeRef[]
+```
+
+```mdl
+ext feat
+  uri: org.dxos.mdl.feat@1.0
+  desc: A named feature grouping one or more requirements.
+  fields:
+    desc?: Prose
+    req: RequirementList
+  nesting: self              # feat blocks may contain feat blocks
+```
+
+```mdl
+ext test
+  uri: org.dxos.mdl.test@1.0
+  desc: An acceptance scenario expressed as given / when / then steps.
+  fields:
+    given?: Step | Step[]
+    when?: Step | Step[]
+    then: Step | Step[]
+    tags?: TagList
+```
+
+```mdl
+ext component
+  uri: org.dxos.mdl.component@1.0
+  desc: A UI component with props, internal state, slots, actions, and events.
+  fields:
+    desc?: Prose
+    props?: FieldMap            # external inputs (immutable inside component)
+    state?: FieldMap            # internal reactive state
+    slots?: FieldMap            # named ReactNode injection points
+    actions?: ActionMap         # methods the component exposes or handles
+    emits?: EventMap            # events the component raises to its parent
+    layout?: CodeBlock          # ASCII sketch of visual structure (non-normative)
+```
+
+```mdl
+ext op
+  uri: org.dxos.mdl.op@1.0
+  desc: |
+    A named operation with typed inputs, outputs, and declared errors.
+    Pure ops have no effects or requires. Effectful ops declare both.
+  fields:
+    desc?: Prose
+    input?: FieldMap            # named input parameters
+    output?: TypeExpr           # return type
+    errors?: ErrorMap           # name: Prose  (when this error occurs)
+    effects?: EffectList        # echo:read | echo:write | http | fs | ...
+    requires?: ServiceList      # injected service dependencies
+    note?: Prose                # implementation guidance (non-normative)
+```

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

@@ -0,0 +1,40 @@
+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

@@ -0,0 +1,7 @@
+{
+  "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

@@ -0,0 +1,32 @@
+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

@@ -0,0 +1,7 @@
+{
+  "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

@@ -0,0 +1,38 @@
+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:/Users/jdw/Code/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

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../src/GamePlugin.tsx", "raw-loader:/Users/jdw/Code/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"]
+}

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

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

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

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "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] }),\n  AppPlugin.addTranslationsModule({ translations }),\n  Plugin.make,\n);\n\nexport default GamePlugin;\n"],
+  "mappings": ";;;AAIA,SAASA,cAAc;AACvB,SAASC,iBAAiB;AAE1B,SAASC,YAAY;AACrB,SAASC,oBAAoB;AAC7B,SAASC,YAAY;AAQd,IAAMC,aAAaL,OAAOM,OAAOJ,IAAAA,EAAMK,KAC5CN,UAAUO,gBAAgB;EAAEC,QAAQ;IAACL;;AAAM,CAAA,GAC3CH,UAAUS,sBAAsB;EAAEP;AAAa,CAAA,GAC/CH,OAAOW,IAAI;AAGb,IAAA,0BAAeN;",
+  "names": ["Plugin", "AppPlugin", "meta", "translations", "Game", "GamePlugin", "define", "pipe", "addSchemaModule", "schema", "addTranslationsModule", "make"]
+}