gulp-mu-gulp-api 0.3.2 → 0.3.4

package/README.md

@@ -1,8 +1,20 @@
 # gulp-mu-gulp-api
 
-Public task API of the **µGulp™** orchestrator — progress reporting and interactive dashboard inputs from within gulp tasks.
+<p align="center">
+  <a href="https://github.com/mamekudz/microGulp">
+    <img src="https://raw.githubusercontent.com/mamekudz/microGulp/main/media/logo_readme.png" alt="µGulp logo" width="180">
+  </a>
+</p>
 
-Part of the [µGulp™ project on GitHub](https://github.com/mamekudz/microGulp) (subdirectory [`gulp-mu-gulp-api/`](https://github.com/mamekudz/microGulp/tree/main/gulp-mu-gulp-api)).
+<p align="center">
+  <a href="https://github.com/mamekudz/microGulp">
+    <img src="https://raw.githubusercontent.com/mamekudz/microGulp/main/media/microgulp-ready.png" alt="µGulp ready" width="150">
+  </a>
+</p>
+
+Public task API of the **µGulp™** orchestrator — progress reporting, i18x console output and interactive dashboard inputs from within gulp tasks.
+
+[![npm version](https://img.shields.io/npm/v/gulp-mu-gulp-api.svg)](https://www.npmjs.com/package/gulp-mu-gulp-api) · [µGulp™ on GitHub](https://github.com/mamekudz/microGulp) · [source tree](https://github.com/mamekudz/microGulp/tree/main/gulp-mu-gulp-api)
 
 [English](#english) · [Deutsch](#deutsch)
 
@@ -20,6 +32,10 @@ The module is deliberately **dependency-free** and knows nothing about µGulp™
 npm install gulp-mu-gulp-api
 ```
 
+### 0.3.3
+
+- **Changed** npm README: centered µGulp logo and µGulp ready badge (absolute raw URLs from the µGulp repo).
+
 ### 0.3.2
 
 - **Added** `FormatValue()` — renders `<name format="…"/>` placeholders from `<format …>` XML definitions in the consumer project's `i18x/gulp/<lid>.json`.
@@ -171,9 +187,9 @@ MIT — © 2026 Meinolf Amekudzi
 
 # Deutsch
 
-**gulp-mu-gulp-api** ist die öffentliche Task-API des **µGulp™**-Orchestrators. Gulp-Tasks (und beliebige npm-Pakete innerhalb des Task-Streams) erhalten damit Zugriff auf die erweiterten µGulp™-Dashboard-Funktionen: Fortschrittsanzeige, Texteingaben mit Validierung, Farb- und Schriftart-Auswahl, Einzel- und Mehrfachauswahl, Slider und komplette Formulare.
+**gulp-mu-gulp-api** ist die öffentliche Task-API des **µGulp™**-Orchestrators. Gulp-Tasks (und beliebige npm-Pakete innerhalb des Task-Streams) erhalten damit Zugriff auf die erweiterten µGulp™-Dashboard-Funktionen: Fortschrittsanzeige, i18x-Konsolenausgabe, Texteingaben mit Validierung, Farb- und Schriftart-Auswahl, Einzel- und Mehrfachauswahl, Slider und komplette Formulare.
 
-Teil des [µGulp™-Projekts auf GitHub](https://github.com/mamekudz/microGulp) (Unterverzeichnis [`gulp-mu-gulp-api/`](https://github.com/mamekudz/microGulp/tree/main/gulp-mu-gulp-api)).
+[![npm version](https://img.shields.io/npm/v/gulp-mu-gulp-api.svg)](https://www.npmjs.com/package/gulp-mu-gulp-api) · [µGulp™ auf GitHub](https://github.com/mamekudz/microGulp)
 
 Das Modul ist bewusst **abhängigkeitsfrei** und kennt keine µGulp™-Interna: Läuft der Task unter µGulp™, spricht es direkt über den IPC-Kanal des Worker-Prozesses mit der Engine. Läuft das Gulpfile klassisch über die gulp-CLI, degradieren alle Funktionen sauber — Fortschritt landet auf dem Terminal, Eingaben werden per readline abgefragt (TTY) oder mit den deklarierten Default-Werten beantwortet (CI/non-TTY). Tasks bleiben ohne µGulp™ voll lauffähig.
 
@@ -183,6 +199,10 @@ Das Modul ist bewusst **abhängigkeitsfrei** und kennt keine µGulp™-Interna:
 npm install gulp-mu-gulp-api
 ```
 
+### 0.3.3
+
+- **Geändert** npm-README: zentriertes µGulp-Logo und µGulp-ready-Badge (absolute raw-URLs aus dem µGulp-Repo).
+
 ### 0.3.2
 
 - **Neu** `FormatValue()` — rendert `<name format="…"/>`-Platzhalter aus `<format …>`-XML-Definitionen in `i18x/gulp/<lid>.json` des Verbraucherprojekts.

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "gulp-mu-gulp-api",
-	"version": "0.3.2",
+	"version": "0.3.4",
 	"description": "Public task API for the µGulp orchestrator: progress reporting, sound signals, speech output, localized console output (i18x) and interactive UI inputs (text, password, number, textarea, color, font, select, radio, multi-select checkbox, range slider, date/time, file) from within gulp tasks — with graceful CLI fallbacks when running without µGulp.",
 	"type": "module",
 	"main": "src/index.mjs",
@@ -43,6 +43,11 @@
 	"publishConfig": {
 		"access": "public"
 	},
+	"microgulp": {
+		"ready": true,
+		"certifiedSince": "0.3.2",
+		"role": "official-task-api"
+	},
 	"engines": {
 		"node": ">=18"
 	}

package/src/index.mjs

@@ -43,7 +43,10 @@ const pendingUiRequests = new Map();
  * attached dashboard (progress and inputs are rendered in the webview)
  */
 export function IsMicroGulp() {
-	return typeof process.send === 'function' && process.env.MICROGULP === '1';
+	// The worker pool sets MICROGULP=1 for every forked task process. Relying
+	// only on process.send was too strict — some hosts still stream stdout
+	// correctly while structured IPC must be attempted separately.
+	return process.env.MICROGULP === '1';
 }
 
 /** Brand-aligned alias for {@link IsMicroGulp}. */
@@ -108,9 +111,12 @@ export function CreateProgress(_label) {
 	};
 }
 
-// -------------------------------------------------
-// structured log output (table / tree)
-// -------------------------------------------------
+function _SendStructuredLog(_format, _payload) {
+	if (!IsMicroGulp()) return false;
+	if (typeof process.send !== 'function') return false;
+	process.send({ type: 'structured-log', format: _format, payload: _payload });
+	return true;
+}
 
 /**
  * Sends a table to the dashboard log pane. The payload is JSON:
@@ -121,10 +127,7 @@ export function CreateProgress(_label) {
  */
 export function LogTable(_spec) {
 	let payload = _NormalizeTableSpec(_spec);
-	if (IsMicroGulp()) {
-		process.send({ type: 'structured-log', format: 'table', payload });
-		return;
-	}
+	if (_SendStructuredLog('table', payload)) return;
 	console.log(_AsciiTable(payload));
 }
 
@@ -137,10 +140,7 @@ export function LogTable(_spec) {
  */
 export function LogTree(_spec) {
 	let payload = _NormalizeTreeSpec(_spec);
-	if (IsMicroGulp()) {
-		process.send({ type: 'structured-log', format: 'tree', payload });
-		return;
-	}
+	if (_SendStructuredLog('tree', payload)) return;
 	for (let line of _AsciiTreeLines(payload)) console.log(line);
 }
 
@@ -153,10 +153,7 @@ export function LogTree(_spec) {
  */
 export function LogGallery(_spec) {
 	let payload = _NormalizeGallerySpec(_spec);
-	if (IsMicroGulp()) {
-		process.send({ type: 'structured-log', format: 'gallery', payload });
-		return;
-	}
+	if (_SendStructuredLog('gallery', payload)) return;
 	console.log(_AsciiGallery(payload));
 }