@das-fed/upf-utils 6.4.0-dev.248 → 6.4.0-dev.250

package/common-tools/timezone-format/index.d.ts

@@ -107,6 +107,32 @@ export interface ApplyIanaTimeZoneResult {
 export interface LoadMomentIanaTimeZoneOptions extends LoadIanaFromApiOptions {
     url?: string;
 }
+export interface ClientTimeZoneChangeDetail {
+    /** 当前用户选择的 IANA 时区；空字符串表示清空选择并回退本机推断。 */
+    timeZone: string;
+    /** 触发来源，用于区分主应用、子应用同步或本窗口事件。 */
+    source?: string;
+    timestamp: number;
+}
+export interface SetClientTimeZoneOptions {
+    /** 是否写入 sessionStorage.timeZone，默认 true。 */
+    persist?: boolean;
+    /** 是否通知 onClientTimeZoneChange 订阅者，默认 true。 */
+    notify?: boolean;
+    /** 是否派发 window timezonechange 事件，默认 true。 */
+    dispatchEvent?: boolean;
+    /** 是否同步 dayjs 默认时区，默认 true。 */
+    syncDefault?: boolean;
+    source?: string;
+}
+export type ClientTimeZoneChangeHandler = (timeZone: string, detail: ClientTimeZoneChangeDetail) => void;
+export interface ClientTimeZoneRef {
+    /** 框架无关的当前时区快照；Vue/Angular/原生应用都可直接读取。 */
+    value: string;
+}
+export declare const TIMEZONE_CHANGE_EVENT = "timezonechange";
+export declare const UPF_TIMEZONE_MESSAGE_TYPE = "__UPF_TIMEZONE_CHANGE__";
+export declare const clientTimeZone: ClientTimeZoneRef;
 export declare const isKnownTimeZone: (timeZone?: string | null) => any;
 export declare const rebuildKnownTimeZoneIds: (data: Pick<PackedIanaData, "zones" | "links">) => any;
 export declare const getKnownTimeZoneIds: () => any;
@@ -114,9 +140,13 @@ export declare const applyDayjsIanaTimeZoneData: (data: PackedIanaData, options?
 export declare const loadDayjsIanaTimeZoneData: (options?: LoadIanaTimeZoneOptions) => Promise<ApplyIanaTimeZoneResult>;
 export declare const applyMomentIanaTimeZoneData: (moment: MomentWithTimezone, data: PackedIanaTzData) => PackedIanaTzData;
 export declare const loadMomentIanaTimeZoneData: (moment: MomentWithTimezone, options?: LoadMomentIanaTimeZoneOptions) => unknown;
+export declare const setDefaultTimeZone: (timeZone?: string | null) => boolean;
+export declare const setClientTimeZone: (timeZone?: string | null, options?: SetClientTimeZoneOptions) => any;
+export declare const syncClientTimeZone: (source?: string) => any;
+export declare const onClientTimeZoneChange: (handler: ClientTimeZoneChangeHandler) => () => any;
+export declare const initClientTimeZoneSync: () => boolean;
 export declare const getClientTimeZone: () => any;
 export declare const resolveTimeZone: (timeZone?: string | null) => any;
-export declare const setDefaultTimeZone: (timeZone?: string | null) => boolean;
 export declare const normalizeLocaleCode: (locale?: string, supportedLocales?: string[]) => any;
 export declare const getZoneUtcOffset: (value: TimeValue, timeZone?: string | null) => any;
 export declare const formatInTimeZone: (value?: TimeValue, timeZone?: string | null, format?: string) => any;