@done-coding/admin-core 0.3.0 → 0.3.1-alpha.0

package/types/components/display/index.d.ts

@@ -4,23 +4,17 @@ import { default as TabsMain } from './TabsMain.vue';
 import { default as HeightProvider } from './HeightProvider.vue';
 
 export { 
-/**
- * 尺寸监听容器：debounce 测量默认槽内容的宽 / 高，
- * 通过 `@height-change` / `@size-change` 上报，供高度预算等场景复用。
- */
+/** 尺寸监听容器：debounce 测默认槽内容宽/高，`@height-change` / `@size-change` 上报 */
 WatchSize, 
 /**
- * Tab 容器组件：手写 tab-bar + 滑动下划线，内部组合 HeightProvider
- * 做高度预算。激活 tab 经 `v-model<string>` 双向绑定并自动归一；
- * 内容懒渲染（首次激活前不实例化）+ KeepAlive（切走保活、切回复用，
- * 状态保留）。内容槽 `#{key}` > `tabs[].component`，
- * 标题槽 `#header-{key}` > `tabs[].title`，两类槽作用域均 `{ tab, active }`。
+ * Tab 容器：手写 tab-bar + 滑动下划线 + 懒渲染 KeepAlive。
+ * 嵌套联动用 `channel="x"` / `parentChannel="x"` 字符串显式配对（[MUST NOT] 响应式）。
  */
 TabsMain, 
 /**
- * 递归高度预算节点：按 `height` → 祖先同 channel inject → `0` 优先级
- * 取得预算，扣除 `#header` 槽实测高度后将剩余可用高度沿同 channel
- * provide 给后代。默认槽作用域 `{ height }` 提供当前可用高度数值。
+ * 纯数值高度预算节点：`available = max(viewportHeight - reserve, minHeight ?? 0)`，
+ * 默认槽 `{ height }` 暴露。Fragment 双根，不撑开自身，不 inject 不 provide。
+ * 消费方 [MUST] 用 slot scope `:height` 自设容器高。
  */
 HeightProvider, };
 export declare const displayInstall: Plugin;

package/types/components/display/types.d.ts

@@ -1,46 +1,61 @@
-import { Component } from 'vue';
+import { Component, ComputedRef } from 'vue';
 
-/**
- * `HeightProvider` 组件 props。
- *
- * 单组件即一个高度预算节点：预算优先级严格为
- * `height`（显式传入）→ 同 channel 最近祖先 HeightProvider 经 inject 下分的
- * 剩余高度 → 兜底 `0`。节点扣除自身 `#header` 槽实测高度后，
- * 将剩余可用高度沿同 channel `provide` 给后代，形成递归预算链。
- */
+/** HeightProvider props——见组件 JSDoc */
 export interface HeightProviderProps {
-    /** px，预算最高优先级来源（非空时无视祖先 inject；height=0 视为显式 0） */
-    height?: number;
-    /** 预算 channel，默认 FULLSCREEN_HEIGHT_CHANNEL */
-    channel?: symbol;
+    /** px，视口可用高度（必填） */
+    viewportHeight: number;
+    /** px，默认槽可用高度兜底下限；超 viewportHeight 时会撑破父容器（有意设计） */
+    minHeight?: number;
 }
-/**
- * `TabsMain` 单个 tab 项配置。
- *
- * 内容渲染优先级：`#{key}` 内容槽 > `component` > 空。
- * 标题渲染优先级：`#header-{key}` 标题槽 > `title` 文本。
- */
+/** TabsMain 单个 tab 项配置 */
 export interface TabsMainItem {
-    /** tab 唯一标识，v-model 值与槽名（#{key} / #header-{key}）均以此为准 */
+    /** 唯一标识，v-model 值与槽名（#{key} / #header-{key}）以此为准 */
     key: string;
-    /** tab 标题文本，#header-{key} 槽缺省时回退此文本 */
+    /** 标题文本，#header-{key} 槽缺省时回退 */
     title: string;
-    /** tab 内容组件，#{key} 槽缺省时回退渲染此组件 */
+    /** 内容组件，#{key} 槽缺省时回退渲染 */
     component?: Component;
 }
+/** tabs 族跨节点高度联动 channel 的 inject payload */
+export interface TabsChannelPayload {
+    /** 下一级 TabsMain 可消费的视口高度（响应式） */
+    viewportHeight: ComputedRef<number>;
+    /** 下一级嵌套深度（非响应式），顶层 = 1，每嵌套 +1；本期预埋不消费 */
+    level: number;
+}
+/** [top, right, bottom, left] px——TabsMain 默认插槽容器内置 padding（top+bottom 同步从 channel viewportHeight 扣减） */
+export type TabsMainPadding = [number, number, number, number];
+/**
+ * TabsHeader 视觉风格变体(与 level 字号解耦)。
+ * - card:浏览器 tabs 风格(active 三面 border + 两侧 100vw separator,真打通)
+ * - indicator:标准 2px 下划线
+ * - indicator-compact:紧凑 1px 下划线
+ * - plain:无装饰(active 加粗 + primary 字色)
+ */
+export type TabsHeaderVariant = "card" | "indicator" | "indicator-compact" | "plain";
 /**
- * `TabsMain` 组件 props。
+ * TabsMain props。
  *
- * `channel` / `height` 原样透传内部组合的 HeightProvider，
- * tab-bar 占用 HeightProvider 的 `#header` 槽并计入 reserve，
- * 内容区消费剩余可用高度。激活 tab 由 `v-model<string>` 双向绑定，
- * 非法或空值自动归一到首个 tab。
+ * 高度优先级：parentChannel inject > viewportHeight > inject `BODY_CONTENT_VIEWPORT_HEIGHT` > 0。
+ * channel / parentChannel [MUST NOT] 响应式变更（setup 期快照，变更 console.error 忽略）。
  */
 export interface TabsMainProps {
     /** tab 配置列表 */
     tabs: TabsMainItem[];
-    /** 预算 channel，默认 FULLSCREEN_HEIGHT_CHANNEL，透传内部 HeightProvider */
-    channel?: symbol;
-    /** px，透传 HeightProvider 供顶层使用 */
-    height?: number;
+    /** px，视口可用高度；未传时降级 BODY_CONTENT_VIEWPORT_HEIGHT 老链 */
+    viewportHeight?: number;
+    /** px，默认内容区高度兜底下限 */
+    minHeight?: number;
+    /** 作为父时的通道标识（字符串，内部 Symbol.for 跨包共享键） */
+    channel?: string;
+    /** 作为子时要消费的父通道标识 */
+    parentChannel?: string;
+    /** 默认插槽容器内置 padding [top,right,bottom,left]，默认 [10,0,0,0]；top+bottom 同步从 slot scope/channel viewportHeight 扣减 */
+    padding?: TabsMainPadding;
+    /** 精细化布局:true(默认) 走 HeightProvider 精确扣 header reserve + padding 给 available;false 不包 HeightProvider,默认槽 viewportHeight 直接给 viewportHeightFinal(不扣减),业务自然流 */
+    refine?: boolean;
+    /** 精细化预留高度(px),从 viewportHeightFinal 中预扣,refine=false 时同样生效 */
+    refineReduceHeight?: number;
+    /** 显式指定 TabsHeader 视觉风格,不传则按 visualLevel 推导默认(L1=card / L2=indicator / L3=indicator-compact / L4=plain)。字号始终跟随 level,不受 variant 影响。 */
+    variant?: TabsHeaderVariant;
 }

package/types/components/form/form-search-utils.d.ts

@@ -0,0 +1,24 @@
+import { ColProps } from 'element-plus';
+import { Breakpoint } from '../../hooks/use-breakpoint';
+
+export declare const computeItemsPerRow: (span: number) => number;
+/**
+ * 计算按钮 ElCol 的 offset，使其推到当前行最右。
+ * ElRow 共 24 格。
+ *
+ * @param visibleCount 可见表单项数量（不含按钮自身）
+ * @param span         当前断点下每个表单项的 span
+ */
+export declare const computeButtonOffset: (visibleCount: number, span: number) => number;
+/**
+ * 按每个响应断点分别计算按钮的 { span, offset }，
+ * 返回可直接 v-bind 到 ElCol 的对象。
+ */
+export declare const computeButtonColProps: (layout: Partial<ColProps> | undefined, visibleCount: number) => Record<string, {
+    span: number;
+    offset: number;
+}>;
+/**
+ * 计算当前断点下每行能容纳的表单项数。
+ */
+export declare const getCurrentSpan: (layout: Partial<ColProps> | undefined, breakpoint: Breakpoint) => number;

package/types/components/form/types.d.ts

@@ -1,5 +1,5 @@
 import { FormItemRule, ColProps, FormItemProps } from 'element-plus';
-import { VNode } from 'vue';
+import { VNode, ComputedRef } from 'vue';
 
 export type OnlyOneKey<T extends Record<string, any>> = {
     [K in keyof T]: {
@@ -143,6 +143,10 @@ export interface FormSearchInstance extends FormMainInstance {
     triggerSearch: () => void;
     /** 触发重置 */
     triggerReset: () => void;
+    /** 切换折叠状态 */
+    toggleCollapse: (nextValue?: boolean) => void;
+    /** 当前折叠状态 */
+    isCollapsed: ComputedRef<boolean>;
 }
 /** FormItem props */
 export interface FormMainItemProps {
@@ -162,6 +166,8 @@ export interface FormSearchProps<PO extends Record<string, any>, SO extends Reco
     labelWidth?: string;
     /** 静态参数(非表单 非分页参数) */
     staticQuery?: SQ;
+    /** 最多展示行数，超出折叠。0 = 不折叠。默认 2 */
+    maxRows?: number;
 }
 /** form item loading 信息 */
 export interface FormItemLoadingInfo {

package/types/components/list-page/types.d.ts

@@ -3,7 +3,7 @@ import { TableApiParams, TableApiResult, TableMainInstance, TableMainProps } fro
 
 export type FormSearchOptionsKey = "staticQuery";
 export type FormSearchRewriteKey = "list";
-export type TableMainOptionsKey = "refine" | "refineReduceHeight";
+export type TableMainOptionsKey = "refine" | "refineReduceHeight" | "viewportHeight" | "parentChannel";
 export type TableMainRequiredKey = "columns" | "rowKey";
 export type TableMainRewriteKey = "api" | "query" | "injectInfo";
 export type ListPageInnerInjectInfo<PO extends Record<string, any>, 

package/types/components/misc/index.d.ts

@@ -8,5 +8,14 @@ import { default as ActionBtn } from './ActionBtn.vue';
 import { default as ActionConfirm } from './ActionConfirm.vue';
 
 export * from './types';
-export { TriggerAutoImport, AutoRefresh, ActionButton, ActionButtonDanger, ActionButtonWarn, ActionBtn, ActionConfirm, };
+export { TriggerAutoImport, AutoRefresh, ActionBtn, ActionConfirm };
+/**
+ * @deprecated 改用 {@link ActionBtn}——`ActionBtn` 通过 `confirmConfig` 一体化承载
+ * loading 自动接管 + 同步/异步 confirm-gate（popconfirm / message-box 两种 mode），
+ * 并对 ElButton 全部 props 透传。`ActionButton` / `ActionButtonDanger` / `ActionButtonWarn`
+ * 三个旧组件计划后续版本移除；新代码请直接使用 `ActionBtn`，
+ * 危险态用 `<ActionBtn type="danger" :confirm-config="{ type: 'danger', ... }">`，
+ * 警告态用 `<ActionBtn :confirm-config="{ type: 'warning', ... }">`。
+ */
+export { ActionButton, ActionButtonDanger, ActionButtonWarn };
 export declare const miscInstall: Plugin;

package/types/components/modal/ConfirmModal.vue.d.ts

@@ -72,12 +72,12 @@ declare const __VLS_component: import('vue').DefineComponent<globalThis.ExtractP
 }>>> & Readonly<{
     "onUpdate:show"?: ((value: boolean) => any) | undefined;
 }>, {
+    width: number | string;
+    reverse: boolean;
     showClose: boolean;
     cancelText: string | (() => VNode);
     confirmText: string | (() => VNode);
     hiddenCancel: boolean;
-    width: number | string;
-    reverse: boolean;
     closeOnPressEscape: boolean;
     closeOnClickModal: boolean;
 }, {}, {}, {}, string, import('vue').ComponentProvideOptions, true, {}, any>;

package/types/components/table/TableToolbar.vue.d.ts

@@ -2,14 +2,14 @@ import { ExportType, TableExportContext, TableMainInstance } from './types';
 
 declare const _default: import('vue').DefineComponent<globalThis.ExtractPropTypes<{
     isAutoRefresh: import('vue').PropType<boolean>;
-    loading: {
-        type: globalThis.PropType<boolean>;
-        required: true;
-    };
     pageSize: {
         type: globalThis.PropType<number>;
         required: true;
     };
+    loading: {
+        type: globalThis.PropType<boolean>;
+        required: true;
+    };
     showRefresh: {
         type: globalThis.PropType<boolean>;
         default: boolean;
@@ -52,14 +52,14 @@ declare const _default: import('vue').DefineComponent<globalThis.ExtractPropType
     };
 }>, {}, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {}, string, import('vue').PublicProps, Readonly<globalThis.ExtractPropTypes<{
     isAutoRefresh: import('vue').PropType<boolean>;
-    loading: {
-        type: globalThis.PropType<boolean>;
-        required: true;
-    };
     pageSize: {
         type: globalThis.PropType<number>;
         required: true;
     };
+    loading: {
+        type: globalThis.PropType<boolean>;
+        required: true;
+    };
     showRefresh: {
         type: globalThis.PropType<boolean>;
         default: boolean;

package/types/components/table/types.d.ts

@@ -173,4 +173,8 @@ F extends Record<string, any>> {
     injectInfo?: F;
     /** 数据视口最大高度最小值 */
     dataViewMaxHeightMinValue?: number;
+    /** 视口可用高度(优先级高于 BODY_CONTENT_VIEWPORT_HEIGHT 老链 inject,低于 parentChannel inject);未传时回退 inject 链 + fallback 500 */
+    viewportHeight?: number;
+    /** 父级 tabs 族 channel 标识(setup 期 Symbol.for 快照,变更 console.error 忽略);命中后高度从父级 inject 取,优先级最高 */
+    parentChannel?: string;
 }

package/types/hooks/index.d.ts

@@ -1,4 +1,6 @@
+export * from './use-breakpoint';
 export * from './activated';
 export * from './feel-size';
 export * from './menus-dispatch';
 export * from './timeout';
+export * from './use-channel-viewport-height';

package/types/hooks/use-breakpoint.d.ts

@@ -0,0 +1,4 @@
+export type Breakpoint = "xs" | "sm" | "md" | "lg" | "xl";
+export declare const useBreakpoint: () => {
+    activeBreakpoint: Readonly<globalThis.Ref<Breakpoint, Breakpoint>>;
+};

package/types/hooks/use-channel-viewport-height.d.ts

@@ -0,0 +1,28 @@
+import { ComputedRef } from 'vue';
+
+/** useChannelViewportHeight 第二参数 options */
+export interface UseChannelViewportHeightOptions {
+    /** body inject 未命中时的最终兜底,默认 0 */
+    fallback?: number;
+}
+/** useChannelViewportHeight 入参对象形状(约定 reactive,props 即满足) */
+export interface UseChannelViewportHeightMaybeProps {
+    /** props.viewportHeight,优先级位于 parentChannel inject 之下、body inject 之上 */
+    viewportHeight?: number;
+    /** tabs 族 channel 父级标识——setup 期 Symbol.for 快照,变更 console.error 忽略 */
+    parentChannel?: string;
+}
+/** useChannelViewportHeight 返回值 */
+export interface UseChannelViewportHeightReturn {
+    /** 最终视口高度,链路 parentChannel > viewportHeight > body inject > fallback */
+    viewportHeightFinal: ComputedRef<number>;
+    /** parent inject 命中时取 payload.level,否则 0;调用方算 childLevel = parentLevel + 1 */
+    parentLevel: ComputedRef<number>;
+}
+/**
+ * tabs 族 channel 视口高度解析 hook。
+ * 链路:parentChannel inject > maybeProps.viewportHeight > body inject > options.fallback。
+ * `parentChannel` setup 期 Symbol.for 快照,变更 console.error 忽略(非响应式)。
+ * 入参 maybeProps 约定 reactive 对象(props 即满足);返回 viewportHeightFinal/parentLevel 均为 computed。
+ */
+export declare const useChannelViewportHeight: (maybeProps: UseChannelViewportHeightMaybeProps, options?: UseChannelViewportHeightOptions) => UseChannelViewportHeightReturn;

package/types/inject/key.d.ts

@@ -12,19 +12,19 @@ import { ModalLevel, ShelfController } from '../components/modal';
  * 产生多个 Symbol → inject/provide 失配 → 列表精细化高度计算塌陷至 fallback。
  */
 export declare const BODY_CONTENT_VIEWPORT_HEIGHT: unique symbol;
-/**
- * 全屏高度预算 channel
- * ---
- * HeightProvider 沿此 channel 向后代 provide「扣除自身 chrome 后剩余可用高度」，
- * 形成与 BODY_CONTENT_VIEWPORT_HEIGHT 完全独立、并存的递归高度预算链。
- * ---
- * 同样使用 `Symbol.for` 全局注册表保证跨包 / 跨 chunk / 跨 ESM 实例的 Symbol 唯一性
- * （dev 走 src、prod 走 es 双 module instance，`Symbol(key)` 会产生两个不同 Symbol
- * 导致 provide/inject 失配 → 预算链断裂）。
- */
-export declare const FULLSCREEN_HEIGHT_CHANNEL: unique symbol;
 /**
  * 弹窗架子 inject key 工厂——按 level 参数化。
  * Symbol.for 全局注册表保证跨包/跨 chunk/跨 ESM 实例唯一（同 BODY_CONTENT_VIEWPORT_HEIGHT）。
  */
 export declare function getModalShelfInjectionKey(level: ModalLevel): InjectionKey<ShelfController>;
+/**
+ * TabsMain 视觉嵌套层级 inject key（独立于 channel payload.level）。
+ * ---
+ * 与 channel 体系完全解耦：
+ * - channel level：高度预算用，父未配 channel 时子 selfLevel=1（看是否 inject 命中）
+ * - 视觉 level：物理嵌套深度，每层 TabsMain（含 refine=false）+1 → provide 给后代
+ * ---
+ * 用途：TabsHeader 据此应用层级化样式（L1 卡片 / L2 下划线 / L3 紧凑 / L4+ 仅文字加粗）。
+ * setup 期一次性 provide number（不响应式）；Symbol.for 跨包/chunk/ESM 实例唯一（同上）。
+ */
+export declare const TABS_MAIN_VISUAL_LEVEL: InjectionKey<number>;