@deepseek-ai/dsh-client-ui-settings-account 0.2.1-alpha.4 → 0.2.1-alpha.5

package/README.i18n.yaml

@@ -15,8 +15,8 @@
   en: c26f81e8adf0128b
   zh: e11ab371f51f66bc
 /deepseek-ai-dsh-client-ui-settings-account/use-this-package:
-  en: a0e4b5bbef33ca6d
-  zh: 697978822aeddf6e
+  en: 45aa7b44d5424d9b
+  zh: 20c7d344c4e9bce0
 /deepseek-ai-dsh-client-ui-settings-account/use-this-package/desktop-onboarding:
   en: c1c4db71fd09ca13
   zh: a40c0a01e9951945

package/README.md

@@ -52,7 +52,7 @@ The account card’s More account information link has no underline and opens th
 
 Sign out first queries running account-token tasks and opens a confirmation dialog. The warning describes interruption when such tasks exist; otherwise it explains that data is retained and the account can be signed in again. Cancel, close, and Escape dismiss without signing out. Failed impact queries still open confirmation with an explicit unknown-task warning; failed sign-out keeps the dialog available for retry.
 
-A granted bonus appears as a server-authored notice above the sidebar account launcher without taking focus. The client reads the unnotified bonus when an account becomes active and once per Settings entry; it never polls. The server orders the candidates and owns the copy, so the client displays the first one and renders its message verbatim.
+A granted bonus appears as a server-authored notice above the sidebar account launcher without taking focus. The client reads the unnotified bonus when an account becomes active and once per Settings entry; it never polls. The server orders the candidates and owns the copy, so the client stacks every live notice in that order and renders its message verbatim. Only the foreground card is interactive and reports display for acknowledgement. Closing it promotes the next card with a 250ms ease-out position and scale transition, including changes in content height; reduced-motion preferences disable the transition. A server-supplied title replaces the localized bonus title; responses without title retain that default.
 
 The notice waits until Desktop onboarding no longer covers the workspace, including loading, completion saving, and the exit animation, and until model credential onboarding unmounts. Closing the application during onboarding leaves the bonus unacknowledged. In the main interface, the notice is painted as soon as the server offers it, including underneath the translucent settings panel, once the document is visible and the card has passed one presented frame. That painted frame is the whole display signal: the card measures no cover, so a card behind the open overlay counts exactly as any other, and closing the card counts as a display too. Displaying a card queues its acknowledgement, so one mounted card is acknowledged once. A failed acknowledgement retries with a capped backoff for the rest of the signed-in session and never surfaces as an account UI error. A read that fails leaves the visible card and its pending acknowledgement alone, so a transport reconnect keeps retrying. Nothing is written to browser storage. The second signed-in frame of one sign-in and a reconnected stream's replayed state are one session, not a new one, so they keep the card and its retries; signing out, replacing the credential with another account's, or unloading the plugin discards them. Identity-only updates do not reach the account UI stream. Every signed-in frame reads again, and a newer read supersedes one still in flight, so a credential swapped in place is named by a fresh read rather than inheriting the replaced account's; the batch's account id then drops the previous account's card and queue even with no intervening signed-out state. The next sign-in displays whatever the server still offers, including an order an earlier sign-in acknowledged, and a card the user has already seen stays up until it is closed, even when a later read returns no bonus.
 

package/README.zh.md

@@ -52,7 +52,7 @@ Chat 通过 `shell.overlay` 中的宿主把已绑定 Session 的实时欠费交
 
 退出登录先查询正在使用账号 token 的任务，再打开确认弹窗。有此类任务时提示执行将被打断，否则提示数据保留且可重新登录。取消、关闭和 Escape 均不退登。影响查询失败仍打开确认弹窗，并明确提示无法确认任务状态；退登失败保留弹窗以便重试。
 
-赠金到账时，侧栏账号入口上方显示一条由服务端提供文案的通知，不抢占焦点。客户端仅在账号进入登录态时、以及每次进入设置页时读取一次未通知赠金，不做轮询。候选顺序与文案均由服务端决定，客户端只展示第一条并原样渲染其消息。
+赠金到账时，侧栏账号入口上方显示一条由服务端提供文案的通知，不抢占焦点。客户端仅在账号进入登录态时、以及每次进入设置页时读取一次未通知赠金，不做轮询。候选顺序与文案均由服务端决定，客户端按该顺序层叠展示全部未过期通知并原样渲染消息。只有最前面的卡片可交互，并在实际展示后触发确认。关闭前卡后，下一张卡片通过 250ms ease-out 的位置与缩放过渡（包括内容高度变化）进入前台；偏好减少动态效果时禁用过渡。服务端提供的 title 替换本地化赠金标题；未返回 title 时沿用默认标题。
 
 通知等待 Desktop 引导界面不再遮盖主界面且模型凭证引导卸载后才展示，Desktop 引导的等待范围包括加载、完成时的保存和退出动画。在引导期间关闭应用不会确认赠金通知。进入主界面后，服务端返回即绘制通知，包括在设置面板的半透明蒙层之下；同时要求文档可见且卡片已完成一帧绘制。这一帧绘制就是全部的展示信号：卡片不检测遮挡，因此处于打开蒙层之下的卡片与其他情形同样计数，用户关闭卡片同样计入展示。卡片展示后即排队确认，因此同一张挂载的卡只确认一次。确认失败会在本次登录会话内按带上限的退避重试，且不会在账号界面报错。读取失败不会影响已展示的卡片及其待确认队列，因此连接重连后仍会继续重试。不写入浏览器存储。同一次登录的第二个登录态帧以及重连后重放的登录态属于同一会话而非新会话，因此保留卡片与重试；只有退出登录、凭证被换成另一账号，或卸载插件才会丢弃。仅身份信息更新不会进入账号界面订阅流。每个登录态帧都会重新读取，且新的读取会取代仍在进行中的旧读取，因此就地更换的凭证会由一次全新的读取来识别，而不会沿用被替换账号的读取结果；读取结果中的账号 ID 随后会丢弃上一个账号的卡片与队列，即使没有中间的退出登录状态。下一次登录会展示服务端仍然下发的内容，包括上一次登录已确认过的订单；用户已看到的卡片会保留到关闭为止，即使之后的读取没有返回赠金。
 

package/lib/client.js

@@ -1535,7 +1535,7 @@ window.__ModuleLoader__.load({
 		}
 		//#endregion
 		//#region \0dsh-css:/home/runner/work/deepseek-harness/deepseek-harness/packages/client/ui-settings-account/src/client/AccountNotice.module.css.mjs
-		const css$4 = ".zwW4-W_card{z-index:40;box-sizing:border-box;border:.5px solid var(--dsw-alias-border-l2-darkmode-thin);background:var(--dsw-specific-input-major);width:260px;max-width:calc(100vw - 16px);color:var(--dsw-alias-label-secondary);border-radius:16px;padding:20px;font-size:14px;line-height:22px;position:fixed;box-shadow:0 2px 4px #0000000d}.zwW4-W_copy{overflow-wrap:anywhere;flex-direction:column;gap:2px;display:flex}.zwW4-W_copy p{white-space:pre-wrap;margin:0}.zwW4-W_title{align-items:flex-start;gap:2px;font-weight:500;line-height:20px;display:flex}.zwW4-W_icon{width:14px;height:14px;color:var(--dsw-alias-brand-primary-new-colorprimary-new-color);flex:none;margin-top:1px;display:flex}.zwW4-W_close{width:18px;height:18px;color:var(--dsw-alias-label-caption);cursor:pointer;background:0 0;border:0;justify-content:center;align-items:center;padding:4px;display:flex;position:absolute;top:6px;right:6px}.zwW4-W_close:focus-visible{outline:2px solid var(--dsw-focus-ring-color,var(--dsw-alias-state-business-primary));outline-offset:2px;border-radius:4px}";
+		const css$4 = ".zwW4-W_stack{z-index:40;isolation:isolate;width:280px;max-width:calc(100vw - 16px);position:fixed}.zwW4-W_card{box-sizing:border-box;background:var(--dsw-specific-input-major);width:100%;box-shadow:var(--dsw-elevation-panel);color:var(--dsw-alias-label-secondary);z-index:calc(0 - var(--notice-depth));transform:translateY(calc(-4px * var(--notice-depth))) scaleX(var(--notice-scale));transform-origin:top;border:0;border-radius:16px;padding:20px;font-size:14px;line-height:22px;transition:transform .25s ease-out;position:relative}.zwW4-W_card[data-front=false]{pointer-events:none;height:100%;position:absolute;inset:0;overflow:hidden}@media (prefers-reduced-motion:reduce){.zwW4-W_card{transition:none}}.zwW4-W_copy{overflow-wrap:anywhere;flex-direction:column;gap:2px;display:flex}.zwW4-W_copy p{white-space:pre-wrap;margin:0}.zwW4-W_title{align-items:flex-start;gap:2px;font-weight:500;line-height:20px;display:flex}.zwW4-W_icon{width:14px;height:14px;color:var(--dsw-alias-brand-primary-new-colorprimary-new-color);flex:none;margin-top:1px;display:flex}.zwW4-W_close{width:18px;height:18px;color:var(--dsw-alias-label-caption);cursor:pointer;background:0 0;border:0;justify-content:center;align-items:center;padding:4px;display:flex;position:absolute;top:6px;right:6px}.zwW4-W_close:focus-visible{outline:2px solid var(--dsw-focus-ring-color,var(--dsw-alias-state-business-primary));outline-offset:2px;border-radius:4px}";
 		const tagId$4 = "@deepseek-ai/dsh-client-ui-settings-account/AccountNotice.module.css";
 		if (typeof document !== "undefined" && document.querySelector("style[data-plugin-css=" + JSON.stringify(tagId$4) + "]") === null) {
 			const tag = document.createElement("style");
@@ -1549,9 +1549,45 @@ window.__ModuleLoader__.load({
 			"close": "zwW4-W_close",
 			"copy": "zwW4-W_copy",
 			"icon": "zwW4-W_icon",
+			"stack": "zwW4-W_stack",
 			"title": "zwW4-W_title"
 		};
 		//#endregion
+		//#region lib/types/client/notice-transition.js
+		/** Animate a notification promotion across the old and new card dimensions. */
+		/**
+		* Close a card and animate surviving siblings from their currently displayed rectangles.
+		* @param card - mounted foreground card whose direct parent owns the stack.
+		* @param dismiss - synchronous notification-store update for the close gesture.
+		*/
+		function dismissNotice(card, dismiss) {
+			if (typeof card.animate !== "function" || getComputedStyle(card).transitionDuration === "0s") {
+				dismiss();
+				return;
+			}
+			const before = [...card.parentElement.querySelectorAll("aside")].map((element) => ({
+				element,
+				rect: element.getBoundingClientRect()
+			}));
+			for (const { element } of before) {
+				for (const animation of element.getAnimations()) animation.cancel();
+				element.style.transition = "none";
+			}
+			(0, react_dom.flushSync)(dismiss);
+			for (const { element, rect } of before) {
+				if (!element.isConnected) continue;
+				const transform = getComputedStyle(element).transform;
+				element.style.transform = "none";
+				const next = element.getBoundingClientRect();
+				element.style.transform = "";
+				element.animate([{ transform: `translate(${rect.x + rect.width / 2 - next.x - next.width / 2}px, ${rect.y - next.y}px) scale(${rect.width / next.width}, ${rect.height / next.height})` }, { transform }], {
+					duration: 250,
+					easing: "ease-out"
+				});
+				element.style.transition = "";
+			}
+		}
+		//#endregion
 		//#region lib/types/client/AccountNotice.js
 		/**
 		* Sidebar bonus notice. The card reports a display once it has a position, the
@@ -1563,6 +1599,7 @@ window.__ModuleLoader__.load({
 		*/
 		/** @param expiresAt - server expiration timestamp. @returns whether the award can still be spent. */
 		function live(expiresAt) {
+			if (expiresAt === "") return true;
 			const expires = Date.parse(expiresAt);
 			return Number.isNaN(expires) || expires > Date.now();
 		}
@@ -1590,19 +1627,18 @@ window.__ModuleLoader__.load({
 				if (timer !== void 0) clearTimeout(timer);
 			};
 		}
-		/** @param props - notice copy and identity, sidebar anchor, and display callbacks.
-		* @returns a non-modal notice above the account launcher until closed.
+		/** @param props - server-ordered notices, localized fallback copy, anchor, and display callbacks.
+		* @returns a non-modal stack whose foreground card alone can report display or be closed.
 		*/
-		function AccountNoticeCard({ notice, anchor, title, closeLabel, onShown, onDismiss }) {
+		function AccountNoticeStack({ notices, anchor, title, closeLabel, onShown, onDismiss }) {
 			const [position, setPosition] = (0, react.useState)();
-			const reported = (0, react.useRef)(false);
 			(0, react.useLayoutEffect)(() => {
-				if (!anchor.current || !live(notice.expiresAt)) return;
+				if (!anchor.current) return;
 				const element = anchor.current;
 				const update = () => {
 					const rect = element.getBoundingClientRect();
 					setPosition({
-						left: Math.max(8, Math.min(rect.left, window.innerWidth - 268)),
+						left: Math.max(8, Math.min(rect.left, window.innerWidth - 288)),
 						bottom: Math.max(8, window.innerHeight - rect.top + 4)
 					});
 				};
@@ -1616,13 +1652,28 @@ window.__ModuleLoader__.load({
 					window.removeEventListener("resize", update);
 					window.removeEventListener("scroll", update, true);
 				};
-			}, [
-				anchor,
-				notice.orderId,
-				notice.expiresAt
-			]);
+			}, [anchor]);
+			const liveNotices = notices.filter((notice) => live(notice.expiresAt));
+			return (0, react_dom.createPortal)((0, react_jsx_runtime.jsx)("div", {
+				className: AccountNotice_module_css_default.stack,
+				style: position ?? { visibility: "hidden" },
+				children: liveNotices.map((notice, depth) => (0, react_jsx_runtime.jsx)(NoticeCard, {
+					notice,
+					depth,
+					ready: position !== void 0,
+					title: notice.title ?? title,
+					closeLabel,
+					onShown,
+					onDismiss
+				}, notice.orderId))
+			}), document.body);
+		}
+		/** One stable card node remains mounted as the cards before it are dismissed. */
+		function NoticeCard({ notice, depth, ready, title, closeLabel, onShown, onDismiss }) {
+			const foreground = depth === 0;
+			const reported = (0, react.useRef)(false);
 			(0, react.useEffect)(() => {
-				if (position === void 0 || reported.current || !live(notice.expiresAt)) return;
+				if (!ready || !foreground || reported.current || !live(notice.expiresAt)) return;
 				let cancel;
 				const attempt = () => {
 					if (reported.current || cancel !== void 0 || !live(notice.expiresAt)) return;
@@ -1641,15 +1692,20 @@ window.__ModuleLoader__.load({
 					cancel?.();
 				};
 			}, [
-				position,
+				ready,
+				foreground,
 				notice.orderId,
 				notice.expiresAt,
 				onShown
 			]);
-			if (!live(notice.expiresAt)) return null;
-			return (0, react_dom.createPortal)((0, react_jsx_runtime.jsxs)("aside", {
+			return (0, react_jsx_runtime.jsxs)("aside", {
 				className: AccountNotice_module_css_default.card,
-				style: position ?? { visibility: "hidden" },
+				"data-front": foreground,
+				"aria-hidden": !foreground,
+				style: {
+					"--notice-depth": depth,
+					"--notice-scale": Math.pow(272 / 280, depth)
+				},
 				children: [(0, react_jsx_runtime.jsxs)("div", {
 					role: "status",
 					className: AccountNotice_module_css_default.copy,
@@ -1679,14 +1735,17 @@ window.__ModuleLoader__.load({
 					}), (0, react_jsx_runtime.jsx)("p", { children: notice.message })]
 				}), (0, react_jsx_runtime.jsx)("button", {
 					type: "button",
+					tabIndex: foreground ? void 0 : -1,
 					className: AccountNotice_module_css_default.close,
 					"aria-label": closeLabel,
-					onClick: () => {
-						onDismiss(notice.orderId);
+					onClick: (event) => {
+						dismissNotice(event.currentTarget.parentElement, () => {
+							onDismiss(notice.orderId);
+						});
 					},
 					children: (0, react_jsx_runtime.jsx)(_deepseek_ai_dsh_client_ui_primitives.IconCloseOutlineRegular, { size: 10 })
 				})]
-			}), document.body);
+			});
 		}
 		//#endregion
 		//#region \0dsh-css:/home/runner/work/deepseek-harness/deepseek-harness/packages/client/ui-settings-account/src/client/AccountMenu.module.css.mjs
@@ -1770,14 +1829,14 @@ window.__ModuleLoader__.load({
 							setExpiryNotice(false);
 						}
 					}),
-					signedIn && !account.desktopOnboardingVisible && !account.onboarding && account.notice && (0, react_jsx_runtime.jsx)(AccountNoticeCard, {
-						notice: account.notice,
+					signedIn && !account.desktopOnboardingVisible && !account.onboarding && account.notices && (0, react_jsx_runtime.jsx)(AccountNoticeStack, {
+						notices: account.notices,
 						anchor,
 						title: t("bonusNoticeTitle"),
 						closeLabel: t("close"),
 						onShown: bonusNoticeShown,
 						onDismiss: bonusNoticeDismissed
-					}, account.notice.orderId),
+					}),
 					(0, react_jsx_runtime.jsx)(_deepseek_ai_dsh_client_ui_primitives.Menu, {
 						open,
 						side: "top",
@@ -2605,6 +2664,7 @@ window.__ModuleLoader__.load({
 		* @returns whether the bonus can no longer be shown.
 		*/
 		function expired(expiresAt, at) {
+			if (expiresAt === "") return false;
 			const expires = Date.parse(expiresAt);
 			return !Number.isNaN(expires) && expires <= at;
 		}
@@ -2616,7 +2676,7 @@ window.__ModuleLoader__.load({
 		function createBonusNoticeController(options) {
 			let scope;
 			/** Notice currently published to the sidebar, including the expiration checked at display time. */
-			let current;
+			let current = [];
 			/** Newest read; an older read still in flight has its result dropped once a newer one starts. */
 			let readGeneration = 0;
 			let ackTimer;
@@ -2630,12 +2690,15 @@ window.__ModuleLoader__.load({
 					ackTimer = void 0;
 				}
 			};
-			const setCurrent = (notice) => {
-				if (notice === void 0 && current === void 0) return;
-				if (notice?.orderId === current?.orderId && notice?.message === current?.message && notice?.expiresAt === current?.expiresAt) return;
-				if (notice?.orderId !== current?.orderId) reported.clear();
-				current = notice;
-				options.publish(notice ?? null);
+			const setCurrent = (notices) => {
+				if (notices.length === current.length && notices.every((notice, index) => {
+					const previous = current[index];
+					return notice.orderId === previous?.orderId && notice.message === previous.message && notice.title === previous.title && notice.expiresAt === previous.expiresAt;
+				})) return;
+				const retained = new Set(notices.map((notice) => notice.orderId));
+				for (const orderId of reported) if (!retained.has(orderId)) reported.delete(orderId);
+				current = notices;
+				options.publish(notices);
 			};
 			const scheduleAck = (delay) => {
 				clearAckTimer();
@@ -2653,36 +2716,23 @@ window.__ModuleLoader__.load({
 				if (scope !== void 0 && scope.pending.length > 0) scheduleAck(0);
 			};
 			/**
-			* Apply one read result. A newly offered order replaces the on-screen card;
-			* an offer equal to the on-screen card refreshes its copy in place, and an
-			* empty batch leaves a card the user has already seen alone.
+			* Apply the server-ordered stack, excluding expired notices. An empty batch
+			* retains only the foreground card if the user has already seen it.
 			*/
 			const apply = (scopeAtRead, batch) => {
 				if (scopeAtRead.accountId !== batch.accountId) {
 					scopeAtRead.accountId = batch.accountId;
 					scopeAtRead.pending.length = 0;
 					resetAcks();
-					setCurrent(void 0);
+					setCurrent([]);
 				}
-				const candidate = batch.bonuses[0];
-				if (candidate === void 0) {
-					if (current !== void 0 && !reported.has(current.orderId)) setCurrent(void 0);
+				const candidates = batch.bonuses.filter((notice) => !expired(notice.expiresAt, Date.now()));
+				if (candidates.length === 0) {
+					const foreground = current[0];
+					setCurrent(foreground !== void 0 && reported.has(foreground.orderId) ? [foreground] : []);
 					return;
 				}
-				if (candidate.orderId === current?.orderId) {
-					setCurrent({
-						orderId: candidate.orderId,
-						message: candidate.message,
-						expiresAt: candidate.expiresAt
-					});
-					return;
-				}
-				if (expired(candidate.expiresAt, Date.now())) return;
-				setCurrent({
-					orderId: candidate.orderId,
-					message: candidate.message,
-					expiresAt: candidate.expiresAt
-				});
+				setCurrent(candidates);
 			};
 			/**
 			* Read once for one live lifecycle. A newer read supersedes one in flight: the
@@ -2742,7 +2792,7 @@ window.__ModuleLoader__.load({
 			/** Queue a presented order, so an acknowledgement interrupted by a failure retries within this sign-in. */
 			const report = (orderId) => {
 				const scopeAtReport = scope;
-				if (scopeAtReport === void 0 || current?.orderId !== orderId || reported.has(orderId)) return;
+				if (scopeAtReport === void 0 || current[0]?.orderId !== orderId || reported.has(orderId)) return;
 				reported.add(orderId);
 				if (!scopeAtReport.pending.includes(orderId)) scopeAtReport.pending.push(orderId);
 				ackDelay = options.ackRetryDelayMs;
@@ -2753,7 +2803,7 @@ window.__ModuleLoader__.load({
 				resetAcks();
 				scope = void 0;
 				reported.clear();
-				setCurrent(void 0);
+				setCurrent([]);
 			};
 			return {
 				begin() {
@@ -2767,14 +2817,15 @@ window.__ModuleLoader__.load({
 					return runRead(scope);
 				},
 				shown(orderId) {
-					if (current?.orderId !== orderId) return;
-					if (expired(current.expiresAt, Date.now())) return;
+					setCurrent(current.filter((notice) => !expired(notice.expiresAt, Date.now())));
+					if (current[0]?.orderId !== orderId) return;
 					report(orderId);
 				},
 				dismiss(orderId) {
-					if (current?.orderId !== orderId) return;
+					setCurrent(current.filter((notice) => !expired(notice.expiresAt, Date.now())));
+					if (current[0]?.orderId !== orderId) return;
 					report(orderId);
-					setCurrent(void 0);
+					setCurrent(current.slice(1).filter((notice) => !expired(notice.expiresAt, Date.now())));
 				}
 			};
 		}
@@ -4410,7 +4461,7 @@ window.__ModuleLoader__.load({
 				avatar.dispose();
 			}, "account: profile picture lifetime");
 			/** @returns the client identity for one account call, read at call time so it carries the language and zone in effect then. */
-			const client = () => accountClientMetadata(ctx.locale.getSnapshot().active, "0.2.1-alpha.4");
+			const client = () => accountClientMetadata(ctx.locale.getSnapshot().active, "0.2.1-alpha.5");
 			const notices = createBonusNoticeController({
 				ackRetryDelayMs: config.bonusAckRetryDelayMs,
 				ackRetryMaxDelayMs: config.bonusAckRetryMaxDelayMs,
@@ -4424,11 +4475,11 @@ window.__ModuleLoader__.load({
 					if (!result.ok) throw new Error("account bonus acknowledgement failed");
 					return result.value;
 				},
-				publish: (notice) => {
-					const { notice: _replaced, ...withoutNotice } = snapshot;
-					publish(notice === null ? withoutNotice : {
-						...withoutNotice,
-						notice
+				publish: (notices) => {
+					const { notices: _replaced, ...withoutNotices } = snapshot;
+					publish(notices.length === 0 ? withoutNotices : {
+						...withoutNotices,
+						notices
 					});
 				}
 			});
@@ -4492,14 +4543,14 @@ window.__ModuleLoader__.load({
 					refreshing = void 0;
 					avatar.reset();
 					const initialize = frame.value.status === "credential-stored" && frame.value.attempt?.phase === "succeeded" && snapshot.view?.attempt?.phase !== "succeeded";
-					const { notice, ...previous } = snapshot;
+					const { notices: previousNotices, ...previous } = snapshot;
 					publish({
 						...previous,
 						view: frame.value,
 						details: void 0,
 						avatar: void 0,
 						failed: false,
-						...frame.value.status === "credential-stored" && notice ? { notice } : {}
+						...frame.value.status === "credential-stored" && previousNotices ? { notices: previousNotices } : {}
 					});
 					browser.update(frame.value);
 					frame.accept();
@@ -4552,7 +4603,7 @@ window.__ModuleLoader__.load({
 					const profile = snapshot.details?.profile;
 					const context = {
 						uid: profile?.status === "ready" ? profile.value.id : null,
-						version: "0.2.1-alpha.4",
+						version: "0.2.1-alpha.5",
 						width: window.screen.width,
 						height: window.screen.height,
 						pixelRatio: window.devicePixelRatio

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

@@ -8,17 +8,17 @@
  */
 import { type RefObject } from 'react';
 import type { BonusNotice } from './bonus-notices.ts';
-/** @param props - notice copy and identity, sidebar anchor, and display callbacks.
- * @returns a non-modal notice above the account launcher until closed.
+/** @param props - server-ordered notices, localized fallback copy, anchor, and display callbacks.
+ * @returns a non-modal stack whose foreground card alone can report display or be closed.
  */
-export declare function AccountNoticeCard({ notice, anchor, title, closeLabel, onShown, onDismiss }: {
-    notice: BonusNotice;
+export declare function AccountNoticeStack({ notices, anchor, title, closeLabel, onShown, onDismiss }: {
+    notices: readonly BonusNotice[];
     anchor: RefObject<HTMLElement>;
     title: string;
     closeLabel: string;
-    /** Called once, after the visible card has passed a presented frame. */
+    /** Called after the foreground card has passed a visible presented frame. */
     onShown: (orderId: BonusNotice['orderId']) => void;
-    /** Called when the user closes the card, which counts as having seen it. */
+    /** Called when the user closes the foreground card. */
     onDismiss: (orderId: BonusNotice['orderId']) => void;
-}): import("react").ReactPortal | null;
+}): import("react").ReactPortal;
 //# sourceMappingURL=AccountNotice.d.ts.map

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

@@ -6,8 +6,8 @@ import type { AccountAvatarSnapshot } from './account-avatar.ts';
 import type { BonusNotice } from './bonus-notices.ts';
 /** Safe account snapshot shared by the settings page and launcher. */
 export interface AccountSnapshot {
-    /** Server-authored bonus notice awaiting display, absent when none is available. */
-    notice?: BonusNotice;
+    /** Server-authored notices in front-to-back order, absent when none are available. */
+    notices?: readonly BonusNotice[];
     /** Latest Host state, absent until the stream responds. */
     view: AccountView | undefined;
     /** Sanitized profile and balance query outcomes, absent while loading. */

package/lib/types/client/bonus-notices.d.ts

@@ -1,10 +1,10 @@
 /**
- * Lifecycle of bonus notices: one displayed notice at a time, one read result in
+ * Lifecycle of bonus notices: one foreground card in a stack, one read result in
  * force at a time, and one acknowledgement per displayed card. Reads happen when
  * the account becomes active and when the user asks for a refresh, never on a
  * timer; the server owns which bonus is unnotified and what its copy says.
  *
- * An order is acknowledged once its card reports a presented frame: the card has
+ * An order is acknowledged once its foreground card reports a presented frame: the card has
  * a position, the document is visible, and it painted one frame. The card measures
  * no cover, so a card painted under the open Settings overlay reports like any
  * other, and closing the card counts as a display too.
@@ -20,11 +20,13 @@
 import type { AccountBonusBatch, AccountBonusOrderId, AccountUserId } from '@deepseek-ai/dsh-deepseek-account/types';
 /** Notice eligible for display; the message is server-authored for the active locale. */
 export interface BonusNotice {
+    /** Server-localized plain-text title; absent responses use the localized bonus title. */
+    readonly title?: string;
     /** Server order identity. */
     readonly orderId: AccountBonusOrderId;
     /** Server-localized plain text, including any award amount or expiration. */
     readonly message: string;
-    /** Server expiration, re-checked at display time so a notice cannot appear after its award expired. */
+    /** Server expiration, re-checked at display time; an empty string means no expiration. */
     readonly expiresAt: string;
 }
 /** Deployment-varying acknowledgement retry timings. */
@@ -45,8 +47,8 @@ export interface BonusNoticeControllerOptions extends BonusNoticeTiming {
      * @returns false when the account changed or signed out; a protocol failure rejects.
      */
     acknowledge: (accountId: AccountUserId, orderId: AccountBonusOrderId) => Promise<boolean>;
-    /** @param notice - notice to display, or null when none is shown. */
-    publish: (notice: BonusNotice | null) => void;
+    /** @param notices - notices in front-to-back order; empty when none are shown. */
+    publish: (notices: readonly BonusNotice[]) => void;
 }
 /** Commands the account plugin issues to the bonus notice lifecycle. */
 export interface BonusNoticeController {

package/lib/types/client/notice-transition.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Close a card and animate surviving siblings from their currently displayed rectangles.
+ * @param card - mounted foreground card whose direct parent owns the stack.
+ * @param dismiss - synchronous notification-store update for the close gesture.
+ */
+export declare function dismissNotice(card: HTMLElement, dismiss: () => void): void;
+//# sourceMappingURL=notice-transition.d.ts.map

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@deepseek-ai/dsh-client-ui-settings-account",
   "description": "Manage DeepSeek login and open Platform billing pages",
-  "version": "0.2.1-alpha.4",
+  "version": "0.2.1-alpha.5",
   "publishConfig": {
     "access": "public"
   },
@@ -45,27 +45,27 @@
   },
   "devDependencies": {
     "@deepseek-ai/cordis": "~4.0.5-alpha.2",
-    "@deepseek-ai/dsh-api-remotes": "0.2.1-alpha.4",
-    "@deepseek-ai/dsh-client-locale": "0.2.1-alpha.4",
-    "@deepseek-ai/dsh-client-store": "0.2.1-alpha.4",
-    "@deepseek-ai/dsh-client-test-runtime": "0.2.1-alpha.4",
-    "@deepseek-ai/dsh-client-ui-chat": "0.2.1-alpha.4",
-    "@deepseek-ai/dsh-client-ui-layout": "0.2.1-alpha.4",
-    "@deepseek-ai/dsh-client-ui-primitives": "0.2.1-alpha.4",
-    "@deepseek-ai/dsh-client-ui-renderer": "0.2.1-alpha.4",
-    "@deepseek-ai/dsh-client-ui-settings": "0.2.1-alpha.4",
-    "@deepseek-ai/dsh-client-ui-slots": "0.2.1-alpha.4",
-    "@deepseek-ai/dsh-client-ui-theme": "0.2.1-alpha.4",
-    "@deepseek-ai/dsh-deepseek-account": "0.2.1-alpha.4",
-    "@deepseek-ai/dsh-settings": "0.2.1-alpha.4",
+    "@deepseek-ai/dsh-api-remotes": "0.2.1-alpha.5",
+    "@deepseek-ai/dsh-client-locale": "0.2.1-alpha.5",
+    "@deepseek-ai/dsh-client-store": "0.2.1-alpha.5",
+    "@deepseek-ai/dsh-client-test-runtime": "0.2.1-alpha.5",
+    "@deepseek-ai/dsh-client-ui-chat": "0.2.1-alpha.5",
+    "@deepseek-ai/dsh-client-ui-layout": "0.2.1-alpha.5",
+    "@deepseek-ai/dsh-client-ui-primitives": "0.2.1-alpha.5",
+    "@deepseek-ai/dsh-client-ui-renderer": "0.2.1-alpha.5",
+    "@deepseek-ai/dsh-client-ui-settings": "0.2.1-alpha.5",
+    "@deepseek-ai/dsh-client-ui-slots": "0.2.1-alpha.5",
+    "@deepseek-ai/dsh-client-ui-theme": "0.2.1-alpha.5",
+    "@deepseek-ai/dsh-deepseek-account": "0.2.1-alpha.5",
+    "@deepseek-ai/dsh-settings": "0.2.1-alpha.5",
     "@testing-library/react": "^16.3.3",
     "@types/big.js": "^6.2.2",
     "react": "^18.2.0",
     "react-dom": "^18.2.0",
-    "@deepseek-ai/dsh-client-ui-settings-models": "0.2.1-alpha.4",
-    "@deepseek-ai/dsh-host-webserver": "0.2.1-alpha.4",
+    "@deepseek-ai/dsh-client-ui-settings-models": "0.2.1-alpha.5",
+    "@deepseek-ai/dsh-host-webserver": "0.2.1-alpha.5",
     "big.js": "^7.0.1",
-    "@deepseek-ai/dsh-client-product-analytics": "0.2.1-alpha.4"
+    "@deepseek-ai/dsh-client-product-analytics": "0.2.1-alpha.5"
   },
   "files": [
     "locale/*.json",