quackage 1.0.29 → 1.0.30

package/debug/Harness.js

@@ -3,7 +3,9 @@ console.log('Fancy debug harness here.  Shame if it would get quacked.');
 let libQuackage = require('../source/Quackage-CLIProgram.js');
 
 //libQuackage.run(['node', 'Harness.js', 'bp', 'pictunittest']);
-libQuackage.run(['node', 'Harness.js', 'lint']);
+//libQuackage.run(['node', 'Harness.js', 'lint']);
+
+//libQuackage.run(['node', 'Harness.js', 'gjv', 'html/', '-p', 'PictoView']);
 
 //libQuackage.run(['node', 'Harness.js', 'db', 'dist/documentation', '--meadow', 'model/MeadowModel-Extended.json']);
 //libQuackage.run(['node', 'Harness.js', 'db', 'dist/documentation', '--meadow', 'model/MeadowModel-Extended.json', '-d', 'documentation-definition.json']);

package/debug/html/About.html

@@ -0,0 +1,39 @@
+<div class="header">
+	<h1>About Grademaster</h1>
+	<h2>Where understanding and mastery are a weighed on a graduated scale.</h2>
+</div>
+<div class="content">
+	<p>Welcome to GradeMaster, your straightforward solution for managing and tracking student grades. Our web application is designed with simplicity and efficiency in mind, making it the perfect tool for teachers, students, and parents who want to stay informed and organized.</p>
+
+	<h3>Our Mission</h3>
+
+	<p>At GradeMaster, our mission is to streamline the grading process and provide an intuitive platform that fosters transparency and communication between educators, students, and parents. We believe that managing grades should be hassle-free, so you can focus on what truly matters: education.</p>
+
+	<h4>Key Features</h4>
+
+	<ul>
+		<li>Easy Grade Entry: Inputting grades is quick and straightforward, saving teachers valuable time.</li>
+		<li>Real-Time Updates: Students and parents can access up-to-date grades and performance summaries anytime, anywhere.</li>
+		<li>Customizable Reports: Generate detailed reports to monitor progress and identify areas for improvement.</li>
+		<li>Secure and Private: We prioritize your data privacy and security, ensuring that all information is protected.</li>
+	</ul>
+
+	<h3>Who Can Benefit?</h3>
+	<ul>
+		<li>Teachers: Simplify the grading process, save time, and maintain organized records.</li>
+		<li>Students: Stay informed about your academic performance and track your progress.</li>
+		<li>Parents: Keep up-to-date with your child's grades and support their educational journey.</li>
+	</ul>
+
+	<h3>Why Choose GradeMaster?</h3>
+	</ul>
+		<li>User-Friendly Interface: Our clean and intuitive design ensures that you can navigate the application with ease, regardless of your tech-savviness.</li>
+		<li>Reliable Performance: Built with robust technology, GradeMaster is reliable and fast, ensuring a seamless experience.</li>
+		<li>Dedicated Support: Our support team is here to help with any questions or issues you might encounter, ensuring you get the most out of GradeMaster.</li>
+	</ul>
+
+	<h3>Get Started</h3>
+	<p>Ready to simplify your grading process? Sign up today and discover how GradeMaster can make managing grades easier and more efficient than ever.</p>
+	<p>For more information, feel free to contact us or explore our FAQs.</p>
+	<p>Thank you for choosing GradeMaster – where simplicity meets efficiency in grade management.</p>
+</div>

package/debug/html/Legal.html

@@ -0,0 +1,34 @@
+<h1>Legal Stuff (The Fun Version)</h1>
+
+<p>Welcome to the GradeMaster Pro Legal Page! This is where we sprinkle a bit of humor on the otherwise dry and dusty legal stuff. Grab a cup of coffee, sit back, and enjoy our attempt to make legal jargon slightly less snooze-inducing.</p>
+
+<h2>Terms of Use</h2>
+<p>By using GradeMaster Pro, you agree to these terms. If you don’t agree, well, you probably shouldn’t be here. Seriously, we’ve put a lot of thought into this, so trust us, it’s worth agreeing to.</p>
+<ol>
+	<li><strong>Don’t Be Evil</strong>: Stealing grades, hacking into accounts, or impersonating a teacher’s pet is strictly prohibited. Play nice!</li>
+	<li><strong>No Robots Allowed</strong>: Unless you’re a cool, teaching robot from the future, no automated systems or scripts here, folks. We like our users human.</li>
+	<li><strong>Use Responsibly</strong>: GradeMaster Pro is here to make your life easier, not to be used as a tool to procrastinate from actual grading. Use it wisely!</li>
+</ol>
+
+<h2>Privacy Policy</h2>
+<p>We take your privacy very seriously. Like, top-secret, James Bond seriously. Here’s how we handle your info:</p>
+<ul>
+	<li><strong>Data Collection</strong>: We collect only what we need to make your experience awesome. No more, no less.</li>
+	<li><strong>Cookies</strong>: Yes, we use cookies. Not the chocolate chip kind (sadly), but the digital kind to keep things running smoothly.</li>
+	<li><strong>Sharing Information</strong>: We don’t sell your data to third parties. We wouldn’t even know how to price it. Your secrets are safe with us.</li>
+</ul>
+
+<h2>Limitation of Liability</h2>
+<p>Let’s keep this simple: if something goes wrong (like the internet breaking, your computer spontaneously combusting, or an alien invasion), GradeMaster Pro is not liable. We’re here to help, but some things are just out of our control.</p>
+<ol>
+	<li><strong>No Guarantees</strong>: We strive for perfection, but we’re not perfect. If things go awry, we’ll do our best to fix them. No guarantees, but plenty of effort.</li>
+	<li><strong>Damages</strong>: In the rare event that GradeMaster Pro causes you any damages (physical, emotional, or psychological), our liability is limited to making funny jokes and sending good vibes your way.</li>
+</ol>
+
+<h2>Changes to This Agreement</h2>
+<p>We might update these terms occasionally. When we do, we promise to give you a heads-up. No sneaky stuff. Check back here from time to time, or just trust that we’ll keep things reasonable.</p>
+
+<h2>Contact Us</h2>
+<p>Still awake? Impressive! If you have any questions, comments, or jokes to share, feel free to reach out to us at <a href="mailto:legal@grademasterpro.com">legal@grademasterpro.com</a>. We promise to respond faster than you can say “legal mumbo jumbo.”</p>
+
+<p>Thanks for choosing GradeMaster Pro! Remember, with great grading power comes great responsibility. Use it wisely and keep on grading like a pro!</p>

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "quackage",
-  "version": "1.0.29",
+  "version": "1.0.30",
   "description": "Building.  Testing.  Quacking.",
   "main": "source/Quackage.js",
   "scripts": {
@@ -54,19 +54,19 @@
     "@babel/preset-env": "^7.23.9",
     "browserify": "^17.0.0",
     "chai": "4.3.10",
-    "copy-files-from-to": "^3.9.1",
+    "copy-files-from-to": "^3.10.0",
     "devextreme-showdown": "^1.0.1",
     "gulp": "^4.0.2",
     "gulp-babel": "^8.0.0",
     "gulp-env": "^0.4.0",
     "gulp-sourcemaps": "^3.0.0",
     "gulp-terser": "^2.1.0",
-    "marked": "^12.0.2",
+    "marked": "^13.0.0",
     "marked-tex-renderer": "^1.1.1",
     "mocha": "10.4.0",
     "npm-check-updates": "^16.14.20",
     "nyc": "^15.1.0",
-    "pict-service-commandlineutility": "^1.0.11",
+    "pict-service-commandlineutility": "^1.0.13",
     "vinyl-buffer": "^1.0.1",
     "vinyl-source-stream": "^2.0.0"
   }

package/source/Quackage-CLIProgram.js

@@ -33,6 +33,7 @@ let _Pict = new libCLIProgram(
 
 		// Template handling
 		require('./commands/Quackage-Command-Boilerplate.js'),
+		require('./commands/Quackage-Command-BuildJSONViews.js'),
 		require('./commands/Quackage-Command-ListTemplates.js'),
 		require('./commands/Quackage-Command-BuildTemplates.js')
 	]);

package/source/commands/Quackage-Command-BuildJSONViews.js

@@ -0,0 +1,164 @@
+const libCommandLineCommand = require('pict-service-commandlineutility').ServiceCommandLineCommand;
+const libFS = require('fs');
+const libPath = require('path');
+
+class QuackageCommandBuildTemplates extends libCommandLineCommand
+{
+	constructor(pFable, pManifest, pServiceHash)
+	{
+		super(pFable, pManifest, pServiceHash);
+
+		this.options.CommandKeyword = 'generate_json_views';
+		this.options.Description = 'Generate pict ';
+
+		this.options.CommandArguments.push({ Name: '<folder>', Description: 'The folder path to build views in.' });
+
+		this.options.CommandOptions.push({ Name: '-p, --prefix [prefix]', Description: 'A "prefix" for the view set identifiers', Default: 'Default' });
+
+		this.options.Aliases.push('gjv');
+
+		this.viewSets = {};
+
+		this.addCommand();
+	}
+
+	/**
+	 * Generate a JSON-only pict view.
+	 * 
+	 * @param {string} pViewPrefix - The prefix for this set of files and views.
+	 * @param {*} pViewName - The name of the view.
+	 * @param {*} pViewContent - The HTML content of the view.
+	 */
+	generateView(pViewPrefix, pViewName, pViewContent)
+	{
+		let tmpViewNameClean = this.services.DataFormat.cleanNonAlphaCharacters(pViewName)
+		let tmpView = (
+			{
+				"ViewIdentifier": `${pViewPrefix}-${tmpViewNameClean}-View`,
+
+				"DefaultRenderable": `${pViewPrefix}-${tmpViewNameClean}-Renderable`,
+				"DefaultDestinationAddress": `#${pViewPrefix}-Content-Container`,
+
+				"AutoRender": false,
+
+				"Templates": [
+					{
+						"Hash": `${pViewPrefix}-${tmpViewNameClean}-Content-Template`,
+						"Template": pViewContent
+					}
+				],
+				"Renderables": [
+					{
+						"RenderableHash": `${pViewPrefix}-${tmpViewNameClean}-Renderable`,
+						"TemplateHash": `${pViewPrefix}-${tmpViewNameClean}-Content-Template`
+					}
+				]
+			});
+		return tmpView;
+	}
+
+	addView(pViewPrefix, pViewRootPath, pViewFilePath)
+	{
+		// Load the view file
+		let tmpViewFileContent = libFS.readFileSync(pViewFilePath, 'utf8');
+		let tmpViewFileName = libPath.basename(pViewFilePath);
+		let tmpViewName = this.fable.DataFormat.cleanNonAlphaCharacters(this.fable.DataFormat.capitalizeEachWord(tmpViewFileName));
+
+		// Generate a view json
+		let tmpViewJSON = this.generateView(pViewPrefix, tmpViewName, tmpViewFileContent);
+		tmpViewJSON.CommentOriginalFilePath = pViewFilePath;
+		tmpViewJSON.CommentOriginalRootPath = pViewRootPath;
+		// Right now the view JSON will have the file extension in it of the template file.  I kindof like this.
+		this.viewSets[tmpViewJSON.ViewIdentifier] = tmpViewJSON;
+	}
+
+	generateViewsRecursively(pViewPrefix, pRootPath, pPath, fCallback)
+	{
+		libFS.readdir(pPath,
+			(pError, pFiles) =>
+			{
+				this.fable.Utility.eachLimit(pFiles, 1,
+					(pFileName, fEnumerationComplete)=>
+					{
+						let tmpFilePath = libPath.join(pPath, pFileName);
+						let tmpStat = libFS.stat(tmpFilePath,
+							(pFileStatError, pFileStats) =>
+							{
+								if (pFileStatError)
+								{
+									return fEnumerationComplete('File stat error during enumeration:'+pEnumerationError);
+								}
+
+								if (pFileStats && pFileStats.isDirectory())
+								{
+									return this.generateViewsRecursively(pViewPrefix, pRootPath, tmpFilePath, fEnumerationComplete);
+								}
+								else
+								{
+									this.log.info(`Generating View JSON for ${pViewPrefix} from File [${pFileName}] in [${tmpFilePath}]`);
+									this.addView(pViewPrefix, pPath, tmpFilePath);
+									return fEnumerationComplete();
+								}
+							});
+					},
+					(pEnumerationError) =>
+					{
+						if (pEnumerationError)
+						{
+							return fCallback(`Error during recursive view JSON generation in folder [${pPath}]: ${pEnumerationError}`);
+						}
+						return fCallback();
+					});
+			});
+	}
+
+	generateViewsFromFolder(pViewPrefix, pPath, fCallback)
+	{
+		libFS.readdir(pPath,
+			(pError, pFiles) =>
+			{
+				this.fable.Utility.eachLimit(pFiles, 1,
+					(pFileName, fEnumerationComplete)=>
+					{
+						let tmpFilePath = libPath.join(pPath, pFileName);
+						let tmpStat = libFS.stat(tmpFilePath,
+							(pFileStatError, pFileStats) =>
+							{
+								if (pFileStatError)
+								{
+									return fCallback('File stat error during enumeration:'+pEnumerationError);
+								}
+
+								if (pFileStats && pFileStats.isDirectory())
+								{
+									this.generateViewsRecursively(pViewPrefix, pPath, tmpFilePath, fEnumerationComplete);
+								}
+								else
+								{
+									this.addView(pViewPrefix, pPath, tmpFilePath);
+									return fEnumerationComplete();
+								}
+							});
+					},
+					(pEnumerationError) =>
+					{
+						if (pEnumerationError)
+						{
+							return fCallback(`Error building configuration only pict views for ${pPath}: ${pEnumerationError}`, pEnumerationError);
+						}
+						libFS.writeFileSync(`${this.fable.AppData.CWD}/${pViewPrefix}-View-Templates.json`, (JSON.stringify(this.viewSets, null, 4)));
+						return fCallback();
+					});
+			});
+	}
+
+	onRunAsync(fCallback)
+	{
+		let tmpPath = this.ArgumentString;
+		let tmpViewPrefix = this.CommandOptions.prefix;
+		let tmpCWDFolderPath = libPath.resolve(`${this.fable.AppData.CWD}/${tmpPath}`);
+		return this.generateViewsFromFolder(tmpViewPrefix, tmpCWDFolderPath, fCallback);
+	};
+}
+
+module.exports = QuackageCommandBuildTemplates;