@ailife-dev-vue/uiplus 0.1.18-snapshot → 0.1.20-snapshot

package/dist/index.d.ts

@@ -27,6 +27,9 @@ export declare interface ActionStatusbarConfirmDialogConfig {
     content?: string;
 }
 
+/** 与 StatusBar 一致：`minute`→00:00，`second`→00:00:00 */
+export declare type ActionStatusbarMiddleTimeUnit = DurationTimeUnit;
+
 export declare type ActionStatusbarProps = ExtractPropTypes<typeof actionStatusbarProps>;
 
 declare const actionStatusbarProps: {
@@ -56,6 +59,14 @@ declare const actionStatusbarProps: {
         type: BooleanConstructor;
         default: boolean;
     };
+    middleAsTimeFormat: {
+        type: BooleanConstructor;
+        default: boolean;
+    };
+    middleTimeUnit: {
+        type: PropType<ActionStatusbarMiddleTimeUnit>;
+        default: string;
+    };
 };
 
 export declare type ActionStatusbarState = 0 | 1 | 2;
@@ -253,6 +264,9 @@ export declare interface Characteristic {
     report?: number;
 }
 
+/** 与 StatusBar 一致：`minute`→00:00，`second`→00:00:00；作用于左下 int/float */
+export declare type CommonBannerNewMiddleTimeUnit = DurationTimeUnit;
+
 export declare type CommonBannerNewProps = ExtractPropTypes<typeof commonBannerNewProps>;
 
 declare const commonBannerNewProps: {
@@ -284,6 +298,16 @@ declare const commonBannerNewProps: {
         type: BooleanConstructor;
         default: boolean;
     };
+    /** 左下绑 int/float 时是否格式化为时间；enum 忽略 */
+    middleAsTimeFormat: {
+        type: BooleanConstructor;
+        default: boolean;
+    };
+    /** middleAsTimeFormat=true 时生效；默认 minute→00:00 */
+    middleTimeUnit: {
+        type: PropType<CommonBannerNewMiddleTimeUnit>;
+        default: string;
+    };
     enableOpenDialog: {
         type: BooleanConstructor;
         default: boolean;
@@ -327,7 +351,8 @@ export declare type CommonInfoEnumItemConfig = CommonInfoItemConfigBase & {
 export declare type CommonInfoIntFloatItemConfig = CommonInfoItemConfigBase & {
     valueMode?: CommonInfoValueMode;
     asTimeFormat?: boolean;
-    timeUnit?: 'minute' | 'second';
+    /** asTimeFormat=true：minute → 00:00，second → 00:00:00（仅做数值换算，不约定上报单位） */
+    timeUnit?: DurationTimeUnit;
     unit?: string;
 };
 
@@ -422,6 +447,9 @@ export declare interface DeviceInfoBase {
     quickmenu?: unknown[];
 }
 
+/** 时间展示枚举：`minute`→00:00，`second`→00:00:00（仅做数值换算，不约定上报单位） */
+export declare type DurationTimeUnit = 'minute' | 'second';
+
 /**
  * 设备产品档案模型与规则判定工具：
  * - 定义 profile/services/characteristics/state 的核心类型；
@@ -2049,7 +2077,7 @@ declare type StatusBarBinaryState = 0 | 1;
 /** 与 `sendHilinkDeviceControl` / `window.hilink._deviceControlInner` 约定一致 */
 export declare type StatusBarCommandPayload = HilinkDeviceControlPayload;
 
-export declare type StatusBarMiddleTimeUnit = 'second' | 'mmss';
+export declare type StatusBarMiddleTimeUnit = DurationTimeUnit;
 
 export declare type StatusBarProps = ExtractPropTypes<typeof statusBarProps>;
 
@@ -2186,14 +2214,14 @@ declare const subpageDisplayItemProps: {
         type: BooleanConstructor;
         default: boolean;
     };
-    /** 仅 int/float 且 asTimeFormat=true：minute → HH:MM，second → HH:MM:SS */
+    /** 仅 int/float 且 asTimeFormat=true：minute → 00:00，second → 00:00:00（仅做数值换算，不约定上报单位） */
     timeUnit: {
         type: PropType<SubpageDisplayItemTimeUnit>;
         default: string;
     };
 };
 
-export declare type SubpageDisplayItemTimeUnit = 'minute' | 'second';
+export declare type SubpageDisplayItemTimeUnit = DurationTimeUnit;
 
 export declare type SubpageEnumItemCommandPayload = HilinkDeviceControlPayload;
 
@@ -2377,6 +2405,26 @@ declare const tableLampSleepyProps: {
     };
 };
 
+export declare interface TextProps {
+    /** 展示文案；text-or-key；解析 trim 为空则不渲染 */
+    content?: string;
+    /** 字号 px；未传或非法用主题默认 */
+    fontSize?: number;
+    /** 浅色主题文字色；空或非法时按深浅回退规则处理 */
+    color?: string;
+    /** 深色主题文字色；空或非法时按深浅回退规则处理 */
+    darkColor?: string;
+    /** 文案水平对齐：left / center / right；非法回退 left */
+    textAlign?: TextTextAlign;
+    /**
+     * 是否套标准卡壳：白底 / 深色 #2a2b2f、16px 圆角、四向 16px 内边距。
+     * 默认 false，保持无背景无圆角。
+     */
+    showBackground?: boolean;
+}
+
+export declare type TextTextAlign = 'left' | 'center' | 'right';
+
 export declare type TimerCardSize = 'full' | 'half';
 
 declare type TimerCommandPayload = HilinkDeviceControlPayload;
@@ -2483,6 +2531,13 @@ declare const timeWheelPickerProps: {
 
 export declare type TimeWheelPickerValue = Record<string, string | number>;
 
+/**
+ * 大屏视口最小宽度（px）。
+ * 须与 theme `$up-large-screen-min-width` / `@mixin up-large-screen` 保持一致
+ *（`@media` 不宜依赖 CSS 变量）。
+ */
+export declare const UP_LARGE_SCREEN_MIN_WIDTH = 700;
+
 export declare const UpActionStatusbar: {
     new (...args: any[]): CreateComponentPublicInstanceWithMixins<Readonly<ExtractPropTypes<    {
     subscribesAction: {
@@ -2509,14 +2564,27 @@ export declare const UpActionStatusbar: {
     type: BooleanConstructor;
     default: boolean;
     };
+    middleAsTimeFormat: {
+    type: BooleanConstructor;
+    default: boolean;
+    };
+    middleTimeUnit: {
+    type: PropType<ActionStatusbarMiddleTimeUnit>;
+    default: string;
+    };
     }>> & Readonly<{}>, {}, {}, {}, {}, ComponentOptionsMixin, ComponentOptionsMixin, {}, PublicProps, {
     subscribesCenter: ProductSubscribe[];
     showMiddle: boolean;
     showMiddleWhenOff: boolean;
+    middleAsTimeFormat: boolean;
+    middleTimeUnit: DurationTimeUnit;
     subscribesAction: ProductSubscribe[];
     subscribesStatus: ProductSubscribe[];
     statusConfigs: ActionStatusbarStatusConfig[];
-    }, true, {}, {}, GlobalComponents, GlobalDirectives, string, {}, HTMLDivElement, ComponentProvideOptions, {
+    }, true, {}, {}, GlobalComponents, GlobalDirectives, string, {
+    middleRef: HTMLDivElement;
+    middlePrimaryRef: HTMLDivElement;
+    }, HTMLDivElement, ComponentProvideOptions, {
     P: {};
     B: {};
     D: {};
@@ -2548,10 +2616,20 @@ export declare const UpActionStatusbar: {
     type: BooleanConstructor;
     default: boolean;
     };
+    middleAsTimeFormat: {
+    type: BooleanConstructor;
+    default: boolean;
+    };
+    middleTimeUnit: {
+    type: PropType<ActionStatusbarMiddleTimeUnit>;
+    default: string;
+    };
     }>> & Readonly<{}>, {}, {}, {}, {}, {
     subscribesCenter: ProductSubscribe[];
     showMiddle: boolean;
     showMiddleWhenOff: boolean;
+    middleAsTimeFormat: boolean;
+    middleTimeUnit: DurationTimeUnit;
     subscribesAction: ProductSubscribe[];
     subscribesStatus: ProductSubscribe[];
     statusConfigs: ActionStatusbarStatusConfig[];
@@ -2584,10 +2662,20 @@ showMiddleWhenOff: {
 type: BooleanConstructor;
 default: boolean;
 };
+middleAsTimeFormat: {
+type: BooleanConstructor;
+default: boolean;
+};
+middleTimeUnit: {
+type: PropType<ActionStatusbarMiddleTimeUnit>;
+default: string;
+};
 }>> & Readonly<{}>, {}, {}, {}, {}, ComponentOptionsMixin, ComponentOptionsMixin, {}, string, {
 subscribesCenter: ProductSubscribe[];
 showMiddle: boolean;
 showMiddleWhenOff: boolean;
+middleAsTimeFormat: boolean;
+middleTimeUnit: DurationTimeUnit;
 subscribesAction: ProductSubscribe[];
 subscribesStatus: ProductSubscribe[];
 statusConfigs: ActionStatusbarStatusConfig[];
@@ -3366,6 +3454,14 @@ export declare const UpCommonBannerNew: {
     type: BooleanConstructor;
     default: boolean;
     };
+    middleAsTimeFormat: {
+    type: BooleanConstructor;
+    default: boolean;
+    };
+    middleTimeUnit: {
+    type: PropType<CommonBannerNewMiddleTimeUnit>;
+    default: string;
+    };
     enableOpenDialog: {
     type: BooleanConstructor;
     default: boolean;
@@ -3407,6 +3503,8 @@ export declare const UpCommonBannerNew: {
     closeDialogShowTitle: boolean;
     closeDialogTitle: string;
     closeDialogContent: string;
+    middleAsTimeFormat: boolean;
+    middleTimeUnit: DurationTimeUnit;
     subscribesLeftTop: ProductSubscribe[];
     showLeftBottom: boolean;
     subscribesLeftBottom: ProductSubscribe[];
@@ -3450,6 +3548,14 @@ export declare const UpCommonBannerNew: {
     type: BooleanConstructor;
     default: boolean;
     };
+    middleAsTimeFormat: {
+    type: BooleanConstructor;
+    default: boolean;
+    };
+    middleTimeUnit: {
+    type: PropType<CommonBannerNewMiddleTimeUnit>;
+    default: string;
+    };
     enableOpenDialog: {
     type: BooleanConstructor;
     default: boolean;
@@ -3491,6 +3597,8 @@ export declare const UpCommonBannerNew: {
     closeDialogShowTitle: boolean;
     closeDialogTitle: string;
     closeDialogContent: string;
+    middleAsTimeFormat: boolean;
+    middleTimeUnit: DurationTimeUnit;
     subscribesLeftTop: ProductSubscribe[];
     showLeftBottom: boolean;
     subscribesLeftBottom: ProductSubscribe[];
@@ -3531,6 +3639,14 @@ showBottomWhenOff: {
 type: BooleanConstructor;
 default: boolean;
 };
+middleAsTimeFormat: {
+type: BooleanConstructor;
+default: boolean;
+};
+middleTimeUnit: {
+type: PropType<CommonBannerNewMiddleTimeUnit>;
+default: string;
+};
 enableOpenDialog: {
 type: BooleanConstructor;
 default: boolean;
@@ -3572,6 +3688,8 @@ enableCloseDialog: boolean;
 closeDialogShowTitle: boolean;
 closeDialogTitle: string;
 closeDialogContent: string;
+middleAsTimeFormat: boolean;
+middleTimeUnit: DurationTimeUnit;
 subscribesLeftTop: ProductSubscribe[];
 showLeftBottom: boolean;
 subscribesLeftBottom: ProductSubscribe[];
@@ -3786,6 +3904,7 @@ export declare const UpEnumStatus: {
     contentRef: HTMLDivElement;
     titleRef: HTMLDivElement;
     statusRef: HTMLDivElement;
+    detailHeaderLeftRef: HTMLDivElement;
     }, HTMLDivElement, ComponentProvideOptions, {
     P: {};
     B: {};
@@ -3912,7 +4031,9 @@ export declare const UpEnumStatusGauge: {
     currentLabel: string;
     enumCount: number;
     selectedIndex: number;
-    }, true, {}, {}, GlobalComponents, GlobalDirectives, string, {}, HTMLDivElement, ComponentProvideOptions, {
+    }, true, {}, {}, GlobalComponents, GlobalDirectives, string, {
+    centerRef: HTMLDivElement;
+    }, HTMLDivElement, ComponentProvideOptions, {
     P: {};
     B: {};
     D: {};
@@ -4102,7 +4223,9 @@ export declare const UpGeneralDisplayCard: {
     subscribes: ProductSubscribe[];
     cardSize: GeneralDisplayCardCardSize;
     level: GeneralDisplayCardLevelConfig[];
-    }, true, {}, {}, GlobalComponents, GlobalDirectives, string, {}, HTMLDivElement, ComponentProvideOptions, {
+    }, true, {}, {}, GlobalComponents, GlobalDirectives, string, {
+    mainRef: HTMLDivElement;
+    }, HTMLDivElement, ComponentProvideOptions, {
     P: {};
     B: {};
     D: {};
@@ -4925,7 +5048,9 @@ export declare const UpGeneralIntCircular: {
     displayUnit: string;
     wheelLoop: boolean;
     dialogSubtitle: string;
-    }, true, {}, {}, GlobalComponents, GlobalDirectives, string, {}, HTMLDivElement, ComponentProvideOptions, {
+    }, true, {}, {}, GlobalComponents, GlobalDirectives, string, {
+    textRef: HTMLDivElement;
+    }, HTMLDivElement, ComponentProvideOptions, {
     P: {};
     B: {};
     D: {};
@@ -5217,7 +5342,10 @@ export declare const UpGeneralScreen: {
     };
     }>> & Readonly<{}>, {}, {}, {}, {}, ComponentOptionsMixin, ComponentOptionsMixin, {}, PublicProps, {
     filterElementItemConfigs: GeneralScreenFilterElementItemConfig[];
-    }, true, {}, {}, GlobalComponents, GlobalDirectives, string, {}, any, ComponentProvideOptions, {
+    }, true, {}, {}, GlobalComponents, GlobalDirectives, string, {
+    detailHeaderLeftRef: HTMLDivElement;
+    tutorialHeaderLeftRef: HTMLDivElement;
+    }, any, ComponentProvideOptions, {
     P: {};
     B: {};
     D: {};
@@ -5326,7 +5454,9 @@ export declare const UpGeneralTimeSwitch: {
     readonly icon: string[];
     readonly subscribesSecond: ProductSubscribe[];
     readonly wheelUnit: GeneralTimeSwitchWheelUnit;
-    }, true, {}, {}, GlobalComponents, GlobalDirectives, string, {}, HTMLDivElement, ComponentProvideOptions, {
+    }, true, {}, {}, GlobalComponents, GlobalDirectives, string, {
+    textRef: HTMLDivElement;
+    }, HTMLDivElement, ComponentProvideOptions, {
     P: {};
     B: {};
     D: {};
@@ -5815,8 +5945,8 @@ zIndex: number;
 placeholder: string;
 inputmode: NumericInputFieldInputMode;
 step: number;
-initialValue: number;
 invalidText: string;
+initialValue: number;
 integerOnly: boolean;
 }, {}, {}, {}, string, ComponentProvideOptions, true, {}, any>;
 
@@ -6303,7 +6433,7 @@ export declare const UpStatisticChart: {
     showLastValidValue: boolean;
     }, true, {}, {}, GlobalComponents, GlobalDirectives, string, {
     chartEl: HTMLDivElement;
-    }, HTMLDivElement, ComponentProvideOptions, {
+    }, any, ComponentProvideOptions, {
     P: {};
     B: {};
     D: {};
@@ -6517,8 +6647,11 @@ export declare const UpStatusBar: {
     showMiddle: boolean;
     showMiddleWhenOff: boolean;
     middleAsTimeFormat: boolean;
-    middleTimeUnit: StatusBarMiddleTimeUnit;
-    }, true, {}, {}, GlobalComponents, GlobalDirectives, string, {}, HTMLDivElement, ComponentProvideOptions, {
+    middleTimeUnit: DurationTimeUnit;
+    }, true, {}, {}, GlobalComponents, GlobalDirectives, string, {
+    middleRef: HTMLDivElement;
+    middlePrimaryRef: HTMLDivElement;
+    }, HTMLDivElement, ComponentProvideOptions, {
     P: {};
     B: {};
     D: {};
@@ -6601,7 +6734,7 @@ export declare const UpStatusBar: {
     showMiddle: boolean;
     showMiddleWhenOff: boolean;
     middleAsTimeFormat: boolean;
-    middleTimeUnit: StatusBarMiddleTimeUnit;
+    middleTimeUnit: DurationTimeUnit;
     }>;
     __isFragment?: never;
     __isTeleport?: never;
@@ -6682,7 +6815,7 @@ subscribesCenter: ProductSubscribe[];
 showMiddle: boolean;
 showMiddleWhenOff: boolean;
 middleAsTimeFormat: boolean;
-middleTimeUnit: StatusBarMiddleTimeUnit;
+middleTimeUnit: DurationTimeUnit;
 }, {}, string, {}, GlobalComponents, GlobalDirectives, string, ComponentProvideOptions> & VNodeProps & AllowedComponentProps & ComponentCustomProps & (new () => {
     $slots: {
         icon?(_: {}): any;
@@ -6866,7 +6999,7 @@ export declare const UpSubpageDisplayItem: {
     subscribes: ProductSubscribe[];
     displayUnit: string;
     asTimeFormat: boolean;
-    timeUnit: SubpageDisplayItemTimeUnit;
+    timeUnit: DurationTimeUnit;
     }, true, {}, {}, GlobalComponents, GlobalDirectives, string, {}, HTMLDivElement, ComponentProvideOptions, {
     P: {};
     B: {};
@@ -6895,7 +7028,7 @@ export declare const UpSubpageDisplayItem: {
     subscribes: ProductSubscribe[];
     displayUnit: string;
     asTimeFormat: boolean;
-    timeUnit: SubpageDisplayItemTimeUnit;
+    timeUnit: DurationTimeUnit;
     }>;
     __isFragment?: never;
     __isTeleport?: never;
@@ -6921,7 +7054,7 @@ default: string;
 subscribes: ProductSubscribe[];
 displayUnit: string;
 asTimeFormat: boolean;
-timeUnit: SubpageDisplayItemTimeUnit;
+timeUnit: DurationTimeUnit;
 }, {}, string, {}, GlobalComponents, GlobalDirectives, string, ComponentProvideOptions> & VNodeProps & AllowedComponentProps & ComponentCustomProps & Plugin_2;
 
 export declare const UpSubpageEnumItem: {
@@ -7008,6 +7141,7 @@ export declare const UpSubPageGroup: {
     readonly leftIcon: string[];
     readonly defTitle: WheelZoneTextEntry;
     }, true, {}, {}, GlobalComponents, GlobalDirectives, string, {
+    titleWrapRef: HTMLDivElement;
     dropzoneRef: HTMLDivElement;
     }, HTMLDivElement, ComponentProvideOptions, {
     P: {};
@@ -7305,7 +7439,10 @@ export declare const UpTableLampMorning: {
     }, PublicProps, {
     title: string;
     cardSize: TableLampMorningCardSize;
-    }, true, {}, {}, GlobalComponents, GlobalDirectives, string, {}, HTMLDivElement, ComponentProvideOptions, {
+    }, true, {}, {}, GlobalComponents, GlobalDirectives, string, {
+    contentRef: HTMLDivElement;
+    detailHeaderLeftRef: HTMLDivElement;
+    }, HTMLDivElement, ComponentProvideOptions, {
     P: {};
     B: {};
     D: {};
@@ -7375,7 +7512,10 @@ export declare const UpTableLampNightWake: {
     cardSize: TableLampNightWakeCardSize;
     showDetailHint: boolean;
     detailHint: string;
-    }, true, {}, {}, GlobalComponents, GlobalDirectives, string, {}, HTMLDivElement, ComponentProvideOptions, {
+    }, true, {}, {}, GlobalComponents, GlobalDirectives, string, {
+    contentRef: HTMLDivElement;
+    detailHeaderLeftRef: HTMLDivElement;
+    }, HTMLDivElement, ComponentProvideOptions, {
     P: {};
     B: {};
     D: {};
@@ -7455,7 +7595,10 @@ export declare const UpTableLampSleepy: {
     }, PublicProps, {
     title: string;
     cardSize: TableLampSleepyCardSize;
-    }, true, {}, {}, GlobalComponents, GlobalDirectives, string, {}, HTMLDivElement, ComponentProvideOptions, {
+    }, true, {}, {}, GlobalComponents, GlobalDirectives, string, {
+    contentRef: HTMLDivElement;
+    detailHeaderLeftRef: HTMLDivElement;
+    }, HTMLDivElement, ComponentProvideOptions, {
     P: {};
     B: {};
     D: {};
@@ -7498,6 +7641,38 @@ title: string;
 cardSize: TableLampSleepyCardSize;
 }, {}, string, {}, GlobalComponents, GlobalDirectives, string, ComponentProvideOptions> & VNodeProps & AllowedComponentProps & ComponentCustomProps & Plugin_2;
 
+export declare const UpText: {
+    new (...args: any[]): CreateComponentPublicInstanceWithMixins<Readonly<TextProps> & Readonly<{}>, {}, {}, {}, {}, ComponentOptionsMixin, ComponentOptionsMixin, {}, PublicProps, {
+    color: string;
+    content: string;
+    textAlign: TextTextAlign;
+    darkColor: string;
+    showBackground: boolean;
+    }, false, {}, {}, GlobalComponents, GlobalDirectives, string, {}, any, ComponentProvideOptions, {
+    P: {};
+    B: {};
+    D: {};
+    C: {};
+    M: {};
+    Defaults: {};
+    }, Readonly<TextProps> & Readonly<{}>, {}, {}, {}, {}, {
+    color: string;
+    content: string;
+    textAlign: TextTextAlign;
+    darkColor: string;
+    showBackground: boolean;
+    }>;
+    __isFragment?: never;
+    __isTeleport?: never;
+    __isSuspense?: never;
+} & ComponentOptionsBase<Readonly<TextProps> & Readonly<{}>, {}, {}, {}, {}, ComponentOptionsMixin, ComponentOptionsMixin, {}, string, {
+color: string;
+content: string;
+textAlign: TextTextAlign;
+darkColor: string;
+showBackground: boolean;
+}, {}, string, {}, GlobalComponents, GlobalDirectives, string, ComponentProvideOptions> & VNodeProps & AllowedComponentProps & ComponentCustomProps & Plugin_2;
+
 export declare const UpTimer: {
     new (...args: any[]): CreateComponentPublicInstanceWithMixins<Readonly<ExtractPropTypes<    {
     cardSize: {
@@ -7965,6 +8140,12 @@ export declare const useGlobalI18n: () => {
     resolveTextByKey: (key: string, fallback?: string) => string;
 };
 
+/**
+ * 是否为大屏：视口宽度 ≥ {@link UP_LARGE_SCREEN_MIN_WIDTH}。
+ * 供 UpCards 及后续需适配大屏的组件统一使用。
+ */
+export declare function useLargeScreen(): Ref<boolean>;
+
 /**
  * Hook to access i18n translations for a specific component.
  * Usage: const { t } = useLocale('enum-droplist-card')