WIP main worktree changes before merge

lib/financials/statement-view-model.ts

@@ -79,6 +79,10 @@ type Categories = Array<{
   count: number;
 }>;
 
+const UNMAPPED_DETAIL_GROUP_KEY = 'unmapped';
+const UNMAPPED_SECTION_KEY = 'unmapped_residual';
+const UNMAPPED_SECTION_LABEL = 'Unmapped / Residual';
+
 function surfaceConfigForKind(surfaceKind: Extract<FinancialSurfaceKind, 'income_statement' | 'balance_sheet' | 'cash_flow_statement'>) {
   return SURFACE_CHILDREN[surfaceKind] ?? {};
 }
@@ -129,6 +133,25 @@ function sortDetailRows(left: DetailFinancialRow, right: DetailFinancialRow) {
   return left.label.localeCompare(right.label);
 }
 
+function buildUnmappedDetailNodes(input: {
+  statementDetails: SurfaceDetailMap | null;
+  searchQuery: string;
+}) {
+  const normalizedSearch = normalize(input.searchQuery);
+
+  return [...(input.statementDetails?.[UNMAPPED_DETAIL_GROUP_KEY] ?? [])]
+    .sort(sortDetailRows)
+    .filter((detail) => normalizedSearch.length === 0 || searchTextForDetail(detail).includes(normalizedSearch))
+    .map((detail) => ({
+      kind: 'detail',
+      id: detailNodeId(UNMAPPED_DETAIL_GROUP_KEY, detail),
+      level: 0,
+      row: detail,
+      parentSurfaceKey: UNMAPPED_DETAIL_GROUP_KEY,
+      matchesSearch: normalizedSearch.length > 0 && searchTextForDetail(detail).includes(normalizedSearch)
+    }) satisfies StatementTreeDetailNode);
+}
+
 function countNodes(nodes: StatementTreeNode[]) {
   let count = 0;
 
@@ -223,10 +246,26 @@ export function buildStatementTree(input: {
     .filter((node): node is StatementTreeSurfaceNode => Boolean(node));
 
   if (input.categories.length === 0) {
+    const sections: StatementTreeSection[] = rootNodes.length > 0
+      ? [{ key: 'ungrouped', label: null, nodes: rootNodes }]
+      : [];
+    const unmappedNodes = buildUnmappedDetailNodes({
+      statementDetails: input.statementDetails,
+      searchQuery: input.searchQuery
+    });
+
+    if (unmappedNodes.length > 0) {
+      sections.push({
+        key: UNMAPPED_SECTION_KEY,
+        label: UNMAPPED_SECTION_LABEL,
+        nodes: unmappedNodes
+      });
+    }
+
     return {
-      sections: [{ key: 'ungrouped', label: null, nodes: rootNodes }],
+      sections,
       autoExpandedKeys,
-      visibleNodeCount: countNodes(rootNodes),
+      visibleNodeCount: sections.reduce((sum, section) => sum + countNodes(section.nodes), 0),
       totalNodeCount: input.rows.length + Object.values(input.statementDetails ?? {}).reduce((sum, rows) => sum + rows.length, 0)
     };
   }
@@ -254,6 +293,18 @@ export function buildStatementTree(input: {
     });
   }
 
+  const unmappedNodes = buildUnmappedDetailNodes({
+    statementDetails: input.statementDetails,
+    searchQuery: input.searchQuery
+  });
+  if (unmappedNodes.length > 0) {
+    sections.push({
+      key: UNMAPPED_SECTION_KEY,
+      label: UNMAPPED_SECTION_LABEL,
+      nodes: unmappedNodes
+    });
+  }
+
   return {
     sections,
     autoExpandedKeys,
@@ -297,9 +348,11 @@ export function resolveStatementSelection(input: {
   }
 
   const parentSurfaceKey = selection.parentKey ?? null;
-  const detailRows = parentSurfaceKey
-    ? input.statementDetails?.[parentSurfaceKey] ?? []
-    : Object.values(input.statementDetails ?? {}).flat();
+  const detailRows = parentSurfaceKey === UNMAPPED_DETAIL_GROUP_KEY
+    ? input.statementDetails?.[UNMAPPED_DETAIL_GROUP_KEY] ?? []
+    : parentSurfaceKey
+      ? input.statementDetails?.[parentSurfaceKey] ?? []
+      : Object.values(input.statementDetails ?? {}).flat();
   const row = detailRows.find((candidate) => candidate.key === selection.key) ?? null;
 
   if (!row) {