gloomberb 0.16.0 → 0.16.2

package/src/i18n/ko.ts

@@ -3,6 +3,7 @@
  * Keep finance terminology precise and translations concise for dense layouts.
  */
 export const ko: Record<string, string> = {
+  "NAV · as of {date}": "NAV · {date} 기준",
   // ── Common UI ────────────────────────────────────────────────
   "Back": "뒤로",
   "Done": "완료",
@@ -376,7 +377,6 @@ export const ko: Record<string, string> = {
   "Price trigger alerts with notifications": "알림이 있는 목표가 알림",
   "Create a price alert from a symbol, condition, and target price": "종목코드, 조건 및 목표가로 가격 알림 생성",
   "Public market heatmap for the largest US stocks and ETFs.": "미국 대형주 및 ETF 시장 히트맵.",
-  "Largest US stocks and ETFs, sized by market cap or assets and colored by daily move.": "미국 대형주와 ETF를 시가총액·자산 규모 및 일일 변동률로 표시.",
   "Top gainers, losers, most active, and trending tickers": "상승률·하락률·거래량 상위 및 인기 종목",
   "Top gainers, losers, most active, and trending tickers.": "상승률·하락률·거래량 상위 및 인기 종목.",
   "S&P 500 sector and industry performance via ETF proxies": "ETF 기준 S&P 500 섹터 및 산업 성과",
@@ -523,7 +523,7 @@ export const ko: Record<string, string> = {
   "Quit the terminal app.": "터미널 앱을 종료합니다.",
   "Copy the active terminal selection.": "활성 터미널 선택을 복사합니다.",
   "Paste clipboard text into the active input.": "클립보드 텍스트를 활성 입력에 붙여넣습니다.",
-  "Install an available app update when one is shown.": "사용 가능한 앱 업데이트가 표시되면 설치하세요.",
+  "Restart into a downloaded app update, or retry one that failed.": "다운로드한 업데이트로 다시 시작하거나, 실패한 업데이트를 다시 시도합니다.",
   "Close the focused pane, docked or floating.": "도킹 또는 플로팅된 포커스 패널을 닫습니다.",
   "Close all floating panes.": "모든 플로팅 패널을 닫습니다.",
   "Edit settings for the focused pane.": "포커스 패널 설정을 편집합니다.",
@@ -835,7 +835,22 @@ export const ko: Record<string, string> = {
   "Recent users": "최근 사용자",
   "No recent users": "최근 사용자 없음",
   "Enter at least one @username.": "@username을 하나 이상 입력하세요.",
-  "Could not start conversation.": "대화를 시작할 수 없습니다.",
+  "@{username} only takes DMs from people they have written to first.": "@{username}님은 먼저 메시지를 보낸 상대의 DM만 받습니다.",
+  "@{username} does not take DMs.": "@{username}님은 DM을 받지 않습니다.",
+  "@{username} was not found.": "@{username}님을 찾을 수 없습니다.",
+  "{usernames} were not found.": "{usernames}님을 찾을 수 없습니다.",
+  "One of those users was not found.": "찾을 수 없는 사용자가 있습니다.",
+  "Someone in that group only takes DMs from people they have written to first.": "이 그룹에 먼저 메시지를 보낸 상대의 DM만 받는 사람이 있습니다.",
+  "Could not start the conversation (error {status}).": "대화를 시작할 수 없습니다 (오류 {status}).",
+  "Could not start the conversation. Check your connection and try again.": "대화를 시작할 수 없습니다. 연결을 확인하고 다시 시도하세요.",
+  "no DMs": "DM 불가",
+  "Only takes DMs from people they have written to first.": "먼저 메시지를 보낸 상대의 DM만 받습니다.",
+  "Does not take DMs.": "DM을 받지 않습니다.",
+  "Message @{username}": "@{username}님에게 메시지",
+  "Open DM with @{username}": "@{username}님과의 DM 열기",
+  "Message": "메시지",
+  "Open DM": "DM 열기",
+  "Show Profile": "프로필 보기",
   "Starting": "시작 중",
   "Start": "시작",
 
@@ -955,7 +970,9 @@ export const ko: Record<string, string> = {
 
   // ── Main dashboard ──────────────────────────────────────────
   "Installing update...": "업데이트 설치 중...",
-  "Update installed, restart to apply": "업데이트 설치 완료. 적용하려면 다시 시작하세요",
+  "Update ready, restart to apply": "업데이트 준비 완료. 적용하려면 다시 시작하세요",
+  "Update ready": "업데이트 준비 완료",
+  "Restart": "다시 시작",
   "Checking for updates...": "업데이트 확인 중...",
   "Downloading v{version}: {percent}%": "v{version} 다운로드 중: {percent}%",
   "Update failed: {error}": "업데이트 실패: {error}",
@@ -970,6 +987,9 @@ export const ko: Record<string, string> = {
   "Minimize": "최소화",
   "Maximize": "최대화",
   "Pane unavailable.": "패널을 사용할 수 없습니다.",
+  "{title} stopped working.": "{title}이(가) 작동을 멈췄습니다.",
+  "Reload pane": "패널 다시 불러오기",
+  "Close pane": "패널 닫기",
   "Cash & Margin": "현금·증거금",
   "No non-zero cash balances.": "표시할 현금 잔액이 없습니다.",
   "adding...": "추가 중...",

package/src/i18n/zh-cn.ts

@@ -5,6 +5,7 @@
  * fixed-width terminal layouts stay readable.
  */
 export const zhCN: Record<string, string> = {
+  "NAV · as of {date}": "NAV · 截至{date}",
   // ── Common UI ────────────────────────────────────────────────
   "Back": "返回",
   "Done": "完成",
@@ -378,7 +379,6 @@ export const zhCN: Record<string, string> = {
   "Price trigger alerts with notifications": "带通知的价格触发提醒",
   "Create a price alert from a symbol, condition, and target price": "用代码、条件和目标价创建价格提醒",
   "Public market heatmap for the largest US stocks and ETFs.": "美股大盘股与 ETF 的市场热力图。",
-  "Largest US stocks and ETFs, sized by market cap or assets and colored by daily move.": "按市值/规模定大小、按日涨跌着色的美股与 ETF。",
   "Top gainers, losers, most active, and trending tickers": "涨幅榜、跌幅榜、成交活跃与热门股票",
   "Top gainers, losers, most active, and trending tickers.": "涨幅榜、跌幅榜、成交活跃与热门股票。",
   "S&P 500 sector and industry performance via ETF proxies": "以 ETF 代理呈现的标普 500 板块与行业表现",
@@ -525,7 +525,7 @@ export const zhCN: Record<string, string> = {
   "Quit the terminal app.": "退出终端应用。",
   "Copy the active terminal selection.": "复制当前终端选中内容。",
   "Paste clipboard text into the active input.": "把剪贴板文本粘贴到当前输入框。",
-  "Install an available app update when one is shown.": "有可用更新提示时安装更新。",
+  "Restart into a downloaded app update, or retry one that failed.": "使用已下载的更新重启，或重试失败的更新。",
   "Close the focused pane, docked or floating.": "关闭聚焦面板（停靠或浮动）。",
   "Close all floating panes.": "关闭所有浮动面板。",
   "Edit settings for the focused pane.": "编辑聚焦面板的设置。",
@@ -837,7 +837,22 @@ export const zhCN: Record<string, string> = {
   "Recent users": "最近联系人",
   "No recent users": "没有最近联系人",
   "Enter at least one @username.": "至少输入一个 @用户名。",
-  "Could not start conversation.": "无法开始会话。",
+  "@{username} only takes DMs from people they have written to first.": "@{username} 只接收自己先联系过的人的私信。",
+  "@{username} does not take DMs.": "@{username} 不接收私信。",
+  "@{username} was not found.": "找不到 @{username}。",
+  "{usernames} were not found.": "找不到 {usernames}。",
+  "One of those users was not found.": "其中有用户不存在。",
+  "Someone in that group only takes DMs from people they have written to first.": "该群组中有人只接收自己先联系过的人的私信。",
+  "Could not start the conversation (error {status}).": "无法开始会话（错误 {status}）。",
+  "Could not start the conversation. Check your connection and try again.": "无法开始会话。请检查网络连接后重试。",
+  "no DMs": "不收私信",
+  "Only takes DMs from people they have written to first.": "只接收自己先联系过的人的私信。",
+  "Does not take DMs.": "不接收私信。",
+  "Message @{username}": "私信 @{username}",
+  "Open DM with @{username}": "打开与 @{username} 的私信",
+  "Message": "发私信",
+  "Open DM": "打开私信",
+  "Show Profile": "查看资料",
   "Starting": "正在开始",
   "Start": "开始",
 
@@ -957,7 +972,9 @@ export const zhCN: Record<string, string> = {
 
   // ── Main dashboard ──────────────────────────────────────────
   "Installing update...": "正在安装更新...",
-  "Update installed, restart to apply": "更新已安装，重启后生效",
+  "Update ready, restart to apply": "更新已就绪，重启后生效",
+  "Update ready": "更新已就绪",
+  "Restart": "重启",
   "Checking for updates...": "正在检查更新...",
   "Downloading v{version}: {percent}%": "正在下载 v{version}：{percent}%",
   "Update failed: {error}": "更新失败：{error}",
@@ -972,6 +989,9 @@ export const zhCN: Record<string, string> = {
   "Minimize": "最小化",
   "Maximize": "最大化",
   "Pane unavailable.": "面板不可用。",
+  "{title} stopped working.": "{title} 已停止工作。",
+  "Reload pane": "重新加载面板",
+  "Close pane": "关闭面板",
   "Cash & Margin": "现金与保证金",
   "No non-zero cash balances.": "没有非零现金余额。",
   "adding...": "添加中...",

package/src/i18n/zh-tw.ts

@@ -5,6 +5,7 @@
  * fixed-width terminal layouts stay readable.
  */
 export const zhTW: Record<string, string> = {
+  "NAV · as of {date}": "NAV · 截至{date}",
   // ── Common UI ────────────────────────────────────────────────
   "Back": "返回",
   "Done": "完成",
@@ -378,7 +379,6 @@ export const zhTW: Record<string, string> = {
   "Price trigger alerts with notifications": "透過通知的價格觸發提醒",
   "Create a price alert from a symbol, condition, and target price": "用代號、條件和目標價建立價格提醒",
   "Public market heatmap for the largest US stocks and ETFs.": "美股大盤股與 ETF 的市場熱力圖。",
-  "Largest US stocks and ETFs, sized by market cap or assets and colored by daily move.": "按市值/規模定大小、按日漲跌著色的美股與 ETF。",
   "Top gainers, losers, most active, and trending tickers": "漲幅榜、跌幅榜、成交活躍與熱門股票",
   "Top gainers, losers, most active, and trending tickers.": "漲幅榜、跌幅榜、成交活躍與熱門股票。",
   "S&P 500 sector and industry performance via ETF proxies": "以 ETF 代表 S&P 500 類股與產業表現",
@@ -525,7 +525,7 @@ export const zhTW: Record<string, string> = {
   "Quit the terminal app.": "結束終端機應用程式。",
   "Copy the active terminal selection.": "複製目前終端機選取內容。",
   "Paste clipboard text into the active input.": "將剪貼簿文字貼到目前的輸入欄位。",
-  "Install an available app update when one is shown.": "有可用更新提示時安裝更新。",
+  "Restart into a downloaded app update, or retry one that failed.": "使用已下載的更新重新啟動，或重試失敗的更新。",
   "Close the focused pane, docked or floating.": "關閉聚焦面板（停靠或浮動）。",
   "Close all floating panes.": "關閉所有浮動面板。",
   "Edit settings for the focused pane.": "編輯聚焦面板的設定。",
@@ -837,7 +837,22 @@ export const zhTW: Record<string, string> = {
   "Recent users": "最近聯絡人",
   "No recent users": "沒有最近聯絡人",
   "Enter at least one @username.": "至少輸入一個 @username。",
-  "Could not start conversation.": "無法開始對話。",
+  "@{username} only takes DMs from people they have written to first.": "@{username} 只接收自己先聯絡過的人的私訊。",
+  "@{username} does not take DMs.": "@{username} 不接收私訊。",
+  "@{username} was not found.": "找不到 @{username}。",
+  "{usernames} were not found.": "找不到 {usernames}。",
+  "One of those users was not found.": "其中有使用者不存在。",
+  "Someone in that group only takes DMs from people they have written to first.": "該群組中有人只接收自己先聯絡過的人的私訊。",
+  "Could not start the conversation (error {status}).": "無法開始對話（錯誤 {status}）。",
+  "Could not start the conversation. Check your connection and try again.": "無法開始對話。請檢查網路連線後再試一次。",
+  "no DMs": "不收私訊",
+  "Only takes DMs from people they have written to first.": "只接收自己先聯絡過的人的私訊。",
+  "Does not take DMs.": "不接收私訊。",
+  "Message @{username}": "私訊 @{username}",
+  "Open DM with @{username}": "開啟與 @{username} 的私訊",
+  "Message": "傳私訊",
+  "Open DM": "開啟私訊",
+  "Show Profile": "查看個人資料",
   "Starting": "正在開始",
   "Start": "開始",
 
@@ -957,7 +972,9 @@ export const zhTW: Record<string, string> = {
 
   // ── Main dashboard ──────────────────────────────────────────
   "Installing update...": "正在安裝更新...",
-  "Update installed, restart to apply": "更新已安裝，重新啟動後生效",
+  "Update ready, restart to apply": "更新已就緒，重新啟動後生效",
+  "Update ready": "更新已就緒",
+  "Restart": "重新啟動",
   "Checking for updates...": "正在檢查更新...",
   "Downloading v{version}: {percent}%": "正在下載 v{version}：{percent}%",
   "Update failed: {error}": "更新失敗：{error}",
@@ -972,6 +989,9 @@ export const zhTW: Record<string, string> = {
   "Minimize": "最小化",
   "Maximize": "最大化",
   "Pane unavailable.": "面板不可用。",
+  "{title} stopped working.": "{title} 已停止運作。",
+  "Reload pane": "重新載入面板",
+  "Close pane": "關閉面板",
   "Cash & Margin": "現金與保證金",
   "No non-zero cash balances.": "沒有非零的現金餘額。",
   "adding...": "新增中...",

package/src/layout/ticker-navigation.ts

@@ -22,8 +22,8 @@ export function listVisibleTickerSourcePanes(
 }
 
 /**
- * Whether the pane menu may link this pane to a ticker source (`PaneDef.tickerFollower`). A source
- * never follows: its own cursor symbol would win over the binding.
+ * Whether the pane menu may link this pane to another pane's ticker (`PaneDef.tickerFollower`).
+ * A source never follows: its own cursor symbol would win over the binding.
  */
 export function canFollowTickerSource(
   instance: PaneInstanceConfig,
@@ -34,6 +34,32 @@ export function canFollowTickerSource(
   return typeof def.tickerFollower === "function" ? def.tickerFollower(instance) : def.tickerFollower === true;
 }
 
+/**
+ * A single-ticker pane other panes can follow. Lists and scanners stay sources; Ticker Research
+ * follows the same rule as any pane flagged `tickerFollower`.
+ */
+export function isTickerLinkPeer(
+  instance: PaneInstanceConfig,
+  panes: ReadonlyMap<string, PaneDef>,
+): boolean {
+  return instance.paneId === TICKER_RESEARCH_PANE_ID || canFollowTickerSource(instance, panes);
+}
+
+/** True when `fromInstanceId`'s follow chain reaches `targetInstanceId`. */
+export function followBindingReaches(
+  layout: LayoutConfig,
+  fromInstanceId: string,
+  targetInstanceId: string,
+  seen = new Set<string>(),
+): boolean {
+  if (seen.has(fromInstanceId)) return false;
+  seen.add(fromInstanceId);
+  const instance = findPaneInstance(layout, fromInstanceId);
+  if (instance?.binding?.kind !== "follow") return false;
+  const next = instance.binding.sourceInstanceId;
+  return next === targetInstanceId || followBindingReaches(layout, next, targetInstanceId, seen);
+}
+
 /** The visible Ticker Research pane that follows `sourceInstanceId`, if any. */
 export function findTickerResearchFollower(
   layout: LayoutConfig,

package/src/market-data/coordinator/chart.ts

@@ -57,7 +57,7 @@ export function normalizeFreshChartData(
     interval: interval ?? undefined }) ?? undefined;
   if (
     isIntradayChartRequest(request, history)
-    && isPriceHistoryStaleForCurrentWindow(normalized, Date.now(), { exchange: target.exchange,
+    && isPriceHistoryStaleForCurrentWindow(normalized, Date.now(), { symbol: target.symbol, exchange: target.exchange,
       intervalMs: interval ? priceHistoryIntervalMs(interval) : undefined, session })
   ) {
     return [];

package/src/market-data/coordinator/quotes.ts

@@ -113,13 +113,24 @@ export async function loadQuoteEntry({
       const attempts = [createAttempt(source, startedAt, "success")];
       return quoteStore.update(key, (current) => readyQuoteEntry(current, resolvedQuote, source, attempts, { keepNewerHeldQuote: true }));
     } catch (error) {
-      const classified = classifyError(error);
-      const attempt = createAttempt(dataProvider.id, startedAt, EXPECTED_EMPTY.test(classified.message) ? "empty" : "fatal_error", classified.reasonCode, classified.message);
-      return quoteStore.update(key, (current) => errorEntry(current, attempt));
+      return storeQuoteFailure(quoteStore, key, dataProvider.id, startedAt, error);
     }
   });
 }
 
+function storeQuoteFailure(
+  quoteStore: QueryStore<Quote>,
+  key: string,
+  providerId: string,
+  startedAt: number,
+  error: unknown,
+): QueryEntry<Quote> {
+  const classified = classifyError(error);
+  const status = EXPECTED_EMPTY.test(classified.message) ? "empty" : "fatal_error";
+  const attempt = createAttempt(providerId, startedAt, status, classified.reasonCode, classified.message);
+  return quoteStore.update(key, (current) => errorEntry(current, attempt));
+}
+
 interface LoadQuoteBatchEntriesOptions {
   dataProvider: DataProvider;
   instruments: InstrumentRef[];
@@ -152,14 +163,22 @@ export async function loadQuoteBatchEntries({
   }
 
   if (misses.length > 0 && dataProvider.getQuotesBatch) {
+    const startedAt = Date.now();
     const batchResults = await dataProvider.getQuotesBatch(
       misses.map((instrument) => quoteTargetFromInstrument(instrument)),
       { forceRefresh: options.forceRefresh },
     );
     batchResults.forEach((item, index) => {
       const instrument = misses[index];
-      if (!instrument || !item.quote) return;
+      if (!instrument) return;
       const key = buildQuoteKey(instrument);
+      if (!item.quote) {
+        // The batch already asked for this one, one by one where the batch
+        // answer fell short, and says why it failed. Asking again here would
+        // only send the same request a second time.
+        if (item.error != null) results.set(key, storeQuoteFailure(quoteStore, key, dataProvider.id, startedAt, item.error));
+        return;
+      }
       const quote = resolveQuote?.(instrument, item.quote) ?? item.quote;
       const source = quote.providerId ?? dataProvider.id;
       const attempts = [createAttempt(source, Date.now(), "success")];

package/src/market-data/fx-closes.ts

@@ -0,0 +1,72 @@
+import type { CloudMarketResponse, CloudPricePointPayload } from "../api-client/types";
+import type { FxLeg } from "./coordinator/fx-legs";
+
+/** USD per unit of one currency at each completed daily FX close, by date. */
+export interface FxCloses {
+  currency: string;
+  closes: ReadonlyMap<string, number>;
+  first: string;
+  asOf: string;
+}
+
+/** Why a daily FX history cannot be used: no usable closes, or none in the last week. */
+export class FxHistoryError extends Error {
+  constructor(readonly problem: "unavailable" | "stale") {
+    super(problem === "stale" ? "Daily FX history is stale" : "Daily FX history unavailable");
+    this.name = "FxHistoryError";
+  }
+}
+
+const DAY_MS = 86_400_000;
+/** A pair's latest completed close older than this is stale; a weekend and a holiday fit well inside it. */
+const FX_MAX_AGE_DAYS = 7;
+
+const isDay = (value: string) => /^\d{4}-\d{2}-\d{2}$/.test(value) && Number.isFinite(Date.parse(value))
+  && new Date(value).toISOString().slice(0, 10) === value;
+
+/**
+ * Completed daily closes of the pair as USD per unit, today's still-trading
+ * bar left out. A malformed row, two different closes on one date, or more
+ * rows than asked for rejects the whole history rather than a part of it.
+ */
+export function dailyFxCloses(
+  response: CloudMarketResponse<CloudPricePointPayload[]>,
+  leg: FxLeg,
+  now = new Date(),
+  maxRows = 1500,
+): FxCloses {
+  if (response.status !== "success" || !Array.isArray(response.data) || response.data.length < 2) throw new FxHistoryError("unavailable");
+  if (response.stale || response.providerMeta?.stale) throw new FxHistoryError("stale");
+  if (response.data.length > maxRows) throw new FxHistoryError("unavailable");
+  const today = now.toISOString().slice(0, 10);
+  const closes = new Map<string, number>();
+  for (const row of response.data) {
+    if (!row || typeof row.date !== "string" || !Number.isFinite(Date.parse(row.date)) || !isDay(row.date.slice(0, 10))
+      || !Number.isFinite(row.close) || row.close <= 0) throw new FxHistoryError("unavailable");
+    const date = new Date(row.date).toISOString().slice(0, 10);
+    if (date >= today) continue;
+    const rate = leg.invert ? 1 / row.close : row.close;
+    const previous = closes.get(date);
+    if (previous != null && previous !== rate) throw new FxHistoryError("unavailable");
+    closes.set(date, rate);
+  }
+  const dates = [...closes.keys()].sort();
+  const asOf = dates.at(-1);
+  if (!asOf || Date.parse(today) - Date.parse(asOf) > FX_MAX_AGE_DAYS * DAY_MS) throw new FxHistoryError("stale");
+  return { currency: leg.currency, closes, first: dates[0]!, asOf };
+}
+
+/**
+ * The last completed close on or before `date` (YYYY-MM-DD), looking back at
+ * most a week so a weekend or holiday finds the close before it but a gap in
+ * the history is not bridged.
+ */
+export function fxCloseOnOrBefore(fx: FxCloses, date: string): { date: string; rate: number } | null {
+  const end = Date.parse(`${(date < fx.asOf ? date : fx.asOf)}T00:00:00Z`);
+  for (let back = 0; back <= FX_MAX_AGE_DAYS; back++) {
+    const day = new Date(end - back * DAY_MS).toISOString().slice(0, 10);
+    const rate = fx.closes.get(day);
+    if (rate != null) return { date: day, rate };
+  }
+  return null;
+}

package/src/market-data/market/freshness.ts

@@ -1,5 +1,6 @@
 import type { MarketState } from "../../types/financials";
 import { canonicalExchange, EXCHANGE_TIME_ZONES, isUsListingExchange } from "../../utils/exchanges";
+import { hasPublishedApacCalendar, isPublishedApacClosure } from "../published-apac-sessions";
 import { hasPublishedCnCalendar, isPublishedCnClosure } from "../published-cn-sessions";
 import { hasPublishedJpxCalendar, isPublishedJpxClosure } from "../published-jpx-sessions";
 import { hasPublishedNseCalendar, isPublishedNseClosure } from "../published-nse-sessions";
@@ -11,6 +12,9 @@ const ALWAYS_OPEN_EXCHANGES = new Set(["CCC"]);
 const MS_PER_DAY = 24 * 60 * 60 * 1000;
 const OVERNIGHT_CLOSE_MAX_AGE_MS = 20 * 60 * 60 * 1000;
 const ALWAYS_OPEN_MAX_AGE_MS = 2 * 60 * 60 * 1000;
+// Spring Festival can put the previous session twelve calendar days back
+// (TWSE, February 2026).
+const SESSION_LOOKBACK_DAYS = 14;
 const REGULAR_OPEN_MINUTES: Record<string, number> = {
   NASDAQ: 9 * 60 + 30,
   NYSE: 9 * 60 + 30,
@@ -72,6 +76,28 @@ const REGULAR_CLOSE_MINUTES: Record<string, number> = {
   NZX: 17 * 60, SSE: 15 * 60 + 30, SZSE: 15 * 60 + 30,
   BMV: 15 * 60 + 10, B3: 18 * 60 + 30, BYMA: 17 * 60 + 10, JSE: 17 * 60 + 15, TASE: 17 * 60 + 40,
 };
+// Venues that pause at midday, as local minutes [start, end), with a zone for
+// those the session tables above do not cover. Jakarta pauses longer on Fridays.
+const MIDDAY_BREAKS: Record<string, {
+  timeZone?: string;
+  weekdays: readonly [number, number];
+  friday?: readonly [number, number];
+}> = {
+  HKEX: { weekdays: [12 * 60, 13 * 60] },
+  SGX: { weekdays: [12 * 60, 13 * 60] },
+  SSE: { weekdays: [11 * 60 + 30, 13 * 60] },
+  SZSE: { weekdays: [11 * 60 + 30, 13 * 60] },
+  JPX: { weekdays: [11 * 60 + 30, 12 * 60 + 30] },
+  BURSAMY: { timeZone: "Asia/Kuala_Lumpur", weekdays: [12 * 60 + 30, 14 * 60 + 30] },
+  JAKARTA: { timeZone: "Asia/Jakarta", weekdays: [12 * 60, 13 * 60 + 30], friday: [11 * 60 + 30, 14 * 60] },
+};
+// A morning print this close to the break is its last one, and afternoon
+// prints are due this long after the feed's lag has passed the reopening.
+const MIDDAY_BREAK_MARGIN_MS = 5 * 60_000;
+// How far the delayed feed runs behind each venue's trades.
+const DELAYED_FEED_LAG_MS = 15 * 60_000;
+const SLOWER_DELAYED_FEED_LAG_MS = 20 * 60_000;
+const SLOWER_DELAYED_FEEDS = new Set(["ASX", "KRX", "KOSDAQ", "TWSE", "TPEX", "SGX", "NZX"]);
 const exchangeLocalTimeFormatters = new Map<string, Intl.DateTimeFormat>();
 const usSessionFormatter = new Intl.DateTimeFormat("en-US", {
   timeZone: "America/New_York",
@@ -159,6 +185,7 @@ function isPublishedClosure(exchange: string, date: string): boolean {
   if (exchange === "JPX") return isPublishedJpxClosure(date);
   if (exchange === "NSE" || exchange === "BSE") return isPublishedNseClosure(date);
   if (exchange === "SSE" || exchange === "SZSE") return isPublishedCnClosure(date);
+  if (isPublishedApacClosure(exchange, date)) return true;
   return getPublishedUsEquityCalendarDay(exchange, date) === "closed";
 }
 
@@ -207,9 +234,7 @@ export function latestRegularSessionClose(
   if (!timeZone || ALWAYS_OPEN_EXCHANGES.has(canonical) || !Number.isFinite(time)) return null;
   const { year, month, day } = zonedDateTimeParts(time, timeZone);
   const today = Date.UTC(year, month - 1, day) / MS_PER_DAY;
-  // Spring Festival can put the previous session eleven calendar days back.
-  const lookback = (canonical === "SSE" || canonical === "SZSE") && hasPublishedCnCalendar(year) ? 14 : 10;
-  for (let offset = 0; offset <= lookback; offset++) {
+  for (let offset = 0; offset <= SESSION_LOOKBACK_DAYS; offset++) {
     const date = new Date((today - offset) * MS_PER_DAY).toISOString().slice(0, 10);
     const published = getPublishedUsEquitySession(canonical, date);
     let close: number | null = null;
@@ -225,6 +250,20 @@ export function latestRegularSessionClose(
   return null;
 }
 
+/**
+ * The UTC minute of the day the venue's regular session closed, for the latest
+ * session at or before `time` (20:00 UTC is 1200 while New York is on daylight
+ * time). Null for round-the-clock venues and for venues whose close hour is
+ * not listed, which `latestRegularSessionClose` would take to close at local
+ * midnight.
+ */
+export function regularSessionCloseUtcMinute(exchange: string | undefined, time: number): number | null {
+  const canonical = canonicalExchange(exchange);
+  if (REGULAR_CLOSE_MINUTES[canonical] === undefined) return null;
+  const close = latestRegularSessionClose(canonical, time);
+  return close ? Math.floor(close.close / 60_000) % 1440 : null;
+}
+
 /**
  * The open of the regular session `time` falls in, or of the latest one
  * before it: the published calendar for US venues, otherwise the venue's
@@ -238,8 +277,7 @@ export function latestRegularSessionOpen(exchange: string | undefined, time: num
   const minutes = REGULAR_OPEN_MINUTES[canonical];
   const { year, month, day } = zonedDateTimeParts(time, timeZone);
   const today = Date.UTC(year, month - 1, day) / MS_PER_DAY;
-  const lookback = (canonical === "SSE" || canonical === "SZSE") && hasPublishedCnCalendar(year) ? 14 : 10;
-  for (let offset = 0; offset <= lookback; offset++) {
+  for (let offset = 0; offset <= SESSION_LOOKBACK_DAYS; offset++) {
     const date = new Date((today - offset) * MS_PER_DAY).toISOString().slice(0, 10);
     const published = getPublishedUsEquitySession(canonical, date);
     let open: number | null = null;
@@ -270,7 +308,8 @@ export function isRegularSessionTime(exchange: string | undefined, time: number)
 
 /**
  * True when the venue's full-day closures for the year of `date` are
- * published: US venues, JPX, NSE, BSE, SSE and SZSE. Elsewhere a local holiday reads as a weekday.
+ * published: US venues, JPX, NSE, BSE, SSE, SZSE, KRX, KOSDAQ, TWSE, TPEX,
+ * HKEX, SGX and ASX. Elsewhere a local holiday reads as a weekday.
  */
 export function hasPublishedSessionCalendar(exchange: string | undefined, date: string): boolean {
   const canonical = canonicalExchange(exchange);
@@ -278,9 +317,42 @@ export function hasPublishedSessionCalendar(exchange: string | undefined, date:
   if (canonical === "JPX") return hasPublishedJpxCalendar(year);
   if (canonical === "NSE" || canonical === "BSE") return hasPublishedNseCalendar(year);
   if (canonical === "SSE" || canonical === "SZSE") return hasPublishedCnCalendar(year);
+  if (hasPublishedApacCalendar(canonical, year)) return true;
   return !!getPublishedUsEquityCalendarYears(canonical)?.includes(year);
 }
 
+/** How far the delayed feed runs behind the venue's trades. */
+export function delayedFeedLagMs(exchange: string | undefined): number {
+  return SLOWER_DELAYED_FEEDS.has(canonicalExchange(exchange)) ? SLOWER_DELAYED_FEED_LAG_MS : DELAYED_FEED_LAG_MS;
+}
+
+/**
+ * Whether a print is still the current price because the venue is paused at
+ * midday: `now` falls in the break, or within the feed's lag plus five
+ * minutes after it, and the print is the morning's last, no earlier than five
+ * minutes before the break started. An earlier morning print means the feed
+ * stopped before the break.
+ */
+export function isMiddayBreakPrint(
+  timestampMs: number,
+  exchange: string | undefined,
+  now: number,
+  feedLagMs: number,
+): boolean {
+  const canonical = canonicalExchange(exchange);
+  const pause = MIDDAY_BREAKS[canonical];
+  const timeZone = pause?.timeZone ?? EXCHANGE_TIME_ZONES[canonical];
+  if (!pause || !timeZone || !Number.isFinite(timestampMs) || !Number.isFinite(now) || timestampMs > now) return false;
+  const { year, month, day } = zonedDateTimeParts(now, timeZone);
+  const weekday = new Date(Date.UTC(year, month - 1, day)).getUTCDay();
+  if (weekday === 0 || weekday === 6) return false;
+  const [start, end] = weekday === 5 && pause.friday ? pause.friday : pause.weekdays;
+  const at = (minutes: number) => zonedWallClockToUtcMs(timeZone, year, month, day, Math.floor(minutes / 60), minutes % 60, 0);
+  const breakStart = at(start);
+  return now >= breakStart && now <= at(end) + feedLagMs + MIDDAY_BREAK_MARGIN_MS
+    && timestampMs >= breakStart - MIDDAY_BREAK_MARGIN_MS;
+}
+
 function usSessionState(timestampMs: number): UsSessionState {
   const minute = Math.floor(timestampMs / 60_000);
   return perMinute(usSessionCache, minute, () => formatUsSessionState(minute * 60_000));

package/src/market-data/market/session-close-note.ts

@@ -0,0 +1,57 @@
+import { canonicalExchange } from "../../utils/exchanges";
+import { futuresListingVenue } from "../../utils/futures-generic";
+import { regularSessionCloseUtcMinute } from "./freshness";
+
+interface SessionLeg {
+  symbol: string;
+  /** The listing's exchange; without one the close is unknown and no note is made. */
+  exchange?: string;
+  /** What the reader typed, when it differs from the symbol. */
+  label?: string;
+}
+
+const MINUTES_PER_DAY = 1440;
+/** Crypto and FX carry no regular session. */
+const ALWAYS_OPEN_EXCHANGES = new Set(["CCC", "CCY"]);
+
+const clock = (minute: number) => `${String(Math.floor(minute / 60) % 24).padStart(2, "0")}:${String(minute % 60).padStart(2, "0")}`;
+
+function offsetText(minutes: number): string {
+  const hours = Math.floor(minutes / 60);
+  const rest = minutes % 60;
+  return [hours ? `${hours} h` : "", rest ? `${rest} min` : ""].filter(Boolean).join(" ");
+}
+
+/**
+ * Where a daily bar of the listing falls on its date. A venue with a listed
+ * regular close closes at that UTC time. Crypto, FX and futures carry a bar
+ * dated 00:00 UTC, which closes when the next UTC day starts. A venue with
+ * neither is unknown.
+ */
+function dailyBarClose(leg: SessionLeg, time: number): { minute: number; text: string } | null {
+  const label = leg.label ?? leg.symbol;
+  const minute = regularSessionCloseUtcMinute(leg.exchange, time);
+  if (minute !== null) return { minute, text: `${label} closes ${clock(minute)} UTC` };
+  const exchange = canonicalExchange(leg.exchange);
+  return exchange && (ALWAYS_OPEN_EXCHANGES.has(exchange) || futuresListingVenue(leg.symbol, exchange))
+    ? { minute: MINUTES_PER_DAY, text: `${label} bar is ${clock(0)} UTC` }
+    : null;
+}
+
+/**
+ * One line for a daily pair whose two sides close at different times, such as
+ * a US equity against crypto, or null when they close together (two US
+ * equities) or a close is not known. Daily closes pair by UTC date, so a
+ * reader of a correlation or ratio should know the two prices are not taken
+ * at the same moment. `dateKey` is the date the pair is read on, which
+ * settles daylight time.
+ */
+export function mixedSessionCloseNote(left: SessionLeg, right: SessionLeg, dateKey?: string | null): string | null {
+  const parsed = dateKey ? Date.parse(`${dateKey}T23:59:59Z`) : Number.NaN;
+  const time = Number.isFinite(parsed) ? parsed : Date.now();
+  const a = dailyBarClose(left, time);
+  const b = dailyBarClose(right, time);
+  if (!a || !b) return null;
+  const offset = Math.abs(a.minute - b.minute);
+  return offset === 0 ? null : `${a.text}; ${b.text} (${offsetText(offset)} offset). Daily pairs are matched by date.`;
+}