@markdstage/markdstage 3.3.0 → 3.8.0

package/src/deck.mjs

@@ -21,10 +21,14 @@ export async function withDeckServer(options, run) {
     log: options.log,
   });
   const server = await startPresentationServer(session, {
+    application: options.application,
+    exporters: options.exporters,
+    initialSourceMode: options.initialSourceMode,
     token,
     onLog: options.log,
     editable: options.watch === true,
     presenter: options.presenter,
+    watcherFactory: options.watcherFactory,
   });
   try {
     return await run(session, server);

package/src/skills.mjs

@@ -82,7 +82,7 @@ what the MarkdStage canvas and MarkdStage Desktop render.
    \`markdstage validate slides.md --json\`. Review diagnostic codes, JSON Pointers,
    and completeness, fix independent issues together, and preserve the same
    validated content when presenting. Suggestions are never automatic repairs.
-5. Use \`markdstage preview slides.md --watch\` for live source-backed authoring.
+5. Use \`markdstage slides.md\` for live source-backed authoring.
    It reloads on save without losing the current slide and keeps the last valid
    deck while a save is incomplete.
 6. Check fixed 16:9 output with \`markdstage inspect slides.md --json\`. Use
@@ -96,11 +96,13 @@ what the MarkdStage canvas and MarkdStage Desktop render.
    \`markdstage export slides.md --output slides.pdf\`, or
    \`markdstage export slides.md --output slides.pptx\`.
 
-The browser in \`preview --watch\` starts in viewing mode. The user can activate
-the pencil control to move Architecture elements, then choose **Advanced edit**
-for the detailed designer. Placement changes save immediately, while the
-detailed designer saves only when the user selects **Save**. \`preview\` without
-\`--watch\` is read-only.
+The browser in \`markdstage slides.md\` starts in viewing mode on the fixed 16:9
+output surface. **Output preview** switches to the retained responsive layout.
+The user can activate the pencil control to switch to the responsive layout and
+move Architecture elements, then choose **Advanced edit** for the detailed
+designer. Placement changes save immediately, while the detailed designer saves
+only when the user selects **Save**. Automatic refresh can be toggled from the
+same UI without disabling Architecture editing.
 
 Never hand-write HTML or CSS for a slide. Fix layout problems by shortening the
 content or by changing the layout in front matter. Prefer structured validation
@@ -110,8 +112,10 @@ and layout diagnostics over capturing every slide.
 
 | Command | Purpose |
 | --- | --- |
-| \`markdstage present <file> [--watch]\` | Open presenter view with the current slide, next-slide preview, speaker notes, and controls for a synchronized audience window. |
-| \`markdstage preview <file> [--watch]\` | Serve the deck on loopback and open it in a browser window. \`--watch\` reloads on save, keeps the current slide, and enables Architecture placement and detailed editing. Without it, the source is read-only. |
+| \`markdstage\` | Open an empty Canvas-equivalent UI and choose Markdown from the workspace. |
+| \`markdstage <file>\` | Open the full UI in live slide view with automatic refresh, editing, presenting, and UI export. |
+| \`markdstage present <file> [--watch]\` | Open the same full UI in presenter view; \`--watch\` enables automatic refresh initially. |
+| \`markdstage preview <file> [--watch]\` | Open the same full UI in slide view; \`--watch\` enables automatic refresh initially. |
 | \`markdstage validate <file> [--json]\` | Check deck structure, Architecture DSL blocks, and themes. |
 | \`markdstage inspect <file> [--json]\` | Report 1280x720 clipping diagnostics for the deck or one slide; use \`--fail-on-issues\` for quality gates. |
 | \`markdstage capture <file> [--pages 2,4]\` | Write 1280x720 PNG files; without \`--pages\` only clipped slides are captured. |