# @cyclone-ui/helpers 中文文档 规范地址：https://npmcn.com/package/%40cyclone-ui/helpers/ 版本：0\.3\.66 npm 元数据更新时间：2026-11-10T16:17:37.682Z 中文译文更新时间：2026-11-11T06:59:02.214Z 软件包许可：未声明 本文由上游 README 翻译，可能存在偏差，请结合原文核对 API、命令与配置。版权与许可归原作者所有。 原始 npm 页面：https://www.npmjs.com/package/%40cyclone-ui/helpers 原文对照：https://npmcn.com/package/%40cyclone-ui/helpers/?lang=original 项目主页：https://github.com/storm-software/cyclone-ui#readme 源码仓库：https://github.com/storm-software/cyclone-ui ## 关键信息（来自 npm 元数据） - 包体积（解压后）：122 kB，84 个文件 - 模块格式：ESM + CJS - TypeScript 类型：包内自带 - 运行依赖：4 个 - peer 依赖：react ^19\.3\.1 - 首次发布：2026-09-04T14:29:36.550Z - 最新版本发布：2026-11-10T16:17:37.259Z - 近 30 天下载量：9510（2026-10-11 至 2026-11-09，npm 官方下载统计） - 已发布版本数：66（近 12 个月 66 个） ## 中文简介 包含 Storm Software 在许多平台中使用的核心前端组件的仓库 ## 安装 ```sh npm install @cyclone-ui/helpers ``` 也可以使用：`pnpm add @cyclone-ui/helpers`、`yarn add @cyclone-ui/helpers`、`bun add @cyclone-ui/helpers` ## README ![Storm Software](https://pub-761b436209f44a4d886487c917806c08.r2.dev/storm-banner.gif) **[网站](https://stormsoftware.com/) 二. 支助 [GitHub 图像](https://github.com/storm-software/cyclone-ui) 二. 支助 [解析器](https://discord.gg/MQ6YVzakM5) 二. 支助 [文档](https://docs.stormsoftware.com/cyclone-ui) 二. 支助 [联系人](https://stormsoftware.com/contact) 二. 支助 [报告错误](https://github.com/storm-software/cyclone-ui/issues/new?assignees=&labels=bug&template=bug-report.yml&title=Bug%20Report%3A+)** 此软件包是 **旋风UI** 单相机 存储器包含 [塔马吉](https://tamagui.dev/) 风暴软件所使用的基于设计组件. 喜欢 [沙德克·乌伊](https://ui.shadcn.com/),组件通过"旋风CLI"被复制到其他寄存器. ### 访问 [暴风软件.com](https://stormsoftware.com/) 更新到此开发者 [![Version](https://img.shields.io/badge/version-0.3.0-1fb2a6.svg?style=for-the-badge&color=1fb2a6)](https://prettier.io/) [![Nx](https://img.shields.io/badge/Nx-17.0.2-lightgrey?style=for-the-badge&logo=nx&logoWidth=20&&color=1fb2a6)](http://nx.dev/) [![NextJs](https://img.shields.io/badge/Next.js-14.0.2-lightgrey?style=for-the-badge&logo=nextdotjs&logoWidth=20&color=1fb2a6)](https://nextjs.org/) [![Commitizen friendly](https://img.shields.io/badge/commitizen-friendly-brightgreen.svg?style=for-the-badge&logo=commitlint&color=1fb2a6)](http://commitizen.github.io/cz-cli/) ![Semantic-Release](https://img.shields.io/badge/%20%20%F0%9F%93%A6%F0%9F%9A%80-semantic--release-e10079.svg?style=for-the-badge&color=1fb2a6) [![documented with docusaurus](https://img.shields.io/badge/documented_with-docusaurus-success.svg?style=for-the-badge&logo=readthedocs&color=1fb2a6)](https://docusaurus.io/) ![GitHub Workflow Status (with event)](https://img.shields.io/github/actions/workflow/status/storm-software/cyclone-ui/cr.yml?style=for-the-badge&logo=github-actions&color=1fb2a6) > \[大 这个寄存器,以及里面包含的应用程序,库和工具,仍然处于初始开发阶段. 因此,随着它的用法,可以预期出错误和问题. 完成主要开发阶段后,将进行适当的发布,通过国家预防机制(和其他分发)提供套件,并删除这一信息。 然而,在此期间,请随意报告可能遇到的任何问题. # 旋风UI - 帮助者 包含 Storm 软件应用程序中使用的各种辅助工具的软件包 - [快速特性](https://npmcn.com/package/%40cyclone-ui/helpers/#readme-quick-features) - [安装](https://npmcn.com/package/%40cyclone-ui/helpers/#readme-installing) - [使用量](https://npmcn.com/package/%40cyclone-ui/helpers/#readme-usage) - [减少软件包大小](https://npmcn.com/package/%40cyclone-ui/helpers/#readme-reduced-package-size) - [发展](https://npmcn.com/package/%40cyclone-ui/helpers/#readme-development) - [大楼](https://npmcn.com/package/%40cyclone-ui/helpers/#readme-building) - [运行单元测试](https://npmcn.com/package/%40cyclone-ui/helpers/#readme-running-unit-tests) - [线性](https://npmcn.com/package/%40cyclone-ui/helpers/#readme-linting) - [风暴工作空间](https://npmcn.com/package/%40cyclone-ui/helpers/#readme-storm-workspaces) - [路线图](https://npmcn.com/package/%40cyclone-ui/helpers/#readme-roadmap) - [支助](https://npmcn.com/package/%40cyclone-ui/helpers/#readme-support) - [许可证](https://npmcn.com/package/%40cyclone-ui/helpers/#readme-license) - [文档](https://npmcn.com/package/%40cyclone-ui/helpers/#readme-documentation) - [更改日志](https://npmcn.com/package/%40cyclone-ui/helpers/#readme-changelog) - [捐款](https://npmcn.com/package/%40cyclone-ui/helpers/#readme-contributing) - [贡献者](https://npmcn.com/package/%40cyclone-ui/helpers/#readme-contributors) ## 快速特性 - 读取 Tamagui 令牌的大小、空间和半径助手(`getSized`, (中文(简体) ), `getSpaced`, (中文(简体) ), `getRadius`(中文(简体) ) - 价值正常化,包括Tailwind风格的任意价值,例如: `[12px]` - 字体大小和字体重量帮助工具 `styled.dynamic` 变体 - 窗体控制大小( E)`sm`, (中文(简体) ), `md`, (中文(简体) ), `lg`)和共享形式控制上下文 有字段钩 - 基于 OKLCH 色彩空间的调色板生成器 ## 安装 使用 [小时](http://pnpm.io/)数字 : ```bash pnpm add -D @cyclone-ui/helpers ``` 使用 npm ```bash npm install -D @cyclone-ui/helpers ``` 使用线条 ```bash yarn add -D @cyclone-ui/helpers ``` ## 使用量 为 Tamagui 样式组件构建大小变体 : ```tsx import { styled, View } from "@tamagui/core"; import { formSizeVariants, getFormFontSize, getFormSizeToken } from "@cyclone-ui/helpers"; export const Box = styled(View, { variants: { size: formSizeVariants((size, env) => ({ height: getFormSizeToken(size), ...getFormFontSize(size, env) })) } }); ``` 见 [软件包文档](https://npmcn.com/package/docs/packages/helpers.md) 每笔 输出. ## 减少软件包大小 这个项目使用 [s](https://tsdown.dev/) 来包装源代码 由于能够删除未使用的代码并运送较小的javascript文件 感谢代码拆分。 这有助于大大缩小包的尺寸 并方便用于其他项目. ## 发展 此工程是使用 [无](https://nx.dev/)因此,许多通常的情况 命令可以帮助开发. 要设置检出, 复制仓库并运行 `pnpm install` 输入 仓库根. ### 大楼 运行 `nx build helpers` 来建造图书馆. ### 运行单元测试 运行 `nx test helpers` 通过 [维特](https://vitest.dev/)。 。 。 . ### 线性 运行 `nx lint helpers` 要运行 [ESLint 语录](https://eslint.org/) 在包裹上. ## 风暴工作空间 风暴工作空间是利用 [无](https://nx.dev/),一组可扩展的 dev 工具 帮助你发展,如谷歌、Facebook和微软. 在Nx之上,开放系统提供了一套工具和模式 帮助您将您的单曲缩放到许多团队中,同时保留代码库 可维护. \[ [回到顶部](https://npmcn.com/package/%40cyclone-ui/helpers/#readme-table-of-contents) \[ . \] ## 路线图 见 [未决问题](https://github.com/storm-software/cyclone-ui/issues) (单位:千美元) 建议的特征清单(和已知问题). - [高级特性请求](https://github.com/storm-software/cyclone-ui/issues?q=label%3Aenhancement+is%3Aopen+sort%3Areactions-%2B1-desc) (用QQ反应加入你的投票) - [顶部臭虫](https://github.com/storm-software/cyclone-ui/issues?q=is%3Aissue+is%3Aopen+label%3Abug+sort%3Areactions-%2B1-desc) (用QQ反应加入你的投票) - [最新错误](https://github.com/storm-software/cyclone-ui/issues?q=is%3Aopen+is%3Aissue+label%3Abug) \[ [回到顶部](https://npmcn.com/package/%40cyclone-ui/helpers/#readme-table-of-contents) \[ . \] ## 支助 联系下列地点之一的维护者: - [联系人](https://stormsoftware.com/contact) - [GitHub 讨论](https://github.com/storm-software/cyclone-ui/discussions) - [支持@ tormsoftware.com](mailto:support@stormsoftware.com) \[ [回到顶部](https://npmcn.com/package/%40cyclone-ui/helpers/#readme-table-of-contents) \[ . \] ## 许可证 本项目根据以下规定获得许可证: **Apache 许可证,2.0版本**. 请随意 编辑和分发此模板. ``` Copyright (C) 2023 - 2024 Storm Software Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at http://www.apache.org/licenses/LICENSE-2.0 Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License. ``` 见 [自由主义](https://npmcn.com/package/%40cyclone-ui/helpers/LICENSE) 更多信息. ### 文档 所有文件均根据《条例》获得许可证 [创意常识](http://creativecommons.org/licenses/by/4.0/) (属性) 执照. \[ [回到顶部](https://npmcn.com/package/%40cyclone-ui/helpers/#readme-table-of-contents) \[ . \] ## 更改日志 本项目遵守 [语义版本](https://semver.org/spec/v2.0.0.html)每一次发布,随同 与移民指示有关的文件 [变化](https://npmcn.com/package/%40cyclone-ui/helpers/CHANGELOG.md) 文件 \[ [回到顶部](https://npmcn.com/package/%40cyclone-ui/helpers/#readme-table-of-contents) \[ . \] ## 捐款 首先,谢谢你花时间捐款! 捐款是什么 让开放源代码社区成为学习、激励和 创建。 你所做的任何贡献都会给其他人带来好处 **非常厉害 谢谢**。 。 。 . 请尝试创建错误报告 : - _可复制._ 包括复制问题的步骤. - _具体._ 包括尽可能多的细节:哪个版本,什么 环境等. - _独出一辙._ 不重复已打开的问题 . - _范围为单虫._ 每个报告一个错误. 请遵守这个计划 [行为守则](https://npmcn.com/package/%40cyclone-ui/helpers/.github/CODE_OF_CONDUCT.md)。 。 。 . 你用得着 [马克下林特-克利](https://github.com/storm-software/cyclone-ui/markdownlint-cli) 以检查常见的标记下样式不一致. \[ [回到顶部](https://npmcn.com/package/%40cyclone-ui/helpers/#readme-table-of-contents) \[ . \] ## 贡献者 感谢这些好人 (单位:千美元)[emoji 密钥](https://allcontributors.org/docs/en/emoji-key):
Patrick Sullivan
帕特里克·苏利文
🎨 💻 🔧 📖 ⚠️		Tyler Benning
泰勒·本宁
🎨		Stormie
史东蜜
🚧
All Contributors 添加您的贡献
本项目遵循 [全部贡献者](https://github.com/all-contributors/all-contributors) 规格。 任何捐款都欢迎! \[ [回到顶部](https://npmcn.com/package/%40cyclone-ui/helpers/#readme-table-of-contents) \[ . \] * * * ![Storm Software](https://pub-761b436209f44a4d886487c917806c08.r2.dev/logo-banner.png) **[网站](https://stormsoftware.com/) 二. 支助 [联系人](https://stormsoftware.com/contact) 二. 支助 [解析器](https://discord.gg/MQ6YVzakM5) 二. 支助 [链接](https://linkedin.com/in/pat-sullivan-dev) 二. 支助 [中型](https://medium.com/@pat.joseph.sullivan) 二. 支助 [GitHub 图像](https://github.com/storm-software) 二. 支助 [OpenPGP 密钥](https://keybase.io/sullivanp)** **指纹 :** 1BD2 7192 7770 2549 F4C9 F238 E6AD C420 DA5C 4C2D Storm Software是一个开源软件开发组织和创建者 酸性,"暴风雪"和"暴风雪". 我们的任务是使软件开发更容易获得。 我们的理想未来是 一个任何人都可以创建软件而无需多年的以前开发 经验成为进入的障碍。 我们希望通过LLMS实现这一点, Generative AI,和直观的高层次数据建模/编程语言. 如果这听起来很有趣, 你想帮助我们 创建下一个 开发工具,请访问我们的网站! QQ 访问 \[stormsoftware.com\] (https://stormsoftware.com) 与这个开发者保持最新联系 \[ [回到顶部](https://npmcn.com/package/%40cyclone-ui/helpers/#readme-table-of-contents) \[ . \] ## 常见问题 ### @cyclone-ui/helpers 是什么？ 包含 Storm Software 在许多平台中使用的核心前端组件的仓库 ### 如何安装 @cyclone-ui/helpers？ 在项目目录运行 npm install @cyclone-ui/helpers，或使用 pnpm add / yarn add / bun add。它还需要宿主项目提供 peer 依赖：react（^19\.3\.1）。npm 7 及以上与 pnpm 8 及以上默认会自动安装必需的 peer 依赖，Yarn 需要手动安装。 ### @cyclone-ui/helpers 支持 TypeScript 吗？ 支持。包内自带 TypeScript 类型声明（package\.json 声明了 types 入口），安装后即可获得类型提示，无需再安装 @types 包。 ### @cyclone-ui/helpers 支持 ESM 还是 CommonJS？ 同时提供 ES Module 与 CommonJS 入口，import 和 require\(\) 都可以使用，打包工具会自动选择合适的版本。 ### @cyclone-ui/helpers 可以商用吗？ @cyclone-ui/helpers 使用 未声明 许可。package\.json 没有声明许可证。没有许可证的代码默认保留全部权利，商用前请联系作者或查看仓库中的 LICENSE 文件。以上为概括，不构成法律意见，请以许可原文为准。 ### @cyclone-ui/helpers 的下载量有多少？ 根据 npm 官方下载统计，@cyclone-ui/helpers 在 2026/10/11 – 2026/11/09 这 30 天内被下载 9,510 次，日均约 317 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入，适合横向比较热度，不能直接等同于使用人数。 ### @cyclone-ui/helpers 还在维护吗？ 最新版本 0\.3\.66 发布于 2026/11/11（今天）；至今共发布 66 个版本，其中过去 12 个月发布了 66 个；首次发布于 2026/09/04。发布频率只是参考信号：功能稳定的工具可能很少需要更新，建议结合源码仓库的 issue 和提交记录判断。