gulp-mu-gulp-api 0.4.0 → 0.4.2

package/README.md

@@ -1,14 +1,14 @@
 # gulp-mu-gulp-api
 
 <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 href="https://microgulp.dev">
+    <img src="https://microgulp.dev/assets/media/logo_readme.png" alt="µGulp logo" width="180">
   </a>
 </p>
 
 <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 href="https://microgulp.dev">
+    <img src="https://microgulp.dev/assets/media/microgulp-ready.png" alt="µGulp ready" width="150">
   </a>
 </p>
 
@@ -17,7 +17,7 @@
 
 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)
+[![npm version](https://img.shields.io/npm/v/gulp-mu-gulp-api.svg)](https://www.npmjs.com/package/gulp-mu-gulp-api) · [µGulp™](https://microgulp.dev) · [Support](mailto:support@microgulp.dev)
 
 [English](#english) · [Deutsch](#deutsch)
 
@@ -37,6 +37,15 @@ The module is deliberately **dependency-free** and knows nothing about µGulp™
 npm install gulp-mu-gulp-api
 ```
 
+### 0.4.2
+
+- **Updated** homepage, support and README images to the public site [microgulp.dev](https://microgulp.dev) and [support@microgulp.dev](mailto:support@microgulp.dev). The source repository is private.
+
+### 0.4.1
+
+- **Fixed** a placeholder with an unknown named format rendered as an empty string instead of its value — gulp lifecycle lines lost their duration (`Finished 'task' after`). The raw value is kept when the format is missing.
+- **Fixed** `SetLid()` kept the dictionary of the previous language cached, so a language switch inside a running worker could still translate with stale texts.
+
 ### 0.4.0
 
 - **Added** `GetParameters()` / `GetParameter(id, fallback)` — values for the inputs a task declared with `µParameters`. µGulp asks for them once before the task body runs and passes them in as `MICROGULP_PARAMS` (JSON) plus one flat `MICROGULP_PARAM_<ID>` per parameter.
@@ -212,7 +221,7 @@ DEPLOY.µParameters = [
 ];
 ```
 
-The declaration uses the same field types as `RequestForm` plus the `boolean` shorthand (a single checkbox). `id` must be env-var safe. Values arrive as `MICROGULP_PARAMS` (JSON) and `MICROGULP_PARAM_<ID>`, so shell steps in the task can read them as well — and running the gulpfile through the plain gulp CLI works by setting those variables yourself:
+The declaration uses the same field types as `RequestForm` plus the `boolean` slide switch. `id` must be env-var safe. Values arrive as `MICROGULP_PARAMS` (JSON) and `MICROGULP_PARAM_<ID>`, so shell steps in the task can read them as well — and running the gulpfile through the plain gulp CLI works by setting those variables yourself:
 
 ```bash
 MICROGULP_PARAM_TARGET=staging npx gulp DEPLOY
@@ -337,7 +346,7 @@ $env:NPM_OTP="123456"; npm run publish:api
 
 **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.
 
-[![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)
+[![npm version](https://img.shields.io/npm/v/gulp-mu-gulp-api.svg)](https://www.npmjs.com/package/gulp-mu-gulp-api) · [µGulp™](https://microgulp.dev) · [Support](mailto:support@microgulp.dev)
 
 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.
 
@@ -347,6 +356,15 @@ Das Modul ist bewusst **abhängigkeitsfrei** und kennt keine µGulp™-Interna:
 npm install gulp-mu-gulp-api
 ```
 
+### 0.4.2
+
+- **Aktualisiert** Homepage, Support und README-Bilder auf die öffentliche Seite [microgulp.dev](https://microgulp.dev) und [support@microgulp.dev](mailto:support@microgulp.dev). Das Quellrepository ist privat.
+
+### 0.4.1
+
+- **Behoben** Ein Platzhalter mit unbekanntem benanntem Format wurde als leerer Text gerendert statt mit seinem Wert — den Gulp-Lifecycle-Zeilen fehlte dadurch die Dauer (`Finished 'task' after`). Fehlt das Format, bleibt der Rohwert erhalten.
+- **Behoben** `SetLid()` behielt das Wörterbuch der vorherigen Sprache im Cache; ein Sprachwechsel im laufenden Worker konnte weiter mit veralteten Texten übersetzen.
+
 ### 0.4.0
 
 - **Neu** `GetParameters()` / `GetParameter(id, fallback)` — Werte für die Eingaben, die ein Task per `µParameters` deklariert hat. µGulp fragt sie einmal vor dem Task-Rumpf ab und übergibt sie als `MICROGULP_PARAMS` (JSON) plus je Parameter ein flaches `MICROGULP_PARAM_<ID>`.
@@ -522,7 +540,7 @@ DEPLOY.µParameters = [
 ];
 ```
 
-Die Deklaration nutzt die Feldtypen von `RequestForm` plus die Kurzform `boolean` (eine einzelne Checkbox). `id` muss als Umgebungsvariablenname taugen. Die Werte kommen als `MICROGULP_PARAMS` (JSON) und `MICROGULP_PARAM_<ID>` an — auch Shell-Schritte im Task können sie lesen, und unter der reinen gulp-CLI setzt man sie einfach selbst:
+Die Deklaration nutzt die Feldtypen von `RequestForm` plus die Kurzform `boolean` (Schiebeschalter). `id` muss als Umgebungsvariablenname taugen. Die Werte kommen als `MICROGULP_PARAMS` (JSON) und `MICROGULP_PARAM_<ID>` an — auch Shell-Schritte im Task können sie lesen, und unter der reinen gulp-CLI setzt man sie einfach selbst:
 
 ```bash
 MICROGULP_PARAM_TARGET=staging npx gulp DEPLOY

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "gulp-mu-gulp-api",
-	"version": "0.4.0",
+	"version": "0.4.2",
 	"description": "Public task API for the µGulp orchestrator: progress reporting, declared task parameters, 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",
@@ -34,14 +34,11 @@
 		"task-api"
 	],
 	"license": "MIT",
-	"repository": {
-		"type": "git",
-		"url": "git+https://github.com/mamekudz/microGulp.git",
-		"directory": "gulp-mu-gulp-api"
-	},
-	"homepage": "https://github.com/mamekudz/microGulp/tree/main/gulp-mu-gulp-api#readme",
+	"author": "Meinolf Amekudzi <support@microgulp.dev>",
+	"homepage": "https://microgulp.dev",
 	"bugs": {
-		"url": "https://github.com/mamekudz/microGulp/issues"
+		"url": "https://microgulp.dev",
+		"email": "support@microgulp.dev"
 	},
 	"publishConfig": {
 		"access": "public"

package/src/i18x-engine.mjs

@@ -627,7 +627,10 @@ export function Trans(_text, _placeholders, _ctx) {
 					let subContext = localFormats ? { ...ctx, formats: { ...(ctx.formats ?? {}), ...localFormats } } : ctx;
 					value = FormatValue(Number(value) || 0, attrValue, subContext);
 				} else {
-					value = '';
+					// Missing named format must not swallow the placeholder (e.g.
+					// gulp lifecycle "after <duration format="progressDuration"/>"
+					// would otherwise render as "Finished 'task' after ").
+					value = value === undefined || value === null ? '' : String(value);
 				}
 			} else if (attrKey === 'enumeration') {
 				let options = attrValue.split('|');

package/src/i18x.mjs

@@ -195,8 +195,10 @@ export function GetLid() {
  */
 export function SetLid(_lid) {
 	activeLid = _lid ? _BestAvailableLid(_lid, _AvailableLids()) : null;
+	dictionaryCache.clear();
 	formatDefinitionCache.clear();
 	formatRegistryCache.clear();
+	availableLids = null;
 }
 
 /** Loads and caches `<dir>/<lid>.json`; a missing/broken file yields source text. */

package/src/index.mjs

@@ -386,9 +386,11 @@ export function Speak(_text, _options) {
  * { value, label?, checked?, disabled? }.
  *
  * Validation rules: { required?, minLength?, pattern?, minSelected? } —
- * checks run asynchronously in the webview before submission.
+ * checks run in the webview; required / minSelected also keep the submit
+ * button disabled until the form is valid. Multi-select `required` means
+ * at least one option.
  *
- * @param {object} _form { title, fields: [...] }
+ * @param {object} _form { title?, submitLabel?, fields: [...] }
  * @returns {Promise<object>} map fieldId -> value
  */
 export async function RequestForm(_form) {