tyrell-react 1.0.0-RC12 → 1.0.0-RC14

package/src/components/TyCalendar.tsx

@@ -1,8 +1,11 @@
 import React, { useEffect, useRef, useCallback } from 'react';
+import { hostProps } from '../utils/host-props';
 import { needsPropertyBridge } from '../utils/react-version';
 import { useBooleanProperty } from '../utils/use-boolean-prop';
 
-// Type definitions for Ty Calendar component
+type BuiltinFlavor = 'primary' | 'success' | 'danger' | 'warning' | 'neutral';
+type ShadedFlavor = BuiltinFlavor | `${BuiltinFlavor}+` | `${BuiltinFlavor}-`;
+
 export interface TyCalendarChangeEventDetail {
   /** Selected month (1-12) */
   month: number;
@@ -47,7 +50,10 @@ export interface TyCalendarProps extends Omit<React.HTMLAttributes<HTMLElement>,
   
   /** Calendar size */
   size?: 'sm' | 'md' | 'lg';
-  
+
+  /** Visual flavor for the selected/today day cells (nav stays neutral chrome) */
+  flavor?: ShadedFlavor | (string & {});
+
   /** Locale for date formatting */
   locale?: string;
   
@@ -91,7 +97,6 @@ export interface TyCalendarProps extends Omit<React.HTMLAttributes<HTMLElement>,
   onDayClick?: (event: CustomEvent) => void;
 }
 
-// React wrapper for ty-calendar web component
 export const TyCalendar = React.forwardRef<HTMLElement, TyCalendarProps>(
   ({ 
     year,
@@ -100,6 +105,7 @@ export const TyCalendar = React.forwardRef<HTMLElement, TyCalendarProps>(
     showNavigation,
     stateless,
     size,
+    flavor,
     locale,
     width,
     min,
@@ -118,7 +124,6 @@ export const TyCalendar = React.forwardRef<HTMLElement, TyCalendarProps>(
   }, ref) => {
     const elementRef = useRef<HTMLElement>(null);
 
-    // Handle ref forwarding
     useEffect(() => {
       if (ref && elementRef.current) {
         if (typeof ref === 'function') {
@@ -129,7 +134,6 @@ export const TyCalendar = React.forwardRef<HTMLElement, TyCalendarProps>(
       }
     }, [ref]);
 
-    // Handle change events (date selection)
     const handleChange = useCallback((event: Event) => {
       const customEvent = event as CustomEvent<TyCalendarChangeEventDetail>;
       if (onChange) {
@@ -137,7 +141,6 @@ export const TyCalendar = React.forwardRef<HTMLElement, TyCalendarProps>(
       }
     }, [onChange]);
 
-    // Handle navigate events (month/year navigation)
     const handleNavigate = useCallback((event: Event) => {
       const customEvent = event as CustomEvent<TyCalendarNavigateEventDetail>;
       if (onNavigate) {
@@ -149,7 +152,6 @@ export const TyCalendar = React.forwardRef<HTMLElement, TyCalendarProps>(
       if (onDayClick) onDayClick(event as CustomEvent);
     }, [onDayClick]);
 
-    // Set up event listeners
     useEffect(() => {
       const element = elementRef.current;
       if (!element) return;
@@ -200,7 +202,6 @@ export const TyCalendar = React.forwardRef<HTMLElement, TyCalendarProps>(
         (element as any).dayClassesFn = null;
       }
 
-      // Custom CSS property
       if (customCSS) {
         (element as any).customCSS = customCSS;
       } else {
@@ -208,13 +209,11 @@ export const TyCalendar = React.forwardRef<HTMLElement, TyCalendarProps>(
       }
     }, [dayContentFn, dayClassesFn, customCSS]);
 
-    // Convert React props to web component attributes
     const webComponentProps: Record<string, any> = {
-      ...props,
+      ...hostProps(props),
       ref: elementRef,
     };
 
-    // Add optional attributes only if they have values
     if (year !== undefined) {
       webComponentProps.year = year.toString();
     }
@@ -237,6 +236,10 @@ export const TyCalendar = React.forwardRef<HTMLElement, TyCalendarProps>(
       webComponentProps.size = size;
     }
 
+    if (flavor) {
+      webComponentProps.flavor = flavor;
+    }
+
     if (locale) {
       webComponentProps.locale = locale;
     }

package/src/components/TyCalendarMonth.tsx

@@ -1,6 +1,9 @@
 import React, { useEffect, useRef } from 'react';
+import { hostProps } from '../utils/host-props';
+
+type BuiltinFlavor = 'primary' | 'success' | 'danger' | 'warning' | 'neutral';
+type ShadedFlavor = BuiltinFlavor | `${BuiltinFlavor}+` | `${BuiltinFlavor}-`;
 
-// Type definitions for Ty Calendar Month component
 export interface TyCalendarMonthProps extends React.HTMLAttributes<HTMLElement> {
   /** Display year */
   displayYear?: number;
@@ -13,7 +16,10 @@ export interface TyCalendarMonthProps extends React.HTMLAttributes<HTMLElement>
   
   /** Calendar size */
   size?: 'sm' | 'md' | 'lg';
-  
+
+  /** Visual flavor for the selected/today day cells */
+  flavor?: ShadedFlavor | (string & {});
+
   /** Width of calendar */
   width?: string;
   
@@ -45,13 +51,13 @@ export interface DayClickDetail {
   isOtherMonth: boolean;
 }
 
-// React wrapper for ty-calendar-month web component
 export const TyCalendarMonth = React.forwardRef<HTMLElement, TyCalendarMonthProps>(
   ({ 
     displayYear,
     displayMonth,
     locale,
     size,
+    flavor,
     width,
     minWidth,
     maxWidth,
@@ -62,7 +68,6 @@ export const TyCalendarMonth = React.forwardRef<HTMLElement, TyCalendarMonthProp
   }, ref) => {
     const elementRef = useRef<HTMLElement>(null);
 
-    // Handle day click events
     useEffect(() => {
       const element = elementRef.current;
       if (!element) return;
@@ -80,7 +85,6 @@ export const TyCalendarMonth = React.forwardRef<HTMLElement, TyCalendarMonthProp
       };
     }, [onDayClick]);
 
-    // Combine refs if needed
     useEffect(() => {
       if (ref && elementRef.current) {
         if (typeof ref === 'function') {
@@ -91,17 +95,16 @@ export const TyCalendarMonth = React.forwardRef<HTMLElement, TyCalendarMonthProp
       }
     }, [ref]);
 
-    // Convert React props to web component attributes
     const webComponentProps: Record<string, any> = {
-      ...props,
+      ...hostProps(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 (flavor) webComponentProps.flavor = flavor;
     if (width) webComponentProps.width = width;
     if (min) webComponentProps.min = min;
     if (max) webComponentProps.max = max;

package/src/components/TyCalendarNavigation.tsx

@@ -1,6 +1,6 @@
 import React, { useEffect, useRef } from 'react';
+import { hostProps } from '../utils/host-props';
 
-// Type definitions for Ty Calendar Navigation component
 export interface TyCalendarNavigationProps extends Omit<React.HTMLAttributes<HTMLElement>, 'onChange'> {
   /** Display month (1-12) */
   displayMonth?: number;
@@ -32,7 +32,6 @@ export interface NavigationChangeDetail {
   year: number;   // e.g., 2025
 }
 
-// React wrapper for ty-calendar-navigation web component
 export const TyCalendarNavigation = React.forwardRef<HTMLElement, TyCalendarNavigationProps>(
   ({ 
     displayMonth,
@@ -47,7 +46,6 @@ export const TyCalendarNavigation = React.forwardRef<HTMLElement, TyCalendarNavi
   }, ref) => {
     const elementRef = useRef<HTMLElement>(null);
 
-    // Handle change events
     useEffect(() => {
       const element = elementRef.current;
       if (!element) return;
@@ -65,7 +63,6 @@ export const TyCalendarNavigation = React.forwardRef<HTMLElement, TyCalendarNavi
       };
     }, [onChange]);
 
-    // Combine refs if needed
     useEffect(() => {
       if (ref && elementRef.current) {
         if (typeof ref === 'function') {
@@ -76,13 +73,11 @@ export const TyCalendarNavigation = React.forwardRef<HTMLElement, TyCalendarNavi
       }
     }, [ref]);
 
-    // Convert React props to web component attributes
     const webComponentProps: Record<string, any> = {
-      ...props,
+      ...hostProps(props),
       ref: elementRef,
     };
 
-    // Add attributes
     if (displayMonth !== undefined) webComponentProps['display-month'] = displayMonth;
     if (displayYear !== undefined) webComponentProps['display-year'] = displayYear;
     if (locale) webComponentProps.locale = locale;

package/src/components/TyCheckbox.tsx

@@ -1,7 +1,10 @@
 import React, { useEffect, useRef } from 'react';
+import { hostProps } from '../utils/host-props';
 import { useBooleanProperty } from '../utils/use-boolean-prop';
 
-// Type definitions for Ty Checkbox component
+type BuiltinFlavor = 'primary' | 'success' | 'danger' | 'warning' | 'neutral';
+type ShadedFlavor = BuiltinFlavor | `${BuiltinFlavor}+` | `${BuiltinFlavor}-`;
+
 export interface TyCheckboxProps extends Omit<React.HTMLAttributes<HTMLElement>, 'onChange' | 'onInput'> {
   /** Checked state */
   checked?: boolean;
@@ -28,7 +31,7 @@ export interface TyCheckboxProps extends Omit<React.HTMLAttributes<HTMLElement>,
   size?: 'xs' | 'sm' | 'md' | 'lg' | 'xl';
   
   /** Semantic styling variant */
-  flavor?: 'primary' | 'secondary' | 'success' | 'danger' | 'warning' | 'neutral';
+  flavor?: ShadedFlavor | (string & {});
   
   /**
    * Fires when checkbox state changes (React convention)
@@ -53,7 +56,6 @@ export interface TyCheckboxEventDetail {
   originalEvent: Event;
 }
 
-// React wrapper for ty-checkbox web component
 export const TyCheckbox = React.forwardRef<HTMLElement, TyCheckboxProps>(
   ({ 
     children,
@@ -72,7 +74,6 @@ export const TyCheckbox = React.forwardRef<HTMLElement, TyCheckboxProps>(
   }, ref) => {
     const elementRef = useRef<HTMLElement>(null);
 
-    // Handle change events
     useEffect(() => {
       const element = elementRef.current;
       if (!element) return;
@@ -91,10 +92,8 @@ export const TyCheckbox = React.forwardRef<HTMLElement, TyCheckboxProps>(
         }
       };
 
-      // Map onChange → input event (React convention)
       element.addEventListener('input', handleInput);
       
-      // Map onChangeCommit → change event (blur behavior)
       element.addEventListener('change', handleChangeCommit);
 
       return () => {
@@ -103,7 +102,6 @@ export const TyCheckbox = React.forwardRef<HTMLElement, TyCheckboxProps>(
       };
     }, [onChange, onChangeCommit]);
 
-    // Combine refs if needed
     useEffect(() => {
       if (ref && elementRef.current) {
         if (typeof ref === 'function') {
@@ -123,19 +121,16 @@ export const TyCheckbox = React.forwardRef<HTMLElement, TyCheckboxProps>(
     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,
+      ...hostProps(props),
       ref: elementRef,
     };
 
-    // Add boolean attributes
     if (isChecked) webComponentProps.checked = '';
     if (isIndeterminate) webComponentProps.indeterminate = '';
     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;

package/src/components/TyCopy.tsx

@@ -1,7 +1,10 @@
 import React, { useEffect, useRef } from 'react';
+import { hostProps } from '../utils/host-props';
 import { useBooleanProperty } from '../utils/use-boolean-prop';
 
-// Type definitions for Ty Copy component
+type BuiltinFlavor = 'primary' | 'success' | 'danger' | 'warning' | 'neutral';
+type ShadedFlavor = BuiltinFlavor | `${BuiltinFlavor}+` | `${BuiltinFlavor}-`;
+
 export interface TyCopyProps extends Omit<React.HTMLAttributes<HTMLElement>, 'onChange'> {
   /** Text to copy */
   value?: string;
@@ -13,7 +16,7 @@ export interface TyCopyProps extends Omit<React.HTMLAttributes<HTMLElement>, 'on
   size?: 'xs' | 'sm' | 'md' | 'lg' | 'xl';
   
   /** Semantic styling variant */
-  flavor?: 'primary' | 'secondary' | 'success' | 'danger' | 'warning' | 'neutral';
+  flavor?: ShadedFlavor | (string & {});
   
   /** Display format */
   format?: 'text' | 'code';
@@ -34,7 +37,6 @@ export interface TyCopyProps extends Omit<React.HTMLAttributes<HTMLElement>, 'on
   onCopyError?: (event: CustomEvent) => void;
 }
 
-// React wrapper for ty-copy web component
 export const TyCopy = React.forwardRef<HTMLElement, TyCopyProps>(
   ({ 
     value,
@@ -51,7 +53,6 @@ export const TyCopy = React.forwardRef<HTMLElement, TyCopyProps>(
   }, ref) => {
     const elementRef = useRef<HTMLElement>(null);
 
-    // Handle ref forwarding
     useEffect(() => {
       if (ref && elementRef.current) {
         if (typeof ref === 'function') {
@@ -62,7 +63,6 @@ export const TyCopy = React.forwardRef<HTMLElement, TyCopyProps>(
       }
     }, [ref]);
 
-    // Custom events → React callbacks
     useEffect(() => {
       const el = elementRef.current;
       if (!el) return;
@@ -82,20 +82,17 @@ export const TyCopy = React.forwardRef<HTMLElement, TyCopyProps>(
     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,
+      ...hostProps(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 = '';

package/src/components/TyDatePicker.tsx

@@ -1,8 +1,16 @@
 import React, { useEffect, useRef, useCallback } from 'react';
+import { hostProps } from '../utils/host-props';
 import { needsPropertyBridge } from '../utils/react-version';
 import { useBooleanProperty } from '../utils/use-boolean-prop';
 
-// Type definitions for Ty DatePicker component
+type BuiltinFlavor = 'primary' | 'success' | 'danger' | 'warning' | 'neutral';
+type ShadedFlavor = BuiltinFlavor | `${BuiltinFlavor}+` | `${BuiltinFlavor}-`;
+type Placement =
+  | 'top-start' | 'top' | 'top-end'
+  | 'right-start' | 'right' | 'right-end'
+  | 'bottom-start' | 'bottom' | 'bottom-end'
+  | 'left-start' | 'left' | 'left-end';
+
 export interface TyDatePickerEventDetail {
   /** The selected date value (ISO string or formatted string based on format) */
   value: string | null;
@@ -18,11 +26,11 @@ export interface TyDatePickerProps extends Omit<React.HTMLAttributes<HTMLElement
   /** The selected date value (ISO string or formatted string) */
   value?: string;
   
-  /** Input size: "sm" | "md" | "lg" */
+  /** Field size — fields come in exactly three; legacy xs/xl map to sm/lg */
   size?: 'sm' | 'md' | 'lg';
   
-  /** Visual flavor: "default" | "success" | "danger" | "warning" */
-  flavor?: 'default' | 'success' | 'danger' | 'warning';
+  /** Visual flavor — built-in semantic, +/- shade, or a custom flavor backed by --ty-*-X tokens. Also tints the popup calendar's selected/today day. */
+  flavor?: 'default' | ShadedFlavor | (string & {});
   
   /** Label text displayed above the input */
   label?: string;
@@ -56,7 +64,10 @@ export interface TyDatePickerProps extends Omit<React.HTMLAttributes<HTMLElement
 
   /** Latest selectable date (ISO "YYYY-MM-DD") */
   max?: string;
-  
+
+  /** Calendar popup placement, same vocabulary as ty-popup/ty-tooltip/ty-select: a side plus an optional cross-axis alignment (e.g. "bottom-start"). The calendar only lives above or below the field, so left/right degrade to auto-side with the alignment kept. Empty/unset = auto (below when it fits). */
+  placement?: Placement;
+
   /** Callback when the date value changes */
   onChange?: (event: CustomEvent<TyDatePickerEventDetail>) => void;
   
@@ -67,8 +78,12 @@ export interface TyDatePickerProps extends Omit<React.HTMLAttributes<HTMLElement
   onClose?: (event: CustomEvent<{}>) => void;
 }
 
-// React wrapper for ty-date-picker web component
-export const TyDatePicker = React.forwardRef<HTMLElement, TyDatePickerProps>(
+/** The underlying custom element, typed with its imperative clear() method. */
+export interface TyDatePickerElement extends HTMLElement {
+  clear(): void;
+}
+
+export const TyDatePicker = React.forwardRef<TyDatePickerElement, TyDatePickerProps>(
   ({ 
     value,
     size,
@@ -84,14 +99,14 @@ export const TyDatePicker = React.forwardRef<HTMLElement, TyDatePickerProps>(
     withTime,
     min,
     max,
+    placement,
     onChange,
     onOpen,
     onClose,
     ...props 
   }, ref) => {
-    const elementRef = useRef<HTMLElement>(null);
+    const elementRef = useRef<TyDatePickerElement>(null);
 
-    // Handle ref forwarding
     useEffect(() => {
       if (ref && elementRef.current) {
         if (typeof ref === 'function') {
@@ -109,12 +124,10 @@ export const TyDatePicker = React.forwardRef<HTMLElement, TyDatePickerProps>(
       if (!needsPropertyBridge) return;
       const element = elementRef.current;
       if (element && value !== undefined) {
-        // Set the value property directly on the element
         (element as any).value = value || '';
       }
     }, [value]);
 
-    // Handle change events
     const handleChange = useCallback((event: Event) => {
       const customEvent = event as CustomEvent<TyDatePickerEventDetail>;
       if (onChange) {
@@ -122,10 +135,8 @@ export const TyDatePicker = React.forwardRef<HTMLElement, TyDatePickerProps>(
       }
     }, [onChange]);
 
-    // Handle open/close events. Guard with `event.target === element` so
-    // bubbled open/close events from popup-like descendants slotted inside
-    // (rare for a date-picker, but defensive — same fix as TyModal/TyPopup)
-    // don't fire the consumer's onOpen/onClose.
+    // Handle open/close events. See TyModal.tsx for why the
+    // `event.target === element` guard is still here.
     const handleOpen = useCallback((event: Event) => {
       if (event.target !== elementRef.current) return;
       if (onOpen) onOpen(event as CustomEvent<{}>);
@@ -136,7 +147,6 @@ export const TyDatePicker = React.forwardRef<HTMLElement, TyDatePickerProps>(
       if (onClose) onClose(event as CustomEvent<{}>);
     }, [onClose]);
 
-    // Set up event listeners
     useEffect(() => {
       const element = elementRef.current;
       if (!element) return;
@@ -165,13 +175,11 @@ export const TyDatePicker = React.forwardRef<HTMLElement, TyDatePickerProps>(
       };
     }, [handleChange, handleOpen, handleClose, onChange, onOpen, onClose]);
 
-    // Convert React props to web component attributes
     const webComponentProps: Record<string, any> = {
-      ...props,
+      ...hostProps(props),
       ref: elementRef,
     };
 
-    // Add optional attributes only if they have values
     if (value !== undefined) {
       webComponentProps.value = value;
     }
@@ -224,6 +232,10 @@ export const TyDatePicker = React.forwardRef<HTMLElement, TyDatePickerProps>(
       webComponentProps.max = max;
     }
 
+    if (placement) {
+      webComponentProps.placement = placement;
+    }
+
     return React.createElement('ty-date-picker', webComponentProps);
   }
 );

package/src/components/TyFileUpload.tsx

@@ -1,7 +1,7 @@
 import React, { useEffect, useRef } from 'react';
+import { hostProps } from '../utils/host-props';
 import { useBooleanProperty } from '../utils/use-boolean-prop';
 
-// Type definitions for Ty File Upload component
 export interface TyFileUploadProps extends Omit<React.HTMLAttributes<HTMLElement>, 'onChange'> {
   /** Form field name — used as the FormData key */
   name?: string;
@@ -40,7 +40,6 @@ export interface TyFileUploadEventDetail {
   names: string[];
 }
 
-// React wrapper for ty-file-upload web component
 export const TyFileUpload = React.forwardRef<HTMLElement, TyFileUploadProps>(
   ({
     name,
@@ -87,7 +86,7 @@ export const TyFileUpload = React.forwardRef<HTMLElement, TyFileUploadProps>(
     const isRequired = useBooleanProperty(elementRef, 'required', required);
 
     const webComponentProps: Record<string, any> = {
-      ...props,
+      ...hostProps(props),
       ref: elementRef,
     };
 

package/src/components/TyIcon.tsx

@@ -1,7 +1,6 @@
 import React, { useEffect, useRef } from 'react';
 import { useBooleanProperty } from '../utils/use-boolean-prop';
 
-// Type definitions for Ty Icon component
 export interface TyIconProps extends React.HTMLAttributes<HTMLElement> {
   /** Icon name from the icon registry (e.g., 'home', 'star', 'settings') */
   name: string;
@@ -22,12 +21,10 @@ export interface TyIconProps extends React.HTMLAttributes<HTMLElement> {
   className?: string;
 }
 
-// React wrapper for ty-icon web component
 export const TyIcon = React.forwardRef<HTMLElement, TyIconProps>(
   ({ name, size, spin, pulse, tempo, className, ...props }, ref) => {
     const elementRef = useRef<HTMLElement>(null);
 
-    // Handle ref forwarding
     useEffect(() => {
       if (ref && elementRef.current) {
         if (typeof ref === 'function') {
@@ -41,14 +38,12 @@ export const TyIcon = React.forwardRef<HTMLElement, TyIconProps>(
     const isSpin = useBooleanProperty(elementRef, 'spin', spin);
     const isPulse = useBooleanProperty(elementRef, 'pulse', pulse);
 
-    // Convert React props to web component attributes
     const webComponentProps: Record<string, any> = {
       ...props,
       name,
       ref: elementRef,
     };
 
-    // Add optional attributes only if they have values
     if (size) {
       webComponentProps.size = size;
     }

package/src/components/TyInput.tsx

@@ -1,8 +1,11 @@
 import React, { useEffect, useRef, useCallback } from 'react';
+import { hostProps } from '../utils/host-props';
 import { needsPropertyBridge } from '../utils/react-version';
 import { useBooleanProperty } from '../utils/use-boolean-prop';
 
-// Event detail structure for ty-input events
+type BuiltinFlavor = 'primary' | 'success' | 'danger' | 'warning' | 'neutral';
+type ShadedFlavor = BuiltinFlavor | `${BuiltinFlavor}+` | `${BuiltinFlavor}-`;
+
 export interface TyInputEventDetail {
   value: any; // shadow value (processed/parsed)
   formattedValue: string; // user-visible formatted value
@@ -23,7 +26,6 @@ export interface TyInputCSSProperties extends React.CSSProperties {
   '--input-disabled-color'?: string;
 }
 
-// Type definitions for Ty Input component
 export interface TyInputProps extends Omit<React.HTMLAttributes<HTMLElement>, 'onChange' | 'onFocus' | 'onBlur' | 'style'> {
   style?: TyInputCSSProperties;
   /** Input type */
@@ -31,10 +33,11 @@ export interface TyInputProps extends Omit<React.HTMLAttributes<HTMLElement>, 'o
   | 'currency' | 'percent' | 'compact';
 
   /** Semantic styling variant */
-  flavor?: 'primary' | 'secondary' | 'success' | 'danger' | 'warning' | 'neutral';
+  flavor?: ShadedFlavor | (string & {});
 
   /** Input size */
-  size?: 'xs' | 'sm' | 'md' | 'lg' | 'xl';
+  /** Field size — fields come in exactly three; legacy xs/xl map to sm/lg */
+  size?: 'sm' | 'md' | 'lg';
 
   /** Input value */
   value?: string;
@@ -91,7 +94,6 @@ export interface TyInputProps extends Omit<React.HTMLAttributes<HTMLElement>, 'o
 // One-time global warning flags so we don't spam the console.
 let _warnedOnInputProp = false;
 
-// React wrapper for ty-input web component
 export const TyInput = React.forwardRef<HTMLElement, TyInputProps>(
   ({ onChange, onChangeCommit, onFocus, onBlur, disabled, required, name, checked, debounce, ...props }, ref) => {
     const elementRef = useRef<HTMLElement>(null);
@@ -145,18 +147,14 @@ export const TyInput = React.forwardRef<HTMLElement, TyInputProps>(
       const element = elementRef.current;
       if (!element) return;
 
-      // Listen for custom input/change events from ty-input
-      // Map onChange → input event (React convention)
       if (onChange) {
         element.addEventListener('input', handleInput as EventListener);
       }
 
-      // Map onChangeCommit → change event (blur behavior)
       if (onChangeCommit) {
         element.addEventListener('change', handleChangeCommit as EventListener);
       }
 
-      // Listen for standard focus/blur events
       if (onFocus) {
         element.addEventListener('focus', handleFocus as EventListener);
       }
@@ -181,7 +179,6 @@ export const TyInput = React.forwardRef<HTMLElement, TyInputProps>(
       };
     }, [handleInput, handleChangeCommit, handleFocus, handleBlur, onChange, onChangeCommit, onFocus, onBlur]);
 
-    // Handle ref forwarding
     useEffect(() => {
       if (ref && elementRef.current) {
         if (typeof ref === 'function') {
@@ -212,21 +209,17 @@ export const TyInput = React.forwardRef<HTMLElement, TyInputProps>(
     const isRequired = useBooleanProperty(elementRef, 'required', required);
     const isChecked = useBooleanProperty(elementRef, 'checked', checked);
 
-    // Convert React props to web component attributes
     const webComponentProps: Record<string, any> = {
-      ...props,
+      ...hostProps(props),
       ref: elementRef,
     };
 
-    // Add conditional attributes
     if (isDisabled) webComponentProps.disabled = '';
     if (isRequired) webComponentProps.required = '';
     if (isChecked) webComponentProps.checked = '';
 
-    // Add string attributes
     if (name) webComponentProps.name = name;
 
-    // Add debounce attribute
     if (debounce !== undefined) webComponentProps.debounce = debounce;
 
     return React.createElement(