@zambon-dev/library 1.5.0 → 1.6.0

package/CHANGELOG.md

@@ -23,6 +23,22 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ### ⚠ Breaking Changes / Migration
 
+## [1.6.0] - 2026-09-16
+
+### Added
+
+- **`DisplayControls`**, which records the form controls that exist only to show a catalog
+  selection's label. `lib-catalog-select` works in pairs — `controlName` holds the identifier,
+  `displayControlName` holds the text — and it creates the second itself when a screen does not
+  declare one, so a form carries controls nobody wrote down. It now marks whichever control it
+  drives as its display, and `framework-button-filters` reads that mark to keep those out of what
+  it submits.
+
+  The mark is held in a `WeakSet` keyed by the control instance, not by its name: two forms may
+  each have an `employeeName`, and only the one a catalog select drives is a display control.
+  Nothing about an application changes — declaring the display control yourself still works, and
+  it is marked just the same.
+
 ## [1.5.0] - 2026-09-09
 
 ### Added
@@ -249,7 +265,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.5.0...HEAD
+[Unreleased]: https://github.com/RicardoZambon/ZLibraries/compare/library-v1.6.0...HEAD
+[1.6.0]: https://github.com/RicardoZambon/ZLibraries/releases/tag/library-v1.6.0
 [1.5.0]: https://github.com/RicardoZambon/ZLibraries/releases/tag/library-v1.5.0
 [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

package/fesm2022/zambon-dev-library.mjs

@@ -38,6 +38,95 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "19.1.6", ngImpor
             args: [{ template: '' }]
         }] });
 
+class DateHelpers {
+    //#region Public methods
+    static diffDays(initialDate, finalDate) {
+        const initialDateOnly = new Date(initialDate.getFullYear(), initialDate.getMonth(), initialDate.getDate());
+        const finalDateOnly = new Date(finalDate.getFullYear(), finalDate.getMonth(), finalDate.getDate());
+        const diff = initialDateOnly.getTime() - finalDateOnly.getTime();
+        return Math.floor(diff / (1000 * 60 * 60 * 24));
+    }
+}
+
+/**
+ * Tracks the form controls that exist only to show a catalog selection's label.
+ *
+ * `lib-catalog-select` works in pairs: the control named by `controlName` holds the identifier, and
+ * the one named by `displayControlName` holds the text the user reads. The second is created by the
+ * component itself when a screen does not declare it, so a form ends up carrying controls nobody
+ * wrote down — and a filters form then submits them alongside the real filters.
+ *
+ * The mark lives in a `WeakSet` keyed by the control instance rather than by its name. That is the
+ * only scope that is actually correct: two forms may each have an `employeeName`, and only the one
+ * a catalog select drives is a display control. It also keeps nothing alive.
+ */
+class DisplayControls {
+    //#region Variables
+    static marked = new WeakSet();
+    //#endregion
+    //#region Public methods
+    /**
+     * Whether the control exists only to display a catalog selection's label.
+     *
+     * @param control The control, which may be absent.
+     * @returns `true` when a catalog select drives it as its display control.
+     */
+    static isDisplayControl(control) {
+        return !!control && DisplayControls.marked.has(control);
+    }
+    /**
+     * Marks the control as existing only to display a catalog selection's label.
+     *
+     * @param control The control, which may be absent.
+     */
+    static markAsDisplayControl(control) {
+        if (control) {
+            DisplayControls.marked.add(control);
+        }
+    }
+}
+
+class GuidHelper {
+    static generateGUID() {
+        return 'xxxxxxxx-xxxx-4xxx-yxxx-xxxxxxxxxxxx'.replace(/[xy]/g, (c) => {
+            const r = (Math.random() * 16) | 0;
+            const v = c === 'x' ? r : (r & 0x3) | 0x8;
+            return v.toString(16);
+        });
+    }
+}
+
+class RouterFormatter {
+    //#region ViewChilds, Inputs, Outputs
+    //#endregion
+    //#region Variables
+    //#endregion
+    //#region Properties
+    //#endregion
+    //#region Constructor and Angular life cycle methods
+    //#endregion
+    //#region Event handlers
+    //#endregion
+    //#region Public methods
+    static getURL(route) {
+        let parentRoute = '';
+        if (route.parent) {
+            parentRoute = this.getURL(route.parent);
+        }
+        let path = route.routeConfig?.path ?? '';
+        route.paramMap.keys
+            .forEach(k => {
+            path = path.replace(':' + k, k === 'view'
+                ? ''
+                : (route.paramMap.get(k) ?? ''));
+        });
+        if (!route.parent || (parentRoute !== '' && parentRoute !== '/' && route.routeConfig?.path && path)) {
+            parentRoute += '/';
+        }
+        return parentRoute + path;
+    }
+}
+
 class CatalogService {
     //#region ViewChilds, Inputs, Outputs
     //#endregion
@@ -193,57 +282,6 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "19.1.6", ngImpor
             type: Injectable
         }], ctorParameters: () => [] });
 
-class DateHelpers {
-    //#region Public methods
-    static diffDays(initialDate, finalDate) {
-        const initialDateOnly = new Date(initialDate.getFullYear(), initialDate.getMonth(), initialDate.getDate());
-        const finalDateOnly = new Date(finalDate.getFullYear(), finalDate.getMonth(), finalDate.getDate());
-        const diff = initialDateOnly.getTime() - finalDateOnly.getTime();
-        return Math.floor(diff / (1000 * 60 * 60 * 24));
-    }
-}
-
-class GuidHelper {
-    static generateGUID() {
-        return 'xxxxxxxx-xxxx-4xxx-yxxx-xxxxxxxxxxxx'.replace(/[xy]/g, (c) => {
-            const r = (Math.random() * 16) | 0;
-            const v = c === 'x' ? r : (r & 0x3) | 0x8;
-            return v.toString(16);
-        });
-    }
-}
-
-class RouterFormatter {
-    //#region ViewChilds, Inputs, Outputs
-    //#endregion
-    //#region Variables
-    //#endregion
-    //#region Properties
-    //#endregion
-    //#region Constructor and Angular life cycle methods
-    //#endregion
-    //#region Event handlers
-    //#endregion
-    //#region Public methods
-    static getURL(route) {
-        let parentRoute = '';
-        if (route.parent) {
-            parentRoute = this.getURL(route.parent);
-        }
-        let path = route.routeConfig?.path ?? '';
-        route.paramMap.keys
-            .forEach(k => {
-            path = path.replace(':' + k, k === 'view'
-                ? ''
-                : (route.paramMap.get(k) ?? ''));
-        });
-        if (!route.parent || (parentRoute !== '' && parentRoute !== '/' && route.routeConfig?.path && path)) {
-            parentRoute += '/';
-        }
-        return parentRoute + path;
-    }
-}
-
 class GridConfigsProvider {
     //#region ViewChilds, Inputs, Outputs
     //#endregion
@@ -1833,6 +1871,10 @@ class CatalogSelectComponent extends BaseComponent {
                 if (!parent.get(name)) {
                     parent.addControl(name, new FormControl(''));
                 }
+                // Marked whether this component created it or the screen declared it: what makes a control
+                // a display control is being driven as one, not who wrote it down. A filters form reads the
+                // mark to keep it out of what it submits.
+                DisplayControls.markAsDisplayControl(parent.get(name));
             }
         });
     }
@@ -4013,5 +4055,5 @@ class DateValidators {
  * Generated bundle index. Do not edit.
  */
 
-export { BaseComponent, BaseDataset, CatalogSelectComponent, CatalogService, DataGridComponent, DataGridConfigsProvider, DataGridDataset, DataGridRowComponent, DataProviderService, DateHelpers, DateValidators, EnumTranslatePipe, FormGroupComponent, FormGroupService, FormInputComponent, FormInputGroupComponent, FormService, GridConfigsProvider, GridDataset, GroupAccordionComponent, GroupContainerComponent, GroupScrollSpyComponent, GuidHelper, LibraryModule, ModalComponent, MultiEditorComponent, MultiEditorDataset, MultiSelectComponent, MultiSelectResultDataset, MultiSelectResultGridComponent, ReplaceManyPipe, ReplacePipe, RibbonButtonComponent, RibbonComponent, RibbonGroupChild, RibbonGroupComponent, RouterFormatter, SIDEBAR_CONFIGS, ScrollSpyDirective, SidebarComponent, SidebarConfigs, SidebarMenu, SidebarMenuOpenMode, SidebarService, toSidebarMenuOpenMode };
+export { BaseComponent, BaseDataset, CatalogSelectComponent, CatalogService, DataGridComponent, DataGridConfigsProvider, DataGridDataset, DataGridRowComponent, DataProviderService, DateHelpers, DateValidators, DisplayControls, EnumTranslatePipe, FormGroupComponent, FormGroupService, FormInputComponent, FormInputGroupComponent, FormService, GridConfigsProvider, GridDataset, GroupAccordionComponent, GroupContainerComponent, GroupScrollSpyComponent, GuidHelper, LibraryModule, ModalComponent, MultiEditorComponent, MultiEditorDataset, MultiSelectComponent, MultiSelectResultDataset, MultiSelectResultGridComponent, ReplaceManyPipe, ReplacePipe, RibbonButtonComponent, RibbonComponent, RibbonGroupChild, RibbonGroupComponent, RouterFormatter, SIDEBAR_CONFIGS, ScrollSpyDirective, SidebarComponent, SidebarConfigs, SidebarMenu, SidebarMenuOpenMode, SidebarService, toSidebarMenuOpenMode };
 //# sourceMappingURL=zambon-dev-library.mjs.map