tyrell-react 1.0.0-RC13 → 1.0.0-RC15

package/src/components/TyTag.tsx

@@ -2,7 +2,7 @@ import React, { useEffect, useRef, useCallback } from 'react';
 import { hostProps } from '../utils/host-props';
 import { useBooleanProperty } from '../utils/use-boolean-prop';
 
-type BuiltinFlavor = 'primary' | 'secondary' | 'success' | 'danger' | 'warning' | 'neutral';
+type BuiltinFlavor = 'primary' | 'success' | 'danger' | 'warning' | 'neutral';
 type ShadedFlavor = BuiltinFlavor | `${BuiltinFlavor}+` | `${BuiltinFlavor}-`;
 
 // CSS custom properties that cascade into the shadow DOM for full color control
@@ -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') {

package/src/components/TyTooltip.tsx

@@ -2,13 +2,17 @@ import React, { useEffect, useRef } from 'react';
 import { hostProps } from '../utils/host-props';
 import { useBooleanProperty } from '../utils/use-boolean-prop';
 
-type BuiltinFlavor = 'primary' | 'secondary' | 'success' | 'danger' | 'warning' | 'neutral';
+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';
 
-// Type definitions for Ty Tooltip component
 export interface TyTooltipProps extends React.HTMLAttributes<HTMLElement> {
-  /** Tooltip positioning relative to the parent element */
-  placement?: 'top' | 'bottom' | 'left' | 'right';
+  /** Tooltip positioning relative to the parent element: a side plus an optional cross-axis alignment (e.g. "bottom-start") */
+  placement?: Placement;
   
   /** Distance in pixels from the anchor element (default: 8) */
   offset?: number;
@@ -26,7 +30,6 @@ export interface TyTooltipProps extends React.HTMLAttributes<HTMLElement> {
   children?: React.ReactNode;
 }
 
-// React wrapper for ty-tooltip web component
 export const TyTooltip = React.forwardRef<HTMLElement, TyTooltipProps>(
   ({ 
     placement, 
@@ -39,7 +42,6 @@ export const TyTooltip = React.forwardRef<HTMLElement, TyTooltipProps>(
   }, ref) => {
     const elementRef = useRef<HTMLElement>(null);
 
-    // Handle ref forwarding
     useEffect(() => {
       if (ref && elementRef.current) {
         if (typeof ref === 'function') {
@@ -50,13 +52,11 @@ export const TyTooltip = React.forwardRef<HTMLElement, TyTooltipProps>(
       }
     }, [ref]);
 
-    // 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/TyWizard.tsx

@@ -1,7 +1,6 @@
 import React, { useEffect, useRef } from 'react';
 import { hostProps } from '../utils/host-props';
 
-// Type definitions for Ty Wizard component
 export interface TyWizardProps extends Omit<React.HTMLAttributes<HTMLElement>, 'onChange'> {
   /** Content area width (accepts px or %) */
   width?: string;
@@ -33,7 +32,6 @@ export interface WizardStepChangeDetail {
   direction: 'forward' | 'backward' | 'none';
 }
 
-// React wrapper for ty-wizard web component
 export const TyWizard = React.forwardRef<HTMLElement, TyWizardProps>(
   ({
     children,
@@ -47,7 +45,6 @@ export const TyWizard = React.forwardRef<HTMLElement, TyWizardProps>(
   }, ref) => {
     const elementRef = useRef<HTMLElement>(null);
 
-    // Handle step change events
     useEffect(() => {
       const element = elementRef.current;
       if (!element) return;
@@ -65,7 +62,6 @@ export const TyWizard = React.forwardRef<HTMLElement, TyWizardProps>(
       };
     }, [onStepChange]);
 
-    // Combine refs if needed
     useEffect(() => {
       if (ref && elementRef.current) {
         if (typeof ref === 'function') {
@@ -76,13 +72,11 @@ export const TyWizard = React.forwardRef<HTMLElement, TyWizardProps>(
       }
     }, [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/index.ts

@@ -1,7 +1,3 @@
-// ===================================================================
-// VERSION
-// ===================================================================
-
 import { VERSION } from '../version';
 
 /** Current version of tyrell-react (auto-synced with package.json on build). */
@@ -19,18 +15,8 @@ if (typeof window !== 'undefined') {
   );
 }
 
-// ===================================================================
-// TYRELL REACT WRAPPER EXPORTS
-// ===================================================================
-// This file provides two export styles for maximum developer flexibility:
-// 1. Ty-prefixed exports (TyButton, TyInput) - explicit and backward compatible
-// 2. Short name exports (Button, Input) - clean and familiar to React developers
-//
-// Choose the style that fits your team's preferences!
-
-// ===================================================================
-// TY-PREFIXED EXPORTS (Explicit Style - Backward Compatible)
-// ===================================================================
+// Every component is exported twice: Ty-prefixed (TyButton) and short
+// (Button). Both names point at the same wrapper — pick one per project.
 
 export { TyButton } from './TyButton';
 export type { TyButtonProps, TyButtonCSSProperties } from './TyButton';
@@ -116,11 +102,6 @@ export type { TyResizeObserverProps } from './TyResizeObserver';
 export { TyScrollContainer } from './TyScrollContainer';
 export type { TyScrollContainerProps, TyScrollContainerRef } from './TyScrollContainer';
 
-
-// ===================================================================
-// SHORT NAME EXPORTS (Clean Style - Developer Choice)
-// ===================================================================
-
 export { TyButton as Button } from './TyButton';
 export { TyTag as Tag } from './TyTag';
 export { TyInput as Input } from './TyInput';
@@ -147,128 +128,52 @@ export { TyStep as Step } from './TyStep';
 export { TyResizeObserver as ResizeObserver } from './TyResizeObserver';
 export { TyScrollContainer as ScrollContainer } from './TyScrollContainer';
 
-// ===================================================================
-// TYPE ALIASES (Both Styles Supported)
-// ===================================================================
-
-// Button types
 export type { TyButtonProps as ButtonProps } from './TyButton';
 
-// Tag types
 export type { TyTagProps as TagProps } from './TyTag';
 
-// Input types
 export type { TyInputProps as InputProps, TyInputEventDetail as InputEventDetail } from './TyInput';
 
-// Textarea types
 export type { TyTextareaProps as TextareaProps, TyTextareaEventDetail as TextareaEventDetail } from './TyTextarea';
 
-// Option types
 export type { TyOptionProps as OptionProps } from './TyOption';
 
-// Icon types
 export type { TyIconProps as IconProps } from './TyIcon';
 
-// Modal types
 export type { TyModalProps as ModalProps, TyModalEventDetail as ModalEventDetail, TyModalRef as ModalRef } from './TyModal';
 
-// Tooltip types
 export type { TyTooltipProps as TooltipProps } from './TyTooltip';
 
-// Calendar types
 export type { TyCalendarProps as CalendarProps, TyCalendarChangeEventDetail as CalendarChangeEventDetail, TyCalendarNavigateEventDetail as CalendarNavigateEventDetail } from './TyCalendar';
 
-// DatePicker types
 export type { TyDatePickerProps as DatePickerProps, TyDatePickerEventDetail as DatePickerEventDetail } from './TyDatePicker';
 
-// Popup types
 export type { TyPopupProps as PopupProps, TyPopupElement as PopupElement } from './TyPopup';
 
-// Checkbox types
 export type { TyCheckboxProps as CheckboxProps, TyCheckboxEventDetail as CheckboxEventDetail } from './TyCheckbox';
 
-// Switch types
 export type { TySwitchProps as SwitchProps, TySwitchEventDetail as SwitchEventDetail } from './TySwitch';
 
-// Radio types
 export type { TyRadioProps as RadioProps } from './TyRadio';
 
-// RadioGroup types
 export type { TyRadioGroupProps as RadioGroupProps, TyRadioGroupEventDetail as RadioGroupEventDetail } from './TyRadioGroup';
 
-// Copy types
 export type { TyCopyProps as CopyProps } from './TyCopy';
 
-// FileUpload types
 export type { TyFileUploadProps as FileUploadProps, TyFileUploadEventDetail as FileUploadEventDetail } from './TyFileUpload';
 
-// Tabs types
 export type { TyTabsProps as TabsProps } from './TyTabs';
 
-// Tab types
 export type { TyTabProps as TabProps } from './TyTab';
 
-// CalendarMonth types
 export type { TyCalendarMonthProps as CalendarMonthProps } from './TyCalendarMonth';
 
-// CalendarNavigation types
 export type { TyCalendarNavigationProps as CalendarNavigationProps } from './TyCalendarNavigation';
 
-// Wizard types
 export type { TyWizardProps as WizardProps, WizardStepChangeDetail as StepChangeDetail } from './TyWizard';
 
-// Step types
 export type { TyStepProps as StepProps } from './TyStep';
 
-// ResizeObserver types
 export type { TyResizeObserverProps as ResizeObserverProps } from './TyResizeObserver';
 
-// ScrollContainer types
 export type { TyScrollContainerProps as ScrollContainerProps, TyScrollContainerRef as ScrollContainerRef } from './TyScrollContainer';
-
-// ===================================================================
-// USAGE EXAMPLES
-// ===================================================================
-
-/*
-
-// STYLE 1: Ty-prefixed (Explicit and backward compatible)
-import { TyButton, TyInput, TyModal } from 'tyrell-react';
-import type { TyButtonProps, TyInputProps } from 'tyrell-react';
-
-function MyComponent() {
-  return (
-    <TyModal>
-      <TyInput placeholder="Enter text..." />
-      <TyButton>Submit</TyButton>
-    </TyModal>
-  );
-}
-
-// STYLE 2: Short names (Clean and familiar)
-import { Button, Input, Modal } from 'tyrell-react';
-import type { ButtonProps, InputProps } from 'tyrell-react';
-
-function MyComponent() {
-  return (
-    <Modal>
-      <Input placeholder="Enter text..." />
-      <Button>Submit</Button>
-    </Modal>
-  );
-}
-
-// STYLE 3: Mixed (Team preferences)
-import { TyModal, Input, Button } from 'tyrell-react';
-import type { TyModalProps, InputProps } from 'tyrell-react';
-
-function MyComponent() {
-  return (
-    <TyModal>
-      <Input placeholder="Enter text..." />
-      <Button>Submit</Button>
-    </TyModal>
-  );
-}
-
-*/

package/src/version.ts

@@ -3,4 +3,4 @@
 // Run 'npm run generate:version' to regenerate.
 
 /** Current version of tyrell-react. Synced with package.json on build. */
-export const VERSION = '1.0.0-RC13'
+export const VERSION = '1.0.0-RC15'