jsgui3-server 0.0.143 → 0.0.145

package/server.js

@@ -45,9 +45,12 @@ class JSGUI_Single_Process_Server extends Evented_Class {
 		};
 
 
-		if (spec.debug !== undefined) {
-			this.debug = spec.debug;
-		}
+		if (spec.debug !== undefined) {
+			this.debug = spec.debug;
+		}
+
+		const style_config = spec.style;
+		const bundler_config = spec.bundler;
 
 		// or src_path_client_js as well...
 
@@ -91,16 +94,18 @@ class JSGUI_Single_Process_Server extends Evented_Class {
 
 			const wp_app = new Webpage({content: Ctrl});
 
-			const opts_wp_publisher = {
-				'webpage': wp_app
-
-			};
+			const opts_wp_publisher = {
+				'webpage': wp_app
+
+			};
+			if (bundler_config !== undefined) opts_wp_publisher.bundler = bundler_config;
+
+			if (this.debug) {
+				opts_wp_publisher.debug = this.debug;
+			}
 
-			if (this.debug) {
-				opts_wp_publisher.debug = this.debug;
-			}
-
-			if (disk_path_client_js) opts_wp_publisher.src_path_client_js = disk_path_client_js;
+			if (disk_path_client_js) opts_wp_publisher.src_path_client_js = disk_path_client_js;
+			if (style_config !== undefined) opts_wp_publisher.style = style_config;
 
 
 
@@ -160,12 +165,18 @@ class JSGUI_Single_Process_Server extends Evented_Class {
 			const ws_app = this.app = this.website = new Website(opts_website);
 			// Be able to treat Webpage as an app?
 
-			const opts_ws_publisher = {
-				'website': ws_app
-			};
-			if (disk_path_client_js) {
-				opts_ws_publisher.disk_path_client_js = disk_path_client_js;
-			}
+			const opts_ws_publisher = {
+				'website': ws_app
+			};
+			if (disk_path_client_js) {
+				opts_ws_publisher.disk_path_client_js = disk_path_client_js;
+			}
+			if (bundler_config !== undefined) {
+				opts_ws_publisher.bundler = bundler_config;
+			}
+			if (style_config !== undefined) {
+				opts_ws_publisher.style = style_config;
+			}
 			const ws_publisher = new HTTP_Website_Publisher(opts_ws_publisher);
 			this._ws_publisher = ws_publisher;
 			ws_publisher.on('ready', () => {
@@ -234,16 +245,33 @@ class JSGUI_Single_Process_Server extends Evented_Class {
 						if (this.allowed_addresses && this.allowed_addresses.length) {
 							arr_ipv4_addresses = arr_ipv4_addresses.filter(a => this.allowed_addresses.indexOf(a) > -1);
 						}
-						arr_ipv4_addresses = [...new Set(arr_ipv4_addresses)];
-						console.log('IPv4 addresses to bind:', arr_ipv4_addresses);
-						let num_to_start = arr_ipv4_addresses.length;
-						if (num_to_start === 0) {
-							callback('No allowed network interfaces found.');
-							return;
-						}
-						const respond_not_found = (res) => {
-							if (!res.headersSent) {
-								const body = 'Not Found';
+						arr_ipv4_addresses = [...new Set(arr_ipv4_addresses)];
+						console.log('IPv4 addresses to bind:', arr_ipv4_addresses);
+						let num_to_start = arr_ipv4_addresses.length;
+						let started_count = 0;
+						let last_error = null;
+						let ready_raised = false;
+						if (num_to_start === 0) {
+							callback('No allowed network interfaces found.');
+							return;
+						}
+						const finalize_start = (err) => {
+							if (num_to_start !== 0) return;
+							if (started_count > 0) {
+								if (!ready_raised) {
+									console.log('Server ready');
+									this.raise('ready');
+									ready_raised = true;
+								}
+								if (callback) callback(null, true);
+								return;
+							}
+							const final_error = err || last_error || new Error('No servers started.');
+							if (callback) callback(final_error);
+						};
+						const respond_not_found = (res) => {
+							if (!res.headersSent) {
+								const body = 'Not Found';
 								res.statusCode = 404;
 								res.setHeader('Content-Type', 'text/plain; charset=utf-8');
 								res.setHeader('Content-Length', Buffer.byteLength(body));
@@ -302,70 +330,66 @@ class JSGUI_Single_Process_Server extends Evented_Class {
 										process_request(req, res);
 									});
 									this.http_servers.push(https_server);
-									https_server.on('error', (err) => {
-										if (err.code === 'EACCES') {
-											console.error('Permission denied:', err.message);
-										} else if (err.code === 'EADDRINUSE') {
-											console.error(`Address ${ipv4_address}:${port} already in use; skipping.`);
-										} else {
-											console.error('https_server error:', err);
-										}
-										num_to_start--;
-										if (num_to_start === 0 && callback) callback(null, true);
-									});
-									https_server.timeout = 10800000;
-									https_server.listen(port, ipv4_address, () => {
-										console.log('* Server running at https://' + ipv4_address + ':' + port + '/');
-										num_to_start--;
-										if (num_to_start === 0) {
-											console.log('Server ready');
-											this.raise('ready');
-											if (callback) callback(null, true);
-										}
-									});
-								} catch (err) {
-									console.log('https_server err', err);
-									num_to_start--;
-									if (num_to_start === 0 && callback) callback(null, true);
-								}
-							});
-						} else {
-						each(arr_ipv4_addresses, (ipv4_address) => {
-								try {
-								var http_server = http.createServer(function(req, res) {
-									process_request(req, res);
-								});
-									this.http_servers.push(http_server);
-									http_server.on('error', (err) => {
-										if (err.code === 'EACCES') {
-											console.error('Permission denied:', err.message);
-										} else if (err.code === 'EADDRINUSE') {
-											console.error(`Address ${ipv4_address}:${port} already in use; skipping.`);
-										} else {
-											console.error('http_server error:', err);
-										}
-										num_to_start--;
-										if (num_to_start === 0 && callback) callback(null, true);
-									});
-									http_server.timeout = 10800000;
-									http_server.listen(port, ipv4_address, () => {
-										console.log('* Server running at http://' + ipv4_address + ':' + port + '/');
-										num_to_start--;
-										if (num_to_start === 0) {
-											console.log('Server ready');
-											this.raise('ready');
-											if (callback) callback(null, true);
-										}
-									});
-								} catch (err) {
-									console.log('http_server err', err);
-									num_to_start--;
-									if (num_to_start === 0 && callback) callback(null, true);
-								}
-							});
-						}
-					}
-				});
+									https_server.on('error', (err) => {
+										last_error = err;
+										if (err.code === 'EACCES') {
+											console.error('Permission denied:', err.message);
+										} else if (err.code === 'EADDRINUSE') {
+											console.error(`Address ${ipv4_address}:${port} already in use; skipping.`);
+										} else {
+											console.error('https_server error:', err);
+										}
+										num_to_start--;
+										finalize_start(err);
+									});
+									https_server.timeout = 10800000;
+									https_server.listen(port, ipv4_address, () => {
+										console.log('* Server running at https://' + ipv4_address + ':' + port + '/');
+										started_count++;
+										num_to_start--;
+										finalize_start(null);
+									});
+								} catch (err) {
+									console.log('https_server err', err);
+									num_to_start--;
+									finalize_start(err);
+								}
+							});
+						} else {
+						each(arr_ipv4_addresses, (ipv4_address) => {
+								try {
+								var http_server = http.createServer(function(req, res) {
+									process_request(req, res);
+								});
+									this.http_servers.push(http_server);
+									http_server.on('error', (err) => {
+										last_error = err;
+										if (err.code === 'EACCES') {
+											console.error('Permission denied:', err.message);
+										} else if (err.code === 'EADDRINUSE') {
+											console.error(`Address ${ipv4_address}:${port} already in use; skipping.`);
+										} else {
+											console.error('http_server error:', err);
+										}
+										num_to_start--;
+										finalize_start(err);
+									});
+									http_server.timeout = 10800000;
+									http_server.listen(port, ipv4_address, () => {
+										console.log('* Server running at http://' + ipv4_address + ':' + port + '/');
+										started_count++;
+										num_to_start--;
+										finalize_start(null);
+									});
+								} catch (err) {
+									console.log('http_server err', err);
+									num_to_start--;
+									finalize_start(err);
+								}
+							});
+						}
+					}
+				});
 			}
 		});
 	}

package/tests/README.md

@@ -26,6 +26,9 @@ tests/
 ├── performance.test.js           # Performance benchmarks
 ├── error-handling.test.js        # Error handling and edge cases
 ├── examples-controls.e2e.test.js # Example apps regression (controls)
+├── sass-controls.e2e.test.js     # Sass/CSS controls E2E coverage
+├── jsgui3-html-examples.puppeteer.test.js # Puppeteer interaction tests (jsgui3-html examples)
+├── window-examples.puppeteer.test.js # Puppeteer interaction tests (window examples)
 ├── test-runner.js                # Custom test runner with reporting
 └── README.md                     # This file
 ```
@@ -51,6 +54,11 @@ npx mocha tests/bundlers.test.js
 npm run test:examples:controls
 ```
 
+### Run Puppeteer Window Example Tests
+```bash
+npm run test:puppeteer:windows
+```
+
 ### Run Tests with Options
 ```bash
 # Debug mode (enables sourcemaps)
@@ -132,6 +140,32 @@ Regression coverage for a representative set of `examples/controls/*` apps:
 - Verifies `/`, `/js/js.js`, and `/css/css.css` routes
 - Ensures HTML rendering works without `Accept-Encoding`
 
+### 8. Puppeteer Window Example Tests (`window-examples.puppeteer.test.js`)
+
+Browser-level interaction checks for selected window examples:
+
+- Minimize/restore window state (class toggling)
+- Tabbed panel tab switching visibility
+- Checkbox label toggling checked state
+- Date picker month header rendering
+
+### 9. Sass/CSS Controls E2E Tests (`sass-controls.e2e.test.js`)
+
+Server-level integration tests for controls that define `.scss` or `.sass` styles:
+
+- Verifies CSS + SCSS mixing order in bundled CSS output
+- Confirms indented Sass compiles and is removed from JS bundles
+- Checks inline CSS sourcemaps include original Sass/SCSS sources
+- Ensures mixed CSS + Sass output preserves order without emitting inaccurate sourcemaps
+
+Note: These tests are skipped if the `sass` dependency is not installed.
+
+### 10. JSGUI3-HTML Example Puppeteer Tests (`jsgui3-html-examples.puppeteer.test.js`)
+
+Browser-level interaction checks for jsgui3-html examples:
+
+- MVVM counter interactions, bindings, and validation state
+
 ## Configuration Examples
 
 ### Basic Minification
@@ -205,12 +239,13 @@ Total Test Suites: 8
 🎉 All tests passed! The minification, compression, and sourcemap features are working correctly.
 ```
 
-## Environment Requirements
+## Environment Requirements
 
 - Node.js >= 15.0.0
 - Mocha test framework (included in package.json)
-- ESBuild (included in package.json)
-- zlib (built-in Node.js module)
+- ESBuild (included in package.json)
+- zlib (built-in Node.js module)
+- Puppeteer (dev dependency; set `PUPPETEER_EXECUTABLE_PATH` to a local Chrome/Chromium if downloads are disabled)
 
 ## Troubleshooting
 

package/tests/bundlers.test.js

@@ -16,29 +16,34 @@ this.timeout(30000); // Increase timeout for bundling operations
 
     beforeEach(async function() {
         // Create a temporary test JS file
-        testJsContent = `
-            // Test JavaScript with CSS
-            const css = \`
-                .test-class {
-                    color: red;
-                    font-size: 14px;
-                }
-            \`;
-
-            // Add CSS to document
-            const style = document.createElement('style');
-            style.textContent = css;
-            document.head.appendChild(style);
-
-            // Test function
-            function testFunction() {
-                console.log('Hello from test function');
-                return 'test result';
-            }
-
-            // Export for testing
-            module.exports = { testFunction };
-        `;
+        testJsContent = `
+            class Test_Class {
+                constructor() {}
+            }
+
+            Test_Class.css = \`
+                .test-class {
+                    color: red;
+                    font-size: 14px;
+                }
+            \`;
+
+            Test_Class.scss = \`
+                $accent-color: #33aacc;
+                .sass-class {
+                    color: $accent-color;
+                }
+            \`;
+
+            // Test function
+            function testFunction() {
+                console.log('Hello from test function');
+                return 'test result';
+            }
+
+            // Export for testing
+            module.exports = { testFunction, Test_Class };
+        `;
 
         testJsFile = path.join(__dirname, 'temp_test.js');
         await fs.writeFile(testJsFile, testJsContent);
@@ -242,14 +247,18 @@ this.timeout(30000); // Increase timeout for bundling operations
             assert.strictEqual(jsItem.extension, 'js');
             assert.strictEqual(cssItem.extension, 'css');
 
-            // Verify CSS was extracted
-            assert(cssItem.text.includes('.test-class'), 'CSS should contain the test class');
-            assert(cssItem.text.includes('color: red'), 'CSS should contain the color property');
-
-            // Verify JS no longer contains CSS
-            assert(!jsItem.text.includes('.test-class'), 'JS should not contain CSS after extraction');
-            assert(jsItem.text.includes('testFunction'), 'JS should still contain the test function');
-        });
+            // Verify CSS was extracted
+            assert(cssItem.text.includes('.test-class'), 'CSS should contain the test class');
+            assert(cssItem.text.includes('color: red'), 'CSS should contain the color property');
+            assert(cssItem.text.includes('.sass-class'), 'CSS should contain the SCSS class');
+            assert(cssItem.text.includes('#33aacc'), 'CSS should contain compiled SCSS color value');
+
+            // Verify JS no longer contains CSS
+            assert(!jsItem.text.includes('.test-class'), 'JS should not contain CSS after extraction');
+            assert(!jsItem.text.includes('.sass-class'), 'JS should not contain SCSS after extraction');
+            assert(!jsItem.text.includes('$accent-color'), 'JS should not contain SCSS variables');
+            assert(jsItem.text.includes('testFunction'), 'JS should still contain the test function');
+        });
 
         it('should handle debug mode with sourcemaps', async function() {
             const bundler = new Advanced_JS_Bundler_Using_ESBuild({
@@ -326,4 +335,4 @@ this.timeout(30000); // Increase timeout for bundling operations
             }
         });
     });
-});
+});

package/tests/content-analysis.test.js

@@ -46,23 +46,24 @@ describe('Content Analysis Tests', function() {
                 }
             }
 
-            // Some CSS embedded in JS
-            const css = \`
-                .test-class {
-                    background-color: #ffffff;
-                    border: 1px solid #cccccc;
-                    padding: 10px;
-                    margin: 5px;
-                }
-                .test-class:hover {
-                    background-color: #f0f0f0;
-                }
-            \`;
-
-            // Add CSS to document
-            const style = document.createElement('style');
-            style.textContent = css;
-            document.head.appendChild(style);
+            TestClass.css = \`
+                .test-class {
+                    background-color: #ffffff;
+                    border: 1px solid #cccccc;
+                    padding: 10px;
+                    margin: 5px;
+                }
+                .test-class:hover {
+                    background-color: #f0f0f0;
+                }
+            \`;
+
+            TestClass.scss = \`
+                $accent-color: #33aacc;
+                .sass-class {
+                    color: $accent-color;
+                }
+            \`;
 
             // Export
             module.exports = { testFunction, testObject, TestClass };
@@ -638,4 +639,4 @@ describe('Content Analysis Tests', function() {
             assert(brotliSize < originalSize * 0.5, 'Brotli should achieve >50% compression on repetitive content');
         });
     });
-});
+});