twico-ui 1.45.0 → 1.45.1

package/dist/index.d.cts

@@ -591,7 +591,17 @@ interface ButtonProps extends React.ButtonHTMLAttributes<HTMLButtonElement> {
   children?: React.ReactNode;
 }
 
-declare function Button(props: ButtonProps): React.JSX.Element;
+/**
+ * #490: forwards `ref` to the `<button>` (or the `<a>` when `as="a"` — `ButtonProps` already commits to
+ * `ButtonHTMLAttributes<HTMLButtonElement>`, so the declared element type follows it).
+ *
+ * Declared rather than left to React 19's implicit pass-through: on React 19 `ref` is an ordinary
+ * prop, so `{...rest}` would land one on the element anyway, but React 18 strips it and the type
+ * denied it on both. `forwardRef` works on both majors — see #488.
+ */
+declare const Button: React.ForwardRefExoticComponent<
+  ButtonProps & React.RefAttributes<HTMLButtonElement>
+>;
 
 /**
  * Surface container for grouped content. Supports header (title/subtitle),
@@ -1604,7 +1614,16 @@ interface CheckboxProps extends Omit<React.InputHTMLAttributes<HTMLInputElement>
   tone?: Tone;
 }
 
-declare function Checkbox(props: CheckboxProps): React.JSX.Element;
+/**
+ * #490: forwards `ref` to the native `<input type="checkbox">`, merged with the internal ref that drives `indeterminate`.
+ *
+ * Declared rather than left to React 19's implicit pass-through: on React 19 `ref` is an ordinary
+ * prop, so `{...rest}` would land one on the element anyway, but React 18 strips it and the type
+ * denied it on both. `forwardRef` works on both majors — see #488.
+ */
+declare const Checkbox: React.ForwardRefExoticComponent<
+  CheckboxProps & React.RefAttributes<HTMLInputElement>
+>;
 
 /**
  * Color picker with a saturation/value square, hue slider, hex input, and
@@ -1745,7 +1764,16 @@ type ComboboxOption = Option;
 /** Alias of the shared {@link OptionGroup} type (kept for backward-compatible imports). */
 type ComboboxGroup = OptionGroup;
 
-declare function Combobox(props: ComboboxProps): React.JSX.Element;
+/**
+ * #490: forwards `ref` to the text `<input>`, merged with the internal ref used for focus and caret handling.
+ *
+ * Declared rather than left to React 19's implicit pass-through: on React 19 `ref` is an ordinary
+ * prop, so `{...rest}` would land one on the element anyway, but React 18 strips it and the type
+ * denied it on both. `forwardRef` works on both majors — see #488.
+ */
+declare const Combobox: React.ForwardRefExoticComponent<
+  ComboboxProps & React.RefAttributes<HTMLInputElement>
+>;
 
 interface Command {
   /** Stable id. */
@@ -3269,7 +3297,16 @@ type MultiSelectOption = Option;
 /** Alias of the shared {@link OptionGroup} type (kept for backward-compatible imports). */
 type MultiSelectGroup = OptionGroup;
 
-declare function MultiSelect(props: MultiSelectProps): React.JSX.Element;
+/**
+ * #490: forwards `ref` to the text `<input>`, merged with the internal ref used for focus and the token-removal keys.
+ *
+ * Declared rather than left to React 19's implicit pass-through: on React 19 `ref` is an ordinary
+ * prop, so `{...rest}` would land one on the element anyway, but React 18 strips it and the type
+ * denied it on both. `forwardRef` works on both majors — see #488.
+ */
+declare const MultiSelect: React.ForwardRefExoticComponent<
+  MultiSelectProps & React.RefAttributes<HTMLInputElement>
+>;
 
 /** The kinds of filter control a field can render. */
 type FilterFieldType = "multiselect" | "daterange" | "search" | "text" | "number" | "boolean" | "select";
@@ -3573,7 +3610,16 @@ interface IconButtonProps extends React.ButtonHTMLAttributes<HTMLButtonElement>
   "aria-label": string;
 }
 
-declare function IconButton(props: IconButtonProps): React.JSX.Element;
+/**
+ * #490: forwards `ref` to the `<button>` (or the `<a>` when `as="a"`, as with `Button`).
+ *
+ * Declared rather than left to React 19's implicit pass-through: on React 19 `ref` is an ordinary
+ * prop, so `{...rest}` would land one on the element anyway, but React 18 strips it and the type
+ * denied it on both. `forwardRef` works on both majors — see #488.
+ */
+declare const IconButton: React.ForwardRefExoticComponent<
+  IconButtonProps & React.RefAttributes<HTMLButtonElement>
+>;
 
 /** One toggle button in a {@link ToggleGroup}. */
 interface ToggleGroupItem {
@@ -3668,7 +3714,10 @@ interface InputProps extends Omit<React.InputHTMLAttributes<HTMLInputElement>, "
   clearable?: boolean;
 }
 
-declare function Input(props: InputProps): React.JSX.Element;
+/** Forwards `ref` to the inner `<input>` (merged with the internal one `clearable` uses). */
+declare const Input: React.ForwardRefExoticComponent<
+  InputProps & React.RefAttributes<HTMLInputElement>
+>;
 
 interface KanbanColumn {
   /** Unique column id (matches a card's `column`). */
@@ -3900,7 +3949,16 @@ interface RadioProps extends Omit<React.InputHTMLAttributes<HTMLInputElement>, "
   tone?: Tone;
 }
 
-declare function Radio(props: RadioProps): React.JSX.Element;
+/**
+ * #490: forwards `ref` to the native `<input type="radio">`.
+ *
+ * Declared rather than left to React 19's implicit pass-through: on React 19 `ref` is an ordinary
+ * prop, so `{...rest}` would land one on the element anyway, but React 18 strips it and the type
+ * denied it on both. `forwardRef` works on both majors — see #488.
+ */
+declare const Radio: React.ForwardRefExoticComponent<
+  RadioProps & React.RefAttributes<HTMLInputElement>
+>;
 
 interface RadioGroupOption {
   /** Submitted value for this choice. */
@@ -4057,7 +4115,16 @@ type SelectOption = Option;
 /** Alias of the shared {@link OptionGroup} type (kept for backward-compatible imports). */
 type SelectGroup = OptionGroup;
 
-declare function Select(props: SelectProps): React.JSX.Element;
+/**
+ * #490: forwards `ref` to the trigger `<button>`, merged with the internal ref used for focus return.
+ *
+ * Declared rather than left to React 19's implicit pass-through: on React 19 `ref` is an ordinary
+ * prop, so `{...rest}` would land one on the element anyway, but React 18 strips it and the type
+ * denied it on both. `forwardRef` works on both majors — see #488.
+ */
+declare const Select: React.ForwardRefExoticComponent<
+  SelectProps & React.RefAttributes<HTMLButtonElement>
+>;
 
 interface SidebarItem {
   /** Item label. */
@@ -4280,7 +4347,16 @@ interface SwitchProps extends Omit<React.InputHTMLAttributes<HTMLInputElement>,
   tone?: Tone;
 }
 
-declare function Switch(props: SwitchProps): React.JSX.Element;
+/**
+ * #490: forwards `ref` to the native `<input role="switch">`.
+ *
+ * Declared rather than left to React 19's implicit pass-through: on React 19 `ref` is an ordinary
+ * prop, so `{...rest}` would land one on the element anyway, but React 18 strips it and the type
+ * denied it on both. `forwardRef` works on both majors — see #488.
+ */
+declare const Switch: React.ForwardRefExoticComponent<
+  SwitchProps & React.RefAttributes<HTMLInputElement>
+>;
 
 /** Sort state: the sorted column field (null = unsorted) and direction. */
 interface TableSort {
@@ -4830,7 +4906,17 @@ interface CodeProps extends React.HTMLAttributes<HTMLElement> {
   rel?: string;
 }
 
-declare function Code(props: CodeProps): React.JSX.Element;
+/**
+ * #490: forwards `ref` to the rendered root (`<code>`, or `<pre>` when `block`, or whatever `as` names), merged with the
+ * internal ref used to read the text for the copy button.
+ *
+ * Declared rather than left to React 19's implicit pass-through: on React 19 `ref` is an ordinary
+ * prop, so `{...rest}` would land one on the element anyway, but React 18 strips it and the type
+ * denied it on both. `forwardRef` works on both majors — see #488.
+ */
+declare const Code: React.ForwardRefExoticComponent<
+  CodeProps & React.RefAttributes<HTMLElement>
+>;
 
 /** Font-size token suffixes available to `Heading` (see tokens/typography.css). */
 type HeadingSize =

package/dist/index.d.ts

@@ -591,7 +591,17 @@ interface ButtonProps extends React.ButtonHTMLAttributes<HTMLButtonElement> {
   children?: React.ReactNode;
 }
 
-declare function Button(props: ButtonProps): React.JSX.Element;
+/**
+ * #490: forwards `ref` to the `<button>` (or the `<a>` when `as="a"` — `ButtonProps` already commits to
+ * `ButtonHTMLAttributes<HTMLButtonElement>`, so the declared element type follows it).
+ *
+ * Declared rather than left to React 19's implicit pass-through: on React 19 `ref` is an ordinary
+ * prop, so `{...rest}` would land one on the element anyway, but React 18 strips it and the type
+ * denied it on both. `forwardRef` works on both majors — see #488.
+ */
+declare const Button: React.ForwardRefExoticComponent<
+  ButtonProps & React.RefAttributes<HTMLButtonElement>
+>;
 
 /**
  * Surface container for grouped content. Supports header (title/subtitle),
@@ -1604,7 +1614,16 @@ interface CheckboxProps extends Omit<React.InputHTMLAttributes<HTMLInputElement>
   tone?: Tone;
 }
 
-declare function Checkbox(props: CheckboxProps): React.JSX.Element;
+/**
+ * #490: forwards `ref` to the native `<input type="checkbox">`, merged with the internal ref that drives `indeterminate`.
+ *
+ * Declared rather than left to React 19's implicit pass-through: on React 19 `ref` is an ordinary
+ * prop, so `{...rest}` would land one on the element anyway, but React 18 strips it and the type
+ * denied it on both. `forwardRef` works on both majors — see #488.
+ */
+declare const Checkbox: React.ForwardRefExoticComponent<
+  CheckboxProps & React.RefAttributes<HTMLInputElement>
+>;
 
 /**
  * Color picker with a saturation/value square, hue slider, hex input, and
@@ -1745,7 +1764,16 @@ type ComboboxOption = Option;
 /** Alias of the shared {@link OptionGroup} type (kept for backward-compatible imports). */
 type ComboboxGroup = OptionGroup;
 
-declare function Combobox(props: ComboboxProps): React.JSX.Element;
+/**
+ * #490: forwards `ref` to the text `<input>`, merged with the internal ref used for focus and caret handling.
+ *
+ * Declared rather than left to React 19's implicit pass-through: on React 19 `ref` is an ordinary
+ * prop, so `{...rest}` would land one on the element anyway, but React 18 strips it and the type
+ * denied it on both. `forwardRef` works on both majors — see #488.
+ */
+declare const Combobox: React.ForwardRefExoticComponent<
+  ComboboxProps & React.RefAttributes<HTMLInputElement>
+>;
 
 interface Command {
   /** Stable id. */
@@ -3269,7 +3297,16 @@ type MultiSelectOption = Option;
 /** Alias of the shared {@link OptionGroup} type (kept for backward-compatible imports). */
 type MultiSelectGroup = OptionGroup;
 
-declare function MultiSelect(props: MultiSelectProps): React.JSX.Element;
+/**
+ * #490: forwards `ref` to the text `<input>`, merged with the internal ref used for focus and the token-removal keys.
+ *
+ * Declared rather than left to React 19's implicit pass-through: on React 19 `ref` is an ordinary
+ * prop, so `{...rest}` would land one on the element anyway, but React 18 strips it and the type
+ * denied it on both. `forwardRef` works on both majors — see #488.
+ */
+declare const MultiSelect: React.ForwardRefExoticComponent<
+  MultiSelectProps & React.RefAttributes<HTMLInputElement>
+>;
 
 /** The kinds of filter control a field can render. */
 type FilterFieldType = "multiselect" | "daterange" | "search" | "text" | "number" | "boolean" | "select";
@@ -3573,7 +3610,16 @@ interface IconButtonProps extends React.ButtonHTMLAttributes<HTMLButtonElement>
   "aria-label": string;
 }
 
-declare function IconButton(props: IconButtonProps): React.JSX.Element;
+/**
+ * #490: forwards `ref` to the `<button>` (or the `<a>` when `as="a"`, as with `Button`).
+ *
+ * Declared rather than left to React 19's implicit pass-through: on React 19 `ref` is an ordinary
+ * prop, so `{...rest}` would land one on the element anyway, but React 18 strips it and the type
+ * denied it on both. `forwardRef` works on both majors — see #488.
+ */
+declare const IconButton: React.ForwardRefExoticComponent<
+  IconButtonProps & React.RefAttributes<HTMLButtonElement>
+>;
 
 /** One toggle button in a {@link ToggleGroup}. */
 interface ToggleGroupItem {
@@ -3668,7 +3714,10 @@ interface InputProps extends Omit<React.InputHTMLAttributes<HTMLInputElement>, "
   clearable?: boolean;
 }
 
-declare function Input(props: InputProps): React.JSX.Element;
+/** Forwards `ref` to the inner `<input>` (merged with the internal one `clearable` uses). */
+declare const Input: React.ForwardRefExoticComponent<
+  InputProps & React.RefAttributes<HTMLInputElement>
+>;
 
 interface KanbanColumn {
   /** Unique column id (matches a card's `column`). */
@@ -3900,7 +3949,16 @@ interface RadioProps extends Omit<React.InputHTMLAttributes<HTMLInputElement>, "
   tone?: Tone;
 }
 
-declare function Radio(props: RadioProps): React.JSX.Element;
+/**
+ * #490: forwards `ref` to the native `<input type="radio">`.
+ *
+ * Declared rather than left to React 19's implicit pass-through: on React 19 `ref` is an ordinary
+ * prop, so `{...rest}` would land one on the element anyway, but React 18 strips it and the type
+ * denied it on both. `forwardRef` works on both majors — see #488.
+ */
+declare const Radio: React.ForwardRefExoticComponent<
+  RadioProps & React.RefAttributes<HTMLInputElement>
+>;
 
 interface RadioGroupOption {
   /** Submitted value for this choice. */
@@ -4057,7 +4115,16 @@ type SelectOption = Option;
 /** Alias of the shared {@link OptionGroup} type (kept for backward-compatible imports). */
 type SelectGroup = OptionGroup;
 
-declare function Select(props: SelectProps): React.JSX.Element;
+/**
+ * #490: forwards `ref` to the trigger `<button>`, merged with the internal ref used for focus return.
+ *
+ * Declared rather than left to React 19's implicit pass-through: on React 19 `ref` is an ordinary
+ * prop, so `{...rest}` would land one on the element anyway, but React 18 strips it and the type
+ * denied it on both. `forwardRef` works on both majors — see #488.
+ */
+declare const Select: React.ForwardRefExoticComponent<
+  SelectProps & React.RefAttributes<HTMLButtonElement>
+>;
 
 interface SidebarItem {
   /** Item label. */
@@ -4280,7 +4347,16 @@ interface SwitchProps extends Omit<React.InputHTMLAttributes<HTMLInputElement>,
   tone?: Tone;
 }
 
-declare function Switch(props: SwitchProps): React.JSX.Element;
+/**
+ * #490: forwards `ref` to the native `<input role="switch">`.
+ *
+ * Declared rather than left to React 19's implicit pass-through: on React 19 `ref` is an ordinary
+ * prop, so `{...rest}` would land one on the element anyway, but React 18 strips it and the type
+ * denied it on both. `forwardRef` works on both majors — see #488.
+ */
+declare const Switch: React.ForwardRefExoticComponent<
+  SwitchProps & React.RefAttributes<HTMLInputElement>
+>;
 
 /** Sort state: the sorted column field (null = unsorted) and direction. */
 interface TableSort {
@@ -4830,7 +4906,17 @@ interface CodeProps extends React.HTMLAttributes<HTMLElement> {
   rel?: string;
 }
 
-declare function Code(props: CodeProps): React.JSX.Element;
+/**
+ * #490: forwards `ref` to the rendered root (`<code>`, or `<pre>` when `block`, or whatever `as` names), merged with the
+ * internal ref used to read the text for the copy button.
+ *
+ * Declared rather than left to React 19's implicit pass-through: on React 19 `ref` is an ordinary
+ * prop, so `{...rest}` would land one on the element anyway, but React 18 strips it and the type
+ * denied it on both. `forwardRef` works on both majors — see #488.
+ */
+declare const Code: React.ForwardRefExoticComponent<
+  CodeProps & React.RefAttributes<HTMLElement>
+>;
 
 /** Font-size token suffixes available to `Heading` (see tokens/typography.css). */
 type HeadingSize =