@guardian/source-react-components-development-kitchen

中文文档
21.0.0发布于 2024/05/16TypeScriptESM + CJS零依赖近 30 天下载 6390

npm

此软件包已被标记为弃用

Use @guardian/source-development-kitchen instead

中文使用文档
文档目录6 节
  1. 安装
  2. 示例
  3. 所有权
  4. 演变
  5. 动机
  6. 出版

@guardian/source-react-components-development-kitchen

npm

开发厨房是新构件和模式可以烹调,测试和共享的地方. 最低接受标准。 重复和破坏东西是正常的。 如果厨房的部件证明有价值,可以晋升到 @guardian/source-react-components。 。 。 .

此软件包是 源设计系统。 。 。 .

安装

$ yarn add @guardian/source-react-components-development-kitchen

或者说

$ npm install @guardian/source-react-components-development-kitchen

示例

import { Lines } from '@guardian/source-react-components-development-kitchen';

const Section = () => (
    <>
        <Lines count={8} />
        <Lines effect="squiggly" />
    </>
);

所有权

厨房组件不受CSTI的支持. 他们由消耗他们的团队拥有.

所有权人的定义载于 消费者。 。 。 .

如果你想开始消耗厨房组件, 加入你的团队作为CODEOWINERS。 这将确保您被告知组件的更改.

演变

厨房组件预计将有变化。 厨房的部件应该被认为是实验性的,并且有可能以破坏事物的方式改变.

证明有价值的组成部分可以晋升到 @guardian/source-react-components为了实现这一目标,该部分必须符合资料来源的要求 接受标准. 满足这些要求的最佳方式是开发者在构建和演化一个组件时与设计和UX密切合作. 构件应表明由源头管理的某些图案、规则或设计方面.

动机

来源是一个库,团队可以期待在那里找到高质量的共享组件. 将新的组件添加到源(Source)需要深入的工作和跨学科的协作 — — 设计,UX和工程. 部件在源头登陆需要很长时间和大量努力.

潜在贡献者被推迟直接向原始来源捐款,因为他们认为难以在时间投资与团队优先事项之间取得平衡。 其代价是双重的:

  • 来源提供的高质量组件数量低于其可能数量.
  • 可能共享的组件直接被构建到应用中,导致分散,不一致和重复.

我们认为,迅速行动、试验新想法并分享这些想法以提供更广泛的投入是有价值的。 发展厨房帮助团队通过降低入门障碍来实现这一目标. 它允许团队从用户和其他开发者那里获得对新组件的快速反馈.

通过为延展和改进提供敏捷的机制,组件可以提升到来源预期的质量水平,每个人都可以从投入其中的工作中受益.

出版

开发厨房作为自己的套装出版,独立于其中的稳定组件 @guardian/source-react-components。这个:

  • 允许厨房快速移动.
  • 允许我们经常改变厨房,同时保留铸币。 稳定的库以更慢的速度变化,以设定预期和保存开发者的信心.

版本与发布记录

@guardian/source-react-components-development-kitchen 共发布 108 个版本,首次发布于 2021/09/17;过去 12 个月发布了 0 个版本。

版本发布日期距今
21.0.0latest2024/05/162 年前
21.0.0-canary-20240513154404canary2024/05/132 年前
20.0.32024/05/082 年前
0.0.0-canary-202405071603322024/05/082 年前
0.0.0-canary-202405071559112024/05/082 年前
20.0.22024/05/072 年前

其他发布通道:next → 0.0.25-rc.2,canary → 21.0.0-canary-20240513154404。

关于 @guardian/source-react-components-development-kitchen 的常见问题

如何安装 @guardian/source-react-components-development-kitchen?

在项目目录运行 npm install @guardian/source-react-components-development-kitchen,或使用 pnpm add / yarn add / bun add。它还需要宿主项目提供 peer 依赖:react(^18.2.0)、tslib(^2.6.2)、@emotion/react(^11.11.1)、@guardian/libs(^16.0.0)、@guardian/source-foundations(^16.0.0)、@guardian/source-react-components(^25.0.0)。npm 7 及以上与 pnpm 8 及以上默认会自动安装必需的 peer 依赖,Yarn 需要手动安装。

@guardian/source-react-components-development-kitchen 支持 TypeScript 吗?

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

@guardian/source-react-components-development-kitchen 支持 ESM 还是 CommonJS?

同时提供 ES Module 与 CommonJS 入口,import 和 require() 都可以使用,打包工具会自动选择合适的版本。

@guardian/source-react-components-development-kitchen 可以商用吗?

@guardian/source-react-components-development-kitchen 使用 未声明 许可。package.json 没有声明许可证。没有许可证的代码默认保留全部权利,商用前请联系作者或查看仓库中的 LICENSE 文件。以上为概括,不构成法律意见,请以许可原文为准。

@guardian/source-react-components-development-kitchen 的下载量有多少?

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

@guardian/source-react-components-development-kitchen 还在维护吗?

最新版本 21.0.0 发布于 2024/05/16(2 年前);至今共发布 108 个版本,其中过去 12 个月发布了 0 个;首次发布于 2021/09/17。作者已将其标记为弃用,新项目建议寻找替代方案。