# @hanzo/composer 中文文档

规范地址：https://npmcn.com/package/%40hanzo/composer/

版本：0\.2\.1
npm 元数据更新时间：2026-10-30T16:30:52.028Z
中文译文更新时间：2026-11-17T08:13:00.266Z
软件包许可：MIT

本文由上游 README 翻译，可能存在偏差，请结合原文核对 API、命令与配置。版权与许可归原作者所有。

原始 npm 页面：https://www.npmjs.com/package/%40hanzo/composer
原文对照：https://npmcn.com/package/%40hanzo/composer/?lang=original

## 关键信息（来自 npm 元数据）

- 包体积（解压后）：29.9 kB，7 个文件
- 模块格式：ES Module
- TypeScript 类型：包内自带
- 运行依赖：0 个
- peer 依赖：react \>=19\.2\.8，@hanzo/gui ^8\.3\.5
- 首次发布：2026-08-15T17:19:58.274Z
- 最新版本发布：2026-10-30T16:30:51.865Z
- 近 30 天下载量：10121（2026-10-17 至 2026-11-15，npm 官方下载统计）
- 已发布版本数：6（近 12 个月 6 个）

## 中文简介

作曲家的材料——围绕可以打入的任何字的点亮环,作为@hanzo/gui组件.

## 安装

```sh
npm install @hanzo/composer
```

也可以使用：`pnpm add @hanzo/composer`、`yarn add @hanzo/composer`、`bun add @hanzo/composer`

## README

# @hanzo/composer (英语)

以@hanzo/gui组件的形式, 这个 同样的材料在hannzo.ai,hannzo。 聊天和韩佐. app.

```bash
pnpm add @hanzo/composer
```

```tsx
import { Composer, Control, Field } from '@hanzo/composer'

<Composer render="form" onSubmit={send} width="100%" maxW={576} mx="auto">
  <XStack items="center" gap="$1.5" p="$1" rounded="$10">{/* your panel */}
    <Field value={draft} onChangeText={setDraft} placeholder="Ask anything" />
    <Control asChild>
      <Voice voice={voice} />
    </Control>
    <Control type="submit" aria-label="Send" fill>
      <ArrowUp size={15} />
    </Control>
  </XStack>
</Composer>
```

主机包起地表自有面板. 这个包裹拥有戒指,光环, 圆控件和字段的重置; 它没有关于什么打字的内容 已经 一个主机没有写 CSS 的反对: 每幅画都是一个 Gui 道具读取 a @hanzo/设计标志.

## 作曲家

| 道具 |  |  |
| --- | --- | --- |
| `band` | `1.5` | 指环宽度,px. 也是主机的垫子:一个号码,读了两次. |
| `halo` | `6` | 光环离盒子有多远. |
| `control` | `34` | 圆控框,px,在 `--density`。 。 。 . |

任何 Gui 视图道具沿途运行(`render`, (中文(简体) ), `width`, (中文(简体) ), `maxW`, (中文(简体) ), `mx`(中文(简体) ). 转角是 `--radius-composer`药片是地板 戒指在那边 `.5` 移动 改为 `.8` 在指针下; 聚焦保持其余值, 因为护身符已经 说重点在哪里。 光环还在 `.22`,模糊的16px.

## 控制权

大小的圆圈 `Composer` 名称,缩放 `--density` 下楼 24px (WCAG 2.5.8 AA). `size` 在作曲家之外命名自己的盒子. `fill` 这是 发送 : `--primary` 打开 `--primary-foreground`在休息的时候 `--muted` 打开 `--text-secondary`它会升到 `--primary` 在指针下 控制另一个 包画会穿透形状 `asChild`。 。 。 .

## 外地

阿贵 `Input` 其铬脱落:无边界、地表、原生外观或 大纲,关于 `--text-base`,将行的空余宽度降低到零 从不把控制器推出药丸 任何输入道具覆盖 .

## 它服从什么

读取 `--radius-composer`, (中文(简体) ), `--density`, (中文(简体) ), `--text-base`, (中文(简体) ), `--muted`, (中文(简体) ), `--text-secondary`, (中文(简体) ), `--primary`, (中文(简体) ), `--primary-foreground`, (中文(简体) ), `--foreground` 财务报告和审定财务报表 `--muted-foreground` 从 [@hanzo/设计](https://www.npmjs.com/package/@hanzo/design)每个都有一个倒背.

扫描是唯一的样式表: 二次曲线角动画 `@property` 财务报告和审定财务报表 `@keyframes`。它曾经被悬挂 通过反应 `<style>`键入 `data-slot`编号 `prism`, (中文(简体) ), `prism-ring` 财务报告和审定财务报表 `prism-halo`从来没有一个阶级。 四家媒体 询问 : `prefers-reduced-motion` 保持扫荡, `prefers-reduced-transparency` 放下光环并巩固了戒指, `prefers-contrast: more` 把戒指变成平地的白色边缘 `forced-colors: active` 为系统颜色大纲去掉两层.

## 常见问题

### @hanzo/composer 是什么？

作曲家的材料——围绕可以打入的任何字的点亮环,作为@hanzo/gui组件\.

### 如何安装 @hanzo/composer？

在项目目录运行 npm install @hanzo/composer，或使用 pnpm add / yarn add / bun add。它还需要宿主项目提供 peer 依赖：react（\>=19\.2\.8）、@hanzo/gui（^8\.3\.5）。npm 7 及以上与 pnpm 8 及以上默认会自动安装必需的 peer 依赖，Yarn 需要手动安装。

### @hanzo/composer 支持 TypeScript 吗？

支持。包内自带 TypeScript 类型声明（package\.json 声明了 types 入口），安装后即可获得类型提示，无需再安装 @types 包。

### @hanzo/composer 支持 ESM 还是 CommonJS？

以 ES Module 形式发布，推荐使用 import 引入。在 CommonJS 项目中，Node\.js 20\.19\+ / 22\.12\+ 可以直接 require\(\) 不含顶层 await 的 ES Module，更早的版本需要改用动态 import\(\)。

### @hanzo/composer 可以商用吗？

@hanzo/composer 使用 MIT 许可。宽松许可：允许商业使用、修改和再分发，通常只需在分发时保留原版权与许可声明。以上为概括，不构成法律意见，请以许可原文为准。

### @hanzo/composer 的下载量有多少？

根据 npm 官方下载统计，@hanzo/composer 在 2026/10/17 – 2026/11/15 这 30 天内被下载 10,121 次，日均约 337 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入，适合横向比较热度，不能直接等同于使用人数。

### @hanzo/composer 还在维护吗？

最新版本 0\.2\.1 发布于 2026/10/31（17 天前）；至今共发布 6 个版本，其中过去 12 个月发布了 6 个；首次发布于 2026/08/16。发布频率只是参考信号：功能稳定的工具可能很少需要更新，建议结合源码仓库的 issue 和提交记录判断。

