@zambon-dev/library 1.4.0 → 1.4.1

package/CHANGELOG.md

@@ -23,6 +23,10 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ### ⚠ Breaking Changes / Migration
 
+## [1.4.1] - 2026-09-08
+
+- Maintenance release (no consumer-facing changes were documented).
+
 ## [1.4.0] - 2026-09-08
 
 ### Added
@@ -113,6 +117,18 @@ and want external items too, add a subscription to `menuExternalUrlSelected`.
   only the last one saved just that row, because `onSaveClick` validates the current selection only,
   so the earlier rows silently vanished on refresh. `newData()`'s values are now registered when the
   row is added.
+- **`lib-catalog-select` no longer renders an empty caption after a form reset.** `FormService.resetForm()`
+  clears every control and then patches the model back, so the component receives the value it already
+  held. It skipped refreshing the caption in that case, on the assumption that an unchanged value means
+  the caption is still on screen — but the reset had emptied the display control a moment earlier. The
+  field therefore rendered blank whenever the stored value equalled the control's initial value, which
+  is why it only ever showed on the entry the form defaults to: a `nonNullable` control declared as
+  `new FormControl(0)` bound to an enum whose first member is `0`, for instance. Values differing from
+  the initial one refreshed normally and always looked right, which made the fault read like a
+  translation or data problem rather than a reset one. The caption is now rewritten whenever it has
+  drifted from the selected entry, so the value alone no longer decides. Selects backed by a
+  `searchEndpoint` are unaffected, since their caption comes from the server-side selection rather than
+  `entriesList`. No consumer changes are required.
 
 ### ⚠ Breaking Changes / Migration
 
@@ -200,7 +216,8 @@ config options and the `getUserProfile()` method still exist but are no longer c
   available via [GitHub Releases](https://github.com/RicardoZambon/ZLibraries/releases) and the
   `library-v*` tags.
 
-[Unreleased]: https://github.com/RicardoZambon/ZLibraries/compare/library-v1.4.0...HEAD
+[Unreleased]: https://github.com/RicardoZambon/ZLibraries/compare/library-v1.4.1...HEAD
+[1.4.1]: https://github.com/RicardoZambon/ZLibraries/releases/tag/library-v1.4.1
 [1.4.0]: https://github.com/RicardoZambon/ZLibraries/releases/tag/library-v1.4.0
 [1.3.2]: https://github.com/RicardoZambon/ZLibraries/releases/tag/library-v1.3.2
 [1.3.1]: https://github.com/RicardoZambon/ZLibraries/releases/tag/library-v1.3.1

package/fesm2022/zambon-dev-library.mjs

@@ -1682,7 +1682,7 @@ class CatalogSelectComponent extends BaseComponent {
             .pipe(takeUntil(this.destroy$))
             .subscribe((value) => {
             this.syncFormControlsEnabledDisabled();
-            if (this.selectedValue === value) {
+            if (!this.shouldRefreshDisplay(value)) {
                 return;
             }
             this.selectedValue = value;
@@ -1692,8 +1692,7 @@ class CatalogSelectComponent extends BaseComponent {
                 }
             }
             else {
-                const display = this.entriesDataSource.filter((entry) => entry.value === value)[0]?.display ?? '';
-                this.displayControl?.setValue(display, { emitEvent: false });
+                this.displayControl?.setValue(this.resolveDisplay(value), { emitEvent: false });
             }
         });
         // Initial sync: if the form control already has a value (e.g., the model was loaded
@@ -1972,16 +1971,36 @@ class CatalogSelectComponent extends BaseComponent {
         this.showNoResultsMessage = false;
         this.showMinimumCharactersMessage = false;
     }
+    resolveDisplay(value) {
+        return this.entriesDataSource.filter((entry) => entry.value === value)[0]?.display ?? '';
+    }
     syncDisplayFromCurrentValue() {
         const currentValue = this.formControl?.value;
-        if (currentValue == null || this.selectedValue === currentValue) {
+        if (currentValue == null || !this.shouldRefreshDisplay(currentValue)) {
             return;
         }
         this.selectedValue = currentValue;
         if (!this.hasSearchEndpoint) {
-            const display = this.entriesDataSource.filter((entry) => entry.value === currentValue)[0]?.display ?? '';
-            this.displayControl?.setValue(display, { emitEvent: false });
+            this.displayControl?.setValue(this.resolveDisplay(currentValue), { emitEvent: false });
+        }
+    }
+    /**
+     * Decides whether the display control has to be written again.
+     *
+     * The value on its own is not enough. Resetting a form clears the display control and then
+     * patches the same value back, so an unchanged value can still leave the display empty. That
+     * only happens when the stored value equals the control's initial value, which is why it used
+     * to show up on the default entry alone.
+     */
+    shouldRefreshDisplay(value) {
+        if (this.selectedValue !== value) {
+            return true;
+        }
+        if (this.hasSearchEndpoint) {
+            return false;
         }
+        const display = this.resolveDisplay(value);
+        return display.length > 0 && this.displayControl?.value !== display;
     }
     syncFormControlsEnabledDisabled() {
         if (this.formControl.enabled !== this.displayControl.enabled) {