pict-section-content 0.0.2 → 0.0.4

package/CONTRIBUTING.md

@@ -0,0 +1,50 @@
+# Contributing to Retold
+
+We welcome contributions to Retold and its modules. This guide covers the expectations and process for contributing.
+
+## Code of Conduct
+
+The Retold community values **empathy**, **equity**, **kindness**, and **thoughtfulness**. We expect all participants to treat each other with respect, assume good intent, and engage constructively. These values apply to all interactions: pull requests, issues, discussions, and code review.
+
+## How to Contribute
+
+### Pull Requests
+
+Pull requests are the preferred method for contributing changes. To submit one:
+
+1. Fork the module repository you want to change
+2. Create a branch for your work
+3. Make your changes, following the code style of the module you are editing
+4. Ensure your changes have test coverage (see below)
+5. Open a pull request against the module's main branch
+
+**Submitting a pull request does not guarantee it will be accepted.** Maintainers review contributions for fit, quality, and alignment with the project's direction. A PR may be declined, or you may be asked to revise it. This is normal and not a reflection on the quality of your effort.
+
+### Reporting Issues
+
+If you find a bug or have a feature suggestion, open an issue on the relevant module's repository. Include enough detail to reproduce the problem or understand the proposal.
+
+## Test Coverage
+
+Every commit must include test coverage for the changes it introduces. Retold modules use Mocha in TDD style. Before submitting:
+
+- **Write tests** for any new functionality or bug fixes
+- **Run the existing test suite** with `npm test` and confirm all tests pass
+- **Check coverage** with `npm run coverage` if the module supports it
+
+Pull requests that break existing tests or lack coverage for new code will not be merged.
+
+## Code Style
+
+Follow the conventions of the module you are working in. The general Retold style is:
+
+- **Tabs** for indentation, never spaces
+- **Plain JavaScript** only (no TypeScript)
+- **Allman-style braces** (opening brace on its own line)
+- **Variable naming:** `pVariable` for parameters, `tmpVariable` for temporaries, `libSomething` for imports
+
+When in doubt, match what the surrounding code does.
+
+## Repository Structure
+
+Each module is its own git repository. The [retold](https://github.com/stevenvelozo/retold) repository tracks module organization but does not contain module source code. Direct your pull request to the specific module repository where your change belongs.

package/README.md

@@ -129,10 +129,16 @@ npm test
 npm run coverage
 ```
 
+## Related Packages
+
+- [pict](https://github.com/stevenvelozo/pict) - MVC application framework
+- [pict-view](https://github.com/stevenvelozo/pict-view) - View base class
+- [pict-provider](https://github.com/stevenvelozo/pict-provider) - Data provider base class
+
 ## License
 
-MIT - See [LICENSE](LICENSE) for details.
+MIT
 
-## Author
+## Contributing
 
-Steven Velozo - [steven@velozo.com](mailto:steven@velozo.com)
+Pull requests are welcome. For details on our code of conduct, contribution process, and testing requirements, see the [Retold Contributing Guide](https://github.com/stevenvelozo/retold/blob/main/docs/contributing.md).

package/docs/css/docuserve.css

@@ -0,0 +1,73 @@
+/* ============================================================================
+   Pict Docuserve - Base Styles
+   ============================================================================ */
+
+/* Reset and base */
+*, *::before, *::after {
+	box-sizing: border-box;
+}
+
+html, body {
+	margin: 0;
+	padding: 0;
+	font-family: -apple-system, BlinkMacSystemFont, "Segoe UI", Roboto, "Helvetica Neue", Arial, sans-serif;
+	font-size: 16px;
+	line-height: 1.5;
+	color: #423D37;
+	background-color: #fff;
+	-webkit-font-smoothing: antialiased;
+	-moz-osx-font-smoothing: grayscale;
+}
+
+/* Typography */
+h1, h2, h3, h4, h5, h6 {
+	margin-top: 0;
+	line-height: 1.3;
+}
+
+a {
+	color: #2E7D74;
+	text-decoration: none;
+}
+
+a:hover {
+	color: #256861;
+}
+
+/* Application container */
+#Docuserve-Application-Container {
+	min-height: 100vh;
+}
+
+/* Utility: scrollbar styling */
+::-webkit-scrollbar {
+	width: 8px;
+}
+
+::-webkit-scrollbar-track {
+	background: #F5F0E8;
+}
+
+::-webkit-scrollbar-thumb {
+	background: #D4CCBE;
+	border-radius: 4px;
+}
+
+::-webkit-scrollbar-thumb:hover {
+	background: #B5AA9A;
+}
+
+/* Responsive adjustments */
+@media (max-width: 768px) {
+	html {
+		font-size: 14px;
+	}
+
+	#Docuserve-Sidebar-Container {
+		display: none;
+	}
+
+	.docuserve-body {
+		flex-direction: column;
+	}
+}

package/docs/index.html

@@ -0,0 +1,39 @@
+<!doctype html>
+<html lang="en">
+	<head>
+		<meta charset="utf-8">
+		<meta http-equiv="X-UA-Compatible" content="IE=edge">
+		<meta name="viewport" content="width=device-width, initial-scale=1, shrink-to-fit=no">
+		<meta name="description" content="Documentation powered by pict-docuserve">
+
+		<title>Documentation</title>
+
+		<!-- Application Stylesheet -->
+		<link href="css/docuserve.css" rel="stylesheet">
+		<!-- KaTeX stylesheet for LaTeX equation rendering -->
+		<link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/katex@0.16.21/dist/katex.min.css">
+		<!-- PICT Dynamic View CSS Container -->
+		<style id="PICT-CSS"></style>
+
+		<!-- Load the PICT library from jsDelivr CDN -->
+		<script src="https://cdn.jsdelivr.net/npm/pict@1/dist/pict.min.js" type="text/javascript"></script>
+		<!-- Bootstrap the Application -->
+		<script type="text/javascript">
+//<![CDATA[
+		Pict.safeOnDocumentReady(() => { Pict.safeLoadPictApplication(PictDocuserve, 2)});
+//]]>
+		</script>
+	</head>
+	<body>
+		<!-- The root container for the Pict application -->
+		<div id="Docuserve-Application-Container"></div>
+
+		<!-- Mermaid diagram rendering -->
+		<script src="https://cdn.jsdelivr.net/npm/mermaid@11/dist/mermaid.min.js"></script>
+		<script>mermaid.initialize({ startOnLoad: false, theme: 'default' });</script>
+		<!-- KaTeX for LaTeX equation rendering -->
+		<script defer src="https://cdn.jsdelivr.net/npm/katex@0.16.21/dist/katex.min.js"></script>
+		<!-- Load the Docuserve PICT Application Bundle from jsDelivr CDN -->
+		<script src="https://cdn.jsdelivr.net/npm/pict-docuserve@0/dist/pict-docuserve.min.js" type="text/javascript"></script>
+	</body>
+</html>

package/docs/retold-catalog.json

@@ -0,0 +1,70 @@
+{
+	"Generated": "2026-02-18T05:42:00.270Z",
+	"GitHubOrg": "stevenvelozo",
+	"DefaultBranch": "master",
+	"Groups": [
+		{
+			"Name": "Dist",
+			"Key": "dist",
+			"Description": "",
+			"Modules": [
+				{
+					"Name": "indoctrinate_content_staging",
+					"Repo": "indoctrinate_content_staging",
+					"Group": "dist",
+					"Branch": "master",
+					"HasDocs": false,
+					"HasCover": false,
+					"Sidebar": [],
+					"DocFiles": []
+				}
+			]
+		},
+		{
+			"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",
+			"Description": "",
+			"Modules": [
+				{
+					"Name": "providers",
+					"Repo": "providers",
+					"Group": "source",
+					"Branch": "master",
+					"HasDocs": false,
+					"HasCover": false,
+					"Sidebar": [],
+					"DocFiles": []
+				},
+				{
+					"Name": "views",
+					"Repo": "views",
+					"Group": "source",
+					"Branch": "master",
+					"HasDocs": false,
+					"HasCover": false,
+					"Sidebar": [],
+					"DocFiles": []
+				}
+			]
+		}
+	]
+}

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.2",
+	"version": "0.0.4",
 	"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)
 		{

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',