gloomberb 0.17.1 → 0.17.2

package/src/{plugins/builtin/cloud/team → team}/collections-sync.ts

@@ -4,12 +4,12 @@ import {
   type TeamCollection,
   type TeamCollectionEvent,
   type TeamCollectionItem,
-} from "../../../../api-client";
-import type { AppTickerRepositoryPort } from "../../../../core/app-service-ports";
-import type { AppAction, AppState } from "../../../../core/state/app/types";
-import { useAppDispatch, useAppSelector, useAppStateRef } from "../../../../state/app/context";
-import type { TickerRecord } from "../../../../types/ticker";
-import { debugLog } from "../../../../utils/debug-log";
+} from "../api-client";
+import type { AppTickerRepositoryPort } from "../core/app-service-ports";
+import type { AppAction, AppState } from "../core/state/app/types";
+import { useAppDispatch, useAppSelector, useAppStateRef } from "../state/app/context";
+import type { TickerRecord } from "../types/ticker";
+import { debugLog } from "../utils/debug-log";
 import {
   applyMembership,
   blankTickerRecord,

package/src/{plugins/builtin/cloud/team → team}/collections.ts

@@ -1,6 +1,6 @@
-import type { TeamCollection, TeamCollectionItem } from "../../../../api-client";
-import type { AppConfig } from "../../../../types/config";
-import type { Portfolio, TickerRecord, Watchlist } from "../../../../types/ticker";
+import type { TeamCollection, TeamCollectionItem } from "../api-client";
+import type { AppConfig } from "../types/config";
+import type { Portfolio, TickerRecord, Watchlist } from "../types/ticker";
 
 const TEAM_COLLECTION_PREFIX = "team:";
 

package/src/{plugins/builtin/cloud/team → team}/model.ts

@@ -4,8 +4,8 @@ import type {
   TeamRole,
   TeamSummary,
   TeamUser,
-} from "../../../../api-client";
-import { blendHex, colors } from "../../../../theme/colors";
+} from "../api-client";
+import { blendHex, colors } from "../theme/colors";
 
 const TEAM_CHANNEL_PREFIX = "team:";
 

package/src/{plugins/builtin/cloud/team → team}/pane-request.ts

@@ -1,4 +1,4 @@
-import { createPaneRequestChannel } from "../../shared/pane-request";
+import { createPaneRequestChannel } from "../plugins/builtin/shared/pane-request";
 
 export type TeamPaneSection = "members" | "invites" | "channels" | "settings";
 

package/src/{plugins/builtin/cloud/team → team}/store.ts

@@ -4,9 +4,9 @@ import {
   type TeamReceivedInvitation,
   type TeamSummary,
   type TeamUpdatedEvent,
-} from "../../../../api-client";
-import type { AppNotificationDelivery, AppNotificationRequest, PluginPersistence } from "../../../../types/plugin";
-import { markNotificationLogReadByRef } from "../../../../notifications/notification-log";
+} from "../api-client";
+import type { AppNotificationDelivery, AppNotificationRequest, PluginPersistence } from "../types/plugin";
+import { markNotificationLogReadByRef } from "../notifications/notification-log";
 import { describeTeamNotification, findTeam, teamIdFromChannelId, teamNotificationRefId } from "./model";
 
 export interface TeamStoreSnapshot {

package/src/types/data-provider.ts

@@ -2,6 +2,7 @@ import type { ExchangeRateSnapshot } from "./exchange-rate";
 import type {
   AnalystResearchData,
   CorporateActionsData,
+  EarningsEpsBasis,
   Quote,
   QuoteMetadata,
   TickerFinancials,
@@ -94,6 +95,8 @@ export interface EarningsEvent {
   epsRevisionDown7d?: number | null;
   epsRevisionDown30d?: number | null;
   epsActual: number | null;
+  /** "adjusted" when the estimate is the consensus on the adjusted basis the company's reports are on (a REIT's FFO), not a GAAP forecast. */
+  epsBasis?: EarningsEpsBasis | null;
   revenueEstimate: number | null;
   revenueLow?: number | null;
   revenueHigh?: number | null;

package/src/types/financials.ts

@@ -870,4 +870,10 @@ export interface OptionsChain {
   realtimeEligible?: boolean;
   /** ISO timestamp for the upstream options snapshot. */
   asOf?: string;
+  /**
+   * The session the chain's open interest counts, YYYY-MM-DD, as Gloom Cloud
+   * states it; null when none of its counts is dated. Absent from a source
+   * that does not say (an older server, another provider).
+   */
+  openInterestAsOf?: string | null;
 }

package/src/utils/decimal-comma.ts

@@ -18,6 +18,24 @@ export function numberErrorMessage(message: string, value: unknown): string {
   return dotted == null ? message : `${message.replace(/\.$/, "")}; use a dot: ${dotted}`;
 }
 
+const DECIMAL_COMMA_RANGE = /^([+-]?\d+(?:,\d+)?)\s*(-|to|\.\.)\s*([+-]?\d+(?:,\d+)?)$/i;
+
+/**
+ * A range typed with decimal commas, `0,80-0,90`, as the dotted range to type
+ * instead (`0.80-0.90`); null when neither end has a decimal comma.
+ */
+function dottedDecimalRange(value: unknown): string | null {
+  const match = DECIMAL_COMMA_RANGE.exec(typeof value === "string" ? value.trim() : "");
+  if (!match || !`${match[1]}${match[3]}`.includes(",")) return null;
+  return `${match[1]!.replace(",", ".")}${match[2]}${match[3]!.replace(",", ".")}`;
+}
+
+/** `numberErrorMessage` for a range of two numbers: "... got "0,80-0,90"; use a dot: 0.80-0.90". */
+export function rangeErrorMessage(message: string, value: unknown): string {
+  const dotted = dottedDecimalRange(value);
+  return dotted == null ? message : `${message.replace(/\.$/, "")}; use a dot: ${dotted}`;
+}
+
 /** What a number pasted from a sheet reads as. */
 export type PastedNumber =
   | { kind: "number"; value: number }

package/src/utils/exchanges.ts

@@ -104,6 +104,11 @@ export const CANONICAL_EXCHANGE_ALIASES: Record<string, string> = {
   XPRA: "PSE",
   VIE: "VIE",
   XWBO: "VIE",
+  // The Vienna MTF, Wiener Boerse's multilateral trading facility, which Gloom
+  // Cloud names by its segment MIC. Its ETPs and notes are its own listings.
+  WBDM: "WBDM",
+  "VIENNA MTF": "WBDM",
+  VMTF: "WBDM",
   TPE: "TWSE",
   TWSE: "TWSE",
   TAI: "TWSE",
@@ -276,6 +281,7 @@ export const EXCHANGE_TIME_ZONES: Record<string, string> = {
   WSE: "Europe/Warsaw",
   PSE: "Europe/Prague",
   VIE: "Europe/Vienna",
+  WBDM: "Europe/Vienna",
   TPEX: "Asia/Taipei",
   TWSE: "Asia/Taipei",
   NSE: "Asia/Kolkata",
@@ -347,6 +353,7 @@ const EXCHANGE_NAMES: Record<string, string> = {
   WSE: "Warsaw Stock Exchange",
   PSE: "Prague Stock Exchange",
   VIE: "Vienna Stock Exchange",
+  WBDM: "Vienna MTF",
   TWSE: "Taiwan Stock Exchange",
   TPEX: "Taipei Exchange",
   NSE: "National Stock Exchange of India",

package/src/utils/forward-dividend.ts

@@ -1,14 +1,44 @@
 /**
  * What a forward dividend yield is everywhere it shows (fundamentals, DVD):
- * the indicated annual rate Gloom Cloud serves, the latest regular
- * distribution annualized, over the price. It is dated by that
- * distribution's ex-date.
+ * the indicated annual rate Gloom Cloud serves over the price, dated by the
+ * ex-date of the distribution it annualizes. While no other is announced that
+ * is the latest distribution, whose ex-date has passed. Once the next one is
+ * declared the rate annualizes it, and its ex-date is still ahead: the basis
+ * then names the declared distribution by its ex-date and pay date, never a
+ * rate "as of" a day that has not come.
  */
-const FORWARD_DIVIDEND_BASIS = "latest distribution annualized";
+const LATEST_DISTRIBUTION = "latest distribution annualized";
 
-/** `latest distribution annualized, as of 2026-10-01`; the basis alone when the date is unknown. */
-export function forwardDividendBasis(asOf: string | Date | null | undefined): string {
-  const text = asOf instanceof Date ? (Number.isFinite(asOf.getTime()) ? asOf.toISOString() : "") : asOf ?? "";
-  const date = /^\d{4}-\d{2}-\d{2}/.test(text) ? text.slice(0, 10) : null;
-  return date ? `${FORWARD_DIVIDEND_BASIS}, as of ${date}` : FORWARD_DIVIDEND_BASIS;
+/** `2026-10-01` from a date or an ISO text; null when it is neither. */
+function isoDay(value: string | Date | null | undefined): string | null {
+  const text = value instanceof Date ? (Number.isFinite(value.getTime()) ? value.toISOString() : "") : value ?? "";
+  return /^\d{4}-\d{2}-\d{2}/.test(text) ? text.slice(0, 10) : null;
+}
+
+/** A rate dated by an ex-date after today annualizes a distribution declared and not yet gone ex. */
+function isDeclared(exDate: string | null, now: Date): exDate is string {
+  return exDate != null && exDate > now.toISOString().slice(0, 10);
+}
+
+/**
+ * `latest distribution annualized, as of 2026-08-20`, or for a rate dated
+ * ahead, `annualized from the declared distribution payable 2026-12-10, ex
+ * 2026-11-19`; the basis alone when the date is unknown. `payDate` is the pay
+ * date stated beside that ex-date, for a source that pairs them.
+ */
+export function forwardDividendBasis(
+  asOf: string | Date | null | undefined,
+  options: { payDate?: string | Date | null; now?: Date } = {},
+): string {
+  const exDate = isoDay(asOf);
+  if (!isDeclared(exDate, options.now ?? new Date())) return exDate ? `${LATEST_DISTRIBUTION}, as of ${exDate}` : LATEST_DISTRIBUTION;
+  const payDate = isoDay(options.payDate);
+  return `annualized from the declared distribution${payDate ? ` payable ${payDate}` : ""}, ex ${exDate}`;
+}
+
+/** The same basis as a pane's short note under the figure: `as of 2026-08-20`, or `declared` beside the next ex-date it shows. */
+export function forwardDividendNote(asOf: string | Date | null | undefined, now = new Date()): string | null {
+  const exDate = isoDay(asOf);
+  if (!exDate) return null;
+  return isDeclared(exDate, now) ? "declared" : `as of ${exDate}`;
 }

package/src/utils/option-expiry.ts

@@ -124,3 +124,19 @@ export function missingExpiryText(requested: number, expirations: readonly numbe
     ? `no option contracts returned for${subject ? ` ${subject}` : ""} expiry ${date}; nearest others: ${choices}`
     : `no expiry ${date}${of}; available: ${choices}`;
 }
+
+/**
+ * How a command fails on an expiry the chain cannot show: `options --expiration`
+ * and `fn OMON --expiration` print the same error, with the command that lists
+ * every expiry as its advice line.
+ */
+export function missingExpiryMessage(
+  symbol: string,
+  requested: number,
+  expirations: readonly number[],
+): { message: string; details: string } {
+  return {
+    message: missingExpiryText(requested, expirations, symbol),
+    details: `Run gloomberb options ${symbol} to list every expiry (--json carries them too).`,
+  };
+}

package/src/utils/sec.ts

@@ -37,7 +37,8 @@ function isEquityType(value?: string): boolean {
 
 const FUND_TYPES = new Set(["ETF", "ETP", "FUND", "MUTUALFUND", "CEF", "CLOSEDEND", "CLOSEDENDFUND"]);
 
-function isFundType(value?: string): boolean {
+/** An instrument type that names a fund (ETF, closed-end fund), which reports no earnings of its own. */
+export function isFundType(value?: string): boolean {
   return FUND_TYPES.has(normalize(value).replace(/[\s_-]/g, ""));
 }