@ailife-dev-vue/uiplus 0.0.12-snapshot → 0.0.13-snapshot

package/dist/index.d.ts

@@ -7,6 +7,7 @@ import { ComponentProvideOptions } from 'vue';
 import { Composer } from 'vue-i18n';
 import { ComputedRef } from 'vue';
 import { CreateComponentPublicInstanceWithMixins } from 'vue';
+import { CSSProperties } from 'vue';
 import { DefineComponent } from 'vue';
 import { ExtractPropTypes } from 'vue';
 import { GlobalComponents } from 'vue';
@@ -19,6 +20,7 @@ import { PropType } from 'vue';
 import { PublicProps } from 'vue';
 import { Ref } from 'vue';
 import { VNodeProps } from 'vue';
+import { WatchSource } from 'vue';
 
 export declare type ActionStatusbarCommandPayload = HilinkDeviceControlPayload;
 
@@ -201,6 +203,17 @@ declare const boolPanelCardProps: {
     };
 };
 
+/** 半卡主/副标题默认 fit 参数，供文档与接入方引用 */
+export declare const CARD_TITLE_TEXT_FIT_DEFAULTS: {
+    readonly titleMode: CardTitleTextLineMode;
+    readonly subtitleMode: CardTitleTextLineMode;
+    readonly titleBaseFontSize: 16;
+    readonly subtitleBaseFontSize: 12;
+    readonly titleMinFontSize: 12;
+    readonly subtitleMinFontSize: 9;
+    readonly lineHeightRatio: 1.2;
+};
+
 export declare type CardsProps = ExtractPropTypes<typeof cardsProps>;
 
 declare const cardsProps: {
@@ -211,6 +224,8 @@ declare const cardsProps: {
     };
 };
 
+export declare type CardTitleTextLineMode = 1 | 2;
+
 export declare interface Characteristic {
     characteristicName: string;
     characteristicType: string;
@@ -476,6 +491,16 @@ export declare const enUS: {
         'numeric-input-placeholder': string;
         'numeric-input-invalid': string;
     };
+    connect: {
+        disconnected: string;
+        connecting: string;
+        failed: string;
+        connected: string;
+        failureDialogContent: string;
+        tryLater: string;
+        reconnect: string;
+        reconnectNow: string;
+    };
     pageBarNew: {
         scene: {
             sectionTitle: string;
@@ -641,16 +666,7 @@ export declare const enUS: {
         placeholderOption4: string;
         more: string;
     };
-    commonBannerNew: {
-        connect: {
-            disconnected: string;
-            connecting: string;
-            failed: string;
-            failureDialogContent: string;
-            tryLater: string;
-            reconnectNow: string;
-        };
-    };
+    commonBannerNew: {};
     generalMode: {
         actionOpen: string;
         inUse: string;
@@ -1279,6 +1295,8 @@ export declare type HilinkDeviceControlFn = (deviceId: string, payloadJson: stri
  */
 export declare type HilinkDeviceControlPayload = Record<string, Record<string, string | number | boolean | Record<string, unknown> | Array<unknown>>> | Array<Record<string, Record<string, string | number | boolean | Record<string, unknown> | Array<unknown>>>>;
 
+export declare type HilinkDispatchListener = (payload: HilinkDeviceControlPayload) => void;
+
 /** 与宿主约定：`setTitleVisible(visible, callbackName)`，`true` 显示原生标题栏，`false` 隐藏。 */
 export declare type HilinkSetTitleVisibleFn = (visible: boolean, callbackName: string) => void;
 
@@ -1680,6 +1698,9 @@ declare const statusBarProps: {
 
 export declare type StatusBarValue = StatusBarBinaryState;
 
+/** 订阅组件库内 `sendHilinkDeviceControl` 的下发事件；返回取消订阅函数。 */
+export declare function subscribeHilinkDeviceControl(listener: HilinkDispatchListener): () => void;
+
 export declare type TableLampFadeTimeCardSize = 'full' | 'half';
 
 export declare type TableLampFadeTimeCommandPayload = HilinkDeviceControlPayload;
@@ -1974,8 +1995,11 @@ export declare const UpBoolIconCard: {
     cardSize: "full" | "half";
     }, true, {}, {}, GlobalComponents, GlobalDirectives, string, {
     headRef: HTMLDivElement;
+    titleRowRef: HTMLDivElement;
+    titleRef: HTMLDivElement;
     infoTriggerRef: HTMLButtonElement;
     infoTooltipRef: HTMLDivElement;
+    statusRef: HTMLDivElement;
     }, HTMLDivElement, ComponentProvideOptions, {
     P: {};
     B: {};
@@ -2177,8 +2201,12 @@ export declare const UpBoolPanelCard: {
     closeDialogContent: string;
     }, true, {}, {}, GlobalComponents, GlobalDirectives, string, {
     headRef: HTMLDivElement;
+    titleRowRef: HTMLDivElement;
+    titleRef: HTMLDivElement;
     infoTriggerRef: HTMLButtonElement;
     infoTooltipRef: HTMLDivElement;
+    statusRef: HTMLDivElement;
+    dropzoneRef: HTMLDivElement;
     }, HTMLDivElement, ComponentProvideOptions, {
     P: {};
     B: {};
@@ -2375,8 +2403,11 @@ export declare const UpBoolSwitchCard: {
     cardSize: "full" | "half";
     }, true, {}, {}, GlobalComponents, GlobalDirectives, string, {
     headRef: HTMLDivElement;
+    titleRowRef: HTMLDivElement;
+    titleRef: HTMLDivElement;
     infoTriggerRef: HTMLButtonElement;
     infoTooltipRef: HTMLDivElement;
+    statusRef: HTMLDivElement;
     }, HTMLDivElement, ComponentProvideOptions, {
     P: {};
     B: {};
@@ -2523,8 +2554,9 @@ export declare const UpCards: {
     }>> & Readonly<{}>, {}, {}, {}, {}, ComponentOptionsMixin, ComponentOptionsMixin, {}, PublicProps, {
     collapsedRows: number;
     }, true, {}, {}, GlobalComponents, GlobalDirectives, string, {
+    rootRef: HTMLDivElement;
     gridRef: HTMLDivElement;
-    }, HTMLDivElement, ComponentProvideOptions, {
+    }, any, ComponentProvideOptions, {
     P: {};
     B: {};
     D: {};
@@ -3204,7 +3236,11 @@ export declare const UpGeneralEnumDialogCard: {
     subscribes: ProductSubscribe[];
     cardSize: GeneralEnumDialogCardSize;
     visibleEnumValues: (string | number)[];
-    }, true, {}, {}, GlobalComponents, GlobalDirectives, string, {}, HTMLDivElement, ComponentProvideOptions, {
+    }, true, {}, {}, GlobalComponents, GlobalDirectives, string, {
+    textRef: HTMLDivElement;
+    titleRef: HTMLDivElement;
+    subtitleRef: HTMLDivElement;
+    }, HTMLDivElement, ComponentProvideOptions, {
     P: {};
     B: {};
     D: {};
@@ -3277,6 +3313,9 @@ export declare const UpGeneralEnumDroplistCard: {
     }, true, {}, {}, GlobalComponents, GlobalDirectives, string, {
     rootRef: HTMLDivElement;
     dropdownRef: HTMLDivElement;
+    textRef: HTMLDivElement;
+    titleRef: HTMLDivElement;
+    subtitleRef: HTMLDivElement;
     }, HTMLDivElement, ComponentProvideOptions, {
     P: {};
     B: {};
@@ -3426,6 +3465,7 @@ export declare const UpGeneralEnumTile: {
     moreEnumOptionConfigs: GeneralEnumTileOptionConfig[];
     }, true, {}, {}, GlobalComponents, GlobalDirectives, string, {
     moreDropdownRef: HTMLDivElement;
+    dropzoneRef: HTMLDivElement;
     }, HTMLDivElement, ComponentProvideOptions, {
     P: {};
     B: {};
@@ -3868,7 +3908,7 @@ export declare const UpGeneralReminder: {
     };
     }>> & Readonly<{}>, {}, {}, {}, {}, ComponentOptionsMixin, ComponentOptionsMixin, {}, PublicProps, {
     enumConfigs: GeneralReminderEnumConfig[];
-    }, true, {}, {}, GlobalComponents, GlobalDirectives, string, {}, any, ComponentProvideOptions, {
+    }, true, {}, {}, GlobalComponents, GlobalDirectives, string, {}, HTMLDivElement, ComponentProvideOptions, {
     P: {};
     B: {};
     D: {};
@@ -4488,6 +4528,7 @@ export declare const UpPageBarNew: {
     productWikiDeviceTransport: PageBarNewProductWikiDeviceTransport;
     }, true, {}, {}, GlobalComponents, GlobalDirectives, string, {
     scrollRef: HTMLDivElement;
+    dropzoneRef: HTMLDivElement;
     }, HTMLDivElement, ComponentProvideOptions, {
     P: {};
     B: {};
@@ -5409,6 +5450,31 @@ bindStatusEnabled: boolean;
 bindStatusValue: string | number;
 }, {}, string, {}, GlobalComponents, GlobalDirectives, string, ComponentProvideOptions> & VNodeProps & AllowedComponentProps & ComponentCustomProps & Plugin_2;
 
+export declare function useCardTitleTextFit(
+/** 文本区容器（`flex:1; min-width:0`），用于 ResizeObserver 与可见宽度早退 */
+measureWidthRef: Ref<HTMLElement | null>, titleRef: Ref<HTMLElement | null>, subtitleRef: Ref<HTMLElement | null>, options?: UseCardTitleTextFitOptions): {
+    titleStyle: ComputedRef<CSSProperties>;
+    subtitleStyle: ComputedRef<CSSProperties>;
+    titleNeedsEllipsis: Ref<boolean, boolean>;
+    subtitleNeedsEllipsis: Ref<boolean, boolean>;
+    titleUseMultiline: Ref<boolean, boolean>;
+    subtitleUseMultiline: Ref<boolean, boolean>;
+    remeasure: () => void;
+};
+
+export declare interface UseCardTitleTextFitOptions {
+    /** 1: 单行；2: 优先单行缩小至 min，仍放不下则固定 min 字号换最多两行。默认主标题 2、副标题 1 */
+    titleMode?: CardTitleTextLineMode;
+    subtitleMode?: CardTitleTextLineMode;
+    titleBaseFontSize?: number;
+    subtitleBaseFontSize?: number;
+    titleMinFontSize?: number;
+    subtitleMinFontSize?: number;
+    lineHeightRatio?: number;
+    hasSubtitle?: MaybeRefOrGetter<boolean>;
+    watchSources?: WatchSource[];
+}
+
 /**
  * 是否与 `UpConfigProvider` 的 `theme="dark"` 一致：依据 `document.documentElement` 是否包含 `dark` 类。
  * 用于组件内随深浅色切换资源（如图标），并在运行时响应主题切换。
@@ -5567,6 +5633,16 @@ export declare const zhCN: {
         'numeric-input-placeholder': string;
         'numeric-input-invalid': string;
     };
+    connect: {
+        disconnected: string;
+        connecting: string;
+        failed: string;
+        connected: string;
+        failureDialogContent: string;
+        tryLater: string;
+        reconnect: string;
+        reconnectNow: string;
+    };
     pageBarNew: {
         scene: {
             sectionTitle: string;
@@ -5732,16 +5808,7 @@ export declare const zhCN: {
         placeholderOption4: string;
         more: string;
     };
-    commonBannerNew: {
-        connect: {
-            disconnected: string;
-            connecting: string;
-            failed: string;
-            failureDialogContent: string;
-            tryLater: string;
-            reconnectNow: string;
-        };
-    };
+    commonBannerNew: {};
     generalMode: {
         actionOpen: string;
         inUse: string;