tyrell-react 1.0.0-TC44 → 1.0.0-TC46

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

@@ -6,7 +6,6 @@ import { useBooleanProperty } from '../utils/use-boolean-prop';
 type BuiltinFlavor = 'primary' | 'secondary' | 'success' | 'danger' | 'warning' | 'neutral';
 type ShadedFlavor = BuiltinFlavor | `${BuiltinFlavor}+` | `${BuiltinFlavor}-`;
 
-// Event detail structure for ty-input events
 export interface TyInputEventDetail {
   value: any; // shadow value (processed/parsed)
   formattedValue: string; // user-visible formatted value
@@ -27,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 */
@@ -96,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);
@@ -150,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);
       }
@@ -186,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') {
@@ -217,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> = {
       ...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(

package/src/components/TyModal.tsx

@@ -3,7 +3,6 @@ import { hostProps } from '../utils/host-props';
 import { useBooleanProperty, coerceBool } from '../utils/use-boolean-prop';
 import { needsPropertyBridge } from '../utils/react-version';
 
-// Event detail structure for modal events
 export interface TyModalEventDetail {
   reason?: 'programmatic' | 'native' | 'backdrop' | 'escape' | 'close-button';
   returnValue?: string;
@@ -19,7 +18,6 @@ export interface TyModalBeforeCloseDetail {
   reason: 'programmatic' | 'backdrop' | 'escape' | 'close-button' | 'native';
 }
 
-// Type definitions for Ty Modal component
 export interface TyModalProps extends React.HTMLAttributes<HTMLElement> {
   /** Controls modal visibility */
   open?: boolean;
@@ -52,7 +50,6 @@ export interface TyModalProps extends React.HTMLAttributes<HTMLElement> {
   children?: React.ReactNode;
 }
 
-// Ref interface for imperative methods
 export interface TyModalRef {
   show: () => void;
   /**
@@ -64,7 +61,6 @@ export interface TyModalRef {
   element: HTMLElement | null;
 }
 
-// React wrapper for ty-modal web component
 export const TyModal = React.forwardRef<TyModalRef, TyModalProps>(
   ({
     open,
@@ -80,7 +76,6 @@ export const TyModal = React.forwardRef<TyModalRef, TyModalProps>(
   }, ref) => {
     const elementRef = useRef<HTMLElement>(null);
 
-    // Expose imperative methods through ref
     useImperativeHandle(ref, () => ({
       show: () => {
         if (elementRef.current && typeof (elementRef.current as any).show === 'function') {
@@ -95,8 +90,6 @@ export const TyModal = React.forwardRef<TyModalRef, TyModalProps>(
       element: elementRef.current,
     }), []);
 
-    // Handle modal events.
-    //
     // ty-dropdown, ty-multiselect, ty-date-picker etc. dispatch their own
     // `open`/`close` custom events with `bubbles: true, composed: true` when
     // their internal popups toggle. Those events bubble up through the
@@ -125,7 +118,6 @@ export const TyModal = React.forwardRef<TyModalRef, TyModalProps>(
         if (onBeforeClose) onBeforeClose(event);
       };
 
-      // Listen for custom modal events
       if (onOpen) {
         element.addEventListener('open', handleOpen as EventListener);
       }
@@ -172,7 +164,6 @@ export const TyModal = React.forwardRef<TyModalRef, TyModalProps>(
       setIf('closeOnEscape', closeOnEscape);
     }, [backdrop, closeOnOutsideClick, closeOnEscape]);
 
-    // Convert React props to web component attributes
     const webComponentProps: Record<string, any> = {
       ...hostProps(props),
       ref: elementRef,

package/src/components/TyOption.tsx

@@ -2,7 +2,6 @@ import React, { useEffect, useRef } from 'react';
 import { hostProps } from '../utils/host-props';
 import { useBooleanProperty } from '../utils/use-boolean-prop';
 
-// Type definitions for Ty Option component
 export interface TyOptionProps extends React.HTMLAttributes<HTMLElement> {
   value?: string;
 
@@ -22,12 +21,10 @@ export interface TyOptionProps extends React.HTMLAttributes<HTMLElement> {
   children?: React.ReactNode;
 }
 
-// React wrapper for ty-option web component
 export const TyOption = React.forwardRef<HTMLElement, TyOptionProps>(
   ({ children, label, flavor, disabled, selected, hidden, ...props }, ref) => {
     const elementRef = useRef<HTMLElement>(null);
 
-    // Handle ref forwarding
     useEffect(() => {
       if (ref && elementRef.current) {
         if (typeof ref === 'function') {

package/src/components/TyPopup.tsx

@@ -2,7 +2,6 @@ import React, { useEffect, useRef } from 'react';
 import { hostProps } from '../utils/host-props';
 import { useBooleanProperty } from '../utils/use-boolean-prop';
 
-// Type definitions for Ty Popup component
 export interface TyPopupProps extends Omit<React.HTMLAttributes<HTMLElement>, 'onClose'> {
   /** Preferred placement of the popup relative to anchor parent: "top" | "bottom" | "left" | "right" */
   placement?: 'top' | 'bottom' | 'left' | 'right';
@@ -26,14 +25,12 @@ export interface TyPopupProps extends Omit<React.HTMLAttributes<HTMLElement>, 'o
   children?: React.ReactNode;
 }
 
-// Programmatic API for popup control
 export interface TyPopupElement extends HTMLElement {
   openPopup(): void;
   closePopup(): void;
   togglePopup(): void;
 }
 
-// React wrapper for ty-popup web component
 export const TyPopup = React.forwardRef<TyPopupElement, TyPopupProps>(
   ({
     placement,
@@ -47,7 +44,6 @@ export const TyPopup = React.forwardRef<TyPopupElement, TyPopupProps>(
   }, ref) => {
     const elementRef = useRef<TyPopupElement>(null);
 
-    // Handle ref forwarding
     useEffect(() => {
       if (ref && elementRef.current) {
         if (typeof ref === 'function') {
@@ -85,13 +81,11 @@ export const TyPopup = React.forwardRef<TyPopupElement, TyPopupProps>(
       };
     }, [onOpen, onClose]);
 
-    // Convert React props to web component attributes
     const webComponentProps: Record<string, any> = {
       ...hostProps(props),
       ref: elementRef,
     };
 
-    // Add optional attributes only if they have values
     if (placement) {
       webComponentProps.placement = placement;
     }

package/src/components/TyResizeObserver.tsx

@@ -1,7 +1,6 @@
 import React, { useEffect, useRef } from 'react';
 import { hostProps } from '../utils/host-props';
 
-// Type definitions for Ty ResizeObserver component
 export interface TyResizeObserverProps extends React.HTMLAttributes<HTMLElement> {
   /** Required unique identifier for size registry */
   id: string;
@@ -13,7 +12,6 @@ export interface TyResizeObserverProps extends React.HTMLAttributes<HTMLElement>
   children?: React.ReactNode;
 }
 
-// React wrapper for ty-resize-observer web component
 export const TyResizeObserver = React.forwardRef<HTMLElement, TyResizeObserverProps>(
   ({
     children,
@@ -23,7 +21,6 @@ export const TyResizeObserver = React.forwardRef<HTMLElement, TyResizeObserverPr
   }, ref) => {
     const elementRef = useRef<HTMLElement>(null);
 
-    // Combine refs if needed
     useEffect(() => {
       if (ref && elementRef.current) {
         if (typeof ref === 'function') {
@@ -34,14 +31,12 @@ export const TyResizeObserver = React.forwardRef<HTMLElement, TyResizeObserverPr
       }
     }, [ref]);
 
-    // Convert React props to web component attributes
     const webComponentProps: Record<string, any> = {
       ...hostProps(props),
       ref: elementRef,
       id,
     };
 
-    // Add number attributes
     if (debounce !== undefined) webComponentProps.debounce = debounce;
 
     return React.createElement(

package/src/components/TyScrollContainer.tsx

@@ -11,7 +11,6 @@ export interface TyScrollNearEdgeDetail {
   clientHeight: number;
 }
 
-// Type definitions for Ty ScrollContainer component
 export interface TyScrollContainerProps extends React.HTMLAttributes<HTMLElement> {
   /** Maximum height of the scroll container */
   maxHeight?: string;
@@ -44,7 +43,6 @@ export interface TyScrollContainerProps extends React.HTMLAttributes<HTMLElement
   children?: React.ReactNode;
 }
 
-// Ref interface for imperative methods
 export interface TyScrollContainerRef {
   /** Force update shadows (useful after dynamic content changes) */
   updateShadows: () => void;
@@ -64,7 +62,6 @@ export interface TyScrollContainerRef {
   element: HTMLElement | null;
 }
 
-// React wrapper for ty-scroll-container web component
 export const TyScrollContainer = React.forwardRef<TyScrollContainerRef, TyScrollContainerProps>(
   ({
     children,
@@ -81,7 +78,6 @@ export const TyScrollContainer = React.forwardRef<TyScrollContainerRef, TyScroll
   }, ref) => {
     const elementRef = useRef<HTMLElement>(null);
 
-    // Expose imperative methods via ref
     useImperativeHandle(ref, () => ({
       updateShadows: () => { (elementRef.current as any)?.updateShadows?.(); },
       scrollToTop: (smooth = true) => { (elementRef.current as any)?.scrollToTop?.(smooth); },
@@ -109,7 +105,6 @@ export const TyScrollContainer = React.forwardRef<TyScrollContainerRef, TyScroll
     const isOverflowX = useBooleanProperty(elementRef, 'overflowX', overflowX);
     const isScrollAnchoring = useBooleanProperty(elementRef, 'scrollAnchoring', scrollAnchoring);
 
-    // Custom events → React callbacks
     useEffect(() => {
       const el = elementRef.current;
       if (!el) return;
@@ -125,17 +120,14 @@ export const TyScrollContainer = React.forwardRef<TyScrollContainerRef, TyScroll
       return () => bound.forEach(([n, h]) => el.removeEventListener(n, h));
     }, [onNearEnd, onNearStart]);
 
-    // Convert React props to web component attributes
     const webComponentProps: Record<string, any> = {
       ...hostProps(props),
       ref: elementRef,
     };
 
-    // String attributes
     if (maxHeight) webComponentProps['max-height'] = maxHeight;
     if (nearEdgeThreshold != null) webComponentProps['near-edge-threshold'] = String(nearEdgeThreshold);
 
-    // Boolean attributes
     if (shadow !== undefined && !coerceBool(shadow)) webComponentProps.shadow = 'false';
     if (isHideScrollbar) webComponentProps['hide-scrollbar'] = '';
     if (isCustomScrollbar) webComponentProps['custom-scrollbar'] = '';

package/src/components/TySelect.tsx

@@ -6,7 +6,6 @@ import { useBooleanProperty } from '../utils/use-boolean-prop';
 type BuiltinFlavor = 'primary' | 'secondary' | 'success' | 'danger' | 'warning' | 'neutral';
 type ShadedFlavor = BuiltinFlavor | `${BuiltinFlavor}+` | `${BuiltinFlavor}-`;
 
-// Type definitions for Ty Select component
 export interface TySelectItem {
   value: string;
   label: string;
@@ -21,7 +20,7 @@ export interface TySelectEventDetail {
   /** Rich info per selected value — enough to render chips out-of-band */
   items: TySelectItem[];
   /** Action that triggered the change */
-  action: 'add' | 'remove' | 'clear' | 'set';
+  action: 'add' | 'remove' | 'clear' | 'set' | 'create';
   /** The specific value that changed */
   item: string | null;
 }
@@ -93,6 +92,12 @@ export interface TySelectProps extends Omit<React.HTMLAttributes<HTMLElement>, '
   /** Field size — fields come in exactly three; legacy xs/xl map to sm/lg */
   size?: 'sm' | 'md' | 'lg';
 
+  /** Horizontal popup anchor: "start" (default, trigger's left edge) or "end" (trigger's right edge) — clamped into the viewport either way. Useful with a custom slot="trigger" element. */
+  align?: 'start' | 'end';
+
+  /** Built-in x clear button in the default/compact trigger, shown once something is selected. Default true. Not shown with slot="trigger" — use the ref's clear() method there instead. */
+  clearable?: boolean;
+
   /** Visual flavor for the field border — built-in semantic, +/- shade, or a custom flavor backed by --ty-*-X tokens */
   flavor?: ShadedFlavor | (string & {});
 
@@ -115,8 +120,12 @@ export interface TySelectProps extends Omit<React.HTMLAttributes<HTMLElement>, '
   children?: React.ReactNode;
 }
 
-// React wrapper for ty-select web component
-export const TySelect = React.forwardRef<HTMLElement, TySelectProps>(
+/** The underlying custom element, typed with its imperative clear() method — useful with a ref, e.g. for slot="trigger" custom triggers that call it directly instead of relying on the built-in clear button. */
+export interface TySelectElement extends HTMLElement {
+  clear(): void;
+}
+
+export const TySelect = React.forwardRef<TySelectElement, TySelectProps>(
   ({
     value,
     multiple,
@@ -134,6 +143,8 @@ export const TySelect = React.forwardRef<HTMLElement, TySelectProps>(
     createTransform,
     loading,
     size,
+    align,
+    clearable,
     flavor,
     onChange,
     onSearch,
@@ -143,9 +154,8 @@ export const TySelect = React.forwardRef<HTMLElement, TySelectProps>(
     children,
     ...props
   }, ref) => {
-    const elementRef = useRef<HTMLElement>(null);
+    const elementRef = useRef<TySelectElement>(null);
 
-    // Handle ref forwarding
     useEffect(() => {
       if (ref && elementRef.current) {
         if (typeof ref === 'function') {
@@ -168,7 +178,6 @@ export const TySelect = React.forwardRef<HTMLElement, TySelectProps>(
       }
     }, [value]);
 
-    // Handle events
     const handleChange = useCallback((event: Event) => {
       if (onChange) onChange(event as CustomEvent<TySelectEventDetail>);
     }, [onChange]);
@@ -183,7 +192,6 @@ export const TySelect = React.forwardRef<HTMLElement, TySelectProps>(
       if (onCreate) onCreate(event as CustomEvent<{ value: string; label: string }>);
     }, [onCreate]);
 
-    // Set up event listeners
     useEffect(() => {
       const element = elementRef.current;
       if (!element) return;
@@ -212,14 +220,13 @@ export const TySelect = React.forwardRef<HTMLElement, TySelectProps>(
     const isLoading = useBooleanProperty(elementRef, 'loading', loading);
     const isExternalSearch = useBooleanProperty(elementRef, 'externalSearch', externalSearch);
     const isAllowCreate = useBooleanProperty(elementRef, 'allowCreate', allowCreate);
+    const isClearable = useBooleanProperty(elementRef, 'clearable', clearable);
 
-    // Convert React props to web component attributes
     const webComponentProps: Record<string, any> = {
       ...hostProps(props),
       ref: elementRef,
     };
 
-    // Handle value conversion (array to comma-separated string)
     if (value !== undefined) {
       webComponentProps.value = Array.isArray(value) ? value.join(',') : value;
     }
@@ -237,6 +244,8 @@ export const TySelect = React.forwardRef<HTMLElement, TySelectProps>(
     if (label) webComponentProps.label = label;
     if (name) webComponentProps.name = name;
     if (size) webComponentProps.size = size;
+    if (align) webComponentProps.align = align;
+    if (isClearable) webComponentProps.clearable = '';
     if (flavor) webComponentProps.flavor = flavor;
     if (debounce !== undefined) webComponentProps.debounce = debounce.toString();
     if (createTransform) webComponentProps['create-transform'] = createTransform;
@@ -250,11 +259,9 @@ export const TySelect = React.forwardRef<HTMLElement, TySelectProps>(
 
 TySelect.displayName = 'TySelect';
 
-// ============================================================================
 // TySelectedOptions — out-of-band chip display for a TySelect
 // (ty-selected-tags below is the same element under its original tag name,
 // kept for backward compatibility.)
-// ============================================================================
 
 export interface TySelectedTagsProps extends React.HTMLAttributes<HTMLElement> {
   /** id of the ty-select to display. Falls back to the previous element sibling. */

package/src/components/TyStep.tsx

@@ -1,7 +1,6 @@
 import React, { useEffect, useRef } from 'react';
 import { hostProps } from '../utils/host-props';
 
-// Type definitions for Ty Step component
 export interface TyStepProps extends React.HTMLAttributes<HTMLElement> {
   /** Required unique identifier for the step */
   id: string;
@@ -22,7 +21,6 @@ export interface TyStepProps extends React.HTMLAttributes<HTMLElement> {
   children?: React.ReactNode;
 }
 
-// React wrapper for ty-step web component
 export const TyStep = React.forwardRef<HTMLElement, TyStepProps>(
   ({
     children,
@@ -35,7 +33,6 @@ export const TyStep = React.forwardRef<HTMLElement, TyStepProps>(
   }, ref) => {
     const elementRef = useRef<HTMLElement>(null);
 
-    // Combine refs if needed
     useEffect(() => {
       if (ref && elementRef.current) {
         if (typeof ref === 'function') {
@@ -46,19 +43,16 @@ export const TyStep = React.forwardRef<HTMLElement, TyStepProps>(
       }
     }, [ref]);
 
-    // Convert React props to web component attributes
     const webComponentProps: Record<string, any> = {
       ...hostProps(props),
       ref: elementRef,
       id,
     };
 
-    // Add string attributes
     if (label) webComponentProps.label = label;
     if (description) webComponentProps.description = description;
     if (status) webComponentProps.status = status;
 
-    // Add boolean attributes
     if (disabled) webComponentProps.disabled = true;
 
     return React.createElement(

package/src/components/TyTab.tsx

@@ -2,7 +2,6 @@ import React, { useEffect, useRef } from 'react';
 import { hostProps } from '../utils/host-props';
 import { useBooleanProperty } from '../utils/use-boolean-prop';
 
-// Type definitions for Ty Tab component
 export interface TyTabProps extends React.HTMLAttributes<HTMLElement> {
   /** Required unique identifier */
   id: string;
@@ -17,7 +16,6 @@ export interface TyTabProps extends React.HTMLAttributes<HTMLElement> {
   children?: React.ReactNode;
 }
 
-// React wrapper for ty-tab web component
 export const TyTab = React.forwardRef<HTMLElement, TyTabProps>(
   ({ 
     children, 
@@ -28,7 +26,6 @@ export const TyTab = React.forwardRef<HTMLElement, TyTabProps>(
   }, ref) => {
     const elementRef = useRef<HTMLElement>(null);
 
-    // Combine refs if needed
     useEffect(() => {
       if (ref && elementRef.current) {
         if (typeof ref === 'function') {
@@ -39,20 +36,16 @@ export const TyTab = React.forwardRef<HTMLElement, TyTabProps>(
       }
     }, [ref]);
 
-    // Convert React props to web component attributes
     const webComponentProps: Record<string, any> = {
       ...hostProps(props),
       ref: elementRef,
     };
 
-    // Add required attribute
     webComponentProps.id = id;
     
-    // Add boolean attributes
     const isDisabled = useBooleanProperty(elementRef, 'disabled', disabled);
     if (isDisabled) webComponentProps.disabled = '';
     
-    // Add string attributes
     if (label) webComponentProps.label = label;
 
     return React.createElement(

package/src/components/TyTabs.tsx

@@ -1,7 +1,6 @@
 import React, { useEffect, useRef } from 'react';
 import { hostProps } from '../utils/host-props';
 
-// Type definitions for Ty Tabs component
 export interface TyTabsProps extends Omit<React.HTMLAttributes<HTMLElement>, 'onChange'> {
   /** Content area width (accepts px or %) */
   width?: string;
@@ -29,7 +28,6 @@ export interface TabChangeDetail {
   previousIndex: number | null;
 }
 
-// React wrapper for ty-tabs web component
 export const TyTabs = React.forwardRef<HTMLElement, TyTabsProps>(
   ({ 
     children, 
@@ -42,7 +40,6 @@ export const TyTabs = React.forwardRef<HTMLElement, TyTabsProps>(
   }, ref) => {
     const elementRef = useRef<HTMLElement>(null);
 
-    // Handle change events
     useEffect(() => {
       const element = elementRef.current;
       if (!element) return;
@@ -60,7 +57,6 @@ export const TyTabs = React.forwardRef<HTMLElement, TyTabsProps>(
       };
     }, [onChange]);
 
-    // Combine refs if needed
     useEffect(() => {
       if (ref && elementRef.current) {
         if (typeof ref === 'function') {
@@ -71,13 +67,11 @@ export const TyTabs = React.forwardRef<HTMLElement, TyTabsProps>(
       }
     }, [ref]);
 
-    // Convert React props to web component attributes
     const webComponentProps: Record<string, any> = {
       ...hostProps(props),
       ref: elementRef,
     };
 
-    // Add string attributes
     if (width) webComponentProps.width = width;
     if (height) webComponentProps.height = height;
     if (active) webComponentProps.active = active;

package/src/components/TyTag.tsx

@@ -12,7 +12,6 @@ export interface TyTagCSSProperties extends React.CSSProperties {
   '--tag-border-color'?: string;
 }
 
-// Type definitions for Ty Tag component
 export interface TyTagProps extends Omit<React.HTMLAttributes<HTMLElement>, 'style' | 'onClick'> {
   flavor?: ShadedFlavor | (string & {});
   size?: 'xs' | 'sm' | 'md' | 'lg' | 'xl';
@@ -29,7 +28,6 @@ export interface TyTagProps extends Omit<React.HTMLAttributes<HTMLElement>, 'sty
   children?: React.ReactNode;
 }
 
-// React wrapper for ty-tag web component
 export const TyTag = React.forwardRef<HTMLElement, TyTagProps>(
   ({ children, onClick, onTagDismiss, notPill, clickable, dismissible, disabled, selected, ...props }, ref) => {
     const elementRef = useRef<HTMLElement>(null);
@@ -51,7 +49,6 @@ export const TyTag = React.forwardRef<HTMLElement, TyTagProps>(
       };
     }, [handleDismiss, onTagDismiss]);
 
-    // Handle ref forwarding
     useEffect(() => {
       if (ref && elementRef.current) {
         if (typeof ref === 'function') {

package/src/components/TyTextarea.tsx

@@ -3,13 +3,11 @@ import { hostProps } from '../utils/host-props';
 import { needsPropertyBridge } from '../utils/react-version';
 import { useBooleanProperty } from '../utils/use-boolean-prop';
 
-// Event detail structure for ty-textarea events
 export interface TyTextareaEventDetail {
   value: string; // textarea value
   originalEvent: Event; // original DOM event
 }
 
-// Type definitions for Ty Textarea component
 export interface TyTextareaProps extends Omit<React.HTMLAttributes<HTMLElement>, 'onChange' | 'onInput' | 'onFocus' | 'onBlur' | 'style'> {
   style?: import('./TyInput').TyInputCSSProperties;
   size?: 'xs' | 'sm' | 'md' | 'lg' | 'xl';
@@ -51,7 +49,6 @@ export interface TyTextareaProps extends Omit<React.HTMLAttributes<HTMLElement>,
 // One-time warning flag.
 let _warnedOnInputProp = false;
 
-// React wrapper for ty-textarea web component
 export const TyTextarea = React.forwardRef<HTMLElement, TyTextareaProps>(
   ({ onChange, onChangeCommit, onFocus, onBlur, disabled, required, minHeight, maxHeight, ...props }, ref) => {
     const elementRef = useRef<HTMLElement>(null);
@@ -102,18 +99,14 @@ export const TyTextarea = React.forwardRef<HTMLElement, TyTextareaProps>(
       const element = elementRef.current;
       if (!element) return;
 
-      // Listen for custom input/change events from ty-textarea
-      // 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);
       }
@@ -138,7 +131,6 @@ export const TyTextarea = React.forwardRef<HTMLElement, TyTextareaProps>(
       };
     }, [handleInput, handleChangeCommit, handleFocus, handleBlur, onChange, onChangeCommit, onFocus, onBlur]);
 
-    // Handle ref forwarding
     useEffect(() => {
       if (ref && elementRef.current) {
         if (typeof ref === 'function') {