@slidev-react/node 0.1.0

package/dist/slides/parsing/parseSlides.mjs

@@ -0,0 +1,159 @@
+import { parseFrontmatter } from "./frontmatter.mjs";
+import { resolveSlidesViewportMeta } from "@slidev-react/core/slides/viewport";
+import { z } from "zod";
+import { transitionNames } from "@slidev-react/core/slides/transition";
+//#region src/slides/parsing/parseSlides.ts
+const layoutSchema = z.string().trim().min(1, "Layout name cannot be empty");
+const transitionSchema = z.enum(transitionNames);
+const addonsSchema = z.union([z.string(), z.array(z.string())]).optional().transform((value) => {
+	if (!value) return void 0;
+	const list = (Array.isArray(value) ? value : [value]).map((entry) => entry.trim()).filter((entry) => entry.length > 0);
+	return list.length > 0 ? [...new Set(list)] : void 0;
+});
+const notesSchema = z.string().transform((value) => value.trim()).optional().transform((value) => value && value.length > 0 ? value : void 0);
+const slidesMetaSchema = z.object({
+	title: z.string().optional(),
+	theme: z.string().optional(),
+	addons: addonsSchema,
+	layout: layoutSchema.optional(),
+	background: z.string().optional(),
+	transition: transitionSchema.optional(),
+	exportFilename: z.string().optional(),
+	ar: z.string().optional()
+});
+const slideMetaSchema = z.object({
+	title: z.string().optional(),
+	layout: layoutSchema.optional(),
+	class: z.string().optional(),
+	background: z.string().optional(),
+	transition: transitionSchema.optional(),
+	clicks: z.number().int().nonnegative().optional(),
+	notes: notesSchema,
+	src: z.string().optional()
+});
+const codeFenceStartRE = /^(`{3,}|~{3,})/;
+function isLikelyYamlMeta(lines) {
+	const candidate = lines.join("\n").trim();
+	if (!candidate) return false;
+	try {
+		const parsed = parseFrontmatter(`---\n${candidate}\n---`).data;
+		return parsed != null && typeof parsed === "object" && !Array.isArray(parsed);
+	} catch {
+		return false;
+	}
+}
+function findFrontmatterCloseLine(lines, start) {
+	for (let index = start + 1; index < lines.length; index += 1) if (lines[index].trim() === "---") return index;
+	return -1;
+}
+function splitSlides(content) {
+	const lines = content.split("\n");
+	const slides = [];
+	let current = [];
+	let atSlideStart = true;
+	let inCodeFence = false;
+	let codeFenceToken = null;
+	let inSlideFrontmatter = false;
+	const flush = () => {
+		const source = current.join("\n").trim();
+		if (source) slides.push(source);
+		current = [];
+		atSlideStart = true;
+		inCodeFence = false;
+		codeFenceToken = null;
+		inSlideFrontmatter = false;
+	};
+	for (let index = 0; index < lines.length; index += 1) {
+		const line = lines[index];
+		const trimmed = line.trim();
+		if (inSlideFrontmatter) {
+			current.push(line);
+			if (trimmed === "---") {
+				inSlideFrontmatter = false;
+				atSlideStart = false;
+			}
+			continue;
+		}
+		if (!inCodeFence) {
+			const match = trimmed.match(codeFenceStartRE);
+			if (match) {
+				inCodeFence = true;
+				codeFenceToken = match[1];
+			}
+		} else if (codeFenceToken && trimmed.startsWith(codeFenceToken)) {
+			inCodeFence = false;
+			codeFenceToken = null;
+		}
+		if (!inCodeFence) {
+			if (atSlideStart && trimmed === "---") {
+				inSlideFrontmatter = true;
+				current.push(line);
+				continue;
+			}
+			if (trimmed === "---") {
+				flush();
+				const closeLine = findFrontmatterCloseLine(lines, index);
+				if (closeLine > index + 1 && isLikelyYamlMeta(lines.slice(index + 1, closeLine))) {
+					inSlideFrontmatter = true;
+					current.push(line);
+				}
+				continue;
+			}
+		}
+		current.push(line);
+		if (trimmed !== "") atSlideStart = false;
+	}
+	flush();
+	return slides;
+}
+function createSlideUnits(slideSources) {
+	return slideSources.map((slide, index) => {
+		const slideMatter = parseFrontmatter(slide);
+		const slideMeta = parseSlideMeta(slideMatter.data, index);
+		const trimmedSource = slideMatter.content.trim();
+		return {
+			id: `slide-${index + 1}`,
+			index,
+			meta: slideMeta,
+			source: trimmedSource || "# Empty slide",
+			hasInlineSource: trimmedSource.length > 0
+		};
+	});
+}
+function parseSlidesMeta(data) {
+	const parsed = slidesMetaSchema.safeParse(data);
+	if (!parsed.success) throw new Error(`Invalid slides frontmatter: ${formatZodIssues(parsed.error)}`);
+	return {
+		...parsed.data,
+		...resolveSlidesViewportMeta(parsed.data.ar)
+	};
+}
+function formatZodIssues(error) {
+	return error.issues.map((issue) => {
+		return `${issue.path.length > 0 ? `${issue.path.join(".")}: ` : ""}${issue.message}`;
+	}).join("; ");
+}
+function parseSlideMeta(data, slideIndex) {
+	const parsed = slideMetaSchema.safeParse(data);
+	if (!parsed.success) {
+		const slideLabel = typeof slideIndex === "number" ? `slide ${slideIndex + 1}` : String(slideIndex);
+		throw new Error(`Invalid frontmatter in ${slideLabel}: ${formatZodIssues(parsed.error)}`);
+	}
+	return parsed.data;
+}
+function parseSlides(source) {
+	const slidesMatter = parseFrontmatter(source.replace(/\r\n/g, "\n").trim());
+	const meta = parseSlidesMeta(slidesMatter.data);
+	const rawSlides = splitSlides(slidesMatter.content);
+	return {
+		meta,
+		slides: createSlideUnits(rawSlides.length > 0 ? rawSlides : ["# Empty slides"])
+	};
+}
+function parseImportedSlides(source) {
+	const slideSources = splitSlides(source.replace(/\r\n/g, "\n").trim());
+	if (slideSources.length === 0) return createSlideUnits(["# Empty slide"]);
+	return createSlideUnits(slideSources);
+}
+//#endregion
+export { parseImportedSlides, parseSlides };

package/dist/slides/validation/validateSlidesAuthoring.mjs

@@ -0,0 +1,93 @@
+import path from "node:path";
+import { readFile, readdir } from "node:fs/promises";
+import { layoutNames } from "@slidev-react/core/slides/layout";
+//#region src/slides/validation/validateSlidesAuthoring.ts
+const CLIENT_THEME_THEMES_DIR = "packages/client/src/theme/themes";
+const CLIENT_ADDONS_DIR = "packages/client/src/addons";
+function collectKnownLayouts() {
+	return new Set(layoutNames);
+}
+function formatSlideLabel(slide) {
+	return slide.meta.title ? `slide ${slide.index + 1} (${slide.meta.title})` : `slide ${slide.index + 1}`;
+}
+async function readLocalIds(rootDir) {
+	try {
+		return (await readdir(rootDir, { withFileTypes: true })).filter((entry) => entry.isDirectory()).map((entry) => entry.name);
+	} catch {
+		return [];
+	}
+}
+async function findDefinitionFile(rootDir) {
+	for (const candidate of [
+		"index.ts",
+		"index.tsx",
+		"index.js",
+		"index.jsx"
+	]) {
+		const filePath = path.join(rootDir, candidate);
+		try {
+			await readFile(filePath, "utf8");
+			return filePath;
+		} catch {}
+	}
+	return null;
+}
+function extractObjectLiteralKeys(source, propertyName) {
+	const propertyIndex = source.indexOf(`${propertyName}:`);
+	if (propertyIndex === -1) return [];
+	const objectStart = source.indexOf("{", propertyIndex);
+	if (objectStart === -1) return [];
+	let depth = 0;
+	let objectEnd = -1;
+	for (let index = objectStart; index < source.length; index += 1) {
+		const char = source[index];
+		if (char === "{") depth += 1;
+		if (char === "}") depth -= 1;
+		if (depth === 0) {
+			objectEnd = index;
+			break;
+		}
+	}
+	if (objectEnd === -1) return [];
+	return [...source.slice(objectStart + 1, objectEnd).matchAll(/(?:^|\n|\s)(["']?[\w-]+["']?)\s*:/g)].map((match) => match[1]?.replace(/^["']|["']$/g, "")).filter((key) => Boolean(key));
+}
+async function readCustomLayoutIds(rootDir) {
+	const ids = await readLocalIds(rootDir);
+	const layouts = /* @__PURE__ */ new Set();
+	await Promise.all(ids.map(async (id) => {
+		const definitionFile = await findDefinitionFile(path.join(rootDir, id));
+		if (!definitionFile) return;
+		try {
+			const source = await readFile(definitionFile, "utf8");
+			for (const layoutName of extractObjectLiteralKeys(source, "layouts")) layouts.add(layoutName);
+		} catch {}
+	}));
+	return layouts;
+}
+async function validateSlidesAuthoring({ appRoot, slides }) {
+	const warnings = [];
+	const themeRootDir = path.join(appRoot, CLIENT_THEME_THEMES_DIR);
+	const addonsRootDir = path.join(appRoot, CLIENT_ADDONS_DIR);
+	const [themeIdList, addonIdList, themeLayouts, addonLayouts] = await Promise.all([
+		readLocalIds(themeRootDir),
+		readLocalIds(addonsRootDir),
+		readCustomLayoutIds(themeRootDir),
+		readCustomLayoutIds(addonsRootDir)
+	]);
+	const themeIds = new Set(themeIdList);
+	const addonIds = new Set(addonIdList);
+	const knownLayouts = collectKnownLayouts();
+	for (const layoutName of themeLayouts) knownLayouts.add(layoutName);
+	for (const layoutName of addonLayouts) knownLayouts.add(layoutName);
+	if (slides.meta.theme && !themeIds.has(slides.meta.theme)) warnings.push(`Unknown theme "${slides.meta.theme}". The runtime will fall back to the default theme.`);
+	for (const addonId of slides.meta.addons ?? []) if (!addonIds.has(addonId)) warnings.push(`Unknown addon "${addonId}". It will be ignored until a matching local addon exists.`);
+	if (slides.meta.layout && !knownLayouts.has(slides.meta.layout)) warnings.push(`Unknown slides layout "${slides.meta.layout}". The runtime will fall back to the default layout.`);
+	for (const slide of slides.slides) {
+		const slideLayout = slide.meta.layout;
+		if (!slideLayout || knownLayouts.has(slideLayout)) continue;
+		warnings.push(`Unknown layout "${slideLayout}" in ${formatSlideLabel(slide)}. The runtime will fall back to the default layout.`);
+	}
+	return warnings;
+}
+//#endregion
+export { validateSlidesAuthoring };

package/package.json

@@ -0,0 +1,57 @@
+{
+  "name": "@slidev-react/node",
+  "version": "0.1.0",
+  "private": false,
+  "description": "Node-side command APIs for slidev-react authoring and build workflows",
+  "license": "MIT",
+  "type": "module",
+  "types": "./dist/index.d.mts",
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.mts",
+      "import": "./dist/index.mjs"
+    },
+    "./slides/build/createSlidesViteConfig": {
+      "types": "./dist/slides/build/createSlidesViteConfig.d.mts",
+      "import": "./dist/slides/build/createSlidesViteConfig.mjs"
+    }
+  },
+  "dependencies": {
+    "@mdx-js/mdx": "3.1.1",
+    "@mdx-js/react": "3.1.1",
+    "@playwright/test": "^1.58.2",
+    "@vitejs/plugin-react": "^5.1.4",
+    "react": "19.2.3",
+    "rehype-katex": "7.0.1",
+    "remark-gfm": "4.0.1",
+    "remark-math": "6.0.0",
+    "shiki": "4.0.1",
+    "vite": "^7.3.1",
+    "yaml": "2.8.2",
+    "zod": "4.3.6",
+    "@slidev-react/core": "0.1.0"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+ssh://git@github.com/hylarucoder/slidev-react.git",
+    "directory": "packages/node"
+  },
+  "homepage": "https://github.com/hylarucoder/slidev-react/tree/main/packages/node",
+  "bugs": {
+    "url": "https://github.com/hylarucoder/slidev-react/issues"
+  },
+  "engines": {
+    "node": ">=22"
+  },
+  "scripts": {
+    "build:pkg": "pnpm exec tsdown",
+    "dev:pkg": "pnpm exec tsdown --watch"
+  }
+}