@zeniai/web-components 4.3.76 → 4.3.77

package/dist/components/expenseAutomation/ExpenseAutomationPage.d.ts

@@ -5,6 +5,7 @@ import { DownloadJEScheduleParams } from '../jeSchedules/downloadJESchedules/typ
 import { ReportTreeScrollPosition } from '../reportTree/ReportTree';
 import { ExpenseAutomationThreadClickTarget } from './components/ExpenseAutomationCommentingShell';
 import { MonthEndReportPageProps } from './components/TableSection';
+import { ActualMatchingActionProps } from './sections/actualMatching/actualMatchingTypes';
 import { JEAccrualFeedbackReason } from './sections/jeSchedules/accrualDetail/JEAccrualFeedbackDialog';
 import { FormData as JEScheduleAccountSettingsFormData } from './sections/jeSchedules/common/JEScheduleAccountSettings';
 import { JEScheduleNewEntrySelection } from './sections/jeSchedules/common/JEScheduleNewEntryButton';
@@ -15,7 +16,7 @@ import { TransferDrawerTransactionData } from './sections/transactionCategorizat
 /**
  * Component & its Props
  */
-export interface ExpenseAutomationPageProps extends MonthEndReportPageProps {
+export interface ExpenseAutomationPageProps extends MonthEndReportPageProps, ActualMatchingActionProps {
     accountListNestedAccountHierarchy: NestedAccountHierarchyForReport[];
     authParams: AuthParams;
     baseTransactionSearchFetchState: FetchStateAndError;
@@ -69,6 +70,12 @@ export interface ExpenseAutomationPageProps extends MonthEndReportPageProps {
     isCreateTransferEntryFromExpenseEnabled?: boolean;
     /** Gates close-management commenting across the 4 tabs. */
     isExpenseAutomationCommentingEnabled?: boolean;
+    /**
+     * Match quick view, named apart from page-level `panelContent` the same way
+     * `schedulePanelContent` is. Actual Matching renders its own SidePanelLayout
+     * so the KPI strip stays full-width above the split.
+     */
+    isMatchPanelOpen?: boolean;
     /** Transaction categorization only: when true, the right rail is expanded. */
     isRightPanelOpen?: boolean;
     /**
@@ -82,6 +89,7 @@ export interface ExpenseAutomationPageProps extends MonthEndReportPageProps {
      */
     isSchedulePanelOpen?: boolean;
     loggedInUser?: LoggedInUser;
+    matchPanelContent?: ReactNode;
     newAccrualAccountsView?: NewAccrualAccountsView;
     /** The draft this form was last left with, for a host that stores it. */
     newScheduleLocalData?: NewScheduleSaveFormValues;
@@ -193,10 +201,12 @@ export interface ExpenseAutomationPageProps extends MonthEndReportPageProps {
     updateSectionIdsForReview: (sectionIds: FluxAnalysisSectionType[]) => void;
     updateSelectedVendorForTransaction: (selectedTab: ExpenseAutomationTransactionsTab, transactionId: ID, lineId: ID, selectedTransaction: SupportedTransactionWithCOT, updatedVendor?: VendorBase) => void;
     /**
-     * When set (e.g. from `withTransactionSidePanel` in the host app), closing the transaction
-     * quick-view / side panel on Missing Receipts sub-tab changes avoids a stale panel over Unmatched
-     * or Completed lists.
+     * When set (e.g. from `withTransactionSidePanel` in the host app), closing
+     * the open quick-view on Missing Receipts sub-tab changes or JE page tab
+     * changes avoids a stale panel over the newly selected list. Match QV is
+     * closed via `closeMatchSidePanel` instead — it is not page-level.
      */
+    closeMatchSidePanel?: () => void;
     closeSidePanel?: () => void;
     onAccountExclude?: (accountId: ID) => void;
     onAccountInclude?: (accountId: ID) => void;

package/dist/components/expenseAutomation/components/navbarHeaderData.d.ts

@@ -47,5 +47,10 @@ missingReceiptsOptions?: {
  * `missing_receipts`, `flux_analysis`, `je_schedules`). Gated by
  * `is_expense_automation_commenting_enabled`.
  */
-isExpenseAutomationCommentingEnabled?: boolean, receiptsEmail?: string) => ExpenseAutomationNavbarHeaderData;
+isExpenseAutomationCommentingEnabled?: boolean, receiptsEmail?: string, 
+/**
+ * Cron-2 live gate (`is_accrual_enabled`). Off hides the Actual Matching JE
+ * subtab — there are no one-time accruals to match.
+ */
+isAccrualEnabled?: boolean) => ExpenseAutomationNavbarHeaderData;
 export {};

package/dist/components/expenseAutomation/sections/actualMatching/ActualMatchingKpiStrip.d.ts

@@ -0,0 +1,9 @@
+import { Amount, MonthYearPeriod } from '@zeniai/client-epic-state';
+import { ActualMatchingKpiSummary } from './actualMatchingTypes';
+export interface ActualMatchingKpiStripProps {
+    displayCurrency: Amount;
+    kpiSummary: ActualMatchingKpiSummary;
+    selectedPeriod: MonthYearPeriod;
+}
+declare function ActualMatchingKpiStrip({ displayCurrency, kpiSummary, selectedPeriod, }: Readonly<ActualMatchingKpiStripProps>): import("react/jsx-runtime").JSX.Element;
+export default ActualMatchingKpiStrip;

package/dist/components/expenseAutomation/sections/actualMatching/ActualMatchingList.d.ts

@@ -0,0 +1,13 @@
+import { SortOrder } from '@zeniai/client-epic-state';
+import { ActualMatchingRow, ActualMatchingSortKey, ActualMatchingViewUIState } from './actualMatchingTypes';
+export interface ActualMatchingListProps {
+    pendingReview: ActualMatchingRow[];
+    reversed: ActualMatchingRow[];
+    sortKey?: ActualMatchingSortKey;
+    sortOrder?: SortOrder;
+    onOpenMatch: (matchId: string) => void;
+    onOpenMatchNewModal?: (matchId: string) => void;
+    onUpdateActualMatchingUIState?: (uiState: Partial<ActualMatchingViewUIState>) => void;
+}
+declare function ActualMatchingList({ pendingReview, reversed, onOpenMatch, onOpenMatchNewModal, onUpdateActualMatchingUIState, sortKey, sortOrder, }: Readonly<ActualMatchingListProps>): import("react/jsx-runtime").JSX.Element;
+export default ActualMatchingList;

package/dist/components/expenseAutomation/sections/actualMatching/ActualMatchingListRow.d.ts

@@ -0,0 +1,11 @@
+import { ActualMatchingColumnKey } from './actualMatchingListConfig';
+import { ActualMatchingRow } from './actualMatchingTypes';
+export interface ActualMatchingListRowProps {
+    columns: ActualMatchingColumnKey[];
+    gridTemplateColumns: string;
+    row: ActualMatchingRow;
+    onOpenMatch: (matchId: string) => void;
+    onOpenMatchNewModal?: (matchId: string) => void;
+}
+declare function ActualMatchingListRow({ columns, gridTemplateColumns, row, onOpenMatch, onOpenMatchNewModal, }: Readonly<ActualMatchingListRowProps>): import("react/jsx-runtime").JSX.Element;
+export default ActualMatchingListRow;

package/dist/components/expenseAutomation/sections/actualMatching/ActualMatchingMatchDetailPage.d.ts

@@ -0,0 +1,21 @@
+import { FetchState, MatchAndReverseResult, UndoReversalResult } from '@zeniai/client-epic-state';
+import { ActualMatchingMatch } from './actualMatchingTypes';
+export interface ActualMatchingMatchDetailPageProps {
+    detailFetchState: FetchState;
+    refreshStatus: FetchState;
+    isRenderedInPanel?: boolean;
+    isUndoInFlight?: boolean;
+    lastMatchResults?: MatchAndReverseResult[];
+    lastUndoResults?: UndoReversalResult[];
+    match?: ActualMatchingMatch;
+    onNavigateBack: () => void;
+    onRefresh: () => void;
+    onContinueMatch?: () => void;
+    onOpenBill?: (txn: {
+        id: string;
+        type: string;
+    }) => void;
+    onUndoReversal?: (accrualIds: string[]) => void;
+}
+declare function ActualMatchingMatchDetailPage({ detailFetchState, isRenderedInPanel, isUndoInFlight, match, onNavigateBack, onRefresh, onOpenBill, onContinueMatch, onUndoReversal, lastMatchResults, lastUndoResults, refreshStatus, }: Readonly<ActualMatchingMatchDetailPageProps>): import("react/jsx-runtime").JSX.Element;
+export default ActualMatchingMatchDetailPage;

package/dist/components/expenseAutomation/sections/actualMatching/ActualMatchingMatchNewButton.d.ts

@@ -0,0 +1,5 @@
+export interface ActualMatchingMatchNewButtonProps {
+    onClick: () => void;
+}
+declare function ActualMatchingMatchNewButton({ onClick, }: Readonly<ActualMatchingMatchNewButtonProps>): import("react/jsx-runtime").JSX.Element;
+export default ActualMatchingMatchNewButton;

package/dist/components/expenseAutomation/sections/actualMatching/ActualMatchingPage.d.ts

@@ -0,0 +1,22 @@
+import { ReactNode } from 'react';
+import { MonthYearPeriod } from '@zeniai/client-epic-state';
+import { ActualMatchingActionProps, ExpenseAutomationActualMatchingViewSelector } from './actualMatchingTypes';
+export interface ActualMatchingPageProps extends ActualMatchingActionProps {
+    actualMatching: ExpenseAutomationActualMatchingViewSelector;
+    selectedPeriod: MonthYearPeriod;
+    /**
+     * Match quick view, named apart from the page-level `panelContent` that drives
+     * transaction and reconciliation. This section renders the split so the KPI
+     * strip stays full-width above it.
+     *
+     * There is no full-view flag: expanding leaves for the match's own page.
+     */
+    isMatchPanelOpen?: boolean;
+    matchPanelContent?: ReactNode;
+}
+export declare function ActualMatchingPageKpis({ actualMatching, selectedPeriod, }: Readonly<{
+    actualMatching: ExpenseAutomationActualMatchingViewSelector;
+    selectedPeriod: MonthYearPeriod;
+}>): import("react/jsx-runtime").JSX.Element;
+declare function ActualMatchingPage({ actualMatching, isMatchPanelOpen, matchPanelContent, onClearMatchNewModal, onCloseMatchNewModal, onMatchAndReverse, onOpenMatch, onOpenMatchNewModal, onSearchMatchAccruals, onSearchMatchTransactions, onUpdateActualMatchingUIState, selectedPeriod, }: Readonly<ActualMatchingPageProps>): import("react/jsx-runtime").JSX.Element;
+export default ActualMatchingPage;

package/dist/components/expenseAutomation/sections/actualMatching/ActualMatchingPageSkeleton.d.ts

@@ -0,0 +1,3 @@
+export declare function ActualMatchingKpiStripSkeleton(): import("react/jsx-runtime").JSX.Element;
+declare function ActualMatchingPageSkeleton(): import("react/jsx-runtime").JSX.Element;
+export default ActualMatchingPageSkeleton;

package/dist/components/expenseAutomation/sections/actualMatching/MatchNewModal.d.ts

@@ -0,0 +1,12 @@
+import { ActualMatchingMatchModalView, MatchAndReverseAccrualsParams, MatchNewFormData } from './actualMatchingTypes';
+export interface MatchNewModalProps {
+    matchModal: ActualMatchingMatchModalView;
+    initialFormValues?: Partial<MatchNewFormData>;
+    onClearMatchNewModal: () => void;
+    onCloseMatchNewModal: () => void;
+    onMatchAndReverse: (params: MatchAndReverseAccrualsParams) => void;
+    onSearchMatchAccruals: (query: string, pageToken?: string) => void;
+    onSearchMatchTransactions: (query: string, pageToken?: string) => void;
+}
+declare function MatchNewModal({ initialFormValues, matchModal, onClearMatchNewModal, onCloseMatchNewModal, onMatchAndReverse, onSearchMatchAccruals, onSearchMatchTransactions, }: Readonly<MatchNewModalProps>): import("react/jsx-runtime").JSX.Element;
+export default MatchNewModal;

package/dist/components/expenseAutomation/sections/actualMatching/MatchNewPreview.d.ts

@@ -0,0 +1,8 @@
+import { JEOneTimeAccrual } from '@zeniai/client-epic-state';
+import { ActualMatchingTransactionSearchResult } from './actualMatchingTypes';
+export interface MatchNewPreviewProps {
+    selectedAccruals: JEOneTimeAccrual[];
+    selectedTransactions: ActualMatchingTransactionSearchResult[];
+}
+declare function MatchNewPreview({ selectedAccruals, selectedTransactions, }: Readonly<MatchNewPreviewProps>): import("react/jsx-runtime").JSX.Element;
+export default MatchNewPreview;

package/dist/components/expenseAutomation/sections/actualMatching/ReversesGroupedPill.d.ts

@@ -0,0 +1,5 @@
+export interface ReversesGroupedPillProps {
+    label: string;
+}
+declare function ReversesGroupedPill({ label }: Readonly<ReversesGroupedPillProps>): import("react/jsx-runtime").JSX.Element;
+export default ReversesGroupedPill;

package/dist/components/expenseAutomation/sections/actualMatching/actualMatchingHelpers.d.ts

@@ -0,0 +1,76 @@
+import { Amount, ExpenseAutomationViewSelector, MonthYearPeriod, SortOrder } from '@zeniai/client-epic-state';
+import { StyledCapsuleThemeType } from '../../../common/StyledCapsule';
+import { ActualMatchingColumnKey } from './actualMatchingListConfig';
+import { ActualMatchingGroupedAccrual, ActualMatchingKpiSummary, ActualMatchingMatch, ActualMatchingRow, ActualMatchingSortKey, ActualMatchingTransactionSearchResult, ExpenseAutomationActualMatchingViewSelector } from './actualMatchingTypes';
+export declare const EMPTY_ACTUAL_MATCHING_KPI_SUMMARY: ActualMatchingKpiSummary;
+export declare const EMPTY_ACTUAL_MATCHING_VIEW: ExpenseAutomationActualMatchingViewSelector;
+export declare function getActualMatchingFromSelector(selector: ExpenseAutomationViewSelector): ExpenseAutomationActualMatchingViewSelector;
+export declare function getAccruedAmount(row: ActualMatchingRow): number;
+export declare function getActualAmount(row: ActualMatchingRow): number | undefined;
+export declare function getActualMatchingAmount(row: ActualMatchingRow): number;
+export declare function getVariancePercent(row: ActualMatchingRow): number | undefined;
+export declare function formatVariancePercent(percent: number): string;
+export declare function getVarianceCapsuleType(percent: number): StyledCapsuleThemeType;
+export declare function getMatchTierKey(row: ActualMatchingRow): string | undefined;
+export declare function getMatchTierLabel(row: ActualMatchingRow): string;
+export declare function getMatchTierCapsuleType(row: ActualMatchingRow): StyledCapsuleThemeType;
+export declare function getActualMatchingTypeLabel(row: ActualMatchingRow): string;
+export declare function getActualMatchingTypeCapsuleType(row: ActualMatchingRow): StyledCapsuleThemeType;
+export declare function formatActualMatchingServiceMonth(serviceMonth: string): string;
+export declare function formatActualMatchingServiceMonths(months: readonly string[]): string;
+export declare function getActualMatchingServiceMonths(row: ActualMatchingRow): string[];
+export declare function getActualMatchingServiceLabel(row: ActualMatchingRow): string;
+export declare function getReceivedLabel(row: ActualMatchingRow): string;
+export declare function getReversesGroupedCount(row: ActualMatchingRow): number;
+export declare function isGroupedActualMatchingRow(row: ActualMatchingRow): boolean;
+export declare function isGroupedAccrualMenuInteractive(_row: ActualMatchingRow): boolean;
+export declare function getGroupedAccrualMenuItems(row: ActualMatchingRow): ActualMatchingGroupedAccrual[];
+export declare function getReversesLabel(row: ActualMatchingRow): string;
+export declare function getReversesTooltip(row: ActualMatchingRow): string;
+export declare function isSameMatchVendor(transaction: {
+    vendorName: string;
+    vendorId?: string;
+}, accrual: {
+    vendorName: string;
+    vendorId?: string;
+}): boolean;
+export declare function getAccruedDisplayAmount(row: ActualMatchingRow): Amount;
+export declare function getActualDisplayAmount(row: ActualMatchingRow): Amount | undefined;
+export declare function sumRowDisplayAmount(rows: ActualMatchingRow[]): Amount;
+export declare function getActualMatchingDisplayCurrency(rows: ActualMatchingRow[]): Amount;
+export declare function formatKpiAmount(amount: number, currency: Amount): string;
+export declare function formatActualMatchingKpiMonth(period: MonthYearPeriod): string;
+export declare function formatGroupAmountSubtitle(template: string, amount: Amount): string;
+export declare function isAiCreatedAccrual(row: ActualMatchingRow): boolean;
+export declare function isHumanReversedRow(row: ActualMatchingRow): boolean;
+export declare function isAiReversedBy(row: ActualMatchingRow): boolean;
+export declare function getReversedByLabel(row: ActualMatchingRow): string;
+export declare function getColumnKeyForActualMatchingSortKey(sortKey: ActualMatchingSortKey): ActualMatchingColumnKey;
+export declare function getActualMatchingColumnSortValue(row: ActualMatchingRow, columnKey: ActualMatchingColumnKey): string | number | null;
+export declare function sortActualMatchingRowsByColumn(rows: ActualMatchingRow[], columnKey: ActualMatchingColumnKey, sortOrder: SortOrder): ActualMatchingRow[];
+export declare function getUndoReversalAccrualIds(row: Pick<ActualMatchingRow, "accrualId" | "groupedMembers">): string[];
+export declare function getMatchedBillTransaction(match: Pick<ActualMatchingMatch, "members" | "transactionType">): {
+    id: string;
+    type: string;
+} | null;
+export declare function getUndoReversalAccrualIdsFromMatch(match: Pick<ActualMatchingMatch, "members">): string[];
+export declare function getLeftoverWarningTooltip(row: ActualMatchingRow): string;
+export declare function pruneSelectionToVisibleResults(currentKeys: string[], visibleKeys: ReadonlySet<string>, searchFetchState: string): string[];
+export declare function nextSelectedTransactionLines(currentKeys: string[], clickedKey: string, results: ActualMatchingTransactionSearchResult[]): string[];
+export declare function pickPrefillTransactionLines(results: ActualMatchingTransactionSearchResult[], prefill?: {
+    actualAmount?: number;
+    consumedLineIds?: string[];
+    matchedLineId?: string;
+    matchedTransactionId?: string;
+}): string[];
+export declare function pickPrefillTransactionLine(results: ActualMatchingTransactionSearchResult[], prefill?: {
+    actualAmount?: number;
+    matchedLineId?: string;
+    matchedTransactionId?: string;
+}): string | null;
+export declare function shouldPromptSelectMatchLine({ isTxnSearchComplete, lineCount, openedFromMatchId, selectedLineKey, }: {
+    isTxnSearchComplete: boolean;
+    lineCount: number;
+    selectedLineKey: string | null;
+    openedFromMatchId?: string;
+}): boolean;

package/dist/components/expenseAutomation/sections/actualMatching/actualMatchingHelpers.test.d.ts

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

package/dist/components/expenseAutomation/sections/actualMatching/actualMatchingListConfig.d.ts

@@ -0,0 +1,12 @@
+import { ActualMatchingSortKey } from './actualMatchingTypes';
+export type ActualMatchingColumnKey = "received" | "vendor" | "type" | "reversedBy" | "service" | "reverses" | "matchTier" | "accrued" | "actual" | "variance";
+export interface ActualMatchingHeaderItem {
+    key: ActualMatchingColumnKey;
+    sortable: boolean;
+    value: string;
+    width: number;
+    sortKey?: ActualMatchingSortKey;
+}
+export declare function isActualMatchingNumericColumn(key: ActualMatchingColumnKey): boolean;
+export declare function getActualMatchingColumns(isQuickViewMode?: boolean): ActualMatchingHeaderItem[];
+export declare function buildActualMatchingGridTemplate(columns: ActualMatchingHeaderItem[]): string;

package/dist/components/expenseAutomation/sections/actualMatching/actualMatchingMatchDetailHelpers.d.ts

@@ -0,0 +1,18 @@
+import { FetchState, JEOneTimeAccrual } from '@zeniai/client-epic-state';
+import { ActualMatchingMatch, ActualMatchingRowKind } from './actualMatchingTypes';
+export declare function getMatchServiceMonthsLabel(members: readonly JEOneTimeAccrual[]): string;
+export declare function getMatchSubtitle(match: ActualMatchingMatch): string;
+export declare function getMatchStatusLabel(kind: ActualMatchingRowKind, labels: {
+    statusAutoReversed: string;
+    statusManuallyReversed: string;
+    statusPendingReview: string;
+}): string;
+export declare function getMatchVariancePercent(match: ActualMatchingMatch): number | null;
+export declare function formatMatchVarianceLabel(match: ActualMatchingMatch): string | null;
+export declare function isMatchRefreshSpinning(match: ActualMatchingMatch | undefined, detailFetchState: FetchState, refreshStatus: FetchState): boolean;
+export declare function getOpenMatchedTransactionLabel(transactionType: string, labels: {
+    openTransaction: string;
+}): string;
+export declare function getMatchedTransactionSectionTitle(transactionType: string, titles: {
+    matchedTransaction: string;
+}): string;

package/dist/components/expenseAutomation/sections/actualMatching/actualMatchingMatchDetailHelpers.test.d.ts

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

package/dist/components/expenseAutomation/sections/actualMatching/actualMatchingTypes.d.ts

@@ -0,0 +1,134 @@
+import { ExpenseAutomationActualMatchingSortKey as ActualMatchingSortKey, ActualMatchingTransactionSearchResult, ExpenseAutomationActualMatchingViewUIState as ActualMatchingViewUIState, Amount, FetchStateAndError, ID, JEOneTimeAccrual, MatchAndReverseAccrualsParams, MatchAndReverseResult, MatchAndReverseResultStatus, UndoReversalAccrualsParams, UndoReversalResult, UndoReversalResultStatus, ZeniDate } from '@zeniai/client-epic-state';
+export type { ActualMatchingSortKey, ActualMatchingTransactionSearchResult, ActualMatchingViewUIState, MatchAndReverseAccrualsParams, MatchAndReverseResult, MatchAndReverseResultStatus, UndoReversalAccrualsParams, UndoReversalResult, UndoReversalResultStatus, };
+/**
+ * WC-only Actual Matching types (page tab, list row extensions, form, handlers).
+ * CES-owned result/params types are imported from `@zeniai/client-epic-state`.
+ */
+export declare const ACTUAL_MATCHING_PAGE_TAB: "actual_matching";
+export type ActualMatchingPageTab = typeof ACTUAL_MATCHING_PAGE_TAB;
+export type ActualMatchingRowKind = "auto_reversed" | "pending_review" | "manually_reversed";
+export type ActualMatchingCleared = NonNullable<JEOneTimeAccrual["cleared"]> & {
+    accrualIds?: ID[];
+    groupSum?: Amount;
+};
+export type ActualMatchingGroupedAccrual = {
+    accrualId: ID;
+    estimatedAmount?: Amount;
+    jeDebitAccountName?: string;
+    memo?: string;
+    serviceMonth?: string;
+};
+export type ActualMatchingRow = JEOneTimeAccrual & {
+    kind: ActualMatchingRowKind;
+    matchId: string;
+    accruedAmount?: Amount;
+    actualAmount?: Amount;
+    cleared?: ActualMatchingCleared;
+    groupedAccrualIds?: ID[];
+    groupedMembers?: ActualMatchingGroupedAccrual[];
+    intendedAccrualIds?: ID[];
+    leftovers?: ActualMatchingGroupedAccrual[];
+    matchShape?: string;
+    matchSuggestion?: JEOneTimeAccrual["matchSuggestion"] & {
+        matchedLineId?: string;
+        matchTier?: string;
+    };
+    matchTier?: string;
+    reversalDate?: ZeniDate;
+    reversedBy?: JEOneTimeAccrual["createdBy"];
+    transactionDate?: string;
+    transactionType?: string;
+};
+export interface ActualMatchingKpiSummary {
+    actualsReceived: {
+        count: number;
+        expectedCount: number;
+        vendorsPending: number;
+    };
+    autoReversed: {
+        clearedAmount: number;
+        count: number;
+        percent: number;
+    };
+    pendingReview: {
+        amount: number;
+        count: number;
+        estimatedMinutesToClear: number;
+    };
+    variance: {
+        averagePercentPerMatch: number;
+        netAmount: number;
+        percent: number;
+    };
+}
+export interface ActualMatchingMatchModalView {
+    accrualSearch: {
+        fetchState: FetchStateAndError;
+        isLoadingMore: boolean;
+        nextPageToken: string | null;
+        query: string;
+        results: JEOneTimeAccrual[];
+    };
+    confirmStatus: FetchStateAndError;
+    isOpen: boolean;
+    transactionSearch: {
+        fetchState: FetchStateAndError;
+        isLoadingMore: boolean;
+        nextPageToken: string | null;
+        query: string;
+        results: ActualMatchingTransactionSearchResult[];
+    };
+    lastBatchResults?: MatchAndReverseResult[];
+    openedFromMatchId?: string;
+    prefill?: {
+        selectedAccrualIds: string[];
+        actualAmount?: number;
+        consumedLineIds?: string[];
+        matchedLineId?: string;
+        matchedTransactionId?: string;
+    };
+}
+export interface ExpenseAutomationActualMatchingViewSelector {
+    fetchState: FetchStateAndError["fetchState"];
+    hasLoadedForSelectedPeriod: boolean;
+    kpiSummary: ActualMatchingKpiSummary;
+    matchModal: ActualMatchingMatchModalView;
+    pendingReview: ActualMatchingRow[];
+    refreshStatus: FetchStateAndError;
+    reversed: ActualMatchingRow[];
+    uiState: ActualMatchingViewUIState;
+    error?: FetchStateAndError["error"];
+}
+export interface ActualMatchingMatch {
+    accruedAmount: Amount;
+    actualAmount: Amount;
+    kind: ActualMatchingRowKind;
+    matchId: string;
+    members: JEOneTimeAccrual[];
+    transactionIntegrationId: ID;
+    transactionType: string;
+    leftovers?: JEOneTimeAccrual[];
+    matchShape?: string;
+    matchTier?: string;
+    transactionDate?: string;
+    vendorId?: ID;
+    vendorName?: string;
+}
+export interface ActualMatchingActionProps {
+    onClearMatchNewModal: () => void;
+    onCloseMatchNewModal: () => void;
+    onMatchAndReverse: (params: MatchAndReverseAccrualsParams) => void;
+    onOpenMatch: (matchId: string) => void;
+    onOpenMatchNewModal: (matchId?: string) => void;
+    onSearchMatchAccruals: (query: string, pageToken?: string) => void;
+    onSearchMatchTransactions: (query: string, pageToken?: string) => void;
+    onUpdateActualMatchingUIState?: (uiState: Partial<ActualMatchingViewUIState>) => void;
+}
+export declare const MATCH_NEW_FORM = "expenseAutomationMatchNew";
+export type MatchNewFormData = {
+    selectedAccrualIds: string[];
+    selectedTransactionLines: string[];
+};
+export declare const MATCH_ACCRUAL_SELECTION_CAP = 50;
+export declare function getTransactionLineKey(transactionId: string, lineId: string): string;
+export declare function isActualMatchingPageTab(tab: string | undefined): tab is ActualMatchingPageTab;

package/dist/components/expenseAutomation/sections/actualMatching/matchNewPreviewHelpers.d.ts

@@ -0,0 +1,12 @@
+import { JEOneTimeAccrual, ZeniDate } from '@zeniai/client-epic-state';
+import { ActualMatchingTransactionSearchResult } from './actualMatchingTypes';
+export declare function formatServiceMonthLabel(serviceMonth: string): string;
+export declare function formatAccrualJeDate(serviceMonth: string, lastDayLabel: string): string;
+export declare function formatJeShortDate(dateValue: string): string;
+export declare function formatReversalJeDate(reversalPostingDate?: ZeniDate): string;
+export declare function sumAccruedAmount(accruals: readonly JEOneTimeAccrual[]): number;
+export declare function variancePercent(transactionAmount: number, accruedAmount: number): number | null;
+export declare function uniqueServiceMonthLabel(accruals: readonly JEOneTimeAccrual[]): string | null;
+export declare function transactionMatchLabel(transaction: ActualMatchingTransactionSearchResult, accruals: readonly JEOneTimeAccrual[]): string;
+export declare function creditAccountName(accrual: JEOneTimeAccrual, fallback: string): string;
+export declare function debitAccountName(accrual: JEOneTimeAccrual, fallback: string): string;

package/dist/components/expenseAutomation/sections/actualMatching/matchNewPreviewHelpers.test.d.ts

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

package/dist/components/expenseAutomation/sections/actualMatching/stories/ActualMatchingPageQuickViewStoryParts.d.ts

@@ -0,0 +1,10 @@
+import { FetchState } from '@zeniai/client-epic-state';
+import { ActualMatchingMatch } from '../actualMatchingTypes';
+export interface ActualMatchingTabQuickViewProps {
+    detailFetchState?: FetchState;
+    initiallyOpen?: boolean;
+    match?: ActualMatchingMatch;
+    refreshStatus?: FetchState;
+    onOpenChange?: (isOpen: boolean) => void;
+}
+export declare function ActualMatchingTabQuickView({ detailFetchState, initiallyOpen, match: initialMatch, refreshStatus, onOpenChange, }: Readonly<ActualMatchingTabQuickViewProps>): import("react/jsx-runtime").JSX.Element;

package/dist/components/expenseAutomation/sections/jeSchedules/JESchedulePage.d.ts

@@ -1,9 +1,10 @@
 import { ExpenseAutomationViewSelector, FetchStateAndError, NestedAccountHierarchyForReport, NestedClassHierarchyForReport, NewAccrualAccountsView, NewOneTimeAccrualLocalData, ScheduleDetailsLocalDataAccruedExpenses, ScheduleTransaction, TransactionID, ZeniDate } from '@zeniai/client-epic-state';
 import { FooterFormIdType } from '../../common';
+import { ActualMatchingActionProps } from '../actualMatching/actualMatchingTypes';
 import { FormData as JEScheduleAccountSettingsFormData } from './common/JEScheduleAccountSettings';
 import { JESchedulesSectionProps } from './sections/JESchedulesSection';
 import { NewScheduleSaveFormValues } from './sections/NewJEScheduleSection';
-export interface JESchedulePageProps extends Omit<JESchedulesSectionProps, "jeSchedules" | "isAccountingClassesEnabled" | "isPanelOpen" | "panelContent" | "pendingDiscardConfirmation"> {
+export interface JESchedulePageProps extends Omit<JESchedulesSectionProps, "jeSchedules" | "isAccountingClassesEnabled" | "isPanelOpen" | "panelContent" | "pendingDiscardConfirmation">, Partial<ActualMatchingActionProps> {
     accountListNestedAccountHierarchy: NestedAccountHierarchyForReport[];
     baseTransactionSearchFetchState: FetchStateAndError;
     baseTransactionSearchResults: ScheduleTransaction[];
@@ -23,6 +24,12 @@ export interface JESchedulePageProps extends Omit<JESchedulesSectionProps, "jeSc
     /** The draft this form was last left with, for a host that stores it. */
     /** Cron-2's live gate for this company. Off hides one-time accrual creation. */
     isAccrualEnabled?: boolean;
+    /**
+     * Match quick view, named apart from page-level `panelContent` the same way
+     * `schedulePanelContent` is. Actual Matching renders its own SidePanelLayout
+     * so the KPI strip stays full-width above the split.
+     */
+    isMatchPanelOpen?: boolean;
     /**
      * Schedule side panel, named apart from the page-level `panelContent` that drives the
      * transaction and reconciliation panels: ExpenseAutomationPage spreads its own props into
@@ -31,6 +38,7 @@ export interface JESchedulePageProps extends Omit<JESchedulesSectionProps, "jeSc
      * There is no full-view flag: expanding leaves for the schedule's own page.
      */
     isSchedulePanelOpen?: boolean;
+    matchPanelContent?: React.ReactNode;
     newAccrualAccountsView?: NewAccrualAccountsView;
     newScheduleLocalData?: NewScheduleSaveFormValues;
     schedulePanelContent?: React.ReactNode;
@@ -51,5 +59,5 @@ export interface JESchedulePageProps extends Omit<JESchedulesSectionProps, "jeSc
     setResetJeAccountSettingsForm: (resetFn: () => void) => void;
     onNewScheduleFormChange?: (scheduleType: string, formValues: NewScheduleSaveFormValues) => void;
 }
-declare function JESchedulePage({ accountListNestedAccountHierarchy, baseTransactionSearchFetchState, baseTransactionSearchResults, classListNestedAccountHierarchy, expenseAutomationViewSelector, currentFooterFormId, isAccountingClassesEnabled, isCreatingNewSchedule, newScheduleSaveStatus, allDepreciationAccountListNestedAccountHierarchy, closeMonth, initialScheduleDetailsMode, initialScheduleType, newAccrualAccountsView, onCreateAccruedSchedule, onCreateOneTimeAccrual, setResetJeAccountSettingsForm, vendorSearchAutoCompleteData, onJESchedulesFormDataChange, onPostJESchedule, handleJeScheduleClick, onOneTimeAccrualClick, onOneTimeAccrualFeedback, onJeAccountSettingsChange, onSaveJeAccountSettingsClick, onSaveSchedule, onScheduleTypeChange, onSearchBaseTransaction, onViewTransaction, newScheduleLocalData, initialSelectedBaseTransaction, isAccrualEnabled, onNewScheduleFormChange, ignoreRecommendedJeSchedule, vendorSearchAutoCompleteActions, isSchedulePanelOpen, schedulePanelContent, schedulePendingDiscardConfirmation, setCurrentFooterFormId, setIsCreatingNewSchedule, setIsJeAccountSettingsOpened, onRevertJeSchedule, onToggleCreatedGroupCollapsed, onTogglePendingGroupCollapsed, onUpdateJEScheduleTypeFilter, onUpdateJESchedulesUIState, }: Readonly<JESchedulePageProps>): import("react/jsx-runtime").JSX.Element;
+declare function JESchedulePage({ accountListNestedAccountHierarchy, baseTransactionSearchFetchState, baseTransactionSearchResults, classListNestedAccountHierarchy, expenseAutomationViewSelector, currentFooterFormId, isAccountingClassesEnabled, isCreatingNewSchedule, newScheduleSaveStatus, allDepreciationAccountListNestedAccountHierarchy, closeMonth, initialScheduleDetailsMode, initialScheduleType, newAccrualAccountsView, onCreateAccruedSchedule, onCreateOneTimeAccrual, setResetJeAccountSettingsForm, vendorSearchAutoCompleteData, onJESchedulesFormDataChange, onPostJESchedule, handleJeScheduleClick, onOneTimeAccrualClick, onOneTimeAccrualFeedback, onJeAccountSettingsChange, onSaveJeAccountSettingsClick, onSaveSchedule, onScheduleTypeChange, onSearchBaseTransaction, onViewTransaction, newScheduleLocalData, initialSelectedBaseTransaction, isAccrualEnabled, onNewScheduleFormChange, ignoreRecommendedJeSchedule, vendorSearchAutoCompleteActions, isMatchPanelOpen, isSchedulePanelOpen, matchPanelContent, schedulePanelContent, schedulePendingDiscardConfirmation, setCurrentFooterFormId, setIsCreatingNewSchedule, setIsJeAccountSettingsOpened, onRevertJeSchedule, onToggleCreatedGroupCollapsed, onTogglePendingGroupCollapsed, onUpdateJEScheduleTypeFilter, onUpdateJESchedulesUIState, onClearMatchNewModal, onCloseMatchNewModal, onMatchAndReverse, onOpenMatch, onOpenMatchNewModal, onSearchMatchAccruals, onSearchMatchTransactions, onUpdateActualMatchingUIState, }: Readonly<JESchedulePageProps>): import("react/jsx-runtime").JSX.Element;
 export default JESchedulePage;

package/dist/components/expenseAutomation/sections/jeSchedules/common/JEGroupSectionHeader.d.ts

@@ -2,7 +2,8 @@ export interface JEGroupSectionHeaderProps {
     count: number;
     isCollapsed: boolean;
     title: string;
+    subtitle?: string;
     onToggle: () => void;
 }
-declare function JEGroupSectionHeader({ title, count, isCollapsed, onToggle, }: Readonly<JEGroupSectionHeaderProps>): import("react/jsx-runtime").JSX.Element;
+declare function JEGroupSectionHeader({ title, count, isCollapsed, onToggle, subtitle, }: Readonly<JEGroupSectionHeaderProps>): import("react/jsx-runtime").JSX.Element;
 export default JEGroupSectionHeader;