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

package/PLUGIN.mdl

@@ -15,9 +15,11 @@ Each extension is defined in the Appendix or resolved via its URI.
 |-------------|--------------------------------|
 | `type`      | `org.dxos.mdl.type@1.0`       |
 | `feat`      | `org.dxos.mdl.feat@1.0`       |
-| `test`      | `org.dxos.mdl.test@1.0`       |
+| `scenario`  | `org.dxos.mdl.scenario@1.0`   |
 | `component` | `org.dxos.mdl.component@1.0`  |
-| `op`        | `org.dxos.mdl.op@1.0`         |
+| `op`        | `org.dxos.mdl.op@1.1`         |
+| `test`      | `org.dxos.mdl.test@1.0`       |
+| `step`      | `org.dxos.mdl.step@1.0`       |
 
 ## Types
 
@@ -109,20 +111,20 @@ component SlideArticle
 
 ```mdl
 op TogglePresentation
+  key: org.dxos.operation.presenter.setPresenting
   desc: |
-    Toggles presentation mode for a Markdown document or Collection.
-    Opens the presenter companion node via the Deck plugin, driving the deck's ephemeral
-    fullscreen state (EphemeralDeckState.fullscreen) rather than a layout mode.
-    If the presenter companion isn't already fullscreen, toggles it fullscreen before opening;
-    exiting reverts fullscreen and re-opens the source object.
+    Enters or exits presentation for a Markdown document or Collection by toggling the deck's
+    fullscreen overlay (EphemeralDeckState.fullscreen) onto the presenter companion node.
+    The overlay is independent of what is open, so neither direction navigates: the URL and the
+    open planks are unchanged.
   input:
     object: Markdown.Document | Collection.Collection
-    state?: boolean             # explicit on/off override; omit to toggle
+    state: boolean              # on or off; callers that flip read the current state first
   output: void
-  effects: [layout:navigate, deck:fullscreen]
-  requires: [DeckCapabilities.State, DeckOperation.Adjust, LayoutOperation.Open]
+  effects: [deck:fullscreen]
+  requires: [DeckCapabilities.EphemeralState, DeckOperation.Adjust]
   note: |
-    Resolves the presenter companion node path as `<objectPath>/presenter`.
+    Resolves the presenter companion node path as `<objectPath>/~presenter`.
     Keyboard shortcut: Shift+Cmd+P (macOS), Shift+Alt+P (Windows/Linux).
 ```
 
@@ -137,7 +139,7 @@ feat F-1: Presentation Mode
     then: every Collection also has a companion Presenter node
   req F-1.3:
     when: user activates TogglePresentation on a document or collection
-    then: Composer opens the presenter node in solo-fullscreen mode
+    then: the presenter companion fills the screen in the deck's fullscreen overlay, without the companion tab strip, and the URL does not change
   req F-1.4:
     when: user presses Shift+Cmd+P (macOS) or Shift+Alt+P (Windows)
     then: TogglePresentation is invoked for the focused object
@@ -182,7 +184,7 @@ feat F-4: Plugin Settings
 ## Acceptance
 
 ```mdl
-test T-1: Document presenter opens in fullscreen
+scenario T-1: Document presenter opens in fullscreen
   given: a Markdown document exists in the workspace
   when: user invokes TogglePresentation (keyboard or action menu)
   then:
@@ -192,7 +194,7 @@ test T-1: Document presenter opens in fullscreen
 ```
 
 ```mdl
-test T-2: Slide navigation via Reveal.js
+scenario T-2: Slide navigation via Reveal.js
   given: a Markdown document with three `---`-separated sections
   when: DocumentArticle renders the document
   then:
@@ -201,14 +203,14 @@ test T-2: Slide navigation via Reveal.js
 ```
 
 ```mdl
-test T-3: Exit returns to document view
+scenario T-3: Exit returns to document view
   given: DocumentArticle is open in fullscreen
   when: user presses Escape
-  then: Composer navigates back to the document article view
+  then: the fullscreen overlay closes, leaving the document and its companion as they were
 ```
 
 ```mdl
-test T-4: Collection slideshow renders per-item surfaces
+scenario T-4: Collection slideshow renders per-item surfaces
   given: a Collection with two Markdown documents and settings.presentCollections = true
   when: CollectionArticle mounts
   then:
@@ -217,7 +219,7 @@ test T-4: Collection slideshow renders per-item surfaces
 ```
 
 ```mdl
-test T-5: Collection slide advance
+scenario T-5: Collection slide advance
   given: CollectionArticle at slide 0 with a three-item collection
   when: user clicks the next-slide control in Pager
   then:
@@ -227,14 +229,14 @@ test T-5: Collection slide advance
 ```
 
 ```mdl
-test T-6: Collections hidden when setting disabled
+scenario T-6: Collections hidden when setting disabled
   given: settings.presentCollections is false (default)
   when: app graph is built for a Collection node
   then: no Presenter companion node is created for the collection
 ```
 
 ```mdl
-test T-7: Keyboard shortcut registered
+scenario T-7: Keyboard shortcut registered
   given: a Markdown document node is focused in the app graph
   then:
     - action with key TogglePresentation is present on the node
@@ -243,6 +245,60 @@ test T-7: Keyboard shortcut registered
 
 ---
 
+## QA
+
+Executable tests. Each step carries a human instruction (`do`) and, where the step maps to an
+invocable operation, an agent binding (`invoke`). Report failures by test and step number.
+
+```mdl
+test QA-1: Preview a document in the companion, then present it
+  desc: The core presenter round-trip — create a document with slide separators, preview it in the presenter companion, present it fullscreen, then exit.
+  actors: both
+  covers: [F-1.1, F-1.3, F-2.1, F-2.2, F-2.3, T-1, T-3]
+  status: unverified
+  automated:
+    - composer-e2e:presenter.spec.ts#Presenter › preview a document in the companion, then present it
+  given:
+    - an identity exists
+    - space: a space is open
+    - collection: a collection in that space, to create into
+    - plugin-presenter is enabled — it is OFF by default (absent from `getDefaults` in
+      `plugin-defs.tsx`), though the plugin itself is registered unconditionally so it always
+      appears in the plugin registry to enable manually
+    - no document named "QA Slides" exists — ABORT rather than deleting one this test did not create
+  steps:
+    - name: Create a document with slides
+      do: In the navtree, click + on a collection and choose Markdown. Name it "QA Slides".
+      invoke: org.dxos.operation.markdown.createDraft { name: "QA Slides", content: "# Slide one\n\n---\n\n# Slide two\n" }
+      capture: created
+      expect: a Document named "QA Slides" now exists with two `---`-separated sections
+      assert: return !!$created.object
+    - name: Place it
+      do: (the navtree create action places it for you)
+      invoke: org.dxos.operation.space.addObject { object: $created.object, target: $given.collection }
+      expect: "QA Slides" appears as a row under the collection
+    - name: Preview in the companion
+      do: Open "QA Slides", open its companion and pick the Presenter tab.
+      expect: the companion shows "Slide one" as a slide scaled to the companion's width
+    - name: Enter presentation mode
+      do: Choose Present from the document's actions menu, or press Shift+Cmd+P (macOS) / Shift+Alt+P (Windows/Linux).
+      invoke: org.dxos.operation.presenter.setPresenting { object: $created.object, state: true }
+      expect: the slides fill the screen showing "Slide one", with no companion tab strip; the URL is unchanged
+      assert: return document.body.innerText.includes('Slide one');
+    - name: Exit presentation mode
+      do: Press Escape.
+      invoke: org.dxos.operation.presenter.setPresenting { object: $created.object, state: false }
+      expect: the document plank and its presenter companion are back as they were, and the URL is unchanged
+      assert: return !!document.querySelector('[data-testid="deck.viewport"]');
+  after:
+    - name: Delete the document
+      do: Right-click "QA Slides" in the navtree and choose Delete.
+      invoke: org.dxos.operation.space.removeObjects { objects: [$created.object], target: $given.collection }
+      expect: the row leaves the navtree and its plank closes
+```
+
+---
+
 ## Appendix: Extension Definitions
 
 Extension block types used in this document are defined below using
@@ -270,8 +326,8 @@ ext feat
 ```
 
 ```mdl
-ext test
-  uri: org.dxos.mdl.test@1.0
+ext scenario
+  uri: org.dxos.mdl.scenario@1.0
   desc: An acceptance scenario expressed as given / when / then steps.
   fields:
     given?: Step | Step[]

package/dist/lib/PresenterCapabilities.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"PresenterCapabilities.mjs","names":[],"sources":["../../src/types/PresenterCapabilities.ts"],"sourcesContent":["//\n// Copyright 2025 DXOS.org\n//\n\n// @import-as-namespace\n\nimport type * as Atom from 'effect/unstable/reactivity/Atom';\n\nimport * as Capability from '@dxos/app-framework/Capability';\n\nimport { meta } from '#meta';\n\n// Inline import to avoid `Settings` namespace alias colliding with the\n// `Settings` capability export below.\nexport const Settings = Capability.makeSingleton<Atom.Writable<import('./Settings').Settings>>()(\n  `${meta.profile.key}.capability.settings`,\n);\n"],"mappings":";;;;;AAcA,IAAa,WAAW,WAAW,cAA4D,CAAC,CAC9F,GAAG,KAAK,QAAQ,IAAI,qBACtB"}
+{"version":3,"file":"PresenterCapabilities.mjs","names":[],"sources":["../../src/types/PresenterCapabilities.ts"],"sourcesContent":["//\n// Copyright 2025 DXOS.org\n//\n\n// @import-as-namespace\n\nimport type * as Atom from 'effect/reactivity/Atom';\n\nimport * as Capability from '@dxos/app-framework/Capability';\n\nimport { meta } from '#meta';\n\n// Inline import to avoid `Settings` namespace alias colliding with the\n// `Settings` capability export below.\nexport const Settings = Capability.makeSingleton<Atom.Writable<import('./Settings.ts').Settings>>()(\n  `${meta.profile.key}.capability.settings`,\n);\n"],"mappings":";;;;;AAcA,IAAa,WAAW,WAAW,cAA+D,CAAC,CACjG,GAAG,KAAK,QAAQ,IAAI,qBACtB"}

package/dist/lib/capabilities.browser.mjs

@@ -0,0 +1,36 @@
+import { t as PLUGIN_default } from "./chunk-PLUGIN.mjs";
+import * as ActivationEvents from "@dxos/app-framework/ActivationEvents";
+import * as Capability from "@dxos/app-framework/Capability";
+import * as AppCapability from "@dxos/app-toolkit/AppCapability";
+import * as MarkdownCapabilities from "@dxos/plugin-markdown/MarkdownCapabilities";
+import * as MarkdownEvents from "@dxos/plugin-markdown/MarkdownEvents";
+import { translations } from "#translations";
+import { PresenterCapabilities } from "#types";
+import { meta } from "#meta";
+//#region src/capabilities/gen/browser.ts
+var AppGraphBuilder = AppCapability.appGraphBuilder(() => import("./chunk-app-graph-builder.mjs"), { environments: [
+	"browser",
+	"node",
+	"tauri"
+] });
+var MarkdownExtension = Capability.lazyModule("MarkdownExtension", {
+	provides: [MarkdownCapabilities.ExtensionProvider],
+	activatesOn: MarkdownEvents.Start
+}, () => import("./chunk-markdown-extension.mjs"));
+var OperationHandler = AppCapability.operationHandler(() => import("./chunk-operation-handler.mjs"), { activatesOn: ActivationEvents.Idle });
+var ReactSurface = AppCapability.surface(() => import("./chunk-react-surface.mjs"), { roles: ["org.dxos.role.article", "org.dxos.role.slide"] });
+var PresenterSettings = AppCapability.settings(() => import("./chunk-settings.mjs"), {
+	activatesOn: ActivationEvents.Idle,
+	provides: [PresenterCapabilities.Settings]
+});
+var Translations = AppCapability.translations(translations);
+var PluginAsset = AppCapability.pluginAsset({
+	pluginId: meta.profile.key,
+	path: "PLUGIN.mdl",
+	content: PLUGIN_default,
+	mimeType: "application/x-mdl"
+});
+//#endregion
+export { AppGraphBuilder, MarkdownExtension, OperationHandler, PluginAsset, PresenterSettings, ReactSurface, Translations };
+
+//# sourceMappingURL=capabilities.browser.mjs.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"capabilities.browser.mjs","names":[],"sources":["../../src/capabilities/gen/browser.ts"],"sourcesContent":["//\n// Copyright 2026 DXOS.org\n//\n\n// GENERATED by dx-plugin — do not edit. Sliced from ../index.ts for the 'browser' condition.\n\nimport * as ActivationEvents from '@dxos/app-framework/ActivationEvents';\nimport * as Capability from '@dxos/app-framework/Capability';\nimport * as AppCapability from '@dxos/app-toolkit/AppCapability';\nimport * as MarkdownCapabilities from '@dxos/plugin-markdown/MarkdownCapabilities';\nimport * as MarkdownEvents from '@dxos/plugin-markdown/MarkdownEvents';\n\nimport { meta } from '#meta';\nimport { translations } from '#translations';\nimport { PresenterCapabilities } from '#types';\n\nimport pluginSpec from '../../../PLUGIN.mdl?raw';\n\nexport const AppGraphBuilder = AppCapability.appGraphBuilder(() => import('../app-graph-builder.ts'), {\n  environments: ['browser', 'node', 'tauri'],\n});\n\nexport const MarkdownExtension = Capability.lazyModule(\n  'MarkdownExtension',\n  { provides: [MarkdownCapabilities.ExtensionProvider], activatesOn: MarkdownEvents.Start },\n  () => import('../markdown-extension.ts'),\n);\n\nexport const OperationHandler = AppCapability.operationHandler(() => import('../operation-handler.ts'), {\n  activatesOn: ActivationEvents.Idle,\n});\n\nexport const ReactSurface = AppCapability.surface(() => import('../react-surface.ts'), {\n  roles: ['org.dxos.role.article', 'org.dxos.role.slide'],\n});\n\nexport const PresenterSettings = AppCapability.settings(() => import('../settings.ts'), {\n  activatesOn: ActivationEvents.Idle,\n  provides: [PresenterCapabilities.Settings],\n});\n\nexport const Translations = AppCapability.translations(translations);\n\nexport const PluginAsset = AppCapability.pluginAsset({\n  pluginId: meta.profile.key,\n  path: 'PLUGIN.mdl',\n  content: pluginSpec,\n  mimeType: 'application/x-mdl',\n});\n"],"mappings":";;;;;;;;;;AAkBA,IAAa,kBAAkB,cAAc,sBAAsB,OAAO,kCAA4B,EACpG,cAAc;CAAC;CAAW;CAAQ;AAAO,EAC3C,CAAC;AAED,IAAa,oBAAoB,WAAW,WAC1C,qBACA;CAAE,UAAU,CAAC,qBAAqB,iBAAiB;CAAG,aAAa,eAAe;AAAM,SAClF,OAAO,iCACf;AAEA,IAAa,mBAAmB,cAAc,uBAAuB,OAAO,kCAA4B,EACtG,aAAa,iBAAiB,KAChC,CAAC;AAED,IAAa,eAAe,cAAc,cAAc,OAAO,8BAAwB,EACrF,OAAO,CAAC,yBAAyB,qBAAqB,EACxD,CAAC;AAED,IAAa,oBAAoB,cAAc,eAAe,OAAO,yBAAmB;CACtF,aAAa,iBAAiB;CAC9B,UAAU,CAAC,sBAAsB,QAAQ;AAC3C,CAAC;AAED,IAAa,eAAe,cAAc,aAAa,YAAY;AAEnE,IAAa,cAAc,cAAc,YAAY;CACnD,UAAU,KAAK,QAAQ;CACvB,MAAM;CACN,SAAS;CACT,UAAU;AACZ,CAAC"}

package/dist/lib/capabilities.mjs

@@ -1,3 +1,4 @@
+import { t as PLUGIN_default } from "./chunk-PLUGIN.mjs";
 import * as ActivationEvents from "@dxos/app-framework/ActivationEvents";
 import * as Capability from "@dxos/app-framework/Capability";
 import * as AppCapability from "@dxos/app-toolkit/AppCapability";
@@ -6,11 +7,12 @@ import * as MarkdownEvents from "@dxos/plugin-markdown/MarkdownEvents";
 import { translations } from "#translations";
 import { PresenterCapabilities } from "#types";
 import { meta } from "#meta";
-//#region PLUGIN.mdl?raw
-var PLUGIN_default = "---\nid: org.dxos.plugin.presenter\nname: PresenterPlugin\nversion: 0.1.0\n---\n\nA presentation plugin for DXOS Composer that turns existing workspace objects — markdown documents and collections — into interactive slideshows with fullscreen mode and keyboard navigation.\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 PresentationTarget\n  literals: document | collection\n  desc: The kind of workspace object being presented.\n```\n\n```mdl\ntype SlideIndex\n  fields:\n    current: number             # zero-based index of the active slide\n    count: number               # total number of slides in the presentation\n```\n\n```mdl\ntype PresentationSettings\n  fields:\n    presentCollections?: boolean  # when true, Collections may also be presented as slideshows (experimental)\n```\n\n## Components\n\n```mdl\ncomponent DocumentArticle\n  desc: |\n    Full-screen Reveal.js player for a single Markdown document.\n    Parses the document content into slides using horizontal/vertical `---` separators.\n    Renders in a Panel that fills the available viewport.\n  props:\n    document: Markdown.Document\n  slots:\n    (none)\n  actions:\n    exit()                      # navigates back to the originating document view\n  layout: |\n    ┌─────────────────────────────┐\n    │                             │\n    │        RevealPlayer         │\n    │  (full-screen slide canvas) │\n    │                             │\n    └─────────────────────────────┘\n```\n\n```mdl\ncomponent CollectionArticle\n  desc: |\n    Slideshow player for a Collection.\n    Renders one slide per object in the collection's ordered items array.\n    The active slide is delegated to the AppSurface.Slide surface, so each\n    item's own plugin renders it (e.g. SlideArticle for documents).\n  props:\n    subject: Collection.Collection\n    role?: string\n  state:\n    slide: number               # zero-based index of the current slide\n    running: boolean            # whether keyboard navigation is active (from PresenterContext)\n  slots:\n    (none)\n  actions:\n    setSlide(index: number)\n    exit()\n  layout: |\n    ┌─────────────────────────────┐\n    │                             │\n    │       Surface (slide N)     │  ← AppSurface.Slide surface\n    │                             │\n    ├────────────────┬────────────┤\n    │   [Pager]      │ [PageNum]  │\n    └────────────────┴────────────┘\n```\n\n```mdl\ncomponent SlideArticle\n  desc: |\n    Renders a single Markdown document as a slide panel inside a Collection presentation.\n    Used as the AppSurface.Slide surface implementation for Markdown.Document objects.\n  props:\n    document: Markdown.Document\n  layout: |\n    ┌─────────────────────────────┐\n    │  Panel                      │\n    │   └─ Slide (markdown)       │\n    └─────────────────────────────┘\n```\n\n## Operations\n\n```mdl\nop TogglePresentation\n  desc: |\n    Toggles presentation mode for a Markdown document or Collection.\n    Opens the presenter companion node via the Deck plugin, driving the deck's ephemeral\n    fullscreen state (EphemeralDeckState.fullscreen) rather than a layout mode.\n    If the presenter companion isn't already fullscreen, toggles it fullscreen before opening;\n    exiting reverts fullscreen and re-opens the source object.\n  input:\n    object: Markdown.Document | Collection.Collection\n    state?: boolean             # explicit on/off override; omit to toggle\n  output: void\n  effects: [layout:navigate, deck:fullscreen]\n  requires: [DeckCapabilities.State, DeckOperation.Adjust, LayoutOperation.Open]\n  note: |\n    Resolves the presenter companion node path as `<objectPath>/presenter`.\n    Keyboard shortcut: Shift+Cmd+P (macOS), Shift+Alt+P (Windows/Linux).\n```\n\n## Features\n\n```mdl\nfeat F-1: Presentation Mode\n\n  req F-1.1: Every Markdown document in the workspace has a companion \"Presenter\" node in the app graph.\n  req F-1.2:\n    when: settings.presentCollections is true\n    then: every Collection also has a companion Presenter node\n  req F-1.3:\n    when: user activates TogglePresentation on a document or collection\n    then: Composer opens the presenter node in solo-fullscreen mode\n  req F-1.4:\n    when: user presses Shift+Cmd+P (macOS) or Shift+Alt+P (Windows)\n    then: TogglePresentation is invoked for the focused object\n```\n\n```mdl\nfeat F-2: Document Slideshow (Reveal.js)\n\n  req F-2.1:\n    when: DocumentArticle mounts with a Markdown.Document\n    then: RevealPlayer parses the document content and renders slides\n  req F-2.2: Horizontal slides are separated by `---`; vertical slides by `----`.\n  req F-2.3:\n    when: user presses Escape or the exit action is triggered\n    then: presenter navigates back to the originating document view\n```\n\n```mdl\nfeat F-3: Collection Slideshow\n\n  req F-3.1:\n    when: CollectionArticle mounts with a Collection\n    then: slide 0 is shown, corresponding to collection.objects[0]\n  req F-3.2:\n    when: user navigates to slide N via the Pager\n    then: the AppSurface.Slide surface renders collection.objects[N]\n  req F-3.3: PageNumber displays the current slide index and total count.\n  req F-3.4:\n    when: user presses Escape or the exit action is triggered\n    then: presenter navigates back to the collection view\n```\n\n```mdl\nfeat F-4: Plugin Settings\n\n  req F-4.1: PresenterSettings panel is registered for the plugin settings surface.\n  req F-4.2:\n    when: user enables \"Present collections (experimental)\"\n    then: settings.presentCollections is set to true and Collection nodes gain Presenter companions\n```\n\n## Acceptance\n\n```mdl\ntest T-1: Document presenter opens in fullscreen\n  given: a Markdown document exists in the workspace\n  when: user invokes TogglePresentation (keyboard or action menu)\n  then:\n    - Composer switches to solo-fullscreen layout\n    - DocumentArticle is shown with the document content\n    - RevealPlayer is visible with at least one slide\n```\n\n```mdl\ntest T-2: Slide navigation via Reveal.js\n  given: a Markdown document with three `---`-separated sections\n  when: DocumentArticle renders the document\n  then:\n    - three horizontal slides are produced\n    - arrow-key navigation advances and retreats between slides\n```\n\n```mdl\ntest T-3: Exit returns to document view\n  given: DocumentArticle is open in fullscreen\n  when: user presses Escape\n  then: Composer navigates back to the document article view\n```\n\n```mdl\ntest T-4: Collection slideshow renders per-item surfaces\n  given: a Collection with two Markdown documents and settings.presentCollections = true\n  when: CollectionArticle mounts\n  then:\n    - slide 0 shows SlideArticle for collection.objects[0]\n    - Pager shows count = 2\n```\n\n```mdl\ntest T-5: Collection slide advance\n  given: CollectionArticle at slide 0 with a three-item collection\n  when: user clicks the next-slide control in Pager\n  then:\n    - slide index advances to 1\n    - AppSurface.Slide renders collection.objects[1]\n    - PageNumber shows \"2 / 3\"\n```\n\n```mdl\ntest T-6: Collections hidden when setting disabled\n  given: settings.presentCollections is false (default)\n  when: app graph is built for a Collection node\n  then: no Presenter companion node is created for the collection\n```\n\n```mdl\ntest T-7: Keyboard shortcut registered\n  given: a Markdown document node is focused in the app graph\n  then:\n    - action with key TogglePresentation is present on the node\n    - keyBinding shows Shift+Cmd+P on macOS\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\n    literals?: UnionList\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\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\n    state?: FieldMap\n    slots?: FieldMap\n    actions?: ActionMap\n    emits?: EventMap\n    layout?: CodeBlock\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\n    output?: TypeExpr\n    errors?: ErrorMap\n    effects?: EffectList\n    requires?: ServiceList\n    note?: Prose\n```\n";
-//#endregion
 //#region src/capabilities/index.ts
-var AppGraphBuilder = AppCapability.appGraphBuilder(() => import("./chunk-app-graph-builder.mjs"), { environments: ["node"] });
+var AppGraphBuilder = AppCapability.appGraphBuilder(() => import("./chunk-app-graph-builder.mjs"), { environments: [
+	"browser",
+	"node",
+	"tauri"
+] });
 var MarkdownExtension = Capability.lazyModule("MarkdownExtension", {
 	provides: [MarkdownCapabilities.ExtensionProvider],
 	activatesOn: MarkdownEvents.Start

package/dist/lib/capabilities.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"capabilities.mjs","names":[],"sources":["../../src/capabilities/index.ts"],"sourcesContent":["//\n// Copyright 2025 DXOS.org\n//\n\nimport * as ActivationEvents from '@dxos/app-framework/ActivationEvents';\nimport * as Capability from '@dxos/app-framework/Capability';\nimport * as AppCapability from '@dxos/app-toolkit/AppCapability';\nimport * as MarkdownCapabilities from '@dxos/plugin-markdown/MarkdownCapabilities';\nimport * as MarkdownEvents from '@dxos/plugin-markdown/MarkdownEvents';\n\nimport { meta } from '#meta';\nimport { translations } from '#translations';\nimport { PresenterCapabilities } from '#types';\n\n// eslint-disable-next-line import/no-relative-packages\nimport pluginSpec from '../../PLUGIN.mdl?raw';\n\nexport const AppGraphBuilder = AppCapability.appGraphBuilder(() => import('./app-graph-builder'), {\n  environments: ['node'],\n});\nexport const MarkdownExtension = Capability.lazyModule(\n  'MarkdownExtension',\n  { provides: [MarkdownCapabilities.ExtensionProvider], activatesOn: MarkdownEvents.Start },\n  () => import('./markdown-extension'),\n);\nexport const OperationHandler = AppCapability.operationHandler(() => import('./operation-handler'), {\n  activatesOn: ActivationEvents.Idle,\n});\nexport const ReactSurface = AppCapability.surface(() => import('./react-surface'), {\n  roles: ['org.dxos.role.article', 'org.dxos.role.slide'],\n});\nexport const PresenterSettings = AppCapability.settings(() => import('./settings'), {\n  activatesOn: ActivationEvents.Idle,\n  provides: [PresenterCapabilities.Settings],\n});\nexport const Translations = AppCapability.translations(translations);\nexport const PluginAsset = AppCapability.pluginAsset({\n  pluginId: meta.profile.key,\n  path: 'PLUGIN.mdl',\n  content: pluginSpec,\n  mimeType: 'application/x-mdl',\n});\n"],"mappings":";;;;;;;;;;;;AAiBA,IAAa,kBAAkB,cAAc,sBAAsB,OAAO,kCAAwB,EAChG,cAAc,CAAC,MAAM,EACvB,CAAC;AACD,IAAa,oBAAoB,WAAW,WAC1C,qBACA;CAAE,UAAU,CAAC,qBAAqB,iBAAiB;CAAG,aAAa,eAAe;AAAM,SAClF,OAAO,iCACf;AACA,IAAa,mBAAmB,cAAc,uBAAuB,OAAO,kCAAwB,EAClG,aAAa,iBAAiB,KAChC,CAAC;AACD,IAAa,eAAe,cAAc,cAAc,OAAO,8BAAoB,EACjF,OAAO,CAAC,yBAAyB,qBAAqB,EACxD,CAAC;AACD,IAAa,oBAAoB,cAAc,eAAe,OAAO,yBAAe;CAClF,aAAa,iBAAiB;CAC9B,UAAU,CAAC,sBAAsB,QAAQ;AAC3C,CAAC;AACD,IAAa,eAAe,cAAc,aAAa,YAAY;AACnE,IAAa,cAAc,cAAc,YAAY;CACnD,UAAU,KAAK,QAAQ;CACvB,MAAM;CACN,SAAS;CACT,UAAU;AACZ,CAAC"}
+{"version":3,"file":"capabilities.mjs","names":[],"sources":["../../src/capabilities/index.ts"],"sourcesContent":["//\n// Copyright 2025 DXOS.org\n//\n\nimport * as ActivationEvents from '@dxos/app-framework/ActivationEvents';\nimport * as Capability from '@dxos/app-framework/Capability';\nimport * as AppCapability from '@dxos/app-toolkit/AppCapability';\nimport * as MarkdownCapabilities from '@dxos/plugin-markdown/MarkdownCapabilities';\nimport * as MarkdownEvents from '@dxos/plugin-markdown/MarkdownEvents';\n\nimport { meta } from '#meta';\nimport { translations } from '#translations';\nimport { PresenterCapabilities } from '#types';\n\n// eslint-disable-next-line import/no-relative-packages\nimport pluginSpec from '../../PLUGIN.mdl?raw';\n\nexport const AppGraphBuilder = AppCapability.appGraphBuilder(() => import('./app-graph-builder.ts'), {\n  environments: ['browser', 'node', 'tauri'],\n});\nexport const MarkdownExtension = Capability.lazyModule(\n  'MarkdownExtension',\n  { provides: [MarkdownCapabilities.ExtensionProvider], activatesOn: MarkdownEvents.Start },\n  () => import('./markdown-extension.ts'),\n);\nexport const OperationHandler = AppCapability.operationHandler(() => import('./operation-handler.ts'), {\n  activatesOn: ActivationEvents.Idle,\n});\nexport const ReactSurface = AppCapability.surface(() => import('./react-surface.ts'), {\n  roles: ['org.dxos.role.article', 'org.dxos.role.slide'],\n});\nexport const PresenterSettings = AppCapability.settings(() => import('./settings.ts'), {\n  activatesOn: ActivationEvents.Idle,\n  provides: [PresenterCapabilities.Settings],\n});\nexport const Translations = AppCapability.translations(translations);\nexport const PluginAsset = AppCapability.pluginAsset({\n  pluginId: meta.profile.key,\n  path: 'PLUGIN.mdl',\n  content: pluginSpec,\n  mimeType: 'application/x-mdl',\n});\n"],"mappings":";;;;;;;;;;AAiBA,IAAa,kBAAkB,cAAc,sBAAsB,OAAO,kCAA2B,EACnG,cAAc;CAAC;CAAW;CAAQ;AAAO,EAC3C,CAAC;AACD,IAAa,oBAAoB,WAAW,WAC1C,qBACA;CAAE,UAAU,CAAC,qBAAqB,iBAAiB;CAAG,aAAa,eAAe;AAAM,SAClF,OAAO,iCACf;AACA,IAAa,mBAAmB,cAAc,uBAAuB,OAAO,kCAA2B,EACrG,aAAa,iBAAiB,KAChC,CAAC;AACD,IAAa,eAAe,cAAc,cAAc,OAAO,8BAAuB,EACpF,OAAO,CAAC,yBAAyB,qBAAqB,EACxD,CAAC;AACD,IAAa,oBAAoB,cAAc,eAAe,OAAO,yBAAkB;CACrF,aAAa,iBAAiB;CAC9B,UAAU,CAAC,sBAAsB,QAAQ;AAC3C,CAAC;AACD,IAAa,eAAe,cAAc,aAAa,YAAY;AACnE,IAAa,cAAc,cAAc,YAAY;CACnD,UAAU,KAAK,QAAQ;CACvB,MAAM;CACN,SAAS;CACT,UAAU;AACZ,CAAC"}

package/dist/lib/capabilities.node.mjs

@@ -6,7 +6,11 @@ import * as MarkdownEvents from "@dxos/plugin-markdown/MarkdownEvents";
 import { translations } from "#translations";
 import { PresenterCapabilities } from "#types";
 //#region src/capabilities/gen/node.ts
-var AppGraphBuilder = AppCapability.appGraphBuilder(() => import("./chunk-app-graph-builder.mjs"), { environments: ["node"] });
+var AppGraphBuilder = AppCapability.appGraphBuilder(() => import("./chunk-app-graph-builder.mjs"), { environments: [
+	"browser",
+	"node",
+	"tauri"
+] });
 var MarkdownExtension = Capability.lazyModule("MarkdownExtension", {
 	provides: [MarkdownCapabilities.ExtensionProvider],
 	activatesOn: MarkdownEvents.Start

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

@@ -1 +1 @@
-{"version":3,"file":"capabilities.node.mjs","names":[],"sources":["../../src/capabilities/gen/node.ts"],"sourcesContent":["//\n// Copyright 2026 DXOS.org\n//\n\n// GENERATED by dx-plugin — do not edit. Sliced from ../index.ts for the 'node' condition.\n\nimport * as ActivationEvents from '@dxos/app-framework/ActivationEvents';\nimport * as Capability from '@dxos/app-framework/Capability';\nimport * as AppCapability from '@dxos/app-toolkit/AppCapability';\nimport * as MarkdownCapabilities from '@dxos/plugin-markdown/MarkdownCapabilities';\nimport * as MarkdownEvents from '@dxos/plugin-markdown/MarkdownEvents';\n\nimport { translations } from '#translations';\nimport { PresenterCapabilities } from '#types';\n\nexport const AppGraphBuilder = AppCapability.appGraphBuilder(() => import('../app-graph-builder'), {\n  environments: ['node'],\n});\n\nexport const MarkdownExtension = Capability.lazyModule(\n  'MarkdownExtension',\n  { provides: [MarkdownCapabilities.ExtensionProvider], activatesOn: MarkdownEvents.Start },\n  () => import('../markdown-extension'),\n);\n\nexport const OperationHandler = AppCapability.operationHandler(() => import('../operation-handler'), {\n  activatesOn: ActivationEvents.Idle,\n});\n\nexport const PresenterSettings = AppCapability.settings(() => import('../settings'), {\n  activatesOn: ActivationEvents.Idle,\n  provides: [PresenterCapabilities.Settings],\n});\n\nexport const Translations = AppCapability.translations(translations);\n\nexport const PluginAsset = undefined;\nexport const ReactSurface = undefined;\n"],"mappings":";;;;;;;;AAeA,IAAa,kBAAkB,cAAc,sBAAsB,OAAO,kCAAyB,EACjG,cAAc,CAAC,MAAM,EACvB,CAAC;AAED,IAAa,oBAAoB,WAAW,WAC1C,qBACA;CAAE,UAAU,CAAC,qBAAqB,iBAAiB;CAAG,aAAa,eAAe;AAAM,SAClF,OAAO,iCACf;AAEA,IAAa,mBAAmB,cAAc,uBAAuB,OAAO,kCAAyB,EACnG,aAAa,iBAAiB,KAChC,CAAC;AAED,IAAa,oBAAoB,cAAc,eAAe,OAAO,yBAAgB;CACnF,aAAa,iBAAiB;CAC9B,UAAU,CAAC,sBAAsB,QAAQ;AAC3C,CAAC;AAED,IAAa,eAAe,cAAc,aAAa,YAAY;AAEnE,IAAa,cAAc,KAAA;AAC3B,IAAa,eAAe,KAAA"}
+{"version":3,"file":"capabilities.node.mjs","names":[],"sources":["../../src/capabilities/gen/node.ts"],"sourcesContent":["//\n// Copyright 2026 DXOS.org\n//\n\n// GENERATED by dx-plugin — do not edit. Sliced from ../index.ts for the 'node' condition.\n\nimport * as ActivationEvents from '@dxos/app-framework/ActivationEvents';\nimport * as Capability from '@dxos/app-framework/Capability';\nimport * as AppCapability from '@dxos/app-toolkit/AppCapability';\nimport * as MarkdownCapabilities from '@dxos/plugin-markdown/MarkdownCapabilities';\nimport * as MarkdownEvents from '@dxos/plugin-markdown/MarkdownEvents';\n\nimport { translations } from '#translations';\nimport { PresenterCapabilities } from '#types';\n\nexport const AppGraphBuilder = AppCapability.appGraphBuilder(() => import('../app-graph-builder.ts'), {\n  environments: ['browser', 'node', 'tauri'],\n});\n\nexport const MarkdownExtension = Capability.lazyModule(\n  'MarkdownExtension',\n  { provides: [MarkdownCapabilities.ExtensionProvider], activatesOn: MarkdownEvents.Start },\n  () => import('../markdown-extension.ts'),\n);\n\nexport const OperationHandler = AppCapability.operationHandler(() => import('../operation-handler.ts'), {\n  activatesOn: ActivationEvents.Idle,\n});\n\nexport const PresenterSettings = AppCapability.settings(() => import('../settings.ts'), {\n  activatesOn: ActivationEvents.Idle,\n  provides: [PresenterCapabilities.Settings],\n});\n\nexport const Translations = AppCapability.translations(translations);\n\nexport const PluginAsset = undefined;\nexport const ReactSurface = undefined;\n"],"mappings":";;;;;;;;AAeA,IAAa,kBAAkB,cAAc,sBAAsB,OAAO,kCAA4B,EACpG,cAAc;CAAC;CAAW;CAAQ;AAAO,EAC3C,CAAC;AAED,IAAa,oBAAoB,WAAW,WAC1C,qBACA;CAAE,UAAU,CAAC,qBAAqB,iBAAiB;CAAG,aAAa,eAAe;AAAM,SAClF,OAAO,iCACf;AAEA,IAAa,mBAAmB,cAAc,uBAAuB,OAAO,kCAA4B,EACtG,aAAa,iBAAiB,KAChC,CAAC;AAED,IAAa,oBAAoB,cAAc,eAAe,OAAO,yBAAmB;CACtF,aAAa,iBAAiB;CAC9B,UAAU,CAAC,sBAAsB,QAAQ;AAC3C,CAAC;AAED,IAAa,eAAe,cAAc,aAAa,YAAY;AAEnE,IAAa,cAAc,KAAA;AAC3B,IAAa,eAAe,KAAA"}

package/dist/lib/capabilities.tauri.mjs

@@ -0,0 +1,36 @@
+import { t as PLUGIN_default } from "./chunk-PLUGIN.mjs";
+import * as ActivationEvents from "@dxos/app-framework/ActivationEvents";
+import * as Capability from "@dxos/app-framework/Capability";
+import * as AppCapability from "@dxos/app-toolkit/AppCapability";
+import * as MarkdownCapabilities from "@dxos/plugin-markdown/MarkdownCapabilities";
+import * as MarkdownEvents from "@dxos/plugin-markdown/MarkdownEvents";
+import { translations } from "#translations";
+import { PresenterCapabilities } from "#types";
+import { meta } from "#meta";
+//#region src/capabilities/gen/tauri.ts
+var AppGraphBuilder = AppCapability.appGraphBuilder(() => import("./chunk-app-graph-builder.mjs"), { environments: [
+	"browser",
+	"node",
+	"tauri"
+] });
+var MarkdownExtension = Capability.lazyModule("MarkdownExtension", {
+	provides: [MarkdownCapabilities.ExtensionProvider],
+	activatesOn: MarkdownEvents.Start
+}, () => import("./chunk-markdown-extension.mjs"));
+var OperationHandler = AppCapability.operationHandler(() => import("./chunk-operation-handler.mjs"), { activatesOn: ActivationEvents.Idle });
+var ReactSurface = AppCapability.surface(() => import("./chunk-react-surface.mjs"), { roles: ["org.dxos.role.article", "org.dxos.role.slide"] });
+var PresenterSettings = AppCapability.settings(() => import("./chunk-settings.mjs"), {
+	activatesOn: ActivationEvents.Idle,
+	provides: [PresenterCapabilities.Settings]
+});
+var Translations = AppCapability.translations(translations);
+var PluginAsset = AppCapability.pluginAsset({
+	pluginId: meta.profile.key,
+	path: "PLUGIN.mdl",
+	content: PLUGIN_default,
+	mimeType: "application/x-mdl"
+});
+//#endregion
+export { AppGraphBuilder, MarkdownExtension, OperationHandler, PluginAsset, PresenterSettings, ReactSurface, Translations };
+
+//# sourceMappingURL=capabilities.tauri.mjs.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"capabilities.tauri.mjs","names":[],"sources":["../../src/capabilities/gen/tauri.ts"],"sourcesContent":["//\n// Copyright 2026 DXOS.org\n//\n\n// GENERATED by dx-plugin — do not edit. Sliced from ../index.ts for the 'tauri' condition.\n\nimport * as ActivationEvents from '@dxos/app-framework/ActivationEvents';\nimport * as Capability from '@dxos/app-framework/Capability';\nimport * as AppCapability from '@dxos/app-toolkit/AppCapability';\nimport * as MarkdownCapabilities from '@dxos/plugin-markdown/MarkdownCapabilities';\nimport * as MarkdownEvents from '@dxos/plugin-markdown/MarkdownEvents';\n\nimport { meta } from '#meta';\nimport { translations } from '#translations';\nimport { PresenterCapabilities } from '#types';\n\nimport pluginSpec from '../../../PLUGIN.mdl?raw';\n\nexport const AppGraphBuilder = AppCapability.appGraphBuilder(() => import('../app-graph-builder.ts'), {\n  environments: ['browser', 'node', 'tauri'],\n});\n\nexport const MarkdownExtension = Capability.lazyModule(\n  'MarkdownExtension',\n  { provides: [MarkdownCapabilities.ExtensionProvider], activatesOn: MarkdownEvents.Start },\n  () => import('../markdown-extension.ts'),\n);\n\nexport const OperationHandler = AppCapability.operationHandler(() => import('../operation-handler.ts'), {\n  activatesOn: ActivationEvents.Idle,\n});\n\nexport const ReactSurface = AppCapability.surface(() => import('../react-surface.ts'), {\n  roles: ['org.dxos.role.article', 'org.dxos.role.slide'],\n});\n\nexport const PresenterSettings = AppCapability.settings(() => import('../settings.ts'), {\n  activatesOn: ActivationEvents.Idle,\n  provides: [PresenterCapabilities.Settings],\n});\n\nexport const Translations = AppCapability.translations(translations);\n\nexport const PluginAsset = AppCapability.pluginAsset({\n  pluginId: meta.profile.key,\n  path: 'PLUGIN.mdl',\n  content: pluginSpec,\n  mimeType: 'application/x-mdl',\n});\n"],"mappings":";;;;;;;;;;AAkBA,IAAa,kBAAkB,cAAc,sBAAsB,OAAO,kCAA4B,EACpG,cAAc;CAAC;CAAW;CAAQ;AAAO,EAC3C,CAAC;AAED,IAAa,oBAAoB,WAAW,WAC1C,qBACA;CAAE,UAAU,CAAC,qBAAqB,iBAAiB;CAAG,aAAa,eAAe;AAAM,SAClF,OAAO,iCACf;AAEA,IAAa,mBAAmB,cAAc,uBAAuB,OAAO,kCAA4B,EACtG,aAAa,iBAAiB,KAChC,CAAC;AAED,IAAa,eAAe,cAAc,cAAc,OAAO,8BAAwB,EACrF,OAAO,CAAC,yBAAyB,qBAAqB,EACxD,CAAC;AAED,IAAa,oBAAoB,cAAc,eAAe,OAAO,yBAAmB;CACtF,aAAa,iBAAiB;CAC9B,UAAU,CAAC,sBAAsB,QAAQ;AAC3C,CAAC;AAED,IAAa,eAAe,cAAc,aAAa,YAAY;AAEnE,IAAa,cAAc,cAAc,YAAY;CACnD,UAAU,KAAK,QAAQ;CACvB,MAAM;CACN,SAAS;CACT,UAAU;AACZ,CAAC"}

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

@@ -1 +1 @@
-{"version":3,"file":"capabilities.workerd.mjs","names":[],"sources":["../../src/capabilities/gen/workerd.ts"],"sourcesContent":["//\n// Copyright 2026 DXOS.org\n//\n\n// GENERATED by dx-plugin — do not edit. Sliced from ../index.ts for the 'workerd' condition.\n\nimport * as ActivationEvents from '@dxos/app-framework/ActivationEvents';\nimport * as Capability from '@dxos/app-framework/Capability';\nimport * as AppCapability from '@dxos/app-toolkit/AppCapability';\nimport * as MarkdownCapabilities from '@dxos/plugin-markdown/MarkdownCapabilities';\nimport * as MarkdownEvents from '@dxos/plugin-markdown/MarkdownEvents';\n\nimport { translations } from '#translations';\nimport { PresenterCapabilities } from '#types';\n\nexport const MarkdownExtension = Capability.lazyModule(\n  'MarkdownExtension',\n  { provides: [MarkdownCapabilities.ExtensionProvider], activatesOn: MarkdownEvents.Start },\n  () => import('../markdown-extension'),\n);\n\nexport const OperationHandler = AppCapability.operationHandler(() => import('../operation-handler'), {\n  activatesOn: ActivationEvents.Idle,\n});\n\nexport const PresenterSettings = AppCapability.settings(() => import('../settings'), {\n  activatesOn: ActivationEvents.Idle,\n  provides: [PresenterCapabilities.Settings],\n});\n\nexport const Translations = AppCapability.translations(translations);\n\nexport const AppGraphBuilder = undefined;\nexport const PluginAsset = undefined;\nexport const ReactSurface = undefined;\n"],"mappings":";;;;;;;;AAeA,IAAa,oBAAoB,WAAW,WAC1C,qBACA;CAAE,UAAU,CAAC,qBAAqB,iBAAiB;CAAG,aAAa,eAAe;AAAM,SAClF,OAAO,iCACf;AAEA,IAAa,mBAAmB,cAAc,uBAAuB,OAAO,kCAAyB,EACnG,aAAa,iBAAiB,KAChC,CAAC;AAED,IAAa,oBAAoB,cAAc,eAAe,OAAO,yBAAgB;CACnF,aAAa,iBAAiB;CAC9B,UAAU,CAAC,sBAAsB,QAAQ;AAC3C,CAAC;AAED,IAAa,eAAe,cAAc,aAAa,YAAY;AAEnE,IAAa,kBAAkB,KAAA;AAC/B,IAAa,cAAc,KAAA;AAC3B,IAAa,eAAe,KAAA"}
+{"version":3,"file":"capabilities.workerd.mjs","names":[],"sources":["../../src/capabilities/gen/workerd.ts"],"sourcesContent":["//\n// Copyright 2026 DXOS.org\n//\n\n// GENERATED by dx-plugin — do not edit. Sliced from ../index.ts for the 'workerd' condition.\n\nimport * as ActivationEvents from '@dxos/app-framework/ActivationEvents';\nimport * as Capability from '@dxos/app-framework/Capability';\nimport * as AppCapability from '@dxos/app-toolkit/AppCapability';\nimport * as MarkdownCapabilities from '@dxos/plugin-markdown/MarkdownCapabilities';\nimport * as MarkdownEvents from '@dxos/plugin-markdown/MarkdownEvents';\n\nimport { translations } from '#translations';\nimport { PresenterCapabilities } from '#types';\n\nexport const MarkdownExtension = Capability.lazyModule(\n  'MarkdownExtension',\n  { provides: [MarkdownCapabilities.ExtensionProvider], activatesOn: MarkdownEvents.Start },\n  () => import('../markdown-extension.ts'),\n);\n\nexport const OperationHandler = AppCapability.operationHandler(() => import('../operation-handler.ts'), {\n  activatesOn: ActivationEvents.Idle,\n});\n\nexport const PresenterSettings = AppCapability.settings(() => import('../settings.ts'), {\n  activatesOn: ActivationEvents.Idle,\n  provides: [PresenterCapabilities.Settings],\n});\n\nexport const Translations = AppCapability.translations(translations);\n\nexport const AppGraphBuilder = undefined;\nexport const PluginAsset = undefined;\nexport const ReactSurface = undefined;\n"],"mappings":";;;;;;;;AAeA,IAAa,oBAAoB,WAAW,WAC1C,qBACA;CAAE,UAAU,CAAC,qBAAqB,iBAAiB;CAAG,aAAa,eAAe;AAAM,SAClF,OAAO,iCACf;AAEA,IAAa,mBAAmB,cAAc,uBAAuB,OAAO,kCAA4B,EACtG,aAAa,iBAAiB,KAChC,CAAC;AAED,IAAa,oBAAoB,cAAc,eAAe,OAAO,yBAAmB;CACtF,aAAa,iBAAiB;CAC9B,UAAU,CAAC,sBAAsB,QAAQ;AAC3C,CAAC;AAED,IAAa,eAAe,cAAc,aAAa,YAAY;AAEnE,IAAa,kBAAkB,KAAA;AAC/B,IAAa,cAAc,KAAA;AAC3B,IAAa,eAAe,KAAA"}

package/dist/lib/chunk-CollectionArticle.mjs

@@ -1,38 +1,43 @@
 import { t as useExitPresenter } from "./chunk-useExitPresenter.mjs";
 import { useContext, useState } from "react";
 import { jsx } from "react/jsx-runtime";
-import { Panel } from "@dxos/react-ui";
 import { Obj } from "@dxos/echo";
-import { Surface } from "@dxos/app-framework/ui";
-import { AppSurface } from "@dxos/app-toolkit/ui";
+import * as Surface from "@dxos/app-framework/Surface";
+import * as AppSurface from "@dxos/app-toolkit/AppSurface";
+import * as Hooks from "@dxos/app-toolkit/Hooks";
+import { useObject } from "@dxos/echo-react";
+import * as Panel$1 from "@dxos/react-ui/Panel";
 import { Layout, PageNumber, Pager, PresentationShell, PresenterContext } from "#components";
 //#region src/containers/CollectionArticle/CollectionArticle.tsx
 var CollectionArticle = ({ role, subject: collection }) => {
 	const [slide, setSlide] = useState(0);
 	const { running } = useContext(PresenterContext);
 	const handleExit = useExitPresenter(collection);
-	return /* @__PURE__ */ jsx(Panel.Root, {
+	const fullscreen = Hooks.useLayout().mode === "solo--fullscreen";
+	const [liveCollection] = useObject(collection);
+	return /* @__PURE__ */ jsx(Panel$1.Root, {
 		role,
 		classNames: "relative",
-		children: /* @__PURE__ */ jsx(Panel.Content, {
+		children: /* @__PURE__ */ jsx(Panel$1.Body, {
 			asChild: true,
 			children: /* @__PURE__ */ jsx(PresentationShell, {
+				fullscreen,
 				onExit: handleExit,
 				children: /* @__PURE__ */ jsx(Layout, {
 					bottomRight: /* @__PURE__ */ jsx(PageNumber, {
 						index: slide,
-						count: collection.objects.length
+						count: liveCollection.objects.length
 					}),
 					bottomLeft: /* @__PURE__ */ jsx(Pager, {
 						index: slide,
-						count: collection.objects.length,
+						count: liveCollection.objects.length,
 						keys: running,
 						onChange: setSlide
 					}),
 					children: /* @__PURE__ */ jsx(Surface.Surface, {
 						type: AppSurface.Slide,
 						data: {
-							subject: collection.objects[slide],
+							subject: liveCollection.objects[slide],
 							attendableId: Obj.getURI(collection)
 						}
 					})

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

@@ -1 +1 @@
-{"version":3,"file":"chunk-CollectionArticle.mjs","names":[],"sources":["../../src/containers/CollectionArticle/CollectionArticle.tsx"],"sourcesContent":["//\n// Copyright 2023 DXOS.org\n//\n\nimport React, { useContext, useState } from 'react';\n\nimport { Surface } from '@dxos/app-framework/ui';\nimport { AppSurface } from '@dxos/app-toolkit/ui';\nimport { type Collection, Obj } from '@dxos/echo';\nimport { Panel } from '@dxos/react-ui';\n\nimport { PageNumber, Pager, PresentationShell, PresenterContext, Layout as PresenterLayout } from '#components';\n\nimport { useExitPresenter } from '../../useExitPresenter';\n\nexport type CollectionArticleProps = AppSurface.ObjectArticleProps<Collection.Collection>;\n\nexport const CollectionArticle = ({ role, subject: collection }: CollectionArticleProps) => {\n  const [slide, setSlide] = useState(0);\n  const { running } = useContext(PresenterContext);\n  const handleExit = useExitPresenter(collection);\n\n  return (\n    <Panel.Root role={role} classNames='relative'>\n      <Panel.Content asChild>\n        <PresentationShell onExit={handleExit}>\n          <PresenterLayout\n            bottomRight={<PageNumber index={slide} count={collection.objects.length} />}\n            bottomLeft={<Pager index={slide} count={collection.objects.length} keys={running} onChange={setSlide} />}\n          >\n            <Surface.Surface\n              type={AppSurface.Slide}\n              data={{\n                subject: collection.objects[slide],\n                attendableId: Obj.getURI(collection),\n              }}\n            />\n          </PresenterLayout>\n        </PresentationShell>\n      </Panel.Content>\n    </Panel.Root>\n  );\n};\n\nCollectionArticle.displayName = 'CollectionArticle';\n"],"mappings":";;;;;;;;;AAiBA,IAAa,qBAAqB,EAAE,MAAM,SAAS,iBAAyC;CAC1F,MAAM,CAAC,OAAO,YAAY,SAAS,CAAC;CACpC,MAAM,EAAE,YAAY,WAAW,gBAAgB;CAC/C,MAAM,aAAa,iBAAiB,UAAU;CAE9C,OACE,oBAAC,MAAM,MAAP;EAAkB;EAAM,YAAW;EACjC,UAAA,oBAAC,MAAM,SAAP;GAAe,SAAA;GACb,UAAA,oBAAC,mBAAD;IAAmB,QAAQ;IACzB,UAAA,oBAAC,QAAD;KACE,aAAa,oBAAC,YAAD;MAAY,OAAO;MAAO,OAAO,WAAW,QAAQ;KAAS,CAAA;KAC1E,YAAY,oBAAC,OAAD;MAAO,OAAO;MAAO,OAAO,WAAW,QAAQ;MAAQ,MAAM;MAAS,UAAU;KAAW,CAAA;KAEvG,UAAA,oBAAC,QAAQ,SAAT;MACE,MAAM,WAAW;MACjB,MAAM;OACJ,SAAS,WAAW,QAAQ;OAC5B,cAAc,IAAI,OAAO,UAAU;MACrC;KACD,CAAA;IACc,CAAA;GACA,CAAA;EACN,CAAA;CACL,CAAA;AAEhB;AAEA,kBAAkB,cAAc"}
+{"version":3,"file":"chunk-CollectionArticle.mjs","names":[],"sources":["../../src/containers/CollectionArticle/CollectionArticle.tsx"],"sourcesContent":["//\n// Copyright 2023 DXOS.org\n//\n\nimport React, { useContext, useState } from 'react';\n\nimport * as Surface from '@dxos/app-framework/Surface';\nimport * as AppSurface from '@dxos/app-toolkit/AppSurface';\nimport * as Hooks from '@dxos/app-toolkit/Hooks';\nimport { type Collection, Obj } from '@dxos/echo';\nimport { useObject } from '@dxos/echo-react';\nimport * as Panel from '@dxos/react-ui/Panel';\n\nimport { PageNumber, Pager, PresentationShell, PresenterContext, Layout as PresenterLayout } from '#components';\n\nimport { useExitPresenter } from '../../useExitPresenter.ts';\n\nexport type CollectionArticleProps = AppSurface.ObjectArticleProps<Collection.Collection>;\n\nexport const CollectionArticle = ({ role, subject: collection }: CollectionArticleProps) => {\n  const [slide, setSlide] = useState(0);\n  const { running } = useContext(PresenterContext);\n  const handleExit = useExitPresenter(collection);\n  const layout = Hooks.useLayout();\n  const fullscreen = layout.mode === 'solo--fullscreen';\n  const [liveCollection] = useObject(collection);\n\n  return (\n    <Panel.Root role={role} classNames='relative'>\n      <Panel.Body asChild>\n        <PresentationShell fullscreen={fullscreen} onExit={handleExit}>\n          <PresenterLayout\n            bottomRight={<PageNumber index={slide} count={liveCollection.objects.length} />}\n            bottomLeft={\n              <Pager index={slide} count={liveCollection.objects.length} keys={running} onChange={setSlide} />\n            }\n          >\n            <Surface.Surface\n              type={AppSurface.Slide}\n              data={{\n                subject: liveCollection.objects[slide],\n                attendableId: Obj.getURI(collection),\n              }}\n            />\n          </PresenterLayout>\n        </PresentationShell>\n      </Panel.Body>\n    </Panel.Root>\n  );\n};\n\nCollectionArticle.displayName = 'CollectionArticle';\n"],"mappings":";;;;;;;;;;;AAmBA,IAAa,qBAAqB,EAAE,MAAM,SAAS,iBAAyC;CAC1F,MAAM,CAAC,OAAO,YAAY,SAAS,CAAC;CACpC,MAAM,EAAE,YAAY,WAAW,gBAAgB;CAC/C,MAAM,aAAa,iBAAiB,UAAU;CAE9C,MAAM,aADS,MAAM,UACF,CAAA,CAAO,SAAS;CACnC,MAAM,CAAC,kBAAkB,UAAU,UAAU;CAE7C,OACE,oBAAC,QAAM,MAAP;EAAkB;EAAM,YAAW;EACjC,UAAA,oBAAC,QAAM,MAAP;GAAY,SAAA;GACV,UAAA,oBAAC,mBAAD;IAA+B;IAAY,QAAQ;IACjD,UAAA,oBAAC,QAAD;KACE,aAAa,oBAAC,YAAD;MAAY,OAAO;MAAO,OAAO,eAAe,QAAQ;KAAS,CAAA;KAC9E,YACE,oBAAC,OAAD;MAAO,OAAO;MAAO,OAAO,eAAe,QAAQ;MAAQ,MAAM;MAAS,UAAU;KAAW,CAAA;KAGjG,UAAA,oBAAC,QAAQ,SAAT;MACE,MAAM,WAAW;MACjB,MAAM;OACJ,SAAS,eAAe,QAAQ;OAChC,cAAc,IAAI,OAAO,UAAU;MACrC;KACD,CAAA;IACc,CAAA;GACA,CAAA;EACT,CAAA;CACF,CAAA;AAEhB;AAEA,kBAAkB,cAAc"}

package/dist/lib/chunk-DocumentArticle.mjs

@@ -1,23 +1,25 @@
 import { t as useExitPresenter } from "./chunk-useExitPresenter.mjs";
 import "react";
 import { jsx } from "react/jsx-runtime";
-import { Panel } from "@dxos/react-ui";
-import { useLayout } from "@dxos/app-toolkit/ui";
+import * as Hooks from "@dxos/app-toolkit/Hooks";
+import { useObject } from "@dxos/echo-react";
+import * as Panel$1 from "@dxos/react-ui/Panel";
 import { PresentationShell, RevealPlayer } from "#components";
 //#region src/containers/DocumentArticle/DocumentArticle.tsx
 var DocumentArticle = ({ role, subject: document }) => {
 	const handleExit = useExitPresenter(document);
-	const fullscreen = useLayout().mode === "solo--fullscreen";
-	const content = document.content.target?.content;
-	return /* @__PURE__ */ jsx(Panel.Root, {
+	const fullscreen = Hooks.useLayout().mode === "solo--fullscreen";
+	const [content] = useObject(document.content, "content");
+	return /* @__PURE__ */ jsx(Panel$1.Root, {
 		role,
 		classNames: "relative",
-		children: /* @__PURE__ */ jsx(Panel.Content, {
+		children: /* @__PURE__ */ jsx(Panel$1.Body, {
 			asChild: true,
 			children: /* @__PURE__ */ jsx(PresentationShell, {
 				fullscreen,
 				onExit: handleExit,
 				children: content !== void 0 && /* @__PURE__ */ jsx(RevealPlayer, {
+					"data-testid": "presenter.deck",
 					fullscreen,
 					content
 				})

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

@@ -1 +1 @@
-{"version":3,"file":"chunk-DocumentArticle.mjs","names":[],"sources":["../../src/containers/DocumentArticle/DocumentArticle.tsx"],"sourcesContent":["//\n// Copyright 2023 DXOS.org\n//\n\nimport React from 'react';\n\nimport { AppSurface, useLayout } from '@dxos/app-toolkit/ui';\nimport type * as Markdown from '@dxos/plugin-markdown/Markdown';\nimport { Panel } from '@dxos/react-ui';\n\nimport { PresentationShell, RevealPlayer } from '#components';\n\nimport { useExitPresenter } from '../../useExitPresenter';\n\nexport type DocumentArticleProps = AppSurface.ObjectArticleProps<Markdown.Document>;\n\nexport const DocumentArticle = ({ role, subject: document }: DocumentArticleProps) => {\n  const handleExit = useExitPresenter(document);\n  const layout = useLayout();\n  const fullscreen = layout.mode === 'solo--fullscreen';\n  // RevealPlayer seeds its deck once from `content` (via a `defaultValue`); wait for the markdown ref to\n  // resolve so the presentation isn't initialized empty and left blank when the content arrives later.\n  const content = document.content.target?.content;\n\n  return (\n    <Panel.Root role={role} classNames='relative'>\n      <Panel.Content asChild>\n        <PresentationShell fullscreen={fullscreen} onExit={handleExit}>\n          {content !== undefined && <RevealPlayer fullscreen={fullscreen} content={content} />}\n        </PresentationShell>\n      </Panel.Content>\n    </Panel.Root>\n  );\n};\n\nDocumentArticle.displayName = 'DocumentArticle';\n"],"mappings":";;;;;;;AAgBA,IAAa,mBAAmB,EAAE,MAAM,SAAS,eAAqC;CACpF,MAAM,aAAa,iBAAiB,QAAQ;CAE5C,MAAM,aADS,UACI,CAAA,CAAO,SAAS;CAGnC,MAAM,UAAU,SAAS,QAAQ,QAAQ;CAEzC,OACE,oBAAC,MAAM,MAAP;EAAkB;EAAM,YAAW;EACjC,UAAA,oBAAC,MAAM,SAAP;GAAe,SAAA;GACb,UAAA,oBAAC,mBAAD;IAA+B;IAAY,QAAQ;IAChD,UAAA,YAAY,KAAA,KAAa,oBAAC,cAAD;KAA0B;KAAqB;IAAU,CAAA;GAClE,CAAA;EACN,CAAA;CACL,CAAA;AAEhB;AAEA,gBAAgB,cAAc"}
+{"version":3,"file":"chunk-DocumentArticle.mjs","names":[],"sources":["../../src/containers/DocumentArticle/DocumentArticle.tsx"],"sourcesContent":["//\n// Copyright 2023 DXOS.org\n//\n\nimport React from 'react';\n\nimport * as AppSurface from '@dxos/app-toolkit/AppSurface';\nimport * as Hooks from '@dxos/app-toolkit/Hooks';\nimport { useObject } from '@dxos/echo-react';\nimport type * as Markdown from '@dxos/plugin-markdown/Markdown';\nimport * as Panel from '@dxos/react-ui/Panel';\n\nimport { PresentationShell, RevealPlayer } from '#components';\n\nimport { useExitPresenter } from '../../useExitPresenter.ts';\n\nexport type DocumentArticleProps = AppSurface.ObjectArticleProps<Markdown.Document>;\n\nexport const DocumentArticle = ({ role, subject: document }: DocumentArticleProps) => {\n  const handleExit = useExitPresenter(document);\n  const layout = Hooks.useLayout();\n  const fullscreen = layout.mode === 'solo--fullscreen';\n  const [content] = useObject(document.content, 'content');\n\n  return (\n    <Panel.Root role={role} classNames='relative'>\n      <Panel.Body asChild>\n        <PresentationShell fullscreen={fullscreen} onExit={handleExit}>\n          {content !== undefined && (\n            <RevealPlayer data-testid='presenter.deck' fullscreen={fullscreen} content={content} />\n          )}\n        </PresentationShell>\n      </Panel.Body>\n    </Panel.Root>\n  );\n};\n\nDocumentArticle.displayName = 'DocumentArticle';\n"],"mappings":";;;;;;;;AAkBA,IAAa,mBAAmB,EAAE,MAAM,SAAS,eAAqC;CACpF,MAAM,aAAa,iBAAiB,QAAQ;CAE5C,MAAM,aADS,MAAM,UACF,CAAA,CAAO,SAAS;CACnC,MAAM,CAAC,WAAW,UAAU,SAAS,SAAS,SAAS;CAEvD,OACE,oBAAC,QAAM,MAAP;EAAkB;EAAM,YAAW;EACjC,UAAA,oBAAC,QAAM,MAAP;GAAY,SAAA;GACV,UAAA,oBAAC,mBAAD;IAA+B;IAAY,QAAQ;IAChD,UAAA,YAAY,KAAA,KACX,oBAAC,cAAD;KAAc,eAAY;KAA6B;KAAqB;IAAU,CAAA;GAEvE,CAAA;EACT,CAAA;CACF,CAAA;AAEhB;AAEA,gBAAgB,cAAc"}

package/dist/lib/chunk-PLUGIN.mjs

@@ -0,0 +1,6 @@
+//#region PLUGIN.mdl?raw
+var PLUGIN_default = "---\nid: org.dxos.plugin.presenter\nname: PresenterPlugin\nversion: 0.1.0\n---\n\nA presentation plugin for DXOS Composer that turns existing workspace objects — markdown documents and collections — into interactive slideshows with fullscreen mode and keyboard navigation.\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| `scenario`  | `org.dxos.mdl.scenario@1.0`   |\n| `component` | `org.dxos.mdl.component@1.0`  |\n| `op`        | `org.dxos.mdl.op@1.1`         |\n| `test`      | `org.dxos.mdl.test@1.0`       |\n| `step`      | `org.dxos.mdl.step@1.0`       |\n\n## Types\n\n```mdl\ntype PresentationTarget\n  literals: document | collection\n  desc: The kind of workspace object being presented.\n```\n\n```mdl\ntype SlideIndex\n  fields:\n    current: number             # zero-based index of the active slide\n    count: number               # total number of slides in the presentation\n```\n\n```mdl\ntype PresentationSettings\n  fields:\n    presentCollections?: boolean  # when true, Collections may also be presented as slideshows (experimental)\n```\n\n## Components\n\n```mdl\ncomponent DocumentArticle\n  desc: |\n    Full-screen Reveal.js player for a single Markdown document.\n    Parses the document content into slides using horizontal/vertical `---` separators.\n    Renders in a Panel that fills the available viewport.\n  props:\n    document: Markdown.Document\n  slots:\n    (none)\n  actions:\n    exit()                      # navigates back to the originating document view\n  layout: |\n    ┌─────────────────────────────┐\n    │                             │\n    │        RevealPlayer         │\n    │  (full-screen slide canvas) │\n    │                             │\n    └─────────────────────────────┘\n```\n\n```mdl\ncomponent CollectionArticle\n  desc: |\n    Slideshow player for a Collection.\n    Renders one slide per object in the collection's ordered items array.\n    The active slide is delegated to the AppSurface.Slide surface, so each\n    item's own plugin renders it (e.g. SlideArticle for documents).\n  props:\n    subject: Collection.Collection\n    role?: string\n  state:\n    slide: number               # zero-based index of the current slide\n    running: boolean            # whether keyboard navigation is active (from PresenterContext)\n  slots:\n    (none)\n  actions:\n    setSlide(index: number)\n    exit()\n  layout: |\n    ┌─────────────────────────────┐\n    │                             │\n    │       Surface (slide N)     │  ← AppSurface.Slide surface\n    │                             │\n    ├────────────────┬────────────┤\n    │   [Pager]      │ [PageNum]  │\n    └────────────────┴────────────┘\n```\n\n```mdl\ncomponent SlideArticle\n  desc: |\n    Renders a single Markdown document as a slide panel inside a Collection presentation.\n    Used as the AppSurface.Slide surface implementation for Markdown.Document objects.\n  props:\n    document: Markdown.Document\n  layout: |\n    ┌─────────────────────────────┐\n    │  Panel                      │\n    │   └─ Slide (markdown)       │\n    └─────────────────────────────┘\n```\n\n## Operations\n\n```mdl\nop TogglePresentation\n  key: org.dxos.operation.presenter.setPresenting\n  desc: |\n    Enters or exits presentation for a Markdown document or Collection by toggling the deck's\n    fullscreen overlay (EphemeralDeckState.fullscreen) onto the presenter companion node.\n    The overlay is independent of what is open, so neither direction navigates: the URL and the\n    open planks are unchanged.\n  input:\n    object: Markdown.Document | Collection.Collection\n    state: boolean              # on or off; callers that flip read the current state first\n  output: void\n  effects: [deck:fullscreen]\n  requires: [DeckCapabilities.EphemeralState, DeckOperation.Adjust]\n  note: |\n    Resolves the presenter companion node path as `<objectPath>/~presenter`.\n    Keyboard shortcut: Shift+Cmd+P (macOS), Shift+Alt+P (Windows/Linux).\n```\n\n## Features\n\n```mdl\nfeat F-1: Presentation Mode\n\n  req F-1.1: Every Markdown document in the workspace has a companion \"Presenter\" node in the app graph.\n  req F-1.2:\n    when: settings.presentCollections is true\n    then: every Collection also has a companion Presenter node\n  req F-1.3:\n    when: user activates TogglePresentation on a document or collection\n    then: the presenter companion fills the screen in the deck's fullscreen overlay, without the companion tab strip, and the URL does not change\n  req F-1.4:\n    when: user presses Shift+Cmd+P (macOS) or Shift+Alt+P (Windows)\n    then: TogglePresentation is invoked for the focused object\n```\n\n```mdl\nfeat F-2: Document Slideshow (Reveal.js)\n\n  req F-2.1:\n    when: DocumentArticle mounts with a Markdown.Document\n    then: RevealPlayer parses the document content and renders slides\n  req F-2.2: Horizontal slides are separated by `---`; vertical slides by `----`.\n  req F-2.3:\n    when: user presses Escape or the exit action is triggered\n    then: presenter navigates back to the originating document view\n```\n\n```mdl\nfeat F-3: Collection Slideshow\n\n  req F-3.1:\n    when: CollectionArticle mounts with a Collection\n    then: slide 0 is shown, corresponding to collection.objects[0]\n  req F-3.2:\n    when: user navigates to slide N via the Pager\n    then: the AppSurface.Slide surface renders collection.objects[N]\n  req F-3.3: PageNumber displays the current slide index and total count.\n  req F-3.4:\n    when: user presses Escape or the exit action is triggered\n    then: presenter navigates back to the collection view\n```\n\n```mdl\nfeat F-4: Plugin Settings\n\n  req F-4.1: PresenterSettings panel is registered for the plugin settings surface.\n  req F-4.2:\n    when: user enables \"Present collections (experimental)\"\n    then: settings.presentCollections is set to true and Collection nodes gain Presenter companions\n```\n\n## Acceptance\n\n```mdl\nscenario T-1: Document presenter opens in fullscreen\n  given: a Markdown document exists in the workspace\n  when: user invokes TogglePresentation (keyboard or action menu)\n  then:\n    - Composer switches to solo-fullscreen layout\n    - DocumentArticle is shown with the document content\n    - RevealPlayer is visible with at least one slide\n```\n\n```mdl\nscenario T-2: Slide navigation via Reveal.js\n  given: a Markdown document with three `---`-separated sections\n  when: DocumentArticle renders the document\n  then:\n    - three horizontal slides are produced\n    - arrow-key navigation advances and retreats between slides\n```\n\n```mdl\nscenario T-3: Exit returns to document view\n  given: DocumentArticle is open in fullscreen\n  when: user presses Escape\n  then: the fullscreen overlay closes, leaving the document and its companion as they were\n```\n\n```mdl\nscenario T-4: Collection slideshow renders per-item surfaces\n  given: a Collection with two Markdown documents and settings.presentCollections = true\n  when: CollectionArticle mounts\n  then:\n    - slide 0 shows SlideArticle for collection.objects[0]\n    - Pager shows count = 2\n```\n\n```mdl\nscenario T-5: Collection slide advance\n  given: CollectionArticle at slide 0 with a three-item collection\n  when: user clicks the next-slide control in Pager\n  then:\n    - slide index advances to 1\n    - AppSurface.Slide renders collection.objects[1]\n    - PageNumber shows \"2 / 3\"\n```\n\n```mdl\nscenario T-6: Collections hidden when setting disabled\n  given: settings.presentCollections is false (default)\n  when: app graph is built for a Collection node\n  then: no Presenter companion node is created for the collection\n```\n\n```mdl\nscenario T-7: Keyboard shortcut registered\n  given: a Markdown document node is focused in the app graph\n  then:\n    - action with key TogglePresentation is present on the node\n    - keyBinding shows Shift+Cmd+P on macOS\n```\n\n---\n\n## QA\n\nExecutable tests. Each step carries a human instruction (`do`) and, where the step maps to an\ninvocable operation, an agent binding (`invoke`). Report failures by test and step number.\n\n```mdl\ntest QA-1: Preview a document in the companion, then present it\n  desc: The core presenter round-trip — create a document with slide separators, preview it in the presenter companion, present it fullscreen, then exit.\n  actors: both\n  covers: [F-1.1, F-1.3, F-2.1, F-2.2, F-2.3, T-1, T-3]\n  status: unverified\n  automated:\n    - composer-e2e:presenter.spec.ts#Presenter › preview a document in the companion, then present it\n  given:\n    - an identity exists\n    - space: a space is open\n    - collection: a collection in that space, to create into\n    - plugin-presenter is enabled — it is OFF by default (absent from `getDefaults` in\n      `plugin-defs.tsx`), though the plugin itself is registered unconditionally so it always\n      appears in the plugin registry to enable manually\n    - no document named \"QA Slides\" exists — ABORT rather than deleting one this test did not create\n  steps:\n    - name: Create a document with slides\n      do: In the navtree, click + on a collection and choose Markdown. Name it \"QA Slides\".\n      invoke: org.dxos.operation.markdown.createDraft { name: \"QA Slides\", content: \"# Slide one\\n\\n---\\n\\n# Slide two\\n\" }\n      capture: created\n      expect: a Document named \"QA Slides\" now exists with two `---`-separated sections\n      assert: return !!$created.object\n    - name: Place it\n      do: (the navtree create action places it for you)\n      invoke: org.dxos.operation.space.addObject { object: $created.object, target: $given.collection }\n      expect: \"QA Slides\" appears as a row under the collection\n    - name: Preview in the companion\n      do: Open \"QA Slides\", open its companion and pick the Presenter tab.\n      expect: the companion shows \"Slide one\" as a slide scaled to the companion's width\n    - name: Enter presentation mode\n      do: Choose Present from the document's actions menu, or press Shift+Cmd+P (macOS) / Shift+Alt+P (Windows/Linux).\n      invoke: org.dxos.operation.presenter.setPresenting { object: $created.object, state: true }\n      expect: the slides fill the screen showing \"Slide one\", with no companion tab strip; the URL is unchanged\n      assert: return document.body.innerText.includes('Slide one');\n    - name: Exit presentation mode\n      do: Press Escape.\n      invoke: org.dxos.operation.presenter.setPresenting { object: $created.object, state: false }\n      expect: the document plank and its presenter companion are back as they were, and the URL is unchanged\n      assert: return !!document.querySelector('[data-testid=\"deck.viewport\"]');\n  after:\n    - name: Delete the document\n      do: Right-click \"QA Slides\" in the navtree and choose Delete.\n      invoke: org.dxos.operation.space.removeObjects { objects: [$created.object], target: $given.collection }\n      expect: the row leaves the navtree and its plank closes\n```\n\n---\n\n## Appendix: Extension Definitions\n\nExtension block types used in this document are defined below using\nthe core `ext` primitive — the only construct the base language provides.\n\n```mdl\next type\n  uri: 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\n    literals?: UnionList\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\n```\n\n```mdl\next scenario\n  uri: org.dxos.mdl.scenario@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\n    state?: FieldMap\n    slots?: FieldMap\n    actions?: ActionMap\n    emits?: EventMap\n    layout?: CodeBlock\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\n    output?: TypeExpr\n    errors?: ErrorMap\n    effects?: EffectList\n    requires?: ServiceList\n    note?: Prose\n```\n";
+//#endregion
+export { PLUGIN_default as t };
+
+//# sourceMappingURL=chunk-PLUGIN.mjs.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"chunk-PLUGIN.mjs","names":[],"sources":[],"mappings":""}

package/dist/lib/chunk-SlideArticle.mjs

@@ -1,9 +1,10 @@
 import "react";
 import { jsx } from "react/jsx-runtime";
+import { useObject } from "@dxos/echo-react";
 import { Panel, Slide } from "#components";
 //#region src/containers/SlideArticle/SlideArticle.tsx
 var SlideArticle = ({ subject: document }) => {
-	const content = document.content.target?.content;
+	const [content] = useObject(document.content, "content");
 	if (!content) return null;
 	return /* @__PURE__ */ jsx(Panel, {
 		classNames: "border",

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

@@ -1 +1 @@
-{"version":3,"file":"chunk-SlideArticle.mjs","names":[],"sources":["../../src/containers/SlideArticle/SlideArticle.tsx"],"sourcesContent":["//\n// Copyright 2023 DXOS.org\n//\n\nimport React from 'react';\n\nimport { AppSurface } from '@dxos/app-toolkit/ui';\nimport type * as Markdown from '@dxos/plugin-markdown/Markdown';\n\nimport { Panel, Slide } from '#components';\n\nexport type SlideArticleProps = AppSurface.ObjectSectionProps<Markdown.Document>;\n\nexport const SlideArticle = ({ subject: document }: SlideArticleProps) => {\n  const content = document.content.target?.content;\n  if (!content) {\n    return null;\n  }\n\n  return (\n    <Panel classNames='border'>\n      <Slide content={content} />\n    </Panel>\n  );\n};\n\nSlideArticle.displayName = 'SlideArticle';\n"],"mappings":";;;;AAaA,IAAa,gBAAgB,EAAE,SAAS,eAAkC;CACxE,MAAM,UAAU,SAAS,QAAQ,QAAQ;CACzC,IAAI,CAAC,SACH,OAAO;CAGT,OACE,oBAAC,OAAD;EAAO,YAAW;EAChB,UAAA,oBAAC,OAAD,EAAgB,QAAU,CAAA;CACrB,CAAA;AAEX;AAEA,aAAa,cAAc"}
+{"version":3,"file":"chunk-SlideArticle.mjs","names":[],"sources":["../../src/containers/SlideArticle/SlideArticle.tsx"],"sourcesContent":["//\n// Copyright 2023 DXOS.org\n//\n\nimport React from 'react';\n\nimport * as AppSurface from '@dxos/app-toolkit/AppSurface';\nimport { useObject } from '@dxos/echo-react';\nimport type * as Markdown from '@dxos/plugin-markdown/Markdown';\n\nimport { Panel, Slide } from '#components';\n\nexport type SlideArticleProps = AppSurface.ObjectSectionProps<Markdown.Document>;\n\nexport const SlideArticle = ({ subject: document }: SlideArticleProps) => {\n  const [content] = useObject(document.content, 'content');\n  if (!content) {\n    return null;\n  }\n\n  return (\n    <Panel classNames='border'>\n      <Slide content={content} />\n    </Panel>\n  );\n};\n\nSlideArticle.displayName = 'SlideArticle';\n"],"mappings":";;;;;AAcA,IAAa,gBAAgB,EAAE,SAAS,eAAkC;CACxE,MAAM,CAAC,WAAW,UAAU,SAAS,SAAS,SAAS;CACvD,IAAI,CAAC,SACH,OAAO;CAGT,OACE,oBAAC,OAAD;EAAO,YAAW;EAChB,UAAA,oBAAC,OAAD,EAAgB,QAAU,CAAA;CACrB,CAAA;AAEX;AAEA,aAAa,cAAc"}

package/dist/lib/chunk-app-graph-builder.mjs

@@ -24,6 +24,7 @@ var app_graph_builder_default = Capability.makeModule(Effect.fnUntraced(function
 	};
 	const extensions = yield* AppGraphBuilder.createExtension({
 		id: "root",
+		relation: AppNode.companion,
 		match: whenPresentable,
 		connector: (object, get) => {
 			if (!isPresentable(object, get)) return Effect.succeed([]);
@@ -53,6 +54,7 @@ var app_graph_builder_default = Capability.makeModule(Effect.fnUntraced(function
 					label: ["toggle-presentation.label", { ns: meta.profile.key }],
 					icon: "ph--presentation--regular",
 					disposition: "list-item",
+					testId: "presenter.present",
 					keyBinding: {
 						macos: "shift+meta+p",
 						windows: "shift+alt+p"

package/dist/lib/chunk-app-graph-builder.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"chunk-app-graph-builder.mjs","names":[],"sources":["../../src/capabilities/app-graph-builder.ts"],"sourcesContent":["//\n// Copyright 2025 DXOS.org\n//\n\nimport * as Effect from 'effect/Effect';\nimport * as Option from 'effect/Option';\nimport type * as Atom from 'effect/unstable/reactivity/Atom';\n\nimport * as Capabilities from '@dxos/app-framework/Capabilities';\nimport * as Capability from '@dxos/app-framework/Capability';\nimport * as AppGraphBuilder from '@dxos/app-graph/AppGraphBuilder';\nimport type * as AppGraphNode from '@dxos/app-graph/AppGraphNode';\nimport * as AppCapabilities from '@dxos/app-toolkit/AppCapabilities';\nimport * as AppNode from '@dxos/app-toolkit/AppNode';\nimport * as AppNodeMatcher from '@dxos/app-toolkit/AppNodeMatcher';\nimport * as Operation from '@dxos/compute/Operation';\nimport { Collection, Obj } from '@dxos/echo';\nimport * as DeckCapabilities from '@dxos/plugin-deck/DeckCapabilities';\nimport * as Markdown from '@dxos/plugin-markdown/Markdown';\n\nimport { meta } from '#meta';\nimport { PresenterCapabilities, PresenterOperation } from '#types';\n\nimport { isPresenting } from '../paths';\n\n/** Match nodes that can be presented (Collection or Document). */\nconst whenPresentable = (node: AppGraphNode.Node, get: Atom.AtomContext) =>\n  Option.orElse(AppNodeMatcher.whenEchoType(Collection.Collection)(node, get), () =>\n    AppNodeMatcher.whenEchoType(Markdown.Document)(node, get),\n  );\n\nexport default Capability.makeModule(\n  Effect.fnUntraced(function* () {\n    // Read reactively so the extension establishes a dependency and heals once this\n    // capability lands (dependency modules contribute individually, not batched per wave).\n    const settingsCapabilityAtom = yield* Capability.atom(PresenterCapabilities.Settings);\n\n    const isPresentable = (object: Obj.Any, get: Atom.AtomContext) => {\n      const [settingsAtom] = get(settingsCapabilityAtom);\n      const settings = settingsAtom ? get(settingsAtom) : undefined;\n      return settings?.presentCollections\n        ? Obj.instanceOf(Collection.Collection, object) || Obj.instanceOf(Markdown.Document, object)\n        : Obj.instanceOf(Markdown.Document, object);\n    };\n\n    const extensions = yield* AppGraphBuilder.createExtension({\n      id: 'root',\n      // TODO(wittjosiah): This is a hack to work around presenter previously relying on \"variant\". Remove.\n      match: whenPresentable,\n      connector: (object, get) => {\n        if (!isPresentable(object, get)) {\n          return Effect.succeed([]);\n        }\n\n        return Effect.succeed([\n          AppNode.makeCompanion({\n            variant: 'presenter',\n            label: 'Presenter',\n            icon: 'ph--presentation--regular',\n            data: { type: meta.profile.key, object },\n          }),\n        ]);\n      },\n      actions: (object, get) => {\n        const db = Obj.getDatabase(object);\n        if (!isPresentable(object, get) || !db) {\n          return Effect.succeed([]);\n        }\n\n        return Effect.succeed([\n          {\n            id: PresenterOperation.SetPresenting.meta.key,\n            // The menu item flips, so it reads the current state and states the one it wants.\n            data: Effect.fnUntraced(function* () {\n              const ephemeral = yield* Capabilities.getAtomValue(DeckCapabilities.EphemeralState);\n              yield* Operation.invoke(PresenterOperation.SetPresenting, {\n                object,\n                state: !isPresenting(ephemeral, object),\n              });\n            }),\n            properties: {\n              label: ['toggle-presentation.label', { ns: meta.profile.key }],\n              icon: 'ph--presentation--regular',\n              disposition: 'list-item',\n              keyBinding: {\n                macos: 'shift+meta+p',\n                windows: 'shift+alt+p',\n              },\n            },\n          },\n        ]);\n      },\n    });\n\n    return Capability.contribute(AppCapabilities.AppGraphBuilder, extensions);\n  }),\n);\n"],"mappings":";;;;;;;;;;;;;;;;;AA0BA,IAAM,mBAAmB,MAAyB,QAChD,OAAO,OAAO,eAAe,aAAa,WAAW,UAAU,CAAC,CAAC,MAAM,GAAG,SACxE,eAAe,aAAa,SAAS,QAAQ,CAAC,CAAC,MAAM,GAAG,CAC1D;AAEF,IAAA,4BAAe,WAAW,WACxB,OAAO,WAAW,aAAa;CAG7B,MAAM,yBAAyB,OAAO,WAAW,KAAK,sBAAsB,QAAQ;CAEpF,MAAM,iBAAiB,QAAiB,QAA0B;EAChE,MAAM,CAAC,gBAAgB,IAAI,sBAAsB;EAEjD,QADiB,eAAe,IAAI,YAAY,IAAI,KAAA,EAAA,EACnC,qBACb,IAAI,WAAW,WAAW,YAAY,MAAM,KAAK,IAAI,WAAW,SAAS,UAAU,MAAM,IACzF,IAAI,WAAW,SAAS,UAAU,MAAM;CAC9C;CAEA,MAAM,aAAa,OAAO,gBAAgB,gBAAgB;EACxD,IAAI;EAEJ,OAAO;EACP,YAAY,QAAQ,QAAQ;GAC1B,IAAI,CAAC,cAAc,QAAQ,GAAG,GAC5B,OAAO,OAAO,QAAQ,CAAC,CAAC;GAG1B,OAAO,OAAO,QAAQ,CACpB,QAAQ,cAAc;IACpB,SAAS;IACT,OAAO;IACP,MAAM;IACN,MAAM;KAAE,MAAM,KAAK,QAAQ;KAAK;IAAO;GACzC,CAAC,CACH,CAAC;EACH;EACA,UAAU,QAAQ,QAAQ;GACxB,MAAM,KAAK,IAAI,YAAY,MAAM;GACjC,IAAI,CAAC,cAAc,QAAQ,GAAG,KAAK,CAAC,IAClC,OAAO,OAAO,QAAQ,CAAC,CAAC;GAG1B,OAAO,OAAO,QAAQ,CACpB;IACE,IAAI,mBAAmB,cAAc,KAAK;IAE1C,MAAM,OAAO,WAAW,aAAa;KACnC,MAAM,YAAY,OAAO,aAAa,aAAa,iBAAiB,cAAc;KAClF,OAAO,UAAU,OAAO,mBAAmB,eAAe;MACxD;MACA,OAAO,CAAC,aAAa,WAAW,MAAM;KACxC,CAAC;IACH,CAAC;IACD,YAAY;KACV,OAAO,CAAC,6BAA6B,EAAE,IAAI,KAAK,QAAQ,IAAI,CAAC;KAC7D,MAAM;KACN,aAAa;KACb,YAAY;MACV,OAAO;MACP,SAAS;KACX;IACF;GACF,CACF,CAAC;EACH;CACF,CAAC;CAED,OAAO,WAAW,WAAW,gBAAgB,iBAAiB,UAAU;AAC1E,CAAC,CACH"}
+{"version":3,"file":"chunk-app-graph-builder.mjs","names":[],"sources":["../../src/capabilities/app-graph-builder.ts"],"sourcesContent":["//\n// Copyright 2025 DXOS.org\n//\n\nimport * as Effect from 'effect/Effect';\nimport * as Option from 'effect/Option';\nimport type * as Atom from 'effect/reactivity/Atom';\n\nimport * as Capabilities from '@dxos/app-framework/Capabilities';\nimport * as Capability from '@dxos/app-framework/Capability';\nimport * as AppGraphBuilder from '@dxos/app-graph/AppGraphBuilder';\nimport * as AppGraphNode from '@dxos/app-graph/AppGraphNode';\nimport * as AppCapabilities from '@dxos/app-toolkit/AppCapabilities';\nimport * as AppNode from '@dxos/app-toolkit/AppNode';\nimport * as AppNodeMatcher from '@dxos/app-toolkit/AppNodeMatcher';\nimport * as Operation from '@dxos/compute/Operation';\nimport { Collection, Obj } from '@dxos/echo';\nimport * as DeckCapabilities from '@dxos/plugin-deck/DeckCapabilities';\nimport * as Markdown from '@dxos/plugin-markdown/Markdown';\n\nimport { meta } from '#meta';\nimport { PresenterCapabilities, PresenterOperation } from '#types';\n\nimport { isPresenting } from '../paths.ts';\n\n/** Match nodes that can be presented (Collection or Document). */\nconst whenPresentable = (node: AppGraphNode.Node, get: Atom.AtomContext) =>\n  Option.orElse(AppNodeMatcher.whenEchoType(Collection.Collection)(node, get), () =>\n    AppNodeMatcher.whenEchoType(Markdown.Document)(node, get),\n  );\n\nexport default Capability.makeModule(\n  Effect.fnUntraced(function* () {\n    // Read reactively so the extension establishes a dependency and heals once this\n    // capability lands (dependency modules contribute individually, not batched per wave).\n    const settingsCapabilityAtom = yield* Capability.atom(PresenterCapabilities.Settings);\n\n    const isPresentable = (object: Obj.Any, get: Atom.AtomContext) => {\n      const [settingsAtom] = get(settingsCapabilityAtom);\n      const settings = settingsAtom ? get(settingsAtom) : undefined;\n      return settings?.presentCollections\n        ? Obj.instanceOf(Collection.Collection, object) || Obj.instanceOf(Markdown.Document, object)\n        : Obj.instanceOf(Markdown.Document, object);\n    };\n\n    const extensions = yield* AppGraphBuilder.createExtension({\n      id: 'root',\n      relation: AppNode.companion,\n      // TODO(wittjosiah): This is a hack to work around presenter previously relying on \"variant\". Remove.\n      match: whenPresentable,\n      connector: (object, get) => {\n        if (!isPresentable(object, get)) {\n          return Effect.succeed([]);\n        }\n\n        return Effect.succeed([\n          AppNode.makeCompanion({\n            variant: 'presenter',\n            label: 'Presenter',\n            icon: 'ph--presentation--regular',\n            data: { type: meta.profile.key, object },\n          }),\n        ]);\n      },\n      actions: (object, get) => {\n        const db = Obj.getDatabase(object);\n        if (!isPresentable(object, get) || !db) {\n          return Effect.succeed([]);\n        }\n\n        return Effect.succeed([\n          {\n            id: PresenterOperation.SetPresenting.meta.key,\n            // The menu item flips, so it reads the current state and states the one it wants.\n            data: Effect.fnUntraced(function* () {\n              const ephemeral = yield* Capabilities.getAtomValue(DeckCapabilities.EphemeralState);\n              yield* Operation.invoke(PresenterOperation.SetPresenting, {\n                object,\n                state: !isPresenting(ephemeral, object),\n              });\n            }),\n            properties: {\n              label: ['toggle-presentation.label', { ns: meta.profile.key }],\n              icon: 'ph--presentation--regular',\n              disposition: 'list-item',\n              testId: 'presenter.present',\n              keyBinding: {\n                macos: 'shift+meta+p',\n                windows: 'shift+alt+p',\n              },\n            },\n          },\n        ]);\n      },\n    });\n\n    return Capability.contribute(AppCapabilities.AppGraphBuilder, extensions);\n  }),\n);\n"],"mappings":";;;;;;;;;;;;;;;;;AA0BA,IAAM,mBAAmB,MAAyB,QAChD,OAAO,OAAO,eAAe,aAAa,WAAW,UAAU,CAAC,CAAC,MAAM,GAAG,SACxE,eAAe,aAAa,SAAS,QAAQ,CAAC,CAAC,MAAM,GAAG,CAC1D;AAEF,IAAA,4BAAe,WAAW,WACxB,OAAO,WAAW,aAAa;CAG7B,MAAM,yBAAyB,OAAO,WAAW,KAAK,sBAAsB,QAAQ;CAEpF,MAAM,iBAAiB,QAAiB,QAA0B;EAChE,MAAM,CAAC,gBAAgB,IAAI,sBAAsB;EAEjD,QADiB,eAAe,IAAI,YAAY,IAAI,KAAA,EAAA,EACnC,qBACb,IAAI,WAAW,WAAW,YAAY,MAAM,KAAK,IAAI,WAAW,SAAS,UAAU,MAAM,IACzF,IAAI,WAAW,SAAS,UAAU,MAAM;CAC9C;CAEA,MAAM,aAAa,OAAO,gBAAgB,gBAAgB;EACxD,IAAI;EACJ,UAAU,QAAQ;EAElB,OAAO;EACP,YAAY,QAAQ,QAAQ;GAC1B,IAAI,CAAC,cAAc,QAAQ,GAAG,GAC5B,OAAO,OAAO,QAAQ,CAAC,CAAC;GAG1B,OAAO,OAAO,QAAQ,CACpB,QAAQ,cAAc;IACpB,SAAS;IACT,OAAO;IACP,MAAM;IACN,MAAM;KAAE,MAAM,KAAK,QAAQ;KAAK;IAAO;GACzC,CAAC,CACH,CAAC;EACH;EACA,UAAU,QAAQ,QAAQ;GACxB,MAAM,KAAK,IAAI,YAAY,MAAM;GACjC,IAAI,CAAC,cAAc,QAAQ,GAAG,KAAK,CAAC,IAClC,OAAO,OAAO,QAAQ,CAAC,CAAC;GAG1B,OAAO,OAAO,QAAQ,CACpB;IACE,IAAI,mBAAmB,cAAc,KAAK;IAE1C,MAAM,OAAO,WAAW,aAAa;KACnC,MAAM,YAAY,OAAO,aAAa,aAAa,iBAAiB,cAAc;KAClF,OAAO,UAAU,OAAO,mBAAmB,eAAe;MACxD;MACA,OAAO,CAAC,aAAa,WAAW,MAAM;KACxC,CAAC;IACH,CAAC;IACD,YAAY;KACV,OAAO,CAAC,6BAA6B,EAAE,IAAI,KAAK,QAAQ,IAAI,CAAC;KAC7D,MAAM;KACN,aAAa;KACb,QAAQ;KACR,YAAY;MACV,OAAO;MACP,SAAS;KACX;IACF;GACF,CACF,CAAC;EACH;CACF,CAAC;CAED,OAAO,WAAW,WAAW,gBAAgB,iBAAiB,UAAU;AAC1E,CAAC,CACH"}