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

package/dist/index.d.ts

@@ -2377,6 +2377,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 +2503,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: {
@@ -2516,7 +2543,9 @@ export declare const UpActionStatusbar: {
     subscribesAction: ProductSubscribe[];
     subscribesStatus: ProductSubscribe[];
     statusConfigs: ActionStatusbarStatusConfig[];
-    }, true, {}, {}, GlobalComponents, GlobalDirectives, string, {}, HTMLDivElement, ComponentProvideOptions, {
+    }, true, {}, {}, GlobalComponents, GlobalDirectives, string, {
+    middleRef: HTMLDivElement;
+    }, HTMLDivElement, ComponentProvideOptions, {
     P: {};
     B: {};
     D: {};
@@ -3786,6 +3815,7 @@ export declare const UpEnumStatus: {
     contentRef: HTMLDivElement;
     titleRef: HTMLDivElement;
     statusRef: HTMLDivElement;
+    detailHeaderLeftRef: HTMLDivElement;
     }, HTMLDivElement, ComponentProvideOptions, {
     P: {};
     B: {};
@@ -3912,7 +3942,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 +4134,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 +4959,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 +5253,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 +5365,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: {};
@@ -6303,7 +6344,7 @@ export declare const UpStatisticChart: {
     showLastValidValue: boolean;
     }, true, {}, {}, GlobalComponents, GlobalDirectives, string, {
     chartEl: HTMLDivElement;
-    }, HTMLDivElement, ComponentProvideOptions, {
+    }, any, ComponentProvideOptions, {
     P: {};
     B: {};
     D: {};
@@ -6518,7 +6559,10 @@ export declare const UpStatusBar: {
     showMiddleWhenOff: boolean;
     middleAsTimeFormat: boolean;
     middleTimeUnit: StatusBarMiddleTimeUnit;
-    }, true, {}, {}, GlobalComponents, GlobalDirectives, string, {}, HTMLDivElement, ComponentProvideOptions, {
+    }, true, {}, {}, GlobalComponents, GlobalDirectives, string, {
+    middleRef: HTMLDivElement;
+    middlePrimaryRef: HTMLDivElement;
+    }, HTMLDivElement, ComponentProvideOptions, {
     P: {};
     B: {};
     D: {};
@@ -7008,6 +7052,7 @@ export declare const UpSubPageGroup: {
     readonly leftIcon: string[];
     readonly defTitle: WheelZoneTextEntry;
     }, true, {}, {}, GlobalComponents, GlobalDirectives, string, {
+    titleWrapRef: HTMLDivElement;
     dropzoneRef: HTMLDivElement;
     }, HTMLDivElement, ComponentProvideOptions, {
     P: {};
@@ -7305,7 +7350,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 +7423,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 +7506,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 +7552,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 +8051,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')