gantt-lib 0.124.2 → 0.126.0

package/dist/{index-DD3YvhvA.d.ts → index-B1yy4LX0.d.ts}

@@ -368,9 +368,10 @@ declare function getTaskDuration(startDate: string | Date, endDate: string | Dat
 
 /**
  * Normalize predecessor dates for scheduling calculations.
- * For milestone tasks, the scheduling "finish" anchor is treated as the day
- * before startDate. This preserves the standard inclusive FS formula
- * (`predEnd + lag + 1`) while making milestone FS lag=0 land on the same day.
+ * Milestones have a real zero-duration finish anchor at startDate. The
+ * successor type, rather than a fabricated predecessor date, determines
+ * whether FS lag=0 lands on the same day (milestone successor) or the next
+ * day (regular successor).
  */
 declare function normalizePredecessorDates(predecessor: Pick<Task, 'startDate' | 'endDate' | 'type'>, parseDateFn: (d: string | Date) => Date): {
     predStart: Date;
@@ -388,30 +389,34 @@ declare function getDependencyLag(dep: Pick<TaskDependency, 'lag'>): number;
  */
 declare function normalizeTaskDependencyLags<TTask extends Pick<Task, 'dependencies'>>(task: TTask): TTask;
 /**
- * Normalize lag for FS links — clamp to >= -predecessorDuration.
+ * Normalize lag for FS links. Regular successors clamp to
+ * `-predecessorDuration`; milestone successors use one fewer day because
+ * their zero-duration FS anchor is the predecessor finish date itself.
  */
-declare function normalizeDependencyLag(linkType: LinkType, lag: number, predecessorStart: Date, predecessorEnd: Date, businessDays?: boolean, weekendPredicate?: (date: Date) => boolean): number;
+declare function normalizeDependencyLag(linkType: LinkType, lag: number, predecessorStart: Date, predecessorEnd: Date, businessDays?: boolean, weekendPredicate?: (date: Date) => boolean, successorType?: Task['type']): number;
 /**
  * Compute lag (in days) from actual predecessor/successor dates.
  * This is the single source of truth for lag semantics.
  *
  * Semantics (lag=0 = natural, gap-free connection):
- * - FS: lag = succStart - predEnd - 1  (adjacent days = 0)
+ * - FS: lag = succStart - predEnd - 1  (adjacent regular-task days = 0)
+ *       milestone successor uses succStart - predEnd (same-day = 0)
  * - SS: lag = succStart - predStart
  * - FF: lag = succEnd   - predEnd
  * - SF: lag = succEnd   - predStart + 1  (symmetric to FS)
  */
-declare function computeLagFromDates(linkType: LinkType, predStart: Date, predEnd: Date, succStart: Date, succEnd: Date, businessDays?: boolean, weekendPredicate?: (date: Date) => boolean): number;
+declare function computeLagFromDates(linkType: LinkType, predStart: Date, predEnd: Date, succStart: Date, succEnd: Date, businessDays?: boolean, weekendPredicate?: (date: Date) => boolean, successorType?: Task['type']): number;
 /**
  * Calculate successor date based on predecessor dates, link type, and lag.
  *
  * Link type semantics:
- * - FS: Successor start = Predecessor end + lag + 1 day  (lag=0 -> next day)
+ * - FS: Successor start = Predecessor end + lag + 1 day for regular tasks
+ *       and Predecessor end + lag for milestone successors
  * - SS: Successor start = Predecessor start + lag
  * - FF: Successor end   = Predecessor end + lag
  * - SF: Successor end   = Predecessor start + lag - 1 day  (lag=0 -> day before)
  */
-declare function calculateSuccessorDate(predecessorStart: Date, predecessorEnd: Date, linkType: LinkType, lag?: number, businessDays?: boolean, weekendPredicate?: (date: Date) => boolean): Date;
+declare function calculateSuccessorDate(predecessorStart: Date, predecessorEnd: Date, linkType: LinkType, lag?: number, businessDays?: boolean, weekendPredicate?: (date: Date) => boolean, successorType?: Task['type']): Date;
 
 /**
  * Critical path (CPM) calculation over dependency links.
@@ -526,7 +531,7 @@ declare function moveTaskRange(originalStart: string | Date, originalEnd: string
 /**
  * Clamp task range start date based on incoming FS dependencies.
  */
-declare function clampTaskRangeForIncomingFS(task: Pick<Task, 'dependencies'>, proposedStart: Date, proposedEnd: Date, allTasks: Task[], businessDays?: boolean, weekendPredicate?: (date: Date) => boolean, taskById?: Map<string, Task>): {
+declare function clampTaskRangeForIncomingFS(task: Pick<Task, 'dependencies' | 'type'>, proposedStart: Date, proposedEnd: Date, allTasks: Task[], businessDays?: boolean, weekendPredicate?: (date: Date) => boolean, taskById?: Map<string, Task>): {
     start: Date;
     end: Date;
 };