tyrell-react 1.0.0-RC13 → 1.0.0-RC14

package/src/components/TyCalendarMonth.tsx

@@ -1,10 +1,9 @@
 import React, { useEffect, useRef } from 'react';
 import { hostProps } from '../utils/host-props';
 
-type BuiltinFlavor = 'primary' | 'secondary' | 'success' | 'danger' | 'warning' | 'neutral';
+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;
@@ -52,7 +51,6 @@ export interface DayClickDetail {
   isOtherMonth: boolean;
 }
 
-// React wrapper for ty-calendar-month web component
 export const TyCalendarMonth = React.forwardRef<HTMLElement, TyCalendarMonthProps>(
   ({ 
     displayYear,
@@ -70,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;
@@ -88,7 +85,6 @@ export const TyCalendarMonth = React.forwardRef<HTMLElement, TyCalendarMonthProp
       };
     }, [onDayClick]);
 
-    // Combine refs if needed
     useEffect(() => {
       if (ref && elementRef.current) {
         if (typeof ref === 'function') {
@@ -99,13 +95,11 @@ export const TyCalendarMonth = React.forwardRef<HTMLElement, TyCalendarMonthProp
       }
     }, [ref]);
 
-    // Convert React props to web component attributes
     const webComponentProps: Record<string, any> = {
       ...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;

package/src/components/TyCalendarNavigation.tsx

@@ -1,7 +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;
@@ -33,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,
@@ -48,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;
@@ -66,7 +63,6 @@ export const TyCalendarNavigation = React.forwardRef<HTMLElement, TyCalendarNavi
       };
     }, [onChange]);
 
-    // Combine refs if needed
     useEffect(() => {
       if (ref && elementRef.current) {
         if (typeof ref === 'function') {
@@ -77,13 +73,11 @@ export const TyCalendarNavigation = React.forwardRef<HTMLElement, TyCalendarNavi
       }
     }, [ref]);
 
-    // Convert React props to web component attributes
     const webComponentProps: Record<string, any> = {
       ...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

@@ -2,10 +2,9 @@ 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 definitions for Ty Checkbox component
 export interface TyCheckboxProps extends Omit<React.HTMLAttributes<HTMLElement>, 'onChange' | 'onInput'> {
   /** Checked state */
   checked?: boolean;
@@ -57,7 +56,6 @@ export interface TyCheckboxEventDetail {
   originalEvent: Event;
 }
 
-// React wrapper for ty-checkbox web component
 export const TyCheckbox = React.forwardRef<HTMLElement, TyCheckboxProps>(
   ({ 
     children,
@@ -76,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;
@@ -95,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 () => {
@@ -107,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') {
@@ -127,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> = {
       ...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

@@ -2,10 +2,9 @@ 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 definitions for Ty Copy component
 export interface TyCopyProps extends Omit<React.HTMLAttributes<HTMLElement>, 'onChange'> {
   /** Text to copy */
   value?: string;
@@ -38,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,
@@ -55,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') {
@@ -66,7 +63,6 @@ export const TyCopy = React.forwardRef<HTMLElement, TyCopyProps>(
       }
     }, [ref]);
 
-    // Custom events → React callbacks
     useEffect(() => {
       const el = elementRef.current;
       if (!el) return;
@@ -86,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> = {
       ...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

@@ -3,10 +3,14 @@ import { hostProps } from '../utils/host-props';
 import { needsPropertyBridge } from '../utils/react-version';
 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 DatePicker component
 export interface TyDatePickerEventDetail {
   /** The selected date value (ISO string or formatted string based on format) */
   value: string | null;
@@ -60,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;
   
@@ -76,7 +83,6 @@ export interface TyDatePickerElement extends HTMLElement {
   clear(): void;
 }
 
-// React wrapper for ty-date-picker web component
 export const TyDatePicker = React.forwardRef<TyDatePickerElement, TyDatePickerProps>(
   ({ 
     value,
@@ -93,6 +99,7 @@ export const TyDatePicker = React.forwardRef<TyDatePickerElement, TyDatePickerPr
     withTime,
     min,
     max,
+    placement,
     onChange,
     onOpen,
     onClose,
@@ -100,7 +107,6 @@ export const TyDatePicker = React.forwardRef<TyDatePickerElement, TyDatePickerPr
   }, ref) => {
     const elementRef = useRef<TyDatePickerElement>(null);
 
-    // Handle ref forwarding
     useEffect(() => {
       if (ref && elementRef.current) {
         if (typeof ref === 'function') {
@@ -118,12 +124,10 @@ export const TyDatePicker = React.forwardRef<TyDatePickerElement, TyDatePickerPr
       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) {
@@ -131,10 +135,8 @@ export const TyDatePicker = React.forwardRef<TyDatePickerElement, TyDatePickerPr
       }
     }, [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<{}>);
@@ -145,7 +147,6 @@ export const TyDatePicker = React.forwardRef<TyDatePickerElement, TyDatePickerPr
       if (onClose) onClose(event as CustomEvent<{}>);
     }, [onClose]);
 
-    // Set up event listeners
     useEffect(() => {
       const element = elementRef.current;
       if (!element) return;
@@ -174,13 +175,11 @@ export const TyDatePicker = React.forwardRef<TyDatePickerElement, TyDatePickerPr
       };
     }, [handleChange, handleOpen, handleClose, onChange, 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 (value !== undefined) {
       webComponentProps.value = value;
     }
@@ -233,6 +232,10 @@ export const TyDatePicker = React.forwardRef<TyDatePickerElement, TyDatePickerPr
       webComponentProps.max = max;
     }
 
+    if (placement) {
+      webComponentProps.placement = placement;
+    }
+
     return React.createElement('ty-date-picker', webComponentProps);
   }
 );

package/src/components/TyFileUpload.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 File Upload component
 export interface TyFileUploadProps extends Omit<React.HTMLAttributes<HTMLElement>, 'onChange'> {
   /** Form field name — used as the FormData key */
   name?: string;
@@ -41,7 +40,6 @@ export interface TyFileUploadEventDetail {
   names: string[];
 }
 
-// React wrapper for ty-file-upload web component
 export const TyFileUpload = React.forwardRef<HTMLElement, TyFileUploadProps>(
   ({
     name,

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

@@ -3,10 +3,9 @@ import { hostProps } from '../utils/host-props';
 import { needsPropertyBridge } from '../utils/react-version';
 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}-`;
 
-// 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;
@@ -27,12 +25,28 @@ export interface TyModalProps extends React.HTMLAttributes<HTMLElement> {
   /** Show backdrop behind modal (default: true) */
   backdrop?: boolean;
 
-  /** Allow closing modal by clicking backdrop (default: true) */
+  /**
+   * @deprecated Use `preventOutsideClick` — string-boolean attrs are being
+   * phased out. Still works; prevent-* wins when both are set.
+   */
   closeOnOutsideClick?: boolean;
 
-  /** Allow closing modal with Escape key (default: true) */
+  /**
+   * @deprecated Use `preventEscape` — string-boolean attrs are being phased
+   * out. Still works; prevent-* wins when both are set.
+   */
   closeOnEscape?: boolean;
 
+  /** Backdrop clicks no longer close the modal (also hides the built-in ✕) */
+  preventOutsideClick?: boolean;
+
+  /**
+   * ESC no longer closes the modal (keydown is consumed, so the browser's
+   * double-ESC anti-trap never fires). A fully guarded modal must render its
+   * own close control — WCAG 2.1.2.
+   */
+  preventEscape?: boolean;
+
   /**
    * Accessible name — sets aria-label on the internal <dialog>. The dialog
    * gets role="dialog" for free, but nothing names it unless you set this.
@@ -52,7 +66,6 @@ export interface TyModalProps extends React.HTMLAttributes<HTMLElement> {
   children?: React.ReactNode;
 }
 
-// Ref interface for imperative methods
 export interface TyModalRef {
   show: () => void;
   /**
@@ -64,13 +77,14 @@ export interface TyModalRef {
   element: HTMLElement | null;
 }
 
-// React wrapper for ty-modal web component
 export const TyModal = React.forwardRef<TyModalRef, TyModalProps>(
   ({
     open,
     backdrop,
     closeOnOutsideClick,
     closeOnEscape,
+    preventOutsideClick,
+    preventEscape,
     label,
     onOpen,
     onClose,
@@ -80,7 +94,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,17 +108,12 @@ 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
-    // modal's slotted content and land on the ty-modal host — same event
-    // type, same listener. Without the `event.target === element` guard, an
-    // `onClose={() => setIsOpen(false)}` callback would fire every time the
-    // user closes a dropdown inside the modal, and the React state flip
-    // would close the modal. Core's modal.ts already applies the same guard
-    // on its internal <dialog>.onclose; this is the React-layer mirror.
+    // Popup lifecycle events (`open`/`close`, plus `beforeclose` on the modal)
+    // no longer bubble — core dispatches them non-composed on the element
+    // itself, like the native <dialog> events they mirror, so a dropdown or
+    // nested modal closing inside this one can't reach these listeners. The
+    // `event.target === element` guard stays as belt-and-braces for consumers
+    // pinned to an older tyrell-components.
     useEffect(() => {
       const element = elementRef.current;
       if (!element) return;
@@ -125,7 +133,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);
       }
@@ -170,9 +177,10 @@ export const TyModal = React.forwardRef<TyModalRef, TyModalProps>(
       setIf('backdrop', backdrop);
       setIf('closeOnOutsideClick', closeOnOutsideClick);
       setIf('closeOnEscape', closeOnEscape);
-    }, [backdrop, closeOnOutsideClick, closeOnEscape]);
+      setIf('preventOutsideClick', preventOutsideClick);
+      setIf('preventEscape', preventEscape);
+    }, [backdrop, closeOnOutsideClick, closeOnEscape, preventOutsideClick, preventEscape]);
 
-    // Convert React props to web component attributes
     const webComponentProps: Record<string, any> = {
       ...hostProps(props),
       ref: elementRef,
@@ -191,6 +199,13 @@ export const TyModal = React.forwardRef<TyModalRef, TyModalProps>(
     if (closeOnEscape !== undefined && !coerceBool(closeOnEscape)) {
       webComponentProps['close-on-escape'] = 'false';
     }
+    // Presence booleans: render the bare attribute only when true
+    if (preventOutsideClick !== undefined && coerceBool(preventOutsideClick)) {
+      webComponentProps['prevent-outside-click'] = '';
+    }
+    if (preventEscape !== undefined && coerceBool(preventEscape)) {
+      webComponentProps['prevent-escape'] = '';
+    }
     if (label) webComponentProps.label = label;
 
     return React.createElement(

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;
 
@@ -14,7 +13,7 @@ export interface TyOptionProps extends React.HTMLAttributes<HTMLElement> {
   label?: string;
 
   /** Semantic flavor — carried onto ty-selected-options chips */
-  flavor?: 'primary' | 'secondary' | 'success' | 'danger' | 'warning' | 'neutral' | 'info';
+  flavor?: 'primary' | 'success' | 'danger' | 'warning' | 'neutral' | 'info';
 
   disabled?: boolean;
   selected?: boolean;
@@ -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') {