@markdstage/markdstage 2.6.0 → 3.1.0

package/src/cli.mjs

@@ -36,8 +36,8 @@ import {
 const PACKAGE_ROOT = resolve(dirname(fileURLToPath(import.meta.url)), "..");
 
 const COMMANDS = [
-  ["presentation", "Open presenter view and launch the audience view from it."],
-  ["present", "Serve a deck on loopback and open it in a browser window."],
+  ["present", "Open presenter view and launch the audience view from it."],
+  ["preview", "Serve a deck on loopback and open it in a browser window."],
   ["validate", "Check deck structure, Architecture DSL blocks, and themes."],
   ["inspect", "Report 1280x720 clipping diagnostics for a deck."],
   ["capture", "Write 1280x720 PNG files for selected or clipped slides."],
@@ -59,8 +59,8 @@ const GLOBAL_OPTIONS = {
 };
 
 const COMMAND_OPTIONS = {
-  presentation: { watch: { type: "boolean" }, "no-open": { type: "boolean" } },
   present: { watch: { type: "boolean" }, "no-open": { type: "boolean" } },
+  preview: { watch: { type: "boolean" }, "no-open": { type: "boolean" } },
   validate: {},
   inspect: { slide: { type: "string" }, all: { type: "boolean" }, "fail-on-issues": { type: "boolean" } },
   capture: { pages: { type: "string" }, output: { type: "string" } },
@@ -103,8 +103,8 @@ function usage(command) {
     return lines.join("\n");
   }
   const help = {
-    presentation: [
-      "Usage: markdstage presentation <file.md> [options]",
+    present: [
+      "Usage: markdstage present <file.md> [options]",
       "",
       "Opens presenter view with the current slide, next-slide preview, and speaker notes.",
       "Use Start presentation in that view to open the synchronized audience window.",
@@ -114,16 +114,16 @@ function usage(command) {
       "",
       "Presentation requires an installed Microsoft Edge, Google Chrome, or Chromium.",
     ],
-    present: [
-      "Usage: markdstage present <file.md> [options]",
+    preview: [
+      "Usage: markdstage preview <file.md> [options]",
       "",
       "  --watch     Reload on save and enable Architecture editing.",
       "  --no-open   Serve the deck without launching a browser.",
       "",
-      "Without --watch, presentation is read-only. Watch mode starts in normal viewing mode;",
+      "Without --watch, preview is read-only. Watch mode starts in normal viewing mode;",
       "use the pencil control to edit Architecture diagrams and open the detailed designer.",
       "",
-      "Presenting requires an installed Microsoft Edge, Google Chrome, or Chromium.",
+      "Preview requires an installed Microsoft Edge, Google Chrome, or Chromium.",
     ],
     validate: [
       "Usage: markdstage validate <file.md> [--json]",
@@ -262,8 +262,8 @@ export async function run(argv, io = {}) {
 
   try {
     switch (command) {
-      case "present": {
-        const file = requireFile(positionals, "present");
+      case "preview": {
+        const file = requireFile(positionals, "preview");
         const report = await presentCommand(
           { ...deckOptions(file, values), watch: values.watch, open: !values["no-open"], until: io.until },
           {
@@ -277,8 +277,8 @@ export async function run(argv, io = {}) {
         if (values.json) json(report);
         return EXIT_OK;
       }
-      case "presentation": {
-        const file = requireFile(positionals, "presentation");
+      case "present": {
+        const file = requireFile(positionals, "present");
         const report = await presentCommand(
           {
             ...deckOptions(file, values),

package/src/commands/present.mjs

@@ -1,4 +1,4 @@
-// markdstage present — serve the deck on loopback and open it in a browser.
+// Shared server for the markdstage preview and present commands.
 
 import { mkdtemp, readFile, rm } from "node:fs/promises";
 import { join, resolve } from "node:path";
@@ -139,7 +139,9 @@ export async function presentCommand(options, io) {
           });
         }
 
-        io.print(`MarkdStage is presenting ${session.sourceName || session.file}`);
+        io.print(
+          `MarkdStage is ${options.presenterView ? "presenting" : "previewing"} ${session.sourceName || session.file}`,
+        );
         io.print(`  slides:    ${session.slides.length}`);
         io.print(`  theme:     ${session.theme}`);
         io.print(`  workspace: ${resolve(session.workspaceRoot)}`);

package/src/skills.mjs

@@ -78,7 +78,7 @@ what the MarkdStage canvas and MarkdStage Desktop render.
    \`references/slide-format.md\`).
 4. Validate structure, themes, and Architecture DSL before visual review:
    \`markdstage validate slides.md --json\`.
-5. Use \`markdstage present slides.md --watch\` for live source-backed authoring.
+5. Use \`markdstage preview slides.md --watch\` 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
@@ -88,14 +88,14 @@ what the MarkdStage canvas and MarkdStage Desktop render.
    whose balance, spacing, or diagrams need visual judgment.
 8. Revise Markdown and repeat validation plus targeted inspection until the deck
    is valid, unclipped, concise, and visually balanced.
-9. Deliver from the same source with \`markdstage presentation slides.md\`,
+9. Deliver from the same source with \`markdstage present slides.md\`,
    \`markdstage export slides.md --output slides.pdf\`, or
    \`markdstage export slides.md --output slides.pptx\`.
 
-The browser in \`present --watch\` starts in viewing mode. The user can activate
+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**. \`present\` without
+detailed designer saves only when the user selects **Save**. \`preview\` without
 \`--watch\` is read-only.
 
 Never hand-write HTML or CSS for a slide. Fix layout problems by shortening the
@@ -106,8 +106,8 @@ and layout diagnostics over capturing every slide.
 
 | Command | Purpose |
 | --- | --- |
-| \`markdstage presentation <file> [--watch]\` | Open presenter view with the current slide, next-slide preview, speaker notes, and controls for a synchronized audience window. |
-| \`markdstage present <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 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 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. |