@slidev-react/cli 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 slidev-react contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,30 @@
+# `@slidev-react/cli`
+
+`@slidev-react/cli` 提供 `slidev-react` 命令行入口。
+
+当前已经完成两层收口：
+
+- 用户入口统一成 `slidev-react`
+- 命令实现收口到 `@slidev-react/node`
+
+当前命令：
+
+- `slidev-react dev [file]`
+- `slidev-react build [file]`
+- `slidev-react export [file]`
+- `slidev-react lint [file]`
+
+其中：
+
+- `dev` / `build` 走程序化 Vite API
+- `export` 会按需拉起临时 dev server 后再走 Playwright 导出
+- `lint` 直接调用 slides parsing + authoring validation
+
+在当前仓库内做 dogfood 时，可以这样用：
+
+```bash
+pnpm slidev-react -- dev
+pnpm slidev-react -- build slides-ar-3-4.mdx
+pnpm slidev-react -- export slides-ar-3-4.mdx --format png
+pnpm slidev-react -- lint slides.mdx --strict
+```

package/dist/bin/slidev-react.mjs

@@ -0,0 +1,89 @@
+#!/usr/bin/env node
+import { Command, CommanderError } from "@commander-js/extra-typings";
+import { runSlidesBuild, runSlidesDev, runSlidesExport, runSlidesLint } from "@slidev-react/node";
+//#region bin/slidev-react.ts
+const HELP_TEXT = `
+Supported dev options:
+  --host, --port, --open, --strictPort, --base, --mode
+
+Supported build options:
+  --outDir, --base, --mode, --emptyOutDir, --minify, --sourcemap
+
+Examples:
+  slidev-react dev
+  slidev-react dev slides-ar-3-4.mdx --host 0.0.0.0 --port 5174
+  slidev-react build slides-ar-3-4.mdx
+  slidev-react export slides-ar-3-4.mdx --format png --slides 3-7
+  slidev-react lint slides-ar-3-4.mdx --strict
+`;
+function fail(message) {
+	console.error(`[slidev-react] ${message}`);
+	process.exit(1);
+}
+function parseCommandArgs(argv) {
+	const args = [...argv];
+	let slidesFile;
+	if (args[0] && !args[0].startsWith("-")) slidesFile = args.shift();
+	for (let index = 0; index < args.length; index += 1) {
+		const entry = args[index];
+		if (entry === "--file" && args[index + 1]) {
+			slidesFile = args[index + 1];
+			args.splice(index, 2);
+			index -= 1;
+			continue;
+		}
+		if (entry.startsWith("--file=")) {
+			slidesFile = entry.slice(7);
+			args.splice(index, 1);
+			index -= 1;
+		}
+	}
+	return {
+		slidesFile,
+		forwardedArgs: args
+	};
+}
+function exitWithCommandResult(result) {
+	if (result.signal) {
+		process.kill(process.pid, result.signal);
+		return;
+	}
+	process.exit(result.code);
+}
+async function runWithViteArgs(argv, runner) {
+	const { slidesFile, forwardedArgs } = parseCommandArgs(argv);
+	exitWithCommandResult(await runner({
+		appRoot: process.cwd(),
+		slidesFile,
+		viteArgs: forwardedArgs
+	}));
+}
+async function runWithCliArgs(argv, runner) {
+	const { slidesFile, forwardedArgs } = parseCommandArgs(argv);
+	exitWithCommandResult(await runner({
+		appRoot: process.cwd(),
+		slidesFile,
+		cliArgs: forwardedArgs
+	}));
+}
+function createPassThroughCommand(program, name, description, runner) {
+	program.command(name).description(description).argument("[file]").allowUnknownOption(true).allowExcessArguments(true).action(async (_file, _options, command) => {
+		await runner(command.args);
+	});
+}
+const program = new Command().name("slidev-react").description("CLI entrypoint for slidev-react authoring and build workflows").usage("<command> [file] [options...]").showHelpAfterError().showSuggestionAfterError().addHelpText("after", HELP_TEXT).exitOverride();
+createPassThroughCommand(program, "dev", "Start the Vite dev server for a slides source file", (argv) => runWithViteArgs(argv, runSlidesDev));
+createPassThroughCommand(program, "build", "Build the current slides app for production", (argv) => runWithViteArgs(argv, runSlidesBuild));
+createPassThroughCommand(program, "export", "Export PDF / PNG artifacts through Playwright", (argv) => runWithCliArgs(argv, runSlidesExport));
+createPassThroughCommand(program, "lint", "Validate slides authoring warnings", (argv) => runWithCliArgs(argv, runSlidesLint));
+try {
+	await program.parseAsync(process.argv);
+} catch (error) {
+	if (error instanceof CommanderError) {
+		if (error.code === "commander.helpDisplayed") process.exit(0);
+		process.exit(error.exitCode);
+	}
+	fail(error instanceof Error ? error.message : String(error));
+}
+//#endregion
+export {};

package/package.json

@@ -0,0 +1,39 @@
+{
+  "name": "@slidev-react/cli",
+  "version": "0.1.0",
+  "private": false,
+  "description": "CLI entrypoint for slidev-react authoring and build workflows",
+  "license": "MIT",
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "bin": {
+    "slidev-react": "./dist/bin/slidev-react.mjs"
+  },
+  "type": "module",
+  "dependencies": {
+    "@commander-js/extra-typings": "^14.0.0",
+    "commander": "^14.0.3",
+    "@slidev-react/node": "0.1.0"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+ssh://git@github.com/hylarucoder/slidev-react.git",
+    "directory": "packages/cli"
+  },
+  "homepage": "https://github.com/hylarucoder/slidev-react/tree/main/packages/cli",
+  "bugs": {
+    "url": "https://github.com/hylarucoder/slidev-react/issues"
+  },
+  "engines": {
+    "node": ">=22"
+  },
+  "scripts": {
+    "build:pkg": "pnpm exec tsdown",
+    "dev:pkg": "pnpm exec tsdown --watch"
+  }
+}