@zeniai/client-epic-state 5.0.55-betaSS1 → 5.0.55-betaVR1

package/lib/view/expenseAutomationView/reducers/transactionsViewReducer.js

@@ -4,7 +4,7 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
 };
 var _a;
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.uploadTransactionCategorizationReceiptSuccess = exports.updateTransactionCategorizationUploadReceiptState = exports.backgroundRefetchReviewTab = exports.syncTransactionCategorizationFromDetailSave = exports.updateSelectedTransactionId = exports.setEntityRecommendationForLineIdsForCategorization = exports.clearExpenseAutomationTransactionsView = exports.clearExpenseAutomationTransactionsViewPerTabView = exports.updateSelectedCheckboxTransactionIds = exports.fetchTransactionCategorizationView = exports.resetOtherTabsFetchState = exports.fetchTransactionCategorizationSuccess = exports.updateTotalCountForTransactionCategorization = exports.setAllItemsToCategoryClassInLocalDataForCategorization = exports.updateSelectedCustomerForTransaction = exports.updateSelectedVendorForTransaction = exports.updateStatusForTransactionNotMiscategorizedUpdateForCategorization = exports.markTransactionAsNotMiscategorized = exports.updateTransactionCategorizationSaveStatus = exports.updateTransactionCategorizationCompletedSubTab = exports.updateCurrentSelectedTransactionCategorizationTab = exports.updateTransactionCategorization = exports.saveTransactionCategorization = exports.fetchTransactionCategorizationFailure = exports.saveTransactionCategorizationLocalData = exports.initializeTransactionCategorizationViewLocalData = exports.updateTransactionCategorizationUIState = exports.fetchTransactionCategorization = exports.initialState = exports.initialTransactionTabViewState = void 0;
+exports.uploadTransactionCategorizationReceiptSuccess = exports.updateTransactionCategorizationUploadReceiptState = exports.backgroundRefetchReviewTab = exports.syncTransactionCategorizationFromDetailSave = exports.updateSelectedTransactionId = exports.setEntityRecommendationForLineIdsForCategorization = exports.clearExpenseAutomationTransactionsView = exports.clearExpenseAutomationTransactionsViewPerTabView = exports.updateSelectedCheckboxTransactionIds = exports.fetchTransactionCategorizationView = exports.resetOtherTabsFetchState = exports.fetchTransactionCategorizationSuccess = exports.updateTotalCountForTransactionCategorization = exports.setAllItemsToCategoryClassInLocalDataForCategorization = exports.updateSelectedCustomerForTransaction = exports.updateSelectedVendorForTransaction = exports.updateStatusForTransactionNotMiscategorizedUpdateForCategorization = exports.markTransactionAsNotMiscategorized = exports.updateTransactionCategorizationSaveStatus = exports.updateCurrentSelectedTransactionCategorizationTab = exports.updateTransactionCategorization = exports.saveTransactionCategorization = exports.fetchTransactionCategorizationFailure = exports.saveTransactionCategorizationLocalData = exports.initializeTransactionCategorizationViewLocalData = exports.updateTransactionCategorizationUIState = exports.fetchTransactionCategorization = exports.initialState = exports.initialTransactionTabViewState = void 0;
 const toolkit_1 = require("@reduxjs/toolkit");
 const get_1 = __importDefault(require("lodash/get"));
 const uniq_1 = __importDefault(require("lodash/uniq"));
@@ -48,40 +48,12 @@ exports.initialTransactionTabViewState = {
     selectedTransactionLineId: undefined,
 };
 exports.initialState = {
-    autoCategorizedSubTabCache: {},
     selectedTransactionCategorizationTab: 'review',
-    selectedTransactionCategorizationCompletedSubTab: 'all',
     transactionCategorizationView: {
         review: { ...exports.initialTransactionTabViewState },
         autoCategorized: { ...exports.initialTransactionTabViewState },
     },
 };
-/**
- * Capture the autoCategorized tab's current paginated dataset for a sub-tab.
- * The mid-flight `'In-Progress'` state is normalised to `'Completed'` because
- * the in-flight request is cancelled by `switchMap` in the fetch epic when the
- * sub-tab changes — restoring `'In-Progress'` later would leave the UI stuck
- * showing a phantom loading state with no fetch actually running. Length-zero
- * datasets degrade to `'Not-Started'` so the next visit triggers a fresh
- * fetch from page 1 instead of short-circuiting on stale empty caches.
- */
-function snapshotAutoCategorizedTab(autoCat) {
-    const transactionIdsBySelectedPeriod = {
-        ...autoCat.transactionIdsBySelectedPeriod,
-    };
-    const hasAnyLoadedRows = Object.values(transactionIdsBySelectedPeriod).some((ids) => ids.length > 0);
-    let normalisedFetchState = autoCat.fetchState;
-    if (normalisedFetchState === 'In-Progress') {
-        normalisedFetchState = hasAnyLoadedRows ? 'Completed' : 'Not-Started';
-    }
-    return {
-        error: autoCat.error,
-        fetchState: normalisedFetchState,
-        pageToken: autoCat.uiState.pageToken,
-        totalCount: { ...autoCat.uiState.totalCount },
-        transactionIdsBySelectedPeriod,
-    };
-}
 const expenseAutomationTransactionsView = (0, toolkit_1.createSlice)({
     name: 'expenseAutomationTransactionsView',
     initialState: exports.initialState,
@@ -295,48 +267,6 @@ const expenseAutomationTransactionsView = (0, toolkit_1.createSlice)({
                 return { payload: { newSelectedTab } };
             },
         },
-        updateTransactionCategorizationCompletedSubTab: {
-            reducer(draft, action) {
-                const { newSubTab } = action.payload;
-                const previousSubTab = draft.selectedTransactionCategorizationCompletedSubTab;
-                if (previousSubTab === newSubTab) {
-                    return;
-                }
-                const autoCat = draft.transactionCategorizationView.autoCategorized;
-                // Snapshot the outgoing sub-tab so a future revisit can short-circuit
-                // the fetch epic (mirrors the parent-tab "don't refetch what's
-                // already cached" behaviour). Period-scoped data is preserved as-is
-                // because the snapshot itself is keyed only by sub-tab; the active
-                // tab's per-period maps remain the source of truth while live.
-                draft.autoCategorizedSubTabCache[previousSubTab] =
-                    snapshotAutoCategorizedTab(autoCat);
-                const cached = draft.autoCategorizedSubTabCache[newSubTab];
-                if (cached != null) {
-                    autoCat.uiState.pageToken = cached.pageToken;
-                    autoCat.uiState.totalCount = { ...cached.totalCount };
-                    autoCat.transactionIdsBySelectedPeriod = {
-                        ...cached.transactionIdsBySelectedPeriod,
-                    };
-                    autoCat.fetchState = cached.fetchState;
-                    autoCat.error = cached.error;
-                }
-                else {
-                    // Sub-tab has never been visited — clear the active slot so the
-                    // view-epic's `fetchState === 'Not-Started' || transactionIds.length
-                    // === 0` cache check falls through and triggers a fresh page-1
-                    // fetch for the new dataset.
-                    autoCat.uiState.pageToken = null;
-                    autoCat.uiState.totalCount = {};
-                    autoCat.transactionIdsBySelectedPeriod = {};
-                    autoCat.fetchState = 'Not-Started';
-                    autoCat.error = undefined;
-                }
-                draft.selectedTransactionCategorizationCompletedSubTab = newSubTab;
-            },
-            prepare(newSubTab) {
-                return { payload: { newSubTab } };
-            },
-        },
         updateTransactionCategorization: {
             reducer(draft, action) {
                 const selectedTab = action.payload.selectedTab;
@@ -880,5 +810,5 @@ const expenseAutomationTransactionsView = (0, toolkit_1.createSlice)({
         },
     },
 });
-_a = expenseAutomationTransactionsView.actions, exports.fetchTransactionCategorization = _a.fetchTransactionCategorization, exports.updateTransactionCategorizationUIState = _a.updateTransactionCategorizationUIState, exports.initializeTransactionCategorizationViewLocalData = _a.initializeTransactionCategorizationViewLocalData, exports.saveTransactionCategorizationLocalData = _a.saveTransactionCategorizationLocalData, exports.fetchTransactionCategorizationFailure = _a.fetchTransactionCategorizationFailure, exports.saveTransactionCategorization = _a.saveTransactionCategorization, exports.updateTransactionCategorization = _a.updateTransactionCategorization, exports.updateCurrentSelectedTransactionCategorizationTab = _a.updateCurrentSelectedTransactionCategorizationTab, exports.updateTransactionCategorizationCompletedSubTab = _a.updateTransactionCategorizationCompletedSubTab, exports.updateTransactionCategorizationSaveStatus = _a.updateTransactionCategorizationSaveStatus, exports.markTransactionAsNotMiscategorized = _a.markTransactionAsNotMiscategorized, exports.updateStatusForTransactionNotMiscategorizedUpdateForCategorization = _a.updateStatusForTransactionNotMiscategorizedUpdateForCategorization, exports.updateSelectedVendorForTransaction = _a.updateSelectedVendorForTransaction, exports.updateSelectedCustomerForTransaction = _a.updateSelectedCustomerForTransaction, exports.setAllItemsToCategoryClassInLocalDataForCategorization = _a.setAllItemsToCategoryClassInLocalDataForCategorization, exports.updateTotalCountForTransactionCategorization = _a.updateTotalCountForTransactionCategorization, exports.fetchTransactionCategorizationSuccess = _a.fetchTransactionCategorizationSuccess, exports.resetOtherTabsFetchState = _a.resetOtherTabsFetchState, exports.fetchTransactionCategorizationView = _a.fetchTransactionCategorizationView, exports.updateSelectedCheckboxTransactionIds = _a.updateSelectedCheckboxTransactionIds, exports.clearExpenseAutomationTransactionsViewPerTabView = _a.clearExpenseAutomationTransactionsViewPerTabView, exports.clearExpenseAutomationTransactionsView = _a.clearExpenseAutomationTransactionsView, exports.setEntityRecommendationForLineIdsForCategorization = _a.setEntityRecommendationForLineIdsForCategorization, exports.updateSelectedTransactionId = _a.updateSelectedTransactionId, exports.syncTransactionCategorizationFromDetailSave = _a.syncTransactionCategorizationFromDetailSave, exports.backgroundRefetchReviewTab = _a.backgroundRefetchReviewTab, exports.updateTransactionCategorizationUploadReceiptState = _a.updateTransactionCategorizationUploadReceiptState, exports.uploadTransactionCategorizationReceiptSuccess = _a.uploadTransactionCategorizationReceiptSuccess;
+_a = expenseAutomationTransactionsView.actions, exports.fetchTransactionCategorization = _a.fetchTransactionCategorization, exports.updateTransactionCategorizationUIState = _a.updateTransactionCategorizationUIState, exports.initializeTransactionCategorizationViewLocalData = _a.initializeTransactionCategorizationViewLocalData, exports.saveTransactionCategorizationLocalData = _a.saveTransactionCategorizationLocalData, exports.fetchTransactionCategorizationFailure = _a.fetchTransactionCategorizationFailure, exports.saveTransactionCategorization = _a.saveTransactionCategorization, exports.updateTransactionCategorization = _a.updateTransactionCategorization, exports.updateCurrentSelectedTransactionCategorizationTab = _a.updateCurrentSelectedTransactionCategorizationTab, exports.updateTransactionCategorizationSaveStatus = _a.updateTransactionCategorizationSaveStatus, exports.markTransactionAsNotMiscategorized = _a.markTransactionAsNotMiscategorized, exports.updateStatusForTransactionNotMiscategorizedUpdateForCategorization = _a.updateStatusForTransactionNotMiscategorizedUpdateForCategorization, exports.updateSelectedVendorForTransaction = _a.updateSelectedVendorForTransaction, exports.updateSelectedCustomerForTransaction = _a.updateSelectedCustomerForTransaction, exports.setAllItemsToCategoryClassInLocalDataForCategorization = _a.setAllItemsToCategoryClassInLocalDataForCategorization, exports.updateTotalCountForTransactionCategorization = _a.updateTotalCountForTransactionCategorization, exports.fetchTransactionCategorizationSuccess = _a.fetchTransactionCategorizationSuccess, exports.resetOtherTabsFetchState = _a.resetOtherTabsFetchState, exports.fetchTransactionCategorizationView = _a.fetchTransactionCategorizationView, exports.updateSelectedCheckboxTransactionIds = _a.updateSelectedCheckboxTransactionIds, exports.clearExpenseAutomationTransactionsViewPerTabView = _a.clearExpenseAutomationTransactionsViewPerTabView, exports.clearExpenseAutomationTransactionsView = _a.clearExpenseAutomationTransactionsView, exports.setEntityRecommendationForLineIdsForCategorization = _a.setEntityRecommendationForLineIdsForCategorization, exports.updateSelectedTransactionId = _a.updateSelectedTransactionId, exports.syncTransactionCategorizationFromDetailSave = _a.syncTransactionCategorizationFromDetailSave, exports.backgroundRefetchReviewTab = _a.backgroundRefetchReviewTab, exports.updateTransactionCategorizationUploadReceiptState = _a.updateTransactionCategorizationUploadReceiptState, exports.uploadTransactionCategorizationReceiptSuccess = _a.uploadTransactionCategorizationReceiptSuccess;
 exports.default = expenseAutomationTransactionsView.reducer;

package/lib/view/expenseAutomationView/selectorTypes/missingReceiptsSelectorTypes.d.ts

@@ -2,8 +2,7 @@ import { CompletionStatusType, FetchStateAndError, ID } from '../../../commonSta
 import { SortOrder } from '../../../commonStateTypes/selectorTypes/sortOrderTypes';
 import { SelectorView } from '../../../commonStateTypes/viewAndReport/viewAndReport';
 import { SupportedTransaction } from '../../../entity/transaction/transactionState';
-import type { CompletedSubTab } from '../types/completedSubTab';
-import type { BatchFileStatus, BatchListItem, BatchStatus, BulkUploadPhase, BulkUploadResultsTab, BulkUploadSortKey, ManualSearchState, MatchSource, MissingReceiptsViewUIState } from '../types/missingReceiptsViewState';
+import type { BatchFileStatus, BatchListItem, BatchStatus, BulkUploadPhase, BulkUploadResultsTab, BulkUploadSortKey, CompletedSubTab, ManualSearchState, MatchSource, MissingReceiptsViewUIState } from '../types/missingReceiptsViewState';
 export interface CompletedTransactionsSelectorData {
     fetchState: FetchStateAndError;
     nextPageToken: string | null;

package/lib/view/expenseAutomationView/selectorTypes/transactionsViewSelectorTypes.d.ts

@@ -7,7 +7,6 @@ import { ClassBase } from '../../../entity/class/classState';
 import { SupportedTransactionWithCOT } from '../../../entity/transaction/transactionState';
 import { UncategorizedAccounts } from '../../accountList/accountListSelector';
 import { ProjectListSelectorView } from '../../projectList/projectListSelector';
-import { CompletedSubTab } from '../types/completedSubTab';
 import { TransactionReviewLocalData, TransactionsTab, TransactionsViewUIState } from '../types/transactionsViewState';
 export interface TransactionReviewLocalDataSelectorView {
     transactionId: ID;
@@ -26,7 +25,6 @@ export interface ExpenseAutomationTransactionViewSelector extends SelectorView {
     refreshStatus: FetchStateAndError;
     saveStatus: FetchStateAndError;
     selectedCheckBoxTransactionIds: ID[];
-    selectedTransactionCategorizationCompletedSubTab: CompletedSubTab;
     totalCountByTab: Record<TransactionsTab, number>;
     transactionIdsWithUnsavedData: ID[];
     transactionLocalData: TransactionReviewLocalDataSelectorView[];

package/lib/view/expenseAutomationView/selectors/transactionCategorizationSelector.js

@@ -16,7 +16,7 @@ const projectListSelector_1 = require("../../projectList/projectListSelector");
 const expenseAutomationViewSelectorTypes_1 = require("../selectorTypes/expenseAutomationViewSelectorTypes");
 function getExpenseAutomationTransactionView(state) {
     const { accountState, classState, classListState, accountListState, expenseAutomationTransactionsViewState, expenseAutomationViewState, projectState, projectListState, transactionState, monthEndCloseChecksState, monthEndCloseChecksViewState, } = state;
-    const { selectedTransactionCategorizationCompletedSubTab, selectedTransactionCategorizationTab, } = expenseAutomationTransactionsViewState;
+    const { selectedTransactionCategorizationTab } = expenseAutomationTransactionsViewState;
     const { uiState, refreshStatus, saveStatus, markAsNotMiscategorizedStatus, transactionIdsBySelectedPeriod, transactionReviewLocalDataById, selectedCheckBoxTransactionIds, transactionIdsWithUnsavedData, uploadReceiptStatusById, selectedTransactionId, selectedTransactionLineId, } = expenseAutomationTransactionsViewState.transactionCategorizationView[selectedTransactionCategorizationTab];
     const uncategorizedIncomeExpense = (0, accountListSelector_1.getUncategorizedAccounts)(accountState, accountListState, 'accountList');
     const accountList = (0, accountListSelector_1.getAccountList)(accountState, accountListState, 'accountList');
@@ -118,6 +118,5 @@ function getExpenseAutomationTransactionView(state) {
         uploadReceiptStatusById,
         selectedTransactionId,
         selectedTransactionLineId,
-        selectedTransactionCategorizationCompletedSubTab,
     };
 }

package/lib/view/expenseAutomationView/types/missingReceiptsViewState.d.ts

@@ -1,7 +1,6 @@
 import { FetchStateAndError, FetchedState, ID } from '../../../commonStateTypes/common';
 import { SortOrder } from '../../../commonStateTypes/selectorTypes/sortOrderTypes';
 import { MonthYearPeriodId } from '../../../commonStateTypes/timePeriod';
-import { CompletedSubTab } from './completedSubTab';
 export declare const toMissingReceiptsSortKey: (v: string) => "date" | "amount" | "vendor" | "category" | "class";
 export type MissingReceiptsSortKey = ReturnType<typeof toMissingReceiptsSortKey>;
 export interface MissingReceiptsViewUIState {
@@ -32,6 +31,8 @@ export declare const toBulkUploadResultsTab: (v: string) => "completed" | "unmat
 export type BulkUploadResultsTab = ReturnType<typeof toBulkUploadResultsTab>;
 export declare const toMissingReceiptsTab: (v: string) => "completed" | "unmatched" | "missing";
 export type MissingReceiptsTab = ReturnType<typeof toMissingReceiptsTab>;
+export declare const toCompletedSubTab: (v: string) => "all" | "manual" | "ai_accountant";
+export type CompletedSubTab = ReturnType<typeof toCompletedSubTab>;
 export declare const toMatchSource: (v: string) => "manual" | "ai";
 export type MatchSource = ReturnType<typeof toMatchSource>;
 export declare const toBulkUploadSortKey: (v: string) => "date" | "amount" | "vendor" | "category" | "class";

package/lib/view/expenseAutomationView/types/missingReceiptsViewState.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.toBulkUploadSortKey = exports.toMatchSource = exports.toMissingReceiptsTab = exports.toBulkUploadResultsTab = exports.toBulkUploadPhase = exports.toBatchFileStatus = exports.BATCH_FILE_STATUSES = exports.toBatchStatusValue = exports.MIN_MANUAL_TRANSACTION_SEARCH_LENGTH = exports.toMissingReceiptsSortKey = void 0;
+exports.toBulkUploadSortKey = exports.toMatchSource = exports.toCompletedSubTab = exports.toMissingReceiptsTab = exports.toBulkUploadResultsTab = exports.toBulkUploadPhase = exports.toBatchFileStatus = exports.BATCH_FILE_STATUSES = exports.toBatchStatusValue = exports.MIN_MANUAL_TRANSACTION_SEARCH_LENGTH = exports.toMissingReceiptsSortKey = void 0;
 exports.isUnmatchedTabFileStatus = isUnmatchedTabFileStatus;
 const stringToUnion_1 = require("../../../commonStateTypes/stringToUnion");
 const MISSING_RECEIPTS_SORT_KEYS = [
@@ -49,6 +49,9 @@ exports.toBulkUploadResultsTab = toBulkUploadResultsTab;
 const MISSING_RECEIPTS_TABS = ['missing', 'completed', 'unmatched'];
 const toMissingReceiptsTab = (v) => (0, stringToUnion_1.stringToUnion)(v.trim().toLowerCase(), MISSING_RECEIPTS_TABS);
 exports.toMissingReceiptsTab = toMissingReceiptsTab;
+const COMPLETED_SUB_TABS = ['all', 'ai_accountant', 'manual'];
+const toCompletedSubTab = (v) => (0, stringToUnion_1.stringToUnion)(v.trim().toLowerCase(), COMPLETED_SUB_TABS);
+exports.toCompletedSubTab = toCompletedSubTab;
 const MATCH_SOURCES = ['ai', 'manual'];
 const toMatchSource = (v) => (0, stringToUnion_1.stringToUnion)(v.trim().toLowerCase(), MATCH_SOURCES);
 exports.toMatchSource = toMatchSource;

package/lib/view/expenseAutomationView/types/transactionsViewState.d.ts

@@ -1,5 +1,5 @@
 import { Amount } from '../../../commonStateTypes/amount';
-import { FetchState, FetchStateAndError, FetchedState, ID } from '../../../commonStateTypes/common';
+import { FetchStateAndError, FetchedState, ID } from '../../../commonStateTypes/common';
 import { Recommendation, RecommendationWithCOT } from '../../../commonStateTypes/recommendationBase';
 import { SortOrder } from '../../../commonStateTypes/selectorTypes/sortOrderTypes';
 import { MonthYearPeriodId } from '../../../commonStateTypes/timePeriod';
@@ -13,11 +13,9 @@ import { TransactionID } from '../../../entity/transaction/stateTypes/transactio
 import { BillableStatus, CategorizationStatusType, PlatformLineDetailType, ProductOrService, TransactionLineBase } from '../../../entity/transaction/stateTypes/transactionLine';
 import { TransactionCategory, TransactionType } from '../../../entity/transaction/stateTypes/transactionType';
 import { VendorBase } from '../../../entity/vendor/vendorState';
-import { ZeniAPIStatus } from '../../../responsePayload';
 import { ZeniDate } from '../../../zeniDayJS';
 import { EntityRecommendationKey } from '../../recommendation/recommendationState';
 import { TransactionDetailKey } from '../../transactionDetail/transactionDetailState';
-import { CompletedSubTab } from './completedSubTab';
 export declare const toTransactionsSortKey: (v: string) => "date" | "amount" | "vendor" | "project" | "category" | "class" | "payment_account" | "transaction_type" | "memo_and_receipt";
 export type TransactionsSortKey = ReturnType<typeof toTransactionsSortKey>;
 export declare const TRANSACTIONS_TABS: readonly ["review", "autoCategorized"];
@@ -105,31 +103,7 @@ export interface TransactionsTabViewState extends FetchedState {
     selectedTransactionId?: ID;
     selectedTransactionLineId?: ID;
 }
-/**
- * Snapshot of the autoCategorized tab's paginated dataset for a single
- * Completed sub-tab. Stored in {@link TransactionsViewState.autoCategorizedSubTabCache}
- * so revisiting an already-loaded sub-tab can short-circuit the fetch epic
- * (mirrors parent-tab caching). The snapshot is period-spanning — both the
- * `totalCount` map and `transactionIdsBySelectedPeriod` map preserve every
- * period the user has paged through under that sub-tab.
- */
-export interface AutoCategorizedSubTabSnapshot {
-    error: ZeniAPIStatus | undefined;
-    fetchState: FetchState;
-    pageToken: PageToken;
-    totalCount: Record<MonthYearPeriodId, number>;
-    transactionIdsBySelectedPeriod: Record<MonthYearPeriodId, ID[]>;
-}
 export type TransactionsViewState = {
-    /**
-     * Per-sub-tab snapshot cache for the Completed (autoCategorized) tab. Keyed
-     * by {@link CompletedSubTab}. Populated as the user navigates between
-     * sub-tabs and consulted on every switch — the active autoCategorized slot
-     * is restored from here when a snapshot exists, otherwise it is reset and
-     * the fetch epic loads page 1 fresh.
-     */
-    autoCategorizedSubTabCache: Partial<Record<CompletedSubTab, AutoCategorizedSubTabSnapshot>>;
-    selectedTransactionCategorizationCompletedSubTab: CompletedSubTab;
     selectedTransactionCategorizationTab: TransactionsTab;
     transactionCategorizationView: Record<TransactionsTab, TransactionsTabViewState>;
 };

package/lib/view/transactionDetail/journalEntryLinesViewModel.d.ts

@@ -0,0 +1,73 @@
+import { Amount } from '../../commonStateTypes/amount';
+import { SortOrder } from '../../commonStateTypes/selectorTypes/sortOrderTypes';
+import { JournalEntryTransactionLine, Line, TransactionLineBase } from '../../entity/transaction/stateTypes/transactionLine';
+/**
+ * View-model helpers for the new Journal Entry table view (see
+ * web-components `journalEntryTable`). Keeps presentation-agnostic
+ * logic — totals, sort, line-filter — colocated in epic-state so it
+ * is testable and reusable.
+ */
+export declare const JOURNAL_ENTRY_SORT_KEYS: readonly ["description", "name", "category", "class", "debit", "credit"];
+export declare const toJournalEntrySortKey: (v: string) => "name" | "description" | "category" | "class" | "credit" | "debit";
+export type JournalEntrySortKey = ReturnType<typeof toJournalEntrySortKey>;
+export interface JournalEntryRowSortConfig {
+    sortKey: JournalEntrySortKey;
+    sortOrder: SortOrder;
+}
+export declare const journalEntryDefaultSortConfig: JournalEntryRowSortConfig;
+type AmountBearer = Pick<TransactionLineBase, 'amount'>;
+/**
+ * Sums the `amount.amount` field of every line and returns an `Amount`
+ * whose currencyCode/currencySymbol are taken from the first line.
+ * Returns `undefined` for an empty list.
+ *
+ * Mirrors legacy `calculateTotal` in
+ * `web-components/src/components/transactionDetail/items/TransactionLinesJournalEntry.tsx`
+ * but without the `Object.assign` ceremony and with stable currency carry-over.
+ */
+export declare const sumJournalEntryAmounts: (lines: ReadonlyArray<AmountBearer>) => Amount | undefined;
+/**
+ * Splits `lines` by `postingType` into debit/credit totals.
+ *
+ * Fixes the operator-precedence bug from legacy
+ * `calculateCombinedTotalAmount` where
+ * `totalAmount?.amount ?? 0 + (...) + (...)` parses as
+ * `totalAmount?.amount ?? (0 + ... + ...)` so the `(...)`'s only get
+ * added when `totalAmount` is nullish. The new implementation just sums
+ * every debit (or credit) line including the un/miscategorized ones in
+ * one pass, so the result is always the true sum.
+ */
+export declare const journalEntryTotalsByPostingSide: (lines: ReadonlyArray<Pick<JournalEntryTransactionLine, "amount" | "postingType">>) => {
+    creditTotal?: Amount;
+    debitTotal?: Amount;
+};
+/**
+ * Drops `linked_transaction_line` entries — equivalent to legacy
+ * `filterOutLinkedTransactionLine` in `transactionDetail.helpers.ts`.
+ */
+export declare const filterJournalEntryLinesExcludingLinked: <T extends Pick<Line, "type">>(lines?: ReadonlyArray<T>) => T[];
+/**
+ * Accessor functions resolve the sort value for each column from a
+ * line. The new table reads display-formatted values from the form
+ * (selected option label, entity name, etc.), so callers pass in
+ * accessors that match their `LineInfo` shape rather than baking the
+ * column-to-form-field mapping into epic-state.
+ */
+export interface JournalEntrySortAccessors<T> {
+    category: (line: T) => string;
+    class: (line: T) => string;
+    credit: (line: T) => number;
+    debit: (line: T) => number;
+    description: (line: T) => string;
+    name: (line: T) => string;
+}
+/**
+ * Stable, accessor-driven sort over arbitrary line shapes. Lines that
+ * resolve to the same key value preserve their original relative order
+ * thanks to lodash's stable `orderBy`.
+ *
+ * Strings are lower-cased before comparison so the order is predictable
+ * across mixed-case data. Numbers (debit/credit) compare directly.
+ */
+export declare const sortJournalEntryLines: <T>(lines: ReadonlyArray<T>, config: JournalEntryRowSortConfig, accessors: JournalEntrySortAccessors<T>) => T[];
+export {};

package/lib/view/transactionDetail/journalEntryLinesViewModel.js

@@ -0,0 +1,124 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.sortJournalEntryLines = exports.filterJournalEntryLinesExcludingLinked = exports.journalEntryTotalsByPostingSide = exports.sumJournalEntryAmounts = exports.journalEntryDefaultSortConfig = exports.toJournalEntrySortKey = exports.JOURNAL_ENTRY_SORT_KEYS = void 0;
+const orderBy_1 = __importDefault(require("lodash/orderBy"));
+const stringToUnion_1 = require("../../commonStateTypes/stringToUnion");
+/**
+ * View-model helpers for the new Journal Entry table view (see
+ * web-components `journalEntryTable`). Keeps presentation-agnostic
+ * logic — totals, sort, line-filter — colocated in epic-state so it
+ * is testable and reusable.
+ */
+// ---------------------------------------------------------------------------
+// Sort keys
+// ---------------------------------------------------------------------------
+exports.JOURNAL_ENTRY_SORT_KEYS = [
+    'description',
+    'name',
+    'category',
+    'class',
+    'debit',
+    'credit',
+];
+const toJournalEntrySortKey = (v) => (0, stringToUnion_1.stringToUnion)(v, exports.JOURNAL_ENTRY_SORT_KEYS);
+exports.toJournalEntrySortKey = toJournalEntrySortKey;
+exports.journalEntryDefaultSortConfig = {
+    sortKey: 'description',
+    sortOrder: 'ascending',
+};
+/**
+ * Sums the `amount.amount` field of every line and returns an `Amount`
+ * whose currencyCode/currencySymbol are taken from the first line.
+ * Returns `undefined` for an empty list.
+ *
+ * Mirrors legacy `calculateTotal` in
+ * `web-components/src/components/transactionDetail/items/TransactionLinesJournalEntry.tsx`
+ * but without the `Object.assign` ceremony and with stable currency carry-over.
+ */
+const sumJournalEntryAmounts = (lines) => {
+    if (lines.length === 0) {
+        return undefined;
+    }
+    const first = lines[0].amount;
+    let total = 0;
+    for (const line of lines) {
+        total += line.amount?.amount ?? 0;
+    }
+    return {
+        amount: total,
+        currencyCode: first?.currencyCode ?? '',
+        currencySymbol: first?.currencySymbol ?? '',
+    };
+};
+exports.sumJournalEntryAmounts = sumJournalEntryAmounts;
+/**
+ * Splits `lines` by `postingType` into debit/credit totals.
+ *
+ * Fixes the operator-precedence bug from legacy
+ * `calculateCombinedTotalAmount` where
+ * `totalAmount?.amount ?? 0 + (...) + (...)` parses as
+ * `totalAmount?.amount ?? (0 + ... + ...)` so the `(...)`'s only get
+ * added when `totalAmount` is nullish. The new implementation just sums
+ * every debit (or credit) line including the un/miscategorized ones in
+ * one pass, so the result is always the true sum.
+ */
+const journalEntryTotalsByPostingSide = (lines) => {
+    const debitLines = [];
+    const creditLines = [];
+    for (const line of lines) {
+        if (line.postingType === 'debit') {
+            debitLines.push(line);
+        }
+        else if (line.postingType === 'credit') {
+            creditLines.push(line);
+        }
+    }
+    return {
+        debitTotal: (0, exports.sumJournalEntryAmounts)(debitLines),
+        creditTotal: (0, exports.sumJournalEntryAmounts)(creditLines),
+    };
+};
+exports.journalEntryTotalsByPostingSide = journalEntryTotalsByPostingSide;
+// ---------------------------------------------------------------------------
+// Filter
+// ---------------------------------------------------------------------------
+/**
+ * Drops `linked_transaction_line` entries — equivalent to legacy
+ * `filterOutLinkedTransactionLine` in `transactionDetail.helpers.ts`.
+ */
+const filterJournalEntryLinesExcludingLinked = (lines) => lines?.filter((line) => line.type !== 'linked_transaction_line') ?? [];
+exports.filterJournalEntryLinesExcludingLinked = filterJournalEntryLinesExcludingLinked;
+const sortOrderToLodash = (sortOrder) => sortOrder === 'descending' ? 'desc' : 'asc';
+/**
+ * Stable, accessor-driven sort over arbitrary line shapes. Lines that
+ * resolve to the same key value preserve their original relative order
+ * thanks to lodash's stable `orderBy`.
+ *
+ * Strings are lower-cased before comparison so the order is predictable
+ * across mixed-case data. Numbers (debit/credit) compare directly.
+ */
+const sortJournalEntryLines = (lines, config, accessors) => {
+    const accessor = (line) => {
+        switch (config.sortKey) {
+            case 'description':
+                return accessors.description(line).toLowerCase();
+            case 'name':
+                return accessors.name(line).toLowerCase();
+            case 'category':
+                return accessors.category(line).toLowerCase();
+            case 'class':
+                return accessors.class(line).toLowerCase();
+            case 'debit':
+                return accessors.debit(line);
+            case 'credit':
+                return accessors.credit(line);
+            default:
+                return accessors.description(line).toLowerCase();
+        }
+    };
+    return (0, orderBy_1.default)([...lines], [accessor], [sortOrderToLodash(config.sortOrder)]);
+};
+exports.sortJournalEntryLines = sortJournalEntryLines;

package/lib/view/transactionDetail/journalEntryLinesViewModel.vitest.d.ts

@@ -0,0 +1 @@
+export {};