@geti-ui/blocks

中文文档
1.7.1发布于 2026/11/05Apache-2.0TypeScriptESM + CJS构建来源已验证近 30 天下载 2057

Geti UI reusable application blocks

原始使用文档
文档目录6 节
  1. What this package includes
  2. Installation
  3. Required setup
  4. Quick start
  5. Examples and docs
  6. Development

@geti-ui/blocks

Composable application-level building blocks for Geti products.

@geti-ui/blocks builds on top of @geti-ui/ui primitives and provides opinionated product-level patterns such as media workflows, logs surfaces, and managed tabs.

What this package includes

  • Media building blocks: filtering, chips, dialog, grid, and table flows
  • Logs building blocks: list content, toolbar controls, level filtering
  • Tabs building blocks: managed and overflowable tab behaviors
  • Annotation-related blocks and utility surfaces used in product screens

Installation

npm install @geti-ui/blocks @geti-ui/ui

Required setup

Import both stylesheets and render under ThemeProvider:

import { ThemeProvider } from '@geti-ui/ui';
import '@geti-ui/ui/styles.css';
import '@geti-ui/blocks/styles.css';

export function App() {
    return <ThemeProvider>{/* app */}</ThemeProvider>;
}

Quick start

import { MediaGrid, FilterDialog, FilterChips } from '@geti-ui/blocks';

// Use with your own state/data source

Examples and docs

  • Installation: documentation/docs/blocks/installation.mdx
  • Blocks docs root: documentation/docs/blocks/
  • Media overview example: documentation/docs/blocks/media/media-overview.mdx
  • Logs docs: documentation/docs/blocks/logs.mdx

Development

From repository root:

npm run build --workspace=@geti-ui/blocks
npm run test --workspace=@geti-ui/blocks
npm run type-check --workspace=@geti-ui/blocks
npm run lint --workspace=@geti-ui/blocks
npm run format:check --workspace=@geti-ui/blocks

版本与发布记录

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

版本发布日期距今
1.7.1latest2026/11/0511 天前
1.7.02026/10/2225 天前
1.6.02026/08/202 个月前
1.5.42026/08/063 个月前
1.5.32026/07/104 个月前
1.5.22026/07/094 个月前

关于 @geti-ui/blocks 的常见问题

@geti-ui/blocks 是什么?

Geti UI reusable application blocks

如何安装 @geti-ui/blocks?

在项目目录运行 npm install @geti-ui/blocks,或使用 pnpm add / yarn add / bun add。它还需要宿主项目提供 peer 依赖:react(>=19.0.0)、react-dom(>=19.0.0)、@react-aria/utils(^3.34.1)。npm 7 及以上与 pnpm 8 及以上默认会自动安装必需的 peer 依赖,Yarn 需要手动安装。

@geti-ui/blocks 支持 TypeScript 吗?

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

@geti-ui/blocks 支持 ESM 还是 CommonJS?

同时提供 ES Module 与 CommonJS 入口,import 和 require() 都可以使用,打包工具会自动选择合适的版本。

@geti-ui/blocks 可以商用吗?

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

@geti-ui/blocks 的下载量有多少?

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

@geti-ui/blocks 还在维护吗?

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