用途:指导在 NVIDIA Elements 项目中从零创建新组件,或修改现有组件。使用前必须先阅读组件创建指南。
主要能力:确认组件命名(kebab-case)、用途,以及直接使用 LitElement 还是采用 ButtonFormControlMixin(按钮类交互组件);参考最接近的现有组件理解模式;在 projects/core/src/<component-name>/ 下创建 10 个必需文件,包括组件类(含元数据、JSDoc、render 方法)、CSS(使用 CSS 自定义属性)、示例文件(带 @summary JSDoc)、单元测试、axe 无障碍测试、视觉回归测试、SSR 测试、lighthouse 测试、define.ts 注册文件(使用 define() 辅助函数与 HTMLElementTagNameMap)以及无副作用的 index.ts 导出。
使用方式:更新共享入口,在 projects/core/src/bundle.ts 中按字母顺序仅添加 import '@nvidia-elements/core/<component-name>/define.js',保持该注册 bundle 仅含导入;从组件 index.ts 导出公共 API 并通过包 exports 映射暴露入口;在 projects/core/src/index.test.lighthouse.ts 的 js-modules 列表中加入定义导入。随后在 projects/core 下运行 mise exec -- pnpm run test:lighthouse 测量载荷,仅在超出当前限制时提高 bundle 体积上限;最后运行 mise exec -- pnpm run lint 与 mise exec -- pnpm run test 校验。
适用场景:新增或调整 Elements 组件、搭建五类测试样板、选择基类或 mixin、配置组件元数据与注册、编写 JSDoc。
限制:资料未提供具体组件创建指南、TypeScript 指南、示例指南、测试指南、API 设计文档的正文内容,也未提供收费、平台或效果信息;参考组件路径为 /projects/core/src/button/、/projects/core/src/badge/、/projects/core/src/card/。