@flexem/fc-gui 3.0.0-alpha.18 → 3.0.0-alpha.181

package/remote/communication/variable/remote-variable-communicator.d.ts

@@ -9,6 +9,7 @@ export declare class RemoteVariableCommunicator implements VariableCommunicator
     private appIdVariablesMap;
     private connectedSubscription;
     private variableValuesChangedSubscription;
+    private virtualDeviceStatesChangedSubscription;
     private variablesToBeOpened;
     private variablesToBeClosed;
     private variableValueCache;
@@ -17,14 +18,43 @@ export declare class RemoteVariableCommunicator implements VariableCommunicator
     private variableStateCache;
     private variableStatesToBeOpened;
     private variableStatesToBeClosed;
+    private alarmObservers;
+    private alarmChangedSubscription;
+    private systemVariableHandlers;
+    private offlineValueCache;
     constructor(remoteVariableProtocol: RemoteVariableProtocol, logger: LoggerService);
+    private doAlarmChanged;
     private doVariableValuesChanged;
+    private doVirtualDeviceStatesChanged;
     private doVariableStatesChanged;
+    /**
+     * 预填充离线变量值缓存，由 GuiContext 在组态加载时一次性调用。
+     * 若状态推送早于接口返回，变量已在 Offline 状态，则直接推送；
+     * 否则缓存等待状态事件到来时推送。
+     */
+    setOfflineValueCache(variableName: string, value: any): void;
     subscribeVariableStates(variableNames: string[]): Observable<VariableState[]>;
     subscribeVariableState(variableName: string): Observable<VariableState>;
+    requestVirtualDeviceState(): Observable<void>;
     openVariables(variableNames: string[], appId?: string): Observable<VariableValue[]>;
     openVariable(variableName: string, appId?: string): Observable<VariableValue>;
     write(variableName: string, value: any): Observable<VariableValue>;
     writeWordByBit(variableName: string, index: number, value: number): Observable<VariableValue>;
+    subscribeUserDeviceAlarms(appId?: string): Observable<any[]>;
+    subscribeUserOneDeviceAlarms(appId?: string): Observable<any>;
+    /**
+     * 注册系统变量处理器
+     * @param variableName 变量名（如"当前语种ID"）
+     * @param getValue 获取值的函数
+     * @param setValue 设置值的函数
+     */
+    registerSystemVariableHandler(variableName: string, getValue: () => Promise<any>, setValue: (value: any) => Promise<void>): void;
+    /**
+     * 通知系统变量值变化
+     * 用于在系统变量值改变时通知所有订阅者
+     * @param variableName 变量名
+     * @param value 新值
+     */
+    notifySystemVariableChange(variableName: string, value: any): void;
     dispose(): void;
 }

package/remote/communication/variable/remote-variable-communicator.js

@@ -1,7 +1,9 @@
 import { each, remove, uniq } from 'lodash';
 import { Observable } from 'rxjs';
 import { map } from 'rxjs/operators';
+import { VariableStateEnum } from '../../../communication';
 import { StringifyingMap } from '../../../core';
+import { GuiFeatureConfig } from '../../../config';
 export class RemoteVariableCommunicator {
     constructor(remoteVariableProtocol, logger) {
         this.remoteVariableProtocol = remoteVariableProtocol;
@@ -10,6 +12,11 @@ export class RemoteVariableCommunicator {
         this.appIdVariablesMap = new Map();
         this.variableStateObservers = new Map();
         this.variableStateCache = new Map();
+        this.alarmObservers = [];
+        // 系统变量处理器
+        this.systemVariableHandlers = new Map();
+        // 预加载的离线变量最新值缓存（组态加载时一次性填充，推送后即删除）
+        this.offlineValueCache = new Map();
         this.variableValueCache = new StringifyingMap(k => JSON.stringify(k));
         this.connectedSubscription = this.remoteVariableProtocol.connected.subscribe(() => {
             const variableNamesToStart = [];
@@ -23,6 +30,18 @@ export class RemoteVariableCommunicator {
         });
         this.doVariableStatesChanged();
         this.doVariableValuesChanged();
+        this.doVirtualDeviceStatesChanged();
+        this.doAlarmChanged();
+    }
+    doAlarmChanged() {
+        if (this.alarmChangedSubscription !== undefined) {
+            this.alarmChangedSubscription.unsubscribe();
+        }
+        this.alarmChangedSubscription = this.remoteVariableProtocol.virtualDeviceAlarmsChanged.subscribe((alarms) => {
+            each(this.alarmObservers, ob => {
+                ob.next(alarms);
+            });
+        });
     }
     doVariableValuesChanged() {
         if (this.variableValuesChangedSubscription !== undefined) {
@@ -42,6 +61,25 @@ export class RemoteVariableCommunicator {
                 });
             });
     }
+    doVirtualDeviceStatesChanged() {
+        if (this.virtualDeviceStatesChangedSubscription !== undefined) {
+            this.virtualDeviceStatesChangedSubscription.unsubscribe();
+        }
+        this.virtualDeviceStatesChangedSubscription =
+            this.remoteVariableProtocol.virtualDeviceStatesChanged.subscribe((deviceStates) => {
+                each(deviceStates, deviceState => {
+                    const variableName = '设备状态';
+                    this.variableValueCache.set(variableName, deviceState);
+                    const data = Object.assign(Object.assign({}, deviceState), { systemName: '设备状态' });
+                    if (this.observers.has(variableName)) {
+                        each(this.observers.get(variableName), ob => {
+                            // TODO 同一个ob监听多个变量的情况，组合成数组一次推送。
+                            ob.next([data]);
+                        });
+                    }
+                });
+            });
+    }
     doVariableStatesChanged() {
         if (this.variableStatesChangedSubscription !== undefined) {
             this.variableStatesChangedSubscription.unsubscribe();
@@ -53,13 +91,69 @@ export class RemoteVariableCommunicator {
                     this.variableStateCache.set(variableName, state);
                     if (this.variableStateObservers.has(variableName)) {
                         each(this.variableStateObservers.get(variableName), ob => {
-                            // TODO 同一个ob监听多个变量的情况，组合成数组一次推送。
                             ob.next([state]);
                         });
                     }
+                    // 离线时推送最后已知值给值订阅者
+                    if (GuiFeatureConfig.isOfflineDisplayEnabled && state.state === VariableStateEnum.Offline) {
+                        let cachedValue;
+                        // 优先用最后一次收到的值（可能是在线时推送的），覆盖所有切页/重连场景
+                        if (this.variableValueCache.has(variableName)) {
+                            cachedValue = this.variableValueCache.get(variableName).value;
+                        }
+                        else if (this.offlineValueCache.has(variableName)) {
+                            // 兜底：变量从未收到过值，用预加载的离线值
+                            cachedValue = this.offlineValueCache.get(variableName);
+                        }
+                        if (cachedValue !== null && cachedValue !== undefined) {
+                            const variableValue = {
+                                variableName,
+                                value: cachedValue,
+                                state: VariableStateEnum.Offline
+                            };
+                            this.variableValueCache.set(variableName, variableValue);
+                            if (this.observers.has(variableName)) {
+                                each(this.observers.get(variableName), ob => {
+                                    ob.next([variableValue]);
+                                });
+                            }
+                        }
+                    }
                 });
             });
     }
+    /**
+     * 预填充离线变量值缓存，由 GuiContext 在组态加载时一次性调用。
+     * 若状态推送早于接口返回，变量已在 Offline 状态，则直接推送；
+     * 否则缓存等待状态事件到来时推送。
+     */
+    setOfflineValueCache(variableName, value) {
+        if (!GuiFeatureConfig.isOfflineDisplayEnabled) {
+            return;
+        }
+        if (value === null || value === undefined) {
+            return;
+        }
+        const cachedState = this.variableStateCache.get(variableName);
+        if (cachedState && cachedState.state === VariableStateEnum.Offline) {
+            // 状态已推送过，直接补推值给订阅者
+            const variableValue = {
+                variableName,
+                value,
+                state: VariableStateEnum.Offline
+            };
+            this.variableValueCache.set(variableName, variableValue);
+            if (this.observers.has(variableName)) {
+                each(this.observers.get(variableName), ob => {
+                    ob.next([variableValue]);
+                });
+            }
+        }
+        else {
+            // 状态还未推送，先缓存，等待状态事件
+            this.offlineValueCache.set(variableName, value);
+        }
+    }
     subscribeVariableStates(variableNames) {
         return new Observable(observer => {
             let variableNamesToStart = [];
@@ -115,6 +209,9 @@ export class RemoteVariableCommunicator {
     subscribeVariableState(variableName) {
         return this.subscribeVariableStates([variableName]).pipe(map(values => values[0]));
     }
+    requestVirtualDeviceState() {
+        return this.remoteVariableProtocol.requestVirtualDeviceState();
+    }
     openVariables(variableNames, appId = '') {
         return new Observable(observer => {
             let variablesToStart = [];
@@ -140,7 +237,33 @@ export class RemoteVariableCommunicator {
                     }
                 }
             });
-            variablesToStart = uniq(variablesToStart);
+            // 过滤掉系统变量，它们不需要通过SignalR订阅
+            const normalVariables = variablesToStart.filter(v => !this.systemVariableHandlers.has(v));
+            const systemVariables = variablesToStart.filter(v => this.systemVariableHandlers.has(v));
+            // 处理系统变量的初始值
+            systemVariables.forEach(variableName => {
+                const handler = this.systemVariableHandlers.get(variableName);
+                if (handler && handler.getValue) {
+                    void handler.getValue().then(value => {
+                        const variableValue = {
+                            variableName: variableName,
+                            value: value,
+                            state: 1 // Normal state
+                        };
+                        this.variableValueCache.set(variableName, variableValue);
+                        if (this.observers.has(variableName)) {
+                            each(this.observers.get(variableName), ob => {
+                                ob.next([variableValue]);
+                            });
+                        }
+                    }).catch(error => {
+                        if (this.logger) {
+                            this.logger.error(`[RemoteVariableCommunicator] Failed to get system variable "${variableName}" value:`, error);
+                        }
+                    });
+                }
+            });
+            variablesToStart = uniq(normalVariables);
             if (variablesToStart && variablesToStart.length > 0) {
                 if (!this.variablesToBeOpened) {
                     this.variablesToBeOpened = [];
@@ -185,8 +308,24 @@ export class RemoteVariableCommunicator {
     }
     write(variableName, value) {
         if (!variableName) {
-            return;
+            return new Observable(observer => {
+                observer.complete();
+            });
         }
+        // 检查是否为系统变量
+        if (this.systemVariableHandlers.has(variableName)) {
+            const handler = this.systemVariableHandlers.get(variableName);
+            // 调用系统变量的setValue处理器
+            void handler.setValue(value).catch(error => {
+                if (this.logger) {
+                    this.logger.error('[RemoteVariableCommunicator] Failed to set system variable value:', error);
+                }
+            });
+            return new Observable(__ => {
+                /* 系统变量通过自己的机制通知变化 */
+            });
+        }
+        // 普通变量通过SignalR写入
         this.remoteVariableProtocol.writeVariable(variableName, value);
         return new Observable(__ => {
             /* do nothing right now, if want value change immediately, can use this code below:
@@ -203,11 +342,62 @@ export class RemoteVariableCommunicator {
               observer.next(new VariableValue(variable, VariableStateEnum.DataNormal, value))*/
         });
     }
+    subscribeUserDeviceAlarms(appId = '') {
+        return new Observable(observer => {
+            this.alarmObservers.push(observer);
+            this.remoteVariableProtocol.subscribeVirtualDeviceAlarms(appId);
+            return () => {
+                this.remoteVariableProtocol.unsubscribeVirtualDeviceAlarms(appId);
+            };
+        });
+    }
+    subscribeUserOneDeviceAlarms(appId = '') {
+        return new Observable(observer => {
+            const subscription = this.remoteVariableProtocol.historyAlarmChanged.subscribe(value => observer.next(value), error => observer.error(error), () => observer.complete());
+            this.remoteVariableProtocol.subscribeUserOneDeviceAlarms(appId);
+            return () => {
+                subscription.unsubscribe();
+                this.remoteVariableProtocol.unsubscribeUserOneDeviceAlarms(appId);
+            };
+        });
+    }
+    /**
+     * 注册系统变量处理器
+     * @param variableName 变量名（如"当前语种ID"）
+     * @param getValue 获取值的函数
+     * @param setValue 设置值的函数
+     */
+    registerSystemVariableHandler(variableName, getValue, setValue) {
+        this.systemVariableHandlers.set(variableName, { getValue, setValue });
+    }
+    /**
+     * 通知系统变量值变化
+     * 用于在系统变量值改变时通知所有订阅者
+     * @param variableName 变量名
+     * @param value 新值
+     */
+    notifySystemVariableChange(variableName, value) {
+        const variableValue = {
+            variableName: variableName,
+            value: value,
+            state: 1 // Normal state
+        };
+        // 更新缓存
+        this.variableValueCache.set(variableName, variableValue);
+        // 通知所有订阅者
+        if (this.observers.has(variableName)) {
+            each(this.observers.get(variableName), ob => {
+                ob.next([variableValue]);
+            });
+        }
+    }
     dispose() {
         // TODO调用所有的ob.complete()。
         this.connectedSubscription.unsubscribe();
         this.variableStatesChangedSubscription.unsubscribe();
         this.variableValuesChangedSubscription.unsubscribe();
+        this.virtualDeviceStatesChangedSubscription.unsubscribe();
+        this.alarmChangedSubscription.unsubscribe();
         if (this.logger && this.logger.isDebugEnabled()) {
             this.logger.debug('[VariableCommunicator] RemoteVariableCommunicator disposed.');
         }

package/remote/communication/variable/remote-variable-communicator.metadata.json

@@ -1 +1 @@
-[{"__symbolic":"module","version":4,"metadata":{"RemoteVariableCommunicator":{"__symbolic":"class","members":{"__ctor__":[{"__symbolic":"constructor","parameters":[{"__symbolic":"reference","module":"./remote-variable-protocol","name":"RemoteVariableProtocol","line":24,"character":57},{"__symbolic":"reference","module":"../../../logger","name":"LoggerService","line":24,"character":106}]}],"doVariableValuesChanged":[{"__symbolic":"method"}],"doVariableStatesChanged":[{"__symbolic":"method"}],"subscribeVariableStates":[{"__symbolic":"method"}],"subscribeVariableState":[{"__symbolic":"method"}],"openVariables":[{"__symbolic":"method"}],"openVariable":[{"__symbolic":"method"}],"write":[{"__symbolic":"method"}],"writeWordByBit":[{"__symbolic":"method"}],"dispose":[{"__symbolic":"method"}]}}}}]
+[{"__symbolic":"module","version":4,"metadata":{"RemoteVariableCommunicator":{"__symbolic":"class","members":{"__ctor__":[{"__symbolic":"constructor","parameters":[{"__symbolic":"reference","module":"./remote-variable-protocol","name":"RemoteVariableProtocol","line":38,"character":57},{"__symbolic":"reference","module":"../../../logger","name":"LoggerService","line":38,"character":106}]}],"doAlarmChanged":[{"__symbolic":"method"}],"doVariableValuesChanged":[{"__symbolic":"method"}],"doVirtualDeviceStatesChanged":[{"__symbolic":"method"}],"doVariableStatesChanged":[{"__symbolic":"method"}],"setOfflineValueCache":[{"__symbolic":"method"}],"subscribeVariableStates":[{"__symbolic":"method"}],"subscribeVariableState":[{"__symbolic":"method"}],"requestVirtualDeviceState":[{"__symbolic":"method"}],"openVariables":[{"__symbolic":"method"}],"openVariable":[{"__symbolic":"method"}],"write":[{"__symbolic":"method"}],"writeWordByBit":[{"__symbolic":"method"}],"subscribeUserDeviceAlarms":[{"__symbolic":"method"}],"subscribeUserOneDeviceAlarms":[{"__symbolic":"method"}],"registerSystemVariableHandler":[{"__symbolic":"method"}],"notifySystemVariableChange":[{"__symbolic":"method"}],"dispose":[{"__symbolic":"method"}]}}}}]

package/remote/communication/variable/remote-variable-protocol.d.ts

@@ -4,10 +4,18 @@ export interface RemoteVariableProtocol {
     connected: Observable<void>;
     variableStatesChanged: Observable<VariableValue[]>;
     variableValuesChanged: Observable<VariableValue[]>;
+    virtualDeviceAlarmsChanged: Observable<any>;
     tryOpenVariables(variableNames: string[], appId: string): Observable<void>;
     tryStopVariables(variableNames: string[], appId: string): Observable<void>;
     writeVariable(variableName: string, value: any): Observable<void>;
     writeVariableWordByBit(variableName: string, index: number, value: number): Observable<void>;
+    requestVirtualDeviceState(): Observable<void>;
+    virtualDeviceStatesChanged: Observable<any>;
     subscribeVariableStates(variableNames: string[]): Observable<void>;
     unsubscribeVariableStates(variableNames: string[]): Observable<void>;
+    subscribeVirtualDeviceAlarms(appId: string): any;
+    unsubscribeVirtualDeviceAlarms(appId: string): any;
+    subscribeUserOneDeviceAlarms(appId: string): any;
+    unsubscribeUserOneDeviceAlarms(appId: string): any;
+    historyAlarmChanged: Observable<any>;
 }

package/service/index.d.ts

@@ -1,4 +1,8 @@
 export { WeatherService } from './weather.service';
 export { PermissionChecker } from './permission-checker';
+export { ReleasedVariableService } from './released-variable';
 export * from './operation-record';
 export * from './video';
+export * from './text-library.service';
+export * from './language.service';
+export * from './system-text-library.service';

package/service/index.js

@@ -0,0 +1 @@
+export * from './system-text-library.service';

package/service/index.metadata.json

@@ -1 +1 @@
-[{"__symbolic":"module","version":4,"metadata":{},"exports":[{"from":"./weather.service","export":["WeatherService"]},{"from":"./permission-checker","export":["PermissionChecker"]},{"from":"./operation-record"},{"from":"./video"}]}]
+[{"__symbolic":"module","version":4,"metadata":{},"exports":[{"from":"./weather.service","export":["WeatherService"]},{"from":"./permission-checker","export":["PermissionChecker"]},{"from":"./released-variable","export":["ReleasedVariableService"]},{"from":"./operation-record"},{"from":"./video"},{"from":"./text-library.service"},{"from":"./language.service"},{"from":"./system-text-library.service"}]}]

package/service/language.service.d.ts

@@ -0,0 +1,37 @@
+import { Observable } from 'rxjs';
+/**
+ * 语种 DTO 接口 - 与 Designer 中的 API 返回格式保持一致
+ */
+export interface ConfigureLanguageDto {
+    name: string;
+    displayName: string;
+    icon: string;
+    isDefault: boolean;
+    isSystem: boolean;
+}
+/**
+ * 语种服务接口
+ * 提供语种的查询能力，供 GUI 组件使用
+ */
+export interface LanguageService {
+    /**
+     * 获取所有语种
+     */
+    getLanguages(): ConfigureLanguageDto[];
+    /**
+     * 获取默认语言代码
+     */
+    getDefaultLanguage(): string;
+    /**
+     * 根据语种代码获取语种信息
+     */
+    getLanguageByCode(code: string): ConfigureLanguageDto | null;
+    /**
+     * 检查是否有缓存数据
+     */
+    hasCache(): boolean;
+    /**
+     * 缓存更新事件 (可选)
+     */
+    readonly cacheUpdated?: Observable<void>;
+}

package/service/language.service.metadata.json

@@ -0,0 +1 @@
+[{"__symbolic":"module","version":4,"metadata":{"ConfigureLanguageDto":{"__symbolic":"interface"},"LanguageService":{"__symbolic":"interface"}}}]

package/service/released-variable/index.d.ts

@@ -0,0 +1 @@
+export { ReleasedVariableService } from './released-variable.service';

package/service/released-variable/index.metadata.json

@@ -0,0 +1 @@
+[{"__symbolic":"module","version":4,"metadata":{},"exports":[{"from":"./released-variable.service","export":["ReleasedVariableService"]}]}]

package/service/released-variable/released-variable.service.d.ts

@@ -0,0 +1,4 @@
+import { Observable } from 'rxjs';
+export interface ReleasedVariableService {
+    getVariableWithValueTransform(variableName: any): Observable<any>;
+}

package/service/released-variable/released-variable.service.metadata.json

@@ -0,0 +1 @@
+[{"__symbolic":"module","version":4,"metadata":{"ReleasedVariableService":{"__symbolic":"interface"}}}]

package/service/system-text-library.service.d.ts

@@ -0,0 +1,77 @@
+import { Observable } from 'rxjs';
+/**
+ * 系统文本条目接口
+ */
+export interface SystemTextEntry {
+    key: string;
+    value: string;
+    referenceLocation: string;
+    isKeyReadOnly: boolean;
+    cultures: {
+        [key: string]: string;
+    };
+}
+/**
+ * 系统文本库缓存数据接口
+ */
+export interface SystemTextLibraryCacheData {
+    id: number;
+    name: string;
+    systemType: string;
+    data: SystemTextEntry[];
+}
+/**
+ * 系统文本库类型常量
+ */
+export declare const SYSTEM_TEXT_LIBRARY_TYPES: {
+    COMPONENT_BUILTIN: string;
+};
+/**
+ * 告警表表头 key 常量
+ */
+export declare const ALARM_TABLE_HEADER_KEYS: {
+    ALARM_NAME: string;
+    ALARM_MESSAGE: string;
+    ALARM_LEVEL: string;
+    TIME: string;
+};
+/**
+ * 时间段 key 常量（用于告警表和历史曲线下拉选择）
+ * 对应 localization 中的: lastThirtyMinutes, lastOneHour, lastEightHour, lastTwentyFourHours, lastSevenDays, lastThirtyDays, lastOneYear
+ */
+export declare const TIME_PERIOD_KEYS: {
+    LAST_THIRTY_MINUTES: string;
+    LAST_ONE_HOUR: string;
+    LAST_EIGHT_HOURS: string;
+    LAST_TWENTY_FOUR_HOURS: string;
+    LAST_SEVEN_DAYS: string;
+    LAST_THIRTY_DAYS: string;
+    LAST_ONE_YEAR: string;
+    CUSTOM: string;
+};
+/**
+ * 系统文本库服务接口
+ * 提供系统文本库的查询能力，供 GUI 组件使用
+ */
+export interface SystemTextLibraryService {
+    /**
+     * 根据 systemType 获取系统文本库
+     */
+    getSystemTextLibrary(systemType: string): SystemTextLibraryCacheData | null;
+    /**
+     * 根据 systemType 和 key 获取系统文本条目
+     */
+    getSystemTextEntry(systemType: string, entryKey: string): SystemTextEntry | null;
+    /**
+     * 根据 systemType、key 和语言获取系统文本值
+     */
+    getSystemTextValue(systemType: string, entryKey: string, culture?: string): string | null;
+    /**
+     * 检查系统文本库缓存是否存在
+     */
+    hasSystemTextLibraryCache(systemType: string): boolean;
+    /**
+     * 缓存更新事件 (可选)
+     */
+    readonly cacheUpdated?: Observable<void>;
+}

package/service/system-text-library.service.js

@@ -0,0 +1,29 @@
+/**
+ * 系统文本库类型常量
+ */
+export const SYSTEM_TEXT_LIBRARY_TYPES = {
+    COMPONENT_BUILTIN: 'ComponentBuiltIn'
+};
+/**
+ * 告警表表头 key 常量
+ */
+export const ALARM_TABLE_HEADER_KEYS = {
+    ALARM_NAME: 'AlarmTable.Header.AlarmName',
+    ALARM_MESSAGE: 'AlarmTable.Header.AlarmMessage',
+    ALARM_LEVEL: 'AlarmTable.Header.AlarmLevel',
+    TIME: 'AlarmTable.Header.Time'
+};
+/**
+ * 时间段 key 常量（用于告警表和历史曲线下拉选择）
+ * 对应 localization 中的: lastThirtyMinutes, lastOneHour, lastEightHour, lastTwentyFourHours, lastSevenDays, lastThirtyDays, lastOneYear
+ */
+export const TIME_PERIOD_KEYS = {
+    LAST_THIRTY_MINUTES: 'HistoricalCurve.TimeFilter.Last30Minutes',
+    LAST_ONE_HOUR: 'HistoricalCurve.TimeFilter.Last1Hour',
+    LAST_EIGHT_HOURS: 'HistoricalCurve.TimeFilter.Last8Hours',
+    LAST_TWENTY_FOUR_HOURS: 'HistoricalCurve.TimeFilter.Last24Hours',
+    LAST_SEVEN_DAYS: 'HistoricalCurve.TimeFilter.Last7Days',
+    LAST_THIRTY_DAYS: 'HistoricalCurve.TimeFilter.Last30Days',
+    LAST_ONE_YEAR: 'HistoricalCurve.TimeFilter.Last1Year',
+    CUSTOM: 'HistoricalCurve.TimeFilter.Custom'
+};

package/service/system-text-library.service.metadata.json

@@ -0,0 +1 @@
+[{"__symbolic":"module","version":4,"metadata":{"SystemTextEntry":{"__symbolic":"interface"},"SystemTextLibraryCacheData":{"__symbolic":"interface"},"SYSTEM_TEXT_LIBRARY_TYPES":{"COMPONENT_BUILTIN":"ComponentBuiltIn"},"ALARM_TABLE_HEADER_KEYS":{"ALARM_NAME":"AlarmTable.Header.AlarmName","ALARM_MESSAGE":"AlarmTable.Header.AlarmMessage","ALARM_LEVEL":"AlarmTable.Header.AlarmLevel","TIME":"AlarmTable.Header.Time"},"TIME_PERIOD_KEYS":{"LAST_THIRTY_MINUTES":"HistoricalCurve.TimeFilter.Last30Minutes","LAST_ONE_HOUR":"HistoricalCurve.TimeFilter.Last1Hour","LAST_EIGHT_HOURS":"HistoricalCurve.TimeFilter.Last8Hours","LAST_TWENTY_FOUR_HOURS":"HistoricalCurve.TimeFilter.Last24Hours","LAST_SEVEN_DAYS":"HistoricalCurve.TimeFilter.Last7Days","LAST_THIRTY_DAYS":"HistoricalCurve.TimeFilter.Last30Days","LAST_ONE_YEAR":"HistoricalCurve.TimeFilter.Last1Year","CUSTOM":"HistoricalCurve.TimeFilter.Custom"},"SystemTextLibraryService":{"__symbolic":"interface"}}}]

package/service/text-library.service.d.ts

@@ -0,0 +1,49 @@
+import { Observable } from 'rxjs';
+/**
+ * 文本条目接口
+ */
+export interface TextEntry {
+    key: string;
+    value: string;
+    cultures: {
+        [key: string]: string;
+    };
+}
+/**
+ * 文本库缓存数据接口
+ */
+export interface TextLibraryCacheData {
+    id: number;
+    name: string;
+    data: TextEntry[];
+}
+/**
+ * 文本库服务接口
+ * 提供文本库的查询能力，供 GUI 组件使用
+ */
+export interface TextLibraryService {
+    /**
+     * 获取所有文本库
+     */
+    getAllTextLibraries(): TextLibraryCacheData[];
+    /**
+     * 根据ID获取文本库
+     */
+    getTextLibraryById(id: number): TextLibraryCacheData | null;
+    /**
+     * 根据文本库ID和条目key获取文本条目
+     */
+    getTextEntry(textLibraryId: number, entryKey: string): TextEntry | null;
+    /**
+     * 根据文本库ID、条目key和语言获取文本值
+     */
+    getTextValue(textLibraryId: number, entryKey: string, culture?: string): string | null;
+    /**
+     * 检查是否有缓存数据
+     */
+    hasCache(): boolean;
+    /**
+     * 缓存更新事件 (可选)
+     */
+    readonly cacheUpdated?: Observable<void>;
+}

package/service/text-library.service.metadata.json

@@ -0,0 +1 @@
+[{"__symbolic":"module","version":4,"metadata":{"TextEntry":{"__symbolic":"interface"},"TextLibraryCacheData":{"__symbolic":"interface"},"TextLibraryService":{"__symbolic":"interface"}}}]

package/shared/gui-consts.d.ts

@@ -27,5 +27,7 @@ export declare class GuiConsts {
         tableKey: string;
         weatherKey: string;
         airQualityKey: string;
+        alarmKey: string;
+        scrollAlarmKey: string;
     };
 }

package/shared/gui-consts.js

@@ -27,5 +27,7 @@ GuiConsts.components = {
     videokey: 'Video',
     tableKey: 'Table',
     weatherKey: 'Weather',
-    airQualityKey: 'AirQualityIndex'
+    airQualityKey: 'AirQualityIndex',
+    alarmKey: 'Alarm',
+    scrollAlarmKey: 'ScrollAlarm'
 };

package/shared/gui-consts.metadata.json

@@ -1 +1 @@
-[{"__symbolic":"module","version":4,"metadata":{"GuiConsts":{"__symbolic":"class","statics":{"components":{"imageKey":"Image","numericalDisplayKey":"NumericalDisplay","textKey":"Text","hyperlinkKey":"Hyperlink","meterKey":"Meter","pipeKey":"Pipe","switchIndicatorLightKey":"SwitchIndicatorLight","barGraphKey":"BarGraph","toggleViewKey":"ToggleView","characterKey":"Character","straightLineKey":"StraightLine","polyLineKey":"PolyLine","rectangleKey":"Rectangle","sectorkey":"Sector","ellipseKey":"Ellipse","datetimeDisplayKey":"DatetimeDisplay","historicalCurveKey":"HistoricalCurve","ringGraphKey":"RingGraph","viewOperationElement":"ViewOperation","polygonKey":"Polygon","videokey":"Video","tableKey":"Table","weatherKey":"Weather","airQualityKey":"AirQualityIndex"}}}}}]
+[{"__symbolic":"module","version":4,"metadata":{"GuiConsts":{"__symbolic":"class","statics":{"components":{"imageKey":"Image","numericalDisplayKey":"NumericalDisplay","textKey":"Text","hyperlinkKey":"Hyperlink","meterKey":"Meter","pipeKey":"Pipe","switchIndicatorLightKey":"SwitchIndicatorLight","barGraphKey":"BarGraph","toggleViewKey":"ToggleView","characterKey":"Character","straightLineKey":"StraightLine","polyLineKey":"PolyLine","rectangleKey":"Rectangle","sectorkey":"Sector","ellipseKey":"Ellipse","datetimeDisplayKey":"DatetimeDisplay","historicalCurveKey":"HistoricalCurve","ringGraphKey":"RingGraph","viewOperationElement":"ViewOperation","polygonKey":"Polygon","videokey":"Video","tableKey":"Table","weatherKey":"Weather","airQualityKey":"AirQualityIndex","alarmKey":"Alarm","scrollAlarmKey":"ScrollAlarm"}}}}}]