import { InputOTP, Label, Description } from "heroui-native";

export function Example() {
  return (
    <>
      <Label>Verify account</Label>
      <InputOTP maxLength={6} onComplete={(code) => console.log(code)}>
        <InputOTP.Group>
          <InputOTP.Slot index={0} />
          <InputOTP.Slot index={1} />
          <InputOTP.Slot index={2} />
        </InputOTP.Group>
        <InputOTP.Separator />
        <InputOTP.Group>
          <InputOTP.Slot index={3} />
          <InputOTP.Slot index={4} />
          <InputOTP.Slot index={5} />
        </InputOTP.Group>
      </InputOTP>
      <Description>We've sent a code to your email</Description>
    </>
  );
}

完整文档与示例见 InputOTP 组件页。

相关 PR： #214

Label

Label 为表单字段提供无障碍标签，内置必填星号、校验态与禁用态，并随字段校验状态自适应样式。

特性：

必填字段自动显示星号
非法态样式
禁用态支持
复合结构便于自定义布局
通过 nativeID 关联的完整无障碍支持
支持 className、classNames、styles 定制样式

用法：

import { Label, TextField } from "heroui-native";

export function Example() {
  return (
    <TextField>
      <Label isRequired>Password</Label>
      <TextField.Input placeholder="Create a password" secureTextEntry />
    </TextField>
  );
}

完整文档与示例见 Label 组件页。

相关 PR： #214

Description

Description 为表单字段提供无障碍辅助说明，默认弱化样式，并可通过 nativeID 与字段关联以支持读屏。

特性：

适合辅助文案的弱化文本样式
通过 nativeID 与 aria-describedby 关联无障碍
与表单组件无缝集成
支持自定义样式

用法：

import { Description, TextField } from "heroui-native";

export function Example() {
  return (
    <TextField>
      <TextField.Label>Email address</TextField.Label>
      <TextField.Input
        placeholder="Enter your email"
        keyboardType="email-address"
        aria-describedby="email-desc"
      />
      <Description nativeID="email-desc">
        We'll never share your email with anyone else.
      </Description>
    </TextField>
  );
}

完整文档与示例见 Description 组件页。

相关 PR： #214

组件改进

Popover 已修复通过 ref 程序化关闭时的行为。

改进：

基于 ref 的关闭方法现能正确触发关闭动画
ref 调用与组件内部状态的同步改进
程序化关闭更可靠

确保调用 popoverRef.current?.close() 时能可靠关闭并正确管理状态与动画。

相关 PR： #207

弹层受控状态修复

Dialog、Bottom Sheet、Popover 等弹层组件已修复通过 isOpen 的受控状态。

改进：

受控状态同步修复
外部状态变更的处理改进
受控模式下行为更可预期

相关 PR： #215

Button、Chip、Tabs 圆角修复

Button、Chip、Tabs 已修复对全局圆角配置的尊重。

改进：

Button 全局圆角应用修复
Chip 圆角应用修复
Tabs 圆角应用修复
使用全局主题配置的组件间一致性提升

相关 PR： #218

TextField.Input 属性精简

TextField 的 Input 子组件已移除 animation 与 isAnimatedStyleActive。

变更：

自 TextField.Input 移除 animation
自 TextField.Input 移除 isAnimatedStyleActive
API 简化，更易维护

动画行为现由组件内部统一处理，无需手动配置动画属性。

相关 PR： #220

API 增强

HeroUINativeProvider 的 devInfo 配置

HeroUINativeProvider 现支持 devInfo 配置项，便于开发与调试。

新能力：

import { HeroUINativeProvider } from "heroui-native";

export function App() {
  return (
    <HeroUINativeProvider
      devInfo={{
        // 开发期配置项
      }}
    >
      {/* 应用内容 */}
    </HeroUINativeProvider>
  );
}

相关 PR： #217

变体样式属性支持

Checkbox、Radio、TextField、InputOTP 现支持通过 variant 样式属性更便捷地覆盖变体样式。

新能力：

import { Checkbox, Radio, TextField, InputOTP } from "heroui-native";

<Checkbox variant="bordered" style={{ variant: "flat" }}>
  Option 1
</Checkbox>

<Radio variant="solid" style={{ variant: "bordered" }}>
  Option 2
</Radio>

<TextField variant="underlined" style={{ variant: "bordered" }}>
  <TextField.Input />
</TextField>