@das-fed/upf-utils 6.4.0-dev.267 → 6.4.0-dev.269

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

@@ -97,6 +97,10 @@ export interface FormatLocalDateTimeOptions {
 export interface ApplyIanaTimeZoneOptions {
     /** 指定默认时区，后续 dayjs.tz(value) 可直接使用。 */
     defaultTimeZone?: string;
+    /** 写入运行期快照的数据来源，供 mframe 注入 iframe 首屏复用。 */
+    runtimeSource?: RuntimeIanaTimeZoneDataSource;
+    /** 是否同步 window.__UPF_IANA_TIMEZONE_DATA__ 并派发事件，默认 true。 */
+    syncRuntimeSnapshot?: boolean;
 }
 export interface LoadIanaTimeZoneOptions extends PreloadDayjsIanaOptions, ApplyIanaTimeZoneOptions {
 }
@@ -126,8 +130,19 @@ export interface SetClientTimeZoneOptions {
     source?: string;
 }
 export type ClientTimeZoneChangeHandler = (timeZone: string, detail: ClientTimeZoneChangeDetail) => void;
+export type RuntimeIanaTimeZoneDataSource = 'iana' | 'fallback';
+export interface RuntimeIanaTimeZoneDataSnapshot extends PackedIanaData {
+    /** 数据来源：接口 IANA 数据或降级兜底数据。 */
+    source: RuntimeIanaTimeZoneDataSource;
+    /** 写入快照时间，供宿主和 iframe 判断是否需要刷新。 */
+    timestamp: number;
+}
 export declare const TIMEZONE_CHANGE_EVENT = "timezonechange";
 export declare const UPF_TIMEZONE_MESSAGE_TYPE = "__UPF_TIMEZONE_CHANGE__";
+export declare const IANA_TIMEZONE_DATA_CHANGE_EVENT = "ianatimezonedatachange";
+export declare const setRuntimeIanaTimeZoneDataSnapshot: (data: Pick<PackedIanaData, "version" | "zones" | "links">, source?: RuntimeIanaTimeZoneDataSource) => RuntimeIanaTimeZoneDataSnapshot;
+export declare const getRuntimeIanaTimeZoneDataSnapshot: () => RuntimeIanaTimeZoneDataSnapshot | null;
+export declare const getRuntimeNameZoneDataSnapshot: () => RuntimeIanaTimeZoneDataSnapshot | null;
 export declare const clientTimeZone: any;
 export declare const isKnownTimeZone: (timeZone?: string | null) => any;
 export declare const rebuildKnownTimeZoneIds: (data: Pick<PackedIanaData, "zones" | "links">) => any;