quackage 1.0.62 → 1.0.64

package/gulp/Quackage-Gulpfile.js

@@ -70,7 +70,13 @@ console.log(`   > Building to [${_CONFIG.LibraryUniminifiedFileName}] and [${_CO
 console.log(`--> Gulp is taking over!`);
 
 const libBrowserify = require('browserify');
-const libGulp = require('gulp');
+
+// Resolve gulp from the consuming project's CWD so that the task
+// registry is shared with the gulp CLI (which also resolves from CWD).
+// Without this, `file:` dev-dependency references to quackage cause
+// two separate gulp instances — tasks registered here become invisible
+// to the CLI, resulting in "Task never defined: default".
+const libGulp = require(require.resolve('gulp', { paths: [process.cwd()] }));
 
 const libVinylSourceStream = require('vinyl-source-stream');
 const libVinylBuffer = require('vinyl-buffer');
@@ -78,28 +84,74 @@ const libVinylBuffer = require('vinyl-buffer');
 const libSourcemaps = require('gulp-sourcemaps');
 const libBabel = require('gulp-babel');
 const libTerser = require('gulp-terser');
+const { Transform } = require('stream');
+
+/**
+ * Create a configured browserify instance with common settings.
+ *
+ * Applies:
+ *   - BrowserifyIgnore entries from config
+ *   - Global transform to rewrite `require('node:xxx')` → `require('xxx')`
+ *     (needed for packages like find-my-way v9 that use Node.js prefixed builtins)
+ *
+ * @param {object} pConfig - The gulpfile config object
+ * @returns {object} Configured browserify instance
+ */
+function createBrowserifyInstance(pConfig)
+{
+	var tmpBrowserify = libBrowserify(
+		{
+			entries: pConfig.EntrypointInputSourceFile,
+			standalone: pConfig.LibraryObjectName,
+			debug: true
+		});
+
+	// Ignore modules that should not be bundled (e.g. WASM loaders loaded via <script> tag)
+	if (Array.isArray(pConfig.BrowserifyIgnore))
+	{
+		for (var i = 0; i < pConfig.BrowserifyIgnore.length; i++)
+		{
+			tmpBrowserify.ignore(pConfig.BrowserifyIgnore[i]);
+		}
+	}
+
+	// Global transform: rewrite require('node:xxx') → require('xxx')
+	// Some npm packages (e.g. find-my-way v9) use the `node:` prefix for
+	// built-in modules, which browserify cannot resolve. This transform
+	// strips the prefix so browserify resolves the standard module name.
+	tmpBrowserify.transform(
+		function(pFile)
+		{
+			var tmpChunks = [];
+			return new Transform(
+				{
+					transform: function(pChunk, pEncoding, fCallback)
+					{
+						tmpChunks.push(pChunk);
+						fCallback();
+					},
+					flush: function(fCallback)
+					{
+						var tmpSource = Buffer.concat(tmpChunks).toString('utf8');
+						tmpSource = tmpSource.replace(
+							/require\(\s*['"]node:([^'"]+)['"]\s*\)/g,
+							"require('$1')"
+						);
+						this.push(tmpSource);
+						fCallback();
+					}
+				});
+		},
+		{ global: true }
+	);
+
+	return tmpBrowserify;
+}
 
 // Build the module for the browser
 libGulp.task('minified',
 	() => {
-		// set up the custom browserify instance for this task
-		var tmpBrowserify = libBrowserify(
-			{
-				entries: _CONFIG.EntrypointInputSourceFile,
-				standalone: _CONFIG.LibraryObjectName,
-				debug: true
-			});
-
-		// Ignore modules that should not be bundled (e.g. WASM loaders loaded via <script> tag)
-		if (Array.isArray(_CONFIG.BrowserifyIgnore))
-		{
-			for (var i = 0; i < _CONFIG.BrowserifyIgnore.length; i++)
-			{
-				tmpBrowserify.ignore(_CONFIG.BrowserifyIgnore[i]);
-			}
-		}
-
-		return tmpBrowserify.bundle()
+		return createBrowserifyInstance(_CONFIG).bundle()
 			.pipe(libVinylSourceStream(_CONFIG.LibraryMinifiedFileName))
 			.pipe(libVinylBuffer())
 			.pipe(libSourcemaps.init({loadMaps: true}))
@@ -114,24 +166,7 @@ libGulp.task('minified',
 // Build the module for the browser
 libGulp.task('debug',
 	() => {
-		// set up the custom browserify instance for this task
-		var tmpBrowserify = libBrowserify(
-			{
-				entries: _CONFIG.EntrypointInputSourceFile,
-				standalone: _CONFIG.LibraryObjectName,
-				debug: true
-			});
-
-		// Ignore modules that should not be bundled (e.g. WASM loaders loaded via <script> tag)
-		if (Array.isArray(_CONFIG.BrowserifyIgnore))
-		{
-			for (var i = 0; i < _CONFIG.BrowserifyIgnore.length; i++)
-			{
-				tmpBrowserify.ignore(_CONFIG.BrowserifyIgnore[i]);
-			}
-		}
-
-		return tmpBrowserify.bundle()
+		return createBrowserifyInstance(_CONFIG).bundle()
 			.pipe(libVinylSourceStream(_CONFIG.LibraryUniminifiedFileName))
 			.pipe(libVinylBuffer())
 			.pipe(libSourcemaps.init({loadMaps: true}))

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "quackage",
-    "version": "1.0.62",
+    "version": "1.0.64",
     "description": "Building.  Testing.  Quacking.  Reloading.",
     "main": "source/Quackage-CLIProgram.js",
     "scripts": {

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

@@ -69,7 +69,15 @@ class QuackageCommandBuild extends libCommandLineCommand
 				}
 
 				// ## .gulpfile-quackage-config.json
-				libFS.writeFileSync(`${this.fable.AppData.CWD}/.gulpfile-quackage-config.json`, this.fable.parseTemplateByHash('Gulpfile-Configuration', pAction));
+				let tmpGulpfileConfigContent = this.fable.parseTemplateByHash('Gulpfile-Configuration', pAction);
+				// Allow per-action BrowserifyIgnore overrides from GulpExecutions entries
+				if (Array.isArray(pAction.BrowserifyIgnore) && pAction.BrowserifyIgnore.length > 0)
+				{
+					let tmpGulpfileConfig = JSON.parse(tmpGulpfileConfigContent);
+					tmpGulpfileConfig.BrowserifyIgnore = pAction.BrowserifyIgnore;
+					tmpGulpfileConfigContent = JSON.stringify(tmpGulpfileConfig, null, 4);
+				}
+				libFS.writeFileSync(`${this.fable.AppData.CWD}/.gulpfile-quackage-config.json`, tmpGulpfileConfigContent);
 				// ## .gulpfile-quackage.js
 				libFS.writeFileSync(`${this.fable.AppData.CWD}/.gulpfile-quackage.js`, this.fable.parseTemplateByHash('Gulpfile-QuackageBase', { AppData: this.fable.AppData, Record: pAction }));
 				// ## gulpfile.js

package/source/services/Quackage-ExampleService.js

@@ -336,39 +336,67 @@ ${tmpExampleListItems}		</ul>
 				}
 
 				let tmpNpxLocation = this.resolveExecutable('npx');
+				let tmpNpmLocation = this.resolveExecutable('npm');
 
-				this.fable.QuackageProcess.execute(
-					tmpNpxLocation,
-					['quack', 'build'],
-					{ cwd: pExample.Path },
-					(pBuildError) =>
-					{
-						if (pBuildError)
-						{
-							this.log.error(`Build error in [${pExample.Name}]: ${pBuildError.message}`);
-						}
-
-						if (tmpPackage.copyFiles || tmpPackage.copyFilesSettings)
+				// Install dependencies if node_modules does not exist
+				let tmpNodeModulesPath = libPath.join(pExample.Path, 'node_modules');
+				let tmpRunBuild = () =>
+				{
+					this.fable.QuackageProcess.execute(
+						tmpNpxLocation,
+						['quack', 'build'],
+						{ cwd: pExample.Path },
+						(pBuildError) =>
 						{
-							this.log.info(`Copying files for [${pExample.Name}] ...`);
-							this.fable.QuackageProcess.execute(
-								tmpNpxLocation,
-								['quack', 'copy'],
-								{ cwd: pExample.Path },
-								(pCopyError) =>
-								{
-									if (pCopyError)
+							if (pBuildError)
+							{
+								this.log.error(`Build error in [${pExample.Name}]: ${pBuildError.message}`);
+							}
+
+							if (tmpPackage.copyFiles || tmpPackage.copyFilesSettings)
+							{
+								this.log.info(`Copying files for [${pExample.Name}] ...`);
+								this.fable.QuackageProcess.execute(
+									tmpNpxLocation,
+									['quack', 'copy'],
+									{ cwd: pExample.Path },
+									(pCopyError) =>
 									{
-										this.log.error(`Copy error in [${pExample.Name}]: ${pCopyError.message}`);
-									}
-									return fExampleCallback();
-								});
-						}
-						else
+										if (pCopyError)
+										{
+											this.log.error(`Copy error in [${pExample.Name}]: ${pCopyError.message}`);
+										}
+										return fExampleCallback();
+									});
+							}
+							else
+							{
+								return fExampleCallback();
+							}
+						});
+				};
+
+				if (!libFS.existsSync(tmpNodeModulesPath))
+				{
+					this.log.info(`Installing dependencies for [${pExample.Name}] ...`);
+					this.fable.QuackageProcess.execute(
+						tmpNpmLocation,
+						['install'],
+						{ cwd: pExample.Path },
+						(pInstallError) =>
 						{
-							return fExampleCallback();
-						}
-					});
+							if (pInstallError)
+							{
+								this.log.error(`Install error in [${pExample.Name}]: ${pInstallError.message}`);
+								return fExampleCallback();
+							}
+							tmpRunBuild();
+						});
+				}
+				else
+				{
+					tmpRunBuild();
+				}
 			},
 			(pError) =>
 			{