@stack-spot/ai-chat-widget 1.38.2-beta.2 → 2.0.0-beta.1

package/src/components/OverlayMenu.tsx

@@ -1,133 +0,0 @@
-/* eslint-disable react/display-name */
-import { IconBox, Text } from '@citric/core'
-import { useKeyboardControls } from '@stack-spot/portal-components'
-import { theme, WithStyle } from '@stack-spot/portal-theme'
-import { forwardRef, RefObject, useCallback, useRef } from 'react'
-import { styled } from 'styled-components'
-import { ButtonAction, WithChildren } from '../types'
-import { Tooltip } from './Tooltip'
-import { useTooltip } from './Tooltip/context'
-import { TooltipPosition } from './Tooltip/types'
-
-interface Props extends WithStyle, WithChildren {
-  /**
-   * The position of the menu relative to its children.
-   */
-  position?: TooltipPosition,
-  /**
-   * The actions of the menu.
-   */
-  actions: ButtonAction[],
-}
-
-interface MenuProps {
-  /**
-   * The actions of the menu.
-   */
-  actions: ButtonAction[],
-  /**
-   * A reference to the HTML element that triggered the menu.
-   */
-  trigger: RefObject<HTMLDivElement>,
-}
-
-const MenuList = styled.ul`
-  margin: 0;
-  padding: 0;
-  list-style: none;
-  border-radius: 8px;
-  background-color: ${theme.color.light[400]};
-  overflow: hidden;
-  display: flex;
-  flex-direction: column;
-
-  > li {
-    display: flex;
-    flex-direction: column;
-
-    > button {
-      padding: 8px 12px;
-      transition: background-color 0.2s;
-      cursor: pointer;
-      display: flex;
-      flex-direction: row;
-      align-items: center;
-      gap: 8px;
-      background-color: transparent;
-      border: none;
-      outline: none;
-
-      &:hover, &:focus {
-        background-color: ${theme.color.light[500]};
-      }
-    }
-  }
-`
-
-const StyledButton = styled.button<{ $color: string | undefined }>`
-  color: ${({ $color }) => $color || theme.color.light.contrastText};
-
-  svg {
-    fill: ${({ $color }) => $color || theme.color.light.contrastText};
-  }
-`
-
-const Menu = ({ actions, trigger }: MenuProps) => {
-  const tooltip = useTooltip()
-  const ref = useRef<HTMLUListElement>(null)
-
-  useKeyboardControls({
-    querySelectors: 'button',
-    onPressEscape: () => {
-      tooltip.hide()
-      trigger.current?.focus()
-    },
-    ref,
-  }, [])
-
-  return (
-    <MenuList ref={ref}>
-      {actions.map(({ label, onClick, className, color, icon, style }) => (
-        <li key={label} className={className} style={style}>
-          <StyledButton $color={color} onClick={() => {
-            onClick()
-            tooltip.hide()
-          }}>
-            <IconBox>{icon}</IconBox>
-            <Text>{label}</Text>
-          </StyledButton>
-        </li>
-      ))}
-    </MenuList>
-  )
-}
-
-/**
- * A floating menu that shows up when the user clicks the children.
- * 
- * This uses the tooltip component to build the menu.
- */
-export const OverlayMenu = forwardRef<HTMLDivElement, Props>(({ actions, children, className, position, style }, externalRef) => {
-  const localRef = useRef<HTMLDivElement>(null)
-  const ref = externalRef as RefObject<HTMLDivElement> ?? localRef
-  const tooltip = useTooltip()
-
-  const onShow = useCallback(() => {
-    tooltip.tooltipRef.current?.querySelector('button')?.focus()
-  }, [])
-
-  return (
-    <Tooltip
-      content={<Menu actions={actions} trigger={ref} />}
-      custom
-      position={position}
-      className={className}
-      style={style}
-      triggeredBy="click"
-      onShow={onShow}
-      ref={ref}
-    >
-      {children}
-    </Tooltip>
-  )
-})

package/src/components/ProgressBar.tsx

@@ -1,183 +0,0 @@
-import { listToClass, theme, WithStyle } from '@stack-spot/portal-theme'
-import { styled } from 'styled-components'
-
-interface Props extends WithStyle {
-  /**
-   * Apply animation effects to the progress bar.
-   */
-  animate?: boolean,
-  /**
-   * Whether or not the progress bar is visible.
-   */
-  visible?: boolean,
-  /**
-   * When true, the progress bar becomes very colorful and bright.
-   */
-  shimmer?: boolean,
-  /**
-   * Color to use in the progress bar that appears in the foreground. Arrays create linear gradients.
-   * @default primary.500 if shimmer is false, white otherwise.
-   */
-  foregroundColor?: string | string[],
-  /**
-   * Color to use in the progress bar that appears in the background. Arrays create linear gradients.
-   * @default light.500 if shimmer is false, a transparent white otherwise.
-   */
-  backgroundColor?: string | string[],
-  /**
-   * Only useful if `shimmer` is true. This allows to customize the colors in the shimmering effect. Arrays create linear gradients.
-   * @default ['#ff6633', '#d668cd', '#ff6633', '#FFF8', '#299cf4']
-   */
-  shimmerColor?: string | string[],
-}
-
-function gradientFromColorArray(colors: string[]) {
-  if (colors.length === 1) return colors[0]
-  const step = 100 / (colors.length - 1)
-  const partials: string[] = []
-  let current = 0
-  for (const color of colors) {
-    partials.push(`${color} ${Math.ceil(current)}%`)
-    current += step
-  }
-  return `linear-gradient(to right, ${partials.join(', ')})`
-}
-
-// the shimmering effect requires more space
-const SHIMMER_PADDING = '10px'
-
-const Styled = styled.div<{ $bg: string[], $fg: string[], $shimmer: string[], $animate?: boolean }>`
-  /* margin: ${({ $shimmer }) => $shimmer.length > 0 ? '7px 0' : '0'}; */
-  opacity: 0;
-  transition: opacity 0.5s;
-
-  &.visible {
-    opacity: 1;
-  }
-
-  .shimmer {
-    display: flex;
-    flex-direction: column;
-    justify-content: center;
-    height: 10px;
-    position: relative;
-    padding: 0 ${SHIMMER_PADDING};
-    margin: 3px 0;
-
-    .progress-glow {
-      filter: blur(2px);
-      position: absolute;
-      top: 0;
-      left: ${SHIMMER_PADDING};
-      bottom: 0;
-      right: ${SHIMMER_PADDING};
-      display: flex;
-      flex-direction: column;
-      justify-content: center;
-      overflow: hidden;
-
-      &::before {
-        content: '';
-        height: 3px;
-        display: block;
-        width: 33%;
-        display: block;
-        animation: slide 3s infinite forwards;
-        background: ${({ $fg }) => gradientFromColorArray($fg)};
-      }
-    }
-
-    .colors {
-      position: absolute;
-      top: 0;
-      bottom: 0;
-      left: 0;
-      right: 0;
-      overflow: hidden;
-      filter: blur(10px);
-
-      ${({ $shimmer }) => `
-        &:before {
-          content: '';
-          position: absolute;
-          top: 0;
-          bottom: 0;
-          width: ${$shimmer.length * 100}%;
-          background: ${gradientFromColorArray($shimmer)};
-          ${$shimmer.length > 2 ? `animation: shimmer-slide ${$shimmer.length}s ease-in infinite alternate;` : ''}
-        }
-          
-        @keyframes shimmer-slide {
-          from {
-            left: 0;
-          }
-          to {
-            left: -${($shimmer.length - 1) * 100}%;
-          }
-        }
-      `}
-    }
-  }
-
-  .progress-bar {
-    height: 2px;
-    width: 100%;
-    background: ${({ $bg }) => gradientFromColorArray($bg)};
-    position: relative;
-    overflow-x: clip;
-
-    &:before {
-      content: '';
-      display: block;
-      width: 100%;
-      height: 100%;
-      background: ${({ $fg, $animate, $bg }) => $animate ? gradientFromColorArray($fg) : $bg};
-      animation: ${({ $animate }) => $animate ? 'slide .5s infinite forwards' : 'none'};
-    }
-
-    @keyframes slide {
-      from {
-        margin-left: -100%;
-      }
-      to {
-        margin-left: 100%;
-      }
-    }
-  }
-`
-
-/**
- * A progress bar with indefinite progress report. This renders a narrower bar on top of larger one that animates from the left to the
- * right.
- */
-export const ProgressBar = ({
-  animate,
-  visible = true,
-  shimmer,
-  backgroundColor = shimmer ? 'rgba(255, 255, 255, 0.4)' : theme.color.light[500],
-  foregroundColor = shimmer ? ['#FFF0', '#FFF', '#FFF0'] : theme.color.primary[500],
-  shimmerColor = ['#ff6633', '#d668cd', '#ff6633', '#FFF8', '#299cf4'],
-  className,
-  style,
-}: Props) => {
-  const $bg = Array.isArray(backgroundColor) ? backgroundColor : [backgroundColor]
-  const $fg = Array.isArray(foregroundColor) ? foregroundColor : [...$bg, foregroundColor, ...$bg]
-  const $shimmer = Array.isArray(shimmerColor) ? shimmerColor : [shimmerColor]
-  const progress = <div className="progress-bar"></div>
-  const result = shimmer 
-    ? (
-      <div className={listToClass([shimmer && 'shimmer'])}>
-        <div className="colors"></div>
-        <div className="progress-glow"></div>
-        {progress}
-      </div>
-    )
-    : progress
-  return (
-    <Styled 
-      className={listToClass([className, visible && 'visible'])} 
-      style={style} $fg={$fg} $bg={$bg} $shimmer={$shimmer} $animate={animate}>
-      {result}
-    </Styled>
-  )
-}

package/src/components/Tooltip/Tooltip.tsx

@@ -1,78 +0,0 @@
-/* eslint-disable react/display-name */
-import { Text } from '@citric/core'
-import { WithStyle } from '@stack-spot/portal-theme'
-import { forwardRef } from 'react'
-import { WithChildren } from '../../types'
-import { useTooltip } from './context'
-import { DefaultTooltip } from './style'
-import { TooltipPosition } from './types'
-
-interface Props extends WithChildren, WithStyle {
-  /**
-   * The content of the tooltip. Can be either a string or a Rect Element.
-   */
-  content: React.ReactNode,
-  /**
-   * Where to position the tooltip relative to the element that triggered it.
-   */
-  position?: TooltipPosition,
-  /**
-   * A tooltip can be triggered either by hovering an element or by clicking it.
-   * @default 'hover'
-   */
-  triggeredBy?: 'click' | 'hover',
-  /**
-   * If true, no style is applied to the tooltip, letting you customize it however you want to.
-   */
-  custom?: boolean,
-  /**
-   * Function to run whenever the tooltip is shown.
-   */
-  onShow?: () => void,
-  /**
-   * Function to run whenever the tooltip is hidden.
-   */
-  onHide?: () => void,
-}
-
-/**
- * Shows a tooltip for its children. This tooltip element is always reused and placed at a root level in order to not be cut out by
- * hidden overflows in the children and its ascendants.
- */
-export const Tooltip = forwardRef<HTMLDivElement, Props>((
-  { content, custom, position, triggeredBy = 'hover', onHide, onShow, children, className, style },
-  ref,
-) => {
-  const api = useTooltip()
-
-  async function show(e: React.UIEvent, hideOnClickOutside?: boolean) {
-    await api.show({
-      content: custom ? content : <DefaultTooltip><Text appearance="microtext1">{content}</Text></DefaultTooltip>,
-      anchor: e.target as HTMLElement,
-      position,
-      hideOnClickOutside,
-    })
-    onShow?.()
-  }
-
-  function hide() {
-    api.hide()
-    onHide?.()
-  }
-
-  return (
-    <div
-      {...(triggeredBy === 'hover'
-        ? { onMouseEnter: show, onMouseLeave: hide }
-        : { onClick: (e) => show(e, true), onKeyDown: (e) => e.key === 'Enter' && show(e, true) }
-      )}
-      className={className}
-      style={style}
-      tabIndex={triggeredBy === 'click' ? 0 : undefined}
-      role={triggeredBy === 'click' ? 'button' : undefined}
-      ref={ref}
-    >
-      {children}
-    </div>
-  )
-})

package/src/components/Tooltip/TooltipAPI.ts

@@ -1,101 +0,0 @@
-import { delay } from '@stack-spot/portal-components'
-import { animationTimeMS } from './style'
-import { ShowOptions } from './types'
-
-// the maximum amount of pixels a tooltip can get close to the screen edges.
-const MARGIN_TO_CORNERS_PX = 10
-
-function isRelative(element: HTMLElement) {
-  return ['relative', 'absolute', 'fixed'].includes(element.computedStyleMap().get('position')?.toString() ?? '')
-}
-
-/**
- * Allows interaction with the tooltip element.
- * 
- * This places the tooltip element at the correct place, shows it, hides it and manages its contents.
- * 
- * This also takes into account the screen edges, making adjustments to the tooltip position if it would overflow the screen.
- */
-export class TooltipAPI {
-  /**
-   * A reference to the tooltip element in the HTML tree.
-   */
-  tooltipRef: React.RefObject<HTMLDivElement>
-  private setContent: React.Dispatch<React.SetStateAction<React.ReactNode>>
-  private hideTimeoutId: number | undefined
-  private clickListener: ((e: MouseEvent) => void) | undefined
-  private relativeTo: HTMLElement | undefined
-
-  constructor(tooltipRef: React.RefObject<HTMLDivElement>, setContent: React.Dispatch<React.SetStateAction<React.ReactNode>>) {
-    this.tooltipRef = tooltipRef
-    this.setContent = setContent
-  }
-
-  private computeRelativeTo() {
-    if (this.relativeTo) return
-    this.relativeTo = this.tooltipRef.current?.parentElement as HTMLElement
-    while (this.relativeTo && this.relativeTo !== document.body && !isRelative(this.relativeTo)) {
-      this.relativeTo = this.relativeTo.parentElement as HTMLElement
-    }
-  }
-
-  /**
-   * Shows the tooltip with `content`. Its position is based on `position` and the position of the element referred by `anchor`.
-   */
-  async show({ content, anchor, position = 'bottom', hideOnClickOutside }: ShowOptions) {
-    window.clearTimeout(this.hideTimeoutId)
-    this.hideTimeoutId = undefined
-    if (this.clickListener) document.removeEventListener('click', this.clickListener)
-    this.setContent(content)
-    await delay(10)
-    if (!this.tooltipRef.current) return
-    const anchorRect = anchor.getClientRects()[0]
-    this.tooltipRef.current.classList.add('visible')
-    const tooltipWidth = this.tooltipRef.current.clientWidth
-    const tooltipHeight = this.tooltipRef.current.clientHeight
-    let top = 0
-    let left = 0
-    if (position === 'left' || position === 'right') {
-      top = anchorRect.top + anchorRect.height / 2 - tooltipHeight / 2
-      if (position === 'left') left = anchorRect.left - tooltipWidth
-      else left = anchorRect.left + anchorRect.width
-    } else {
-      left = anchorRect.left + anchorRect.width / 2 - tooltipWidth / 2
-      if (position === 'top') top = anchorRect.top - tooltipHeight
-      else top = anchorRect.top + anchorRect.height
-    }
-    // takes the parent the tooltip is positioned relative to into consideration
-    this.computeRelativeTo()
-    const relativeRect = this.relativeTo?.getClientRects()[0] ?? { top: 0, left: 0 }
-    top -= relativeRect.top
-    left -= relativeRect.left
-    // adjusts positions in order to avoid overflowing the window and leaving a margin to the corners
-    if (top <= 0) top += MARGIN_TO_CORNERS_PX
-    else if (top + tooltipHeight >= document.body.clientHeight - MARGIN_TO_CORNERS_PX) {
-      top = document.body.clientHeight - MARGIN_TO_CORNERS_PX + tooltipHeight
-    }
-    if (left <= 0) left += MARGIN_TO_CORNERS_PX
-    else if (left + tooltipWidth >= document.body.clientWidth - MARGIN_TO_CORNERS_PX) {
-      left = document.body.clientWidth - MARGIN_TO_CORNERS_PX - tooltipWidth
-    }
-    this.tooltipRef.current.style.top = `${top}px`
-    this.tooltipRef.current.style.left = `${left}px`
-    if (hideOnClickOutside) {
-      this.clickListener = (e: MouseEvent) => {
-        if (this.tooltipRef.current?.contains(e.target as HTMLElement)) return
-        this.hide()
-      }
-      document.addEventListener('click', this.clickListener)
-    }
-  }
-
-  /**
-   * Hides the tooltip. After the animation, the content is removed.
-   */
-  hide(): void {
-    if (!this.tooltipRef.current) return
-    this.tooltipRef.current.classList.remove('visible')
-    this.hideTimeoutId = window.setTimeout(() => this.setContent(undefined), animationTimeMS)
-    if (this.clickListener) document.removeEventListener('click', this.clickListener)
-  }
-}

package/src/components/Tooltip/context.tsx

@@ -1,24 +0,0 @@
-import { createContext, useContext, useMemo, useRef, useState } from 'react'
-import { WithChildren } from '../../types'
-import { TooltipBox } from './style'
-import { TooltipAPI } from './TooltipAPI'
-
-const Context = createContext<TooltipAPI | undefined>(undefined)
-
-export const TooltipProvider = ({ children }: Required<WithChildren>) => {
-  const ref = useRef<HTMLDivElement>(null)
-  const [content, setContent] = useState<React.ReactNode>()
-  const api = useMemo(() => new TooltipAPI(ref, setContent), [])
-  return (
-    <Context.Provider value={api}>
-      {children}
-      <TooltipBox ref={ref}>{content}</TooltipBox>
-    </Context.Provider>
-  )
-}
-
-export function useTooltip() {
-  const api = useContext(Context)
-  if (!api) throw new Error('In order to use tooltips, you must wrap your content in a <TooltipProvider>.')
-  return api
-}

package/src/components/Tooltip/index.ts

@@ -1,2 +0,0 @@
-export { TooltipProvider } from './context'
-export { Tooltip } from './Tooltip'

package/src/components/Tooltip/style.tsx

@@ -1,24 +0,0 @@
-import { theme } from '@stack-spot/portal-theme'
-import { styled } from 'styled-components'
-
-export const animationTimeMS = 300
-
-export const TooltipBox = styled.div`
-  position: absolute;
-  opacity: 0;
-  transition: opacity ${animationTimeMS/ 1000}s;
-  top: 0;
-  left: 0;
-
-  &.visible {
-    opacity: 1;
-  }
-`
-
-export const DefaultTooltip = styled.div`
-  padding: 4px 8px;
-  background-color: ${theme.color.inverse[500]};
-  color: ${theme.color.inverse.contrastText};
-  border-radius: 6px;
-  margin: 6px;
-`

package/src/components/Tooltip/types.ts

@@ -1,28 +0,0 @@
-export type TooltipPosition = 'left' | 'right' | 'top' | 'bottom'
-
-export interface BoxPosition {
-  x1: number,
-  x2: number,
-  y1: number,
-  y2: number,
-}
-
-export interface ShowOptions {
-  /**
-   * The content of the tooltip. Can be either a string or a React Element.
-   */
-  content: React.ReactNode,
-  /**
-   * The anchor to the tooltip. This is part of what defines the position where the tooltip will appear.
-   */
-  anchor: HTMLElement,
-  /**
-   * The position relative to the element referred by `anchor`.
-   * @default bottom
-   */
-  position?: TooltipPosition,
-  /**
-   * Whether or not to hide the tooltip when a click is detected outside of it.
-   */
-  hideOnClickOutside?: boolean,
-}