@aquera/nile-elements 1.4.2-beta-1.0 → 1.4.3-beta-1.0

package/package.json

@@ -3,7 +3,7 @@
   "description": "Webcomponent nile-elements following open-wc recommendations",
   "license": "MIT",
   "author": "nile-elements",
-  "version": "1.4.2-beta-1.0",
+  "version": "1.4.3-beta-1.0",
   "main": "dist/src/index.js",
   "type": "module",
   "module": "dist/src/index.js",

package/src/index.ts

@@ -46,6 +46,8 @@ export { NileBreadcrumb } from './nile-breadcrumb';
 export { NileBreadcrumbItem } from './nile-breadcrumb-item';
 export { NileFormGroup } from './nile-form-group';
 export { NileCard } from './nile-card';
+export { NileCarousel } from './nile-carousel';
+export { NileCarouselItem } from './nile-carousel/nile-carousel-item';
 export { NilePopover } from './nile-popover';
 export { NileButtonFilter } from './nile-button-filter';
 export { NileCircularProgressbar } from './nile-circular-progressbar';

package/src/nile-auto-complete/nile-auto-complete.ts

@@ -269,7 +269,10 @@ enableTabClose: this.enableTabClose,
 
   getItemRenderFunction(item: any): TemplateResult {
     const value = this.renderItemFunction(item);
-    const strValue = value ? value.toString() : "";
+    let strValue = "";
+    if(value || typeof value === "number") {
+        strValue = value.toString();
+    }
     const hasTooltip = !!item.tooltip;
     const shouldShowTooltip =
       hasTooltip && (!item.tooltip.for || item.tooltip.for === 'menu');

package/src/nile-carousel/carousel-helpers.ts

@@ -0,0 +1,137 @@
+/**
+ * Copyright Aquera Inc 2025
+ *
+ * This source code is licensed under the BSD-3-Clause license found in the
+ * LICENSE file in the root directory of this source tree.
+ */
+
+import type NileCarouselItem from './nile-carousel-item/nile-carousel-item';
+import { clamp } from '../internal/math';
+import { prefersReducedMotion } from '../internal/animate';
+
+export function isCarouselItem(element: HTMLElement): boolean {
+  return element.tagName.toLowerCase() === 'nile-carousel-item';
+}
+
+export function findMostVisibleSlide(
+  slides: NileCarouselItem[],
+  scrollContainer: HTMLElement
+): NileCarouselItem | null {
+  if (!slides.length || !scrollContainer) {
+    return null;
+  }
+
+  const scrollContainerRect = scrollContainer.getBoundingClientRect();
+  let mostVisibleSlide: NileCarouselItem | null = null;
+  let maxVisibleArea = 0;
+
+  slides.forEach((slide) => {
+    const slideRect = slide.getBoundingClientRect();
+    const visibleWidth = Math.max(
+      0,
+      Math.min(slideRect.right, scrollContainerRect.right) - Math.max(slideRect.left, scrollContainerRect.left)
+    );
+
+    if (visibleWidth > maxVisibleArea) {
+      maxVisibleArea = visibleWidth;
+      mostVisibleSlide = slide;
+    }
+  });
+
+  return mostVisibleSlide;
+}
+
+export function getPageCount(slidesCount: number, slidesPerPage: number, slidesPerMove: number): number {
+  const pages = (slidesCount - slidesPerPage) / slidesPerMove + 1;
+  return Math.ceil(pages);
+}
+
+export function getCurrentPage(activeSlide: number, slidesPerMove: number): number {
+  return Math.ceil(activeSlide / slidesPerMove);
+}
+
+export function canScrollNext(currentPage: number, pageCount: number): boolean {
+  return currentPage < pageCount - 1;
+}
+
+export function canScrollPrev(currentPage: number): boolean {
+  return currentPage > 0;
+}
+
+export function shouldSnapToSlide(slideIndex: number, slidesPerMove: number): boolean {
+  return (slideIndex + slidesPerMove) % slidesPerMove === 0;
+}
+
+export function calculateScrollPosition(
+  slideRect: DOMRect,
+  containerRect: DOMRect,
+  containerScrollLeft: number,
+  containerScrollTop: number
+): { left: number; top: number } {
+  const nextLeft = slideRect.left - containerRect.left;
+  const nextTop = slideRect.top - containerRect.top;
+
+  return {
+    left: nextLeft + containerScrollLeft,
+    top: nextTop + containerScrollTop
+  };
+}
+
+export function scrollToSlide(
+  slide: HTMLElement,
+  scrollContainer: HTMLElement,
+  behavior: ScrollBehavior = 'smooth',
+  setPendingSlideChange: (value: boolean) => void
+): void {
+  setPendingSlideChange(true);
+  window.requestAnimationFrame(() => {
+    if (!scrollContainer) {
+      return;
+    }
+
+    const scrollContainerRect = scrollContainer.getBoundingClientRect();
+    const nextSlideRect = slide.getBoundingClientRect();
+
+    const nextLeft = nextSlideRect.left - scrollContainerRect.left;
+    const nextTop = nextSlideRect.top - scrollContainerRect.top;
+
+    if (nextLeft || nextTop) {
+      const scrollPosition = calculateScrollPosition(
+        nextSlideRect,
+        scrollContainerRect,
+        scrollContainer.scrollLeft,
+        scrollContainer.scrollTop
+      );
+
+      setPendingSlideChange(true);
+      scrollContainer.scrollTo({
+        left: scrollPosition.left,
+        top: scrollPosition.top,
+        behavior
+      });
+    } else {
+      setPendingSlideChange(false);
+    }
+  });
+}
+
+export function goToSlide(
+  index: number,
+  slides: HTMLElement[],
+  slidesPerPage: number,
+  behavior: ScrollBehavior = 'smooth'
+): { newActiveSlide: number; slideToScroll: HTMLElement } | null {
+  if (!slides.length) {
+    return null;
+  }
+
+  const newActiveSlide = clamp(index, 0, slides.length - slidesPerPage);
+  const nextSlideIndex = clamp(index, 0, slides.length - 1);
+  const nextSlide = slides[nextSlideIndex];
+
+  return {
+    newActiveSlide,
+    slideToScroll: nextSlide
+  };
+}
+

package/src/nile-carousel/index.ts

@@ -0,0 +1,2 @@
+export { NileCarousel } from './nile-carousel';
+

package/src/nile-carousel/nile-carousel-item/index.ts

@@ -0,0 +1,2 @@
+export { NileCarouselItem } from './nile-carousel-item';
+

package/src/nile-carousel/nile-carousel-item/nile-carousel-item.css.ts

@@ -0,0 +1,33 @@
+/**
+ * Copyright Aquera Inc 2025
+ *
+ * This source code is licensed under the BSD-3-Clause license found in the
+ * LICENSE file in the root directory of this source tree.
+ */
+
+import { css } from 'lit';
+
+/**
+ * CarouselItem CSS
+ */
+export const styles = css`
+  :host {
+    display: block;
+    scroll-snap-align: start;
+    scroll-snap-stop: always;
+  }
+
+  .carousel-item {
+    display: flex;
+    flex-direction: column;
+    height: 100%;
+    width: 100%;
+  }
+
+  :host([hidden]) {
+    display: none;
+  }
+`;
+
+export default [styles];
+

package/src/nile-carousel/nile-carousel-item/nile-carousel-item.ts

@@ -0,0 +1,42 @@
+/**
+ * Copyright Aquera Inc 2025
+ *
+ * This source code is licensed under the BSD-3-Clause license found in the
+ * LICENSE file in the root directory of this source tree.
+ */
+
+import { html, CSSResultArray, TemplateResult } from 'lit';
+import { customElement } from 'lit/decorators.js';
+import { styles } from './nile-carousel-item.css';
+import NileElement from '../../internal/nile-element';
+
+/**
+ * Nile carousel-item component.
+ *
+ * @tag nile-carousel-item
+ *
+ */
+@customElement('nile-carousel-item')
+export class NileCarouselItem extends NileElement {
+ 
+  public static get styles(): CSSResultArray {
+    return [styles];
+  }
+
+  public render(): TemplateResult {
+    return html`
+      <div part="base" class="carousel-item">
+        <slot></slot>
+      </div>
+    `;
+  }
+}
+
+export default NileCarouselItem;
+
+declare global {
+  interface HTMLElementTagNameMap {
+    'nile-carousel-item': NileCarouselItem;
+  }
+}
+

package/src/nile-carousel/nile-carousel.css.ts

@@ -0,0 +1,161 @@
+/**
+ * Copyright Aquera Inc 2025
+ *
+ * This source code is licensed under the BSD-3-Clause license found in the
+ * LICENSE file in the root directory of this source tree.
+ */
+
+import { css } from 'lit';
+
+/**
+ * Carousel CSS
+ */
+export const styles = css`
+  :host {
+    --slide-gap: var(--nile-spacing-md, var(--ng-spacing-md));
+    display: block;
+    position: relative;
+  }
+
+  .carousel {
+    display: flex;
+    flex-direction: column;
+    position: relative;
+  }
+
+  .carousel__content-wrapper {
+    display: flex;
+    align-items: center;
+    gap: var(--nile-spacing-sm, var(--ng-spacing-sm));
+    width: 100%;
+  }
+
+  .carousel__slides {
+    display: flex;
+    flex-direction: row;
+    overflow-x: auto;
+    overflow-y: hidden;
+    scroll-snap-type: x mandatory;
+    scroll-behavior: smooth;
+    gap: var(--slide-gap);
+    padding: 0;
+    scrollbar-width: none;
+    -ms-overflow-style: none;
+    flex: 1;
+    min-width: 0;
+  }
+
+  .carousel__slides::-webkit-scrollbar {
+    display: none;
+  }
+
+  .carousel__slides:focus {
+    outline: none;
+  }
+
+  .carousel__slides:focus-visible {
+    outline: 2px solid var(--nile-colors-primary-600, var(--ng-colors-text-brand-secondary-700));
+    outline-offset: 2px;
+  }
+
+  ::slotted(nile-carousel-item) {
+    flex: 0 0 calc((100% - (var(--slides-per-page) - 1) * var(--slide-gap)) / var(--slides-per-page));
+    min-width: 0;
+  }
+
+  .carousel__navigation-button {
+    display: inline-flex;
+    align-items: center;
+    justify-content: center;
+    width: 2.5rem;
+    height: 2.5rem;
+    padding: 0;
+    background: rgba(255, 255, 255, 0.9);
+    border: 1px solid var(--nile-colors-dark-200, var(--ng-colors-border-secondary));
+    border-radius: 50%;
+    color: var(--nile-colors-dark-900, var(--ng-colors-text-primary-900));
+    cursor: pointer;
+    flex-shrink: 0;
+    transition: background-color 0.15s ease, border-color 0.15s ease, color 0.15s ease, transform 0.15s ease;
+    box-shadow: 0 2px 8px rgba(0, 0, 0, 0.1);
+  }
+
+  .carousel__navigation-button:hover:not(.carousel__navigation-button--disabled) {
+    background: rgba(255, 255, 255, 1);
+    border-color: var(--nile-colors-neutral-400, var(--ng-colors-border-tertiary));
+    transform: scale(1.1);
+    box-shadow: 0 4px 12px rgba(0, 0, 0, 0.15);
+  }
+
+  .carousel__navigation-button:active:not(.carousel__navigation-button--disabled) {
+    background: rgba(255, 255, 255, 1);
+    transform: scale(0.95);
+  }
+
+  .carousel__navigation-button--disabled {
+    opacity: 0.4;
+    cursor: not-allowed;
+    pointer-events: none;
+  }
+
+  .carousel__navigation-button:focus {
+    outline: none;
+  }
+
+  .carousel__navigation-button:focus-visible {
+    outline: 2px solid var(--nile-colors-primary-600, var(--ng-colors-text-brand-secondary-700));
+    outline-offset: 2px;
+  }
+
+  .carousel__pagination {
+    display: flex;
+    align-items: center;
+    justify-content: center;
+    gap: var(--nile-spacing-xs, var(--ng-spacing-xs));
+    margin-top: var(--nile-spacing-md, var(--ng-spacing-md));
+    position: relative;
+    z-index: 2;
+  }
+
+  .carousel__pagination-item {
+    width: 0.75rem;
+    height: 0.75rem;
+    padding: 0;
+    background: var(--nile-colors-neutral-400, var(--ng-colors-border-secondary));
+    border: 2px solid var(--nile-colors-white-base, var(--ng-colors-bg-primary));
+    border-radius: 50%;
+    cursor: pointer;
+    transition: background-color 0.1s ease, transform 0.1s ease, border-color 0.1s ease, width 0.1s ease, height 0.1s ease;
+    box-shadow: 0 1px 3px rgba(0, 0, 0, 0.2);
+  }
+
+  .carousel__pagination-item:hover {
+    background: var(--nile-colors-neutral-400, var(--ng-colors-border-tertiary));
+    transform: scale(1.15);
+    border-color: var(--nile-colors-dark-200, var(--ng-colors-border-secondary));
+  }
+
+  .carousel__pagination-item--active {
+    width: 0.875rem;
+    height: 0.875rem;
+    background: var(--nile-colors-primary-600, var(--ng-colors-text-brand-secondary-700));
+    border-color: var(--nile-colors-primary-600, var(--ng-colors-text-brand-secondary-700));
+    box-shadow: 0 2px 6px rgba(0, 0, 0, 0.3);
+  }
+
+  .carousel__pagination-item:focus {
+    outline: none;
+  }
+
+  .carousel__pagination-item:focus-visible {
+    outline: 2px solid var(--nile-colors-primary-600, var(--ng-colors-text-brand-secondary-700));
+    outline-offset: 2px;
+  }
+
+  :host([hidden]) {
+    display: none;
+  }
+`;
+
+export default [styles];
+