@outbuild-company/schedule-core 1.35.1 → 1.35.3

package/dist/index.d.cts

@@ -76,6 +76,94 @@ interface CalendarAPI {
     readonly getWorkHours: (date: Date) => string[];
 }
 
+/** Validation failure raised while planning or preparing Lookahead actual dates. */
+type LookaheadActualTransitionErrorCode = 'ACTIVITY_CALENDAR_REQUIRED' | 'ACTUAL_FINISH_BEFORE_START' | 'ACTUAL_FINISH_REMOVAL_NOT_APPLICABLE' | 'ACTUAL_FINISH_REMOVAL_REQUIRED' | 'ACTUAL_FINISH_REQUIRES_100' | 'ACTUAL_START_REQUIRED' | 'DATA_DATE_INACTIVE' | 'INVALID_ACTUAL_DAY' | 'INVALID_ACTUAL_TIME_SOURCE' | 'INVALID_DATA_DATE' | 'INVALID_DISPLAYED_FINISH' | 'INVALID_PROGRESS';
+declare class LookaheadActualTransitionError extends Error {
+    readonly code: LookaheadActualTransitionErrorCode;
+    constructor(code: LookaheadActualTransitionErrorCode);
+}
+/**
+ * Actual dates the user confirmed in the Lookahead progress dialog.
+ * `actualFinish: null` is the confirmed removal of the Actual Finish when
+ * progress drops below 100 on a completed activity.
+ */
+interface LookaheadActualIntent {
+    readonly actualStart?: Date;
+    readonly actualFinish?: Date | null;
+}
+/** Slice of the P6 activity state the Lookahead progress transition reads. */
+type LookaheadProgressActualActivityState = Pick<P6ActivityDraftState, 'actualStart' | 'actualFinish' | 'remainingDurationHours' | 'executionStatus' | 'suspendDate' | 'resumeDate' | 'physicalPercentComplete' | 'originalDurationHours' | 'percentCompleteType'>;
+/**
+ * Input of a Lookahead progress change under a Data Date: the active
+ * `dataDate` (`null` when inactive), the activity's P6 slice, the target
+ * progress (0–100) and the finish currently displayed to the user.
+ */
+interface LookaheadProgressActualInput {
+    readonly dataDate: Date | null;
+    readonly activity: Readonly<LookaheadProgressActualActivityState>;
+    readonly nextProgress: number;
+    readonly displayedFinish?: Date | null;
+}
+/**
+ * Which actual dates the transition needs: `start` is required when a
+ * not-started activity gains progress, `finish` is optional when progress
+ * reaches 100, `uncomplete` is required when a completed activity drops
+ * below 100 (the Actual Finish must be removed; the Actual Start stays).
+ * All are `null` when the Data Date is inactive.
+ */
+interface LookaheadProgressActualPlan {
+    readonly start: {
+        readonly required: true;
+        readonly suggestedAt: Date;
+    } | null;
+    readonly finish: {
+        readonly optional: true;
+        readonly suggestedAt: Date | null;
+    } | null;
+    readonly uncomplete: {
+        readonly required: true;
+        readonly removes: Date;
+    } | null;
+}
+/**
+ * Combines a `YYYY-MM-DD` day picked by the user with the UTC time of day of
+ * `timeSource`. Throws `LookaheadActualTransitionError` on an invalid day or
+ * time source.
+ */
+declare function resolveLookaheadActualDateSelection(input: {
+    readonly selectedDay: string;
+    readonly timeSource: Date;
+}): Date;
+/**
+ * Decides which actual dates a progress change requires and suggests default
+ * values (the Data Date for the start, the displayed finish for the finish).
+ * Throws `LookaheadActualTransitionError` on invalid input.
+ */
+declare function planLookaheadProgressActuals(input: LookaheadProgressActualInput): LookaheadProgressActualPlan;
+/**
+ * Validates the confirmed `intent` against the plan and returns the P6
+ * activity patch to dispatch: the actual-date transition plus, while the
+ * activity is in progress, `nextProgress` mirrored into the percent field
+ * selected by `percentCompleteType` (Physical %, or the Remaining Duration
+ * for the duration type; the units type is read-only). Throws
+ * `LookaheadActualTransitionError` when a required actual start is missing,
+ * a finish is given below 100 %, a completed activity drops below 100 %
+ * without the confirmed removal of its Actual Finish, or an intent arrives
+ * while the Data Date is inactive.
+ */
+declare function prepareLookaheadProgressActuals(input: LookaheadProgressActualInput & {
+    readonly intent?: LookaheadActualIntent;
+}): Readonly<Partial<P6ActivityDraftState>>;
+/**
+ * Prepares a Lookahead progress patch for persistence, preserving the time of
+ * an existing Actual Start or normalizing its first assignment to the activity
+ * shift.
+ */
+declare function prepareLookaheadProgressActualsForPersistence(input: LookaheadProgressActualInput & {
+    readonly intent?: LookaheadActualIntent;
+    readonly resolveCalendar: () => CalendarAPI | null;
+}): Readonly<Partial<P6ActivityDraftState>>;
+
 /** Canonical reasons why an activity field edit may be blocked. */
 declare const EDIT_DENIAL_REASON: {
     readonly COMPLETED: "completed";
@@ -1336,6 +1424,7 @@ type DispatchAction = {
     isLookahead: boolean;
     hasLookaheadTasks: boolean;
     persistedProgress?: number;
+    persistedActualTransition?: LookaheadActualIntent;
     acknowledgePersistedLookahead?: boolean;
     eventSource?: string;
 } | ScheduleAutoScheduleAction;
@@ -4171,93 +4260,6 @@ declare function resolveExpectedFinishDateSelection(input: {
     readonly displayedFinish: Date;
 }): Date;
 
-/** Validation failure raised while planning or preparing Lookahead actual dates. */
-type LookaheadActualTransitionErrorCode = 'ACTIVITY_CALENDAR_REQUIRED' | 'ACTUAL_FINISH_BEFORE_START' | 'ACTUAL_FINISH_REMOVAL_NOT_APPLICABLE' | 'ACTUAL_FINISH_REMOVAL_REQUIRED' | 'ACTUAL_FINISH_REQUIRES_100' | 'ACTUAL_START_REQUIRED' | 'DATA_DATE_INACTIVE' | 'INVALID_ACTUAL_DAY' | 'INVALID_ACTUAL_TIME_SOURCE' | 'INVALID_DATA_DATE' | 'INVALID_DISPLAYED_FINISH' | 'INVALID_PROGRESS';
-declare class LookaheadActualTransitionError extends Error {
-    readonly code: LookaheadActualTransitionErrorCode;
-    constructor(code: LookaheadActualTransitionErrorCode);
-}
-/**
- * Actual dates the user confirmed in the Lookahead progress dialog.
- * `actualFinish: null` is the confirmed removal of the Actual Finish when
- * progress drops below 100 on a completed activity.
- */
-interface LookaheadActualIntent {
-    readonly actualStart?: Date;
-    readonly actualFinish?: Date | null;
-}
-/** Slice of the P6 activity state the Lookahead progress transition reads. */
-type LookaheadProgressActualActivityState = Pick<P6ActivityDraftState, 'actualStart' | 'actualFinish' | 'remainingDurationHours' | 'executionStatus' | 'suspendDate' | 'resumeDate' | 'physicalPercentComplete' | 'originalDurationHours' | 'percentCompleteType'>;
-/**
- * Input of a Lookahead progress change under a Data Date: the active
- * `dataDate` (`null` when inactive), the activity's P6 slice, the target
- * progress (0–100) and the finish currently displayed to the user.
- */
-interface LookaheadProgressActualInput {
-    readonly dataDate: Date | null;
-    readonly activity: Readonly<LookaheadProgressActualActivityState>;
-    readonly nextProgress: number;
-    readonly displayedFinish?: Date | null;
-}
-/**
- * Which actual dates the transition needs: `start` is required when a
- * not-started activity gains progress, `finish` is optional when progress
- * reaches 100, `uncomplete` is required when a completed activity drops
- * below 100 (the Actual Finish must be removed; the Actual Start stays).
- * All are `null` when the Data Date is inactive.
- */
-interface LookaheadProgressActualPlan {
-    readonly start: {
-        readonly required: true;
-        readonly suggestedAt: Date;
-    } | null;
-    readonly finish: {
-        readonly optional: true;
-        readonly suggestedAt: Date | null;
-    } | null;
-    readonly uncomplete: {
-        readonly required: true;
-        readonly removes: Date;
-    } | null;
-}
-/**
- * Combines a `YYYY-MM-DD` day picked by the user with the UTC time of day of
- * `timeSource`. Throws `LookaheadActualTransitionError` on an invalid day or
- * time source.
- */
-declare function resolveLookaheadActualDateSelection(input: {
-    readonly selectedDay: string;
-    readonly timeSource: Date;
-}): Date;
-/**
- * Decides which actual dates a progress change requires and suggests default
- * values (the Data Date for the start, the displayed finish for the finish).
- * Throws `LookaheadActualTransitionError` on invalid input.
- */
-declare function planLookaheadProgressActuals(input: LookaheadProgressActualInput): LookaheadProgressActualPlan;
-/**
- * Validates the confirmed `intent` against the plan and returns the P6
- * activity patch to dispatch: the actual-date transition plus, while the
- * activity is in progress, `nextProgress` mirrored into the percent field
- * selected by `percentCompleteType` (Physical %, or the Remaining Duration
- * for the duration type; the units type is read-only). Throws
- * `LookaheadActualTransitionError` when a required actual start is missing,
- * a finish is given below 100 %, a completed activity drops below 100 %
- * without the confirmed removal of its Actual Finish, or an intent arrives
- * while the Data Date is inactive.
- */
-declare function prepareLookaheadProgressActuals(input: LookaheadProgressActualInput & {
-    readonly intent?: LookaheadActualIntent;
-}): Readonly<Partial<P6ActivityDraftState>>;
-/**
- * Prepares a Lookahead progress patch for persistence after calendar
- * resolution, normalizing a midnight Actual Start to the activity shift.
- */
-declare function prepareLookaheadProgressActualsForPersistence(input: LookaheadProgressActualInput & {
-    readonly intent?: LookaheadActualIntent;
-    readonly resolveCalendar: () => CalendarAPI | null;
-}): Readonly<Partial<P6ActivityDraftState>>;
-
 /** Calendars of the schedule whose working time is read. */
 interface CalendarReaderInput {
     readonly calendars: readonly BackendCalendarInput[];

package/dist/index.d.ts

@@ -76,6 +76,94 @@ interface CalendarAPI {
     readonly getWorkHours: (date: Date) => string[];
 }
 
+/** Validation failure raised while planning or preparing Lookahead actual dates. */
+type LookaheadActualTransitionErrorCode = 'ACTIVITY_CALENDAR_REQUIRED' | 'ACTUAL_FINISH_BEFORE_START' | 'ACTUAL_FINISH_REMOVAL_NOT_APPLICABLE' | 'ACTUAL_FINISH_REMOVAL_REQUIRED' | 'ACTUAL_FINISH_REQUIRES_100' | 'ACTUAL_START_REQUIRED' | 'DATA_DATE_INACTIVE' | 'INVALID_ACTUAL_DAY' | 'INVALID_ACTUAL_TIME_SOURCE' | 'INVALID_DATA_DATE' | 'INVALID_DISPLAYED_FINISH' | 'INVALID_PROGRESS';
+declare class LookaheadActualTransitionError extends Error {
+    readonly code: LookaheadActualTransitionErrorCode;
+    constructor(code: LookaheadActualTransitionErrorCode);
+}
+/**
+ * Actual dates the user confirmed in the Lookahead progress dialog.
+ * `actualFinish: null` is the confirmed removal of the Actual Finish when
+ * progress drops below 100 on a completed activity.
+ */
+interface LookaheadActualIntent {
+    readonly actualStart?: Date;
+    readonly actualFinish?: Date | null;
+}
+/** Slice of the P6 activity state the Lookahead progress transition reads. */
+type LookaheadProgressActualActivityState = Pick<P6ActivityDraftState, 'actualStart' | 'actualFinish' | 'remainingDurationHours' | 'executionStatus' | 'suspendDate' | 'resumeDate' | 'physicalPercentComplete' | 'originalDurationHours' | 'percentCompleteType'>;
+/**
+ * Input of a Lookahead progress change under a Data Date: the active
+ * `dataDate` (`null` when inactive), the activity's P6 slice, the target
+ * progress (0–100) and the finish currently displayed to the user.
+ */
+interface LookaheadProgressActualInput {
+    readonly dataDate: Date | null;
+    readonly activity: Readonly<LookaheadProgressActualActivityState>;
+    readonly nextProgress: number;
+    readonly displayedFinish?: Date | null;
+}
+/**
+ * Which actual dates the transition needs: `start` is required when a
+ * not-started activity gains progress, `finish` is optional when progress
+ * reaches 100, `uncomplete` is required when a completed activity drops
+ * below 100 (the Actual Finish must be removed; the Actual Start stays).
+ * All are `null` when the Data Date is inactive.
+ */
+interface LookaheadProgressActualPlan {
+    readonly start: {
+        readonly required: true;
+        readonly suggestedAt: Date;
+    } | null;
+    readonly finish: {
+        readonly optional: true;
+        readonly suggestedAt: Date | null;
+    } | null;
+    readonly uncomplete: {
+        readonly required: true;
+        readonly removes: Date;
+    } | null;
+}
+/**
+ * Combines a `YYYY-MM-DD` day picked by the user with the UTC time of day of
+ * `timeSource`. Throws `LookaheadActualTransitionError` on an invalid day or
+ * time source.
+ */
+declare function resolveLookaheadActualDateSelection(input: {
+    readonly selectedDay: string;
+    readonly timeSource: Date;
+}): Date;
+/**
+ * Decides which actual dates a progress change requires and suggests default
+ * values (the Data Date for the start, the displayed finish for the finish).
+ * Throws `LookaheadActualTransitionError` on invalid input.
+ */
+declare function planLookaheadProgressActuals(input: LookaheadProgressActualInput): LookaheadProgressActualPlan;
+/**
+ * Validates the confirmed `intent` against the plan and returns the P6
+ * activity patch to dispatch: the actual-date transition plus, while the
+ * activity is in progress, `nextProgress` mirrored into the percent field
+ * selected by `percentCompleteType` (Physical %, or the Remaining Duration
+ * for the duration type; the units type is read-only). Throws
+ * `LookaheadActualTransitionError` when a required actual start is missing,
+ * a finish is given below 100 %, a completed activity drops below 100 %
+ * without the confirmed removal of its Actual Finish, or an intent arrives
+ * while the Data Date is inactive.
+ */
+declare function prepareLookaheadProgressActuals(input: LookaheadProgressActualInput & {
+    readonly intent?: LookaheadActualIntent;
+}): Readonly<Partial<P6ActivityDraftState>>;
+/**
+ * Prepares a Lookahead progress patch for persistence, preserving the time of
+ * an existing Actual Start or normalizing its first assignment to the activity
+ * shift.
+ */
+declare function prepareLookaheadProgressActualsForPersistence(input: LookaheadProgressActualInput & {
+    readonly intent?: LookaheadActualIntent;
+    readonly resolveCalendar: () => CalendarAPI | null;
+}): Readonly<Partial<P6ActivityDraftState>>;
+
 /** Canonical reasons why an activity field edit may be blocked. */
 declare const EDIT_DENIAL_REASON: {
     readonly COMPLETED: "completed";
@@ -1336,6 +1424,7 @@ type DispatchAction = {
     isLookahead: boolean;
     hasLookaheadTasks: boolean;
     persistedProgress?: number;
+    persistedActualTransition?: LookaheadActualIntent;
     acknowledgePersistedLookahead?: boolean;
     eventSource?: string;
 } | ScheduleAutoScheduleAction;
@@ -4171,93 +4260,6 @@ declare function resolveExpectedFinishDateSelection(input: {
     readonly displayedFinish: Date;
 }): Date;
 
-/** Validation failure raised while planning or preparing Lookahead actual dates. */
-type LookaheadActualTransitionErrorCode = 'ACTIVITY_CALENDAR_REQUIRED' | 'ACTUAL_FINISH_BEFORE_START' | 'ACTUAL_FINISH_REMOVAL_NOT_APPLICABLE' | 'ACTUAL_FINISH_REMOVAL_REQUIRED' | 'ACTUAL_FINISH_REQUIRES_100' | 'ACTUAL_START_REQUIRED' | 'DATA_DATE_INACTIVE' | 'INVALID_ACTUAL_DAY' | 'INVALID_ACTUAL_TIME_SOURCE' | 'INVALID_DATA_DATE' | 'INVALID_DISPLAYED_FINISH' | 'INVALID_PROGRESS';
-declare class LookaheadActualTransitionError extends Error {
-    readonly code: LookaheadActualTransitionErrorCode;
-    constructor(code: LookaheadActualTransitionErrorCode);
-}
-/**
- * Actual dates the user confirmed in the Lookahead progress dialog.
- * `actualFinish: null` is the confirmed removal of the Actual Finish when
- * progress drops below 100 on a completed activity.
- */
-interface LookaheadActualIntent {
-    readonly actualStart?: Date;
-    readonly actualFinish?: Date | null;
-}
-/** Slice of the P6 activity state the Lookahead progress transition reads. */
-type LookaheadProgressActualActivityState = Pick<P6ActivityDraftState, 'actualStart' | 'actualFinish' | 'remainingDurationHours' | 'executionStatus' | 'suspendDate' | 'resumeDate' | 'physicalPercentComplete' | 'originalDurationHours' | 'percentCompleteType'>;
-/**
- * Input of a Lookahead progress change under a Data Date: the active
- * `dataDate` (`null` when inactive), the activity's P6 slice, the target
- * progress (0–100) and the finish currently displayed to the user.
- */
-interface LookaheadProgressActualInput {
-    readonly dataDate: Date | null;
-    readonly activity: Readonly<LookaheadProgressActualActivityState>;
-    readonly nextProgress: number;
-    readonly displayedFinish?: Date | null;
-}
-/**
- * Which actual dates the transition needs: `start` is required when a
- * not-started activity gains progress, `finish` is optional when progress
- * reaches 100, `uncomplete` is required when a completed activity drops
- * below 100 (the Actual Finish must be removed; the Actual Start stays).
- * All are `null` when the Data Date is inactive.
- */
-interface LookaheadProgressActualPlan {
-    readonly start: {
-        readonly required: true;
-        readonly suggestedAt: Date;
-    } | null;
-    readonly finish: {
-        readonly optional: true;
-        readonly suggestedAt: Date | null;
-    } | null;
-    readonly uncomplete: {
-        readonly required: true;
-        readonly removes: Date;
-    } | null;
-}
-/**
- * Combines a `YYYY-MM-DD` day picked by the user with the UTC time of day of
- * `timeSource`. Throws `LookaheadActualTransitionError` on an invalid day or
- * time source.
- */
-declare function resolveLookaheadActualDateSelection(input: {
-    readonly selectedDay: string;
-    readonly timeSource: Date;
-}): Date;
-/**
- * Decides which actual dates a progress change requires and suggests default
- * values (the Data Date for the start, the displayed finish for the finish).
- * Throws `LookaheadActualTransitionError` on invalid input.
- */
-declare function planLookaheadProgressActuals(input: LookaheadProgressActualInput): LookaheadProgressActualPlan;
-/**
- * Validates the confirmed `intent` against the plan and returns the P6
- * activity patch to dispatch: the actual-date transition plus, while the
- * activity is in progress, `nextProgress` mirrored into the percent field
- * selected by `percentCompleteType` (Physical %, or the Remaining Duration
- * for the duration type; the units type is read-only). Throws
- * `LookaheadActualTransitionError` when a required actual start is missing,
- * a finish is given below 100 %, a completed activity drops below 100 %
- * without the confirmed removal of its Actual Finish, or an intent arrives
- * while the Data Date is inactive.
- */
-declare function prepareLookaheadProgressActuals(input: LookaheadProgressActualInput & {
-    readonly intent?: LookaheadActualIntent;
-}): Readonly<Partial<P6ActivityDraftState>>;
-/**
- * Prepares a Lookahead progress patch for persistence after calendar
- * resolution, normalizing a midnight Actual Start to the activity shift.
- */
-declare function prepareLookaheadProgressActualsForPersistence(input: LookaheadProgressActualInput & {
-    readonly intent?: LookaheadActualIntent;
-    readonly resolveCalendar: () => CalendarAPI | null;
-}): Readonly<Partial<P6ActivityDraftState>>;
-
 /** Calendars of the schedule whose working time is read. */
 interface CalendarReaderInput {
     readonly calendars: readonly BackendCalendarInput[];