@zeniai/web-components 4.3.76-beta12MM → 4.3.76-beta13MM

package/dist/components/invoicing/subscriptionForm/InvoicingSubscriptionFormPage.d.ts

@@ -12,6 +12,14 @@ export interface InvoicingSubscriptionFormPageProps {
     customers?: InvoicingSubscriptionFormOption[];
     errorMessage?: string;
     fieldHelp?: FieldHelpByCode;
+    /**
+     * True while the subscription being edited is still loading. The form holds
+     * its skeleton until the record lands: `useForm` seeds its default values
+     * once, at first render, so mounting the fields against the blank draft
+     * leaves them empty, and the first change writes that blankness back over the
+     * subscription. Always false when creating — there is nothing to load.
+     */
+    isLoading?: boolean;
     plans?: InvoicingSubscriptionFormOption[];
     shippingAddressLabel?: string;
     onCancel: () => void;
@@ -26,5 +34,5 @@ export interface InvoicingSubscriptionFormPageProps {
  * primitives. The draft flows from CES (`localData`) and is synced back on every
  * change; the shipping address is captured via the shared Address screen.
  */
-export declare function InvoicingSubscriptionFormPage({ fieldHelp, addons, charges, coupons, customers, errorMessage, isSubmitting, localData, mode, onBack, onCancel, onChange, onOpenAddress, onSubmit, plans, shippingAddressLabel, }: Readonly<InvoicingSubscriptionFormPageProps>): import("react/jsx-runtime").JSX.Element;
+export declare function InvoicingSubscriptionFormPage({ fieldHelp, addons, charges, coupons, customers, errorMessage, isLoading, isSubmitting, localData, mode, onBack, onCancel, onChange, onOpenAddress, onSubmit, plans, shippingAddressLabel, }: Readonly<InvoicingSubscriptionFormPageProps>): import("react/jsx-runtime").JSX.Element;
 export default InvoicingSubscriptionFormPage;

package/dist/components/invoicing/subscriptionForm/SubscriptionItemQuantityRows.d.ts

@@ -1,17 +1,20 @@
 export interface SubscriptionItemQuantityRowsProps {
-    namePrefix: string;
-    quantities: Record<string, number>;
+    /** Field-array path holding this section's `{priceCode, quantity}` entries. */
+    name: string;
     selectedPriceCodes: string[];
+    labelWidth?: number;
+    rowStyle?: React.CSSProperties;
     getOptionLabel: (priceCode: string) => string;
-    onChange: (quantities: Record<string, number>) => void;
 }
 /**
  * One quantity row per selected add-on / one-time charge. Every pricing model
  * except `flat_fee` bills on quantity, so each selected item carries its own
  * (minimum 1) rather than the single hardcoded 1 the payload used to send.
  *
- * The whole map is one react-hook-form field, so price codes never have to be
- * escaped into field paths — a code containing a `.` or `[` would otherwise be
- * read as a nested path.
+ * Rendered as a react-hook-form field array so each row is a real registered
+ * field and can use the shared `Labeled*` row the rest of the form is built
+ * from. Keying the rows by array index (not by price code) is what makes that
+ * safe: a price code containing a `.` or a `[` would otherwise be read as a
+ * nested field path.
  */
-export declare function SubscriptionItemQuantityRows({ getOptionLabel, namePrefix, onChange, quantities, selectedPriceCodes, }: Readonly<SubscriptionItemQuantityRowsProps>): import("react/jsx-runtime").JSX.Element;
+export declare function SubscriptionItemQuantityRows({ getOptionLabel, labelWidth, name, rowStyle, selectedPriceCodes, }: Readonly<SubscriptionItemQuantityRowsProps>): import("react/jsx-runtime").JSX.Element;

package/dist/components/invoicing/subscriptionForm/subscriptionForm.shared.d.ts

@@ -1,29 +1,11 @@
-import { InvoicingSubscriptionFormLocalData } from '@zeniai/client-epic-state';
+import { InvoicingSubscriptionFormLocalData, InvoicingSubscriptionOption } from '@zeniai/client-epic-state';
 import { MultiSelectFieldValue } from '../../formElements/multiSelectField/MultiSelectField';
-export interface InvoicingSubscriptionFormOption {
-    label: string;
-    value: string;
-    /**
-     * Plan options only: the plan's own paid-cycle limit, used to prefill the
-     * form's Billing Cycles field when the plan is selected. Absent means the
-     * plan renews forever.
-     */
-    billingCycles?: number;
-    /**
-     * Plan options only: the price point's own billing cadence. Shown read-only,
-     * because cadence is a property of the price point and the backend rejects a
-     * subscription that claims a different one.
-     */
-    billingPeriod?: number;
-    billingPeriodUnit?: string;
-    subtitle?: string;
-    /**
-     * Plan options only: the plan's own trial length, used to prefill the form's
-     * Trial End field from the start date. Absent means the plan has no trial.
-     */
-    trialPeriod?: number;
-    trialPeriodUnit?: string;
-}
+/**
+ * Aliased rather than redeclared: CES builds every picker list this form
+ * renders, so a second definition here would be a copy free to drift from the
+ * one the options are actually built against.
+ */
+export type InvoicingSubscriptionFormOption = InvoicingSubscriptionOption;
 export interface PickerValue {
     allOptions: {
         label: string;
@@ -48,9 +30,11 @@ export interface InvoicingSubscriptionFormOptions {
  * in the UI, so it lives off react-hook-form and is reconstructed in the reverse
  * mapper for the request body.
  */
-export type SubscriptionFormValues = Omit<InvoicingSubscriptionFormLocalData, "addonPriceCodes" | "chargePriceCodes" | "couponId" | "customerId" | "planPriceCode" | "preferredCurrencyCode" | "setupFee" | "startedAt" | "trialEnd"> & {
+export type SubscriptionFormValues = Omit<InvoicingSubscriptionFormLocalData, "addonPriceCodes" | "addonQuantities" | "chargePriceCodes" | "chargeQuantities" | "couponId" | "customerId" | "planPriceCode" | "preferredCurrencyCode" | "setupFee" | "startedAt" | "trialEnd"> & {
     addonPriceCodes: MultiSelectFieldValue;
+    addonQuantities: SubscriptionItemQuantityEntry[];
     chargePriceCodes: MultiSelectFieldValue;
+    chargeQuantities: SubscriptionItemQuantityEntry[];
     couponId: PickerValue;
     customerId: PickerValue;
     planPriceCode: PickerValue;
@@ -68,6 +52,59 @@ export declare const buildSubscriptionOptionLabelGetter: (options: InvoicingSubs
  * subscription that claims a different one.
  */
 export declare const subscriptionBillingCadenceLabel: (plan: InvoicingSubscriptionFormOption | undefined) => string;
+/**
+ * One selected add-on / one-time charge's quantity, as the form holds it.
+ *
+ * An ordered list rather than a `Record` keyed by price code because the rows
+ * register with react-hook-form as a field array: a list gives each row the
+ * index-based path (`addonQuantities.0.quantity`) that `register` needs, where
+ * a price-code key would be read as a nested path the moment a code contained
+ * a `.` or a `[`.
+ *
+ * `quantity` stays the raw field text — clamped to a valid quantity only at the
+ * CES boundary — so a half-finished edit (an emptied field, a lone minus) is
+ * not snapped out from under the user mid-keystroke.
+ */
+export interface SubscriptionItemQuantityEntry {
+    priceCode: string;
+    quantity: string;
+}
+/**
+ * Both readers take their list straight from react-hook-form, which owns the
+ * array and can leave a hole in it across a reset or an unregister. The element
+ * type says otherwise, so the gap is stated here rather than trusted away.
+ */
+type MaybeSubscriptionItemQuantityEntries = readonly (SubscriptionItemQuantityEntry | undefined)[] | undefined;
+/**
+ * Quantity entries covering exactly the currently selected price codes: every
+ * selection gets a value the row can render (1 when the draft has none), and a
+ * code left behind by a deselect is dropped rather than carried in the draft.
+ */
+export declare const subscriptionQuantityEntries: (selectedPriceCodes: string[], quantities: Record<string, number> | undefined) => SubscriptionItemQuantityEntry[];
+/**
+ * The same reconcile against an existing entry list, keeping each surviving
+ * row's in-progress text rather than re-clamping it.
+ */
+export declare const reconcileSubscriptionQuantityEntries: (selectedPriceCodes: string[], entries: MaybeSubscriptionItemQuantityEntries) => SubscriptionItemQuantityEntry[];
+/**
+ * An add-on / one-time-charge picker's value narrowed to the options currently
+ * on offer: `allOptions` becomes the incoming list, and any selection that list
+ * no longer holds is dropped.
+ *
+ * Both halves are needed. A restricted plan narrows the option lists upstream,
+ * but the picker renders from the `allOptions` carried inside its own form
+ * value, so a narrowed list only reaches the screen by being written back —
+ * and a selection the new plan disallows has to go with it.
+ *
+ * Selections are pruned, never cleared: switching between two plans that both
+ * allow an add-on keeps it, and the quantity typed against it.
+ *
+ * Returns `current` unchanged when nothing moved, so the caller can skip the
+ * write — and the dirty flag it would raise — on the common no-op.
+ */
+export declare const reconcileSubscriptionMultiSelect: (current: MultiSelectFieldValue, options: InvoicingSubscriptionFormOption[]) => MultiSelectFieldValue;
+/** Entries back to the quantity map CES stores, clamped to what the API accepts. */
+export declare const subscriptionQuantitiesFromEntries: (selectedPriceCodes: string[], entries: MaybeSubscriptionItemQuantityEntries) => Record<string, number>;
 /**
  * Trial end implied by the selected plan: the start date walked forward by the
  * plan's own trial length. `undefined` when the start date is unset or the plan
@@ -82,13 +119,17 @@ export declare const subscriptionFormValuesToLocalData: (values: SubscriptionFor
 /** Values used by the inline edit on the subscription detail page. */
 export interface SubscriptionEditValues {
     addon_price_codes: MultiSelectFieldValue;
+    addon_quantities: SubscriptionItemQuantityEntry[];
     auto_collection: boolean;
+    charge_price_codes: MultiSelectFieldValue;
+    charge_quantities: SubscriptionItemQuantityEntry[];
     coupon_id: PickerValue;
     plan_price_code: PickerValue;
     plan_quantity: string;
     po_number: string;
 }
-export declare const localDataToSubscriptionEditValues: (localData: InvoicingSubscriptionFormLocalData, options: Pick<InvoicingSubscriptionFormOptions, "addons" | "coupons" | "plans">) => SubscriptionEditValues;
+export declare const localDataToSubscriptionEditValues: (localData: InvoicingSubscriptionFormLocalData, options: Pick<InvoicingSubscriptionFormOptions, "addons" | "charges" | "coupons" | "plans">) => SubscriptionEditValues;
 export declare const subscriptionEditValuesToLocalData: (values: SubscriptionEditValues, base: InvoicingSubscriptionFormLocalData) => InvoicingSubscriptionFormLocalData;
 /** Seed the detail-page inline edit form from the current CES draft. */
-export declare const buildSubscriptionEditDefaults: (localData: InvoicingSubscriptionFormLocalData, options: Pick<InvoicingSubscriptionFormOptions, "addons" | "coupons" | "plans">) => SubscriptionEditValues;
+export declare const buildSubscriptionEditDefaults: (localData: InvoicingSubscriptionFormLocalData, options: Pick<InvoicingSubscriptionFormOptions, "addons" | "charges" | "coupons" | "plans">) => SubscriptionEditValues;
+export {};

package/dist/components/notifications/components/CommentsNotificationTileMedium.d.ts

@@ -1,4 +1,4 @@
-import { CommentBodyElement, CommentBodyLink, CommentBodyMention, CommentBodyText } from '@liveblocks/client';
+import { CommentBodyLink, CommentBodyMention, CommentBodyText } from '@liveblocks/client';
 import { ExternalNotificationData, ID, NotificationStatus, User, ZeniUrl } from '@zeniai/client-epic-state';
 /**
  * Props
@@ -34,6 +34,17 @@ export declare const NotificationActionComponents: ({ notificationData, users, }
     users: User[];
 }) => import("react/jsx-runtime").JSX.Element;
 export declare const NotificationTimeComponent: (props: NotificationTimeProps) => import("react/jsx-runtime").JSX.Element;
-export declare function isCommentBodyText(element: CommentBodyElement): element is CommentBodyText;
-export declare function isCommentBodyMention(element: CommentBodyElement): element is CommentBodyMention;
-export declare function isCommentBodyLink(element: CommentBodyElement): element is CommentBodyLink;
+type CommentInline = {
+    type?: string;
+    id?: string;
+    url?: string;
+    text?: string;
+    bold?: boolean;
+    italic?: boolean;
+    strikethrough?: boolean;
+    code?: boolean;
+};
+export declare function isCommentBodyText(element: CommentInline): element is CommentBodyText;
+export declare function isCommentBodyMention(element: CommentInline): element is CommentBodyMention;
+export declare function isCommentBodyLink(element: CommentInline): element is CommentBodyLink;
+export {};

package/dist/components/reportTree/treeNode/accountReconReport/row/v2/statusHelper.d.ts

@@ -6,7 +6,7 @@ type StatusProps = {
 /** V2 list row — Review lives in AccountReconDetailsDrawerPageV2, not the AI Progress column. */
 export declare function ShowStatusForBankConnectionV2({ accountRecon, isLoading, }: Readonly<StatusProps>): import("react/jsx-runtime").JSX.Element;
 export declare function ShowStatusForStatementConnectionV2({ accountRecon, isLoading, }: Readonly<StatusProps>): import("react/jsx-runtime").JSX.Element;
-/** When true, AI Progress shows the V1 status (Reconciled / Books closed / etc.) instead of the bar. */
+/** When true, AI Progress shows the V1 status (Reconciled tag / etc.) instead of the bar. */
 export declare function shouldShowReconciledTagInMatchProgress(reconciliationStatusCode?: ReconciliationStatusCodeType): boolean;
 export declare function shouldShowMatchProgressBar(matchTotal: number, reconciliationStatusCode?: ReconciliationStatusCodeType): boolean;
 export {};

package/dist/components/reports/PdfColumnLimitPopup.d.ts

@@ -0,0 +1,12 @@
+import { AllowedTimeframe } from '../common/downloadReport/types/downloadReportOptions';
+export interface PdfColumnLimitPopupProps {
+    additionalColumnsCount: number;
+    maxColumns: number;
+    numberOfPeriods: number;
+    /** Absent when the report is on a timeframe that has no period wording. */
+    timeframe?: AllowedTimeframe;
+    onCancel: () => void;
+    onDownloadExcel: () => void;
+}
+declare const PdfColumnLimitPopup: ({ additionalColumnsCount, maxColumns, numberOfPeriods, timeframe, onCancel, onDownloadExcel, }: Readonly<PdfColumnLimitPopupProps>) => import("react/jsx-runtime").JSX.Element;
+export default PdfColumnLimitPopup;

package/dist/context/featureProvider/DynamicConfigNameConstants.d.ts

@@ -27,7 +27,8 @@ export declare enum DynamicConfigNamesWebApp {
     approvalRuleV3Config = "approval_rule_v3_config",
     transactionCategorizationConfig = "transaction_categorization_config",
     zeniCardsVisibilityConfig = "zeni_cards_visibility_config",
-    updateTransactionTypeConfig = "update_transaction_type_config"
+    updateTransactionTypeConfig = "update_transaction_type_config",
+    agentJeConfig = "agent_je_config"
 }
 /** Shared configs used by both web-app-ui and cockpit-ui */
 export declare enum DynamicConfigNamesShared {
@@ -54,6 +55,7 @@ export declare const DynamicConfigNames: {
     transactionCategorizationConfig: DynamicConfigNamesWebApp.transactionCategorizationConfig;
     zeniCardsVisibilityConfig: DynamicConfigNamesWebApp.zeniCardsVisibilityConfig;
     updateTransactionTypeConfig: DynamicConfigNamesWebApp.updateTransactionTypeConfig;
+    agentJeConfig: DynamicConfigNamesWebApp.agentJeConfig;
     cardsTabCockpitUser: DynamicConfigNamesCockpit.cardsTabCockpitUser;
     monthEndInsightsEnablement: DynamicConfigNamesCockpit.monthEndInsightsEnablement;
     expenseAutomationEnablement: DynamicConfigNamesCockpit.expenseAutomationEnablement;

package/dist/context/featureProvider/isActualMatchingEnabledInAgentJeConfig.d.ts

@@ -0,0 +1,18 @@
+/**
+ * UI gate for Actual Matching. Reads Statsig dynamic config `agent_je_config`
+ * (same object agent-je uses). Fail-closed: missing slice / missing key /
+ * any value other than explicit `true` hides the tab.
+ *
+ * Expected shape:
+ * ```
+ * {
+ *   "global": {
+ *     "accrual_config": {
+ *       "ACTUAL_MATCHING_ENABLED": true
+ *     }
+ *   }
+ * }
+ * ```
+ */
+export declare const ACTUAL_MATCHING_ENABLED_KEY = "ACTUAL_MATCHING_ENABLED";
+export declare function isActualMatchingEnabledInAgentJeConfig(configValue: Record<string, unknown> | null | undefined): boolean;

package/dist/context/featureProvider/isActualMatchingEnabledInAgentJeConfig.test.d.ts

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

package/dist/context/featureProvider/useActualMatchingEnabled.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Actual Matching JE subtab / match-detail UI gate from Statsig
+ * `agent_je_config`. Fail-closed while Statsig is loading or the key is
+ * missing — master can ship the code with the tab hidden.
+ */
+export declare function useActualMatchingEnabled(): boolean;