tyrell-react 1.0.0-RC10

package/src/components/TyCalendar.tsx

@@ -0,0 +1,247 @@
+import React, { useEffect, useRef, useCallback } from 'react';
+import { needsPropertyBridge } from '../utils/react-version';
+import { useBooleanProperty } from '../utils/use-boolean-prop';
+
+// 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();
+    }
+
+    const isShowNavigation = useBooleanProperty(elementRef, 'showNavigation', showNavigation);
+    const isStateless = useBooleanProperty(elementRef, 'stateless', stateless);
+
+    if (isShowNavigation) webComponentProps['show-navigation'] = '';
+    if (isStateless) webComponentProps.stateless = '';
+
+    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';

package/src/components/TyCheckbox.tsx

@@ -0,0 +1,147 @@
+import React, { useEffect, useRef } from 'react';
+import { useBooleanProperty } from '../utils/use-boolean-prop';
+
+// Type definitions for Ty Checkbox component
+export interface TyCheckboxProps extends Omit<React.HTMLAttributes<HTMLElement>, 'onChange' | 'onInput'> {
+  /** Checked state */
+  checked?: boolean;
+  
+  /** Form field value when checked */
+  value?: string;
+  
+  /** Form field name */
+  name?: string;
+  
+  /** Disable the checkbox */
+  disabled?: boolean;
+  
+  /** Required field */
+  required?: boolean;
+  
+  /** Error message */
+  error?: string;
+  
+  /** Checkbox size */
+  size?: 'xs' | 'sm' | 'md' | 'lg' | 'xl';
+  
+  /** Semantic styling variant */
+  flavor?: 'primary' | 'secondary' | 'success' | 'danger' | 'warning' | 'neutral';
+  
+  /**
+   * Fires when checkbox state changes (React convention)
+   * Maps to native 'input' event from ty-checkbox
+   */
+  onChange?: (event: CustomEvent<TyCheckboxEventDetail>) => void;
+  
+  /**
+   * Fires on blur if value changed (native DOM behavior)
+   * Maps to native 'change' event from ty-checkbox
+   */
+  onChangeCommit?: (event: CustomEvent<TyCheckboxEventDetail>) => void;
+  
+  /** Checkbox label content */
+  children?: React.ReactNode;
+}
+
+export interface TyCheckboxEventDetail {
+  value: boolean;
+  checked: boolean;
+  formValue: string | null;
+  originalEvent: Event;
+}
+
+// React wrapper for ty-checkbox web component
+export const TyCheckbox = React.forwardRef<HTMLElement, TyCheckboxProps>(
+  ({ 
+    children, 
+    checked,
+    value,
+    name,
+    disabled,
+    required,
+    error,
+    size,
+    flavor,
+    onChange,
+    onChangeCommit,
+    ...props 
+  }, ref) => {
+    const elementRef = useRef<HTMLElement>(null);
+
+    // Handle change events
+    useEffect(() => {
+      const element = elementRef.current;
+      if (!element) return;
+
+      // Map onChange to input event (React convention)
+      const handleInput = (event: Event) => {
+        if (onChange) {
+          onChange(event as CustomEvent<TyCheckboxEventDetail>);
+        }
+      };
+
+      // Map onChangeCommit to change event (blur behavior)
+      const handleChangeCommit = (event: Event) => {
+        if (onChangeCommit) {
+          onChangeCommit(event as CustomEvent<TyCheckboxEventDetail>);
+        }
+      };
+
+      // Map onChange → input event (React convention)
+      element.addEventListener('input', handleInput);
+      
+      // Map onChangeCommit → change event (blur behavior)
+      element.addEventListener('change', handleChangeCommit);
+
+      return () => {
+        element.removeEventListener('input', handleInput);
+        element.removeEventListener('change', handleChangeCommit);
+      };
+    }, [onChange, onChangeCommit]);
+
+    // Combine refs if needed
+    useEffect(() => {
+      if (ref && elementRef.current) {
+        if (typeof ref === 'function') {
+          ref(elementRef.current);
+        } else {
+          ref.current = elementRef.current;
+        }
+      }
+    }, [ref]);
+
+    // Imperative property sync for boolean props (see use-boolean-prop.ts).
+    // React 18 sets boolean attributes as empty strings on first render but
+    // doesn't reliably remove them when the prop flips back to false on a
+    // custom element. React 19+ handles this natively.
+    const isChecked = useBooleanProperty(elementRef, 'checked', checked);
+    const isDisabled = useBooleanProperty(elementRef, 'disabled', disabled);
+    const isRequired = useBooleanProperty(elementRef, 'required', required);
+
+    // Convert React props to web component attributes
+    const webComponentProps: Record<string, any> = {
+      ...props,
+      ref: elementRef,
+    };
+
+    // Add boolean attributes
+    if (isChecked) webComponentProps.checked = '';
+    if (isDisabled) webComponentProps.disabled = '';
+    if (isRequired) webComponentProps.required = '';
+    
+    // Add string attributes
+    if (value) webComponentProps.value = value;
+    if (name) webComponentProps.name = name;
+    if (error) webComponentProps.error = error;
+    if (size) webComponentProps.size = size;
+    if (flavor) webComponentProps.flavor = flavor;
+
+    return React.createElement(
+      'ty-checkbox',
+      webComponentProps,
+      children
+    );
+  }
+);
+
+TyCheckbox.displayName = 'TyCheckbox';

package/src/components/TyCopy.tsx

@@ -0,0 +1,83 @@
+import React, { useEffect, useRef } from 'react';
+import { useBooleanProperty } from '../utils/use-boolean-prop';
+
+// Type definitions for Ty Copy component
+export interface TyCopyProps extends Omit<React.HTMLAttributes<HTMLElement>, 'onChange'> {
+  /** Text to copy */
+  value?: string;
+  
+  /** Field label */
+  label?: string;
+  
+  /** Component size */
+  size?: 'xs' | 'sm' | 'md' | 'lg' | 'xl';
+  
+  /** Semantic styling variant */
+  flavor?: 'primary' | 'secondary' | 'success' | 'danger' | 'warning' | 'neutral';
+  
+  /** Display format */
+  format?: 'text' | 'code';
+  
+  /** Multi-line display */
+  multiline?: boolean;
+  
+  /** Disable the field */
+  disabled?: boolean;
+  
+  /** Required field */
+  required?: boolean;
+}
+
+// React wrapper for ty-copy web component
+export const TyCopy = React.forwardRef<HTMLElement, TyCopyProps>(
+  ({ 
+    value,
+    label,
+    size,
+    flavor,
+    format,
+    multiline,
+    disabled,
+    required,
+    ...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]);
+
+    const isMultiline = useBooleanProperty(elementRef, 'multiline', multiline);
+    const isDisabled = useBooleanProperty(elementRef, 'disabled', disabled);
+    const isRequired = useBooleanProperty(elementRef, 'required', required);
+
+    // Convert React props to web component attributes
+    const webComponentProps: Record<string, any> = {
+      ...props,
+      ref: elementRef,
+    };
+
+    // Add string attributes
+    if (value) webComponentProps.value = value;
+    if (label) webComponentProps.label = label;
+    if (size) webComponentProps.size = size;
+    if (flavor) webComponentProps.flavor = flavor;
+    if (format) webComponentProps.format = format;
+
+    // Add boolean attributes
+    if (isMultiline) webComponentProps.multiline = '';
+    if (isDisabled) webComponentProps.disabled = '';
+    if (isRequired) webComponentProps.required = '';
+
+    return React.createElement('ty-copy', webComponentProps);
+  }
+);
+
+TyCopy.displayName = 'TyCopy';