Skip to content

fix(explorer): rail in reading order — statements first, canonical statement sort#224

Merged
jfrench9 merged 2 commits into
mainfrom
feature/explorer-rail-order
Jul 23, 2026
Merged

fix(explorer): rail in reading order — statements first, canonical statement sort#224
jfrench9 merged 2 commits into
mainfrom
feature/explorer-rail-order

Conversation

@jfrench9

@jfrench9 jfrench9 commented Jul 23, 2026

Copy link
Copy Markdown
Member

Summary

Two explorer polish fixes from live review:

Rail in reading order

The picker mirrored the list API's alphabetical block_type sort: metrics first, statement family shuffled (BS, CF, Equity, IS).

  • Group order now follows a financial report's reading order: Statements → Disclosures → Schedules → Metrics → Other.
  • Statement family sorts canonically: Balance Sheet, Income Statement, Cash Flow, Equity, Comprehensive Income; name sort inside every other group; unregistered block types (forecast) land in Other, last.

Scenario picker on metric blocks only

The Actuals/scenario dropdown rendered everywhere, including block types that ignore it — and statements, where an F-1 scenario bind is a single sparse projected month (the BS slice carries only working-capital instants), more confusing than useful. It now renders only on metric blocks, where a scenario visibly extends the series with "(forecast)"-labeled columns — the same only-where-useful rule the compute bar follows. Statements rejoin when the statement-series view lands (fpa-operating-plan F-4). ?scenario= persists across selections, so flipping away and back keeps the pick.

Client-side only, no API changes. Default block selection (metric = the explorer home) unchanged.

Verification

npm run test:all green — new tests: group order + canonical statement order fed a deliberately shuffled list, forecast-in-Other, and scenario-picker visibility (shown on metric, hidden on statement + schedule, restored on return).

jfrench9 added 2 commits July 23, 2026 12:10
…ules, metrics, other

The picker mirrored the list API's alphabetical block_type sort, which
put metrics first and shuffled the statement family (BS, CF, Equity,
IS). Groups now follow a financial report's reading order — the
statements, their notes, the working papers behind them, derived
analytics, everything else — and the statement family sorts canonically
(BS, IS, CF, Equity, Comprehensive Income) with name sorts inside every
other group. Unregistered block types (forecast) keep landing in Other.
The Actuals/scenario dropdown rendered on every block type, including
the ones that ignore it (schedules, disclosures, the forecast container)
and statements — where an F-1 scenario bind is a single sparse projected
month (the BS slice carries only working-capital instants), more
confusing than useful. It now renders only on metric blocks, where the
scenario visibly extends the series with '(forecast)'-labeled columns —
the same only-where-useful rule the compute bar follows. Statements
rejoin when the statement-series view lands (fpa-operating-plan F-4).
The ?scenario= URL param persists across selections, so flipping away
and back keeps the chosen scenario.
@jfrench9
jfrench9 merged commit b0bf466 into main Jul 23, 2026
3 checks passed
@jfrench9
jfrench9 deleted the feature/explorer-rail-order branch July 23, 2026 17:20
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant