hdoc-tools 0.53.0 → 0.54.0

package/hdoc-build.js

@@ -97,8 +97,12 @@
 
 	// Mutable references updated immediately before each md.render() call so
 	// the highlight and frontmatter plugin callbacks can identify the current
-	// file. Safe because md.render() is synchronous — nothing can interleave
-	// between setting these and reading them back within a single render.
+	// file. md.render() is synchronous, so these are safe to READ from within
+	// the render itself (e.g. the highlight callback reading currentMdFilePath).
+	// They are NOT safe to read back AFTER an await: transform_file runs up to 8
+	// concurrently, so a concurrent render can clobber these while we're awaiting.
+	// Anything needed past the first await must be snapshotted into a local first
+	// (see file_frontmatter in transform_file).
 	let currentMdFilePath = "";
 	let currentFrontmatter = "";
 
@@ -303,6 +307,16 @@
 			// Render markdown into HTML
 			html_txt = md.render(md_txt);
 
+			// Capture this file's frontmatter into a local NOW, before any await.
+			// currentFrontmatter is shared module-level state populated by the mdfm
+			// callback during the (synchronous) md.render() above. transform_file runs
+			// up to 8-at-a-time (see the chunked Promise.all in run()), so the await
+			// below yields the event loop and lets a concurrent transform_file reset
+			// and overwrite currentFrontmatter — if we read it back after the await we
+			// would parse another file's frontmatter. Snapshot it while it is still
+			// guaranteed to be ours.
+			const file_frontmatter = currentFrontmatter;
+
 			// md.render() synchronously queued any Mermaid diagrams in this file.
 			// Render them to SVG now (memoized/deduped) so the files exist before
 			// PDF generation below reads them, and before validation/zipping.
@@ -318,7 +332,7 @@
 			let fm_contains_reading_time = false;
 			let fm_contains_description = false;
 
-			const fm_content = currentFrontmatter.split(/\r?\n/);
+			const fm_content = file_frontmatter.split(/\r?\n/);
 			if (fm_content.length >= 0) {
 				for (fm_prop of fm_content) {
 					const fm_id = fm_prop.slice(0, fm_prop.indexOf(":"));

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "hdoc-tools",
-	"version": "0.53.0",
+	"version": "0.54.0",
 	"description": "Hornbill HDocBook Development Support Tool",
 	"main": "hdoc.js",
 	"bin": {