@zeniai/web-components 4.4.70-beta0DI → 4.4.71-beta0AN

package/dist/common/audio/wav.d.ts

@@ -0,0 +1,35 @@
+/**
+ * PCM → 16-bit mono WAV, for voice dictation uploads.
+ *
+ * The browser records raw PCM rather than using MediaRecorder because Chrome's
+ * MediaRecorder only produces `audio/webm`, which the transcription model does
+ * not accept (it takes wav/mp3/aiff/aac/ogg/flac). Encoding WAV here also makes
+ * the payload identical across browsers instead of varying by vendor codec.
+ */
+/** 16 kHz is the standard speech-recognition rate; more bandwidth buys no accuracy. */
+export declare const DICTATION_SAMPLE_RATE = 16000;
+/**
+ * Resample to a lower rate by averaging each source window.
+ *
+ * Averaging rather than picking the nearest sample: plain decimation aliases
+ * high frequencies down into the speech band as audible chirp, which costs
+ * recognition accuracy for a couple of lines of arithmetic.
+ *
+ * @param input Mono samples in [-1, 1].
+ * @param inputRate Source sample rate, typically the AudioContext's 44.1/48 kHz.
+ * @param targetRate Desired rate; must not exceed inputRate.
+ * @returns Resampled mono samples, or `input` unchanged when no downsampling is needed.
+ */
+export declare function downsample(input: Float32Array, inputRate: number, targetRate: number): Float32Array;
+/** Concatenate the captured chunks into one contiguous buffer. */
+export declare function mergeChunks(chunks: Float32Array[]): Float32Array;
+/** Root-mean-square level of a chunk, used to detect a silent microphone. */
+export declare function rms(samples: Float32Array): number;
+/**
+ * Wrap mono float samples in a canonical 44-byte RIFF/WAVE header.
+ *
+ * @param samples Mono samples in [-1, 1]; values outside are clipped, not wrapped.
+ * @param sampleRate Rate of `samples`.
+ * @returns A complete `.wav` file.
+ */
+export declare function encodeWav(samples: Float32Array, sampleRate: number): ArrayBuffer;

package/dist/common/audio/wav.test.d.ts

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

package/dist/common/hooks/useVoiceDictation.d.ts

@@ -0,0 +1,32 @@
+export interface VoiceDictationErrorMessages {
+    /** The user (or browser policy) blocked microphone access. */
+    permissionDenied: string;
+    /** Capture failed for any other reason. */
+    unavailable: string;
+}
+export interface UseVoiceDictationResult {
+    error: string | null;
+    isRecording: boolean;
+    /** True between start() and the mic actually going live (permission pending). */
+    isStarting: boolean;
+    /** False when the browser cannot capture audio — hide the control entirely. */
+    isSupported: boolean;
+    /**
+     * Latest windowed input level (RMS, 0–1), refreshed about ten times a second.
+     * A ref rather than state: a level that re-rendered the composer on every
+     * update would re-render it ten times a second for a decoration.
+     */
+    levelRef: React.MutableRefObject<number>;
+    /** Dismisses a capture error — it is otherwise only cleared by the next start(). */
+    clearError: () => void;
+    start: () => void;
+    /** `discard` drops the take instead of emitting it (e.g. the message was sent). */
+    stop: (options?: {
+        discard?: boolean;
+    }) => void;
+}
+/**
+ * @param onRecordingComplete Called with a finished WAV once recording stops.
+ *   Not called when the take held no audio, so a mis-click costs nothing.
+ */
+export declare function useVoiceDictation(onRecordingComplete: (audio: Blob) => void, errorMessages: VoiceDictationErrorMessages): UseVoiceDictationResult;

package/dist/common/hooks/useVoiceDictation.test.d.ts

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

package/dist/components/aiCfo/AiCfoPage.d.ts

@@ -168,7 +168,10 @@ export interface AiCfoPageProps {
     isRoutinesOpen?: boolean;
     /** Replaces the chat body with the Skills browser. Driven by the left-rail entry. */
     isSkillsOpen?: boolean;
+    isTranscribing?: boolean;
+    isTranscriptionFailed?: boolean;
     isUploadPromoVisible?: boolean;
+    isVoiceInputEnabled?: boolean;
     /** Debounced (300ms) flush of the card-policy RHF watch subscription. */
     onCardPolicyFormChange?: AiCfoQuestionAnswerProps["onCardPolicyFormChange"];
     /** Submission handler for the AI Card Policy interactive form. */
@@ -312,6 +315,8 @@ export interface AiCfoPageProps {
     /** Publish or unpublish in place. Absent withholds the control. */
     onSetSkillVisibility?: (macroId: string, visibility: SkillVisibility) => void;
     onUploadPromoClose?: () => void;
+    /** Receives a finished WAV recording to send for transcription. */
+    onVoiceRecordingComplete?: (audio: Blob, chatSessionId?: ID) => void;
     /**
      * Resolves a newly-created card id to a `{ title, subtitle? }` tile.
      * Used by the synthetic "Created cards" answer bubble rendered after a

package/dist/components/aiCfo/AiCfoSidePanel.d.ts

@@ -44,7 +44,10 @@ export interface AiCfoSidePanelProps {
     isInteractiveFormSubmitting?: AiCfoQuestionAnswerProps["isInteractiveFormSubmitting"];
     /** Passed by connect() / drawer; not used by panel */
     isOpen?: boolean;
+    isTranscribing?: boolean;
+    isTranscriptionFailed?: boolean;
     isUploadPromoVisible?: boolean;
+    isVoiceInputEnabled?: boolean;
     location?: unknown;
     navigate?: unknown;
     /** Debounced card-policy watch flush → `updateAiCardPolicyFormDraft`. */
@@ -87,6 +90,8 @@ export interface AiCfoSidePanelProps {
     onEmailLinkQuestionProcessed?: () => void;
     onMenuClick?: () => void;
     onUploadPromoClose?: () => void;
+    /** Receives a finished WAV recording to send for transcription. */
+    onVoiceRecordingComplete?: (audio: Blob, chatSessionId?: ID) => void;
     /**
      * Look up a newly-created card's preview tile data by `cardId`. Used by
      * the synthetic "Created cards" bubble to render the tile list. Optional

package/dist/components/aiCfo/components/AiCfoInput.d.ts

@@ -22,7 +22,13 @@ export interface AiCfoInputProps {
      */
     isCreateSkillEnabled?: boolean;
     isFileUploadEnabled?: boolean;
+    /** True while a finished recording is being transcribed server-side. */
+    isTranscribing?: boolean;
+    /** True when the last transcription request failed, so the composer can say so. */
+    isTranscriptionFailed?: boolean;
     isUploadPromoVisible?: boolean;
+    /** Gates the mic; the control also needs a browser that can capture audio. */
+    isVoiceInputEnabled?: boolean;
     selectedFiles?: FileAttachment[];
     shouldFocus?: boolean;
     /** Chat-visible skills for the `/` menu (from getSkills). */
@@ -31,6 +37,8 @@ export interface AiCfoInputProps {
     skillsEnabled?: boolean;
     /** First-person next message suggestion; shown as ghost placeholder + Tab-to-fill when the input is empty. */
     suggestedReply?: string;
+    /** Session the composer is in, snapshotted when a recording starts. */
+    voiceChatSessionId?: ID;
     onInputChange: (value: string) => void;
     onStopSubmit: () => void;
     onSubmit: () => void;
@@ -42,6 +50,8 @@ export interface AiCfoInputProps {
     /** Called when a skill is picked from the `/` menu. */
     onSelectSkill?: (skill: SkillMenuItem) => void;
     onUploadPromoClose?: () => void;
+    /** Receives a finished WAV recording plus the session it was dictated into. */
+    onVoiceRecordingComplete?: (audio: Blob, chatSessionId?: ID) => void;
 }
 declare const AiCfoInput: React.FC<AiCfoInputProps>;
 export default AiCfoInput;

package/dist/components/aiCfo/components/VoiceWaveform.d.ts

@@ -0,0 +1,10 @@
+import { default as React } from 'react';
+export interface VoiceWaveformProps {
+    levelRef: React.MutableRefObject<number>;
+}
+/**
+ * Live input level while dictating, as a strip of bars scrolling right to left.
+ * Reads the level from a ref on an interval so the composer is not re-rendered
+ * ten times a second.
+ */
+export declare const VoiceWaveform: ({ levelRef, }: VoiceWaveformProps) => React.ReactElement;

package/dist/components/aiCfo/hooks/useSyncTranscriptIntoLocalInput.d.ts

@@ -0,0 +1,16 @@
+import { MutableRefObject } from 'react';
+/** The one method this hook needs off the debounced writer — `lodash` itself is a forbidden import here. */
+interface FlushableDebouncedFunc {
+    flush: () => void;
+}
+/**
+ * Keeps the composer's local draft in step with a dictation take.
+ *
+ * The transcript is appended to Redux `currentInput` by the reducer, but the textarea
+ * renders `localInput`, which is not otherwise subscribed to Redux. Flushing the pending
+ * debounced write when transcription starts makes Redux match the draft exactly, and the
+ * composer is read-only until the take lands, so neither side can move in between — the
+ * refresh cannot drop anything typed while recording.
+ */
+export declare const useSyncTranscriptIntoLocalInput: (isTranscribing: boolean, currentInput: string, debouncedUpdateRedux: MutableRefObject<FlushableDebouncedFunc>, setLocalInput: (input: string) => void) => void;
+export {};

package/dist/components/animations/{DashboardSidebarHalloweenBottomAnimation.d.ts → DashboardHalloweenBatsAnimation.d.ts}

@@ -1,4 +1,4 @@
 declare const _default: import('react').NamedExoticComponent<{
-    animationEnabled?: boolean;
+    animationEnabled: boolean;
 }>;
 export default _default;

package/dist/components/animations/DashboardSidebarBottomAnimation.d.ts

@@ -1,6 +1,5 @@
 declare const _default: import('react').NamedExoticComponent<{
     christmasAnimationEnabled?: boolean;
-    halloweenAnimationEnabled?: boolean;
     newYearAnimationEnabled?: boolean;
     thanksGivingAnimationEnabled?: boolean;
 }>;

package/dist/components/cockpit/common/parentSubsidiaryTag/components/ParentSubsidiaryTag.d.ts

@@ -4,7 +4,9 @@ export interface Props {
     companyName: string;
     parentSubsidiaryRelationship: ParentSubsidiaryInfo;
     isEnabled?: boolean;
+    /** Overrides the "Parent" / "Subsidiary" tag text. */
+    label?: string;
     onViewDetailsLinkClicked?: (parentID: ID) => void;
 }
-declare const ParentSubsidiaryTag: ({ companyId, companyName, isEnabled, parentSubsidiaryRelationship, onViewDetailsLinkClicked, }: Props) => import("react/jsx-runtime").JSX.Element | null;
+declare const ParentSubsidiaryTag: ({ companyId, companyName, isEnabled, label, parentSubsidiaryRelationship, onViewDetailsLinkClicked, }: Props) => import("react/jsx-runtime").JSX.Element | null;
 export default ParentSubsidiaryTag;

package/dist/components/cockpit/common/userMultiSelect/UserMultiSelect.d.ts

@@ -26,8 +26,7 @@ export interface Props {
     isReadOnly?: boolean;
     pickerStyles?: Partial<PickerStyles>;
     selectedUserGroups?: UserGroup[];
-    showDropdownIndicator?: boolean;
     onSelectedUsersChanged: (selectedUsers: RoleSelectableUser[], deSelectedUsers: RoleSelectableUser[]) => void;
     onSelectedUserGroupsChanged?: (selectedUserGroups: UserGroup[]) => void;
 }
-export default function UserMultiSelect({ name, allUsers, allUserGroups, selectedUserGroups, onSelectedUserGroupsChanged, onSelectedUsersChanged, selectedUsers, disable, pickerStyles: { optionBackgroundColor, optionTextStyle, titleTextStyle, backgroundColor, titleTextAlignment, selectedOptionColor, multiValueLabelTitleStyle, }, customization: { placeholderLabel }, isReadOnly, showDropdownIndicator, }: Readonly<Props>): import("react/jsx-runtime").JSX.Element;
+export default function UserMultiSelect({ name, allUsers, allUserGroups, selectedUserGroups, onSelectedUserGroupsChanged, onSelectedUsersChanged, selectedUsers, disable, pickerStyles: { optionBackgroundColor, optionTextStyle, titleTextStyle, backgroundColor, titleTextAlignment, selectedOptionColor, multiValueLabelTitleStyle, }, customization: { placeholderLabel }, isReadOnly, }: Readonly<Props>): import("react/jsx-runtime").JSX.Element;

package/dist/components/cockpit/common/userMultiSelect/UserMultiSelectField.d.ts

@@ -16,7 +16,6 @@ export interface Props {
     pickerStyles?: Partial<PickerStyles>;
     placeholderLabel?: string;
     registerOptions?: RegisterOptions;
-    showDropdownIndicator?: boolean;
 }
-declare const UserMultiSelectField: ({ name, placeholderLabel, registerOptions, value: defaultValue, isReadOnly, showDropdownIndicator, isDisabled, pickerStyles, }: Props) => import("react/jsx-runtime").JSX.Element;
+declare const UserMultiSelectField: ({ name, placeholderLabel, registerOptions, value: defaultValue, isReadOnly, isDisabled, pickerStyles, }: Props) => import("react/jsx-runtime").JSX.Element;
 export default UserMultiSelectField;

package/dist/components/commentsAndNotes/utils/CollaborationHelpers.d.ts

@@ -49,12 +49,18 @@ export declare const isTransactionDetailFieldEntityType: (entityType: string) =>
  * those to this form on read so they still resolve.
  * Returns undefined for null balances so callers can skip commenting on empty cells.
  */
-export declare const toColumnKey: (balance: COABalance | null) => string | undefined;
+/**
+ * Column part of a cell's comment anchor.
+ *
+ * `customRangeEndDate` is the end of the custom date range the user committed
+ * on the page (see CustomDateRangeColumnContext), if any.
+ */
+export declare const toColumnKey: (balance: COABalance | null, customRangeEndDate?: string) => string | undefined;
 /**
  * Builds a per-cell entityId by combining a row-level stable ID with a column key.
  * Returns undefined if either part is missing (commenting should be disabled for that cell).
  */
-export declare const toCellEntityId: (rowStableId: string | undefined, balance: COABalance | null) => string | undefined;
+export declare const toCellEntityId: (rowStableId: string | undefined, balance: COABalance | null, customRangeEndDate?: string) => string | undefined;
 /**
  * Normalizes a column key to its canonical, timezone-independent form.
  * Date-pair keys become `YYYY-MM-DD_YYYY-MM-DD`; calculated-column keys

package/dist/components/common/ButtonWithDropDown.d.ts

@@ -1,4 +1,10 @@
 import { ReactNode } from 'react';
+/**
+ * `default` is the JE Schedules look. `iconMenu` is the Create Transaction design: a white
+ * button that opens its menu on hover anywhere over it, darkens its border while open, and
+ * shows a wider menu of {@link IconMenuItem} rows.
+ */
+export type ButtonWithDropDownVariant = "default" | "iconMenu";
 export interface ButtonWithDropDownProps {
     /**
      * Supplied by the caller rather than derived from `label`: deriving it would tie every
@@ -10,6 +16,7 @@ export interface ButtonWithDropDownProps {
     /** Shown above the chevron on hover. */
     chevronTooltip?: string;
     isDisabled?: boolean;
+    variant?: ButtonWithDropDownVariant;
     /**
      * `close` lets the caller dismiss the menu on selection without its own selection types
      * having to pass through this component. With a plain ReactNode the popover could not be
@@ -26,7 +33,7 @@ export interface ButtonWithDropDownProps {
  * The split button used for "New"-style actions: a labelled primary segment and a chevron that
  * opens a menu.
  */
-declare function ButtonWithDropDown({ dataTestId, label, renderMenu, chevronTooltip, isDisabled, onPrimaryClick, }: Readonly<ButtonWithDropDownProps>): import("react/jsx-runtime").JSX.Element;
+declare function ButtonWithDropDown({ dataTestId, label, renderMenu, chevronTooltip, isDisabled, onPrimaryClick, variant, }: Readonly<ButtonWithDropDownProps>): import("react/jsx-runtime").JSX.Element;
 export default ButtonWithDropDown;
 export declare const MenuItemLabel: import('@emotion/styled').StyledComponent<{
     theme?: import('@emotion/react').Theme;
@@ -57,3 +64,27 @@ export declare const SectionLabel: import('@emotion/styled').StyledComponent<{
 } & import('react').ClassAttributes<HTMLDivElement> & import('react').HTMLAttributes<HTMLDivElement> & {
     theme?: import('@emotion/react').Theme;
 }, {}, {}>;
+export declare const IconMenuItemIcon: import('@emotion/styled').StyledComponent<{
+    theme?: import('@emotion/react').Theme;
+    as?: React.ElementType;
+}, import('react').DetailedHTMLProps<import('react').HTMLAttributes<HTMLDivElement>, HTMLDivElement>, {}>;
+export declare const IconMenuItemText: import('@emotion/styled').StyledComponent<{
+    theme?: import('@emotion/react').Theme;
+    as?: React.ElementType;
+}, import('react').DetailedHTMLProps<import('react').HTMLAttributes<HTMLDivElement>, HTMLDivElement>, {}>;
+export declare const IconMenuItemLabel: import('@emotion/styled').StyledComponent<{
+    theme?: import('@emotion/react').Theme;
+    as?: React.ElementType;
+} & import('react').ClassAttributes<HTMLDivElement> & import('react').HTMLAttributes<HTMLDivElement> & {
+    theme?: import('@emotion/react').Theme;
+}, {}, {}>;
+export declare const IconMenuItemDescription: import('@emotion/styled').StyledComponent<{
+    theme?: import('@emotion/react').Theme;
+    as?: React.ElementType;
+} & import('react').ClassAttributes<HTMLDivElement> & import('react').HTMLAttributes<HTMLDivElement> & {
+    theme?: import('@emotion/react').Theme;
+}, {}, {}>;
+export declare const IconMenuItem: import('@emotion/styled').StyledComponent<{
+    theme?: import('@emotion/react').Theme;
+    as?: React.ElementType;
+}, import('react').DetailedHTMLProps<import('react').HTMLAttributes<HTMLDivElement>, HTMLDivElement>, {}>;

package/dist/components/common/downloadReport/types/downloadReportOptions.d.ts

@@ -30,6 +30,14 @@ export interface DownloadReportOptions {
     cashFlowProjectsToFilterOut?: ID[];
     /** Profit & Loss by class only: matches on-screen "By Class (Horizontal)" vs vertical. */
     classViewLayout?: ClassViewLayout;
+    /**
+     * Custom date range (`YYYY-MM-DD`) shown on screen; the export then covers
+     * exactly this range. Absent for the default period-based export.
+     */
+    customDateRange?: {
+        endDate: string;
+        startDate: string;
+    };
     dataAvailable?: TimeframeTick;
     disabledAdditionalColumns?: COABalanceType[];
     nestedClassHierarchy?: NestedClassHierarchyForReport[];

package/dist/components/common/downloadReport/types/downloadReportOptionsPayload.d.ts

@@ -41,6 +41,9 @@ export default interface DownloadReportOptionsPayload {
     cash_flow_classes_to_filter_out?: NestedClassID[];
     cash_flow_projects_to_filter_out?: ID[];
     class_view_layout?: ClassViewLayout;
+    /** Same names as the reports API: export exactly this range when present. */
+    custom_end_date?: string;
+    custom_start_date?: string;
     data_available?: {
         end_date: string;
         start_date: string;

package/dist/components/common/lazyLottie.d.ts

@@ -0,0 +1,8 @@
+import { ForwardRefExoticComponent, PropsWithoutRef, Ref, RefAttributes } from 'react';
+import { LottieProps } from 'react-lottie-player';
+type PlayerProps = PropsWithoutRef<LottieProps>;
+type LottieInstance = LottieProps["ref"] extends Ref<infer Instance> | undefined ? Instance : never;
+export type LazyLottieComponent = ForwardRefExoticComponent<PlayerProps & RefAttributes<LottieInstance>>;
+export declare const LottiePlayerLight: LazyLottieComponent;
+export declare const LottiePlayer: LazyLottieComponent;
+export {};

package/dist/components/common/lazyReactPdf.d.ts

@@ -0,0 +1,13 @@
+import { ComponentPropsWithoutRef } from 'react';
+import { Document as PdfDocument, Page as PdfPage } from 'react-pdf';
+type DocumentProps = ComponentPropsWithoutRef<typeof PdfDocument>;
+type PageProps = ComponentPropsWithoutRef<typeof PdfPage>;
+/**
+ * react-pdf's `Document` and `Page`, loaded on first render. Imported directly,
+ * react-pdf and pdf.js land in the first-load bundle of every app; through
+ * `import()` they load only where a PDF is shown. While the library loads,
+ * `Document` shows its own `loading` element, so the spinner is unchanged.
+ */
+export declare const Document: (props: DocumentProps) => import("react/jsx-runtime").JSX.Element;
+export declare const Page: (props: PageProps) => import("react/jsx-runtime").JSX.Element;
+export {};

package/dist/components/common/lazySvg.d.ts

@@ -0,0 +1,17 @@
+import { ComponentType, SVGProps } from 'react';
+type SvgProps = Omit<SVGProps<SVGSVGElement>, "ref">;
+/**
+ * An SVG component loaded on first render, for large SVGs (Figma exports that
+ * embed raster images as base64). Imported directly they compile into the main
+ * bundle and every page load downloads them; through `import()` each becomes
+ * its own chunk that loads only where it is shown. Same call sites and
+ * `styled()` wrappers as the directly imported component; renders nothing
+ * until its chunk arrives.
+ */
+export declare const lazySvg: (load: () => Promise<{
+    ReactComponent: ComponentType<SvgProps>;
+}>) => {
+    (props: SvgProps): import("react/jsx-runtime").JSX.Element;
+    displayName: string;
+};
+export {};

package/dist/components/common/listPageSearchInputBox/ListPageSearchInputBox.d.ts

@@ -2,6 +2,8 @@ export interface Props {
     disabled?: boolean;
     enableSearchHotkey?: boolean;
     inputWrapperStyle?: React.CSSProperties;
+    /** When true, a one-time discovery coachmark is shown anchored to the search icon. */
+    isSearchDiscoveryCoachmarkOpen?: boolean;
     keepSearchBoxOpen?: boolean;
     placeholder?: string;
     /** When set, applied to the search bar container (icon + input). */
@@ -12,7 +14,8 @@ export interface Props {
     styledSearchCancelIconWrapperStyle?: React.CSSProperties;
     styledSearchIconContainerStyle?: React.CSSProperties;
     styledSearchIconWrapperStyle?: React.CSSProperties;
+    onDismissSearchDiscoveryCoachmark?: () => void;
     onSearchOpen?: (isOpen: boolean) => void;
     onSearchTextChanged?: (text: string) => void;
 }
-export declare function ListPageSearchInputBox({ enableSearchHotkey, disabled, inputWrapperStyle, keepSearchBoxOpen, placeholder, searchBarDataTestId, searchIconMarginRight, searchText, style, styledSearchCancelIconWrapperStyle, styledSearchIconContainerStyle, styledSearchIconWrapperStyle, onSearchOpen, onSearchTextChanged, }: Readonly<Props>): import("react/jsx-runtime").JSX.Element;
+export declare function ListPageSearchInputBox({ enableSearchHotkey, disabled, inputWrapperStyle, isSearchDiscoveryCoachmarkOpen, keepSearchBoxOpen, placeholder, searchBarDataTestId, searchIconMarginRight, searchText, style, styledSearchCancelIconWrapperStyle, styledSearchIconContainerStyle, styledSearchIconWrapperStyle, onDismissSearchDiscoveryCoachmark, onSearchOpen, onSearchTextChanged, }: Readonly<Props>): import("react/jsx-runtime").JSX.Element;

package/dist/components/common/listPageSearchSection/ListPageSearchSection.d.ts

@@ -8,6 +8,8 @@ export interface ListPageSearchSectionProps {
     enableSearchHotkey?: boolean;
     hideSearchBtn?: boolean;
     inputWrapperStyle?: React.CSSProperties;
+    /** When true, a one-time discovery coachmark is shown anchored to the search icon (non-mobile). */
+    isSearchDiscoveryCoachmarkOpen?: boolean;
     /** When set, applied to each search bar container (icon + input). */
     searchBarDataTestId?: string;
     searchIconMarginRight?: string;
@@ -24,6 +26,7 @@ export interface ListPageSearchSectionProps {
     styledSearchCancelIconWrapperStyle?: React.CSSProperties;
     styledSearchIconContainerStyle?: React.CSSProperties;
     styledSearchIconWrapperStyle?: React.CSSProperties;
+    onDismissSearchDiscoveryCoachmark?: () => void;
     onSearchTextChanged?: (searchText: string) => void;
 }
 export default function ListPageSearchSection(listPageSearchSectionProps: Readonly<ListPageSearchSectionProps>): import("react/jsx-runtime").JSX.Element;

package/dist/components/common/searchDiscoveryCoachmark/SearchDiscoveryCoachmark.d.ts

@@ -0,0 +1,12 @@
+export interface SearchDiscoveryCoachmarkProps {
+    onDismiss: () => void;
+}
+/**
+ * One-time discovery coachmark rendered as the `title` of a controlled dark
+ * Tooltip anchored to the transaction search icon. Content-only — the Tooltip
+ * supplies the dark surface; the upward tick is drawn here to match the design.
+ * Dismissed via the close button or Escape (plus the search icon / Cmd+K in the
+ * host). There is deliberately no click-away: a stray click shouldn't
+ * permanently dismiss a one-time coachmark.
+ */
+export declare function SearchDiscoveryCoachmark({ onDismiss, }: Readonly<SearchDiscoveryCoachmarkProps>): import("react/jsx-runtime").JSX.Element;

package/dist/components/customers/common/CustomerHierarchyTag.d.ts

@@ -0,0 +1,10 @@
+import { CustomerSummary, ID } from '@zeniai/client-epic-state';
+/**
+ * A sub-customer's or project's tag (like cockpit's Subsidiary tag). With its parent and `onParentClick`, its popover
+ * shows the parent, with View Details opening it; otherwise it's a plain tag.
+ */
+export declare function CustomerHierarchyTag({ customer, onParentClick, }: Readonly<{
+    customer: CustomerSummary;
+    onParentClick?: (id: ID) => void;
+}>): import("react/jsx-runtime").JSX.Element | null;
+export default CustomerHierarchyTag;

package/dist/components/customers/common/CustomerNameCell.d.ts

@@ -0,0 +1,7 @@
+import { CustomerSummary, ID } from '@zeniai/client-epic-state';
+/** A customer's initials avatar (like the vendor list's) and name, with its Sub-customer / Project tag. */
+export declare function CustomerNameCell({ customer, onParentClick, }: Readonly<{
+    customer: CustomerSummary;
+    onParentClick?: (id: ID) => void;
+}>): import("react/jsx-runtime").JSX.Element;
+export default CustomerNameCell;

package/dist/components/customers/customerDetail/CustomerDetailPage.d.ts

@@ -17,6 +17,8 @@ export interface CustomerDetailPageProps {
         timePeriod: TimeframeTick;
     };
     allTransactionsView?: TransactionListByEntityView;
+    /** Tenant setting: the figures cover the customer's sub-customers and projects too. */
+    includeSubCustomersInTotals?: boolean;
     panelContent?: ReactNode;
     sidePanelIsFullView?: boolean;
     sidePanelIsOpen?: boolean;
@@ -26,6 +28,8 @@ export interface CustomerDetailPageProps {
     onTabChange: (tab: CustomerDetailTabType) => void;
     onTrendFilterChange: (filter: VendorSpendTrendFilterTabType) => void;
     onBackClick?: () => void;
+    /** Opens another customer's details: one in its family tree, or its parent from the tag. */
+    onCustomerClick?: (customerId: ID) => void;
     onTransactionItemClick?: (id: TransactionID) => void;
     onTrendRetry?: () => void;
     onTrendSelectedPeriodChange?: (selectedPeriod?: {
@@ -34,5 +38,5 @@ export interface CustomerDetailPageProps {
         currentTimePeriod?: TimeframeTick;
     }) => void;
 }
-export declare function CustomerDetailPage({ allTransactionsTabData, allTransactionsView, detailView, firstMonthOfFY, panelContent, readOnlyMode, selectedTab, sidePanelIsFullView, sidePanelIsOpen, trendFilter, trendWithTransactions, onBackClick, onLoadPreviousTransactionsClick, onSave, onTabChange, onTransactionItemClick, onTrendFilterChange, onTrendRetry, onTrendSelectedPeriodChange, }: Readonly<CustomerDetailPageProps>): import("react/jsx-runtime").JSX.Element;
+export declare function CustomerDetailPage({ allTransactionsTabData, allTransactionsView, detailView, firstMonthOfFY, includeSubCustomersInTotals, panelContent, readOnlyMode, selectedTab, sidePanelIsFullView, sidePanelIsOpen, trendFilter, trendWithTransactions, onBackClick, onCustomerClick, onLoadPreviousTransactionsClick, onSave, onTabChange, onTransactionItemClick, onTrendFilterChange, onTrendRetry, onTrendSelectedPeriodChange, }: Readonly<CustomerDetailPageProps>): import("react/jsx-runtime").JSX.Element;
 export default CustomerDetailPage;

package/dist/components/customers/customerDetail/CustomerFamilyTree.d.ts

@@ -0,0 +1,16 @@
+import { CustomerSummary, ID } from '@zeniai/client-epic-state';
+export interface CustomerFamilyTreeProps {
+    currentCustomerId: ID;
+    /** The family, flat: its top-level customer and every active descendant (`CustomerSummary.familyTree`). */
+    familyTree: CustomerSummary[];
+    /** "Show totals including sub-customers": parents show totals and get a "Total <name>" row when expanded. */
+    includeSubCustomersInTotals: boolean;
+    currencySymbol?: string;
+    onCustomerClick: (customerId: ID) => void;
+}
+/**
+ * The whole family a customer belongs to, as a report-style tree: each level indented under its parent, opened down
+ * to the current customer, which is highlighted. Other rows open their own details page.
+ */
+export declare function CustomerFamilyTree({ currencySymbol, currentCustomerId, familyTree, includeSubCustomersInTotals, onCustomerClick, }: Readonly<CustomerFamilyTreeProps>): import("react/jsx-runtime").JSX.Element;
+export default CustomerFamilyTree;

package/dist/components/customers/customerList/CustomerListPage.d.ts

@@ -1,6 +1,9 @@
 import { CustomerRevenueKey, CustomerSummary, CustomerSummarySortKey, FetchState, SortOrder } from '@zeniai/client-epic-state';
 export declare const getCustomerRevenueLabel: (key: CustomerRevenueKey) => string;
-/** Customers tab (Accounts Receivable) list: revenue, open AR, category and class per customer. */
+/**
+ * Customers tab (Accounts Receivable) list: revenue, open AR, category and class per customer. Which levels it
+ * lists and whether the figures include sub-customers and projects follow the tenant's Customers settings.
+ */
 export interface CustomerListPageProps {
     customers: CustomerSummary[];
     fetchState: FetchState;

package/dist/components/dataListTable/DataListTable.d.ts

@@ -37,4 +37,4 @@ export interface ListItemData<TData> {
     onToggleRow?: (rowId: string) => void;
     renderPlaceholderRow?: (index: number) => ReactNode;
 }
-export declare function DataListTable<TData>({ columns, columnOrder, onColumnOrderChange, data, getRowId, stickyColumnKeys, maxWidthByColumnKey, sortState, onSortChange, selectedRowIds, onSelectedRowIdsChange, features, renderCheckboxRailCell, renderCheckboxRailHeader, renderRowBorderIcon, renderRowComment, renderRowCommentHeader, renderRowMenu, getRowMeta, infiniteLoader, estimatedRowHeight, getEstimatedRowHeight, cellVerticalAlign, centerWhenNarrow, bodyHeightIncludesHeader, disableInternalScroll, expandFrameWidthToViewport, bodyHeight, fillParent, className, "data-testid": dataTestId, rowLayoutVersion, rowMinHeight, onScroll, showOuterBorder, initialScrollOffset, onVirtualListRef, placeholderRowRootProps, renderFooterBelowFrame, isResponsiveTable, responsiveTableMinWidth, responsiveTableMaxWidth, isHorizontalScroll, columnGapPx, }: DataListTableProps<TData>): import("react/jsx-runtime").JSX.Element;
+export declare function DataListTable<TData>({ columns, columnOrder, onColumnOrderChange, data, getRowId, stickyColumnKeys, maxWidthByColumnKey, sortState, defaultSortState, onSortChange, selectedRowIds, onSelectedRowIdsChange, features, renderCheckboxRailCell, renderCheckboxRailHeader, renderRowBorderIcon, renderRowComment, renderRowCommentHeader, renderRowMenu, getRowMeta, infiniteLoader, estimatedRowHeight, getEstimatedRowHeight, cellVerticalAlign, centerWhenNarrow, bodyHeightIncludesHeader, disableInternalScroll, expandFrameWidthToViewport, bodyHeight, fillParent, fitHeightToContent, className, "data-testid": dataTestId, rowLayoutVersion, rowMinHeight, onScroll, showOuterBorder, initialScrollOffset, onVirtualListRef, placeholderRowRootProps, renderFooterBelowFrame, isResponsiveTable, responsiveTableMinWidth, responsiveTableMaxWidth, isHorizontalScroll, columnGapPx, }: DataListTableProps<TData>): import("react/jsx-runtime").JSX.Element;

package/dist/components/dataListTable/DataListTableHeader.d.ts

@@ -13,6 +13,8 @@ export interface DataListTableHeaderProps<TData> {
     columnGapPx?: number;
     /** When set (responsive table), fixed pixel width per data column. */
     columnWidthPxByKey?: ColumnKeyMap;
+    /** When set, a sort other than this one shows a ⊗ on the active column that resets to it. */
+    defaultSortState?: SortState | null;
     features?: {
         checkboxRail?: boolean;
         columnReorder?: boolean;
@@ -39,6 +41,6 @@ export interface DataListTableHeaderProps<TData> {
     renderCheckboxRailHeader?: () => ReactNode;
     renderRowCommentHeader?: () => ReactNode;
 }
-declare function DataListTableHeaderInner<TData>({ headerRowRef, paneColumns, maxWidthByColumnKey, sortState, onSortChange, features, onColumnOrderChange, columnOrder, paneMinWidth, allSelected, someSelected, onToggleAll, renderCheckboxRailHeader, renderRowCommentHeader, includeCheckboxRail, includeRightRails, stickyLeftOffsets, lastStickyColumnKey, columnWidthPxByKey, columnGapPx, }: DataListTableHeaderProps<TData>): import("react/jsx-runtime").JSX.Element;
+declare function DataListTableHeaderInner<TData>({ headerRowRef, paneColumns, maxWidthByColumnKey, sortState, defaultSortState, onSortChange, features, onColumnOrderChange, columnOrder, paneMinWidth, allSelected, someSelected, onToggleAll, renderCheckboxRailHeader, renderRowCommentHeader, includeCheckboxRail, includeRightRails, stickyLeftOffsets, lastStickyColumnKey, columnWidthPxByKey, columnGapPx, }: DataListTableHeaderProps<TData>): import("react/jsx-runtime").JSX.Element;
 export declare const DataListTableHeader: typeof DataListTableHeaderInner;
 export {};

package/dist/components/dataListTable/DataListTablePlaceholderRow.d.ts

@@ -13,9 +13,11 @@ export interface DataListTablePlaceholderRowProps<TData> {
     /** Spread onto the root flex row (e.g. `data-*` for host styling). */
     placeholderRowRootProps?: HTMLAttributes<HTMLDivElement>;
     rightRailWidth?: number;
+    /** Alternates the bar widths row by row. */
+    rowIndex?: number;
     rowMinHeight?: number;
     stickyLeftOffsets?: Map<ColumnKey, number>;
 }
-declare function DataListTablePlaceholderRowInner<TData>({ paneColumns, paneMinWidth, columnGapPx, columnWidthPxByKey, includeCheckboxRail, maxWidthByColumnKey, rightRailWidth, rowMinHeight, stickyLeftOffsets, lastStickyColumnKey, placeholderRowRootProps, }: DataListTablePlaceholderRowProps<TData>): import("react/jsx-runtime").JSX.Element;
+declare function DataListTablePlaceholderRowInner<TData>({ paneColumns, paneMinWidth, columnGapPx, columnWidthPxByKey, includeCheckboxRail, maxWidthByColumnKey, rightRailWidth, rowIndex, rowMinHeight, stickyLeftOffsets, lastStickyColumnKey, placeholderRowRootProps, }: DataListTablePlaceholderRowProps<TData>): import("react/jsx-runtime").JSX.Element;
 export declare const DataListTablePlaceholderRow: typeof DataListTablePlaceholderRowInner;
 export {};

package/dist/components/dataListTable/types.d.ts

@@ -119,6 +119,8 @@ export interface DataListTableProps<TData> {
      */
     columnGapPx?: number;
     "data-testid"?: string;
+    /** When set, a sort other than this one shows a ⊗ on the active column header that resets to it. */
+    defaultSortState?: SortState | null;
     /**
      * When true, sets `overflow: hidden` on the react-window List to suppress internal
      * scrollbars. Use with content-height mode where the outer page handles scrolling.
@@ -138,6 +140,8 @@ export interface DataListTableProps<TData> {
     features?: DataListTableFeatures;
     /** Parent must have definite height; uses AutoSizer for body. */
     fillParent?: boolean;
+    /** With `fillParent`, the frame ends at its last row instead of filling the parent, until it's that tall. */
+    fitHeightToContent?: boolean;
     infiniteLoader?: DataListTableInfiniteConfig;
     /** Initial vertical scroll offset for the virtual list (scroll restore). */
     initialScrollOffset?: number;

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

@@ -95,6 +95,8 @@ export interface ExpenseAutomationPageProps extends MonthEndReportPageProps, Act
      * There is no full-view flag: expanding leaves for the schedule's own page.
      */
     isSchedulePanelOpen?: boolean;
+    /** When true, shows the one-time transaction-search discovery coachmark. */
+    isSearchDiscoveryCoachmarkOpen?: boolean;
     loggedInUser?: LoggedInUser;
     matchPanelContent?: ReactNode;
     newAccrualAccountsView?: NewAccrualAccountsView;
@@ -234,6 +236,7 @@ export interface ExpenseAutomationPageProps extends MonthEndReportPageProps, Act
     onConfirmBulkUploadMatch?: (batchId: ID, attachmentId: ID, transactionId: ID, transactionType: string, fileName: string) => void;
     onCreateTransactionSelect?: (transactionType: CreatableTransactionType) => void;
     onDeleteUnmatchedReceipt?: (attachmentId: ID) => void;
+    onDismissSearchDiscoveryCoachmark?: () => void;
     onExpenseAutomationCommentingThreadClick?: (target: ExpenseAutomationThreadClickTarget) => void;
     onFetchBulkUploadBatches?: (input?: {
         cacheOverride?: boolean;

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

@@ -62,6 +62,7 @@ interface NavBarWithHeaderProps {
     isAiCfoAccessEnabled?: boolean;
     isCompletionLoading?: boolean;
     isReconV3Enabled?: boolean;
+    isSearchDiscoveryCoachmarkOpen?: boolean;
     lastRefreshTime?: ZeniDate;
     navBarCustomElement?: JSX.Element;
     /** Optional "New" button (e.g. New JE Schedule) rendered in the right-side navbar area. */
@@ -86,6 +87,7 @@ interface NavBarWithHeaderProps {
     onUpdateTab: (tab: ExpenseAutomationTransactionsTab) => void;
     onAskAiCfoClick?: () => void;
     onCommentDrawerClick?: () => void;
+    onDismissSearchDiscoveryCoachmark?: () => void;
     onFiltersChange?: (filters: TransactionFilters) => void;
     onGenericTabChange?: (tab: TabSwitcherOption) => void;
     onJeTabUpdate?: (tab: JEPageTab) => void;

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

@@ -60,6 +60,14 @@ export declare function getReversalJournalEntryTransaction(accrual: {
     id: string;
     type: string;
 } | null;
+/**
+ * The transaction Actual Matching cleared the accrual against. Only the `cleared` stamp counts: a
+ * match suggestion has not reversed anything yet.
+ */
+export declare function getClearedMatchedTransaction(accrual: Pick<JEOneTimeAccrual, "cleared">): {
+    id: string;
+    type: string;
+} | null;
 export declare function getMatchedBillTransaction(match: Pick<ActualMatchingMatch, "members" | "transactionType"> & {
     leftovers?: ActualMatchingMatch["leftovers"];
     transactionIntegrationId?: string;