@outbuild-company/schedule-core 1.22.0 → 1.24.0

package/dist/index.cjs

@@ -342,6 +342,7 @@ var LINK_REJECTION_REASON = {
 // src/dispatch/action-kinds.ts
 var DISPATCH_ACTION_KIND = {
   ACTIVITY_CLIPBOARD_CLEAR: "activity-clipboard-clear",
+  ACTIVITY_CLIPBOARD_IMPORT: "activity-clipboard-import",
   ACTIVITY_COPY: "activity-copy",
   CALENDAR_RECONCILE: "calendar-reconcile",
   ACTIVITY_PASTE_COPIED: "activity-paste-copied",
@@ -524,6 +525,7 @@ function createActivitiesApi(engine) {
     hasChildren: (parentId) => engine.hasChild(parentId),
     indentTargetParentIds: (ids) => engine.getIndentTargetParentIds(ids),
     isCustomIdInUse: (customId, currentCustomId) => engine.isCustomIdInUse(customId, currentCustomId ?? null),
+    clipboard: () => engine.getActivityClipboardView(),
     create: (input, options) => engine.dispatch(
       { ...input, kind: DISPATCH_ACTION_KIND.ACTIVITY_CREATE },
       options
@@ -606,6 +608,12 @@ function createActivitiesApi(engine) {
       ...context,
       kind: DISPATCH_ACTION_KIND.ACTIVITY_CLIPBOARD_CLEAR
     }),
+    importClipboard: (snapshot, references, context = {}) => engine.dispatch({
+      ...context,
+      kind: DISPATCH_ACTION_KIND.ACTIVITY_CLIPBOARD_IMPORT,
+      snapshot,
+      ...references === void 0 ? {} : { references }
+    }),
     lookaheadSync: (input) => engine.dispatch({
       ...input,
       kind: DISPATCH_ACTION_KIND.ACTIVITY_LOOKAHEAD_SYNC
@@ -948,6 +956,7 @@ var REJECTION_REASON = {
   ACTIVITY_IDS_EMPTY: "activity_ids_empty",
   NO_ACTIVITY_SELECTION: "no_activity_selection",
   CLIPBOARD_EMPTY: "clipboard_empty",
+  CLIPBOARD_SNAPSHOT_INVALID: "clipboard_snapshot_invalid",
   ACTIVITY_PASTE_INVARIANT_FAILED: "activity_paste_invariant_failed",
   SOLE_SCHEDULE_ROOT: "sole_schedule_root",
   ANCHOR_SIBLING_CONFLICT: "anchor_sibling_conflict",
@@ -11744,6 +11753,7 @@ var NON_SCHEDULING_INLINE_COLUMNS = /* @__PURE__ */ new Set([
 ]);
 var NON_SCHEDULING_KINDS = /* @__PURE__ */ new Set([
   DISPATCH_ACTION_KIND.ACTIVITY_CLIPBOARD_CLEAR,
+  DISPATCH_ACTION_KIND.ACTIVITY_CLIPBOARD_IMPORT,
   DISPATCH_ACTION_KIND.ACTIVITY_COPY,
   DISPATCH_ACTION_KIND.CELL_CLIPBOARD_CLEAR,
   DISPATCH_ACTION_KIND.CELL_COPY,
@@ -11764,6 +11774,7 @@ var NON_SCHEDULING_KINDS = /* @__PURE__ */ new Set([
 ]);
 var PURE_VIEW_STATE_KINDS = /* @__PURE__ */ new Set([
   DISPATCH_ACTION_KIND.ACTIVITY_CLIPBOARD_CLEAR,
+  DISPATCH_ACTION_KIND.ACTIVITY_CLIPBOARD_IMPORT,
   DISPATCH_ACTION_KIND.ACTIVITY_COPY,
   DISPATCH_ACTION_KIND.CELL_CLIPBOARD_CLEAR,
   DISPATCH_ACTION_KIND.CELL_COPY,
@@ -11968,14 +11979,65 @@ function createOutbuildP6ActivityDraft(activity) {
   if (state === void 0) return void 0;
   return {
     ...state,
-    remainingDurationHours: draftRemainingDuration(activity)
+    ...outbuildProgressExecution(activity, activity.durationHours)
   };
 }
-function draftRemainingDuration(activity) {
+var COMPLETED_PHYSICAL_PERCENT = 100;
+var NOT_STARTED_PHYSICAL_PERCENT = 0;
+function outbuildProgressExecution(activity, originalDurationHours) {
   if (activity.progress === NOT_STARTED_PROGRESS) {
-    return activity.durationHours;
+    return {
+      executionStatus: P6_EXECUTION_STATUS.NOT_STARTED,
+      actualStart: null,
+      actualFinish: null,
+      remainingDurationHours: originalDurationHours,
+      physicalPercentComplete: NOT_STARTED_PHYSICAL_PERCENT,
+      actualDurationHours: 0,
+      atCompletionDurationHours: originalDurationHours,
+      durationPercentComplete: 0
+    };
   }
-  return isCompletedProgress(activity.progress) ? 0 : null;
+  const actualStart = cloneValidDate(activity.startDate, "actualStart");
+  if (isCompletedProgress(activity.progress)) {
+    const hasMeasurableDuration = originalDurationHours > 0;
+    return {
+      executionStatus: P6_EXECUTION_STATUS.COMPLETED,
+      actualStart,
+      actualFinish: cloneValidDate(activity.endDate, "actualFinish"),
+      remainingDurationHours: 0,
+      physicalPercentComplete: COMPLETED_PHYSICAL_PERCENT,
+      actualDurationHours: originalDurationHours,
+      atCompletionDurationHours: originalDurationHours,
+      durationPercentComplete: hasMeasurableDuration ? COMPLETED_PHYSICAL_PERCENT : NOT_STARTED_PHYSICAL_PERCENT
+    };
+  }
+  return {
+    executionStatus: P6_EXECUTION_STATUS.IN_PROGRESS,
+    actualStart,
+    actualFinish: null,
+    remainingDurationHours: originalDurationHours,
+    physicalPercentComplete: activity.progress,
+    actualDurationHours: 0,
+    atCompletionDurationHours: originalDurationHours,
+    durationPercentComplete: 0
+  };
+}
+function awaitsOutbuildExecution(draft) {
+  return draft.executionStatus === P6_EXECUTION_STATUS.NOT_STARTED && draft.actualStart === null;
+}
+function reconcileOutbuildProgress(activity, draft) {
+  const isProgressed = activity.progress !== NOT_STARTED_PROGRESS;
+  if (!isProgressed || !awaitsOutbuildExecution(draft)) return draft;
+  const inferred = outbuildProgressExecution(
+    activity,
+    draft.originalDurationHours
+  );
+  const keepsRecordedRemaining = inferred.executionStatus === P6_EXECUTION_STATUS.IN_PROGRESS && draft.remainingDurationHours !== null;
+  return {
+    ...draft,
+    ...inferred,
+    ...keepsRecordedRemaining ? { remainingDurationHours: draft.remainingDurationHours } : {}
+  };
 }
 
 // src/p6/inactive-drafts.ts
@@ -12028,17 +12090,41 @@ function ordinaryInputChanges(before, activity) {
     ...before.startDate.getTime() !== activity.startDate.getTime() ? { plannedStart: new Date(activity.startDate) } : {},
     ...before.endDate.getTime() !== activity.endDate.getTime() ? { plannedFinish: new Date(activity.endDate) } : {},
     ...durationChanged ? { originalDurationHours: activity.durationHours } : {},
-    ...durationChanged || before.progress !== activity.progress ? remainingInputChanges(before, activity) : {}
+    ...durationChanged || before.progress !== activity.progress ? executionInputChanges(before, activity, durationChanged) : {}
   };
 }
-function remainingInputChanges(before, activity) {
+function executionInputChanges(before, activity, durationChanged) {
   const current = activity.p6;
-  if (current.actualStart !== null || current.remainingDurationHours !== before.p6.remainingDurationHours)
-    return {};
-  const remaining = draftRemainingDuration(activity);
+  const hasExplicitRemainingCorrection = current.remainingDurationHours !== before.p6.remainingDurationHours;
+  if (hasExplicitRemainingCorrection) return {};
+  const progressChanged = before.progress !== activity.progress;
+  const resetsToNotStarted = progressChanged && activity.progress === NOT_STARTED_PROGRESS;
+  if (awaitsOutbuildExecution(current) || resetsToNotStarted) {
+    const originalDurationHours = durationChanged ? activity.durationHours : current.originalDurationHours;
+    return outbuildProgressExecution(activity, originalDurationHours);
+  }
+  const isStarted = current.actualStart !== null;
+  if (!isStarted || !progressChanged) return {};
+  return startedProgressChanges(current, activity);
+}
+function startedProgressChanges(current, activity) {
+  const mirrorsPhysicalPercent = current.percentCompleteType === P6_PERCENT_COMPLETE_TYPE.PHYSICAL;
+  if (!isCompletedProgress(activity.progress)) {
+    return {
+      ...current.actualFinish === null ? {} : {
+        executionStatus: P6_EXECUTION_STATUS.IN_PROGRESS,
+        actualFinish: null
+      },
+      ...mirrorsPhysicalPercent ? { physicalPercentComplete: activity.progress } : {}
+    };
+  }
+  const finishesAfterActualStart = current.actualStart !== null && activity.endDate.getTime() >= current.actualStart.getTime();
+  if (current.actualFinish !== null || !finishesAfterActualStart) return {};
   return {
-    remainingDurationHours: remaining,
-    ...remaining !== null ? { atCompletionDurationHours: remaining } : {}
+    executionStatus: P6_EXECUTION_STATUS.COMPLETED,
+    actualFinish: new Date(activity.endDate),
+    remainingDurationHours: 0,
+    physicalPercentComplete: COMPLETED_PROGRESS
   };
 }
 
@@ -18381,8 +18467,7 @@ function dispatchActivityCopy(action, deps) {
   if (!selection.ok) return selection;
   return { ...selection, changes: { ...selection.changes, source: action } };
 }
-function dispatchActivityClipboardClear(action, clipboard) {
-  clipboard.value = null;
+function clipboardOnlyResult(action) {
   return {
     ok: true,
     changes: {
@@ -18394,6 +18479,57 @@ function dispatchActivityClipboardClear(action, clipboard) {
     }
   };
 }
+function dispatchActivityClipboardClear(action, clipboard) {
+  clipboard.value = null;
+  return clipboardOnlyResult(action);
+}
+function keepKnownIds(ids, known) {
+  if (ids === void 0 || known === void 0) return ids;
+  const knownSet = new Set(known);
+  return ids.filter((id) => knownSet.has(id));
+}
+function localizeOverrides(overrides, deps, references) {
+  const localized = cloneDomainValue(overrides);
+  const hasUnknownCalendar = localized.calendarId != null && !deps.calendars.has(localized.calendarId);
+  if (hasUnknownCalendar) delete localized.calendarId;
+  const hasUnknownSubcontract = references?.subcontractIds !== void 0 && localized.subcontractId != null && !references.subcontractIds.includes(localized.subcontractId);
+  if (hasUnknownSubcontract) localized.subcontractId = null;
+  const responsableIds = keepKnownIds(
+    localized.responsableIds,
+    references?.responsableIds
+  );
+  if (responsableIds !== void 0)
+    localized.responsableIds = [...responsableIds];
+  const tagIds = keepKnownIds(localized.tagIds, references?.tagIds);
+  if (tagIds !== void 0) localized.tagIds = [...tagIds];
+  return localized;
+}
+function hasDanglingLink(snapshot) {
+  const copiedIds = new Set(
+    snapshot.activities.map((entry) => String(entry.originalId))
+  );
+  return snapshot.links.some(
+    (link) => !copiedIds.has(String(link.source)) || !copiedIds.has(String(link.target))
+  );
+}
+function dispatchActivityClipboardImport(action, deps) {
+  const { snapshot, references } = action;
+  if (snapshot.activities.length === 0) {
+    return { ok: false, reason: REJECTION_REASON.CLIPBOARD_EMPTY };
+  }
+  if (hasDanglingLink(snapshot)) {
+    return { ok: false, reason: REJECTION_REASON.CLIPBOARD_SNAPSHOT_INVALID };
+  }
+  deps.clipboard.value = {
+    activities: snapshot.activities.map((entry) => ({
+      originalId: entry.originalId,
+      originalParentId: entry.originalParentId,
+      overrides: localizeOverrides(entry.overrides, deps, references)
+    })),
+    links: snapshot.links.map((link) => cloneDomainValue(link))
+  };
+  return clipboardOnlyResult(action);
+}
 
 // src/activity-copy-paste/paste.ts
 function resolveDestination(afterSiblingId, adapter) {
@@ -18999,6 +19135,12 @@ async function performDispatch(action, options, deps) {
   if (action.kind === DISPATCH_ACTION_KIND.ACTIVITY_CLIPBOARD_CLEAR) {
     return dispatchActivityClipboardClear(action, deps.activityClipboard);
   }
+  if (action.kind === DISPATCH_ACTION_KIND.ACTIVITY_CLIPBOARD_IMPORT) {
+    return dispatchActivityClipboardImport(action, {
+      clipboard: deps.activityClipboard,
+      calendars: deps.calendars
+    });
+  }
   if (action.kind === DISPATCH_ACTION_KIND.ACTIVITY_PASTE_COPIED) {
     return dispatchActivityPasteCopied(action, options, deps);
   }
@@ -23415,7 +23557,7 @@ function getDispatchHistoryPolicy(action) {
   if (action.kind === DISPATCH_ACTION_KIND.PERSISTENCE_ACKNOWLEDGE) {
     return DISPATCH_HISTORY_POLICY.CHECKPOINT_ON_SUCCESS;
   }
-  if (action.kind === DISPATCH_ACTION_KIND.SIR_SYNC || action.kind === DISPATCH_ACTION_KIND.CALENDAR_RECONCILE || action.kind === DISPATCH_ACTION_KIND.ACTIVITY_LOOKAHEAD_SYNC || action.kind === DISPATCH_ACTION_KIND.BASELINE_APPLY || action.kind === DISPATCH_ACTION_KIND.PONDERATOR_CRITERION_SET || action.kind === DISPATCH_ACTION_KIND.STATUS_CRITERIA_SET || action.kind === DISPATCH_ACTION_KIND.ACTIVITY_CLIPBOARD_CLEAR || action.kind === DISPATCH_ACTION_KIND.ACTIVITY_COPY || action.kind === DISPATCH_ACTION_KIND.SELECTION_TOGGLE || action.kind === DISPATCH_ACTION_KIND.SELECTION_REPLACE || action.kind === DISPATCH_ACTION_KIND.VISIBILITY_SET || action.kind === DISPATCH_ACTION_KIND.FILTER_SET || action.kind === DISPATCH_ACTION_KIND.SORT_SET || action.kind === DISPATCH_ACTION_KIND.VIEW_ATTRIBUTES_SET || action.kind === DISPATCH_ACTION_KIND.GROUP_SET || action.kind === DISPATCH_ACTION_KIND.WBS_DEPTH_SET) {
+  if (action.kind === DISPATCH_ACTION_KIND.SIR_SYNC || action.kind === DISPATCH_ACTION_KIND.CALENDAR_RECONCILE || action.kind === DISPATCH_ACTION_KIND.ACTIVITY_LOOKAHEAD_SYNC || action.kind === DISPATCH_ACTION_KIND.BASELINE_APPLY || action.kind === DISPATCH_ACTION_KIND.PONDERATOR_CRITERION_SET || action.kind === DISPATCH_ACTION_KIND.STATUS_CRITERIA_SET || action.kind === DISPATCH_ACTION_KIND.ACTIVITY_CLIPBOARD_CLEAR || action.kind === DISPATCH_ACTION_KIND.ACTIVITY_CLIPBOARD_IMPORT || action.kind === DISPATCH_ACTION_KIND.ACTIVITY_COPY || action.kind === DISPATCH_ACTION_KIND.SELECTION_TOGGLE || action.kind === DISPATCH_ACTION_KIND.SELECTION_REPLACE || action.kind === DISPATCH_ACTION_KIND.VISIBILITY_SET || action.kind === DISPATCH_ACTION_KIND.FILTER_SET || action.kind === DISPATCH_ACTION_KIND.SORT_SET || action.kind === DISPATCH_ACTION_KIND.VIEW_ATTRIBUTES_SET || action.kind === DISPATCH_ACTION_KIND.GROUP_SET || action.kind === DISPATCH_ACTION_KIND.WBS_DEPTH_SET) {
     return DISPATCH_HISTORY_POLICY.SKIP;
   }
   return DISPATCH_HISTORY_POLICY.RECORD;
@@ -26178,8 +26320,8 @@ var P6ActivityStatusError = class extends Error {
   }
   code;
 };
-var COMPLETED_PHYSICAL_PERCENT = 100;
-var NOT_STARTED_PHYSICAL_PERCENT = 0;
+var COMPLETED_PHYSICAL_PERCENT2 = 100;
+var NOT_STARTED_PHYSICAL_PERCENT2 = 0;
 function validateP6ActivityStatus(activity) {
   validateRemainingDuration(activity.remainingDurationHours);
   validateDates(activity);
@@ -26205,11 +26347,11 @@ function normalizeP6ActualDatePatch(current, patch) {
     executionStatus,
     ...actualFinish !== null ? {
       remainingDurationHours: 0,
-      physicalPercentComplete: COMPLETED_PHYSICAL_PERCENT
+      physicalPercentComplete: COMPLETED_PHYSICAL_PERCENT2
     } : {},
     ...unStarting ? {
       remainingDurationHours: current.originalDurationHours,
-      physicalPercentComplete: NOT_STARTED_PHYSICAL_PERCENT
+      physicalPercentComplete: NOT_STARTED_PHYSICAL_PERCENT2
     } : {}
   };
   validateP6ActivityDraftStatus({ ...current, ...normalized2 });
@@ -30242,7 +30384,7 @@ function initializeDataDate(input, activities) {
 function attachImportedDataDate(activities, imported, settings) {
   for (const activity of activities) {
     const importedP6 = Object.hasOwn(imported, activity.id) ? imported[activity.id] : void 0;
-    const p6 = importedP6 ?? createOutbuildP6ActivityDraft(activity);
+    const p6 = importedP6 === void 0 ? createOutbuildP6ActivityDraft(activity) : reconcileOutbuildProgress(activity, importedP6);
     if (p6 === void 0) continue;
     activity.p6 = p6;
     if (!hasActiveDataDate(settings)) continue;
@@ -31171,6 +31313,18 @@ var ScheduleCore = class _ScheduleCore {
     this.assertReady();
     return readSelectedActivityIds(this.coreRuntime.state);
   }
+  /**
+   * Reads the core-owned activity clipboard as a portable snapshot.
+   *
+   * The snapshot can be imported into another `ScheduleCore` through the
+   * `activity-clipboard-import` command, which is how a copy survives the
+   * replacement of the schedule instance.
+   * @returns A defensive copy, or `null` when nothing has been copied.
+   */
+  getActivityClipboardView() {
+    this.assertReady();
+    return cloneDomainValue(this._activityClipboard.value);
+  }
   /** @returns A defensive snapshot of explicitly hidden activity IDs. */
   getHiddenActivityIds() {
     this.assertReady();