vue3-ep-biz-lib 0.1.1

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026-present syanjun
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,77 @@
+# vue3-ep-biz-lib
+
+基于 **Vue3 + Element Plus + TypeScript + SCSS + VitePress** 的企业级业务组件库，工程规范对标 Element Plus。
+
+## 工程结构
+
+```
+packages/
+├── components/     # 组件源码（每个组件独立目录：src/组件.vue + style/index.scss + index.ts）
+├── hooks/          # 公共组合式函数
+├── utils/          # 工具方法（withInstall / makeInstaller）
+├── types/          # 全局 TS 类型定义
+└── theme/          # SCSS 全局变量、Element Plus 主题变量复用
+
+docs/
+├── .vitepress/     # VitePress 配置 + 主题 + :::demo 容器插件
+├── zh-CN/
+│   ├── guide/      # 开发指南
+│   └── components/ # 组件文档（md）
+└── examples/       # 文档 demo 示例（组件名/示例名.vue）
+```
+
+## 命令
+
+| 命令 | 说明 |
+| ---- | ---- |
+| `npm run dev` | 启动文档站本地开发 |
+| `npm run build` | 构建组件库（ES + UMD + d.ts） |
+| `npm run typecheck` | TS 类型检查 |
+| `npm run docs:build` | 构建文档站 |
+| `npm run release` | 发布 npm 包（release 分支 + tag，见[发布指南](docs/zh-CN/guide/release.md)） |
+
+## 新增组件三步
+
+1. 在 `packages/components/xxx-component/` 开发组件，`index.ts` 中 `withInstall` 导出；
+2. 在 `packages/components/index.ts` 的 `components` 数组中注册；
+3. 补充 `docs/zh-CN/components/xxx-component.md` 文档与 `docs/examples/xxx-component/basic.vue` 示例。
+
+## 使用方式
+
+### 全局注册
+
+```ts
+import { createApp } from 'vue'
+import ElementPlus from 'element-plus'
+import 'element-plus/dist/index.css'
+import Vue3EpBizLib from 'vue3-ep-biz-lib'
+import 'vue3-ep-biz-lib/dist/style.css' // 组件样式（npm 安装时必引）
+import App from './App.vue'
+
+const app = createApp(App)
+app.use(ElementPlus)
+app.use(Vue3EpBizLib)
+app.mount('#app')
+```
+
+### 按需导入
+
+```vue
+<script setup lang="ts">
+import { BizButton } from 'vue3-ep-biz-lib'
+</script>
+
+<template>
+  <BizButton type="primary">按需导入</BizButton>
+</template>
+```
+
+## 发布
+
+统一命令（自动完成 release 分支、版本号、tag、构建、发布、合回 master）：
+
+```bash
+npm run release          # patch；minor/major/显式版本号：npm run release -- minor
+```
+
+完整流程与注意事项见 [发布指南](docs/zh-CN/guide/release.md)。

package/dist/style.css

@@ -0,0 +1 @@
+@charset "UTF-8";.biz-button__icon-font{display:inline-flex;align-items:center;justify-content:center;width:1em;height:1em;font-size:inherit;font-style:normal;line-height:1}.biz-button .biz-button__icon-font+.biz-button__text{margin-left:6px}.biz-button.el-button--small .biz-button__icon-font+.biz-button__text{margin-left:4px}.biz-button.el-button--large .biz-button__icon-font+.biz-button__text{margin-left:8px}.biz-button.is-only-icon .biz-button__text{display:none}.biz-button.is-only-icon:not(.is-circle):not(.is-text):not(.is-link):not(.el-button--text){width:var(--el-component-size);padding-inline:0}.biz-button.is-only-icon.el-button--small:not(.is-circle):not(.is-text):not(.is-link):not(.el-button--text){width:var(--el-component-size-small);padding-inline:0}.biz-button.is-only-icon.el-button--large:not(.is-circle):not(.is-text):not(.is-link):not(.el-button--text){width:var(--el-component-size-large);padding-inline:0}.biz-divide-title{display:block;width:100%;font-size:var(--el-font-size-base);line-height:var(--el-font-line-height-primary);color:var(--el-text-color-primary)}.biz-divide-title--large{font-size:var(--el-font-size-medium)}.biz-divide-title--small{font-size:var(--el-font-size-small)}.biz-divide-title__header{display:flex;align-items:center;gap:8px;min-width:0;width:100%}.biz-divide-title__accent{flex-shrink:0;width:4px;height:1em;border-radius:2px;background-color:var(--el-color-primary)}.biz-divide-title__text{flex:1;min-width:0;overflow:hidden;text-overflow:ellipsis;white-space:nowrap}.biz-divide-title.is-bold .biz-divide-title__text{font-weight:600}.biz-divide-title__extra{flex-shrink:0;margin-left:auto;display:flex;align-items:center;gap:8px;font-size:var(--el-font-size-base);font-weight:400;color:var(--el-text-color-regular)}.biz-divide-title.is-collapsible .biz-divide-title__header{cursor:pointer;-webkit-user-select:none;user-select:none;min-height:var(--el-component-size)}.biz-divide-title__arrow{color:var(--el-text-color-secondary);transition:transform var(--el-transition-duration) ease}.biz-divide-title.is-collapsed .biz-divide-title__arrow{transform:rotate(-90deg)}.biz-divide-title__content{display:grid;grid-template-rows:1fr;margin-top:12px;transition:grid-template-rows var(--el-transition-duration) ease}.biz-divide-title__content.is-collapsed{grid-template-rows:0fr;margin-top:0}.biz-divide-title__content-inner{overflow:hidden;min-height:0}.biz-divide-title.is-divider .biz-divide-title__header{padding-bottom:8px;border-bottom:1px solid var(--el-border-color-light)}.biz-divide-title.is-divider-dashed .biz-divide-title__header{border-bottom-style:dashed}.biz-divide-title.is-divider .biz-divide-title__content{margin-top:16px}.biz-divide-title.is-divider .biz-divide-title__content.is-collapsed{margin-top:0}.biz-divide-title--small .biz-divide-title__content{margin-top:8px}.biz-divide-title--small .biz-divide-title__content.is-collapsed{margin-top:0}.biz-image-viewer{--biz-image-viewer-thumb-width: 120px;--biz-image-viewer-thumb-height: 90px;display:flex;flex-wrap:wrap;align-items:flex-start;gap:8px;width:100%}.biz-image-viewer__item{position:relative;flex-shrink:0}.biz-image-viewer__thumb{width:var(--biz-image-viewer-thumb-width);height:var(--biz-image-viewer-thumb-height);border-radius:var(--el-border-radius-base);border:1px solid var(--el-border-color-lighter);box-sizing:border-box;cursor:pointer;transition:border-color var(--el-transition-duration-fast) ease}.biz-image-viewer__thumb:hover{border-color:var(--el-color-primary)}.biz-image-viewer__loading{display:flex;align-items:center;justify-content:center;width:100%;height:100%;background:var(--el-fill-color-light);color:var(--el-text-color-secondary);font-size:var(--el-font-size-base)}.biz-image-viewer__error{display:flex;flex-direction:column;align-items:center;justify-content:center;gap:4px;width:100%;height:100%;background:var(--el-fill-color-light);color:var(--el-text-color-secondary);font-size:var(--el-font-size-base)}.biz-image-viewer__extra{position:absolute;inset-inline:0;bottom:0;pointer-events:auto}.biz-image-viewer__more{display:flex;align-items:center;justify-content:center;width:var(--biz-image-viewer-thumb-width);height:var(--biz-image-viewer-thumb-height);border-radius:var(--el-border-radius-base);border:1px solid var(--el-border-color-lighter);box-sizing:border-box;background:var(--el-fill-color-light);color:var(--el-text-color-regular);font-size:var(--el-font-size-medium);font-weight:600;cursor:pointer;transition:all var(--el-transition-duration-fast) ease}.biz-image-viewer__more:hover{background:var(--el-fill-color);color:var(--el-color-primary);border-color:var(--el-color-primary)}.biz-image-viewer__empty{width:100%;padding:4px 0}.biz-modal__header{display:flex;align-items:center;gap:8px;width:100%;min-width:0}.biz-modal__title{flex:1;min-width:0;overflow:hidden;text-overflow:ellipsis;white-space:nowrap;font-size:var(--el-dialog-title-font-size, var(--el-font-size-medium));font-weight:600;line-height:var(--el-font-line-height-primary);color:var(--el-text-color-primary)}.biz-modal__fullscreen-btn{flex-shrink:0;margin-left:auto;font-size:var(--el-font-size-medium);color:var(--el-text-color-secondary);cursor:pointer;transition:color var(--el-transition-duration-fast)}.biz-modal__fullscreen-btn:hover{color:var(--el-color-primary)}.biz-modal__body.is-scrollable{max-height:var(--biz-modal-body-max-height);overflow-y:auto;scrollbar-width:thin;scrollbar-color:var(--el-border-color) transparent}.biz-modal__async-loading{display:flex;flex-direction:column;align-items:center;justify-content:center;gap:12px;padding:48px 0;color:var(--el-text-color-secondary)}.biz-modal__async-loading-icon{width:24px;height:24px;border:2px solid var(--el-border-color-light);border-top-color:var(--el-color-primary);border-radius:50%;animation:biz-modal-rotate .8s linear infinite}.biz-modal__async-loading-text{font-size:var(--el-font-size-base)}@keyframes biz-modal-rotate{to{transform:rotate(360deg)}}.biz-search-form .el-form-item{margin-bottom:18px}.biz-search-form__actions{display:flex;align-items:center;justify-content:flex-end;margin-bottom:18px}.biz-search-form__expand-icon{margin-left:4px;transition:transform var(--el-transition-duration)}.biz-table{display:flex;flex-direction:column;min-width:0}.biz-table__toolbar{display:flex;align-items:center;justify-content:space-between;gap:8px;padding-bottom:12px}.biz-table__toolbar-left{display:flex;align-items:center;min-width:0;overflow:hidden}.biz-table__toolbar-title{font-size:16px;font-weight:600;color:var(--el-text-color-primary);white-space:nowrap;text-overflow:ellipsis;overflow:hidden}.biz-table__toolbar-actions{display:flex;flex-shrink:0;align-items:center;gap:4px}.biz-table__action{width:28px;height:28px;padding:0;margin-left:0;border-radius:var(--el-border-radius-base);font-size:16px;color:var(--el-text-color-regular);transition:color var(--el-transition-duration),background-color var(--el-transition-duration)}.biz-table__action+.biz-table__action{margin-left:4px}.biz-table__action:hover{color:var(--el-color-primary);background-color:var(--el-fill-color-light)}.biz-table__action:focus-visible{outline:none;color:var(--el-color-primary);background-color:var(--el-fill-color-light)}.biz-table__main{position:relative;flex:1;min-height:180px;overflow:hidden}.biz-table__loading{position:absolute;top:0;right:0;bottom:0;left:0;z-index:10;display:flex;align-items:center;justify-content:center;background-color:var(--el-mask-color-lighter);color:var(--el-color-primary)}.biz-table__loading .el-icon.is-loading{animation:rotating 2s linear infinite}.biz-table .el-table__header{margin:0}.biz-table .el-table--large th.el-table__cell{padding-top:calc(var(--biz-table-header-padding-y) + 2px);padding-bottom:calc(var(--biz-table-header-padding-y) + 2px)}.biz-table .el-table--default th.el-table__cell{padding-top:var(--biz-table-header-padding-y);padding-bottom:var(--biz-table-header-padding-y)}.biz-table .el-table--small th.el-table__cell{padding-top:calc(var(--biz-table-header-padding-y) - 2px);padding-bottom:calc(var(--biz-table-header-padding-y) - 2px)}.biz-table th.el-table__cell .cell{white-space:nowrap}.biz-table__pagination{flex-shrink:0;display:flex;align-items:center;justify-content:flex-end;padding-top:12px}.biz-table__pagination .el-pagination{min-width:0;flex-wrap:wrap;row-gap:8px;justify-content:flex-end}.biz-table__pagination .el-pager{margin:0;padding:0}.biz-table.is-fullscreen{position:fixed;top:0;right:0;bottom:0;left:0;z-index:var(--el-index-top);padding:16px;background-color:var(--el-bg-color)}.biz-table__column-setting .el-checkbox{width:100%;height:28px;margin-right:0}.biz-table__column-setting-head{display:flex;align-items:center;justify-content:space-between;padding-bottom:4px;margin-bottom:4px;border-bottom:1px solid var(--el-border-color-lighter)}.biz-table__column-setting-head .el-checkbox{height:auto;width:auto}.biz-table__density-popper .el-dropdown-menu__item.is-active{color:var(--el-color-primary);background-color:var(--el-color-primary-light-9)}@keyframes rotating{0%{transform:rotate(0)}to{transform:rotate(360deg)}}

package/dist/types/components/biz-button/index.d.ts

@@ -0,0 +1,161 @@
+/** 业务按钮：el-button 全量透传 + only-icon 图标按钮模式（hover tooltip）+ 图标三通道（组件/字体 class/插槽） */
+export declare const BizButton: import('..').SFCWithInstall<{
+    new (...args: any[]): import('vue').CreateComponentPublicInstanceWithMixins<Readonly<import('vue').ExtractPropTypes<{
+        icon: {
+            type: import('vue').PropType<import('.').BizButtonIcon>;
+            default: undefined;
+        };
+        onlyIcon: {
+            type: import('vue').PropType<boolean>;
+            default: boolean;
+        };
+        tooltip: {
+            type: import('vue').PropType<string>;
+            default: string;
+        };
+        tooltipPlacement: {
+            type: import('vue').PropType<import('.').BizButtonTooltipPlacement>;
+            default: string;
+        };
+        tooltipEffect: {
+            type: import('vue').PropType<import('.').BizButtonTooltipEffect>;
+            default: string;
+        };
+        tooltipDisabled: {
+            type: import('vue').PropType<boolean>;
+            default: boolean;
+        };
+        tooltipShowAfter: {
+            type: import('vue').PropType<number>;
+            default: number;
+        };
+        tooltipHideAfter: {
+            type: import('vue').PropType<number>;
+            default: number;
+        };
+    }>> & Readonly<{}>, {
+        buttonRef: import('vue').Ref<import('element-plus').ButtonInstance | null, import('element-plus').ButtonInstance | null>;
+        focus: () => void;
+        blur: () => void;
+    }, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {}, import('vue').PublicProps, {
+        icon: import('.').BizButtonIcon;
+        onlyIcon: boolean;
+        tooltip: string;
+        tooltipPlacement: import('.').BizButtonTooltipPlacement;
+        tooltipEffect: import('.').BizButtonTooltipEffect;
+        tooltipDisabled: boolean;
+        tooltipShowAfter: number;
+        tooltipHideAfter: number;
+    }, true, {}, {}, import('vue').GlobalComponents, import('vue').GlobalDirectives, string, {}, any, import('vue').ComponentProvideOptions, {
+        P: {};
+        B: {};
+        D: {};
+        C: {};
+        M: {};
+        Defaults: {};
+    }, Readonly<import('vue').ExtractPropTypes<{
+        icon: {
+            type: import('vue').PropType<import('.').BizButtonIcon>;
+            default: undefined;
+        };
+        onlyIcon: {
+            type: import('vue').PropType<boolean>;
+            default: boolean;
+        };
+        tooltip: {
+            type: import('vue').PropType<string>;
+            default: string;
+        };
+        tooltipPlacement: {
+            type: import('vue').PropType<import('.').BizButtonTooltipPlacement>;
+            default: string;
+        };
+        tooltipEffect: {
+            type: import('vue').PropType<import('.').BizButtonTooltipEffect>;
+            default: string;
+        };
+        tooltipDisabled: {
+            type: import('vue').PropType<boolean>;
+            default: boolean;
+        };
+        tooltipShowAfter: {
+            type: import('vue').PropType<number>;
+            default: number;
+        };
+        tooltipHideAfter: {
+            type: import('vue').PropType<number>;
+            default: number;
+        };
+    }>> & Readonly<{}>, {
+        buttonRef: import('vue').Ref<import('element-plus').ButtonInstance | null, import('element-plus').ButtonInstance | null>;
+        focus: () => void;
+        blur: () => void;
+    }, {}, {}, {}, {
+        icon: import('.').BizButtonIcon;
+        onlyIcon: boolean;
+        tooltip: string;
+        tooltipPlacement: import('.').BizButtonTooltipPlacement;
+        tooltipEffect: import('.').BizButtonTooltipEffect;
+        tooltipDisabled: boolean;
+        tooltipShowAfter: number;
+        tooltipHideAfter: number;
+    }>;
+    __isFragment?: never;
+    __isTeleport?: never;
+    __isSuspense?: never;
+} & import('vue').ComponentOptionsBase<Readonly<import('vue').ExtractPropTypes<{
+    icon: {
+        type: import('vue').PropType<import('.').BizButtonIcon>;
+        default: undefined;
+    };
+    onlyIcon: {
+        type: import('vue').PropType<boolean>;
+        default: boolean;
+    };
+    tooltip: {
+        type: import('vue').PropType<string>;
+        default: string;
+    };
+    tooltipPlacement: {
+        type: import('vue').PropType<import('.').BizButtonTooltipPlacement>;
+        default: string;
+    };
+    tooltipEffect: {
+        type: import('vue').PropType<import('.').BizButtonTooltipEffect>;
+        default: string;
+    };
+    tooltipDisabled: {
+        type: import('vue').PropType<boolean>;
+        default: boolean;
+    };
+    tooltipShowAfter: {
+        type: import('vue').PropType<number>;
+        default: number;
+    };
+    tooltipHideAfter: {
+        type: import('vue').PropType<number>;
+        default: number;
+    };
+}>> & Readonly<{}>, {
+    buttonRef: import('vue').Ref<import('element-plus').ButtonInstance | null, import('element-plus').ButtonInstance | null>;
+    focus: () => void;
+    blur: () => void;
+}, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {}, string, {
+    icon: import('.').BizButtonIcon;
+    onlyIcon: boolean;
+    tooltip: string;
+    tooltipPlacement: import('.').BizButtonTooltipPlacement;
+    tooltipEffect: import('.').BizButtonTooltipEffect;
+    tooltipDisabled: boolean;
+    tooltipShowAfter: number;
+    tooltipHideAfter: number;
+}, {}, string, {}, import('vue').GlobalComponents, import('vue').GlobalDirectives, string, import('vue').ComponentProvideOptions> & import('vue').VNodeProps & import('vue').AllowedComponentProps & import('vue').ComponentCustomProps & (new () => {
+    $slots: {
+        icon?(_: {}): any;
+        default?(_: {}): any;
+    };
+})>;
+export default BizButton;
+export type { BizButtonIcon, BizButtonTooltipPlacement, BizButtonTooltipEffect, BizButtonProps, } from './src/types';
+/** 组件实例类型：`ref` 获取 { buttonRef, focus, blur } */
+export type BizButtonInstance = InstanceType<typeof BizButton>;

package/dist/types/components/biz-button/src/types.d.ts

@@ -0,0 +1,36 @@
+import { Component } from 'vue';
+
+/**
+ * 图标入参（三通道之一/之二）：
+ * - `Component`：`@element-plus/icons-vue` 图标组件 / 业务自定义 SVG 组件
+ * - `string`：任意第三方字体图标 class（如 `'iconfont icon-edit'`、`'ri-home-line'`）
+ *
+ * 说明：el-button 的 `icon` prop 内部按组件名解析字符串，无法承载字体 class，
+ * 字体图标由 BizButton 自渲染 `<i :class>`，因此 icon 不透传给 el-button。
+ */
+export type BizButtonIcon = Component | string;
+/** tooltip 弹出方位（对齐 el-tooltip placement 取值） */
+export type BizButtonTooltipPlacement = 'top' | 'top-start' | 'top-end' | 'bottom' | 'bottom-start' | 'bottom-end' | 'left' | 'left-start' | 'left-end' | 'right' | 'right-start' | 'right-end';
+/** tooltip 主题 */
+export type BizButtonTooltipEffect = 'dark' | 'light';
+export interface BizButtonProps {
+    /** 图标：组件（EP 图标 / 自定义 SVG 组件）或 字体图标 class 字符串 */
+    icon?: BizButtonIcon;
+    /**
+     * 图标按钮模式：隐藏按钮文本、按钮方形化（等宽等高），
+     * 鼠标移入以 tooltip 呈现按钮文本（`tooltip` prop 留空时自动取默认插槽文本）
+     */
+    onlyIcon?: boolean;
+    /** tooltip 文本；留空时自动取默认插槽文本；两者皆空则 tooltip 自动禁用 */
+    tooltip?: string;
+    /** tooltip 弹出方位 */
+    tooltipPlacement?: BizButtonTooltipPlacement;
+    /** tooltip 主题 */
+    tooltipEffect?: BizButtonTooltipEffect;
+    /** 关闭 tooltip */
+    tooltipDisabled?: boolean;
+    /** tooltip 显示延迟（ms） */
+    tooltipShowAfter?: number;
+    /** tooltip 隐藏延迟（ms） */
+    tooltipHideAfter?: number;
+}

package/dist/types/components/biz-divide-title/index.d.ts

@@ -0,0 +1,175 @@
+/** 业务分块标题：装饰竖条 + 标题/操作区/分割线 + 可折叠内容区 */
+export declare const BizDivideTitle: import('..').SFCWithInstall<{
+    new (...args: any[]): import('vue').CreateComponentPublicInstanceWithMixins<Readonly<import('vue').ExtractPropTypes<{
+        size: {
+            type: import('vue').PropType<import('.').BizDivideTitleSize>;
+            default: string;
+        };
+        bold: {
+            type: import('vue').PropType<boolean>;
+            default: boolean;
+        };
+        title: {
+            type: import('vue').PropType<string>;
+            default: string;
+        };
+        accent: {
+            type: import('vue').PropType<boolean>;
+            default: boolean;
+        };
+        accentColor: {
+            type: import('vue').PropType<string>;
+            default: string;
+        };
+        divider: {
+            type: import('vue').PropType<import('.').BizDivideTitleDivider>;
+            default: boolean;
+        };
+        collapsible: {
+            type: import('vue').PropType<boolean>;
+            default: boolean;
+        };
+        collapsed: {
+            type: import('vue').PropType<boolean>;
+            default: boolean;
+        };
+    }>> & Readonly<{
+        "onUpdate:collapsed"?: ((value: boolean) => any) | undefined;
+        onCollapse?: ((value: boolean) => any) | undefined;
+        "onClick-title"?: ((event: MouseEvent) => any) | undefined;
+    }>, {
+        toggle: () => void;
+    }, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {
+        "update:collapsed": (value: boolean) => void;
+        collapse: (value: boolean) => void;
+        "click-title": (event: MouseEvent) => void;
+    }, import('vue').PublicProps, {
+        size: import('.').BizDivideTitleSize;
+        bold: boolean;
+        title: string;
+        accent: boolean;
+        accentColor: string;
+        divider: import('.').BizDivideTitleDivider;
+        collapsible: boolean;
+        collapsed: boolean;
+    }, true, {}, {}, import('vue').GlobalComponents, import('vue').GlobalDirectives, string, {}, any, import('vue').ComponentProvideOptions, {
+        P: {};
+        B: {};
+        D: {};
+        C: {};
+        M: {};
+        Defaults: {};
+    }, Readonly<import('vue').ExtractPropTypes<{
+        size: {
+            type: import('vue').PropType<import('.').BizDivideTitleSize>;
+            default: string;
+        };
+        bold: {
+            type: import('vue').PropType<boolean>;
+            default: boolean;
+        };
+        title: {
+            type: import('vue').PropType<string>;
+            default: string;
+        };
+        accent: {
+            type: import('vue').PropType<boolean>;
+            default: boolean;
+        };
+        accentColor: {
+            type: import('vue').PropType<string>;
+            default: string;
+        };
+        divider: {
+            type: import('vue').PropType<import('.').BizDivideTitleDivider>;
+            default: boolean;
+        };
+        collapsible: {
+            type: import('vue').PropType<boolean>;
+            default: boolean;
+        };
+        collapsed: {
+            type: import('vue').PropType<boolean>;
+            default: boolean;
+        };
+    }>> & Readonly<{
+        "onUpdate:collapsed"?: ((value: boolean) => any) | undefined;
+        onCollapse?: ((value: boolean) => any) | undefined;
+        "onClick-title"?: ((event: MouseEvent) => any) | undefined;
+    }>, {
+        toggle: () => void;
+    }, {}, {}, {}, {
+        size: import('.').BizDivideTitleSize;
+        bold: boolean;
+        title: string;
+        accent: boolean;
+        accentColor: string;
+        divider: import('.').BizDivideTitleDivider;
+        collapsible: boolean;
+        collapsed: boolean;
+    }>;
+    __isFragment?: never;
+    __isTeleport?: never;
+    __isSuspense?: never;
+} & import('vue').ComponentOptionsBase<Readonly<import('vue').ExtractPropTypes<{
+    size: {
+        type: import('vue').PropType<import('.').BizDivideTitleSize>;
+        default: string;
+    };
+    bold: {
+        type: import('vue').PropType<boolean>;
+        default: boolean;
+    };
+    title: {
+        type: import('vue').PropType<string>;
+        default: string;
+    };
+    accent: {
+        type: import('vue').PropType<boolean>;
+        default: boolean;
+    };
+    accentColor: {
+        type: import('vue').PropType<string>;
+        default: string;
+    };
+    divider: {
+        type: import('vue').PropType<import('.').BizDivideTitleDivider>;
+        default: boolean;
+    };
+    collapsible: {
+        type: import('vue').PropType<boolean>;
+        default: boolean;
+    };
+    collapsed: {
+        type: import('vue').PropType<boolean>;
+        default: boolean;
+    };
+}>> & Readonly<{
+    "onUpdate:collapsed"?: ((value: boolean) => any) | undefined;
+    onCollapse?: ((value: boolean) => any) | undefined;
+    "onClick-title"?: ((event: MouseEvent) => any) | undefined;
+}>, {
+    toggle: () => void;
+}, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {
+    "update:collapsed": (value: boolean) => void;
+    collapse: (value: boolean) => void;
+    "click-title": (event: MouseEvent) => void;
+}, string, {
+    size: import('.').BizDivideTitleSize;
+    bold: boolean;
+    title: string;
+    accent: boolean;
+    accentColor: string;
+    divider: import('.').BizDivideTitleDivider;
+    collapsible: boolean;
+    collapsed: boolean;
+}, {}, string, {}, import('vue').GlobalComponents, import('vue').GlobalDirectives, string, import('vue').ComponentProvideOptions> & import('vue').VNodeProps & import('vue').AllowedComponentProps & import('vue').ComponentCustomProps & (new () => {
+    $slots: {
+        title?(_: {}): any;
+        extra?(_: {}): any;
+        default?(_: {}): any;
+    };
+})>;
+export default BizDivideTitle;
+export type { BizDivideTitleSize, BizDivideTitleDivider, BizDivideTitleProps, } from './src/types';
+export type BizDivideTitleInstance = InstanceType<typeof BizDivideTitle>;

package/dist/types/components/biz-divide-title/src/types.d.ts

@@ -0,0 +1,22 @@
+/** 分块标题尺寸档位（映射主题字号变量） */
+export type BizDivideTitleSize = 'large' | 'default' | 'small';
+/** 分割线：true / 'solid' 实线，'dashed' 虚线 */
+export type BizDivideTitleDivider = boolean | 'solid' | 'dashed';
+export interface BizDivideTitleProps {
+    /** 标题文本（#title 插槽优先） */
+    title?: string;
+    /** 尺寸档位：large 16px / default 14px / small 13px（竖条高度随字号自适应） */
+    size?: BizDivideTitleSize;
+    /** 是否加粗标题 */
+    bold?: boolean;
+    /** 是否展示左侧装饰竖条 */
+    accent?: boolean;
+    /** 竖条自定义颜色（默认 var(--el-color-primary)） */
+    accentColor?: string;
+    /** 标题行下方分割线（占满整行，右侧操作区随行居上） */
+    divider?: BizDivideTitleDivider;
+    /** 是否可折叠：标题可点击切换，右侧渲染箭头，default 插槽为折叠内容 */
+    collapsible?: boolean;
+    /** 折叠状态（v-model:collapsed，仅 collapsible 时有意义） */
+    collapsed?: boolean;
+}

package/dist/types/components/biz-image-viewer/src/types.d.ts

@@ -0,0 +1,41 @@
+/** 归一化后的图片项（组件内部使用 / 插槽作用域类型） */
+export interface BizImageViewerItem {
+    /** 缩略图地址 */
+    src: string;
+    /** 预览大图地址（缺省用 src） */
+    previewSrc?: string;
+    /** 图片名称（渲染为 alt，提升无障碍） */
+    name?: string;
+}
+/** 图片数据源单项：url / 归一化对象 / 业务记录（配合字段映射 props） */
+export type BizImageViewerDataItem = string | BizImageViewerItem | Record<string, unknown>;
+/** 图片数据源：url 字符串数组、归一化对象数组，或业务记录数组（配合 src-key 等字段映射 props） */
+export type BizImageViewerDataSource = string[] | BizImageViewerItem[] | Record<string, unknown>[];
+export interface BizImageViewerProps {
+    /** 图片数据：string[] 直传；对象数组可用 src-key / preview-src-key / name-key 映射字段 */
+    images?: BizImageViewerDataSource;
+    /** 对象数组时缩略图地址字段名（'' 表示直接读 item.src） */
+    srcKey?: string;
+    /** 对象数组时预览大图字段名（'' 表示与缩略图同源） */
+    previewSrcKey?: string;
+    /** 对象数组时名称字段名（'' 表示不读取） */
+    nameKey?: string;
+    /** 点击缩略图是否打开全屏预览 */
+    preview?: boolean;
+    /** 最多展示缩略图数量，0 全部展示；超出部分聚合为 +N 占位（点击打开预览定位到首张隐藏图） */
+    limit?: number;
+    /** 缩略图懒加载（滚动进入视口才加载） */
+    lazy?: boolean;
+    /** 空数据时是否展示占位 */
+    showEmpty?: boolean;
+    /** 空数据占位文案 */
+    emptyText?: string;
+    /** 全屏预览：点击遮罩关闭 */
+    hideOnClickModal?: boolean;
+    /** 全屏预览：Esc 关闭 */
+    closeOnPressEscape?: boolean;
+    /** 全屏预览：滚轮缩放速率 */
+    zoomRate?: number;
+    /** 全屏预览：是否挂载到 body */
+    teleported?: boolean;
+}