gulp-mu-gulp-api 0.4.0 → 0.4.1

package/README.md

@@ -37,6 +37,11 @@ The module is deliberately **dependency-free** and knows nothing about µGulp™
 npm install gulp-mu-gulp-api
 ```
 
+### 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.
@@ -347,6 +352,11 @@ Das Modul ist bewusst **abhängigkeitsfrei** und kennt keine µGulp™-Interna:
 npm install gulp-mu-gulp-api
 ```
 
+### 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>`.

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "gulp-mu-gulp-api",
-	"version": "0.4.0",
+	"version": "0.4.1",
 	"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",

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) {