@songluo/ui-biz

@songluo/ui-biz

监管平台业务组件层——PersonPicker / ClosureFlowBar / Pager / AppCard。 跨模块复用、API 已稳定的业务件;组件本体不做数据获取,数据经 props 注入。依赖 @songluo/ui-base。

安装

npm i @songluo/ui-base @songluo/ui-biz
# peer: react ^18.3.1 || ^19、lucide-react ^1.16

使用

import { Pager, PersonPicker, ClosureFlowBar, AppCard } from '@songluo/ui-biz';
import '@songluo/ui-base/dist/style.css';
import '@songluo/ui-biz/dist/style.css';

各组件完整可粘贴示例见其档案(仓库 packages/ui-biz/src/*.meta.js 的 example 字段), 或平台内 /tech 客户视角「接入」页签一键复制。

公开 API(冻结面)

组件	必填 props	关键可选 props
PersonPicker	open / onOpenChange	contacts、targetType、multiple、requireNote、onConfirm
ClosureFlowBar	current	reachable、onNavigate、stages(环节文案外置)
Pager	page / pageSize / total / onPage	—(total ≤ pageSize 返回 null 为契约行为)
AppCard	app / onRoute / onAsk	feature、canRoute

类型:@songluo/ui-biz 自带 types/index.d.ts。

换肤与稳定性

• 品牌位默认挂全局 token(--pp-*/--cf-*/--pg-* 跟随 --primary 等);细调见 docs/theme-token-whitelist.md。换主色时白名单里带 ⚠ 的派生位(光环/浅底)需一并覆盖(包内不用 color-mix)。
• 非公开面:DOM 结构与内部类名本身(pp-*/cc-*/closure-*/app-directory-*)。
• 变更遵循 semver 版本政策,冻结面见 docs/api-surface.md,变更见根 CHANGELOG.md。

当前 0.x,公开面可能调整,升级前读 CHANGELOG。

License

见根 README.md License 段(法务定稿前为占位)。