npm - ng-hub-ui-utils - Versions diffs - 22.13.0 → 22.14.0 - Mend

ng-hub-ui-utils 22.13.0 → 22.14.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (5) hide show

package/README.md +7 -7
package/fesm2022/ng-hub-ui-utils.mjs +8 -67
package/fesm2022/ng-hub-ui-utils.mjs.map +1 -1
package/package.json +1 -1
package/types/ng-hub-ui-utils.d.ts +8 -47

package/README.md CHANGED Viewed

@@ -384,13 +384,14 @@ export class ExampleComponent {}
 Inputs: `hubTooltip` (text), `hubTooltipPlacement` (`top` | `bottom` | `left` | `right`,
 default `top`), `hubTooltipDelay` (fade ms, default `150`), `hubTooltipOffset` (px, default `8`).
-> **`TooltipDirective` (`[tooltip]`) is deprecated since 22.9.0.** It still works,
-> unchanged — both directives are thin shells over the same `HubTooltipController` — but its
-> bare input names (`tooltip`, `placement`, `delay`, `offset`) belong to every directive on
-> the element that declares them, which is how it collided with `[hubDropdown]`'s own
-> `placement` and with the `tooltip` input of `<hub-badge>`. Migration is attribute for
+> **`TooltipDirective` (`[tooltip]`) was removed in 22.14.0**, having been deprecated since
+> 22.9.0. Its bare input names (`tooltip`, `placement`, `delay`, `offset`) belonged to every
+> directive on the element that declared them, which is how it collided with `[hubDropdown]`'s
+> own `placement` and with the `tooltip` input of `<hub-badge>`. Migration is attribute for
 > attribute: `tooltip` → `hubTooltip`, `placement` → `hubTooltipPlacement`,
-> `delay` → `hubTooltipDelay`, `offset` → `hubTooltipOffset`.
+> `delay` → `hubTooltipDelay`, `offset` → `hubTooltipOffset`. A template left writing
+> `tooltip="…"` still compiles and shows nothing at all, so check the markup as well as the
+> imports.
 Show the label **only while the host is truncated** with `HubOverflowTooltipDirective`
 (`[hubOverflowTooltip]`), which tracks truncation live with a `ResizeObserver` and a
@@ -727,7 +728,6 @@ library, because their selectors and data models differ.
 -   `HubTooltipDirective` (`[hubTooltip]`) - Tooltip on hover/focus. Inputs: `hubTooltip`, `hubTooltipPlacement`, `hubTooltipDelay`, `hubTooltipOffset`
 -   `HubOverflowTooltipDirective` (`[hubOverflowTooltip]`) - Tooltip shown only while the label is truncated. Inputs: `hubOverflowTooltip`, `placement`, `hubOverflowTooltipMeasure` (CSS selector, resolved inside the host, naming the box whose truncation decides it; defaults to the host)
--   `TooltipDirective` (`[tooltip]`) - **Deprecated since 22.9.0**, kept working. Inputs: `tooltip`, `placement`, `delay`, `offset`
 -   `provideHubTooltip(adapter: HubTooltipAdapter)` and `HUB_TOOLTIP_ADAPTER` - Swap the implementation behind `[hubOverflowTooltip]`, app-wide or per subtree; defaults to `hubTooltipAdapter`
 ### Pipes

package/fesm2022/ng-hub-ui-utils.mjs CHANGED Viewed

@@ -2792,7 +2792,7 @@ let nextTooltipId = 0;
  *
  * Binds hover/focus listeners to a host element and renders a body-portaled,
  * `--hub-tooltip-*`-themeable label on demand. It owns no Angular dependency, so
- * it can be reused both by the `[tooltip]` directive and by other primitives
+ * it can be reused both by the `[hubTooltip]` directive and by other primitives
  * (e.g. a badge overflow tooltip) that want the exact same visual contract
  * without re-implementing the DOM logic.
  *
@@ -3125,65 +3125,6 @@ function provideHubTooltip(adapter) {
     ]);
 }
-/**
- * Lightweight tooltip directive.
- *
- * @deprecated Use {@link HubTooltipDirective} (`[hubTooltip]`) instead. The bare
- * attribute and the bare input names `placement`, `delay` and `offset` are not this
- * directive's to hold: Angular feeds one attribute to every directive on the element
- * that declares an input of that name, so `[hubDropdown] placement` fails to compile
- * beside a tooltip, and `[tooltip]` on a `<hub-badge>` — which owns an input of that
- * name — renders two. Kept working, unchanged, until the next major.
- *
- * Apply `[tooltip]` to any element to show a positioned label on hover/focus.
- * The tooltip element is appended to `<body>` so it is never clipped by an
- * overflow container, and every visual aspect is themeable through
- * `--hub-tooltip-*` CSS variables.
- *
- * All DOM work is delegated to {@link HubTooltipController}, so the directive and
- * any imperative consumer (e.g. a badge overflow tooltip) share the exact same
- * behaviour and styling.
- *
- * Styles ship in `styles/tooltip.scss` (mirroring `styles/overlay.scss`). Import
- * it once in your app: `@use 'ng-hub-ui-utils/styles/tooltip';`.
- */
-class TooltipDirective {
-    /** Tooltip text content. */
-    tooltipTitle = input.required({ ...(ngDevMode ? { debugName: "tooltipTitle" } : /* istanbul ignore next */ {}), alias: 'tooltip' });
-    /** Placement of the tooltip relative to the host. */
-    placement = input('top', /* @ts-ignore */
-    ...(ngDevMode ? [{ debugName: "placement" }] : /* istanbul ignore next */ []));
-    /** Fade duration in milliseconds, also used as the removal delay on hide. */
-    delay = input(150, /* @ts-ignore */
-    ...(ngDevMode ? [{ debugName: "delay" }] : /* istanbul ignore next */ []));
-    /** Gap in pixels between the host and the tooltip. */
-    offset = input(8, /* @ts-ignore */
-    ...(ngDevMode ? [{ debugName: "offset" }] : /* istanbul ignore next */ []));
-    host = inject(ElementRef);
-    controller = new HubTooltipController(this.host.nativeElement);
-    constructor() {
-        effect(() => {
-            this.controller.setOptions({
-                placement: this.placement(),
-                delay: this.delay(),
-                offset: this.offset()
-            });
-            this.controller.setText(this.tooltipTitle());
-        });
-    }
-    ngOnDestroy() {
-        this.controller.destroy();
-    }
-    static ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "22.0.8", ngImport: i0, type: TooltipDirective, deps: [], target: i0.ɵɵFactoryTarget.Directive });
-    static ɵdir = i0.ɵɵngDeclareDirective({ minVersion: "17.1.0", version: "22.0.8", type: TooltipDirective, isStandalone: true, selector: "[tooltip]", inputs: { tooltipTitle: { classPropertyName: "tooltipTitle", publicName: "tooltip", isSignal: true, isRequired: true, transformFunction: null }, placement: { classPropertyName: "placement", publicName: "placement", isSignal: true, isRequired: false, transformFunction: null }, delay: { classPropertyName: "delay", publicName: "delay", isSignal: true, isRequired: false, transformFunction: null }, offset: { classPropertyName: "offset", publicName: "offset", isSignal: true, isRequired: false, transformFunction: null } }, ngImport: i0 });
-}
-i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "22.0.8", ngImport: i0, type: TooltipDirective, decorators: [{
-            type: Directive,
-            args: [{
-                    selector: '[tooltip]'
-                }]
-        }], ctorParameters: () => [], propDecorators: { tooltipTitle: [{ type: i0.Input, args: [{ isSignal: true, alias: "tooltip", required: true }] }], placement: [{ type: i0.Input, args: [{ isSignal: true, alias: "placement", required: false }] }], delay: [{ type: i0.Input, args: [{ isSignal: true, alias: "delay", required: false }] }], offset: [{ type: i0.Input, args: [{ isSignal: true, alias: "offset", required: false }] }] } });
 /**
  * Tooltip directive, named the way the rest of the family names itself.
  *
@@ -3192,12 +3133,12 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "22.0.8", ngImpor
  * container, and every visual aspect is themeable through `--hub-tooltip-*` CSS
  * variables.
  *
- * ## Why this exists beside {@link TooltipDirective}
+ * ## Why every attribute here carries the prefix
  *
- * The older directive claims the bare attribute `[tooltip]` and the bare input names
- * `placement`, `delay` and `offset`. Angular feeds one attribute to **every** directive
- * on the element that declares an input of that name, so those bare names are not this
- * directive's to hold:
+ * This replaced an earlier directive that claimed the bare attribute `[tooltip]` and the
+ * bare input names `placement`, `delay` and `offset`. Angular feeds one attribute to
+ * **every** directive on the element that declares an input of that name, so those bare
+ * names were never a library's to hold:
  *
  * - `[hubDropdown]` declares its own `placement`, typed over eight values where a
  *   tooltip understands four. A menu trigger that also wanted a tooltip did not merely
@@ -3257,7 +3198,7 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "22.0.8", ngImpor
  * Shows a tooltip with the given text **only while the host element is truncated**
  * (its content is wider than its box).
  *
- * Unlike `[tooltip]`, which always shows on hover, this directive is meant for
+ * Unlike `[hubTooltip]`, which always shows on hover, this directive is meant for
  * ellipsised labels: the tooltip appears solely when the text doesn't fit, so it
  * never duplicates already-visible content. Truncation is tracked live with a
  * `ResizeObserver` (host/container resizes) and a `MutationObserver` (text
@@ -3405,5 +3346,5 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "22.0.8", ngImpor
  * Generated bundle index. Do not edit.
  */
-export { ContentRef, FOCUSABLE_ELEMENTS_SELECTOR, GetPipe, HUB_DROPDOWN_POSITIONS, HUB_INK_LIGHTNESS_THRESHOLD, HUB_NAMED_COLORS, HUB_TOOLTIP_ADAPTER, HUB_TRANSLATION_CONFIG, HUB_TRANSLATION_PREFIX, HUB_TRANSLATION_SOURCE, HubDragDropService, HubOverflowTooltipDirective, HubTooltipController, HubTooltipDirective, HubTranslationService, IsObjectPipe, IsObservablePipe, IsStringPipe, OverlayPosition, OverlayRef, OverlayService, PopupService, ScrollBar, TooltipDirective, TranslatePipe, UcfirstPipe, UnwrapAsyncPipe, clamp, clampToSrgbGamut, closest, compositeOver, computeTargetIndex, containsNode, contrastAPCA, contrastRatio, copyArrayItem, createNativeDragImage, createPointerDragSession, debouncedSignal, equals, generateUniqueId, getActiveElement, getFocusableBoundaryElements, getValue, getValueInRange, hubCompleteTransition, hubFocusTrap, hubRunTransition, hubTooltipAdapter, interpolateString, isDefined, isInSrgbGamut, isInteger, isNumber, isObject, isPromise, isString, isValidColor, maxSrgbChroma, mergeDeep, moveItemInArray, oklchToRgb, padNumber, parseColor, provideHubTooltip, provideHubTranslation, provideHubTranslationAdapter, readableOn, reflow, regExpEscape, registerOverlayKeydown, relativeLuminance, removeAccents, resolveDropPosition, resolveHubAccent, rgbToOklch, runInZone, toAbsoluteIndex, toHex, toInteger, toRgb, toString, transferArrayItem };
+export { ContentRef, FOCUSABLE_ELEMENTS_SELECTOR, GetPipe, HUB_DROPDOWN_POSITIONS, HUB_INK_LIGHTNESS_THRESHOLD, HUB_NAMED_COLORS, HUB_TOOLTIP_ADAPTER, HUB_TRANSLATION_CONFIG, HUB_TRANSLATION_PREFIX, HUB_TRANSLATION_SOURCE, HubDragDropService, HubOverflowTooltipDirective, HubTooltipController, HubTooltipDirective, HubTranslationService, IsObjectPipe, IsObservablePipe, IsStringPipe, OverlayPosition, OverlayRef, OverlayService, PopupService, ScrollBar, TranslatePipe, UcfirstPipe, UnwrapAsyncPipe, clamp, clampToSrgbGamut, closest, compositeOver, computeTargetIndex, containsNode, contrastAPCA, contrastRatio, copyArrayItem, createNativeDragImage, createPointerDragSession, debouncedSignal, equals, generateUniqueId, getActiveElement, getFocusableBoundaryElements, getValue, getValueInRange, hubCompleteTransition, hubFocusTrap, hubRunTransition, hubTooltipAdapter, interpolateString, isDefined, isInSrgbGamut, isInteger, isNumber, isObject, isPromise, isString, isValidColor, maxSrgbChroma, mergeDeep, moveItemInArray, oklchToRgb, padNumber, parseColor, provideHubTooltip, provideHubTranslation, provideHubTranslationAdapter, readableOn, reflow, regExpEscape, registerOverlayKeydown, relativeLuminance, removeAccents, resolveDropPosition, resolveHubAccent, rgbToOklch, runInZone, toAbsoluteIndex, toHex, toInteger, toRgb, toString, transferArrayItem };
 //# sourceMappingURL=ng-hub-ui-utils.mjs.map