# @coveo/atomic-legacy 中文文档

规范地址：https://npmcn.com/package/%40coveo/atomic-legacy/

版本：0\.1\.10
npm 元数据更新时间：2026-11-02T20:41:09.733Z
中文译文更新时间：2026-11-10T20:56:44.586Z
软件包许可：未声明

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

原始 npm 页面：https://www.npmjs.com/package/%40coveo/atomic-legacy
原文对照：https://npmcn.com/package/%40coveo/atomic-legacy/?lang=original
源码仓库：https://github.com/coveo/ui-kit

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

- 包体积（解压后）：124 kB，24 个文件
- 模块格式：ES Module
- TypeScript 类型：包内自带
- Node.js 要求：^22\.11\.0 \|\| ^24\.11\.0
- 运行依赖：2 个
- 首次发布：2026-01-29T21:08:33.693Z
- 最新版本发布：2026-11-02T20:41:09.390Z
- 近 30 天下载量：18422（2026-10-11 至 2026-11-09，npm 官方下载统计）
- 已发布版本数：39（近 12 个月 39 个）

## 中文简介

@coveo/ 原子内部使用的包, 用于使用遗留技术的组件( 如 Stencil) 。 本套装并非供公众使用.

## 安装

```sh
npm install @coveo/atomic-legacy
```

也可以使用：`pnpm add @coveo/atomic-legacy`、`yarn add @coveo/atomic-legacy`、`bun add @coveo/atomic-legacy`

## README

# @coveo/ 原子学

> ⚠️ **内部软件包**: 此软件包由内部使用 `@coveo/atomic` 用于使用遗留的 Stencil 技术的组件. **不应直接用于您的项目.**

## 概览

`@coveo/atomic-legacy` 提供主要消耗的基于 Stencil 的部件 `@coveo/atomic` 软件包。 此软件包的存在是为了在从Stencil到Lit组件的迁移过程中支持后向兼容性.

## 目的

这个包裹是科维奥正在进行的现代化努力的一部分,从斯通西尔迁移到利特,以提高性能,更小的捆绑尺寸,以及更好的可维护性. 本套件中的组件使用遗留下来的Stencil架构,并正在被逐渐迁移到主要部分 `@coveo/atomic` 作为 Lit 组件的软件包.

## 构成部分

### 原子建议提交者

用于提供单个搜索框建议的内部组件。 它处理Stencil VNodes或原生DOM元素的建议内容的渲染,提供遗留的Stencil组件和现代Lit执行相容性.

**关键特性:**

-   自动完成搜索框的渲染器建议内容
-   支持 Stencil VNode 和本地元素内容
-   处理无障碍属性( ARIA 标签、 键盘导航)
-   提供视觉状态( 选中、 悬浮)
-   通过 i18next 支持国际化

## 条目点

该套件暴露出一个单一的切入点:

-   `@coveo/atomic-legacy/atomic-suggestion-renderer`: 直接获取具有类型和实施情况的建议渲染器组件

## 使用量

此软件包被自动消耗 `@coveo/atomic` 并且不应在应用程序代码中直接安装或导入.

**不使用 :**

```typescript
// ❌ Don't import from atomic-legacy in your projects
import {AtomicSuggestionRenderer} from '@coveo/atomic-legacy';
```

**相反,使用:**

```typescript
// ✅ Use the main @coveo/atomic package
import {defineCustomElements} from '@coveo/atomic/loader';
```

## 发展

### 大楼

从单列波根:

```sh
pnpm turbo run build --filter=@coveo/atomic-legacy
```

### 依赖关系

-   **@ stencil/ 核心**: 网络组件的 Stencil 框架
-   **下一个i18**: 国际化框架(非依赖性)

## 移徙

本套计划中的组件是可迁移到Lit的候选. 如果你为移民工作做贡献:

1.  参见 [原子贡献准则](https://npmcn.com/package/%40coveo/atomic/CONTRIBUTING.md)
2.  使用迁移提示 `.github/prompts/`

## 相关软件包

-   [`@coveo/atomic`](https://npmcn.com/package/%40coveo/atomic/README.md) - 主要原子网络组件库
-   [`@coveo/headless`](https://npmcn.com/package/%40coveo/headless/README.md) - 无头搜索库为原子提供动力

## 许可证

阿帕奇2.0 (英语). 见 [自由主义](https://npmcn.com/package/LICENSE.md) 详细情况.

## 常见问题

### @coveo/atomic-legacy 是什么？

@coveo/ 原子内部使用的包, 用于使用遗留技术的组件\( 如 Stencil\) 。 本套装并非供公众使用\.

### 如何安装 @coveo/atomic-legacy？

在项目目录运行 npm install @coveo/atomic-legacy，或使用 pnpm add / yarn add / bun add。

### @coveo/atomic-legacy 支持 TypeScript 吗？

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

### @coveo/atomic-legacy 支持 ESM 还是 CommonJS？

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

### @coveo/atomic-legacy 需要什么版本的 Node\.js？

package\.json 的 engines 字段要求 Node\.js ^22\.11\.0 \|\| ^24\.11\.0。版本不符时 npm 默认只给出警告，开启 engine-strict 后会拒绝安装。

### @coveo/atomic-legacy 可以商用吗？

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

### @coveo/atomic-legacy 的下载量有多少？

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

### @coveo/atomic-legacy 还在维护吗？

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