gloomberb 0.11.0 → 0.11.2

package/src/plugins/builtin/thirteenf/data.ts

@@ -1,5 +1,6 @@
 import {
   listThirteenFFormHoldings,
+  listThirteenFFormHoldingsPage,
   listThirteenFForms,
   listThirteenFFilings,
   listTopThirteenFFunds,
@@ -81,8 +82,17 @@ export async function loadBrowserRows(
     const ticker = query.trim().toUpperCase();
     if (!ticker) return { rows: [], quarter };
     const tickers = await lookupThirteenFTickers([ticker], signal, apiOptions);
-    const cusip = tickers[0]?.cusip;
-    if (!cusip) return { rows: [], quarter, warning: `No CUSIP found for ${ticker}` };
+    const exact = tickers.filter((item) => item.ticker === ticker);
+    const candidates = exact.length > 0 ? exact : tickers;
+    const cusips = [...new Set(candidates.map((item) => item.cusip).filter(Boolean))];
+    const cusip = cusips.length === 1 ? cusips[0] : undefined;
+    if (!cusip) {
+      return {
+        rows: [],
+        quarter,
+        warning: cusips.length === 0 ? `No CUSIP found for ${ticker}` : `Ambiguous CUSIP for ${ticker}`,
+      };
+    }
     const periodOfReport = quarterToPeriod(quarter);
     try {
       const holders = await lookupThirteenFHoldersByCusip(cusip, periodOfReport, signal, apiOptions);
@@ -186,11 +196,9 @@ export async function loadFilingPositions(
   cik: string,
   accessionNumber: string,
   signal?: AbortSignal,
-  options: { forceRefresh?: boolean } = {},
-): Promise<ThirteenFHoldingRecord[]> {
-  return listThirteenFFormHoldings(cik, accessionNumber, signal, {
-    forceRefresh: options.forceRefresh,
-  });
+  options: { forceRefresh?: boolean; offset?: number; limit?: number } = {},
+): Promise<{ rows: ThirteenFHoldingRecord[]; hasMore: boolean }> {
+  return listThirteenFFormHoldingsPage(cik, accessionNumber, signal, options);
 }
 
 function quarterToPeriod(quarter: string): string {

package/src/plugins/builtin/thirteenf/pane.tsx

@@ -10,6 +10,7 @@ import {
   DataTableStackView,
   DataTableView,
   EmptyState,
+  useTableLoadMore,
   InputSearchBar,
   Spinner,
   Tabs,
@@ -238,13 +239,7 @@ export function ThirteenFPane({ focused, width, height }: PaneProps) {
     setSelectedId(sortedRows[0]?.id ?? null);
   }, [selectedId, setSelectedId, sortedRows]);
 
-  const loadMoreFromScroll = useCallback(() => {
-    const scrollBox = tableScrollRef.current;
-    if (!scrollBox?.viewport) return;
-    const viewportHeight = Math.max(1, scrollBox.viewport.height);
-    if (scrollBox.scrollTop + viewportHeight < scrollBox.scrollHeight - LOAD_MORE_THRESHOLD) return;
-    loadMore();
-  }, [loadMore]);
+  const loadMoreFromScroll = useTableLoadMore(tableScrollRef, hasMore && !loadingMore && status === "loaded", loadMore, LOAD_MORE_THRESHOLD);
 
   const refresh = useCallback(() => load(true), [load]);
   const focusSearch = useCallback(() => {
@@ -672,19 +667,29 @@ function FilingDetailView({
   const [holdings, setHoldings] = useState<ThirteenFHoldingRecord[]>([]);
   const [status, setStatus] = useState<LoadStatus>("loading");
   const [error, setError] = useState<string | null>(null);
+  const [hasMore, setHasMore] = useState(false);
+  const [nextOffset, setNextOffset] = useState(0);
+  const [loadingMore, setLoadingMore] = useState(false);
   const abortRef = useRef<AbortController | null>(null);
+  const moreAbortRef = useRef<AbortController | null>(null);
+  const positionScrollRef = useRef<ScrollBoxRenderable | null>(null);
 
   const load = useCallback((refresh = false) => {
     abortRef.current?.abort();
+    moreAbortRef.current?.abort();
     const controller = new AbortController();
     abortRef.current = controller;
     setStatus("loading");
     setError(null);
     setHoldings([]);
-    void loadFilingPositions(filing.cik, filing.accessionNumber, controller.signal, { forceRefresh: refresh })
-      .then((nextHoldings) => {
+    setHasMore(false);
+    setNextOffset(0);
+    void loadFilingPositions(filing.cik, filing.accessionNumber, controller.signal, { forceRefresh: refresh, offset: 0 })
+      .then((result) => {
         if (abortRef.current !== controller) return;
-        setHoldings(nextHoldings);
+        setHoldings(result.rows);
+        setHasMore(result.hasMore);
+        setNextOffset(result.rows.length);
         setStatus("loaded");
       })
       .catch((loadError) => {
@@ -695,11 +700,39 @@ function FilingDetailView({
       });
   }, [filing.accessionNumber, filing.cik]);
 
+  const loadMore = useCallback(() => {
+    if (loadingMore || !hasMore || status !== "loaded") return;
+    moreAbortRef.current?.abort();
+    const controller = new AbortController();
+    moreAbortRef.current = controller;
+    setLoadingMore(true);
+    void loadFilingPositions(filing.cik, filing.accessionNumber, controller.signal, { offset: nextOffset })
+      .then((result) => {
+        if (moreAbortRef.current !== controller) return;
+        setHoldings((current) => [...current, ...result.rows]);
+        setHasMore(result.hasMore);
+        setNextOffset(nextOffset + result.rows.length);
+      })
+      .catch((loadError) => {
+        if (moreAbortRef.current !== controller) return;
+        if (loadError instanceof Error && loadError.name === "AbortError") return;
+        setError(loadError instanceof Error ? loadError.message : String(loadError));
+      })
+      .finally(() => {
+        if (moreAbortRef.current !== controller) return;
+        setLoadingMore(false);
+      });
+  }, [filing.accessionNumber, filing.cik, hasMore, loadingMore, nextOffset, status]);
+
+  const onBodyScrollActivity = useTableLoadMore(positionScrollRef, hasMore && !loadingMore && status === "loaded", loadMore);
+
   useEffect(() => {
     load(false);
     return () => {
       abortRef.current?.abort();
       abortRef.current = null;
+      moreAbortRef.current?.abort();
+      moreAbortRef.current = null;
     };
   }, [load]);
 
@@ -769,6 +802,8 @@ function FilingDetailView({
         onRootKeyDown={handlePositionKeyDown}
         rootWidth={width}
         rootBefore={summary}
+        scrollRef={positionScrollRef}
+        onBodyScrollActivity={onBodyScrollActivity}
         resetScrollKey={filing.accessionNumber}
         columns={columns}
         items={positionRows}

package/src/plugins/builtin/ticker-detail/index.tsx

@@ -100,6 +100,14 @@ export const tickerDetailModule: PluginModule = {
           }
           : {}
       ),
+      publicShare: {
+        serialize: ({ pane }) => pane.binding?.kind === "fixed" && pane.binding.symbol.trim()
+          ? { title: pane.title?.trim() || pane.binding.symbol, data: { symbol: pane.binding.symbol.trim().toUpperCase() } }
+          : null,
+        restore: (data) => Object.keys(data).length === 1 && typeof data.symbol === "string" && data.symbol.trim()
+          ? { symbol: data.symbol.trim().toUpperCase() }
+          : null,
+      },
     },
     {
       id: "quote-monitor-pane",
@@ -147,6 +155,7 @@ export const tickerDetailModule: PluginModule = {
       description: "Open a historical OHLCV table for a ticker.",
       keywords: ["historical", "prices", "hp", "ohlc", "volume"],
       shortcut: "HP",
+      publicShare: true,
     }),
     createProviderSearchPaneTemplate(),
     createTickerSurfacePaneTemplate({
@@ -156,6 +165,7 @@ export const tickerDetailModule: PluginModule = {
       description: "Open financial statements for a ticker.",
       keywords: ["fa", "financial", "analysis", "statements"],
       shortcut: "FA",
+      publicShare: true,
       titlePrefix: "FA",
     }),
   ],

package/src/plugins/builtin/ticker-detail/overview-tab.tsx

@@ -14,6 +14,7 @@ import {
 } from "../../../market-data/market/status";
 import { selectEffectiveExchangeRates } from "../../../utils/exchange-rate-map";
 import { EmptyState } from "../../../components";
+import { CompanyLogo } from "../../../components/company-logo";
 import {
   CompositeChart,
   pricePointsToResolvedSeries,
@@ -48,7 +49,7 @@ export function OverviewTab({
   const baseCurrency = useAppSelector((state) => state.config.baseCurrency);
   const exchangeRatesState = useAppSelector((state) => state.exchangeRates);
   const { width: termWidth } = useViewport();
-  const { fractionalViewport = false } = useUiCapabilities();
+  const { fractionalViewport = false, nativePaneChrome } = useUiCapabilities();
 
   if (!ticker) return <EmptyState title={t("No ticker selected.")} />;
 
@@ -136,14 +137,20 @@ export function OverviewTab({
 
   return (
     <ScrollBox flexGrow={1} flexBasis={0} scrollY focusable={false}>
-      <Box flexDirection="column" paddingX={1} paddingBottom={1} gap={1}>
+      <Box flexDirection="column" paddingX={1} paddingTop={nativePaneChrome ? 1 : 0} paddingBottom={1} gap={1}>
         <Box flexDirection={quoteBookInline ? "row" : "column"} gap={quoteBookInline ? 2 : 0} width={contentWidth}>
-          <Box flexDirection="column" width={quoteSummaryWidth}>
+          <Box flexDirection="row" width={quoteSummaryWidth}>
+            <CompanyLogo
+              symbol={ticker.metadata.ticker}
+              assetCategory={ticker.metadata.assetCategory}
+              name={ticker.metadata.name || quote?.name}
+            />
+            <Box flexDirection="column" flexGrow={1} flexShrink={1} minWidth={0}>
             <Box flexDirection="row">
               <Text attributes={TextAttributes.BOLD} fg={colors.textBright}>
                 {ticker.metadata.ticker}
               </Text>
-              {ticker.metadata.name && ticker.metadata.name !== ticker.metadata.ticker && (
+              {(ticker.metadata.name || quote?.name) && (ticker.metadata.name || quote?.name) !== ticker.metadata.ticker && (
                 <Text fg={colors.textDim}>
                   {" "}- {ticker.metadata.name || quote?.name || ""}
                 </Text>
@@ -193,6 +200,7 @@ export function OverviewTab({
             {metadataParts.length > 0 && (
               <Text fg={colors.textDim}>{metadataParts.join(" | ")}</Text>
             )}
+            </Box>
           </Box>
 
           {quote && hasBidAsk && (

package/src/plugins/builtin/ticker-detail/quote-monitor/card.tsx

@@ -82,7 +82,8 @@ export function QuoteMonitorCard({
   const flashDirection = useQuoteFlashDirection(flashFinancials, valueFlashingEnabled);
   const display = getActiveQuoteDisplay(quote);
   const quoteStatus = resolveQuoteStatus(quoteEntry, symbol);
-  const changeColor = priceColor(display?.change ?? 0);
+  const quoteFailed = quoteStatus.failed && !!display;
+  const changeColor = quoteFailed ? colors.textDim : priceColor(display?.change ?? 0);
   const priceAttributes = flashDirection ? TextAttributes.DIM : TextAttributes.BOLD;
   const changeAttributes = flashDirection ? TextAttributes.DIM : TextAttributes.NONE;
   const currency = quote?.currency ?? ticker?.metadata.currency ?? "USD";
@@ -192,7 +193,12 @@ export function QuoteMonitorCard({
             <Text attributes={TextAttributes.BOLD} fg={colors.textBright} style={desktopSymbolStyle}>
               {symbol}
             </Text>
-            {ticker?.metadata.name && (
+            {quoteFailed && (
+              <Text fg={colors.negative} style={{ fontSize: "12px", lineHeight: "14px" }}>
+                {quoteStatus.text}
+              </Text>
+            )}
+            {!quoteFailed && ticker?.metadata.name && (
               <Text
                 fg={colors.textDim}
                 style={{

package/src/plugins/builtin/ticker-detail/settings.ts

@@ -73,6 +73,18 @@ export function buildTickerResearchSettingsDef(settings: TickerResearchPaneSetti
           options: tabs.map((tab) => ({ value: tab.id, label: tab.name })),
         }]
         : []),
+      {
+        key: "chainRefreshMinutes",
+        label: "Options chain refresh",
+        description: "How often the Options tab refetches the whole chain snapshot.",
+        type: "select" as const,
+        options: [
+          { value: "1", label: "Every minute" },
+          { value: "5", label: "Every 5 minutes" },
+          { value: "10", label: "Every 10 minutes" },
+          { value: "30", label: "Every 30 minutes" },
+        ],
+      },
     ],
   };
 }

package/src/plugins/builtin/treasury-auctions/index.tsx

@@ -7,6 +7,7 @@ import {
 } from "./cache";
 import { TreasuryAuctionsPane } from "./pane";
 import { TREASURY_AUCTIONS_PANE_ID } from "./types";
+import { createPublicPaneShare } from "../shared/public-pane";
 
 let disposeConnection: (() => void) | null = null;
 
@@ -85,6 +86,7 @@ export const treasuryAuctionsModule: PluginModule = {
       ],
       shortcut: { prefix: "AUCT" },
       createInstance: () => ({ placement: "floating" }),
+      publicShare: createPublicPaneShare("Treasury Auctions"),
     },
   ],
 };

package/src/plugins/builtin/world-indices/index.tsx

@@ -8,6 +8,7 @@ import { useAssetData, usePluginTickerActions } from "../../runtime";
 import { useQuoteBoard } from "../shared/use-quote-board";
 import { WORLD_INDICES, REGION_LABELS, getIndicesByRegion, resolveIndexEntries } from "./indices";
 import { useWorldIndicesFooter } from "./footer";
+import { createPublicPaneShare } from "../shared/public-pane";
 import {
   buildFlatRows,
   DEFAULT_SORT_PREFERENCE,
@@ -158,6 +159,7 @@ export const worldIndicesModule: PluginModule = {
       description: "Monitor global equity indices grouped by region.",
       keywords: ["world", "indices", "global", "equity", "markets", "international"],
       shortcut: { prefix: "WEI" },
+      publicShare: createPublicPaneShare("World Equity Indices"),
     },
   ],
 };

package/src/plugins/catalog-browser.test.ts

@@ -0,0 +1,78 @@
+import { describe, expect, test } from "bun:test";
+import { browserBuiltinPlugins } from "./catalog-browser";
+import { getLoadablePlugins } from "./catalog";
+
+const ids = browserBuiltinPlugins.map((plugin) => plugin.id);
+const paneIds = browserBuiltinPlugins.flatMap((plugin) => plugin.panes?.map((pane) => pane.id) ?? []);
+const templateIds = new Set(browserBuiltinPlugins.flatMap((plugin) => plugin.paneTemplates?.map((template) => template.id) ?? []));
+
+describe("browser plugin catalog", () => {
+  test("contains the reviewed cloud, local, market, and research plugins", () => {
+    expect(ids).toEqual([
+      "gloomberb-cloud",
+      "portfolio",
+      "ticker-research",
+      "application",
+      "news",
+      "market-overview",
+      "macro",
+      "alerts",
+    ]);
+  });
+
+  test("excludes native, filesystem, local AI, debug, updater, and external plugins", () => {
+    for (const forbidden of [
+      "broker",
+      "ibkr",
+      "public",
+      "robinhood",
+      "simplefin",
+      "notes",
+      "substack",
+      "ai",
+      "debug",
+      "yahoo",
+      "prediction-markets",
+      "polls",
+      "updater",
+    ]) {
+      expect(ids).not.toContain(forbidden);
+    }
+  });
+
+  test("keeps every public pane handoff restorable in the hosted browser", () => {
+    const unavailable = getLoadablePlugins()
+      .flatMap((plugin) => plugin.paneTemplates ?? [])
+      .filter((template) => template.publicShare && !templateIds.has(template.id))
+      .map((template) => template.id);
+    expect(unavailable).toEqual([]);
+  });
+
+  test("omits unsupported modules inside otherwise browser-safe product areas", () => {
+    expect(paneIds).toEqual(expect.arrayContaining([
+      "ticker-research",
+      "chart-composer",
+      "options-calculator",
+      "ticker-news",
+      "world-indices",
+      "econ-calendar",
+      "treasury-auctions",
+    ]));
+    for (const forbidden of [
+      "buildout",
+      "market-heatmap",
+      "market-movers",
+      "market-halts",
+      "earnings-calendar",
+      "ipo-calendar",
+      "tv",
+      "dividend-yield",
+      "short-interest",
+      "thirteenf",
+      "sec",
+      "insider",
+    ]) {
+      expect(paneIds).not.toContain(forbidden);
+    }
+  });
+});

package/src/plugins/catalog-browser.ts

@@ -0,0 +1,136 @@
+import {
+  attachFredSeriesPersistence,
+  resetFredSeriesPersistence,
+} from "../data/fred-series";
+import type { GloomPlugin } from "../types/plugin";
+import { portfolioAnalyticsModule } from "./builtin/analytics";
+import { alertsPlugin } from "./builtin/alerts";
+import { browserGloomberbCloudPlugin } from "./builtin/cloud/browser";
+import { changelogModule } from "./builtin/changelog";
+import { chartComposerModule } from "./builtin/chart-composer";
+import { connectionsModule } from "./builtin/connections";
+import { correlationModule } from "./builtin/correlation";
+import { cdsModule } from "./builtin/cds";
+import { creditConditionsModule } from "./builtin/credit-conditions";
+import { economicCalendarModule } from "./builtin/econ";
+import { futuresModule } from "./builtin/futures";
+import { fxMatrixModule } from "./builtin/fx-matrix";
+import { helpModule } from "./builtin/help";
+import { positionSizerModule } from "./builtin/kelly-sizer";
+import { layoutManagerModule } from "./builtin/layout-manager";
+import { tickerNewsModule } from "./builtin/news";
+import { optionsModule } from "./builtin/options";
+import { optionsCalculatorModule } from "./builtin/options-calculator";
+import { composeBuiltinPlugin, type PluginModule } from "./builtin/plugin-module";
+import { portfolioListModule } from "./builtin/portfolio-list";
+import { researchModule } from "./builtin/research";
+import { scannerModule } from "./builtin/scanner";
+import { sectorsModule } from "./builtin/sectors";
+import { tickerDetailModule } from "./builtin/ticker-detail";
+import { treasuryAuctionsModule } from "./builtin/treasury-auctions";
+import { volatilityModule } from "./builtin/volatility";
+import { worldIndicesModule } from "./builtin/world-indices";
+import { yieldCurveModule } from "./builtin/yield-curve";
+
+const browserApplicationPlugin = composeBuiltinPlugin({
+  id: "application",
+  name: "Application",
+  version: "1.0.0",
+  description: "Core layout, help, and release information.",
+  modules: [layoutManagerModule, helpModule, changelogModule, connectionsModule],
+});
+
+const browserPortfolioPlugin = composeBuiltinPlugin({
+  id: "portfolio",
+  name: "Portfolio",
+  version: "1.0.0",
+  description: "Portfolio and watchlist management, analytics, and position sizing.",
+  toggleable: true,
+  modules: [portfolioListModule, portfolioAnalyticsModule, positionSizerModule],
+});
+
+const browserTickerResearchPlugin = composeBuiltinPlugin({
+  id: "ticker-research",
+  name: "Ticker Research",
+  version: "1.0.0",
+  description: "Company overview, charts, financials, options, and research.",
+  toggleable: true,
+  modules: [
+    tickerDetailModule,
+    chartComposerModule,
+    optionsModule,
+    optionsCalculatorModule,
+    researchModule,
+  ],
+});
+
+const browserNewsPlugin = composeBuiltinPlugin({
+  id: "news",
+  name: "News",
+  version: "1.0.0",
+  description: "View latest news for each ticker.",
+  toggleable: true,
+  modules: [tickerNewsModule],
+});
+
+const browserMarketOverviewPlugin = composeBuiltinPlugin({
+  id: "market-overview",
+  name: "Market Overview",
+  version: "1.0.0",
+  description: "Global indices, scanners, sectors, FX, futures, and correlations.",
+  toggleable: true,
+  modules: [
+    correlationModule,
+    worldIndicesModule,
+    scannerModule,
+    sectorsModule,
+    fxMatrixModule,
+    futuresModule,
+  ],
+});
+
+const browserFredResourcesModule: PluginModule = {
+  setup(ctx) {
+    attachFredSeriesPersistence(ctx.persistence);
+  },
+  dispose() {
+    resetFredSeriesPersistence();
+  },
+};
+
+const browserMacroPlugin = composeBuiltinPlugin({
+  id: "macro",
+  name: "Macro",
+  version: "1.0.0",
+  description: "Economic calendar, rates, volatility, credit spreads, single-name CDS, and Treasury auctions.",
+  toggleable: true,
+  modules: [
+    browserFredResourcesModule,
+    economicCalendarModule,
+    yieldCurveModule,
+    volatilityModule,
+    creditConditionsModule,
+    cdsModule,
+    treasuryAuctionsModule,
+  ],
+});
+
+/**
+ * Reviewed browser catalog. Native brokers, filesystem/local-process plugins,
+ * and modules whose data path is not available through Gloom Cloud or a
+ * browser-safe public API are absent rather than registered behind stubs.
+ */
+export const browserBuiltinPlugins: readonly GloomPlugin[] = [
+  browserGloomberbCloudPlugin,
+  browserPortfolioPlugin,
+  browserTickerResearchPlugin,
+  browserApplicationPlugin,
+  browserNewsPlugin,
+  browserMarketOverviewPlugin,
+  browserMacroPlugin,
+  alertsPlugin,
+];
+
+export function getBrowserBuiltinPlugins(): readonly GloomPlugin[] {
+  return browserBuiltinPlugins;
+}

package/src/plugins/gridlock-notification.ts

@@ -3,9 +3,10 @@ import type { AppNotificationRequest } from "../types/plugin";
 export function notifyGridlockComplete(
   notify: (notification: AppNotificationRequest) => void,
   onRevert: () => void,
+  body = "Windows tidied",
 ): void {
   notify({
-    body: "Retiled all panes",
+    body,
     type: "success",
     action: {
       label: "Revert",

package/src/plugins/ibkr/flex/index.test.ts

@@ -27,6 +27,7 @@ describe("parseFlexPositions", () => {
     const positions = parseFlexPositions(xml);
     expect(positions).toHaveLength(1);
     expect(positions[0]?.ticker).toBe("SPY  260619C00500000");
+    expect(positions[0]?.side).toBe("long");
     expect(positions[0]?.brokerContract).toEqual({
       brokerId: "ibkr",
       conId: 123456,
@@ -43,6 +44,24 @@ describe("parseFlexPositions", () => {
       tradingClass: "SPY",
     });
   });
+
+  test("treats a negative Flex position without a side attribute as a short", () => {
+    const xml = `
+      <FlexQueryResponse>
+        <OpenPositions>
+          <OpenPosition accountId="DU12345" symbol="TSLA" assetCategory="STK" position="-50" costBasisPrice="200" currency="USD" listingExchange="NASDAQ" />
+        </OpenPositions>
+      </FlexQueryResponse>
+    `;
+
+    const positions = parseFlexPositions(xml);
+    expect(positions).toHaveLength(1);
+    expect(positions[0]).toMatchObject({
+      ticker: "TSLA",
+      shares: 50,
+      side: "short",
+    });
+  });
 });
 
 describe("parseFlexAccounts", () => {

package/src/plugins/ibkr/flex/index.ts

@@ -162,7 +162,7 @@ export function parseFlexPositions(xml: string): BrokerPosition[] {
       name: description || undefined,
       assetCategory: assetCategory || undefined,
       isin: isin || undefined,
-      side: side === "long" || side === "short" ? side : undefined,
+      side: side === "long" || side === "short" ? side : quantity < 0 ? "short" : "long",
       markPrice: numAttr("markPrice"),
       marketValue: numAttr("positionValue"),
       unrealizedPnl: numAttr("fifoPnlUnrealized") ?? numAttr("unrealizedCapitalGainsPnl"),

package/src/plugins/pane-manager/gridlock.ts

@@ -1,4 +1,4 @@
-import type { LayoutConfig } from "../../types/config";
+import type { FloatingPaneEntry, LayoutConfig } from "../../types/config";
 import {
   boundsForRects,
   inferDockTreeFromRects,
@@ -14,9 +14,85 @@ import {
   type PaneTypeAvailability,
 } from "./layout-state";
 
-export function gridlockAllPanes(
+const BURIED_VISIBLE_RATIO = 0.2;
+const TITLE_BAR_HEIGHT_RATIO = 0.12;
+const TIDY_FLOATING_THRESHOLD = 3;
+
+type Rect = Pick<FloatingPaneEntry, "x" | "y" | "width" | "height">;
+
+export interface FloatingPaneVisibility {
+  instanceId: string;
+  buried: boolean;
+  visibleRatio: number;
+  titleBarVisibleRatio: number;
+}
+
+function rectArea(rect: Rect): number {
+  return Math.max(0, rect.width) * Math.max(0, rect.height);
+}
+
+function subtractRect(rect: Rect, cover: Rect): Rect[] {
+  const left = Math.max(rect.x, cover.x);
+  const top = Math.max(rect.y, cover.y);
+  const right = Math.min(rect.x + rect.width, cover.x + cover.width);
+  const bottom = Math.min(rect.y + rect.height, cover.y + cover.height);
+  if (left >= right || top >= bottom) return [rect];
+
+  return [
+    { x: rect.x, y: rect.y, width: rect.width, height: top - rect.y },
+    { x: rect.x, y: bottom, width: rect.width, height: rect.y + rect.height - bottom },
+    { x: rect.x, y: top, width: left - rect.x, height: bottom - top },
+    { x: right, y: top, width: rect.x + rect.width - right, height: bottom - top },
+  ].filter((piece) => piece.width > 0 && piece.height > 0);
+}
+
+function visibleRatio(rect: Rect, covers: Rect[]): number {
+  const area = rectArea(rect);
+  if (area === 0) return 0;
+  let pieces = [rect];
+  for (const cover of covers) {
+    pieces = pieces.flatMap((piece) => subtractRect(piece, cover));
+    if (pieces.length === 0) return 0;
+  }
+  return Math.min(1, pieces.reduce((sum, piece) => sum + rectArea(piece), 0) / area);
+}
+
+export function analyzeFloatingPaneVisibility(layout: LayoutConfig): FloatingPaneVisibility[] {
+  const frontToBack = layout.floating
+    .map((entry, index) => ({ entry, index }))
+    .sort((left, right) => (
+      (right.entry.zIndex ?? 50) - (left.entry.zIndex ?? 50)
+      || right.index - left.index
+    ));
+  const covers: Rect[] = [];
+
+  return frontToBack.map(({ entry }) => {
+    const paneVisibleRatio = visibleRatio(entry, covers);
+    const titleBar = {
+      x: entry.x,
+      y: entry.y,
+      width: entry.width,
+      height: Math.min(entry.height, Math.max(1, entry.height * TITLE_BAR_HEIGHT_RATIO)),
+    };
+    const titleBarVisibleRatio = visibleRatio(titleBar, covers);
+    covers.push(entry);
+    return {
+      instanceId: entry.instanceId,
+      buried: paneVisibleRatio < BURIED_VISIBLE_RATIO || titleBarVisibleRatio < BURIED_VISIBLE_RATIO,
+      visibleRatio: paneVisibleRatio,
+      titleBarVisibleRatio,
+    };
+  });
+}
+
+export function shouldShowTidyWindows(layout: LayoutConfig): boolean {
+  return layout.floating.length >= TIDY_FLOATING_THRESHOLD
+    || analyzeFloatingPaneVisibility(layout).some((pane) => pane.buried);
+}
+
+function gridlockPanes(
   layout: LayoutConfig,
-  bounds: LayoutBounds = { x: 0, y: 0, width: 120, height: 40 },
+  bounds: LayoutBounds,
   paneTypes?: PaneTypeAvailability,
 ): LayoutConfig {
   const visibleLayout = paneTypes
@@ -40,3 +116,11 @@ export function gridlockAllPanes(
     floating: [],
   });
 }
+
+export function gridlockAllPanes(
+  layout: LayoutConfig,
+  bounds: LayoutBounds = { x: 0, y: 0, width: 120, height: 40 },
+  paneTypes?: PaneTypeAvailability,
+): LayoutConfig {
+  return gridlockPanes(layout, bounds, paneTypes);
+}