@soonit/rspress-plugin-og 0.1.0 → 0.1.2

package/dist/index.mjs

@@ -54,17 +54,74 @@ const baseImages = /* @__PURE__ */ new Map();
 function escapeHtml(unsafe) {
 	return unsafe.replace(/&/g, "&amp;").replace(/</g, "&lt;").replace(/>/g, "&gt;").replace(/"/g, "&quot;").replace(/'/g, "&#039;");
 }
+/**
+* Wrap a title string into at most three lines with a best-effort “do not break words” strategy.
+*
+* The input is first split by explicit newlines into paragraphs (empty lines are ignored). Then each
+* paragraph is wrapped into lines whose length does not exceed {@link maxSizePerLine} when possible:
+*
+* - If the paragraph contains whitespace, it is tokenized by whitespace and tokens are joined with a
+*   single space.
+* - If the paragraph contains no whitespace (e.g. CJK text), it is tokenized by individual characters.
+* - If a single token is longer than the line limit, it is hard-split into fixed-size chunks.
+*
+* Wrapping stops once three lines have been produced in total.
+*
+* @param input - The title text to wrap. `null`/`undefined`/empty (after trimming) results in `[]`.
+* @param maxSizePerLine - Maximum allowed character count per line. Values `<= 0` are treated as `1`.
+* @returns An array of wrapped lines, with a maximum length of 3.
+*/
+function wrapTitleToLines(input, maxSizePerLine) {
+	const text = (input ?? "").trim();
+	if (!text) return [];
+	const max = Math.max(1, maxSizePerLine || 1);
+	const paragraphs = text.split(/\r?\n+/).map((s) => s.trim()).filter(Boolean);
+	const out = [];
+	for (const para of paragraphs) {
+		if (out.length >= 3) break;
+		const tokens = /\s/.test(para) ? para.split(/\s+/).filter(Boolean) : [...para];
+		let line = "";
+		for (const token of tokens) {
+			if (out.length >= 3) break;
+			const next = line ? /\s/.test(para) ? `${line} ${token}` : `${line}${token}` : token;
+			if (next.length <= max) {
+				line = next;
+				continue;
+			}
+			if (line) {
+				out.push(line);
+				line = "";
+				if (out.length >= 3) break;
+			}
+			if (token.length > max) {
+				const chunks = token.match(new RegExp(`.{1,${max}}`, "g")) ?? [];
+				for (const chunk of chunks) {
+					if (out.length >= 3) break;
+					if (chunk.length === max) out.push(chunk);
+					else line = chunk;
+				}
+			} else line = token;
+		}
+		if (out.length >= 3) break;
+		if (line) out.push(line);
+	}
+	return out.slice(0, 3);
+}
 async function generateOgImage({ title }, output, options) {
 	if (existsSync(output)) return;
 	if (!templates.has(options.ogTemplate)) templates.set(options.ogTemplate, readFileSync(options.ogTemplate, "utf-8"));
 	const ogTemplate = templates.get(options.ogTemplate);
 	if (!baseImages.has(options.ogTemplate)) {
 		const baseSvg = ogTemplate.replace(/\{\{[^}]+\}\}/g, "").replace(/<text[^>]*>[\s\S]*?<\/text>/g, "");
-		const baseImageBuffer = await sharp(Buffer.from(baseSvg)).resize(1200, 630).png().toBuffer();
+		const baseImageBuffer = sharp(Buffer.from(baseSvg)).resize(1200, 630).png().toBuffer();
 		baseImages.set(options.ogTemplate, baseImageBuffer);
 	}
 	mkdirSync(dirname(output), { recursive: true });
-	const lines = title.trim().split(new RegExp(`(.{0,${options.maxTitleSizePerLine}})(?:\\s|$)`, "g")).filter(Boolean);
+	const lines = wrapTitleToLines(title, options.maxTitleSizePerLine);
+	if (lines.length === 0) {
+		console.warn("[plugin-og] Missing page title, skip og image generation.");
+		return;
+	}
 	const textLayerBuffer = new Resvg(createTextLayerSvg(ogTemplate, {
 		line1: lines[0] ? escapeHtml(lines[0]) : "",
 		line2: lines[1] ? escapeHtml(lines[1]) : "",
@@ -81,7 +138,7 @@ async function generateOgImage({ title }, output, options) {
 		dpi: 96,
 		...options.resvgOptions
 	}).render().asPng();
-	await sharp(baseImages.get(options.ogTemplate)).composite([{
+	await sharp(await baseImages.get(options.ogTemplate)).composite([{
 		input: textLayerBuffer,
 		blend: "over"
 	}]).png().toFile(output);
@@ -395,7 +452,8 @@ function src_default(userOptions) {
 				imageUrl: joinURL(options.domain, options.outDir, imageName)
 			});
 		},
-		async afterBuild(config) {
+		async afterBuild(config, isProd) {
+			if (!isProd) return;
 			const outputFolder = join(cwd(), config.outDir ?? "doc_build", options.outDir);
 			src_logger.info(`${LOG_PREFIX} Generating OG images to ${relative(cwd(), outputFolder)} ...`);
 			const start = performance.now();

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@soonit/rspress-plugin-og",
   "type": "module",
-  "version": "0.1.0",
+  "version": "0.1.2",
   "description": "Automatically generate Open Graph images for your Rspress pages.",
   "author": "Estéban Soubiran <esteban@soubiran.dev>",
   "license": "MIT",