dineeek / ngx-libs-workspace / 24940704470

97%

push

github

feat: add ngx-overflow-tooltip (#51)

* feat(ngx-overflow-tooltip): scaffold lib (config only)

Add Nx project scaffold for the next ngx-* lib — a standalone directive
that detects when a host element's text is ellipsized:
- package.json with @angular/common + @angular/core peer deps
  (>=21.0.0 <22.0.0); no @angular/forms — this is a directive, not a
  form-field
- project.json, ng-package.json, tsconfig set, jest + eslint configs
- empty src/index.ts placeholder; the directive lands in the next commit

* feat(ngx-overflow-tooltip): standalone directive with isTruncated signal

Implement OverflowTooltipDirective — a standalone directive that detects
when a host element's text is ellipsized and exposes a reactive
isTruncated signal so consumers can wire any tooltip surface (Angular
Material, custom popover, etc.) to fire only when content actually
overflows.

- modes: auto (default — checks both axes), single (width only), multi
  (height only). Aliased so [ngxOverflowTooltip]="'single'" configures
  the mode inline.
- ResizeObserver re-measures on layout changes; MutationObserver
  re-measures on textContent / DOM-tree mutations — the prototype this
  was extracted from only handled the resize axis.
- rAF coalescing collapses back-to-back observer triggers into one
  measurement.
- Observers run outside the Angular zone; only signal.set re-enters when
  the value flips.
- afterNextRender for setup, DestroyRef for teardown — works under
  zoneless Angular.
- SSR-safe: skips wiring entirely when ResizeObserver is missing.
- exportAs: 'ngxOverflowTooltip' so the template can read the signal via
  a ref (#oft="ngxOverflowTooltip").
- truncatedChange output for code-side consumers.

No Angular Material peer dep — composition pattern with MatTooltip is
documented in the JSDoc.

* test(ngx-overflow-tooltip): directive specs with mocked observers

Cover the directive end-to-end under jsdom (which has no real layout):
- mock ResizeObserver, MutationObserver, ... (continued)

630 of 668 branches covered (94.31%)

Branch coverage included in aggregate %.

44 of 44 new or added lines in 1 file covered. (100.0%)

785 of 791 relevant lines covered (99.24%)

96.82 hits per line