pict-section-content 0.0.3 → 0.0.5

package/docs/retold-catalog.json

@@ -1,5 +1,5 @@
 {
-	"Generated": "2026-02-18T04:48:09.555Z",
+	"Generated": "2026-02-18T05:42:00.270Z",
 	"GitHubOrg": "stevenvelozo",
 	"DefaultBranch": "master",
 	"Groups": [
@@ -20,6 +20,25 @@
 				}
 			]
 		},
+		{
+			"Name": "Docs",
+			"Key": "docs",
+			"Description": "",
+			"Modules": [
+				{
+					"Name": "css",
+					"Repo": "css",
+					"Group": "docs",
+					"Branch": "master",
+					"HasDocs": true,
+					"HasCover": false,
+					"Sidebar": [],
+					"DocFiles": [
+						"css/docuserve.css"
+					]
+				}
+			]
+		},
 		{
 			"Name": "Source",
 			"Key": "source",

package/docs/retold-keyword-index.json

@@ -0,0 +1,19 @@
+{
+	"Generated": "2026-02-18T05:42:00.361Z",
+	"DocumentCount": 0,
+	"LunrIndex": {
+		"version": "2.3.9",
+		"fields": [
+			"title",
+			"module",
+			"group",
+			"body"
+		],
+		"fieldVectors": [],
+		"invertedIndex": [],
+		"pipeline": [
+			"stemmer"
+		]
+	},
+	"Documents": {}
+}

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "pict-section-content",
-	"version": "0.0.3",
+	"version": "0.0.5",
 	"description": "Pict content rendering section - markdown parsing, Mermaid diagrams, and KaTeX equations",
 	"main": "source/Pict-Section-Content.js",
 	"scripts": {
@@ -21,14 +21,14 @@
 	},
 	"homepage": "https://github.com/stevenvelozo/pict-section-content#readme",
 	"dependencies": {
-		"pict-provider": "^1.0.7",
-		"pict-view": "^1.0.64"
+		"pict-provider": "^1.0.10",
+		"pict-view": "^1.0.66"
 	},
 	"devDependencies": {
 		"chai": "^6.2.2",
 		"mocha": "^11.7.5",
-		"pict": "^1.0.343",
-		"quackage": "^1.0.47"
+		"pict": "^1.0.348",
+		"quackage": "^1.0.51"
 	},
 	"mocha": {
 		"diff": true,

package/source/providers/Pict-Provider-Content.js

@@ -46,6 +46,17 @@ class PictContentProvider extends libPictProvider
 		let tmpBlockquoteLines = [];
 		let tmpInMathBlock = false;
 		let tmpMathLines = [];
+		let tmpParagraphLines = [];
+
+		// Helper to flush accumulated paragraph lines into a single <p> tag
+		let fFlushParagraph = () =>
+		{
+			if (tmpParagraphLines.length > 0)
+			{
+				tmpHTML.push('<p>' + tmpParagraphLines.map((pLine) => { return this.parseInline(pLine, pLinkResolver); }).join(' ') + '</p>');
+				tmpParagraphLines = [];
+			}
+		};
 
 		for (let i = 0; i < tmpLines.length; i++)
 		{
@@ -63,6 +74,8 @@ class PictContentProvider extends libPictProvider
 				}
 				else
 				{
+					// Flush any pending paragraph
+					fFlushParagraph();
 					// Close any open list or blockquote
 					if (tmpInList)
 					{
@@ -122,6 +135,8 @@ class PictContentProvider extends libPictProvider
 				}
 				else
 				{
+					// Flush any pending paragraph
+					fFlushParagraph();
 					// Close any open list or blockquote
 					if (tmpInList)
 					{
@@ -153,6 +168,8 @@ class PictContentProvider extends libPictProvider
 			{
 				if (!tmpInBlockquote)
 				{
+					// Flush any pending paragraph
+					fFlushParagraph();
 					// Close any open list
 					if (tmpInList)
 					{
@@ -175,6 +192,7 @@ class PictContentProvider extends libPictProvider
 			// Horizontal rule
 			if (tmpLine.match(/^(-{3,}|\*{3,}|_{3,})\s*$/))
 			{
+				fFlushParagraph();
 				if (tmpInList)
 				{
 					tmpHTML.push(tmpListType === 'ul' ? '</ul>' : '</ol>');
@@ -188,6 +206,7 @@ class PictContentProvider extends libPictProvider
 			let tmpHeadingMatch = tmpLine.match(/^(#{1,6})\s+(.+)/);
 			if (tmpHeadingMatch)
 			{
+				fFlushParagraph();
 				if (tmpInList)
 				{
 					tmpHTML.push(tmpListType === 'ul' ? '</ul>' : '</ol>');
@@ -204,6 +223,7 @@ class PictContentProvider extends libPictProvider
 			let tmpULMatch = tmpLine.match(/^(\s*)[-*+]\s+(.*)/);
 			if (tmpULMatch)
 			{
+				fFlushParagraph();
 				if (!tmpInList || tmpListType !== 'ul')
 				{
 					if (tmpInList)
@@ -222,6 +242,7 @@ class PictContentProvider extends libPictProvider
 			let tmpOLMatch = tmpLine.match(/^(\s*)\d+\.\s+(.*)/);
 			if (tmpOLMatch)
 			{
+				fFlushParagraph();
 				if (!tmpInList || tmpListType !== 'ol')
 				{
 					if (tmpInList)
@@ -243,15 +264,17 @@ class PictContentProvider extends libPictProvider
 				tmpInList = false;
 			}
 
-			// Empty line
+			// Empty line — flush any accumulated paragraph
 			if (tmpLine.trim() === '')
 			{
+				fFlushParagraph();
 				continue;
 			}
 
 			// Table detection
 			if (tmpLine.match(/^\|/) && i + 1 < tmpLines.length && tmpLines[i + 1].match(/^\|[\s-:|]+\|/))
 			{
+				fFlushParagraph();
 				// Close any open list
 				if (tmpInList)
 				{
@@ -291,10 +314,14 @@ class PictContentProvider extends libPictProvider
 				continue;
 			}
 
-			// Regular paragraph
-			tmpHTML.push('<p>' + this.parseInline(tmpLine, pLinkResolver) + '</p>');
+			// Accumulate paragraph lines — consecutive non-blank text lines
+			// will be joined into a single <p> tag when flushed
+			tmpParagraphLines.push(tmpLine);
 		}
 
+		// Flush any remaining accumulated paragraph
+		fFlushParagraph();
+
 		// Close any trailing open elements
 		if (tmpInList)
 		{
@@ -328,8 +355,14 @@ class PictContentProvider extends libPictProvider
 
 		let tmpResult = pText;
 
-		// Inline code (backticks) - handle first to avoid interfering with other patterns
-		tmpResult = tmpResult.replace(/`([^`]+)`/g, '<code>$1</code>');
+		// Extract inline code spans into placeholders so bold/italic regexes don't mangle their contents
+		let tmpCodeSpans = [];
+		tmpResult = tmpResult.replace(/`([^`]+)`/g, (pMatch, pCode) =>
+		{
+			let tmpIndex = tmpCodeSpans.length;
+			tmpCodeSpans.push('<code>' + pCode + '</code>');
+			return '\x00CODEINLINE' + tmpIndex + '\x00';
+		});
 
 		// Inline LaTeX equations ($...$) — must be processed before other inline patterns
 		// Match single $ delimiters that aren't adjacent to spaces (to avoid false positives with currency)
@@ -369,6 +402,12 @@ class PictContentProvider extends libPictProvider
 		tmpResult = tmpResult.replace(/\*([^*]+)\*/g, '<em>$1</em>');
 		tmpResult = tmpResult.replace(/_([^_]+)_/g, '<em>$1</em>');
 
+		// Restore inline code spans from placeholders
+		tmpResult = tmpResult.replace(/\x00CODEINLINE(\d+)\x00/g, (pMatch, pIndex) =>
+		{
+			return tmpCodeSpans[parseInt(pIndex)];
+		});
+
 		return tmpResult;
 	}
 

package/test/Pict-Section-Content_tests.js

@@ -255,6 +255,146 @@ suite
 			}
 		);
 
+		suite
+		(
+			'Multi-line Paragraph Handling',
+			function()
+			{
+				test
+				(
+					'parseMarkdown should join consecutive lines into a single paragraph.',
+					(fDone) =>
+					{
+						var tmpProvider = createProvider();
+						var tmpResult = tmpProvider.parseMarkdown('This is the first line\nof a single paragraph\nthat spans three lines.');
+						// All three lines should be in one <p> tag
+						Expect(tmpResult).to.contain('<p>This is the first line of a single paragraph that spans three lines.</p>');
+						fDone();
+					}
+				);
+				test
+				(
+					'parseMarkdown should separate paragraphs on blank lines.',
+					(fDone) =>
+					{
+						var tmpProvider = createProvider();
+						var tmpResult = tmpProvider.parseMarkdown('First paragraph line one\nfirst paragraph line two.\n\nSecond paragraph line one\nsecond paragraph line two.');
+						Expect(tmpResult).to.contain('<p>First paragraph line one first paragraph line two.</p>');
+						Expect(tmpResult).to.contain('<p>Second paragraph line one second paragraph line two.</p>');
+						// Should produce exactly two <p> tags
+						var tmpParagraphCount = (tmpResult.match(/<p>/g) || []).length;
+						Expect(tmpParagraphCount).to.equal(2);
+						fDone();
+					}
+				);
+				test
+				(
+					'parseMarkdown should flush paragraph before a heading.',
+					(fDone) =>
+					{
+						var tmpProvider = createProvider();
+						var tmpResult = tmpProvider.parseMarkdown('Some introductory text\nthat spans two lines.\n## A Heading');
+						Expect(tmpResult).to.contain('<p>Some introductory text that spans two lines.</p>');
+						Expect(tmpResult).to.contain('<h2');
+						Expect(tmpResult).to.contain('A Heading');
+						fDone();
+					}
+				);
+				test
+				(
+					'parseMarkdown should flush paragraph before a list.',
+					(fDone) =>
+					{
+						var tmpProvider = createProvider();
+						var tmpResult = tmpProvider.parseMarkdown('Here is a paragraph\nbefore a list.\n- Item 1\n- Item 2');
+						Expect(tmpResult).to.contain('<p>Here is a paragraph before a list.</p>');
+						Expect(tmpResult).to.contain('<ul>');
+						Expect(tmpResult).to.contain('<li>Item 1</li>');
+						fDone();
+					}
+				);
+				test
+				(
+					'parseMarkdown should flush paragraph before a code block.',
+					(fDone) =>
+					{
+						var tmpProvider = createProvider();
+						var tmpResult = tmpProvider.parseMarkdown('Some text before code\nstill the same paragraph.\n```\ncode here\n```');
+						Expect(tmpResult).to.contain('<p>Some text before code still the same paragraph.</p>');
+						Expect(tmpResult).to.contain('<pre>');
+						Expect(tmpResult).to.contain('code here');
+						fDone();
+					}
+				);
+				test
+				(
+					'parseMarkdown should flush paragraph before a blockquote.',
+					(fDone) =>
+					{
+						var tmpProvider = createProvider();
+						var tmpResult = tmpProvider.parseMarkdown('A multi-line\nparagraph here.\n> A blockquote');
+						Expect(tmpResult).to.contain('<p>A multi-line paragraph here.</p>');
+						Expect(tmpResult).to.contain('<blockquote>');
+						Expect(tmpResult).to.contain('A blockquote');
+						fDone();
+					}
+				);
+				test
+				(
+					'parseMarkdown should handle a paragraph after a code block.',
+					(fDone) =>
+					{
+						var tmpProvider = createProvider();
+						var tmpResult = tmpProvider.parseMarkdown('```\ncode\n```\nA paragraph that\nfollows the code block.');
+						Expect(tmpResult).to.contain('<pre>');
+						Expect(tmpResult).to.contain('<p>A paragraph that follows the code block.</p>');
+						fDone();
+					}
+				);
+				test
+				(
+					'parseMarkdown should handle inline formatting within multi-line paragraphs.',
+					(fDone) =>
+					{
+						var tmpProvider = createProvider();
+						var tmpResult = tmpProvider.parseMarkdown('This paragraph has **bold** on the first line\nand *italic* on the second line.');
+						Expect(tmpResult).to.contain('<strong>bold</strong>');
+						Expect(tmpResult).to.contain('<em>italic</em>');
+						// Should be a single paragraph
+						var tmpParagraphCount = (tmpResult.match(/<p>/g) || []).length;
+						Expect(tmpParagraphCount).to.equal(1);
+						fDone();
+					}
+				);
+				test
+				(
+					'parseMarkdown should handle hand-wrapped README-style paragraphs.',
+					(fDone) =>
+					{
+						var tmpProvider = createProvider();
+						var tmpInput = 'Ultravisor is a process supervisor and service\n'
+							+ 'orchestrator built on the Fable ecosystem.\n'
+							+ 'It manages the lifecycle of multiple child\n'
+							+ 'processes from a single configuration.\n'
+							+ '\n'
+							+ 'Designed for development and production\n'
+							+ 'environments alike, it provides log\n'
+							+ 'aggregation and automatic restarts.';
+						var tmpResult = tmpProvider.parseMarkdown(tmpInput);
+						var tmpParagraphCount = (tmpResult.match(/<p>/g) || []).length;
+						Expect(tmpParagraphCount).to.equal(2, 'Should produce exactly two paragraphs.');
+						// First paragraph should contain all four lines joined
+						Expect(tmpResult).to.contain('Ultravisor is a process supervisor and service');
+						Expect(tmpResult).to.contain('orchestrator built on the Fable ecosystem.');
+						// Second paragraph should contain all three lines joined
+						Expect(tmpResult).to.contain('Designed for development and production');
+						Expect(tmpResult).to.contain('aggregation and automatic restarts.');
+						fDone();
+					}
+				);
+			}
+		);
+
 		suite
 		(
 			'Inline Markdown Parsing',