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

package/dist/index.d.ts

@@ -1947,6 +1947,21 @@ export declare type StatisticChartDataSource = 'avg' | 'sum' | 'maxMin';
 /** 统计维度模式：最近 N 天 / 天周月年（互斥） */
 export declare type StatisticChartDimensionMode = 'recent' | 'calendar';
 
+/**
+ * 业务：解析画布 i18n 对象 `{ key, zh_CN, en_US, type }`（兼容 zh/en）。
+ * 优先 key→文案表，否则按当前语言取双语字段。
+ */
+export declare type StatisticChartI18nText = {
+    key?: string;
+    zh?: string;
+    en?: string;
+    zh_CN?: string;
+    en_US?: string;
+    'zh-CN'?: string;
+    'en-US'?: string;
+    type?: string;
+};
+
 export declare type StatisticChartProps = ExtractPropTypes<typeof statisticChartProps>;
 
 declare const statisticChartProps: {
@@ -1967,10 +1982,16 @@ declare const statisticChartProps: {
         type: PropType<StatisticChartDataSource>;
         default: string;
     };
-    referenceRange: {
-        type: PropType<StatisticChartReferenceRange | null>;
+    /** 参考范围标题；画布 i18n 对象 */
+    referenceRangesTitle: {
+        type: PropType<StatisticChartI18nText | null>;
         default: null;
     };
+    /** 参考范围分段列表；空则不展示参考范围区 */
+    referenceRanges: {
+        type: PropType<StatisticChartReferenceRangeItem[]>;
+        default: () => never[];
+    };
     statsFollowTab: {
         type: BooleanConstructor;
         default: boolean;
@@ -1999,19 +2020,22 @@ declare const statisticChartProps: {
 
 export declare type StatisticChartRecentTab = 'last7Days' | 'last30Days';
 
-export declare interface StatisticChartReferenceRange {
-    /** 区域标题；L2 i18n key */
-    title: string;
-    ranges: StatisticChartReferenceRangeItem[];
-}
-
+/** 参考范围分段：画布 i18n 对象 + 浅/暗色（字段名对齐宿主 schema） */
 export declare interface StatisticChartReferenceRangeItem {
-    /** 段描述；L2 i18n key */
-    description: string;
-    /** CSS 颜色 */
+    /**
+     * 色条上方段名（如「正常」）。
+     * 宿主 schema 字段名为 `range`（与示例 JSON 一致）。
+     */
+    range: StatisticChartI18nText;
+    /**
+     * 色条下方范围文案（如「15~20」）。
+     * 宿主 schema 字段名为 `description`。
+     */
+    description: StatisticChartI18nText;
+    /** 浅色主题色条颜色 */
     color: string;
-    /** 范围文案；L2 i18n key */
-    range: string;
+    /** 暗黑主题色条颜色；缺省回退 color */
+    darkColor?: string;
 }
 
 /** 数据统计展示指标 */
@@ -2353,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;
@@ -2459,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: {
@@ -2492,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: {};
@@ -3762,6 +3815,7 @@ export declare const UpEnumStatus: {
     contentRef: HTMLDivElement;
     titleRef: HTMLDivElement;
     statusRef: HTMLDivElement;
+    detailHeaderLeftRef: HTMLDivElement;
     }, HTMLDivElement, ComponentProvideOptions, {
     P: {};
     B: {};
@@ -3888,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: {};
@@ -4078,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: {};
@@ -4901,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: {};
@@ -5193,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: {};
@@ -5302,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: {};
@@ -6232,10 +6297,14 @@ export declare const UpStatisticChart: {
     type: PropType<StatisticChartDataSource>;
     default: string;
     };
-    referenceRange: {
-    type: PropType<StatisticChartReferenceRange | null>;
+    referenceRangesTitle: {
+    type: PropType<StatisticChartI18nText | null>;
     default: null;
     };
+    referenceRanges: {
+    type: PropType<StatisticChartReferenceRangeItem[]>;
+    default: () => never[];
+    };
     statsFollowTab: {
     type: BooleanConstructor;
     default: boolean;
@@ -6265,7 +6334,8 @@ export declare const UpStatisticChart: {
     unit: string;
     chartType: StatisticChartType;
     chartDataSource: StatisticChartDataSource;
-    referenceRange: StatisticChartReferenceRange | null;
+    referenceRangesTitle: StatisticChartI18nText | null;
+    referenceRanges: StatisticChartReferenceRangeItem[];
     statsFollowTab: boolean;
     statMetrics: StatisticChartStatMetric[];
     dimensionMode: StatisticChartDimensionMode;
@@ -6274,7 +6344,7 @@ export declare const UpStatisticChart: {
     showLastValidValue: boolean;
     }, true, {}, {}, GlobalComponents, GlobalDirectives, string, {
     chartEl: HTMLDivElement;
-    }, HTMLDivElement, ComponentProvideOptions, {
+    }, any, ComponentProvideOptions, {
     P: {};
     B: {};
     D: {};
@@ -6298,10 +6368,14 @@ export declare const UpStatisticChart: {
     type: PropType<StatisticChartDataSource>;
     default: string;
     };
-    referenceRange: {
-    type: PropType<StatisticChartReferenceRange | null>;
+    referenceRangesTitle: {
+    type: PropType<StatisticChartI18nText | null>;
     default: null;
     };
+    referenceRanges: {
+    type: PropType<StatisticChartReferenceRangeItem[]>;
+    default: () => never[];
+    };
     statsFollowTab: {
     type: BooleanConstructor;
     default: boolean;
@@ -6331,7 +6405,8 @@ export declare const UpStatisticChart: {
     unit: string;
     chartType: StatisticChartType;
     chartDataSource: StatisticChartDataSource;
-    referenceRange: StatisticChartReferenceRange | null;
+    referenceRangesTitle: StatisticChartI18nText | null;
+    referenceRanges: StatisticChartReferenceRangeItem[];
     statsFollowTab: boolean;
     statMetrics: StatisticChartStatMetric[];
     dimensionMode: StatisticChartDimensionMode;
@@ -6359,10 +6434,14 @@ chartDataSource: {
 type: PropType<StatisticChartDataSource>;
 default: string;
 };
-referenceRange: {
-type: PropType<StatisticChartReferenceRange | null>;
+referenceRangesTitle: {
+type: PropType<StatisticChartI18nText | null>;
 default: null;
 };
+referenceRanges: {
+type: PropType<StatisticChartReferenceRangeItem[]>;
+default: () => never[];
+};
 statsFollowTab: {
 type: BooleanConstructor;
 default: boolean;
@@ -6392,7 +6471,8 @@ subscribes: ProductSubscribe[];
 unit: string;
 chartType: StatisticChartType;
 chartDataSource: StatisticChartDataSource;
-referenceRange: StatisticChartReferenceRange | null;
+referenceRangesTitle: StatisticChartI18nText | null;
+referenceRanges: StatisticChartReferenceRangeItem[];
 statsFollowTab: boolean;
 statMetrics: StatisticChartStatMetric[];
 dimensionMode: StatisticChartDimensionMode;
@@ -6479,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: {};
@@ -6969,6 +7052,7 @@ export declare const UpSubPageGroup: {
     readonly leftIcon: string[];
     readonly defTitle: WheelZoneTextEntry;
     }, true, {}, {}, GlobalComponents, GlobalDirectives, string, {
+    titleWrapRef: HTMLDivElement;
     dropzoneRef: HTMLDivElement;
     }, HTMLDivElement, ComponentProvideOptions, {
     P: {};
@@ -7266,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: {};
@@ -7336,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: {};
@@ -7416,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: {};
@@ -7459,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: {
@@ -7926,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')