dsh-group-status 0.2.1 → 0.3.0

package/lib/types/client/legacy/register-legacy-facets.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"register-legacy-facets.js","sourceRoot":"","sources":["../../../../src/client/legacy/register-legacy-facets.tsx"],"names":[],"mappings":"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"}

package/lib/types/client/legacy/schedule.d.ts

@@ -0,0 +1,49 @@
+/**
+ * 过渡期适配器：dsh-later 的「定时任务」→ facet。
+ *
+ * ⚠️ 与 `waiting-review.ts` 同属临时层，dsh-later 自己注册之后连同图标映射一并删除。
+ * 见其 issue #17（摘要 API）与本次的升级请求。
+ *
+ * @module dsh-group-status/client/legacy/schedule
+ */
+import type { FacetFold, FacetRenderContext, GroupStatusFacet } from '../facets.ts';
+/** facet id：与 dsh-later 自己注册时应当使用的 id 保持一致。 */
+export declare const SCHEDULE_FACET_ID = "dsh-later.schedule";
+/** 一条定时任务事实，来自 dsh-later 的 `useScheduleSummary()`。 */
+export interface ScheduleSummaryEntry {
+    readonly count: number;
+    readonly pausedCount: number;
+    readonly nextAt?: number;
+    readonly state: 'scheduled' | 'urgent' | 'overdue';
+}
+/** 会话 id → 该会话的定时任务事实。 */
+export type ScheduleSummaryMap = ReadonlyMap<string, ScheduleSummaryEntry>;
+/** 定时折果携带的数据：只有本 facet 读。 */
+export interface ScheduleData {
+    /** 组内定时任务总条数（含已暂停）。 */
+    readonly tasks: number;
+    /** 组内最高优先级状态：overdue > urgent > scheduled。 */
+    readonly state: 'scheduled' | 'urgent' | 'overdue' | undefined;
+}
+/**
+ * 把一组的会话 id 折成定时任务事实。
+ *
+ * `count` 用**有条目的会话数**（与徽标"还需要看几件事"的口径一致），任务总数留在
+ * `data.tasks` 里供文案/明细使用。
+ */
+export declare function foldSchedule(snapshot: ScheduleSummaryMap | undefined, sessionIds: readonly string[]): FacetFold<ScheduleData>;
+/** 跨层合并：会话数与任务数相加，状态取更紧急的一档。 */
+export declare function mergeScheduleFold(a: FacetFold<ScheduleData>, b: FacetFold<ScheduleData>): FacetFold<ScheduleData>;
+/** 「N 定时任务」：措辞沿用本插件的行级文案键。 */
+export declare function scheduleLabel(fold: FacetFold<ScheduleData>, context: FacetRenderContext): string;
+/**
+ * 构造内置的定时任务 facet。
+ *
+ * @param input.getSnapshot - 读 dsh-later 的摘要 Map。
+ * @param input.subscribe - 订阅其变化。
+ */
+export declare function createScheduleFacet(input: {
+    subscribe: (listener: () => void) => () => void;
+    getSnapshot: () => ScheduleSummaryMap | undefined;
+}): GroupStatusFacet<ScheduleSummaryMap | undefined, ScheduleData>;
+//# sourceMappingURL=schedule.d.ts.map

package/lib/types/client/legacy/schedule.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schedule.d.ts","sourceRoot":"","sources":["../../../../src/client/legacy/schedule.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,OAAO,KAAK,EAAE,SAAS,EAAE,kBAAkB,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAA;AAGnF,+CAA+C;AAC/C,eAAO,MAAM,iBAAiB,uBAAuB,CAAA;AAErD,sDAAsD;AACtD,MAAM,WAAW,oBAAoB;IACnC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;IACtB,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAA;IAC5B,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAA;IACxB,QAAQ,CAAC,KAAK,EAAE,WAAW,GAAG,QAAQ,GAAG,SAAS,CAAA;CACnD;AAED,0BAA0B;AAC1B,MAAM,MAAM,kBAAkB,GAAG,WAAW,CAAC,MAAM,EAAE,oBAAoB,CAAC,CAAA;AAE1E,6BAA6B;AAC7B,MAAM,WAAW,YAAY;IAC3B,uBAAuB;IACvB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;IACtB,8CAA8C;IAC9C,QAAQ,CAAC,KAAK,EAAE,WAAW,GAAG,QAAQ,GAAG,SAAS,GAAG,SAAS,CAAA;CAC/D;AAOD;;;;;GAKG;AACH,wBAAgB,YAAY,CAC1B,QAAQ,EAAE,kBAAkB,GAAG,SAAS,EACxC,UAAU,EAAE,SAAS,MAAM,EAAE,GAC5B,SAAS,CAAC,YAAY,CAAC,CAoBzB;AAED,gCAAgC;AAChC,wBAAgB,iBAAiB,CAAC,CAAC,EAAE,SAAS,CAAC,YAAY,CAAC,EAAE,CAAC,EAAE,SAAS,CAAC,YAAY,CAAC,GAAG,SAAS,CAAC,YAAY,CAAC,CAUjH;AAED,8BAA8B;AAC9B,wBAAgB,aAAa,CAAC,IAAI,EAAE,SAAS,CAAC,YAAY,CAAC,EAAE,OAAO,EAAE,kBAAkB,GAAG,MAAM,CAEhG;AAED;;;;;GAKG;AACH,wBAAgB,mBAAmB,CAAC,KAAK,EAAE;IACzC,SAAS,EAAE,CAAC,QAAQ,EAAE,MAAM,IAAI,KAAK,MAAM,IAAI,CAAA;IAC/C,WAAW,EAAE,MAAM,kBAAkB,GAAG,SAAS,CAAA;CAClD,GAAG,gBAAgB,CAAC,kBAAkB,GAAG,SAAS,EAAE,YAAY,CAAC,CAajE"}

package/lib/types/client/legacy/schedule.js

@@ -0,0 +1,73 @@
+import { GROUP_STATUS_FACET_PROTOCOL_VERSION } from "../facets.js";
+/** facet id：与 dsh-later 自己注册时应当使用的 id 保持一致。 */
+export const SCHEDULE_FACET_ID = 'dsh-later.schedule';
+/** 状态优先级（越大越紧急），与 dsh-later 的行内口径一致。 */
+const SCHEDULE_RANK = {
+    scheduled: 1, urgent: 2, overdue: 3,
+};
+/**
+ * 把一组的会话 id 折成定时任务事实。
+ *
+ * `count` 用**有条目的会话数**（与徽标"还需要看几件事"的口径一致），任务总数留在
+ * `data.tasks` 里供文案/明细使用。
+ */
+export function foldSchedule(snapshot, sessionIds) {
+    let sessions = 0;
+    let tasks = 0;
+    let state;
+    if (snapshot !== undefined) {
+        for (const id of sessionIds) {
+            const entry = snapshot.get(id);
+            if (entry === undefined)
+                continue;
+            sessions += 1;
+            tasks += entry.count;
+            if (state === undefined || SCHEDULE_RANK[entry.state] > SCHEDULE_RANK[state])
+                state = entry.state;
+        }
+    }
+    return {
+        count: sessions,
+        tone: state === 'overdue' ? 'error' : state === 'urgent' ? 'warn' : 'info',
+        // 提醒已过点 / 五分钟内到点 = 真的在催用户，这是脉冲的唯一合法用途。
+        pulse: state === 'overdue' || state === 'urgent',
+        data: { tasks, state },
+    };
+}
+/** 跨层合并：会话数与任务数相加，状态取更紧急的一档。 */
+export function mergeScheduleFold(a, b) {
+    const rankA = a.data?.state === undefined ? 0 : SCHEDULE_RANK[a.data.state];
+    const rankB = b.data?.state === undefined ? 0 : SCHEDULE_RANK[b.data.state];
+    const state = rankB > rankA ? b.data?.state : a.data?.state;
+    return {
+        count: a.count + b.count,
+        tone: state === 'overdue' ? 'error' : state === 'urgent' ? 'warn' : 'info',
+        pulse: a.pulse || b.pulse,
+        data: { tasks: (a.data?.tasks ?? 0) + (b.data?.tasks ?? 0), state },
+    };
+}
+/** 「N 定时任务」：措辞沿用本插件的行级文案键。 */
+export function scheduleLabel(fold, context) {
+    return `${fold.count} ${context.t('status.scheduled')}`;
+}
+/**
+ * 构造内置的定时任务 facet。
+ *
+ * @param input.getSnapshot - 读 dsh-later 的摘要 Map。
+ * @param input.subscribe - 订阅其变化。
+ */
+export function createScheduleFacet(input) {
+    return {
+        protocol: GROUP_STATUS_FACET_PROTOCOL_VERSION,
+        id: SCHEDULE_FACET_ID,
+        origin: 'legacy',
+        settingKey: 'showScheduledInBadge',
+        order: 10,
+        subscribe: input.subscribe,
+        getSnapshot: input.getSnapshot,
+        fold: (snapshot, sessionIds) => foldSchedule(snapshot, sessionIds),
+        merge: mergeScheduleFold,
+        label: scheduleLabel,
+    };
+}
+//# sourceMappingURL=schedule.js.map

package/lib/types/client/legacy/schedule.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"schedule.js","sourceRoot":"","sources":["../../../../src/client/legacy/schedule.ts"],"names":[],"mappings":"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"}

package/lib/types/client/legacy/store-source.d.ts

@@ -0,0 +1,78 @@
+/**
+ * 过渡期桥接层里**与图标无关**的那一半。
+ *
+ * 单独成文只为一件事：可测。`register-legacy-facets.tsx` 引宿主图标集，它的 `require`
+ * 图在本仓库里解析不了（`vitest.config.ts` 排除理由 (b)）。"store 迟到怎么办"和"设置
+ * 关掉哪个来源"都是真会咬人的逻辑，跟图标写在一起就永远进不了测试。
+ *
+ * @module dsh-group-status/client/legacy/store-source
+ */
+import { type ResolvedBadgeSettings } from '../badge-settings.ts';
+import type { RegisteredFacet } from '../facets.ts';
+import type { ScheduleSummaryMap } from './schedule.ts';
+import type { WaitingReviewSummarizer, WaitingReviewSummaryMap } from './waiting-review.ts';
+/**
+ * 把「store 可能迟到」的两层订阅合成一个稳定订阅面。
+ *
+ * @param getStore - 读当前生效的 store（未登记时 undefined）。
+ * @param subscribeRegistry - 订阅 store 登记变化（提供方 apply 晚于本插件渲染时用它自愈）。
+ */
+export declare function bridgeLateStoreSource<Snapshot>(getStore: (() => {
+    getSnapshot: () => Snapshot | undefined;
+    subscribe: (listener: () => void) => () => void;
+} | undefined) | undefined, subscribeRegistry: ((listener: () => void) => () => void) | undefined): {
+    subscribe: (listener: () => void) => () => void;
+    getSnapshot: () => Snapshot | undefined;
+} | undefined;
+/**
+ * 安装两个过渡适配器。
+ *
+ * @returns 一次性注销函数（挂到 `ctx.effect` 的清理上）。
+
+/**
+ * 按设置筛掉被关掉的来源。
+ *
+ * 过滤放在**折叠之前**而不是渲染阶段：数字、图标、`aria-label`、悬停明细与"要不要画
+ * 徽标"因此天然同源，不会出现在 label 里有、计数里没有的情况。
+ */
+export declare function visibleFacets(entries: readonly RegisteredFacet[], settings: ResolvedBadgeSettings): RegisteredFacet[];
+/** 提供方 store 的最小面（两家同形：宿主 `useSyncExternalStore` 的外部存储）。 */
+export interface ProviderStore<Snapshot> {
+    getSnapshot: () => Snapshot | undefined;
+    subscribe: (listener: () => void) => () => void;
+}
+/** 两家 provider 的 client 导出面里，桥接层真正用到的部分。 */
+export interface LegacyProviderClients {
+    /** 缺席（未安装 / 未启用）就整个省略这个键。 */
+    later?: {
+        getScheduleSummaryStore?: () => ProviderStore<ScheduleSummaryMap> | undefined;
+        subscribeScheduleSummaryStore?: (listener: () => void) => () => void;
+    };
+    /** 同上。 */
+    dispatch?: {
+        getWaitingSummaryStore?: () => ProviderStore<WaitingReviewSummaryMap> | undefined;
+        subscribeWaitingSummaryStore?: (listener: () => void) => () => void;
+        summarizeWaitingGroup?: WaitingReviewSummarizer;
+    };
+}
+/** 交给图标层的装配入参（见 `register-legacy-facets.tsx`）。 */
+export interface LegacyFacetSources {
+    schedule: {
+        subscribe: (listener: () => void) => () => void;
+        getSnapshot: () => ScheduleSummaryMap | undefined;
+    } | undefined;
+    waiting: {
+        subscribe: (listener: () => void) => () => void;
+        getSnapshot: () => WaitingReviewSummaryMap | undefined;
+        summarize?: WaitingReviewSummarizer;
+    } | undefined;
+}
+/**
+ * 从两家 provider 的 client 面拼出登记入参。
+ *
+ * 这一层刻意不碰图标、不 `require`：它是桥接里唯一"会拼错"的部分（store 迟到、
+ * 谁缺席、委托哪个聚合函数），能被测试覆盖才有意义。`require` 与图标各自留在只有一行
+ * 调用的 `bridge.ts` 与 `register-legacy-facets.tsx` 里。
+ */
+export declare function assembleLegacySources(clients: LegacyProviderClients): LegacyFacetSources;
+//# sourceMappingURL=store-source.d.ts.map

package/lib/types/client/legacy/store-source.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"store-source.d.ts","sourceRoot":"","sources":["../../../../src/client/legacy/store-source.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,OAAO,EAA0B,KAAK,qBAAqB,EAAE,MAAM,sBAAsB,CAAA;AACzF,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,cAAc,CAAA;AACnD,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,eAAe,CAAA;AACvD,OAAO,KAAK,EAAE,uBAAuB,EAAE,uBAAuB,EAAE,MAAM,qBAAqB,CAAA;AAE3F;;;;;GAKG;AACH,wBAAgB,qBAAqB,CAAC,QAAQ,EAC5C,QAAQ,EAAE,CAAC,MAAM;IAAE,WAAW,EAAE,MAAM,QAAQ,GAAG,SAAS,CAAC;IAAC,SAAS,EAAE,CAAC,QAAQ,EAAE,MAAM,IAAI,KAAK,MAAM,IAAI,CAAA;CAAE,GAAG,SAAS,CAAC,GAAG,SAAS,EACtI,iBAAiB,EAAE,CAAC,CAAC,QAAQ,EAAE,MAAM,IAAI,KAAK,MAAM,IAAI,CAAC,GAAG,SAAS,GACpE;IAAE,SAAS,EAAE,CAAC,QAAQ,EAAE,MAAM,IAAI,KAAK,MAAM,IAAI,CAAC;IAAC,WAAW,EAAE,MAAM,QAAQ,GAAG,SAAS,CAAA;CAAE,GAAG,SAAS,CA4B1G;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,aAAa,CAC3B,OAAO,EAAE,SAAS,eAAe,EAAE,EACnC,QAAQ,EAAE,qBAAqB,GAC9B,eAAe,EAAE,CAEnB;AAED,4DAA4D;AAC5D,MAAM,WAAW,aAAa,CAAC,QAAQ;IACrC,WAAW,EAAE,MAAM,QAAQ,GAAG,SAAS,CAAA;IACvC,SAAS,EAAE,CAAC,QAAQ,EAAE,MAAM,IAAI,KAAK,MAAM,IAAI,CAAA;CAChD;AAED,4CAA4C;AAC5C,MAAM,WAAW,qBAAqB;IACpC,6BAA6B;IAC7B,KAAK,CAAC,EAAE;QACN,uBAAuB,CAAC,EAAE,MAAM,aAAa,CAAC,kBAAkB,CAAC,GAAG,SAAS,CAAA;QAC7E,6BAA6B,CAAC,EAAE,CAAC,QAAQ,EAAE,MAAM,IAAI,KAAK,MAAM,IAAI,CAAA;KACrE,CAAA;IACD,UAAU;IACV,QAAQ,CAAC,EAAE;QACT,sBAAsB,CAAC,EAAE,MAAM,aAAa,CAAC,uBAAuB,CAAC,GAAG,SAAS,CAAA;QACjF,4BAA4B,CAAC,EAAE,CAAC,QAAQ,EAAE,MAAM,IAAI,KAAK,MAAM,IAAI,CAAA;QACnE,qBAAqB,CAAC,EAAE,uBAAuB,CAAA;KAChD,CAAA;CACF;AAED,kDAAkD;AAClD,MAAM,WAAW,kBAAkB;IACjC,QAAQ,EAAE;QACR,SAAS,EAAE,CAAC,QAAQ,EAAE,MAAM,IAAI,KAAK,MAAM,IAAI,CAAA;QAC/C,WAAW,EAAE,MAAM,kBAAkB,GAAG,SAAS,CAAA;KAClD,GAAG,SAAS,CAAA;IACb,OAAO,EAAE;QACP,SAAS,EAAE,CAAC,QAAQ,EAAE,MAAM,IAAI,KAAK,MAAM,IAAI,CAAA;QAC/C,WAAW,EAAE,MAAM,uBAAuB,GAAG,SAAS,CAAA;QACtD,SAAS,CAAC,EAAE,uBAAuB,CAAA;KACpC,GAAG,SAAS,CAAA;CACd;AAED;;;;;;GAMG;AACH,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,qBAAqB,GAAG,kBAAkB,CAgBxF"}

package/lib/types/client/legacy/store-source.js

@@ -0,0 +1,82 @@
+/**
+ * 过渡期桥接层里**与图标无关**的那一半。
+ *
+ * 单独成文只为一件事：可测。`register-legacy-facets.tsx` 引宿主图标集，它的 `require`
+ * 图在本仓库里解析不了（`vitest.config.ts` 排除理由 (b)）。"store 迟到怎么办"和"设置
+ * 关掉哪个来源"都是真会咬人的逻辑，跟图标写在一起就永远进不了测试。
+ *
+ * @module dsh-group-status/client/legacy/store-source
+ */
+import { facetVisibleBySettings } from "../badge-settings.js";
+/**
+ * 把「store 可能迟到」的两层订阅合成一个稳定订阅面。
+ *
+ * @param getStore - 读当前生效的 store（未登记时 undefined）。
+ * @param subscribeRegistry - 订阅 store 登记变化（提供方 apply 晚于本插件渲染时用它自愈）。
+ */
+export function bridgeLateStoreSource(getStore, subscribeRegistry) {
+    if (getStore === undefined)
+        return undefined;
+    return {
+        getSnapshot: () => getStore()?.getSnapshot(),
+        subscribe: (listener) => {
+            // store 每迟到/替换一次就要重挂它的订阅；登记表变化本身也算一次变化。
+            let storeUnsubscribe;
+            let current;
+            const rewire = () => {
+                const next = getStore();
+                if (next === current)
+                    return;
+                storeUnsubscribe?.();
+                current = next;
+                storeUnsubscribe = next?.subscribe(listener);
+            };
+            rewire();
+            const unsubscribeRegistry = subscribeRegistry?.(() => {
+                rewire();
+                listener();
+            });
+            return () => {
+                unsubscribeRegistry?.();
+                storeUnsubscribe?.();
+                storeUnsubscribe = undefined;
+                current = undefined;
+            };
+        },
+    };
+}
+/**
+ * 安装两个过渡适配器。
+ *
+ * @returns 一次性注销函数（挂到 `ctx.effect` 的清理上）。
+
+/**
+ * 按设置筛掉被关掉的来源。
+ *
+ * 过滤放在**折叠之前**而不是渲染阶段：数字、图标、`aria-label`、悬停明细与"要不要画
+ * 徽标"因此天然同源，不会出现在 label 里有、计数里没有的情况。
+ */
+export function visibleFacets(entries, settings) {
+    return entries.filter(entry => facetVisibleBySettings(settings, entry.facet.settingKey));
+}
+/**
+ * 从两家 provider 的 client 面拼出登记入参。
+ *
+ * 这一层刻意不碰图标、不 `require`：它是桥接里唯一"会拼错"的部分（store 迟到、
+ * 谁缺席、委托哪个聚合函数），能被测试覆盖才有意义。`require` 与图标各自留在只有一行
+ * 调用的 `bridge.ts` 与 `register-legacy-facets.tsx` 里。
+ */
+export function assembleLegacySources(clients) {
+    const schedule = bridgeLateStoreSource(clients.later?.getScheduleSummaryStore, clients.later?.subscribeScheduleSummaryStore);
+    const waiting = bridgeLateStoreSource(clients.dispatch?.getWaitingSummaryStore, clients.dispatch?.subscribeWaitingSummaryStore);
+    const summarize = clients.dispatch?.summarizeWaitingGroup;
+    return {
+        schedule: schedule === undefined ? undefined : { subscribe: schedule.subscribe, getSnapshot: schedule.getSnapshot },
+        waiting: waiting === undefined ? undefined : {
+            subscribe: waiting.subscribe,
+            getSnapshot: waiting.getSnapshot,
+            ...(summarize === undefined ? {} : { summarize }),
+        },
+    };
+}
+//# sourceMappingURL=store-source.js.map

package/lib/types/client/legacy/store-source.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"store-source.js","sourceRoot":"","sources":["../../../../src/client/legacy/store-source.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,OAAO,EAAE,sBAAsB,EAA8B,MAAM,sBAAsB,CAAA;AAKzF;;;;;GAKG;AACH,MAAM,UAAU,qBAAqB,CACnC,QAAsI,EACtI,iBAAqE;IAErE,IAAI,QAAQ,KAAK,SAAS;QAAE,OAAO,SAAS,CAAA;IAC5C,OAAO;QACL,WAAW,EAAE,GAAG,EAAE,CAAC,QAAQ,EAAE,EAAE,WAAW,EAAE;QAC5C,SAAS,EAAE,CAAC,QAAQ,EAAE,EAAE;YACtB,wCAAwC;YACxC,IAAI,gBAA0C,CAAA;YAC9C,IAAI,OAAoC,CAAA;YACxC,MAAM,MAAM,GAAG,GAAS,EAAE;gBACxB,MAAM,IAAI,GAAG,QAAQ,EAAE,CAAA;gBACvB,IAAI,IAAI,KAAK,OAAO;oBAAE,OAAM;gBAC5B,gBAAgB,EAAE,EAAE,CAAA;gBACpB,OAAO,GAAG,IAAI,CAAA;gBACd,gBAAgB,GAAG,IAAI,EAAE,SAAS,CAAC,QAAQ,CAAC,CAAA;YAC9C,CAAC,CAAA;YACD,MAAM,EAAE,CAAA;YACR,MAAM,mBAAmB,GAAG,iBAAiB,EAAE,CAAC,GAAG,EAAE;gBACnD,MAAM,EAAE,CAAA;gBACR,QAAQ,EAAE,CAAA;YACZ,CAAC,CAAC,CAAA;YACF,OAAO,GAAG,EAAE;gBACV,mBAAmB,EAAE,EAAE,CAAA;gBACvB,gBAAgB,EAAE,EAAE,CAAA;gBACpB,gBAAgB,GAAG,SAAS,CAAA;gBAC5B,OAAO,GAAG,SAAS,CAAA;YACrB,CAAC,CAAA;QACH,CAAC;KACF,CAAA;AACH,CAAC;AAED;;;;;;;;;;GAUG;AACH,MAAM,UAAU,aAAa,CAC3B,OAAmC,EACnC,QAA+B;IAE/B,OAAO,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC,sBAAsB,CAAC,QAAQ,EAAE,KAAK,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC,CAAA;AAC1F,CAAC;AAoCD;;;;;;GAMG;AACH,MAAM,UAAU,qBAAqB,CAAC,OAA8B;IAClE,MAAM,QAAQ,GAAG,qBAAqB,CACpC,OAAO,CAAC,KAAK,EAAE,uBAAuB,EAAE,OAAO,CAAC,KAAK,EAAE,6BAA6B,CACrF,CAAA;IACD,MAAM,OAAO,GAAG,qBAAqB,CACnC,OAAO,CAAC,QAAQ,EAAE,sBAAsB,EAAE,OAAO,CAAC,QAAQ,EAAE,4BAA4B,CACzF,CAAA;IACD,MAAM,SAAS,GAAG,OAAO,CAAC,QAAQ,EAAE,qBAAqB,CAAA;IACzD,OAAO;QACL,QAAQ,EAAE,QAAQ,KAAK,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,SAAS,EAAE,QAAQ,CAAC,SAAS,EAAE,WAAW,EAAE,QAAQ,CAAC,WAAW,EAAE;QACnH,OAAO,EAAE,OAAO,KAAK,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC;YAC3C,SAAS,EAAE,OAAO,CAAC,SAAS;YAC5B,WAAW,EAAE,OAAO,CAAC,WAAW;YAChC,GAAG,CAAC,SAAS,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,SAAS,EAAE,CAAC;SAClD;KACF,CAAA;AACH,CAAC"}

package/lib/types/client/legacy/waiting-review.d.ts

@@ -0,0 +1,85 @@
+import type { FacetFold, FacetRenderContext, GroupStatusFacet } from '../facets.ts';
+/** facet id：与 dsh-gitea-dispatch 自己注册时应当使用的 id 保持一致。 */
+export declare const WAITING_REVIEW_FACET_ID = "dsh-gitea-dispatch.waiting-review";
+/**
+ * 一条等待评审事实，来自 dsh-gitea-dispatch 的 `useWaitingSummary()`
+ * （issue: dsh-gitea-dispatch#16）。
+ *
+ * 可选字段是提供方契约的一部分：正是它们让徽标能说「在等哪个 PR」「还剩多久」。
+ * 本类型此前只声明 `{ prNumber, state }`，于是提供方已经取回的信息被静默丢掉。
+ */
+export interface WaitingReviewSummaryEntry {
+    readonly prNumber: number;
+    readonly state: 'waiting' | 'overdue';
+    /** 等待起点（宿主 state 里是 epoch ms，过 wire 可能是 ISO 字符串）。 */
+    readonly startedAt?: number | string;
+    /** CI 声明的等待上限（秒）；缺省 = 时长未知。 */
+    readonly waitMaxSec?: number;
+    /** CI 声明的绝对截止（epoch ms）；优先于 `startedAt + waitMaxSec`。 */
+    readonly deadline?: number;
+}
+/** 会话 id → 该会话的等待事实（没有条目 = 没在等）。 */
+export type WaitingReviewSummaryMap = ReadonlyMap<string, WaitingReviewSummaryEntry>;
+/** 提供方 `summarizeWaitingGroup()` 的折果形状。 */
+export interface WaitingReviewFold {
+    /** 组内**在等**的会话数。 */
+    sessions: number;
+    /** 组内在等的 PR 号（按传入会话顺序）。 */
+    prNumbers: readonly number[];
+    /** 组内最高优先级状态：overdue > waiting。 */
+    state: 'waiting' | 'overdue' | undefined;
+    /** 组内**尚未到点**的最早截止（epoch ms）；无则缺省。 */
+    nextDeadline?: number;
+}
+/** 提供方的分组聚合函数面。 */
+export type WaitingReviewSummarizer = (summary: WaitingReviewSummaryMap, sessionIds: readonly string[], now: number) => WaitingReviewFold;
+/** 等待折果携带的数据：徽标从不解释它，只有本 facet 读。 */
+export interface WaitingReviewData {
+    readonly prNumbers: readonly number[];
+    readonly state: 'waiting' | 'overdue' | undefined;
+    readonly nextDeadline?: number;
+}
+/**
+ * 一条等待的绝对截止（epoch ms）；`undefined` = 时长未知。
+ *
+ * 刻意与提供方的 `deadlineOf` 同口径（绝对 deadline 优先，才退 `startedAt + waitMaxSec`）：
+ * CI 的等待从"进入循环"起算，而广播在此之前已发出，只按时长算会让徽标的倒计时晚于
+ * 真实截止（其 Issues #2577）。`startedAt` 的两种形态同理都要认。
+ */
+export declare function waitingDeadlineOf(entry: WaitingReviewSummaryEntry): number | undefined;
+/**
+ * 提供方聚合面缺席时的等价折叠。
+ *
+ * 与提供方的 `summarizeWaitingGroup()` 同一套判据：四形态 id 兜底（复用
+ * `cross-plugin-summary.ts` 的 `entryFor`，规则与它的 `waitingEntryFor` 相同）、
+ * `overdue > waiting` 排序、只把**未到期**的截止算作 `nextDeadline`。
+ */
+export declare function summarizeWaitingGroupLocally(summary: WaitingReviewSummaryMap, sessionIds: readonly string[], now: number): WaitingReviewFold;
+/**
+ * 同 facet 跨层合并：PR 号取并集去重升序、色档取更紧急的一档、
+ * 倒计时取两侧更早的那个未到期截止。
+ */
+export declare function mergeWaitingReviewFold(a: FacetFold<WaitingReviewData>, b: FacetFold<WaitingReviewData>): FacetFold<WaitingReviewData>;
+/** `#15, #2783(+2)`：去重升序、封顶三个。 */
+export declare function prNumberList(prNumbers: readonly number[] | undefined): string;
+/**
+ * 等待评审那一句文案：状态 + 剩余时长（分钟粒度）+ PR 号。
+ *
+ * 措辞与提供方自己的行内呈现同档（`等待评审 3:28` / `评审等待已超时` / `等待评审结果`），
+ * 但只到分钟：徽标只在提供方 store 通知时重渲染，秒级读数会停在旧值上撒谎。
+ */
+export declare function waitingReviewLabel(fold: FacetFold<WaitingReviewData>, context: FacetRenderContext): string;
+/**
+ * 构造本插件内置的等待评审 facet。
+ *
+ * @param input - 提供方的摘要读取面；`summarize` 缺席时退回本地等价折叠。
+ * @param input.subscribe - 订阅快照变化（提供方 store 的订阅面）。
+ * @param input.getSnapshot - 读当前摘要 Map。
+ * @param input.summarize - 提供方的分组聚合（有则委托）。
+ */
+export declare function createWaitingReviewFacet(input: {
+    subscribe: (listener: () => void) => () => void;
+    getSnapshot: () => WaitingReviewSummaryMap | undefined;
+    summarize?: WaitingReviewSummarizer;
+}): GroupStatusFacet<WaitingReviewSummaryMap | undefined, WaitingReviewData>;
+//# sourceMappingURL=waiting-review.d.ts.map

package/lib/types/client/legacy/waiting-review.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"waiting-review.d.ts","sourceRoot":"","sources":["../../../../src/client/legacy/waiting-review.ts"],"names":[],"mappings":"AAoBA,OAAO,KAAK,EAAE,SAAS,EAAE,kBAAkB,EAAa,gBAAgB,EAAE,MAAM,cAAc,CAAA;AAG9F,wDAAwD;AACxD,eAAO,MAAM,uBAAuB,sCAAsC,CAAA;AAI1E;;;;;;GAMG;AACH,MAAM,WAAW,yBAAyB;IACxC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAA;IACzB,QAAQ,CAAC,KAAK,EAAE,SAAS,GAAG,SAAS,CAAA;IACrC,qDAAqD;IACrD,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,GAAG,MAAM,CAAA;IACpC,+BAA+B;IAC/B,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAA;IAC5B,yDAAyD;IACzD,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;CAC3B;AAED,oCAAoC;AACpC,MAAM,MAAM,uBAAuB,GAAG,WAAW,CAAC,MAAM,EAAE,yBAAyB,CAAC,CAAA;AAEpF,2CAA2C;AAC3C,MAAM,WAAW,iBAAiB;IAChC,oBAAoB;IACpB,QAAQ,EAAE,MAAM,CAAA;IAChB,2BAA2B;IAC3B,SAAS,EAAE,SAAS,MAAM,EAAE,CAAA;IAC5B,mCAAmC;IACnC,KAAK,EAAE,SAAS,GAAG,SAAS,GAAG,SAAS,CAAA;IACxC,sCAAsC;IACtC,YAAY,CAAC,EAAE,MAAM,CAAA;CACtB;AAED,mBAAmB;AACnB,MAAM,MAAM,uBAAuB,GAAG,CACpC,OAAO,EAAE,uBAAuB,EAChC,UAAU,EAAE,SAAS,MAAM,EAAE,EAC7B,GAAG,EAAE,MAAM,KACR,iBAAiB,CAAA;AAEtB,qCAAqC;AACrC,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,SAAS,EAAE,SAAS,MAAM,EAAE,CAAA;IACrC,QAAQ,CAAC,KAAK,EAAE,SAAS,GAAG,SAAS,GAAG,SAAS,CAAA;IACjD,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,CAAA;CAC/B;AAED;;;;;;GAMG;AACH,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,yBAAyB,GAAG,MAAM,GAAG,SAAS,CAgBtF;AAED;;;;;;GAMG;AACH,wBAAgB,4BAA4B,CAC1C,OAAO,EAAE,uBAAuB,EAChC,UAAU,EAAE,SAAS,MAAM,EAAE,EAC7B,GAAG,EAAE,MAAM,GACV,iBAAiB,CAoBnB;AAqBD;;;GAGG;AACH,wBAAgB,sBAAsB,CAAC,CAAC,EAAE,SAAS,CAAC,iBAAiB,CAAC,EAAE,CAAC,EAAE,SAAS,CAAC,iBAAiB,CAAC,GAAG,SAAS,CAAC,iBAAiB,CAAC,CAkBrI;AAED,kCAAkC;AAClC,wBAAgB,YAAY,CAAC,SAAS,EAAE,SAAS,MAAM,EAAE,GAAG,SAAS,GAAG,MAAM,CAM7E;AAED;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,SAAS,CAAC,iBAAiB,CAAC,EAAE,OAAO,EAAE,kBAAkB,GAAG,MAAM,CAc1G;AAED;;;;;;;GAOG;AACH,wBAAgB,wBAAwB,CAAC,KAAK,EAAE;IAC9C,SAAS,EAAE,CAAC,QAAQ,EAAE,MAAM,IAAI,KAAK,MAAM,IAAI,CAAA;IAC/C,WAAW,EAAE,MAAM,uBAAuB,GAAG,SAAS,CAAA;IACtD,SAAS,CAAC,EAAE,uBAAuB,CAAA;CACpC,GAAG,gBAAgB,CAAC,uBAAuB,GAAG,SAAS,EAAE,iBAAiB,CAAC,CAkB3E"}

package/lib/types/client/legacy/waiting-review.js

@@ -0,0 +1,179 @@
+/**
+ * 过渡期适配器：dsh-gitea-dispatch 的「等待评审」→ facet。
+ *
+ * ⚠️ **本目录整体是临时的**。dsh-gitea-dispatch 自己按 `../facets.ts` 的协议注册之后
+ * （对应它的 issue「把摘要 API 升级为 facet 注册」），这个文件与 `schedule.ts`、
+ * `facet-icons.tsx` 一起删除，本插件不再认识任何具体状态源。
+ *
+ * 保留在 `legacy/` 而不是混进核心，是为了让"删除它"成为一次可执行的收尾，而不是一句
+ * 口头承诺：核心模块（`group-status.ts` / `badge-labels.ts` / `rows/GroupBadge.tsx`）
+ * 里没有任何 `waitingReview` 字样可寻。
+ *
+ * ## 为什么这里既读快照又自己折
+ *
+ * 提供方（issue #16）导出 `summarizeWaitingGroup()`。能用到就用它：id 口径、
+ * `overdue > waiting` 排序、截止时刻算法都是它的所有物，委托才不会再出现"提供方加了
+ * 字段而徽标不知道"的静默丢数据。它不导出（旧版本）时才用本文件的等价实现。
+ *
+ * @module dsh-group-status/client/legacy/waiting-review
+ */
+import { entryFor } from "../cross-plugin-summary.js";
+import { GROUP_STATUS_FACET_PROTOCOL_VERSION } from "../facets.js";
+/** facet id：与 dsh-gitea-dispatch 自己注册时应当使用的 id 保持一致。 */
+export const WAITING_REVIEW_FACET_ID = 'dsh-gitea-dispatch.waiting-review';
+/**
+ * 一条等待的绝对截止（epoch ms）；`undefined` = 时长未知。
+ *
+ * 刻意与提供方的 `deadlineOf` 同口径（绝对 deadline 优先，才退 `startedAt + waitMaxSec`）：
+ * CI 的等待从"进入循环"起算，而广播在此之前已发出，只按时长算会让徽标的倒计时晚于
+ * 真实截止（其 Issues #2577）。`startedAt` 的两种形态同理都要认。
+ */
+export function waitingDeadlineOf(entry) {
+    if (typeof entry.deadline === 'number' && Number.isFinite(entry.deadline))
+        return entry.deadline;
+    const started = typeof entry.startedAt === 'number'
+        ? entry.startedAt
+        : typeof entry.startedAt === 'string' && entry.startedAt !== ''
+            ? Date.parse(entry.startedAt)
+            : Number.NaN;
+    if (Number.isFinite(started)
+        && typeof entry.waitMaxSec === 'number'
+        && Number.isFinite(entry.waitMaxSec)
+        && entry.waitMaxSec > 0) {
+        return started + entry.waitMaxSec * 1000;
+    }
+    return undefined;
+}
+/**
+ * 提供方聚合面缺席时的等价折叠。
+ *
+ * 与提供方的 `summarizeWaitingGroup()` 同一套判据：四形态 id 兜底（复用
+ * `cross-plugin-summary.ts` 的 `entryFor`，规则与它的 `waitingEntryFor` 相同）、
+ * `overdue > waiting` 排序、只把**未到期**的截止算作 `nextDeadline`。
+ */
+export function summarizeWaitingGroupLocally(summary, sessionIds, now) {
+    const prNumbers = [];
+    let state;
+    let nextDeadline;
+    for (const sessionId of sessionIds) {
+        const entry = entryFor(summary, sessionId);
+        if (entry === undefined)
+            continue;
+        prNumbers.push(entry.prNumber);
+        if (entry.state === 'overdue')
+            state = 'overdue';
+        else if (state === undefined)
+            state = 'waiting';
+        const deadline = waitingDeadlineOf(entry);
+        // 已到点的条目由 `state: 'overdue'` 表达；把它算进倒计时会折出一个负数。
+        if (deadline !== undefined && deadline > now && (nextDeadline === undefined || deadline < nextDeadline)) {
+            nextDeadline = deadline;
+        }
+    }
+    const fold = { sessions: prNumbers.length, prNumbers, state };
+    // 用"缺键"而不是"键=undefined"对齐提供方：两条路径对下游必须不可区分。
+    if (nextDeadline !== undefined)
+        fold.nextDeadline = nextDeadline;
+    return fold;
+}
+/** 折果 `data` 的读取（本文件内部用）。 */
+function dataOf(fold) {
+    return fold.data ?? { prNumbers: [], state: undefined };
+}
+/** 把提供方的折果装进 facet 形状（数量 / 色档 / 脉冲）。 */
+function toFacetFold(source) {
+    const tone = source.state === 'overdue' ? 'error' : 'warn';
+    // 脉冲刻意不给等待评审的超时：提供方把 `overdue` 画成**静止**（其
+    // `lib/waiting-glyph.js`：「超时后停动画：静止即不再期待」），且它只代表 CI
+    // 窗口到期、不代表评审失败。同一条等待在行内静止、在父级闪动是两套说法。
+    // `nextDeadline` 缺键而不是 =undefined：与提供方的折果形状一致，也让两条折叠路径
+    // （委托 / 本地）对下游不可区分。
+    const data = source.nextDeadline === undefined
+        ? { prNumbers: source.prNumbers, state: source.state }
+        : { prNumbers: source.prNumbers, state: source.state, nextDeadline: source.nextDeadline };
+    return { count: source.sessions, tone, pulse: false, data };
+}
+/**
+ * 同 facet 跨层合并：PR 号取并集去重升序、色档取更紧急的一档、
+ * 倒计时取两侧更早的那个未到期截止。
+ */
+export function mergeWaitingReviewFold(a, b) {
+    const left = dataOf(a);
+    const right = dataOf(b);
+    const prNumbers = [...new Set([...left.prNumbers, ...right.prNumbers])].sort((x, y) => x - y);
+    const state = left.state === 'overdue' || right.state === 'overdue'
+        ? 'overdue'
+        : left.state ?? right.state;
+    const deadlines = [left.nextDeadline, right.nextDeadline].filter((v) => v !== undefined);
+    const nextDeadline = deadlines.length === 0 ? undefined : Math.min(...deadlines);
+    const data = nextDeadline === undefined
+        ? { prNumbers, state }
+        : { prNumbers, state, nextDeadline };
+    return {
+        count: a.count + b.count,
+        tone: state === 'overdue' ? 'error' : 'warn',
+        pulse: a.pulse || b.pulse,
+        data,
+    };
+}
+/** `#15, #2783(+2)`：去重升序、封顶三个。 */
+export function prNumberList(prNumbers) {
+    if (prNumbers === undefined || prNumbers.length === 0)
+        return '';
+    const distinct = [...new Set(prNumbers)].sort((a, b) => a - b);
+    const shown = distinct.slice(0, 3).map(pr => `#${pr}`);
+    if (distinct.length > shown.length)
+        shown.push(`+${distinct.length - shown.length}`);
+    return shown.join(', ');
+}
+/**
+ * 等待评审那一句文案：状态 + 剩余时长（分钟粒度）+ PR 号。
+ *
+ * 措辞与提供方自己的行内呈现同档（`等待评审 3:28` / `评审等待已超时` / `等待评审结果`），
+ * 但只到分钟：徽标只在提供方 store 通知时重渲染，秒级读数会停在旧值上撒谎。
+ */
+export function waitingReviewLabel(fold, context) {
+    const t = context.t;
+    const data = dataOf(fold);
+    const phrase = (() => {
+        if (data.state === 'overdue')
+            return t('status.waitingReviewOverdue');
+        const deadline = data.nextDeadline;
+        if (deadline === undefined)
+            return t('status.waitingReview');
+        const left = Math.max(0, deadline - context.now);
+        if (left < 60_000)
+            return t('status.waitingReviewImminent');
+        if (left < 3_600_000)
+            return t('status.waitingReviewLeft', { time: t('time.minutes', { n: Math.floor(left / 60_000) }) });
+        return t('status.waitingReviewLeft', { time: t('time.hours', { n: Math.floor(left / 3_600_000) }) });
+    })();
+    const prs = prNumberList(data.prNumbers);
+    return prs === '' ? `${fold.count} ${phrase}` : `${fold.count} ${phrase} · ${prs}`;
+}
+/**
+ * 构造本插件内置的等待评审 facet。
+ *
+ * @param input - 提供方的摘要读取面；`summarize` 缺席时退回本地等价折叠。
+ * @param input.subscribe - 订阅快照变化（提供方 store 的订阅面）。
+ * @param input.getSnapshot - 读当前摘要 Map。
+ * @param input.summarize - 提供方的分组聚合（有则委托）。
+ */
+export function createWaitingReviewFacet(input) {
+    const summarize = input.summarize ?? summarizeWaitingGroupLocally;
+    return {
+        protocol: GROUP_STATUS_FACET_PROTOCOL_VERSION,
+        id: WAITING_REVIEW_FACET_ID,
+        origin: 'legacy',
+        settingKey: 'showWaitingReviewInBadge',
+        order: 20,
+        subscribe: input.subscribe,
+        getSnapshot: input.getSnapshot,
+        fold: (snapshot, sessionIds, now) => toFacetFold(snapshot === undefined || sessionIds.length === 0
+            ? { sessions: 0, prNumbers: [], state: undefined }
+            : summarize(snapshot, sessionIds, now)),
+        merge: mergeWaitingReviewFold,
+        label: waitingReviewLabel,
+    };
+}
+//# sourceMappingURL=waiting-review.js.map

package/lib/types/client/legacy/waiting-review.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"waiting-review.js","sourceRoot":"","sources":["../../../../src/client/legacy/waiting-review.ts"],"names":[],"mappings":"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"}

package/lib/types/client/locales.d.ts

@@ -106,8 +106,7 @@ export declare const zh: {
     'status.compact.approval': string;
     'status.compact.planReview': string;
     'status.compact.answer': string;
-    'status.waitingReview': string;
-    'status.scheduled': string;
+    'status.needsAttention': string;
     'status.completed': string;
     'hover.created': string;
     'hover.copied': string;
@@ -247,8 +246,7 @@ export declare const en: {
     'status.compact.approval': string;
     'status.compact.planReview': string;
     'status.compact.answer': string;
-    'status.waitingReview': string;
-    'status.scheduled': string;
+    'status.needsAttention': string;
     'status.completed': string;
     'hover.created': string;
     'hover.copied': string;

package/lib/types/client/locales.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"locales.d.ts","sourceRoot":"","sources":["../../../src/client/locales.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,mEAAmE;AACnE,eAAO,MAAM,EAAE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAyImB,CAAA;AAElC,yCAAyC;AACzC,MAAM,MAAM,YAAY,GAAG,MAAM,OAAO,EAAE,CAAA;AAE1C,mEAAmE;AACnE,eAAO,MAAM,EAAE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAyIyB,CAAA"}
+{"version":3,"file":"locales.d.ts","sourceRoot":"","sources":["../../../src/client/locales.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,mEAAmE;AACnE,eAAO,MAAM,EAAE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAwImB,CAAA;AAElC,yCAAyC;AACzC,MAAM,MAAM,YAAY,GAAG,MAAM,OAAO,EAAE,CAAA;AAE1C,mEAAmE;AACnE,eAAO,MAAM,EAAE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAwIyB,CAAA"}