@eui/ecl 22.0.0-alpha.37 → 22.0.0-alpha.39

package/docs/json/EclSloganTickerComponent.md

@@ -11,8 +11,53 @@ when off-screen via IntersectionObserver.
 Uses Embla Carousel (via embla-carousel-angular) with the auto-scroll plugin
 to match the ECL vanilla implementation.
 
-The component clones projected slides internally to ensure the track is wide
-enough for seamless infinite scrolling (matching the vanilla ECL approach).
+## Why two lists (hidden source + generated track)
+
+The consumer provides a plain, semantic list:
+
+```html
+<ecl-slogan-ticker>
+  <ul eclSloganTickerList>
+    <li eclSloganTickerSlide>SLOGAN ONE</li>
+    <li eclSloganTickerSlide>SLOGAN TWO</li>
+  </ul>
+</ecl-slogan-ticker>
+```
+
+This authored `<ul eclSloganTickerList>` is NOT the list you see scrolling.
+`EclSloganTickerListDirective` hides it with `display: none`, and it stays in
+the light DOM as the single accessible source of truth. The component reads
+the slide texts out of it via a `contentChildren` query (see `slides`) and
+builds a SEPARATE, component-owned `<ul class="ecl-slogan-ticker__track">`
+from the `trackSlides` signal. That generated track is what Embla animates.
+
+Reasons for the split (rather than just scrolling the authored `<ul>`):
+
+- Seamless infinite loop needs more content than the author gives. The track
+  must be several times wider than the viewport or the loop visibly jumps, so
+  `ensureEnoughContent()` measures the originals and appends CLONE sets until
+  the total width reaches `CLONE_MULTIPLIER` × the container width.
+- Clones must not pollute accessibility. The authored list stays the one
+  accessible list; every generated clone is rendered with `aria-hidden` so a
+  screen reader announces each slogan once, not once per clone.
+- You cannot meaningfully grow the authored `<ul>`. Its `<li>` children are
+  Angular-projected content that Angular owns; imperatively appending clone
+  `<li>` nodes into it fights change detection. Building our own track signal
+  and letting `@for` render it is clean and safe. `<li>` is also only valid
+  inside a list element, so the `<ul eclSloganTickerList>` wrapper keeps the
+  consumer's authored markup valid and self-contained.
+
+This mirrors the vanilla ECL slogan ticker (hidden source list + measured,
+cloned, auto-scrolling track).
+
+## Testing note
+
+The visible track is only built after a real width measurement
+(`offsetWidth`). Under jsdom every element reports a width of 0, so
+`ensureEnoughContent()` bails early and the generated track stays empty. Unit
+tests should therefore assert slide-driven behavior through its observable
+effects (e.g. the play/pause controls appearing) rather than through the
+generated track DOM.
 
 
 **Selector:** `ecl-slogan-ticker`

package/docs/json/EclSocialMediaFollowItemComponent.md

@@ -12,7 +12,7 @@
 - **href**: `string` - 
 - **icon**: `string` - 
 - **iconSet**: `EclIconSet` - 
-- **isInverted**: `false` - 
+- **isInverted**: `boolean` - 
 - **routerLink**: `string` - 
 - **size**: `string` - 
 - **target**: `string` -