@mx-space/cli 0.6.3 → 0.6.4

package/dist/bin/mxs.mjs

@@ -1,3 +1,3 @@
 #!/usr/bin/env node
-import { t as run } from "../mxs-Dj82UF06.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-Dj82UF06.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-Dj82UF06.mjs → mxs-BGjeCBcT.mjs}

@@ -24,7 +24,7 @@ import * as ChildProcess from "node:child_process";
 import childProcess, { execFile, spawn } from "node:child_process";
 import * as readline from "node:readline";
 import E from "node:readline";
-import V, { stdin, stdout } from "node:process";
+import process$1, { stdin, stdout } from "node:process";
 import "node:tty";
 //#region ../../node_modules/.pnpm/@effect+platform@0.96.1_effect@3.21.2/node_modules/@effect/platform/dist/esm/Error.js
 /**
@@ -9042,7 +9042,7 @@ function isInsideContainer() {
 //#endregion
 //#region ../../node_modules/.pnpm/is-wsl@3.1.1/node_modules/is-wsl/index.js
 const isWsl = () => {
-	if (V.platform !== "linux") return false;
+	if (process$1.platform !== "linux") return false;
 	if (os.release().toLowerCase().includes("microsoft")) {
 		if (isInsideContainer()) return false;
 		return true;
@@ -9053,11 +9053,11 @@ const isWsl = () => {
 	if (fs.existsSync("/proc/sys/fs/binfmt_misc/WSLInterop") || fs.existsSync("/run/WSL")) return !isInsideContainer();
 	return false;
 };
-var is_wsl_default = V.env.__IS_WSL_TEST__ ? isWsl : isWsl();
+var is_wsl_default = process$1.env.__IS_WSL_TEST__ ? isWsl : isWsl();
 //#endregion
 //#region ../../node_modules/.pnpm/powershell-utils@0.1.0/node_modules/powershell-utils/index.js
 const execFile$2 = promisify(childProcess.execFile);
-const powerShellPath$1 = () => `${V.env.SYSTEMROOT || V.env.windir || String.raw`C:\Windows`}\\System32\\WindowsPowerShell\\v1.0\\powershell.exe`;
+const powerShellPath$1 = () => `${process$1.env.SYSTEMROOT || process$1.env.windir || String.raw`C:\Windows`}\\System32\\WindowsPowerShell\\v1.0\\powershell.exe`;
 const executePowerShell = async (command, options = {}) => {
 	const { powerShellPath: psPath, ...execFileOptions } = options;
 	const encodedCommand = executePowerShell.encodeCommand(command);
@@ -9164,7 +9164,7 @@ function defineLazyProperty(object, propertyName, valueGetter) {
 //#region ../../node_modules/.pnpm/default-browser-id@5.0.1/node_modules/default-browser-id/index.js
 const execFileAsync$3 = promisify(execFile);
 async function defaultBrowserId() {
-	if (V.platform !== "darwin") throw new Error("macOS only");
+	if (process$1.platform !== "darwin") throw new Error("macOS only");
 	const { stdout } = await execFileAsync$3("defaults", [
 		"read",
 		"com.apple.LaunchServices/com.apple.launchservices.secure",
@@ -9178,7 +9178,7 @@ async function defaultBrowserId() {
 //#region ../../node_modules/.pnpm/run-applescript@7.1.0/node_modules/run-applescript/index.js
 const execFileAsync$2 = promisify(execFile);
 async function runAppleScript(script, { humanReadableOutput = true, signal } = {}) {
-	if (V.platform !== "darwin") throw new Error("macOS only");
+	if (process$1.platform !== "darwin") throw new Error("macOS only");
 	const outputArguments = humanReadableOutput ? [] : ["-ss"];
 	const execOptions = {};
 	if (signal) execOptions.signal = signal;
@@ -9289,14 +9289,14 @@ async function defaultBrowser$1(_execFileAsync = execFileAsync$1) {
 const execFileAsync = promisify(execFile);
 const titleize = (string) => string.toLowerCase().replaceAll(/(?:^|\s|-)\S/g, (x) => x.toUpperCase());
 async function defaultBrowser() {
-	if (V.platform === "darwin") {
+	if (process$1.platform === "darwin") {
 		const id = await defaultBrowserId();
 		return {
 			name: await bundleName(id),
 			id
 		};
 	}
-	if (V.platform === "linux") {
+	if (process$1.platform === "linux") {
 		const { stdout } = await execFileAsync("xdg-mime", [
 			"query",
 			"default",
@@ -9308,18 +9308,18 @@ async function defaultBrowser() {
 			id
 		};
 	}
-	if (V.platform === "win32") return defaultBrowser$1();
+	if (process$1.platform === "win32") return defaultBrowser$1();
 	throw new Error("Only macOS, Linux, and Windows are supported");
 }
 //#endregion
 //#region ../../node_modules/.pnpm/is-in-ssh@1.0.0/node_modules/is-in-ssh/index.js
-const isInSsh = Boolean(V.env.SSH_CONNECTION || V.env.SSH_CLIENT || V.env.SSH_TTY);
+const isInSsh = Boolean(process$1.env.SSH_CONNECTION || process$1.env.SSH_CLIENT || process$1.env.SSH_TTY);
 //#endregion
 //#region ../../node_modules/.pnpm/open@11.0.0/node_modules/open/index.js
 const fallbackAttemptSymbol = Symbol("fallbackAttempt");
 const __dirname = import.meta.url ? path.dirname(fileURLToPath(import.meta.url)) : "";
 const localXdgOpenPath = path.join(__dirname, "xdg-open");
-const { platform: platform$1, arch: arch$1 } = V;
+const { platform: platform$1, arch: arch$1 } = process$1;
 const tryEachApp = async (apps, opener) => {
 	if (apps.length === 0) return;
 	const errors = [];
@@ -9432,7 +9432,7 @@ const baseOpen = async (options) => {
 				await fs$1.access(localXdgOpenPath, constants.X_OK);
 				exeLocalXdgOpen = true;
 			} catch {}
-			command = V.versions.electron ?? (platform$1 === "android" || isBundled || !exeLocalXdgOpen) ? "xdg-open" : localXdgOpenPath;
+			command = process$1.versions.electron ?? (platform$1 === "android" || isBundled || !exeLocalXdgOpen) ? "xdg-open" : localXdgOpenPath;
 		}
 		if (appArguments.length > 0) cliArguments.push(...appArguments);
 		if (!options.wait) {
@@ -10889,7 +10889,7 @@ var ht$1 = class extends m {
 //#endregion
 //#region ../../node_modules/.pnpm/@clack+prompts@1.4.0/node_modules/@clack/prompts/dist/index.mjs
 function ee() {
-	return V.platform !== "win32" ? V.env.TERM !== "linux" : !!V.env.CI || !!V.env.WT_SESSION || !!V.env.TERMINUS_SUBLIME || V.env.ConEmuTask === "{cmd::Cmder}" || V.env.TERM_PROGRAM === "Terminus-Sublime" || V.env.TERM_PROGRAM === "vscode" || V.env.TERM === "xterm-256color" || V.env.TERM === "alacritty" || V.env.TERMINAL_EMULATOR === "JetBrains-JediTerm";
+	return process$1.platform !== "win32" ? process$1.env.TERM !== "linux" : !!process$1.env.CI || !!process$1.env.WT_SESSION || !!process$1.env.TERMINUS_SUBLIME || process$1.env.ConEmuTask === "{cmd::Cmder}" || process$1.env.TERM_PROGRAM === "Terminus-Sublime" || process$1.env.TERM_PROGRAM === "vscode" || process$1.env.TERM === "xterm-256color" || process$1.env.TERM === "alacritty" || process$1.env.TERMINAL_EMULATOR === "JetBrains-JediTerm";
 }
 const tt = ee(), w = (t, i) => tt ? t : i, Tt = w("◆", "*"), at = w("■", "x"), ut = w("▲", "x"), H = w("◇", "o");
 const $ = w("│", "|"), x = w("└", "—");
@@ -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.3",
+  "version": "0.6.4",
   "description": "Command line interface for mx-space (mx-core) — auth, content, configuration",
   "keywords": [
     "mx-space",

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