@coveo/atomic-legacy

中文文档
0.1.10发布于 2026/11/03TypeScriptES Module构建来源已验证近 30 天下载 1.8万

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

中文使用文档
文档目录12 节
  1. 概览
  2. 目的
  3. 构成部分
  4. 原子建议提交者
  5. 条目点
  6. 使用量
  7. 发展
  8. 大楼
  9. 依赖关系
  10. 移徙
  11. 相关软件包
  12. 许可证

@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 并且不应在应用程序代码中直接安装或导入.

不使用 :

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

相反,使用:

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

发展

大楼

从单列波根:

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

依赖关系

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

移徙

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

  1. 参见 原子贡献准则
  2. 使用迁移提示 .github/prompts/

许可证

阿帕奇2.0 (英语). 见 自由主义 详细情况.

版本与发布记录

@coveo/atomic-legacy 共发布 39 个版本,首次发布于 2026/01/30;过去 12 个月发布了 39 个版本。最新版本附带 npm provenance 构建来源证明,可追溯到公开的 CI 构建记录。

版本发布日期距今
0.1.10latest2026/11/038 天前
0.1.92026/10/2022 天前
0.1.82026/10/1428 天前
0.1.72026/10/061 个月前
0.1.62026/09/301 个月前
0.1.52026/09/231 个月前

关于 @coveo/atomic-legacy 的常见问题

@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 和提交记录判断。