@ailife-dev-vue/uiplus-dev 0.0.1 → 0.0.2

package/dist/index.d.ts

@@ -259,11 +259,18 @@ export declare interface Characteristic {
     max?: string;
     step?: number;
     unit?: string;
+    /** 为 1 时按 min/max（及可选 divisor）换算为百分比展示 */
+    percent?: number;
+    /** 百分比换算时除数；真值才对 min/max 做除法 */
+    divisor?: string | number;
     method?: string;
     permission?: string;
     report?: number;
 }
 
+/** 展示值就近钳到数值区间（不写 state） */
+export declare const clampDisplayToEnableRange: (raw: number, enable: EnableConstraint | null | undefined) => number;
+
 /** 与 StatusBar 一致：`minute`→00:00，`second`→00:00:00；作用于左下 int/float */
 export declare type CommonBannerNewMiddleTimeUnit = DurationTimeUnit;
 
@@ -399,6 +406,18 @@ export declare type CommonInfoViewItem = {
     router?: PageRouterTarget;
 };
 
+export declare type ComponentRuleSupportEntry = {
+    component: string;
+    supported: boolean;
+    ruleAnchors: RuleAnchor[];
+    effectScope: 'whole' | 'partial';
+    effectTarget?: string;
+    ignoresSecondaryFeature?: boolean;
+    notes?: string;
+    rules: Record<RuleTypeFlag, boolean>;
+    enableBehavior: RuleEnableBehavior;
+};
+
 declare const _default: {
     install: (app: App) => void;
 };
@@ -455,11 +474,27 @@ export declare interface DeviceInfoBase {
 /** 时间展示枚举：`minute`→00:00，`second`→00:00:00（仅做数值换算，不约定上报单位） */
 export declare type DurationTimeUnit = 'minute' | 'second';
 
+export declare const emptyRuleUiSnapshot: () => RuleUiSnapshot;
+
+/** enableRule 解析后的 UI 约束（不写回 state） */
+export declare type EnableConstraint = {
+    kind: 'enumWhitelist';
+    values: Array<string | number>;
+} | {
+    kind: 'numberRange';
+    min: number;
+    max: number;
+} | {
+    kind: 'boolGate';
+    allowed: Array<string | number | boolean>;
+};
+
 /**
  * 设备产品档案模型与规则判定工具：
  * - 定义 profile/services/characteristics/state 的核心类型；
  * - 提供按 (sid,cid) 读取特征与状态值的方法；
- * - 提供规则命中判断（disable/hide/readOnly 等）的通用计算函数。
+ * - 按规格评估 hide/disable/readOnly/enable（and>or、作用域、last-win）。
+ * 需求：docs/sdd/specs/rule-response-logic-spec.md
  */
 export declare interface EnumItem {
     descEn: string;
@@ -980,6 +1015,34 @@ export declare const enUS: {
     };
 };
 
+/**
+ * 评估 dependGroup.expressList。
+ * 注意：宿主 profile **无** `dependGroup.operator`（历史误抄），块间连接词取各 express 首条 characteristic 的 operator。
+ */
+export declare const evaluateDependGroup: (state: ProductState, dependGroup: ProductRuleItem["dependGroup"] | undefined) => boolean;
+
+/**
+ * 中缀 and/or 求值（**and 优先于 or**，非左折叠）。
+ * `terms[i].op`：连接 `terms[i-1]` 与 `terms[i]`（i≥1）；等价于先算 and 段再 or。
+ */
+export declare const evaluateInfixAndOr: (terms: Array<{
+    matched: boolean;
+    op: "and" | "or";
+}>) => boolean;
+
+/** 业务【D|R|H】对多个锚点分别评估后 OR 合并；用于 TimeSwitch 双锚点、Timer 卡片双 cid 等 */
+export declare const evaluateRuleFlagsOrForAnchors: (profile: Pick<ProductProfile, "rules" | "services">, state: ProductState, anchors: Array<{
+    sid: string;
+    cid: string;
+}>) => Pick<RuleUiSnapshot, "hidden" | "disabled" | "readOnly">;
+
+/**
+ * 按组件锚点 `(sid,cid)` 评估完整规则快照（实例认领自身属性时调用）。
+ * - 同类型按 `rules[]` 顺序 **last-win**（仅条件成立且作用域命中者参与）
+ * - hide / disable / readOnly / enable **独立**，互不覆盖
+ */
+export declare const evaluateRulesForAnchor: (profile: Pick<ProductProfile, "rules" | "services">, state: ProductState, sid: string, cid: string) => RuleUiSnapshot;
+
 export declare type FirmwareUpdatesCardSize = 'full' | 'half';
 
 export declare type FirmwareUpdatesEmits = {
@@ -1205,6 +1268,8 @@ export declare type GeneralEnumTileDisplayItem = {
     label: string;
     isPlaceholder?: boolean;
     isMore?: boolean;
+    /** enableRule 白名单外：保留展示但不可点（optionReadonly） */
+    enableReadonly?: boolean;
 };
 
 export declare type GeneralEnumTileOptionConfig = {
@@ -1612,6 +1677,20 @@ export declare type GeneralWheelSubscribeData = {
     showSector?: boolean;
 } & Record<WheelZoneKey, WheelZoneConfig>;
 
+/** 按导出组件名（如 UpGeneralEnumTile）查询支持条目；未登记视为不支持 */
+export declare const getComponentRuleSupport: (componentName: string) => ComponentRuleSupportEntry | null;
+
+/**
+ * 业务【E】enable 约束下是否仍有可用取值（Timer timerServices 入口守卫等）。
+ * 无 enable 视为可用；boolGate 看 allowed 非空；enum/int 看裁剪后是否仍有交集。
+ */
+export declare const hasUsableValueUnderEnableConstraint: (enable: EnableConstraint | null | undefined, opts: {
+    characteristicType: string;
+    enumValues?: Array<string | number>;
+    intMin?: number;
+    intMax?: number;
+}) => boolean;
+
 export declare interface HilinkDevHistoryParams {
     devId: string;
     pageNo?: string;
@@ -1646,6 +1725,27 @@ export declare type HilinkSetDeviceInfoWithoutCallbackFn = (deviceId: string, pa
 /** 与宿主约定：`setTitleVisible(visible, callbackName)`，`true` 显示原生标题栏，`false` 隐藏。 */
 export declare type HilinkSetTitleVisibleFn = (visible: boolean, callbackName: string) => void;
 
+/**
+ * boolGate：当前值是否落在 enable 允许集合内。
+ * 未命中时组件应局部只读（禁止切换），并保持当前视觉态（勿走 disable 强制关）。
+ */
+export declare const isBoolValueEnabledByConstraint: (value: unknown, enable: EnableConstraint | null | undefined) => boolean;
+
+/** 组件是否消费任一规则类型 */
+export declare const isComponentRuleSupported: (componentName: string) => boolean;
+
+/** 组件是否支持指定规则类型 */
+export declare const isComponentRuleTypeSupported: (componentName: string, ruleType: RuleTypeFlag) => boolean;
+
+/** 枚举值是否在 enable 白名单内；无 enable 或非白名单约束时视为可用 */
+export declare const isEnumValueEnabledByConstraint: (enumVal: string | number, enable: EnableConstraint | null | undefined) => boolean;
+
+/**
+ * 判断指定 (sid,cid) 的规则是否生效（兼容旧 API）。
+ * 内部走 evaluateRulesForAnchor；enableRule 有约束即视为 active。
+ */
+export declare const isRuleActive: (profile: ProductProfile, state: ProductState, sid: string, cid: string, ruleName: string) => boolean;
+
 /** 与 `sendHilinkDeviceControl` 约定一致 */
 export declare type LampCCTCommandPayload = HilinkDeviceControlPayload;
 
@@ -1689,6 +1789,9 @@ export declare interface Language {
  */
 export declare const localeContextKey: InjectionKey<Ref<Language>>;
 
+/** 业务【D|R|H】多锚点按 OR 合并（任一命中即真）；【E】不合并，由调用方按锚点单独取 */
+export declare const mergeRuleFlagsOr: (...snapshots: RuleUiSnapshot[]) => Pick<RuleUiSnapshot, "hidden" | "disabled" | "readOnly">;
+
 export declare type NumericInputFieldEmits = {
     (e: 'update:modelValue', value: string): void;
     (e: 'input'): void;
@@ -1859,30 +1962,50 @@ export declare interface ProductProfile {
     services: Service[];
 }
 
-declare interface ProductRule {
+export declare interface ProductRule {
     id: string;
     name?: string;
     rules?: ProductRuleItem[];
 }
 
+/**
+ * 条件条目。
+ * - `operator`：与**前一词项**的连接词（and/or），首项不参与连接
+ * - `order`：仅定位中缀表达式中的左右位置，不表示布尔优先级
+ */
 declare interface ProductRuleCharacteristic {
     characteristic: string;
-    symbol: string;
-    value: unknown;
+    symbol?: string;
+    value?: unknown;
+    operator?: 'and' | 'or' | string;
+    characterType?: string;
+    order?: number | string;
 }
 
 declare interface ProductRuleDepend {
     dependId: string;
-    characteristicList: ProductRuleCharacteristic[];
+    characteristicList?: ProductRuleCharacteristic[];
 }
 
-declare interface ProductRuleItem {
+export declare interface ProductRuleItem {
     name: string;
     dependGroup?: {
         expressList?: ProductRuleDepend[];
+        /** 历史误抄字段：忽略，不参与计算 */
+        operator?: string;
+    };
+    resultGroup?: {
+        expressList?: ProductRuleResultExpress[];
     };
 }
 
+declare interface ProductRuleResultExpress {
+    characteristic?: string;
+    characterType?: string;
+    symbol?: string;
+    value?: unknown;
+}
+
 export declare type ProductState = Record<string, any>;
 
 declare interface ProductSubscribe {
@@ -1905,6 +2028,56 @@ export declare type ResolvedSecondaryItem = {
     unit: string;
 };
 
+export declare type RuleAnchor = RuleAnchorProp | RuleAnchorFixed | RuleAnchorResolved;
+
+declare type RuleAnchorFixed = {
+    source: 'fixed';
+    sid: string;
+    cid: string;
+};
+
+declare type RuleAnchorProp = {
+    source: 'prop';
+    prop: string;
+    index?: number;
+};
+
+declare type RuleAnchorResolved = {
+    source: 'resolved';
+    candidates: Array<{
+        sid: string;
+        cid: string;
+    }>;
+    notes?: string;
+};
+
+/** enableRule 命中后的选项/范围表现编码（与 JSON enableBehaviorCodes 一致） */
+export declare type RuleEnableBehavior = 'none' | 'optionReadonly' | 'optionHide' | 'segmentHide' | 'rangeClampNearest' | 'rangeClampNearestDisablePresets' | 'boolGate' | 'timerServiceOptionHide';
+
+export declare type RuleResponseSupportTable = {
+    version: number;
+    description: string;
+    ruleTypes: RuleTypeFlag[];
+    enableBehaviorCodes: Record<string, string>;
+    components: ComponentRuleSupportEntry[];
+    unsupportedPolicy: string;
+};
+
+/** 组件规则支持登记表（只读） */
+export declare const ruleResponseSupportTable: RuleResponseSupportTable;
+
+export declare type RuleTypeFlag = 'hideRule' | 'disableRule' | 'readOnlyRule' | 'enableRule';
+
+export declare type RuleTypeName = 'hideRule' | 'disableRule' | 'readOnlyRule' | 'enableRule';
+
+/** 锚点上四类独立规则快照 */
+export declare interface RuleUiSnapshot {
+    hidden: boolean;
+    disabled: boolean;
+    readOnly: boolean;
+    enable: EnableConstraint | null;
+}
+
 export declare type SecondaryZone = 'slider' | 'list' | 'schedule';
 
 export declare interface Service {
@@ -2455,6 +2628,16 @@ declare interface TimerFunctionOption {
     intStep?: number;
     /** `characteristicType=int` 时展示在数值后的单位；优先 `timerServices[].unit`，否则特征 `unit`，再否则 `%` */
     intUnit?: string;
+    /** 规则：hide 命中（通常已从选择列表过滤） */
+    ruleHidden?: boolean;
+    /** 规则：disable → 列表保留置灰不可选 */
+    ruleDisabled?: boolean;
+    /** 规则：readOnly → 同常规 readonly 样式，不可选 */
+    ruleReadOnly?: boolean;
+    /** 规则：enable 导致内部取值全部不可用 */
+    ruleEnableBlocked?: boolean;
+    /** 当前是否可选（未 hide/disable/readOnly/enable 挡掉） */
+    isSelectable?: boolean;
 }
 export { TimerFunctionOption }
 export { TimerFunctionOption as TimerNewFunctionOption }
@@ -3517,7 +3700,10 @@ export declare const UpCommonBannerNew: {
     centerImageUrl: string;
     logo: string;
     showBottomWhenOff: boolean;
-    }, true, {}, {}, GlobalComponents, GlobalDirectives, string, {}, HTMLDivElement, ComponentProvideOptions, {
+    }, true, {}, {}, GlobalComponents, GlobalDirectives, string, {
+    topLeftRef: HTMLDivElement;
+    bottomLeftRef: HTMLDivElement;
+    }, HTMLDivElement, ComponentProvideOptions, {
     P: {};
     B: {};
     D: {};