pict-docuserve 0.0.1 → 0.0.2

package/build-site.js

@@ -119,9 +119,15 @@ if (libFS.existsSync(tmpOutputPath))
 }
 ensureDir(tmpOutputPath);
 
-// 1. Copy the entire dist/ folder contents as the base
+// 1. Copy only the required dist/ artifacts (minified bundles, css, index.html)
 console.log('  Copying dist/ build artifacts...');
-copyDir(tmpDistPath, tmpOutputPath);
+copyFile(libPath.join(tmpDistPath, 'index.html'), libPath.join(tmpOutputPath, 'index.html'));
+copyDir(libPath.join(tmpDistPath, 'css'), libPath.join(tmpOutputPath, 'css'));
+ensureDir(libPath.join(tmpOutputPath, 'js'));
+copyFile(libPath.join(tmpDistPath, 'js', 'pict.min.js'), libPath.join(tmpOutputPath, 'js', 'pict.min.js'));
+copyFile(libPath.join(tmpDistPath, 'js', 'pict.min.js.map'), libPath.join(tmpOutputPath, 'js', 'pict.min.js.map'));
+copyFile(libPath.join(tmpDistPath, 'pict-docuserve.min.js'), libPath.join(tmpOutputPath, 'pict-docuserve.min.js'));
+copyFile(libPath.join(tmpDistPath, 'pict-docuserve.min.js.map'), libPath.join(tmpOutputPath, 'pict-docuserve.min.js.map'));
 
 // 2. Copy markdown content files from docs/
 console.log('  Copying documentation markdown files...');

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "pict-docuserve",
-	"version": "0.0.1",
+	"version": "0.0.2",
 	"description": "Pict Documentation Server - A single-page documentation viewer built on Pict",
 	"main": "source/Pict-Application-Docuserve.js",
 	"bin": {
@@ -45,7 +45,11 @@
 			"to": "./dist/css/"
 		},
 		{
-			"from": "./node_modules/pict/dist/*",
+			"from": "./node_modules/pict/dist/pict.min.js",
+			"to": "./dist/js/"
+		},
+		{
+			"from": "./node_modules/pict/dist/pict.min.js.map",
 			"to": "./dist/js/"
 		}
 	]

package/source/cli/commands/Docuserve-Command-Inject.js

@@ -57,14 +57,14 @@ class DocuserveCommandInject extends libCommandLineCommand
 		this.options.CommandKeyword = 'inject';
 		this.options.Description = 'Copy docuserve app assets into a docs folder for static hosting.';
 
-		this.options.CommandArguments.push({ Name: '<docs-path>', Description: 'Target documentation folder to inject assets into.' });
+		this.options.CommandArguments.push({ Name: '[docs-path]', Description: 'Target documentation folder to inject assets into (defaults to ./docs/).' });
 
 		this.addCommand();
 	}
 
 	onRun()
 	{
-		let tmpDocsPath = libPath.resolve(this.ArgumentString || '.');
+		let tmpDocsPath = libPath.resolve(this.ArgumentString || './docs/');
 		let tmpDistPath = libPath.resolve(__dirname, '..', '..', '..', 'dist');
 
 		if (!libFS.existsSync(tmpDocsPath))
@@ -72,6 +72,11 @@ class DocuserveCommandInject extends libCommandLineCommand
 			this.log.error(`Target folder not found at ${tmpDocsPath}`);
 			process.exit(1);
 		}
+
+		// Create .nojekyll for GitHub Pages compatibility (always, even if dist is missing)
+		libFS.writeFileSync(libPath.join(tmpDocsPath, '.nojekyll'), '');
+		this.log.info(`Created .nojekyll in ${tmpDocsPath}`);
+
 		if (!libFS.existsSync(tmpDistPath))
 		{
 			this.log.error(`dist/ folder not found at ${tmpDistPath}.  Run npm run build first.`);
@@ -94,28 +99,26 @@ class DocuserveCommandInject extends libCommandLineCommand
 			libPath.join(tmpDocsPath, 'css')
 		);
 
-		// Copy js/ folder (pict library)
-		copyDir(
-			libPath.join(tmpDistPath, 'js'),
-			libPath.join(tmpDocsPath, 'js')
+		// Copy minified pict library and source map
+		ensureDir(libPath.join(tmpDocsPath, 'js'));
+		copyFile(
+			libPath.join(tmpDistPath, 'js', 'pict.min.js'),
+			libPath.join(tmpDocsPath, 'js', 'pict.min.js')
+		);
+		copyFile(
+			libPath.join(tmpDistPath, 'js', 'pict.min.js.map'),
+			libPath.join(tmpDocsPath, 'js', 'pict.min.js.map')
 		);
 
-		// Copy all pict-docuserve bundle files (*.js and *.js.map)
-		let tmpDistEntries = libFS.readdirSync(tmpDistPath, { withFileTypes: true });
-		for (let i = 0; i < tmpDistEntries.length; i++)
-		{
-			let tmpEntry = tmpDistEntries[i];
-			if (tmpEntry.isFile() && tmpEntry.name.match(/^pict-docuserve\./))
-			{
-				copyFile(
-					libPath.join(tmpDistPath, tmpEntry.name),
-					libPath.join(tmpDocsPath, tmpEntry.name)
-				);
-			}
-		}
-
-		// Create .nojekyll for GitHub Pages compatibility
-		libFS.writeFileSync(libPath.join(tmpDocsPath, '.nojekyll'), '');
+		// Copy minified pict-docuserve bundle and source map
+		copyFile(
+			libPath.join(tmpDistPath, 'pict-docuserve.min.js'),
+			libPath.join(tmpDocsPath, 'pict-docuserve.min.js')
+		);
+		copyFile(
+			libPath.join(tmpDistPath, 'pict-docuserve.min.js.map'),
+			libPath.join(tmpDocsPath, 'pict-docuserve.min.js.map')
+		);
 
 		this.log.info('');
 		this.log.info('Injection complete!  The docs folder is now self-contained.');

package/source/cli/commands/Docuserve-Command-Serve.js

@@ -60,7 +60,7 @@ class DocuserveCommandServe extends libCommandLineCommand
 		this.options.CommandKeyword = 'serve';
 		this.options.Description = 'Start a local HTTP server for a documentation folder.';
 
-		this.options.CommandArguments.push({ Name: '<docs-path>', Description: 'Path to the documentation folder containing markdown files.' });
+		this.options.CommandArguments.push({ Name: '[docs-path]', Description: 'Path to the documentation folder containing markdown files (defaults to ./docs/).' });
 
 		this.options.CommandOptions.push({ Name: '-p, --port [port]', Description: 'Port to serve on.', Default: '3333' });
 
@@ -69,7 +69,7 @@ class DocuserveCommandServe extends libCommandLineCommand
 
 	onRun()
 	{
-		let tmpDocsPath = libPath.resolve(this.ArgumentString || '.');
+		let tmpDocsPath = libPath.resolve(this.ArgumentString || './docs/');
 		let tmpDistPath = libPath.resolve(__dirname, '..', '..', '..', 'dist');
 		let tmpPort = parseInt(this.CommandOptions.port, 10) || 3333;