@done-coding/admin-core 0.26.1 → 0.27.0

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

@@ -1,3 +1,4 @@
+import { ComponentPublicInstance } from 'vue';
 type __VLS_Props = {
     /**
      * 徽标键；命中 `bridge.badge` 注册表且未过期才渲染角标。
@@ -43,11 +44,161 @@ declare function __VLS_template(): {
         default?(_: {}): any;
         default?(_: {}): any;
     };
-    refs: {};
+    refs: {
+        badgeRef: ({
+            $: import('vue').ComponentInternalInstance;
+            $data: {};
+            $props: {
+                readonly value?: string | number | undefined;
+                readonly max?: number | undefined;
+                readonly isDot?: boolean | undefined;
+                readonly hidden?: boolean | undefined;
+                readonly type?: "primary" | "success" | "warning" | "info" | "danger" | undefined;
+                readonly showZero?: boolean | undefined;
+                readonly color?: string | undefined;
+                readonly badgeStyle?: import('vue').StyleValue;
+                readonly offset?: [number, number] | undefined;
+                readonly badgeClass?: string | undefined;
+            } & import('vue').VNodeProps & import('vue').AllowedComponentProps & import('vue').ComponentCustomProps;
+            $attrs: import('vue').Attrs;
+            $refs: {
+                [x: string]: unknown;
+            };
+            $slots: Readonly<{
+                [name: string]: import('vue').Slot<any> | undefined;
+            }>;
+            $root: ComponentPublicInstance | null;
+            $parent: ComponentPublicInstance | null;
+            $host: Element | null;
+            $emit: (event: string, ...args: any[]) => void;
+            $el: any;
+            $options: import('vue').ComponentOptionsBase<Readonly<import('element-plus').BadgeProps> & Readonly<{}>, {
+                content: import('vue').ComputedRef<string>;
+            }, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {}, string, {
+                offset: [number, number];
+                type: "primary" | "success" | "warning" | "info" | "danger";
+                value: string | number;
+                max: number;
+                showZero: boolean;
+                badgeStyle: string | false | import('vue').CSSProperties | import('vue').StyleValue[] | null;
+            }, {}, string, {}, import('vue').GlobalComponents, import('vue').GlobalDirectives, string, import('vue').ComponentProvideOptions> & {
+                beforeCreate?: (() => void) | (() => void)[];
+                created?: (() => void) | (() => void)[];
+                beforeMount?: (() => void) | (() => void)[];
+                mounted?: (() => void) | (() => void)[];
+                beforeUpdate?: (() => void) | (() => void)[];
+                updated?: (() => void) | (() => void)[];
+                activated?: (() => void) | (() => void)[];
+                deactivated?: (() => void) | (() => void)[];
+                beforeDestroy?: (() => void) | (() => void)[];
+                beforeUnmount?: (() => void) | (() => void)[];
+                destroyed?: (() => void) | (() => void)[];
+                unmounted?: (() => void) | (() => void)[];
+                renderTracked?: ((e: import('vue').DebuggerEvent) => void) | ((e: import('vue').DebuggerEvent) => void)[];
+                renderTriggered?: ((e: import('vue').DebuggerEvent) => void) | ((e: import('vue').DebuggerEvent) => void)[];
+                errorCaptured?: ((err: unknown, instance: ComponentPublicInstance | null, info: string) => boolean | void) | ((err: unknown, instance: ComponentPublicInstance | null, info: string) => boolean | void)[];
+            };
+            $forceUpdate: () => void;
+            $nextTick: typeof import('vue').nextTick;
+            $watch<T extends string | ((...args: any) => any)>(source: T, cb: T extends (...args: any) => infer R ? (...args: [R, R, import('@vue/reactivity').OnCleanup]) => any : (...args: [any, any, import('@vue/reactivity').OnCleanup]) => any, options?: import('vue').WatchOptions): import('vue').WatchStopHandle;
+        } & Readonly<{
+            offset: [number, number];
+            type: "primary" | "success" | "warning" | "info" | "danger";
+            value: string | number;
+            max: number;
+            showZero: boolean;
+            badgeStyle: string | false | import('vue').CSSProperties | import('vue').StyleValue[] | null;
+        }> & Omit<Readonly<import('element-plus').BadgeProps> & Readonly<{}>, "value" | "max" | "content" | "offset" | "type" | "showZero" | "badgeStyle"> & {
+            content: string;
+        } & {} & import('vue').ComponentCustomProperties & {} & {
+            $slots: {
+                default?: (props: {}) => any;
+            } & {
+                content?: (props: {
+                    value: string;
+                }) => any;
+            };
+        }) | null;
+    };
     rootEl: any;
 };
 type __VLS_TemplateResult = ReturnType<typeof __VLS_template>;
-declare const __VLS_component: import('vue').DefineComponent<__VLS_Props, {}, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {}, string, import('vue').PublicProps, Readonly<__VLS_Props> & Readonly<{}>, {}, {}, {}, {}, string, import('vue').ComponentProvideOptions, false, {}, any>;
+declare const __VLS_component: import('vue').DefineComponent<__VLS_Props, {}, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {}, string, import('vue').PublicProps, Readonly<__VLS_Props> & Readonly<{}>, {}, {}, {}, {}, string, import('vue').ComponentProvideOptions, false, {
+    badgeRef: ({
+        $: import('vue').ComponentInternalInstance;
+        $data: {};
+        $props: {
+            readonly value?: string | number | undefined;
+            readonly max?: number | undefined;
+            readonly isDot?: boolean | undefined;
+            readonly hidden?: boolean | undefined;
+            readonly type?: "primary" | "success" | "warning" | "info" | "danger" | undefined;
+            readonly showZero?: boolean | undefined;
+            readonly color?: string | undefined;
+            readonly badgeStyle?: import('vue').StyleValue;
+            readonly offset?: [number, number] | undefined;
+            readonly badgeClass?: string | undefined;
+        } & import('vue').VNodeProps & import('vue').AllowedComponentProps & import('vue').ComponentCustomProps;
+        $attrs: import('vue').Attrs;
+        $refs: {
+            [x: string]: unknown;
+        };
+        $slots: Readonly<{
+            [name: string]: import('vue').Slot<any> | undefined;
+        }>;
+        $root: ComponentPublicInstance | null;
+        $parent: ComponentPublicInstance | null;
+        $host: Element | null;
+        $emit: (event: string, ...args: any[]) => void;
+        $el: any;
+        $options: import('vue').ComponentOptionsBase<Readonly<import('element-plus').BadgeProps> & Readonly<{}>, {
+            content: import('vue').ComputedRef<string>;
+        }, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {}, string, {
+            offset: [number, number];
+            type: "primary" | "success" | "warning" | "info" | "danger";
+            value: string | number;
+            max: number;
+            showZero: boolean;
+            badgeStyle: string | false | import('vue').CSSProperties | import('vue').StyleValue[] | null;
+        }, {}, string, {}, import('vue').GlobalComponents, import('vue').GlobalDirectives, string, import('vue').ComponentProvideOptions> & {
+            beforeCreate?: (() => void) | (() => void)[];
+            created?: (() => void) | (() => void)[];
+            beforeMount?: (() => void) | (() => void)[];
+            mounted?: (() => void) | (() => void)[];
+            beforeUpdate?: (() => void) | (() => void)[];
+            updated?: (() => void) | (() => void)[];
+            activated?: (() => void) | (() => void)[];
+            deactivated?: (() => void) | (() => void)[];
+            beforeDestroy?: (() => void) | (() => void)[];
+            beforeUnmount?: (() => void) | (() => void)[];
+            destroyed?: (() => void) | (() => void)[];
+            unmounted?: (() => void) | (() => void)[];
+            renderTracked?: ((e: import('vue').DebuggerEvent) => void) | ((e: import('vue').DebuggerEvent) => void)[];
+            renderTriggered?: ((e: import('vue').DebuggerEvent) => void) | ((e: import('vue').DebuggerEvent) => void)[];
+            errorCaptured?: ((err: unknown, instance: ComponentPublicInstance | null, info: string) => boolean | void) | ((err: unknown, instance: ComponentPublicInstance | null, info: string) => boolean | void)[];
+        };
+        $forceUpdate: () => void;
+        $nextTick: typeof import('vue').nextTick;
+        $watch<T extends string | ((...args: any) => any)>(source: T, cb: T extends (...args: any) => infer R ? (...args: [R, R, import('@vue/reactivity').OnCleanup]) => any : (...args: [any, any, import('@vue/reactivity').OnCleanup]) => any, options?: import('vue').WatchOptions): import('vue').WatchStopHandle;
+    } & Readonly<{
+        offset: [number, number];
+        type: "primary" | "success" | "warning" | "info" | "danger";
+        value: string | number;
+        max: number;
+        showZero: boolean;
+        badgeStyle: string | false | import('vue').CSSProperties | import('vue').StyleValue[] | null;
+    }> & Omit<Readonly<import('element-plus').BadgeProps> & Readonly<{}>, "value" | "max" | "content" | "offset" | "type" | "showZero" | "badgeStyle"> & {
+        content: string;
+    } & {} & import('vue').ComponentCustomProperties & {} & {
+        $slots: {
+            default?: (props: {}) => any;
+        } & {
+            content?: (props: {
+                value: string;
+            }) => any;
+        };
+    }) | null;
+}, any>;
 declare const _default: __VLS_WithTemplateSlots<typeof __VLS_component, __VLS_TemplateResult["slots"]>;
 export default _default;
 type __VLS_WithTemplateSlots<T, S> = T & {

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

@@ -204,7 +204,7 @@ declare function __VLS_template(): {
              * 无单一"可用视口高度"语义)。
              */
             ?: string | undefined) => any) | undefined;
-        }>, "offset" | "type" | "marker" | "scrollTo" | "direction" | "bound" | "duration"> & {
+        }>, "offset" | "type" | "marker" | "scrollTo" | "direction" | "duration" | "bound"> & {
             scrollTo: (href
             /**
              * TabsTile —— TabsMain 平铺(tile)模式渲染分支(仅 TabsMain 内部经 `v-if=tile` 消费,不对外单独发布)。
@@ -414,7 +414,7 @@ declare const __VLS_component: import('vue').DefineComponent<__VLS_PublicProps,
          * 无单一"可用视口高度"语义)。
          */
         ?: string | undefined) => any) | undefined;
-    }>, "offset" | "type" | "marker" | "scrollTo" | "direction" | "bound" | "duration"> & {
+    }>, "offset" | "type" | "marker" | "scrollTo" | "direction" | "duration" | "bound"> & {
         scrollTo: (href
         /**
          * TabsTile —— TabsMain 平铺(tile)模式渲染分支(仅 TabsMain 内部经 `v-if=tile` 消费,不对外单独发布)。

package/types/components/display/use-badge-mask.d.ts

@@ -0,0 +1,8 @@
+import { BadgeEntry } from '../../bridge';
+/**
+ * 启动徽标遮挡。
+ *
+ * @param getAnchor 取 `BadgeMark` 自身的 DOM 落点（用于向上 `closest` 找宿主）
+ * @param getEntry  取当前命中的标（未命中 / 已过期为 `undefined`）
+ */
+export declare const useBadgeMask: (getAnchor: () => HTMLElement | undefined, getEntry: () => BadgeEntry | undefined) => void;

package/types/components/display/use-badge.d.ts

@@ -1,5 +1,6 @@
-import { ComputedRef } from 'vue';
+import { ComputedRef, Component } from 'vue';
 import { BadgeProps } from 'element-plus';
+import { BadgeEntry } from '../../bridge';
 /** 徽标解析结果——已过滤过期项，直接可渲染 */
 export interface BadgeResolved {
     /** ElBadge value（数量标为数字，其余为文案） */
@@ -8,6 +9,10 @@ export interface BadgeResolved {
     max?: number;
     /** ElBadge 语义色档 */
     type: BadgeProps["type"];
+    /** 图标（状态三档走图标而非文字）；有它则 `value` 不渲染、改由 `#content` 出图标 */
+    icon?: Component;
+    /** 完整文案——图标档的悬浮气泡用它把语义补回来 */
+    label?: string;
 }
 /**
  * 按 key 解析出可渲染的徽标；无 key / 未 `app.use(bridge)` / 未命中 / 已过期 → `undefined`。
@@ -16,4 +21,11 @@ export interface BadgeResolved {
  * `ActionBtn` 可用在 AppLayout 之外的任何地方。**opt-in**：未 `app.use(bridge)` 时静默不显，
  * [MUST NOT] 抛错。
  */
+/**
+ * 按 key 取**原始标条目**（未命中 / 已过期 → `undefined`）。
+ *
+ * 与 {@link useBadgeResolved} 的分工：后者产「可渲染的展示数据」，本函数产「标本身」——
+ * 遮挡功能要读 `kind` 判是否该挡、读 `onTrigger` 决定点击归宿，那些不是展示数据。
+ */
+export declare function useBadgeEntry(getKey: () => string | undefined): ComputedRef<BadgeEntry | undefined>;
 export declare function useBadgeResolved(getKey: () => string | undefined): ComputedRef<BadgeResolved | undefined>;

package/types/components/icon/IconHammer.vue.d.ts

@@ -0,0 +1,2 @@
+declare const _default: import('vue').DefineComponent<{}, {}, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {}, string, import('vue').PublicProps, Readonly<{}> & Readonly<{}>, {}, {}, {}, {}, string, import('vue').ComponentProvideOptions, true, {}, SVGSVGElement>;
+export default _default;

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

@@ -0,0 +1,7 @@
+import { default as IconHammer } from './IconHammer.vue';
+export { 
+/**
+ * 锤子图标（施工 / 开发中）。EP 图标集无锤子，最接近的 `Tools` 会被读成「设置」。
+ * `currentColor` + `1em`：颜色随父级、尺寸随字号，套 `ElIcon` 即可控。
+ */
+IconHammer, };

package/types/index.d.ts

@@ -3,6 +3,7 @@ export { InfiniteListView, DataGridView } from './components/data-view';
 export type { DataGridViewInstance, DataGridViewPageInfo, DataGridViewProps, InfiniteListViewConfig, InfiniteListViewInstance, InfiniteListViewProps, } from './components/data-view';
 export * from './components/menu';
 export * from './components/display';
+export * from './components/icon';
 export * from './components/misc';
 export * from './components/modal';
 export * from './components/table';

package/types/injectInfo.json.d.ts

@@ -1,6 +1,6 @@
 declare const _default: {
   "name": "@done-coding/admin-core",
-  "version": "0.26.1",
+  "version": "0.27.0",
   "description": "内部前端库"
 };