@cobre-npm/portal-widgets

中文文档
0.49.0发布于 2026/11/10TypeScriptES Module近 30 天下载 4022

可嵌入的Vue 3部件为Cobre的出入口,发布至npm并被出入口外壳和任何其他主机应用程序所消耗. vue 财务报告和审定财务报表 vue-i18n 是外部的——由主机提供.

中文使用文档
文档目录5 节
  1. 脚本
  2. 测试
  3. 覆盖层的缝隙
  4. 这道门被执行的地方
  5. 建筑

@ cobre- npm/ portal- widgets (英语)

可嵌入的 Vue 3 元件为 Cobre 的出入口,发布到 npm , 由出入口外壳和 由任何其他主机应用程序. vue 财务报告和审定财务报表 vue-i18n 是外部的——由主机提供.

脚本

脚本它会做什么
pnpm devVite Dev 牵引装置(src/main.ts(中文(简体) )
pnpm build将可出版的图书馆建为 dist/ + 将类型输入 dist/types/
pnpm test整个大门: 套房, 覆盖在地板上, 和鼠标
pnpm lint带有 ESLint 的 Lint 自动修正( A)

测试

pnpm test 运行三件事的顺序, 和任何其中的去红色失败的建设:

  1. 那个套房 - 维特过来 src/**/*.{test,spec}.ts。 。 。 .
  2. 覆盖范围 ——按下列标准执行: coverage-floor.json。 。 。 .
  3. 转弯 —— 说 scripts/check-invariants.mjs比较底稿和底稿.

src/repo-invariants.test.ts 守卫 形状 而不是其编号: 阈值从 coverage-floor.json 而不是暗示,所有四个度量衡, 无法排除所有部件目录缩小分母 test 脚本 仍然引用一个真正的跑者 没有 --passWithNoTests没有它,大门就可以被打败,没有它 触摸一个数字 鼠标手表.

车道覆盖 src/**/*.ts 减测试,只类型模块, enums, locales, 模拟,常数, 桶和Dev条目。 这个 .vue 组件是故意的 没有 在分母中:与 ds-v3 这个软件包没有故事道,所以没有二进制渲染闸门可以和, 将未经测试的部件折叠成一个数字,以衡量是否缺少向导道 而不是逻辑ADR-0008 (英语)) (中文(简体) ).

覆盖层的缝隙

coverage-floor.json 是一个 地板,不是目标它掌握着门的日记 被打开(2026-09-17),而不是95%,因为没有可追溯的回填——无人能够进入的大门 第一天收养的门没人打开.

它可能只会上升. scripts/check-invariants.mjs 当其中的任何数字下降到低于值时失败 当一个度量衡被完全去除时,或者当基准值不能解决时——鼠标 默默不作的跑步 与过去那段是分不开的 这就是整个的缺陷 要删除的闸门存在。 放下地板在同一块 承诺 打破它正是 鼠标的存在防止.

当加入测试和覆盖率上升时,在同一公关中提高底线. 这就是整个机制.

在CI之外,鼠标是一个不op 除非你给它一个基础参考:

node scripts/check-invariants.mjs --base origin/trunk

这道门被执行的地方

输油管是 不在此还原它生活在 Cobre-Colombia/circleci-library 时间 pipes/npm/config-frontend-libraries.yml,其 build_unit 任务运行 eval "CI=true ${TEST_CMD:-npm test}"。 。 。 .

这个软件包 没有 .env 在repo的文件中 config/frontend-libraries-project-overrides/这样 build_unit 陷入默认状态 npm test ——和该默认 实值 大门。 缺席 这是故意的,而不是疏忽: 管子不需要覆盖这个步骤运行 此处的操作只能削弱已经定义的软件包本身的命令 .

如果增加了一个,它不能携带 TEST_CMD 会 议 日 程 和 议 程 vitest ... --passWithNoTests 形状. 这正是中和的 util-ds:步骤跑出,报告成功,永远不能失败.

CI=true 开关也是:没有它 check-invariants.mjs 没有任何根据 出口为0.

建筑

见 克劳德·姆德 用于部件布局、导出表面、本地化模式和 代码样式规则.

版本与发布记录

@cobre-npm/portal-widgets 共发布 83 个版本,首次发布于 2026/02/12;过去 12 个月发布了 83 个版本。

版本发布日期距今
0.49.0latest2026/11/10今天
0.48.02026/11/063 天前
0.46.02026/11/064 天前
0.45.02026/11/045 天前
0.44.62026/11/036 天前
0.44.52026/10/3011 天前

关于 @cobre-npm/portal-widgets 的常见问题

@cobre-npm/portal-widgets 是什么?

可嵌入的Vue 3部件为Cobre的出入口,发布至npm并被出入口外壳和任何其他主机应用程序所消耗. vue 财务报告和审定财务报表 vue-i18n 是外部的——由主机提供.

如何安装 @cobre-npm/portal-widgets?

在项目目录运行 npm install @cobre-npm/portal-widgets,或使用 pnpm add / yarn add / bun add。它还需要宿主项目提供 peer 依赖:vue(^3.5.0)、vue-i18n(>=11.0.0)、bootstrap(^5.3.8)、vue-collapsed(^1.1.0)、@cobre-npm/ds-v3(>=0.169.0)。npm 7 及以上与 pnpm 8 及以上默认会自动安装必需的 peer 依赖,Yarn 需要手动安装。

@cobre-npm/portal-widgets 支持 TypeScript 吗?

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

@cobre-npm/portal-widgets 支持 ESM 还是 CommonJS?

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

@cobre-npm/portal-widgets 可以商用吗?

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

@cobre-npm/portal-widgets 的下载量有多少?

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

@cobre-npm/portal-widgets 还在维护吗?

最新版本 0.49.0 发布于 2026/11/10(今天);至今共发布 83 个版本,其中过去 12 个月发布了 83 个;首次发布于 2026/02/12。发布频率只是参考信号:功能稳定的工具可能很少需要更新,建议结合源码仓库的 issue 和提交记录判断。