gloomberb 0.20.13 → 0.20.14

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (155) hide show
  1. package/package.json +2 -1
  2. package/patches/@opentui%2Fcore@0.3.2.patch +22 -4
  3. package/src/account/auth-dialog.tsx +22 -4
  4. package/src/account/auth-form.tsx +6 -1
  5. package/src/account/checkout-handoff.tsx +7 -14
  6. package/src/account/device-signin-dialog.tsx +35 -24
  7. package/src/api-client/crypto-markets.ts +10 -0
  8. package/src/api-client/errors.ts +3 -1
  9. package/src/api-client/money-markets.ts +7 -0
  10. package/src/api-client/request.ts +12 -2
  11. package/src/architecture/floating-promise-allowlist.json +0 -1
  12. package/src/brokers/signed-in/sign-in-dialog.tsx +38 -38
  13. package/src/cli/commands/market.ts +95 -23
  14. package/src/cli/commands/overview.ts +18 -4
  15. package/src/cli/errors.ts +3 -1
  16. package/src/cli/freshness.ts +7 -2
  17. package/src/cli/glossary.ts +10 -5
  18. package/src/cli/helpers.ts +8 -16
  19. package/src/cli/history-export.ts +4 -0
  20. package/src/cli/known-gaps.ts +2 -2
  21. package/src/cli/listing-arg.ts +79 -11
  22. package/src/cli/not-a-ticker.ts +4 -0
  23. package/src/cli/pane-functions/catalog.ts +29 -8
  24. package/src/cli/pane-functions/headless.ts +5 -2
  25. package/src/cli/pane-functions/options.ts +7 -0
  26. package/src/cli/pane-functions/resolver.ts +61 -15
  27. package/src/cli/result.ts +22 -4
  28. package/src/cli/symbol-args.ts +5 -3
  29. package/src/cli/symbol-list.ts +23 -10
  30. package/src/cli/symbol-rows.ts +135 -3
  31. package/src/cli/treasury-yields.ts +15 -1
  32. package/src/components/chart/composite/format.ts +2 -1
  33. package/src/components/chart/composite/panel-surface/axis-markers.ts +133 -0
  34. package/src/components/chart/composite/panel-surface/level-labels.tsx +78 -0
  35. package/src/components/chart/composite/panel-surface/overlays.ts +108 -0
  36. package/src/components/chart/composite/panel-surface/pan-coast.ts +54 -0
  37. package/src/components/chart/composite/panel-surface/panel-cursor.tsx +138 -0
  38. package/src/components/chart/composite/panel-surface/panel-levels.ts +47 -0
  39. package/src/components/chart/composite/panel-surface/plot-gestures.ts +403 -0
  40. package/src/components/chart/composite/panel-surface/plot-pointer.ts +65 -0
  41. package/src/components/chart/composite/panel-surface/plot-wheel.ts +102 -0
  42. package/src/components/chart/composite/panel-surface/pointer.ts +12 -0
  43. package/src/components/chart/composite/panel-surface/props.ts +79 -0
  44. package/src/components/chart/composite/panel-surface/tool-readout.ts +151 -0
  45. package/src/components/chart/composite/panel-surface/value-axis-gestures.ts +152 -0
  46. package/src/components/chart/composite/panel-surface.tsx +81 -1177
  47. package/src/components/command-bar/commands/collection-list.ts +1 -0
  48. package/src/components/command-bar/routes/root/results.ts +3 -2
  49. package/src/components/command-bar/routes/root/runtime.ts +3 -2
  50. package/src/components/command-bar/routes/root/selection.ts +3 -2
  51. package/src/components/command-bar/routes/root/shortcuts.ts +15 -0
  52. package/src/components/layout/pane/title.ts +10 -4
  53. package/src/components/pane-settings-dialog/tui.tsx +6 -3
  54. package/src/components/pane-settings-dialog.tsx +2 -1
  55. package/src/components/pane-template-wizard.tsx +2 -0
  56. package/src/components/ui/choice-dialog.tsx +1 -1
  57. package/src/components/ui/confirm-dialog.tsx +3 -2
  58. package/src/components/ui/frame.tsx +7 -3
  59. package/src/components/ui/icon.tsx +4 -2
  60. package/src/components/ui/list-view.tsx +8 -0
  61. package/src/components/ui/number-prompt-dialog.tsx +2 -1
  62. package/src/components/use-pane-notice-footer.tsx +3 -1
  63. package/src/docs/snapshot.json +2 -2
  64. package/src/i18n/es.ts +1 -0
  65. package/src/i18n/ja.ts +1 -0
  66. package/src/i18n/ko.ts +1 -0
  67. package/src/i18n/zh-cn.ts +1 -0
  68. package/src/i18n/zh-tw.ts +1 -0
  69. package/src/market-data/market/format.ts +35 -1
  70. package/src/market-data/quotes/contributions.ts +13 -0
  71. package/src/market-data/quotes/export-identity.ts +36 -1
  72. package/src/market-data/quotes/resolution.ts +16 -0
  73. package/src/plugins/builtin/account-management/password-dialog.tsx +2 -2
  74. package/src/plugins/builtin/analytics/risk-client.ts +12 -2
  75. package/src/plugins/builtin/analytics/risk-headless.ts +66 -6
  76. package/src/plugins/builtin/analytics/risk-math.ts +23 -6
  77. package/src/plugins/builtin/analytics/risk-model.ts +20 -9
  78. package/src/plugins/builtin/analytics/risk-pane.tsx +2 -2
  79. package/src/plugins/builtin/chart-composer/catalog-inventory.ts +5 -2
  80. package/src/plugins/builtin/chart-composer/editor.tsx +1 -0
  81. package/src/plugins/builtin/chart-composer/pane.tsx +1 -1
  82. package/src/plugins/builtin/chart-composer/quick-add.tsx +4 -1
  83. package/src/plugins/builtin/chart-composer/series-catalog.ts +17 -1
  84. package/src/plugins/builtin/cloud/plugin.tsx +2 -0
  85. package/src/plugins/builtin/cloud/thesis/module.tsx +2 -0
  86. package/src/plugins/builtin/cloud/upgrade-status-widget.tsx +6 -2
  87. package/src/plugins/builtin/cpi/headless.ts +6 -1
  88. package/src/plugins/builtin/cpi/model.ts +17 -0
  89. package/src/plugins/builtin/cpi/pane.tsx +3 -1
  90. package/src/plugins/builtin/crypto-board/client.ts +6 -1
  91. package/src/plugins/builtin/crypto-board/headless.ts +10 -2
  92. package/src/plugins/builtin/crypto-board/model.ts +89 -11
  93. package/src/plugins/builtin/crypto-board/pane.tsx +20 -5
  94. package/src/plugins/builtin/dividend-yield/client.ts +24 -2
  95. package/src/plugins/builtin/dividend-yield/headless.ts +4 -2
  96. package/src/plugins/builtin/dividend-yield/ranking.ts +2 -1
  97. package/src/plugins/builtin/dividend-yield/view.ts +5 -1
  98. package/src/plugins/builtin/earnings/history-table.ts +8 -0
  99. package/src/plugins/builtin/earnings-ripple/index.tsx +2 -0
  100. package/src/plugins/builtin/econ/calendar-model.ts +17 -1
  101. package/src/plugins/builtin/econ/fred-catalog.ts +33 -4
  102. package/src/plugins/builtin/econ-statistics/headless.ts +21 -0
  103. package/src/plugins/builtin/macro-day/headless.ts +21 -10
  104. package/src/plugins/builtin/macro-day/model.ts +40 -3
  105. package/src/plugins/builtin/macro-day/pane.tsx +26 -8
  106. package/src/plugins/builtin/macro-day/releases.ts +24 -1
  107. package/src/plugins/builtin/money-markets/client.ts +4 -1
  108. package/src/plugins/builtin/money-markets/headless.ts +15 -4
  109. package/src/plugins/builtin/money-markets/index.tsx +1 -1
  110. package/src/plugins/builtin/money-markets/pane.tsx +7 -1
  111. package/src/plugins/builtin/portfolio-list/cli/bulk-symbols.ts +4 -2
  112. package/src/plugins/builtin/portfolio-list/cli/period-report.ts +61 -11
  113. package/src/plugins/builtin/portfolio-list/cli/portfolio-command.ts +11 -3
  114. package/src/plugins/builtin/portfolio-list/cli/watchlist-command.ts +2 -0
  115. package/src/plugins/builtin/portfolio-list/headless.ts +33 -6
  116. package/src/plugins/builtin/portfolio-list/pane/index.tsx +5 -3
  117. package/src/plugins/builtin/portfolio-list/pane/period-pnl.ts +24 -6
  118. package/src/plugins/builtin/portfolio-list/period-pnl.ts +16 -1
  119. package/src/plugins/builtin/portfolio-list/summary/index.tsx +4 -1
  120. package/src/plugins/builtin/portfolio-list/summary/totals.ts +6 -4
  121. package/src/plugins/builtin/portfolio-list/table.tsx +25 -15
  122. package/src/plugins/builtin/shared/cloud-upgrade.ts +4 -2
  123. package/src/plugins/builtin/shared/cpi-year-gap.ts +67 -0
  124. package/src/plugins/builtin/ticker-detail/adr-pair/headless.ts +45 -2
  125. package/src/plugins/builtin/ticker-detail/headless.ts +26 -1
  126. package/src/plugins/builtin/ticker-detail/overview/components.tsx +4 -5
  127. package/src/plugins/builtin/ticker-detail/overview/model.ts +4 -1
  128. package/src/plugins/builtin/ticker-detail/overview-tab.tsx +10 -2
  129. package/src/portfolio/collection-name.ts +2 -1
  130. package/src/portfolio/column-values.ts +14 -4
  131. package/src/portfolio/listed-symbol.ts +4 -2
  132. package/src/portfolio/period-pnl.ts +51 -1
  133. package/src/renderers/dom/dialog-host.tsx +5 -5
  134. package/src/renderers/electrobun/view/remote/capability-invoker.ts +1 -1
  135. package/src/renderers/opentui/dialog-host.tsx +3 -4
  136. package/src/sources/gloomberb-cloud/normalizers.ts +5 -0
  137. package/src/sources/provider-router/history.ts +5 -2
  138. package/src/test-support/plugin-persistence.ts +12 -0
  139. package/src/tickers/company-name-listing.ts +4 -3
  140. package/src/tickers/company-name.ts +19 -1
  141. package/src/tickers/instrument-coverage.ts +27 -0
  142. package/src/tickers/search/home-listing.ts +38 -1
  143. package/src/tickers/search/index.ts +3 -2
  144. package/src/tickers/search/ranking.ts +21 -2
  145. package/src/time-series/base-series.ts +4 -0
  146. package/src/time-series/types.ts +5 -2
  147. package/src/types/financials.ts +13 -0
  148. package/src/types/headless.ts +2 -0
  149. package/src/ui/dialog-stack.ts +17 -0
  150. package/src/ui/dialog.tsx +6 -2
  151. package/src/utils/crypto-pair.ts +9 -0
  152. package/src/utils/exchanges.ts +13 -0
  153. package/src/utils/financial-statements.ts +60 -3
  154. package/src/utils/futures-generic.ts +14 -0
  155. package/src/utils/trailing-dividend.ts +13 -3
@@ -572,6 +572,8 @@ export interface HeadlessRowsResult extends HeadlessPaneResultBase {
572
572
  rowAsOfKey?: string;
573
573
  /** The interval every row is at (`daily`), which each exported row names in `interval`. */
574
574
  interval?: string;
575
+ /** The currency or unit every row's figures are in (`GBP`, `index points`), which each exported row names in `currency_or_unit`. */
576
+ unit?: string;
575
577
  /**
576
578
  * Tables `--csv` and `--ndjson` write after the rows, each in its own
577
579
  * section, such as the dated history the rows sum up. The text report and
@@ -9,6 +9,23 @@ import type { DialogApi, DialogOptions, PromptContext } from "./dialog";
9
9
 
10
10
  export type DialogKind = "alert" | "prompt";
11
11
 
12
+ /**
13
+ * A click outside that closes a dialog only while nothing in it would be lost:
14
+ * the prompt takes `closeOnClickOutside`, its content reports `setClean`.
15
+ */
16
+ export function clickOutsideWhileClean(): { closeOnClickOutside: () => boolean; setClean: (clean: boolean) => void } {
17
+ let clean = true;
18
+ return {
19
+ closeOnClickOutside: () => clean,
20
+ setClean: (next) => { clean = next; },
21
+ };
22
+ }
23
+
24
+ /** Whether a click on the backdrop closes the dialog now. */
25
+ export function closesOnClickOutside(option: DialogOptions["closeOnClickOutside"]): boolean {
26
+ return typeof option === "function" ? option() : option === true;
27
+ }
28
+
12
29
  interface DialogStackOptions<E extends { id: string }> {
13
30
  idPrefix: string;
14
31
  /** Builds the host's record. `stackWasEmpty` is true for the first dialog of a stack. */
package/src/ui/dialog.tsx CHANGED
@@ -36,8 +36,12 @@ export interface DialogOptions<C = AlertContext> {
36
36
  style?: DialogStyle;
37
37
  /** Terminal: Esc closes the dialog unless this is false. The desktop always closes on Esc. */
38
38
  closeOnEscape?: boolean;
39
- /** A click on the backdrop closes the dialog. Off by default. */
40
- closeOnClickOutside?: boolean;
39
+ /**
40
+ * A click on the backdrop closes the dialog. Off by default. A function is
41
+ * asked at the click, for a dialog that closes so only while nothing in it
42
+ * would be lost.
43
+ */
44
+ closeOnClickOutside?: boolean | (() => boolean);
41
45
  /** Hosts ignore options they do not know. */
42
46
  [key: string]: unknown;
43
47
  }
@@ -39,6 +39,15 @@ export function isRoundTheClockCoin(symbol?: string, exchange?: string): boolean
39
39
  return !!parsed && (isUsdCoinPair(parsed.symbol) || (!venue && isQuotedCoinPair(parsed.symbol)));
40
40
  }
41
41
 
42
+ /**
43
+ * A message as a reader takes it: a coin named by its pair (USDT-USD), never with
44
+ * the crypto venue's internal code after it (USDT-USD:CCC). A credit rating's CCC,
45
+ * which no listing precedes, stays.
46
+ */
47
+ export function withoutCryptoVenueCode(text: string): string {
48
+ return text.replace(/(\S):CCC\b/g, "$1");
49
+ }
50
+
42
51
  const SLASH_COIN_PAIR = /^([A-Z0-9]{1,15})\/(USD|EUR|GBP|JPY|KRW|CAD|INR|CNY|AUD|USDT|USDC|BTC|ETH)$/;
43
52
 
44
53
  /**
@@ -260,6 +260,19 @@ export function displayTickerKey(key: string): string {
260
260
  return isKnownExchangeCode(parsePublicTickerKey(key).exchange) ? canonicalTickerKey(key) : key;
261
261
  }
262
262
 
263
+ /**
264
+ * A stored key as the listing a request names: a row saved under its venue's
265
+ * code (`ES3:XSES`, as a key is when another listing holds the bare symbol)
266
+ * is ES3 on SGX, as `D05` on SGX is D05 there. A key whose suffix names no
267
+ * venue (`FRED:DFII10`) is requested as stored, on the row's exchange.
268
+ */
269
+ export function storedKeyListing(key: string, exchange?: string): { symbol: string; exchange: string } {
270
+ const parsed = parsePublicTickerKey(key);
271
+ return parsed.exchange && isKnownExchangeCode(parsed.exchange)
272
+ ? { symbol: parsed.symbol, exchange: parsed.exchange }
273
+ : { symbol: key, exchange: exchange ?? "" };
274
+ }
275
+
263
276
  export function publicTickerKey(symbol: string, exchange?: string): string {
264
277
  const parsed = parsePublicTickerKey(symbol);
265
278
  const publicValue = publicExchange(parsed.exchange ?? exchange);
@@ -312,8 +312,9 @@ export function filledPeriodsNote(
312
312
  // A TTM Gloom Cloud built from the year and the half since it says how.
313
313
  const basis = statements.find(({ aggregation }) => aggregation?.kind === "annual-plus-interim")?.aggregation?.basis;
314
314
  const trailing = basis ? `TTM is ${basis}, from the company's results announcements.` : null;
315
+ const withheld = withheldLinesNote(statements, shown);
315
316
  const filled = filledPeriods(statements, shown);
316
- if (filled.length === 0) return trailing;
317
+ if (filled.length === 0) return [trailing, withheld].filter(Boolean).join(" ") || null;
317
318
  const sources = [...new Set(filled.map((period) => period.source))];
318
319
  let note: string;
319
320
  // Each announcement dates its own periods: "TTM revenue; 2025-12-31 revenue (published 2026-03-25)", and
@@ -327,7 +328,60 @@ export function filledPeriodsNote(
327
328
  const read = filled.map(({ stamp }) => stamp.date).sort().at(-1);
328
329
  note = `From ${sources.join(" and ")} (read ${read}): ${filled.map(({ period, fields }) => `${period} ${fields.join(", ")}`).join("; ")}.`;
329
330
  }
330
- return [note, omittedLinesNote(statements, shown), trailing].filter(Boolean).join(" ");
331
+ return [note, omittedLinesNote(statements, shown), trailing, withheld].filter(Boolean).join(" ");
332
+ }
333
+
334
+ type WithheldLines = Record<string, { value?: number; reason?: string } | undefined>;
335
+
336
+ /** The lines a row says Gloom Cloud left blank (`withheld`), read through a cast: the type does not name it. */
337
+ function withheldOf(row: FinancialStatement | undefined): WithheldLines | undefined {
338
+ const withheld = (row as { withheld?: unknown } | undefined)?.withheld;
339
+ return withheld && typeof withheld === "object" ? withheld as WithheldLines : undefined;
340
+ }
341
+
342
+ /** Keeps the lines either row withholds as below zero blank in their merge, and says so on it. */
343
+ function withholdBelowZero(merged: FinancialStatement, rows: ReadonlyArray<FinancialStatement | undefined>): void {
344
+ const withheld = Object.assign({}, ...rows.map(withheldOf).reverse()) as WithheldLines;
345
+ if (Object.keys(withheld).length === 0) return;
346
+ const values = merged as unknown as Record<string, unknown>;
347
+ values.withheld = withheld;
348
+ for (const [field, entry] of Object.entries(withheld)) {
349
+ const value = values[field];
350
+ if (entry?.reason === "below-zero" && typeof value === "number" && value < 0) delete values[field];
351
+ }
352
+ }
353
+
354
+ /** Expense lines Gloom Cloud serves blank where the statements source gives them below zero (the row's `withheld`). */
355
+ const WITHHELD_LINES: Record<string, string> = {
356
+ costOfRevenue: "cost of revenue",
357
+ sellingGeneralAndAdministration: "SG&A",
358
+ sellingAndMarketingExpense: "selling and marketing",
359
+ generalAndAdministrativeExpense: "G&A",
360
+ researchAndDevelopment: "R&D",
361
+ operatingExpense: "operating expenses",
362
+ };
363
+
364
+ /**
365
+ * "SG&A blank for 2026-06-30, 2025-12-31, 2025-06-30: source value below zero.": lines Gloom Cloud left blank
366
+ * rather than serve an impossible figure (CATL's SG&A, read by the source as a difference of years to date it
367
+ * counts otherwise). `shown` keeps the lines the table has a row for. Null when none is.
368
+ */
369
+ function withheldLinesNote(statements: readonly Pick<FinancialStatement, "date">[], shown?: ReadonlySet<string>): string | null {
370
+ const ends = new Map<string, string[]>();
371
+ for (const row of statements) {
372
+ const withheld = withheldOf(row as FinancialStatement);
373
+ if (!withheld || !/^\d{4}-\d{2}-\d{2}/.test(row.date)) continue;
374
+ for (const [field, entry] of Object.entries(withheld)) {
375
+ const line = WITHHELD_LINES[field];
376
+ if (!line || entry?.reason !== "below-zero" || (shown && !shown.has(field))) continue;
377
+ // Another source's figure for it, merged in, is shown: not blank.
378
+ if (typeof (row as unknown as Record<string, unknown>)[field] === "number") continue;
379
+ ends.set(line, [...ends.get(line) ?? [], row.date.slice(0, 10)]);
380
+ }
381
+ }
382
+ if (ends.size === 0) return null;
383
+ const lines = [...ends].map(([line, dates]) => `${line} blank for ${[...new Set(dates)].sort().reverse().join(", ")}`).join("; ");
384
+ return `${lines}: source value below zero.`;
331
385
  }
332
386
 
333
387
  /** "2026-09-30, 2026-06-30 revenue left blank: the company's results announcements count it otherwise than the statements source." */
@@ -377,7 +431,7 @@ export function quarterRows<T extends Pick<FinancialStatement, "filledFrom">>(ro
377
431
 
378
432
  export const SEC_EPS_BASIS_NOTICE = "SEC EPS uses corroborated split-adjusted share bases. Unverified bases are unavailable.";
379
433
 
380
- const STATEMENT_METADATA_KEYS = new Set(["date", "dateSource", "accountingStandard", "providerDate", "dateEvidence", "currency", "availableAt", "fieldAvailability", "epsBasis", "fieldSources", "unavailableFields", "withdrawnObservations", "operatingResult", "operatingResultAggregation", "earningsResult", "unavailableEarnings", "filledFrom"]);
434
+ const STATEMENT_METADATA_KEYS = new Set(["date", "dateSource", "accountingStandard", "providerDate", "dateEvidence", "currency", "availableAt", "fieldAvailability", "epsBasis", "fieldSources", "unavailableFields", "withdrawnObservations", "operatingResult", "operatingResultAggregation", "earningsResult", "unavailableEarnings", "filledFrom", "withheld"]);
381
435
  const NEARBY_PERIOD_END_MS = 7 * 24 * 60 * 60 * 1_000;
382
436
 
383
437
  /** An explicit field map is authoritative: omitted fields have unknown availability. */
@@ -588,6 +642,9 @@ export function mergeFinancialStatementRows(
588
642
  }
589
643
  }
590
644
 
645
+ // A line Gloom Cloud left blank as below zero stays blank: no other copy's figure below zero (a copy saved
646
+ // before, or another source's) fills it.
647
+ withholdBelowZero(merged, [row, fallback]);
591
648
  // A gap either report declares for the period survives the other's value.
592
649
  mergeStatementGaps(merged, [row, fallback]);
593
650
  const fill = retainedFill(merged, [row, fallback]);
@@ -231,6 +231,20 @@ export function futuresContractMonth(code: string): { root: string; month: numbe
231
231
  return { root: match[1]!, month: (2000 + Number(match[3])) * 12 + MONTH_CODES.indexOf(match[2]!) };
232
232
  }
233
233
 
234
+ /**
235
+ * A dated contract typed without its venue (ZQZ26), named as its quote is, with
236
+ * the venue that lists its root: ZQZ26.CBT, as WIRP prints it. A Bloomberg
237
+ * root reads as the exchange's (FFZ26 is ZQZ26.CBT). Null for a root Gloom
238
+ * Cloud does not archive and for any other code.
239
+ */
240
+ export function venueOfDatedContract(code: string): string | null {
241
+ const match = /^([A-Z0-9]{1,4}?)([FGHJKMNQUVXZ])(\d{2})$/.exec(code.trim().toUpperCase());
242
+ if (!match) return null;
243
+ const root = ALIASES[match[1]!] ?? match[1]!;
244
+ const venue = ROOT_VENUES[root];
245
+ return venue ? `${root}${match[2]}${match[3]}.${venue}` : null;
246
+ }
247
+
234
248
  /** A root's contract for a delivery month as `futuresContractMonth` counts it: CL and 2026 × 12 + 11 are CLZ26. */
235
249
  export function futuresContractCode(root: string, month: number): string {
236
250
  return `${root}${MONTH_CODES[month % 12]}${String(Math.floor(month / 12) % 100).padStart(2, "0")}`;
@@ -34,13 +34,23 @@ const MAX_LATE_GRACE_DAYS = 30;
34
34
  export const LATE_GRACE_DAYS = [...new Set(Object.values(REGULAR_CADENCE)
35
35
  .map((cadence) => Math.min(cadence.halfPeriodDays, MAX_LATE_GRACE_DAYS)))];
36
36
 
37
+ /**
38
+ * How far past two years the cadence looks when those two years hold a single ex-date: an annual payer whose
39
+ * ex-date came a few days later than the year before (Moutai's June 25, 2021 and June 30, 2022) has one in
40
+ * them for those days, and read as no cadence its trailing cash fell to nothing until the late one went ex.
41
+ */
42
+ export const CADENCE_GRACE_DAYS = MAX_LATE_GRACE_DAYS;
43
+
37
44
  /** Cadence of ex-dates in the two years ending at `asOf`, ignoring later payments. */
38
45
  export function inferCadence(payments: readonly Pick<CashDistribution, "exDate">[], asOf: Date): DistributionCadence | null {
39
- const cutoff = calendarMonthsBefore(asOf, 24);
40
- // Old suspensions or a former schedule must not redefine a fund's recent cadence.
41
- const dates = [...new Set(payments.filter((payment) => payment.exDate > cutoff && payment.exDate <= asOf)
46
+ const within = (cutoff: Date) => [...new Set(payments.filter((payment) => payment.exDate > cutoff && payment.exDate <= asOf)
42
47
  .map((payment) => payment.exDate.getTime()))]
43
48
  .sort((a, b) => a - b);
49
+ const cutoff = calendarMonthsBefore(asOf, 24);
50
+ // Old suspensions or a former schedule must not redefine a fund's recent cadence.
51
+ let dates = within(cutoff);
52
+ // A single ex-date in two years: the one before it, if only days past them, says the cadence.
53
+ if (dates.length === 1) dates = within(new Date(cutoff.getTime() - CADENCE_GRACE_DAYS * DAY));
44
54
  if (dates.length < 2) return null;
45
55
  const avgGapDays = (dates.at(-1)! - dates[0]!) / (dates.length - 1) / DAY;
46
56
  if (Math.abs(avgGapDays - 30) < 8) return "monthly";