@mx-space/cli 0.6.2 → 0.6.4

package/dist/bin/mxs.mjs

@@ -1,3 +1,3 @@
 #!/usr/bin/env node
-import { t as run } from "../mxs-BxXhmqqF.mjs";
+import { t as run } from "../mxs-BGjeCBcT.mjs";
 export { run };

package/dist/index.mjs

@@ -1,2 +1,2 @@
-import { a as defaultMessageFor, c as tagToCode, i as codeForTag, l as toErrorEnvelope, n as defaultGlobalFlags, o as exitCodeForError, r as parseGlobalFlags, s as exitCodeForTag, t as run } from "./mxs-BxXhmqqF.mjs";
+import { a as defaultMessageFor, c as tagToCode, i as codeForTag, l as toErrorEnvelope, n as defaultGlobalFlags, o as exitCodeForError, r as parseGlobalFlags, s as exitCodeForTag, t as run } from "./mxs-BGjeCBcT.mjs";
 export { codeForTag, defaultGlobalFlags, defaultMessageFor, exitCodeForError, exitCodeForTag, parseGlobalFlags, run, tagToCode, toErrorEnvelope };

package/dist/{mxs-BxXhmqqF.mjs → mxs-BGjeCBcT.mjs}

@@ -31768,6 +31768,10 @@ registerCommandHelp({
 		{
 			flag: "--print",
 			description: "emit HTML to stdout instead of opening a browser"
+		},
+		{
+			flag: "--open",
+			description: "explicitly open the rendered HTML in a browser (default behavior)"
 		}
 	]
 });
@@ -31780,6 +31784,7 @@ const variantOpt = choice("variant", [
 ]).pipe(optional$2);
 const saveOpt = text$1("save").pipe(optional$2);
 const printOpt = boolean("print").pipe(optional$2);
+const openOpt = boolean("open").pipe(optional$2);
 const requireFrom$3 = createRequire(import.meta.url);
 const resolveLitexmlBin = () => {
 	try {
@@ -31857,11 +31862,17 @@ const previewCmd = make$13("preview", {
 	theme: themeOpt,
 	variant: variantOpt,
 	save: saveOpt,
-	print: printOpt
-}, ({ file, theme, variant, save, print }) => gen(function* () {
+	print: printOpt,
+	open: openOpt
+}, ({ file, theme, variant, save, print, open: openFlag }) => gen(function* () {
 	const editor = yield* Editor;
 	const renderer = yield* Renderer;
 	const filePath = getOrUndefined(file);
+	const stdinIsTty = Boolean(process.stdin.isTTY);
+	if ((filePath === void 0 || filePath === "-" || filePath === "") && stdinIsTty) return yield* fail$2(new ValidationXml({
+		message: "mxs preview requires a file path or piped LiteXML on stdin",
+		hint: "pass `mxs preview <file>` or pipe content: `cat post.xml | mxs preview -`"
+	}));
 	const raw = yield* editor.readFileOrStdin(filePath);
 	let body;
 	let detectedVariant = "article";
@@ -31876,6 +31887,9 @@ const previewCmd = make$13("preview", {
 	const resolvedTheme = getOrUndefined(theme);
 	const savePath = getOrUndefined(save);
 	const printMode = getOrElse(print, () => false);
+	const explicitOpen = getOrElse(openFlag, () => false);
+	if (printMode && savePath) return yield* fail$2(new ValidationXml({ message: "--print and --save are mutually exclusive" }));
+	if (explicitOpen && (printMode || savePath)) return yield* fail$2(new ValidationXml({ message: "--open conflicts with --print / --save" }));
 	const args = [
 		"--format",
 		"html",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mx-space/cli",
-  "version": "0.6.2",
+  "version": "0.6.4",
   "description": "Command line interface for mx-space (mx-core) — auth, content, configuration",
   "keywords": [
     "mx-space",
@@ -54,7 +54,7 @@
     "@effect/platform-node": "0.106.0",
     "@haklex/rich-headless": "0.13.0",
     "@haklex/rich-litexml": "0.15.2",
-    "@haklex/rich-litexml-cli": "0.15.2",
+    "@haklex/rich-litexml-cli": "0.15.3",
     "@lexical/headless": "^0.44.0",
     "better-auth": "^1.6.9",
     "effect": "3.21.2",

package/skills/commands-preview.md

@@ -12,9 +12,12 @@ order: 39
 | Command                                  | Behavior                                                                    |
 | ---------------------------------------- | --------------------------------------------------------------------------- |
 | `mxs preview <file>`                     | Render the file and open the preview in a browser.                          |
+| `mxs preview <file> --open`              | Same as above, but explicit. Useful in scripts.                             |
 | `mxs preview -`                          | Read LiteXML or envelope from stdin and open the preview.                   |
-| `mxs preview <file> --print`             | Emit HTML to stdout instead of opening a browser.                           |
-| `mxs preview <file> --save <out.html>`   | Write HTML to `<out.html>` instead of opening a browser.                    |
+| `mxs preview --print <file>`             | Emit HTML to stdout instead of opening a browser.                           |
+| `mxs preview --save <out.html> <file>`   | Write HTML to `<out.html>` instead of opening a browser.                    |
+
+Flags must precede the positional `<file>` argument. `mxs preview <file> --print` is rejected by `@effect/cli` ("unknown argument") — write `mxs preview --print <file>` or `cat file | mxs preview --print -`.
 
 ## Flags
 
@@ -22,8 +25,9 @@ order: 39
 | ------------------------------------------ | ------------------------------------------------------------------------------------------------ |
 | `--theme <light\|dark>`                    | HTML theme. Default `light`.                                                                     |
 | `--variant <article\|note\|comment>`       | HTML variant. Auto-detected from the envelope root (`<mxpost>` → `article`, `<mxnote>` → `note`). |
-| `--save <path>`                            | Write HTML to a file instead of opening the browser. Mutually exclusive with `--print`.          |
-| `--print`                                  | Emit HTML to stdout. Mutually exclusive with `--save`.                                           |
+| `--save <path>`                            | Write HTML to a file instead of opening the browser. Mutually exclusive with `--print` / `--open`. |
+| `--print`                                  | Emit HTML to stdout. Mutually exclusive with `--save` / `--open`.                                |
+| `--open`                                   | Explicitly open the rendered HTML in a browser (default behavior; mutually exclusive with `--print` / `--save`). |
 
 ## Behavior notes