tyrell-react 1.0.0-RC6

package/src/components/TyButton.tsx

@@ -0,0 +1,145 @@
+import React, { useEffect, useRef, useCallback } from 'react';
+
+type BuiltinFlavor = 'primary' | 'secondary' | 'success' | 'danger' | 'warning' | 'neutral';
+type ShadedFlavor = BuiltinFlavor | `${BuiltinFlavor}+` | `${BuiltinFlavor}-`;
+type ButtonAppearance = 'solid' | 'outlined' | 'ghost';
+
+export interface TyButtonCSSProperties extends React.CSSProperties {
+  '--ty-button-bg'?: string;
+  '--ty-button-bg-hover'?: string;
+  '--ty-button-color'?: string;
+  '--ty-button-border'?: string;
+}
+
+export interface TyButtonProps extends Omit<React.HTMLAttributes<HTMLElement>, 'style'> {
+  style?: TyButtonCSSProperties;
+  /**
+   * Semantic styling variant. Built-in flavors get themed styles; append `+`
+   * for a stronger shade or `-` for a softer one (e.g. `"primary+"`,
+   * `"danger-"`). Any other string is passed through as-is — theme it via
+   * `--ty-button-*` CSS variables.
+   */
+  flavor?: ShadedFlavor | (string & {});
+
+  /**
+   * Visual appearance:
+   * - `"solid"` (default) — saturated brand fill with paired text color
+   * - `"outlined"` — transparent background, text === border
+   * - `"ghost"` — text only with hover background
+   */
+  appearance?: ButtonAppearance;
+
+  /** Button size */
+  size?: 'xs' | 'sm' | 'md' | 'lg' | 'xl';
+
+  /** Button type for form submission */
+  type?: 'button' | 'submit' | 'reset';
+
+  /** Disable the button */
+  disabled?: boolean;
+
+  /** Pill-shaped button (rounded ends) */
+  pill?: boolean;
+
+  /** Action (icon-only square) */
+  action?: boolean;
+
+  /** Accessible label for screen readers */
+  label?: string;
+
+  /** Form field name for form submission */
+  name?: string;
+
+  /** Form field value for form submission */
+  value?: string;
+
+  /** Full-width button */
+  wide?: boolean;
+
+  /** Button content */
+  children?: React.ReactNode;
+}
+
+export const TyButton = React.forwardRef<HTMLElement, TyButtonProps>(
+  ({
+    children,
+    type,
+    appearance,
+    disabled,
+    pill,
+    action,
+    wide,
+    label,
+    name,
+    value,
+    onClick,
+    ...props
+  }, ref) => {
+    const elementRef = useRef<HTMLElement>(null);
+
+    // Imperatively attach the click listener so onClick reliably fires for the
+    // CustomEvent('click') that <ty-button> re-dispatches on its host (the
+    // inner <button> calls stopPropagation, so React's delegated onClick can
+    // miss it). Also handles type=submit by dispatching a synthetic submit.
+    useEffect(() => {
+      const element = elementRef.current;
+      if (!element) return;
+
+      const handler = (event: Event) => {
+        if (type === 'submit') {
+          const form = element.closest('form');
+          if (form) {
+            event.preventDefault();
+            event.stopPropagation();
+            form.dispatchEvent(new Event('submit', {
+              bubbles: true,
+              cancelable: true,
+            }));
+          }
+        }
+        if (onClick) {
+          onClick(event as unknown as React.MouseEvent<HTMLElement>);
+        }
+      };
+
+      element.addEventListener('click', handler);
+      return () => {
+        element.removeEventListener('click', handler);
+      };
+    }, [type, onClick]);
+
+    useEffect(() => {
+      if (ref && elementRef.current) {
+        if (typeof ref === 'function') {
+          ref(elementRef.current);
+        } else {
+          ref.current = elementRef.current;
+        }
+      }
+    }, [ref]);
+
+    const webComponentProps: Record<string, any> = {
+      ...props,
+      ref: elementRef,
+    };
+
+    if (disabled) webComponentProps.disabled = '';
+    if (pill) webComponentProps.pill = '';
+    if (action) webComponentProps.action = '';
+    if (wide) webComponentProps.wide = '';
+
+    if (appearance) webComponentProps.appearance = appearance;
+    if (type) webComponentProps.type = type;
+    if (label) webComponentProps.label = label;
+    if (name) webComponentProps.name = name;
+    if (value) webComponentProps.value = value;
+
+    return React.createElement(
+      'ty-button',
+      webComponentProps,
+      children
+    );
+  }
+);
+
+TyButton.displayName = 'TyButton';

package/src/components/TyCalendar.tsx

@@ -0,0 +1,248 @@
+import React, { useEffect, useRef, useCallback } from 'react';
+import { needsPropertyBridge } from '../utils/react-version';
+
+// Type definitions for Ty Calendar component
+export interface TyCalendarChangeEventDetail {
+  /** Selected month (1-12) */
+  month: number;
+  /** Selected year (4-digit) */
+  year: number;
+  /** Selected day (1-31) */
+  day: number;
+  /** Action that triggered the change: "select" */
+  action: 'select';
+  /** Source of the change: "day-click" */
+  source: 'day-click';
+  /** Complete day context from the calendar month */
+  dayContext: any;
+}
+
+export interface TyCalendarNavigateEventDetail {
+  /** Navigation target month (1-12) */
+  month: number;
+  /** Navigation target year (4-digit) */
+  year: number;
+  /** Action that triggered the navigation: "navigate" */
+  action: 'navigate';
+  /** Source of the change: "navigation" */
+  source: 'navigation';
+}
+
+export interface TyCalendarProps extends Omit<React.HTMLAttributes<HTMLElement>, 'onChange'> {
+  /** Selected year (4-digit) */
+  year?: number | string;
+  
+  /** Selected month (1-12) */
+  month?: number | string;
+  
+  /** Selected day (1-31) */
+  day?: number | string;
+  
+  /** Show navigation controls */
+  showNavigation?: boolean;
+  
+  /** Stateless mode - no internal state management */
+  stateless?: boolean;
+  
+  /** Calendar size */
+  size?: 'sm' | 'md' | 'lg';
+  
+  /** Locale for date formatting */
+  locale?: string;
+  
+  /** Calendar width */
+  width?: string | number;
+  
+  /** Minimum calendar width */
+  minWidth?: string | number;
+  
+  /** Maximum calendar width */
+  maxWidth?: string | number;
+  
+  /** Form field name for form submission */
+  name?: string;
+  
+  /** Form value (ISO date string) */
+  value?: string;
+  
+  /** Function to render custom day content */
+  dayContentFn?: (dayContext: any) => HTMLElement | string;
+  
+  /** Function to determine day CSS classes */
+  dayClassesFn?: (dayContext: any) => string[];
+  
+  /** Custom CSS injection for render functions */
+  customCSS?: string;
+  
+  /** Callback when a date is selected */
+  onChange?: (event: CustomEvent<TyCalendarChangeEventDetail>) => void;
+  
+  /** Callback when navigation changes month/year */
+  onNavigate?: (event: CustomEvent<TyCalendarNavigateEventDetail>) => void;
+}
+
+// React wrapper for ty-calendar web component
+export const TyCalendar = React.forwardRef<HTMLElement, TyCalendarProps>(
+  ({ 
+    year,
+    month,
+    day,
+    showNavigation,
+    stateless,
+    size,
+    locale,
+    width,
+    minWidth,
+    maxWidth,
+    name,
+    value,
+    dayContentFn,
+    dayClassesFn,
+    customCSS,
+    onChange,
+    onNavigate,
+    ...props 
+  }, ref) => {
+    const elementRef = useRef<HTMLElement>(null);
+
+    // Handle ref forwarding
+    useEffect(() => {
+      if (ref && elementRef.current) {
+        if (typeof ref === 'function') {
+          ref(elementRef.current);
+        } else {
+          ref.current = elementRef.current;
+        }
+      }
+    }, [ref]);
+
+    // Handle change events (date selection)
+    const handleChange = useCallback((event: Event) => {
+      const customEvent = event as CustomEvent<TyCalendarChangeEventDetail>;
+      if (onChange) {
+        onChange(customEvent);
+      }
+    }, [onChange]);
+
+    // Handle navigate events (month/year navigation)
+    const handleNavigate = useCallback((event: Event) => {
+      const customEvent = event as CustomEvent<TyCalendarNavigateEventDetail>;
+      if (onNavigate) {
+        onNavigate(customEvent);
+      }
+    }, [onNavigate]);
+
+    // Set up event listeners
+    useEffect(() => {
+      const element = elementRef.current;
+      if (!element) return;
+
+      const listeners: Array<[string, EventListener]> = [];
+
+      if (onChange) {
+        element.addEventListener('change', handleChange);
+        listeners.push(['change', handleChange]);
+      }
+      
+      if (onNavigate) {
+        element.addEventListener('navigate', handleNavigate);
+        listeners.push(['navigate', handleNavigate]);
+      }
+
+      return () => {
+        listeners.forEach(([eventName, handler]) => {
+          element.removeEventListener(eventName, handler);
+        });
+      };
+    }, [handleChange, handleNavigate, onChange, onNavigate]);
+
+    // Set function/object properties directly on the element. Required on
+    // React 18, which can't bridge non-string props onto custom elements.
+    // React 19+ handles function/object prop-to-property bridging natively.
+    useEffect(() => {
+      if (!needsPropertyBridge) return;
+      const element = elementRef.current;
+      if (!element) return;
+
+      // Day content function property (preferred over attribute)
+      if (dayContentFn) {
+        (element as any).dayContentFn = dayContentFn;
+      } else {
+        (element as any).dayContentFn = null;
+      }
+
+      // Day classes function property (preferred over attribute)
+      if (dayClassesFn) {
+        (element as any).dayClassesFn = dayClassesFn;
+      } else {
+        (element as any).dayClassesFn = null;
+      }
+
+      // Custom CSS property
+      if (customCSS) {
+        (element as any).customCSS = customCSS;
+      } else {
+        (element as any).customCSS = null;
+      }
+    }, [dayContentFn, dayClassesFn, customCSS]);
+
+    // Convert React props to web component attributes
+    const webComponentProps: Record<string, any> = {
+      ...props,
+      ref: elementRef,
+    };
+
+    // Add optional attributes only if they have values
+    if (year !== undefined) {
+      webComponentProps.year = year.toString();
+    }
+
+    if (month !== undefined) {
+      webComponentProps.month = month.toString();
+    }
+
+    if (day !== undefined) {
+      webComponentProps.day = day.toString();
+    }
+
+    if (showNavigation) {
+      webComponentProps['show-navigation'] = '';  // Boolean attributes as empty string
+    }
+
+    if (stateless) {
+      webComponentProps.stateless = '';  // Boolean attributes as empty string
+    }
+
+    if (size) {
+      webComponentProps.size = size;
+    }
+
+    if (locale) {
+      webComponentProps.locale = locale;
+    }
+
+    if (width !== undefined) {
+      webComponentProps.width = width.toString();
+    }
+
+    if (minWidth !== undefined) {
+      webComponentProps['min-width'] = minWidth.toString();
+    }
+
+    if (maxWidth !== undefined) {
+      webComponentProps['max-width'] = maxWidth.toString();
+    }
+
+    if (name) {
+      webComponentProps.name = name;
+    }
+
+    if (value) {
+      webComponentProps.value = value;
+    }
+
+    return React.createElement('ty-calendar', webComponentProps);
+  }
+);
+
+TyCalendar.displayName = 'TyCalendar';

package/src/components/TyCalendarMonth.tsx

@@ -0,0 +1,108 @@
+import React, { useEffect, useRef } from 'react';
+
+// Type definitions for Ty Calendar Month component
+export interface TyCalendarMonthProps extends React.HTMLAttributes<HTMLElement> {
+  /** Display year */
+  displayYear?: number;
+  
+  /** Display month (1-12) */
+  displayMonth?: number;
+  
+  /** Locale for date formatting */
+  locale?: string;
+  
+  /** Calendar size */
+  size?: 'sm' | 'md' | 'lg';
+  
+  /** Width of calendar */
+  width?: string;
+  
+  /** Minimum width */
+  minWidth?: string;
+  
+  /** Maximum width */
+  maxWidth?: string;
+  
+  /** Day click event handler */
+  onDayClick?: (event: CustomEvent<DayClickDetail>) => void;
+}
+
+export interface DayClickDetail {
+  dayContext: any; // DayContext type from calendar-utils
+  value: number;
+  year: number;
+  month: number;
+  day: number;
+  isHoliday?: boolean;
+  isToday?: boolean;
+  isWeekend: boolean;
+  isOtherMonth: boolean;
+}
+
+// React wrapper for ty-calendar-month web component
+export const TyCalendarMonth = React.forwardRef<HTMLElement, TyCalendarMonthProps>(
+  ({ 
+    displayYear,
+    displayMonth,
+    locale,
+    size,
+    width,
+    minWidth,
+    maxWidth,
+    onDayClick,
+    ...props 
+  }, ref) => {
+    const elementRef = useRef<HTMLElement>(null);
+
+    // Handle day click events
+    useEffect(() => {
+      const element = elementRef.current;
+      if (!element) return;
+
+      const handleDayClick = (event: Event) => {
+        if (onDayClick) {
+          onDayClick(event as CustomEvent<DayClickDetail>);
+        }
+      };
+
+      element.addEventListener('day-click', handleDayClick);
+
+      return () => {
+        element.removeEventListener('day-click', handleDayClick);
+      };
+    }, [onDayClick]);
+
+    // Combine refs if needed
+    useEffect(() => {
+      if (ref && elementRef.current) {
+        if (typeof ref === 'function') {
+          ref(elementRef.current);
+        } else {
+          ref.current = elementRef.current;
+        }
+      }
+    }, [ref]);
+
+    // Convert React props to web component attributes
+    const webComponentProps: Record<string, any> = {
+      ...props,
+      ref: elementRef,
+    };
+
+    // Add attributes
+    if (displayYear !== undefined) webComponentProps['display-year'] = displayYear;
+    if (displayMonth !== undefined) webComponentProps['display-month'] = displayMonth;
+    if (locale) webComponentProps.locale = locale;
+    if (size) webComponentProps.size = size;
+    if (width) webComponentProps.width = width;
+    if (minWidth) webComponentProps['min-width'] = minWidth;
+    if (maxWidth) webComponentProps['max-width'] = maxWidth;
+
+    return React.createElement(
+      'ty-calendar-month',
+      webComponentProps
+    );
+  }
+);
+
+TyCalendarMonth.displayName = 'TyCalendarMonth';

package/src/components/TyCalendarNavigation.tsx

@@ -0,0 +1,91 @@
+import React, { useEffect, useRef } from 'react';
+
+// Type definitions for Ty Calendar Navigation component
+export interface TyCalendarNavigationProps extends Omit<React.HTMLAttributes<HTMLElement>, 'onChange'> {
+  /** Display month (1-12) */
+  displayMonth?: number;
+  
+  /** Display year */
+  displayYear?: number;
+  
+  /** Locale for month name formatting */
+  locale?: string;
+  
+  /** Navigation size */
+  size?: 'sm' | 'md' | 'lg';
+  
+  /** Width of navigation */
+  width?: string;
+  
+  /** Navigation change event handler */
+  onChange?: (event: CustomEvent<NavigationChangeDetail>) => void;
+}
+
+export interface NavigationChangeDetail {
+  month: number;  // 1-12
+  year: number;   // e.g., 2025
+}
+
+// React wrapper for ty-calendar-navigation web component
+export const TyCalendarNavigation = React.forwardRef<HTMLElement, TyCalendarNavigationProps>(
+  ({ 
+    displayMonth,
+    displayYear,
+    locale,
+    size,
+    width,
+    onChange,
+    ...props 
+  }, ref) => {
+    const elementRef = useRef<HTMLElement>(null);
+
+    // Handle change events
+    useEffect(() => {
+      const element = elementRef.current;
+      if (!element) return;
+
+      const handleChange = (event: Event) => {
+        if (onChange) {
+          onChange(event as CustomEvent<NavigationChangeDetail>);
+        }
+      };
+
+      element.addEventListener('change', handleChange);
+
+      return () => {
+        element.removeEventListener('change', handleChange);
+      };
+    }, [onChange]);
+
+    // Combine refs if needed
+    useEffect(() => {
+      if (ref && elementRef.current) {
+        if (typeof ref === 'function') {
+          ref(elementRef.current);
+        } else {
+          ref.current = elementRef.current;
+        }
+      }
+    }, [ref]);
+
+    // Convert React props to web component attributes
+    const webComponentProps: Record<string, any> = {
+      ...props,
+      ref: elementRef,
+    };
+
+    // Add attributes
+    if (displayMonth !== undefined) webComponentProps['display-month'] = displayMonth;
+    if (displayYear !== undefined) webComponentProps['display-year'] = displayYear;
+    if (locale) webComponentProps.locale = locale;
+    if (size) webComponentProps.size = size;
+    if (width) webComponentProps.width = width;
+
+    return React.createElement(
+      'ty-calendar-navigation',
+      webComponentProps
+    );
+  }
+);
+
+TyCalendarNavigation.displayName = 'TyCalendarNavigation';