@veevarts/design-system 2.0.0 → 2.1.0

package/dist/patterns/InstallmentSchedule/InstallmentSchedule.d.ts

@@ -1,3 +1,3 @@
 import { JSX } from 'react';
 import { InstallmentScheduleProps } from './types';
-export declare function InstallmentSchedule({ mode: controlledMode, donationAmount, currency, locale, installments, automaticSettings, defaultTab, showTitle, showCard, showSavePayment, showTabs, inputs, startDate, labels: customLabels, classNames, isSaving, isModeSwitchDisabled, onModeChange, onAutomaticSettingsChange, onInstallmentsChange, onSave, }: InstallmentScheduleProps): JSX.Element;
+export declare function InstallmentSchedule({ mode: controlledMode, donationAmount, currency, locale, installments, automaticSettings, defaultTab, showTitle, showCard, showSavePayment, showTabs, inputs, startDate, firstInstallmentDateOverride, labels: customLabels, classNames, isSaving, isModeSwitchDisabled, onModeChange, onAutomaticSettingsChange, onInstallmentsChange, onSave, }: InstallmentScheduleProps): JSX.Element;

package/dist/patterns/InstallmentSchedule/index.d.ts

@@ -1,5 +1,5 @@
 export { InstallmentSchedule } from './InstallmentSchedule';
 export { InstallmentScheduleSkeleton } from './InstallmentScheduleSkeleton';
 export { InstallmentTable } from './InstallmentTable';
-export { generateAutomaticInstallments } from './utils';
+export { applyFirstInstallmentDateOverride, generateAutomaticInstallments } from './utils';
 export type { AutomaticScheduleSettings, InstallmentFrequency, InstallmentScheduleInput, InstallmentTableLabels, InstallmentTableProps, InstallmentScheduleClassNames, InstallmentScheduleLabels, InstallmentScheduleMode, InstallmentScheduleProps, InstallmentStatus, ScheduledInstallment, } from './types';

package/dist/patterns/InstallmentSchedule/types.d.ts

@@ -71,6 +71,22 @@ export type InstallmentScheduleProps = {
     showTabs?: boolean;
     inputs?: InstallmentScheduleInput[];
     startDate?: string;
+    /**
+     * Automatic mode only. Dates installment #1 on this day instead of the day
+     * the generated cadence would put it on. Installments #2..N keep the
+     * generated cadence untouched.
+     *
+     * For flows where the first charge happens when the plan is COMMITTED
+     * while the schedule anchors on a later term start: a plan created today
+     * with a term starting next month charges #1 today, then follows the term.
+     * Without this the first charge silently moves to the term start, and the
+     * schedule on screen stops matching the one that gets persisted.
+     *
+     * Ignored in manual mode, where the host already owns every date, and
+     * ignored when `firstInstallmentDate` is one of `inputs` — there the user
+     * picks that date themselves and the schedule must agree with the field.
+     */
+    firstInstallmentDateOverride?: string;
     labels?: InstallmentScheduleLabels;
     classNames?: InstallmentScheduleClassNames;
     isSaving?: boolean;

package/dist/patterns/InstallmentSchedule/utils.d.ts

@@ -1,3 +1,15 @@
 import { AutomaticScheduleSettings, ScheduledInstallment } from './types';
 export declare function generateAutomaticInstallments(donationAmount: number, settings: AutomaticScheduleSettings): ScheduledInstallment[];
 export declare function getInvalidDateRowIds(installments: ScheduledInstallment[]): Set<string>;
+/**
+ * Re-dates installment #1 without touching the rest of the schedule.
+ *
+ * The generator produces one uniform cadence from a single anchor, which
+ * cannot express "charge #1 today, then follow the term start". This applies
+ * that shape on top: only the first date moves, and only when an override is
+ * given and it actually differs.
+ *
+ * Amounts are never touched — the first-installment rounding remainder stays
+ * where the generator put it.
+ */
+export declare function applyFirstInstallmentDateOverride(installments: ScheduledInstallment[], firstInstallmentDateOverride?: string): ScheduledInstallment[];

package/package.json

@@ -1,7 +1,7 @@
 {
     "name": "@veevarts/design-system",
     "private": false,
-    "version": "2.0.0",
+    "version": "2.1.0",
     "type": "module",
     "main": "dist/index.js",
     "module": "dist/index.js",