PillarConfig

interface EdgeTriggerConfig {
  /**
   * Whether to show the edge trigger sidebar tab.
   * When enabled, a slim vertical tab appears on the screen edge that opens the panel.
   * @default true
   */
  enabled?: boolean;
  /**
   * Whether the panel can be resized by dragging the edge of the sidebar trigger.
   * When enabled, a drag handle appears on the inner edge of the sidebar when the panel is open.
   * The resized width is persisted to localStorage.
   * @default true
   */
  resizable?: boolean;
}

interface MobileTriggerConfig {
  /**
   * Whether to show the mobile floating button on small screens.
   * When enabled, a floating action button appears when viewport is below mobileBreakpoint.
   * @default true
   */
  enabled?: boolean;
  /**
   * Viewport width below which the edge trigger hides and mobile trigger shows.
   * @default 700
   */
  breakpoint?: number;
  /**
   * Position of the floating button.
   * @default 'bottom-right'
   */
  position?: MobileTriggerPosition;
  /**
   * Preset icon to display in the button.
   * @default 'sparkle'
   */
  icon?: MobileTriggerIcon;
  /**
   * Custom SVG icon string. Overrides the icon preset if provided.
   */
  customIcon?: string;
  /**
   * Background color of the button (CSS value).
   * Defaults to the theme's primary color.
   */
  backgroundColor?: string;
  /**
   * Icon color (CSS value).
   * @default 'white'
   */
  iconColor?: string;
  /**
   * Button size - preset name or pixel value.
   * - 'small': 44px
   * - 'medium': 56px (default)
   * - 'large': 68px
   * @default 'medium'
   */
  size?: MobileTriggerSize | number;
  /**
   * Tooltip text and aria-label for accessibility.
   * @default 'Get help'
   */
  label?: string;
  /**
   * Offset from screen edges in pixels.
   * @default 24
   */
  offset?: number;
}

type MobileTriggerPosition = 'bottom-right' | 'bottom-left'

type MobileTriggerIcon = 'sparkle' | 'question' | 'help' | 'chat' | 'support'

type MobileTriggerSize = 'small' | 'medium' | 'large'

interface UrlParamsConfig {
  /** Whether to check URL params for auto-opening the panel (default: true) */
  enabled?: boolean;
  /** Prefix for URL params (default: 'pillar-') */
  prefix?: string;
  /** Whether to clear URL params after opening (default: true) */
  clearAfterOpen?: boolean;
}

interface InteractionHighlightConfig {
  /**
   * Whether to highlight elements when the AI interacts with them.
   * @default true
   */
  enabled?: boolean;
  /**
   * Outline color for highlighted elements (CSS color value).
   * @default '#3b82f6' (blue-500)
   */
  outlineColor?: string;
  /**
   * Outline width in pixels.
   * @default 2
   */
  outlineWidth?: number;
  /**
   * Outline offset in pixels (space between element and outline).
   * @default 2
   */
  outlineOffset?: number;
  /**
   * Duration in milliseconds to show the highlight.
   * Set to 0 for no auto-removal (highlight stays until next interaction).
   * @default 2000
   */
  duration?: number;
  /**
   * Whether to scroll the element into view if not visible.
   * @default true
   */
  scrollIntoView?: boolean;
  /**
   * Scroll behavior when scrolling element into view.
   * @default 'smooth'
   */
  scrollBehavior?: ScrollBehavior;
}

interface SuggestionsConfig {
  /**
   * Enable page-aware suggestion sorting.
   * When enabled, suggestions are re-sorted based on the current page context
   * whenever the user navigates to a new route.
   * @default true
   */
  enabled?: boolean;
  /**
   * Debounce time for route change detection (ms).
   * Prevents excessive sorting on rapid navigation.
   * @default 100
   */
  debounceMs?: number;
  /**
   * Maximum number of suggestions to display.
   * @default 3
   */
  displayLimit?: number;
}

interface SidebarTabConfig {
  id: string;
  label: string;
  enabled: boolean;
  order: number;
  /** Preset icon for this tab */
  icon?: 'help' | 'support' | 'settings' | 'feedback' | 'chat' | 'calendar' | 'mail';
}