@basenative/marketplace

中文文档
3.0.0发布于 2026/10/31Apache-2.0TypeScriptES Module零依赖构建来源已验证

用于BaseNative的组件注册表-发布和发现基础设施

中文使用文档
文档目录8 节
  1. 安装
  2. 快速入门
  3. 主题
  4. API
  5. createRegistry(options?)
  6. createInstaller(options?)
  7. createThemeManager(options)
  8. 许可证

@basenative /市场

社区组件市场——浏览、安装和管理BaseNative包和主题

部分 BaseNative 生态系统——基于信号的web运行时,基于原生HTML。

安装

npm install @basenative/marketplace

快速入门

import { createRegistry, createInstaller, createThemeManager } from '@basenative/marketplace';

// Search the registry
const registry = createRegistry({ url: 'https://registry.basenative.dev' });
const { packages } = await registry.search('calendar', { limit: 10 });

// Get details for a specific package
const pkg = await registry.getPackage('bn-calendar');
const versions = await registry.getVersions('bn-calendar');

// Install a package into the current project
const installer = createInstaller({ projectRoot: process.cwd() });
await installer.install('[email protected]');
await installer.uninstall('bn-calendar');
const installed = await installer.list();

主题

import { createThemeManager } from '@basenative/marketplace';

const themes = createThemeManager({ registry });

// Browse and apply themes
const available = await themes.list();
await themes.apply('basenative-midnight');
await themes.reset();

API

createRegistry(options?)

创建市场注册中心客户端。选项: url (默认值: 'https://registry.basenative.dev'), token (发布的认证令牌)。

  • search(query, options?) —搜索包。选项: offset, limit, tag, category, sort。返回 { packages, total }.
  • getPackage(name) -按名称返回包的完整元数据。
  • getVersions(name) -返回包的已发布版本数组。
  • publish(manifest, tarball) —将包发布到注册表(必需) token)。

createInstaller(options?)

创建本地安装程序。选项: projectRoot -项目目录的路径。

  • install(packageSpec) —安装软件包(例如: 'bn-calendar' 或者 '[email protected]')。
  • uninstall(name) —移除已安装的软件包。
  • list() -返回当前安装的市场包的数组。
  • update(name) —将已安装的软件包更新到最新版本。

createThemeManager(options)

创建主题管理器。选项: registry -注册表客户端实例。

  • list() -从注册表返回可用主题。
  • apply(themeName) -下载并应用主题到项目。
  • reset() -删除当前应用的主题并恢复默认设置。

许可证

apache - 2.0

版本与发布记录

@basenative/marketplace 共发布 11 个版本,首次发布于 2026/03/20;过去 12 个月发布了 11 个版本。最新版本附带 npm provenance 构建来源证明,可追溯到公开的 CI 构建记录。

版本发布日期距今
3.0.0latest2026/10/312 天前
2.4.02026/10/268 天前
2.3.22026/10/2212 天前
2.3.12026/10/2212 天前
2.3.02026/10/2212 天前
2.2.02026/10/2113 天前

关于 @basenative/marketplace 的常见问题

@basenative/marketplace 是什么?

用于BaseNative的组件注册表-发布和发现基础设施

如何安装 @basenative/marketplace?

在项目目录运行 npm install @basenative/marketplace,或使用 pnpm add / yarn add / bun add。

@basenative/marketplace 支持 TypeScript 吗?

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

@basenative/marketplace 支持 ESM 还是 CommonJS?

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

@basenative/marketplace 可以商用吗?

@basenative/marketplace 使用 Apache-2.0 许可。宽松许可:允许商业使用、修改和再分发,并附带明确的专利授权;分发时需保留许可与 NOTICE 文件,修改过的文件要注明改动。以上为概括,不构成法律意见,请以许可原文为准。

@basenative/marketplace 还在维护吗?

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