@outbuild-company/schedule-core 1.22.0 → 1.23.0

package/dist/index.d.cts

@@ -17,6 +17,20 @@ declare const LINK_TYPE: {
 /** Canonical stored dependency relationship. */
 type LinkType = (typeof LINK_TYPE)[keyof typeof LINK_TYPE];
 
+/** Named normalized activity scheduling constraints. */
+declare const CONSTRAINT_TYPE: {
+    readonly ASAP: "asap";
+    readonly ALAP: "alap";
+    readonly SNET: "snet";
+    readonly SNLT: "snlt";
+    readonly FNET: "fnet";
+    readonly FNLT: "fnlt";
+    readonly MSO: "mso";
+    readonly MFO: "mfo";
+};
+/** Normalized activity scheduling constraint. */
+type ConstraintType = (typeof CONSTRAINT_TYPE)[keyof typeof CONSTRAINT_TYPE];
+
 interface WorkTimeQuery {
     readonly direction: WorkTimeDirection;
     readonly date: Date;
@@ -198,13 +212,10 @@ declare const NOT_STARTED_PROGRESS = 0;
 /** Progress percentage representing a completed activity. */
 declare const COMPLETED_PROGRESS = 100;
 
-declare const CREATION_OVERRIDE_FIELD_LIST: readonly ["name", "description", "type", "startDate", "durationHours", "constraintType", "constraintDate", "calendarId", "assignedDefaultCalendar", "autoScheduling", "progress", "cost", "usedCost", "realCost", "workHours", "realWorkHours", "ponderator", "hasCustomPonderator", "customId", "subcontractId", "responsableIds", "tagIds", "isLookahead"];
-type CreationOverrideField = (typeof CREATION_OVERRIDE_FIELD_LIST)[number];
-type CreationOverrides = Partial<Pick<CoreActivity, CreationOverrideField>>;
-
 /** Discriminators for commands accepted by {@link ScheduleCore.dispatch}. */
 declare const DISPATCH_ACTION_KIND: {
     readonly ACTIVITY_CLIPBOARD_CLEAR: "activity-clipboard-clear";
+    readonly ACTIVITY_CLIPBOARD_IMPORT: "activity-clipboard-import";
     readonly ACTIVITY_COPY: "activity-copy";
     readonly CALENDAR_RECONCILE: "calendar-reconcile";
     readonly ACTIVITY_PASTE_COPIED: "activity-paste-copied";
@@ -722,6 +733,11 @@ type DispatchAction = {
 } | {
     kind: typeof DISPATCH_ACTION_KIND.ACTIVITY_CLIPBOARD_CLEAR;
     eventSource?: string;
+} | {
+    kind: typeof DISPATCH_ACTION_KIND.ACTIVITY_CLIPBOARD_IMPORT;
+    snapshot: ActivityClipboardSnapshot;
+    references?: ActivityClipboardReferences;
+    eventSource?: string;
 } | {
     kind: typeof DISPATCH_ACTION_KIND.ACTIVITY_PASTE_COPIED;
     destination: {
@@ -1578,19 +1594,38 @@ interface EntityChange<T> {
     after: Readonly<T> | null;
 }
 
-/** Named normalized activity scheduling constraints. */
-declare const CONSTRAINT_TYPE: {
-    readonly ASAP: "asap";
-    readonly ALAP: "alap";
-    readonly SNET: "snet";
-    readonly SNLT: "snlt";
-    readonly FNET: "fnet";
-    readonly FNLT: "fnlt";
-    readonly MSO: "mso";
-    readonly MFO: "mfo";
-};
-/** Normalized activity scheduling constraint. */
-type ConstraintType = (typeof CONSTRAINT_TYPE)[keyof typeof CONSTRAINT_TYPE];
+declare const CREATION_OVERRIDE_FIELD_LIST: readonly ["name", "description", "type", "startDate", "durationHours", "constraintType", "constraintDate", "calendarId", "assignedDefaultCalendar", "autoScheduling", "progress", "cost", "usedCost", "realCost", "workHours", "realWorkHours", "ponderator", "hasCustomPonderator", "customId", "subcontractId", "responsableIds", "tagIds", "isLookahead"];
+type CreationOverrideField = (typeof CREATION_OVERRIDE_FIELD_LIST)[number];
+type CreationOverrides = Partial<Pick<CoreActivity, CreationOverrideField>>;
+
+/** One copied activity: its identity in the source schedule plus the fields a paste recreates. */
+interface ActivityClipboardEntry {
+    readonly originalId: ActivityId;
+    readonly originalParentId: ActivityId | typeof ROOT_PARENT_ID;
+    readonly overrides: CreationOverrides;
+}
+/**
+ * Portable snapshot of the activity clipboard.
+ *
+ * `originalId`, `originalParentId` and the link endpoints are only mapping
+ * keys inside the snapshot, so a snapshot exported from one schedule can be
+ * imported into another one.
+ */
+interface ActivityClipboardSnapshot {
+    readonly activities: ReadonlyArray<ActivityClipboardEntry>;
+    readonly links: ReadonlyArray<Readonly<Link>>;
+}
+/**
+ * Consumer-owned reference catalogs of the destination schedule.
+ *
+ * Every provided list filters the copied field on import; an omitted list
+ * leaves that field untouched.
+ */
+interface ActivityClipboardReferences {
+    readonly subcontractIds?: ReadonlyArray<number>;
+    readonly responsableIds?: ReadonlyArray<string>;
+    readonly tagIds?: ReadonlyArray<string>;
+}
 
 declare const SAVE_FIELD_POLICY: {
     readonly TRACKED: "tracked";
@@ -1950,6 +1985,12 @@ interface ScheduleActivitiesApi {
      * @param currentCustomId - Existing value to ignore, or `null`.
      */
     isCustomIdInUse(customId: string, currentCustomId?: string | null): boolean;
+    /**
+     * Reads the activity clipboard as a portable snapshot.
+     *
+     * @returns A defensive copy, or `null` when nothing has been copied.
+     */
+    clipboard(): ActivityClipboardSnapshot | null;
     /**
      * Creates one activity through the canonical dispatch pipeline.
      *
@@ -2071,6 +2112,21 @@ interface ScheduleActivitiesApi {
     duplicate(activityIds: ReadonlyArray<ActivityId>, context?: MutationContext): Promise<DispatchResult>;
     /** @returns The complete result of clearing core-owned clipboard state. */
     clearClipboard(context?: MutationContext): Promise<DispatchResult>;
+    /**
+     * Replaces the activity clipboard with a snapshot exported elsewhere.
+     *
+     * Copied `calendarId` values unknown to this schedule are dropped so the
+     * paste falls back to the schedule default calendar; every list in
+     * `references` filters the matching copied field. Rejects an empty
+     * snapshot (`clipboard_empty`) or one whose links point outside its own
+     * activities (`clipboard_snapshot_invalid`). Never touches history or
+     * persistence tracking.
+     * @param snapshot - Snapshot read through {@link ScheduleActivitiesApi.clipboard}.
+     * @param references - Destination reference catalogs, when known.
+     * @param context - Optional consumer event source.
+     * @returns The complete dispatch result.
+     */
+    importClipboard(snapshot: ActivityClipboardSnapshot, references?: ActivityClipboardReferences, context?: MutationContext): Promise<DispatchResult>;
     /**
      * Synchronizes consumer-owned lookahead metadata into core state.
      *
@@ -2978,6 +3034,15 @@ declare class ScheduleCore {
     getChildrenIds(parentId: ActivityId | typeof ROOT_PARENT_ID): ReadonlyArray<ActivityId>;
     /** @returns A defensive snapshot of selected activity IDs. */
     getSelectedActivityIds(): string[];
+    /**
+     * 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(): ActivityClipboardSnapshot | null;
     /** @returns A defensive snapshot of explicitly hidden activity IDs. */
     getHiddenActivityIds(): string[];
     /** @returns A defensive snapshot of activity IDs not currently hidden. */
@@ -3602,6 +3667,7 @@ declare const REJECTION_REASON: {
     readonly ACTIVITY_IDS_EMPTY: "activity_ids_empty";
     readonly NO_ACTIVITY_SELECTION: "no_activity_selection";
     readonly CLIPBOARD_EMPTY: "clipboard_empty";
+    readonly CLIPBOARD_SNAPSHOT_INVALID: "clipboard_snapshot_invalid";
     readonly ACTIVITY_PASTE_INVARIANT_FAILED: "activity_paste_invariant_failed";
     readonly SOLE_SCHEDULE_ROOT: "sole_schedule_root";
     readonly ANCHOR_SIBLING_CONFLICT: "anchor_sibling_conflict";
@@ -3631,4 +3697,4 @@ declare const DISPATCH_TRACK_EVENT: {
 /** Consumer analytics event name emitted by a schedule mutation. */
 type DispatchTrackEvent = (typeof DISPATCH_TRACK_EVENT)[keyof typeof DISPATCH_TRACK_EVENT];
 
-export { ACTIVITY_BATCH_ACTION_KIND, ACTIVITY_BATCH_MODE, ACTIVITY_DATE_EDGE, ACTIVITY_FIELD, ACTIVITY_PONDERATOR_CRITERION, ACTIVITY_PROGRESS_ORIGIN, ACTIVITY_TYPE, type ActivityBaselineSnapshot, type ActivityBatchAction, type ActivityBatchInput, type ActivityBatchItem, type ActivityBatchItemInput, type ActivityBatchLinkInput$1 as ActivityBatchLinkInput, type ActivityBatchMode, type ActivityBatchParentReference, type ActivityBatchReference, type ActivityBulkEdit, type ActivityCreateInput, type ActivityCreationOverrides, type ActivityCreter, type ActivityDateEdge, type ActivityDateEdit, type ActivityField, type ActivityFieldEdit, type ActivityFieldValue, type ActivityId, type ActivityLookaheadSyncInput, type ActivityMoveInput, type ActivityStatus, type ActivityType, type ApplyLookaheadConversionInput, type BackendActivityInput, type BackendCalendarExceptionInput, type BackendCalendarInput, type BackendLinkInput, type BackendScheduleInput, type BackendSectorInput, type BackendShiftInput, type BaselinePoint, type BaselineVersion, type BranchOrderChange, CALENDAR_UNIT, CHANGE_SET_SOURCE_KIND, COLUMN, COMPLETED_PROGRESS, CONFIRMATION_KIND, CONSTRAINT_TYPE, CONSTRAINT_TYPE_TO_LABEL, CONSTRAINT_WARNING_KIND, CREATION_KIND, type Calendar, type CalendarId, type CalendarLike, type CalendarUnit, type CalendarWorktime, type ChangeSet, type ChangeSetSource, type ColumnName, type ConfirmationAlternative, type ConfirmationKind, type ConfirmationRequest, type ConstraintType, type ConstraintWarning, type CoreActivity, type CoreBaselinePoint, type CreationKind, type CriticalPathResult, P6_PROPERTY_CONTRACT as DATA_DATE_PROPERTY_CONTRACT, DATE_GESTURE_KIND, DEFAULT_HOURS_PER_DAY, DISPATCH_ACTION_KIND, DISPATCH_ACTION_KINDS, DISPATCH_LINK_OPERATION_KIND, DISPATCH_TRACK_EVENT, type P6ActivityCalculationInputs as DataDateActivityCalculationInputs, type P6ActivityColumnKey as DataDateActivityColumnKey, type P6ActivityData as DataDateActivityData, type P6ActivityDraftState as DataDateActivityDraftState, type P6ActivityInputPatch as DataDateActivityInputPatch, type P6ActivityState as DataDateActivityState, type P6ActivityType as DataDateActivityType, P6CapabilityError as DataDateCapabilityError, type P6CapabilityErrorCode as DataDateCapabilityErrorCode, type P6DependencyReference as DataDateDependencyReference, type P6DiagnosticProjectIdentity as DataDateDiagnosticProjectIdentity, type P6DiagnosticRelationship as DataDateDiagnosticRelationship, type P6DiagnosticRelationshipType as DataDateDiagnosticRelationshipType, type P6DurationType as DataDateDurationType, type P6EndingActivityOption as DataDateEndingActivityOption, type P6EndingActivityPage as DataDateEndingActivityPage, type P6EndingActivitySearch as DataDateEndingActivitySearch, type P6MappedScheduleOptions as DataDateMappedScheduleOptions, type P6MissingActivityInput as DataDateMissingActivityInput, type P6OutOfSequencePolicy as DataDateOutOfSequencePolicy, type P6ProjectPlannedStartChange as DataDateProjectPlannedStartChange, type P6ProjectState as DataDateProjectState, type P6PropertyContractRow as DataDatePropertyContractRow, type P6PropertyEdgeCases as DataDatePropertyEdgeCases, type P6RawProjectOptions as DataDateRawProjectOptions, type P6RawScheduleOptions as DataDateRawScheduleOptions, type P6RequiredHistoricalField as DataDateRequiredHistoricalField, type P6ResourceAssignment as DataDateResourceAssignment, type P6ScheduleDiagnostic as DataDateScheduleDiagnostic, type P6ScheduleDiagnosticCode as DataDateScheduleDiagnosticCode, type P6ScheduleInput as DataDateScheduleInput, type P6ScheduleReadiness as DataDateScheduleReadiness, type P6ScheduleResult as DataDateScheduleResult, type P6ScheduleRunLog as DataDateScheduleRunLog, type P6ScheduleSettings as DataDateScheduleSettings, type P6ScheduleWarning as DataDateScheduleWarning, type P6SettingsChange as DataDateSettingsChange, type DateGesture, type DateGestureKind, type DateGesturePreview, type DatesBatchVerdict, type DeletedActivitySnapshot, type DeletedLinkSnapshot, type DispatchAction, type DispatchActionKind, type DispatchManyAction, type DispatchManyChangeSetSource, type DispatchManyResult, type DispatchOptions, type DispatchRejectReason, type DispatchResult, type DispatchTrackEvent, EDIT_ALERT_KEY, EDIT_DENIAL_REASON, ENTITY_CHANGE_KIND, type EditAlertKey, type EditDenialReason, type EditResult, type EditableColumnName, type EffectiveGraphAudit, type EntityChange, type ActivityBatchLinkInput as ErgonomicActivityBatchLinkInput, type ExpectedProgressAdapter, FILTER_FIELD, FILTER_LOGIC, FILTER_OPERATOR, FILTER_REJECTION_REASON, FILTER_VALUE_KIND, FLAT_WBS_DEPTH, type FilterCriterion, type FilterCriterionGroup, type FilterCriterionValue, type FilterDateRange, type FilterField, type FilterLogic, type FilterOperator, type FilterRejection, type FilterState, type FilterValueKind, GROUP_ID_PREFIX, GROUP_ID_SEPARATOR, type GroupCriterion, type GroupCriterionInput, type GroupLevelWindow, type GroupState, type GroupStateInput, type ImpactRequestSyncInput, LINK_BATCH_OPERATION_KIND, LINK_CODE, LINK_CODE_TO_TYPE, LINK_REJECTION_REASON, LINK_RELATIONSHIP, LINK_TYPE, LINK_TYPE_CODE, type Link, type LinkBatchOperationKind, type LinkBatchRequest, type LinkBatchVerdict, type LinkCreateRequest, type LinkId, type LinkPatchRequest, type LinkRejection, type LinkRelationship, type LinkType, type LinkTypeCode, type LinkUpdateAction, type LinksBatchOperation, type LoadDiagnostic, type LoadDiagnosticCode, type LookaheadActualIntent, LookaheadActualTransitionError, type LookaheadActualTransitionErrorCode, type LookaheadConversionFormerParent, type LookaheadConversionGroup, type LookaheadConversionInput, type LookaheadConversionMilestoneMove, type LookaheadConversionPlan, type LookaheadConversionResult, type LookaheadDerivedCalendars, type LookaheadDerivedFields, type LookaheadDerivedFieldsResolver, type LookaheadDerivedInput, type LookaheadProgressActualActivityState, type LookaheadProgressActualInput, type LookaheadProgressActualPlan, MINIMUM_GROUP_DEPTH, MINIMUM_GROUP_LEVEL, type MutationContext, NEW_ACTIVITY_DEFAULTS, NOT_STARTED_PROGRESS, ORDER_DIRECTION, ORDER_MODE, type OrderDirection, type OrderMode, type OrderRule, type OrderState, type ParsedInput, type PendingRequest, type PersistableActivityField, type PersistedEntityIdentity, type PersistenceCheckpoint, type PipelineColumnName, type ProjectWorkHours, REJECTION_REASON, ROOT_PARENT_ID, SCHEDULE_CORE_STATUS, SCHEDULE_EFFECT_KIND, SIR_AUTO_REJECT_REASON, STATUS, STATUS_CRITERIA, type ScheduleActivitiesApi, type ScheduleApiNamespaces, type ScheduleAutoScheduleAction, type ScheduleBaselinesApi, type ScheduleCalendarsApi, type ScheduleCellsApi, ScheduleCore, type ScheduleCoreInput, type ScheduleCoreReporter, type ScheduleCoreStatus, type ScheduleCriticalPathApi, type ScheduleP6Api as ScheduleDataDatesApi, type ScheduleDiagnosticsApi, type ScheduleEffect, type ScheduleHistoryApi, type ScheduleImpactRequestsApi, type ScheduleLinksApi, type SchedulePersistenceApi, type ScheduleProjectionApi, type ScheduleSelectionApi, type ScheduleViewApi, type SectorMetadata, type SelectionToggleInput, type StaticActivityDefaults, type StatusCriteria, type TrackingEvent, UNASSIGNED_GROUP_LABEL, UNASSIGNED_VALUE_ID, type UndoOptions, VIEW_ATTRIBUTE_KIND, VISUAL_ROW_KIND, type ViewAttributeAssignmentInput, type ViewAttributeCatalogInput, type ViewAttributeFilterCriterion, type ViewAttributeOrderRule, type ViewAttributeValueInput, type ViewFilterInput, type ViewStateChange, type ViewStatePropChange, type VisualRow, WORK_TIME_DIRECTION, type WbsDepth, type WithProplannerId, type WorkTimeDirection, allowedSecondaryConstraintTypes, appendGroupRowId, buildGroupRowId, checkNoUpdatedLinks, computeExpectedProgress, createLookaheadDerivedFields, createOutbuildP6ScheduleSettings as createOutbuildDataDateScheduleSettings, createSchedule, expectedProgressFromBaseline, formatUtcAsP6WallDate, getActiveBaseline, getUnsavedActivities, isRootParent, isViewAttributeCriterion, isViewAttributeOrderRule, mapP6ScheduleOptions as mapDataDateScheduleOptions, normalizeParentKey, parseFromBackend, parseP6DayAsCalendarStart, parseP6WallDateAsUtc, planLookaheadProgressActuals, prepareLookaheadProgressActuals, resolveExpectedFinishDateSelection, resolveLookaheadActualDateSelection, willRunCriticalPath, yieldToBrowser };
+export { ACTIVITY_BATCH_ACTION_KIND, ACTIVITY_BATCH_MODE, ACTIVITY_DATE_EDGE, ACTIVITY_FIELD, ACTIVITY_PONDERATOR_CRITERION, ACTIVITY_PROGRESS_ORIGIN, ACTIVITY_TYPE, type ActivityBaselineSnapshot, type ActivityBatchAction, type ActivityBatchInput, type ActivityBatchItem, type ActivityBatchItemInput, type ActivityBatchLinkInput$1 as ActivityBatchLinkInput, type ActivityBatchMode, type ActivityBatchParentReference, type ActivityBatchReference, type ActivityBulkEdit, type ActivityClipboardEntry, type ActivityClipboardReferences, type ActivityClipboardSnapshot, type ActivityCreateInput, type ActivityCreationOverrides, type ActivityCreter, type ActivityDateEdge, type ActivityDateEdit, type ActivityField, type ActivityFieldEdit, type ActivityFieldValue, type ActivityId, type ActivityLookaheadSyncInput, type ActivityMoveInput, type ActivityStatus, type ActivityType, type ApplyLookaheadConversionInput, type BackendActivityInput, type BackendCalendarExceptionInput, type BackendCalendarInput, type BackendLinkInput, type BackendScheduleInput, type BackendSectorInput, type BackendShiftInput, type BaselinePoint, type BaselineVersion, type BranchOrderChange, CALENDAR_UNIT, CHANGE_SET_SOURCE_KIND, COLUMN, COMPLETED_PROGRESS, CONFIRMATION_KIND, CONSTRAINT_TYPE, CONSTRAINT_TYPE_TO_LABEL, CONSTRAINT_WARNING_KIND, CREATION_KIND, type Calendar, type CalendarId, type CalendarLike, type CalendarUnit, type CalendarWorktime, type ChangeSet, type ChangeSetSource, type ColumnName, type ConfirmationAlternative, type ConfirmationKind, type ConfirmationRequest, type ConstraintType, type ConstraintWarning, type CoreActivity, type CoreBaselinePoint, type CreationKind, type CriticalPathResult, P6_PROPERTY_CONTRACT as DATA_DATE_PROPERTY_CONTRACT, DATE_GESTURE_KIND, DEFAULT_HOURS_PER_DAY, DISPATCH_ACTION_KIND, DISPATCH_ACTION_KINDS, DISPATCH_LINK_OPERATION_KIND, DISPATCH_TRACK_EVENT, type P6ActivityCalculationInputs as DataDateActivityCalculationInputs, type P6ActivityColumnKey as DataDateActivityColumnKey, type P6ActivityData as DataDateActivityData, type P6ActivityDraftState as DataDateActivityDraftState, type P6ActivityInputPatch as DataDateActivityInputPatch, type P6ActivityState as DataDateActivityState, type P6ActivityType as DataDateActivityType, P6CapabilityError as DataDateCapabilityError, type P6CapabilityErrorCode as DataDateCapabilityErrorCode, type P6DependencyReference as DataDateDependencyReference, type P6DiagnosticProjectIdentity as DataDateDiagnosticProjectIdentity, type P6DiagnosticRelationship as DataDateDiagnosticRelationship, type P6DiagnosticRelationshipType as DataDateDiagnosticRelationshipType, type P6DurationType as DataDateDurationType, type P6EndingActivityOption as DataDateEndingActivityOption, type P6EndingActivityPage as DataDateEndingActivityPage, type P6EndingActivitySearch as DataDateEndingActivitySearch, type P6MappedScheduleOptions as DataDateMappedScheduleOptions, type P6MissingActivityInput as DataDateMissingActivityInput, type P6OutOfSequencePolicy as DataDateOutOfSequencePolicy, type P6ProjectPlannedStartChange as DataDateProjectPlannedStartChange, type P6ProjectState as DataDateProjectState, type P6PropertyContractRow as DataDatePropertyContractRow, type P6PropertyEdgeCases as DataDatePropertyEdgeCases, type P6RawProjectOptions as DataDateRawProjectOptions, type P6RawScheduleOptions as DataDateRawScheduleOptions, type P6RequiredHistoricalField as DataDateRequiredHistoricalField, type P6ResourceAssignment as DataDateResourceAssignment, type P6ScheduleDiagnostic as DataDateScheduleDiagnostic, type P6ScheduleDiagnosticCode as DataDateScheduleDiagnosticCode, type P6ScheduleInput as DataDateScheduleInput, type P6ScheduleReadiness as DataDateScheduleReadiness, type P6ScheduleResult as DataDateScheduleResult, type P6ScheduleRunLog as DataDateScheduleRunLog, type P6ScheduleSettings as DataDateScheduleSettings, type P6ScheduleWarning as DataDateScheduleWarning, type P6SettingsChange as DataDateSettingsChange, type DateGesture, type DateGestureKind, type DateGesturePreview, type DatesBatchVerdict, type DeletedActivitySnapshot, type DeletedLinkSnapshot, type DispatchAction, type DispatchActionKind, type DispatchManyAction, type DispatchManyChangeSetSource, type DispatchManyResult, type DispatchOptions, type DispatchRejectReason, type DispatchResult, type DispatchTrackEvent, EDIT_ALERT_KEY, EDIT_DENIAL_REASON, ENTITY_CHANGE_KIND, type EditAlertKey, type EditDenialReason, type EditResult, type EditableColumnName, type EffectiveGraphAudit, type EntityChange, type ActivityBatchLinkInput as ErgonomicActivityBatchLinkInput, type ExpectedProgressAdapter, FILTER_FIELD, FILTER_LOGIC, FILTER_OPERATOR, FILTER_REJECTION_REASON, FILTER_VALUE_KIND, FLAT_WBS_DEPTH, type FilterCriterion, type FilterCriterionGroup, type FilterCriterionValue, type FilterDateRange, type FilterField, type FilterLogic, type FilterOperator, type FilterRejection, type FilterState, type FilterValueKind, GROUP_ID_PREFIX, GROUP_ID_SEPARATOR, type GroupCriterion, type GroupCriterionInput, type GroupLevelWindow, type GroupState, type GroupStateInput, type ImpactRequestSyncInput, LINK_BATCH_OPERATION_KIND, LINK_CODE, LINK_CODE_TO_TYPE, LINK_REJECTION_REASON, LINK_RELATIONSHIP, LINK_TYPE, LINK_TYPE_CODE, type Link, type LinkBatchOperationKind, type LinkBatchRequest, type LinkBatchVerdict, type LinkCreateRequest, type LinkId, type LinkPatchRequest, type LinkRejection, type LinkRelationship, type LinkType, type LinkTypeCode, type LinkUpdateAction, type LinksBatchOperation, type LoadDiagnostic, type LoadDiagnosticCode, type LookaheadActualIntent, LookaheadActualTransitionError, type LookaheadActualTransitionErrorCode, type LookaheadConversionFormerParent, type LookaheadConversionGroup, type LookaheadConversionInput, type LookaheadConversionMilestoneMove, type LookaheadConversionPlan, type LookaheadConversionResult, type LookaheadDerivedCalendars, type LookaheadDerivedFields, type LookaheadDerivedFieldsResolver, type LookaheadDerivedInput, type LookaheadProgressActualActivityState, type LookaheadProgressActualInput, type LookaheadProgressActualPlan, MINIMUM_GROUP_DEPTH, MINIMUM_GROUP_LEVEL, type MutationContext, NEW_ACTIVITY_DEFAULTS, NOT_STARTED_PROGRESS, ORDER_DIRECTION, ORDER_MODE, type OrderDirection, type OrderMode, type OrderRule, type OrderState, type ParsedInput, type PendingRequest, type PersistableActivityField, type PersistedEntityIdentity, type PersistenceCheckpoint, type PipelineColumnName, type ProjectWorkHours, REJECTION_REASON, ROOT_PARENT_ID, SCHEDULE_CORE_STATUS, SCHEDULE_EFFECT_KIND, SIR_AUTO_REJECT_REASON, STATUS, STATUS_CRITERIA, type ScheduleActivitiesApi, type ScheduleApiNamespaces, type ScheduleAutoScheduleAction, type ScheduleBaselinesApi, type ScheduleCalendarsApi, type ScheduleCellsApi, ScheduleCore, type ScheduleCoreInput, type ScheduleCoreReporter, type ScheduleCoreStatus, type ScheduleCriticalPathApi, type ScheduleP6Api as ScheduleDataDatesApi, type ScheduleDiagnosticsApi, type ScheduleEffect, type ScheduleHistoryApi, type ScheduleImpactRequestsApi, type ScheduleLinksApi, type SchedulePersistenceApi, type ScheduleProjectionApi, type ScheduleSelectionApi, type ScheduleViewApi, type SectorMetadata, type SelectionToggleInput, type StaticActivityDefaults, type StatusCriteria, type TrackingEvent, UNASSIGNED_GROUP_LABEL, UNASSIGNED_VALUE_ID, type UndoOptions, VIEW_ATTRIBUTE_KIND, VISUAL_ROW_KIND, type ViewAttributeAssignmentInput, type ViewAttributeCatalogInput, type ViewAttributeFilterCriterion, type ViewAttributeOrderRule, type ViewAttributeValueInput, type ViewFilterInput, type ViewStateChange, type ViewStatePropChange, type VisualRow, WORK_TIME_DIRECTION, type WbsDepth, type WithProplannerId, type WorkTimeDirection, allowedSecondaryConstraintTypes, appendGroupRowId, buildGroupRowId, checkNoUpdatedLinks, computeExpectedProgress, createLookaheadDerivedFields, createOutbuildP6ScheduleSettings as createOutbuildDataDateScheduleSettings, createSchedule, expectedProgressFromBaseline, formatUtcAsP6WallDate, getActiveBaseline, getUnsavedActivities, isRootParent, isViewAttributeCriterion, isViewAttributeOrderRule, mapP6ScheduleOptions as mapDataDateScheduleOptions, normalizeParentKey, parseFromBackend, parseP6DayAsCalendarStart, parseP6WallDateAsUtc, planLookaheadProgressActuals, prepareLookaheadProgressActuals, resolveExpectedFinishDateSelection, resolveLookaheadActualDateSelection, willRunCriticalPath, yieldToBrowser };

package/dist/index.d.ts

@@ -17,6 +17,20 @@ declare const LINK_TYPE: {
 /** Canonical stored dependency relationship. */
 type LinkType = (typeof LINK_TYPE)[keyof typeof LINK_TYPE];
 
+/** Named normalized activity scheduling constraints. */
+declare const CONSTRAINT_TYPE: {
+    readonly ASAP: "asap";
+    readonly ALAP: "alap";
+    readonly SNET: "snet";
+    readonly SNLT: "snlt";
+    readonly FNET: "fnet";
+    readonly FNLT: "fnlt";
+    readonly MSO: "mso";
+    readonly MFO: "mfo";
+};
+/** Normalized activity scheduling constraint. */
+type ConstraintType = (typeof CONSTRAINT_TYPE)[keyof typeof CONSTRAINT_TYPE];
+
 interface WorkTimeQuery {
     readonly direction: WorkTimeDirection;
     readonly date: Date;
@@ -198,13 +212,10 @@ declare const NOT_STARTED_PROGRESS = 0;
 /** Progress percentage representing a completed activity. */
 declare const COMPLETED_PROGRESS = 100;
 
-declare const CREATION_OVERRIDE_FIELD_LIST: readonly ["name", "description", "type", "startDate", "durationHours", "constraintType", "constraintDate", "calendarId", "assignedDefaultCalendar", "autoScheduling", "progress", "cost", "usedCost", "realCost", "workHours", "realWorkHours", "ponderator", "hasCustomPonderator", "customId", "subcontractId", "responsableIds", "tagIds", "isLookahead"];
-type CreationOverrideField = (typeof CREATION_OVERRIDE_FIELD_LIST)[number];
-type CreationOverrides = Partial<Pick<CoreActivity, CreationOverrideField>>;
-
 /** Discriminators for commands accepted by {@link ScheduleCore.dispatch}. */
 declare const DISPATCH_ACTION_KIND: {
     readonly ACTIVITY_CLIPBOARD_CLEAR: "activity-clipboard-clear";
+    readonly ACTIVITY_CLIPBOARD_IMPORT: "activity-clipboard-import";
     readonly ACTIVITY_COPY: "activity-copy";
     readonly CALENDAR_RECONCILE: "calendar-reconcile";
     readonly ACTIVITY_PASTE_COPIED: "activity-paste-copied";
@@ -722,6 +733,11 @@ type DispatchAction = {
 } | {
     kind: typeof DISPATCH_ACTION_KIND.ACTIVITY_CLIPBOARD_CLEAR;
     eventSource?: string;
+} | {
+    kind: typeof DISPATCH_ACTION_KIND.ACTIVITY_CLIPBOARD_IMPORT;
+    snapshot: ActivityClipboardSnapshot;
+    references?: ActivityClipboardReferences;
+    eventSource?: string;
 } | {
     kind: typeof DISPATCH_ACTION_KIND.ACTIVITY_PASTE_COPIED;
     destination: {
@@ -1578,19 +1594,38 @@ interface EntityChange<T> {
     after: Readonly<T> | null;
 }
 
-/** Named normalized activity scheduling constraints. */
-declare const CONSTRAINT_TYPE: {
-    readonly ASAP: "asap";
-    readonly ALAP: "alap";
-    readonly SNET: "snet";
-    readonly SNLT: "snlt";
-    readonly FNET: "fnet";
-    readonly FNLT: "fnlt";
-    readonly MSO: "mso";
-    readonly MFO: "mfo";
-};
-/** Normalized activity scheduling constraint. */
-type ConstraintType = (typeof CONSTRAINT_TYPE)[keyof typeof CONSTRAINT_TYPE];
+declare const CREATION_OVERRIDE_FIELD_LIST: readonly ["name", "description", "type", "startDate", "durationHours", "constraintType", "constraintDate", "calendarId", "assignedDefaultCalendar", "autoScheduling", "progress", "cost", "usedCost", "realCost", "workHours", "realWorkHours", "ponderator", "hasCustomPonderator", "customId", "subcontractId", "responsableIds", "tagIds", "isLookahead"];
+type CreationOverrideField = (typeof CREATION_OVERRIDE_FIELD_LIST)[number];
+type CreationOverrides = Partial<Pick<CoreActivity, CreationOverrideField>>;
+
+/** One copied activity: its identity in the source schedule plus the fields a paste recreates. */
+interface ActivityClipboardEntry {
+    readonly originalId: ActivityId;
+    readonly originalParentId: ActivityId | typeof ROOT_PARENT_ID;
+    readonly overrides: CreationOverrides;
+}
+/**
+ * Portable snapshot of the activity clipboard.
+ *
+ * `originalId`, `originalParentId` and the link endpoints are only mapping
+ * keys inside the snapshot, so a snapshot exported from one schedule can be
+ * imported into another one.
+ */
+interface ActivityClipboardSnapshot {
+    readonly activities: ReadonlyArray<ActivityClipboardEntry>;
+    readonly links: ReadonlyArray<Readonly<Link>>;
+}
+/**
+ * Consumer-owned reference catalogs of the destination schedule.
+ *
+ * Every provided list filters the copied field on import; an omitted list
+ * leaves that field untouched.
+ */
+interface ActivityClipboardReferences {
+    readonly subcontractIds?: ReadonlyArray<number>;
+    readonly responsableIds?: ReadonlyArray<string>;
+    readonly tagIds?: ReadonlyArray<string>;
+}
 
 declare const SAVE_FIELD_POLICY: {
     readonly TRACKED: "tracked";
@@ -1950,6 +1985,12 @@ interface ScheduleActivitiesApi {
      * @param currentCustomId - Existing value to ignore, or `null`.
      */
     isCustomIdInUse(customId: string, currentCustomId?: string | null): boolean;
+    /**
+     * Reads the activity clipboard as a portable snapshot.
+     *
+     * @returns A defensive copy, or `null` when nothing has been copied.
+     */
+    clipboard(): ActivityClipboardSnapshot | null;
     /**
      * Creates one activity through the canonical dispatch pipeline.
      *
@@ -2071,6 +2112,21 @@ interface ScheduleActivitiesApi {
     duplicate(activityIds: ReadonlyArray<ActivityId>, context?: MutationContext): Promise<DispatchResult>;
     /** @returns The complete result of clearing core-owned clipboard state. */
     clearClipboard(context?: MutationContext): Promise<DispatchResult>;
+    /**
+     * Replaces the activity clipboard with a snapshot exported elsewhere.
+     *
+     * Copied `calendarId` values unknown to this schedule are dropped so the
+     * paste falls back to the schedule default calendar; every list in
+     * `references` filters the matching copied field. Rejects an empty
+     * snapshot (`clipboard_empty`) or one whose links point outside its own
+     * activities (`clipboard_snapshot_invalid`). Never touches history or
+     * persistence tracking.
+     * @param snapshot - Snapshot read through {@link ScheduleActivitiesApi.clipboard}.
+     * @param references - Destination reference catalogs, when known.
+     * @param context - Optional consumer event source.
+     * @returns The complete dispatch result.
+     */
+    importClipboard(snapshot: ActivityClipboardSnapshot, references?: ActivityClipboardReferences, context?: MutationContext): Promise<DispatchResult>;
     /**
      * Synchronizes consumer-owned lookahead metadata into core state.
      *
@@ -2978,6 +3034,15 @@ declare class ScheduleCore {
     getChildrenIds(parentId: ActivityId | typeof ROOT_PARENT_ID): ReadonlyArray<ActivityId>;
     /** @returns A defensive snapshot of selected activity IDs. */
     getSelectedActivityIds(): string[];
+    /**
+     * 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(): ActivityClipboardSnapshot | null;
     /** @returns A defensive snapshot of explicitly hidden activity IDs. */
     getHiddenActivityIds(): string[];
     /** @returns A defensive snapshot of activity IDs not currently hidden. */
@@ -3602,6 +3667,7 @@ declare const REJECTION_REASON: {
     readonly ACTIVITY_IDS_EMPTY: "activity_ids_empty";
     readonly NO_ACTIVITY_SELECTION: "no_activity_selection";
     readonly CLIPBOARD_EMPTY: "clipboard_empty";
+    readonly CLIPBOARD_SNAPSHOT_INVALID: "clipboard_snapshot_invalid";
     readonly ACTIVITY_PASTE_INVARIANT_FAILED: "activity_paste_invariant_failed";
     readonly SOLE_SCHEDULE_ROOT: "sole_schedule_root";
     readonly ANCHOR_SIBLING_CONFLICT: "anchor_sibling_conflict";
@@ -3631,4 +3697,4 @@ declare const DISPATCH_TRACK_EVENT: {
 /** Consumer analytics event name emitted by a schedule mutation. */
 type DispatchTrackEvent = (typeof DISPATCH_TRACK_EVENT)[keyof typeof DISPATCH_TRACK_EVENT];
 
-export { ACTIVITY_BATCH_ACTION_KIND, ACTIVITY_BATCH_MODE, ACTIVITY_DATE_EDGE, ACTIVITY_FIELD, ACTIVITY_PONDERATOR_CRITERION, ACTIVITY_PROGRESS_ORIGIN, ACTIVITY_TYPE, type ActivityBaselineSnapshot, type ActivityBatchAction, type ActivityBatchInput, type ActivityBatchItem, type ActivityBatchItemInput, type ActivityBatchLinkInput$1 as ActivityBatchLinkInput, type ActivityBatchMode, type ActivityBatchParentReference, type ActivityBatchReference, type ActivityBulkEdit, type ActivityCreateInput, type ActivityCreationOverrides, type ActivityCreter, type ActivityDateEdge, type ActivityDateEdit, type ActivityField, type ActivityFieldEdit, type ActivityFieldValue, type ActivityId, type ActivityLookaheadSyncInput, type ActivityMoveInput, type ActivityStatus, type ActivityType, type ApplyLookaheadConversionInput, type BackendActivityInput, type BackendCalendarExceptionInput, type BackendCalendarInput, type BackendLinkInput, type BackendScheduleInput, type BackendSectorInput, type BackendShiftInput, type BaselinePoint, type BaselineVersion, type BranchOrderChange, CALENDAR_UNIT, CHANGE_SET_SOURCE_KIND, COLUMN, COMPLETED_PROGRESS, CONFIRMATION_KIND, CONSTRAINT_TYPE, CONSTRAINT_TYPE_TO_LABEL, CONSTRAINT_WARNING_KIND, CREATION_KIND, type Calendar, type CalendarId, type CalendarLike, type CalendarUnit, type CalendarWorktime, type ChangeSet, type ChangeSetSource, type ColumnName, type ConfirmationAlternative, type ConfirmationKind, type ConfirmationRequest, type ConstraintType, type ConstraintWarning, type CoreActivity, type CoreBaselinePoint, type CreationKind, type CriticalPathResult, P6_PROPERTY_CONTRACT as DATA_DATE_PROPERTY_CONTRACT, DATE_GESTURE_KIND, DEFAULT_HOURS_PER_DAY, DISPATCH_ACTION_KIND, DISPATCH_ACTION_KINDS, DISPATCH_LINK_OPERATION_KIND, DISPATCH_TRACK_EVENT, type P6ActivityCalculationInputs as DataDateActivityCalculationInputs, type P6ActivityColumnKey as DataDateActivityColumnKey, type P6ActivityData as DataDateActivityData, type P6ActivityDraftState as DataDateActivityDraftState, type P6ActivityInputPatch as DataDateActivityInputPatch, type P6ActivityState as DataDateActivityState, type P6ActivityType as DataDateActivityType, P6CapabilityError as DataDateCapabilityError, type P6CapabilityErrorCode as DataDateCapabilityErrorCode, type P6DependencyReference as DataDateDependencyReference, type P6DiagnosticProjectIdentity as DataDateDiagnosticProjectIdentity, type P6DiagnosticRelationship as DataDateDiagnosticRelationship, type P6DiagnosticRelationshipType as DataDateDiagnosticRelationshipType, type P6DurationType as DataDateDurationType, type P6EndingActivityOption as DataDateEndingActivityOption, type P6EndingActivityPage as DataDateEndingActivityPage, type P6EndingActivitySearch as DataDateEndingActivitySearch, type P6MappedScheduleOptions as DataDateMappedScheduleOptions, type P6MissingActivityInput as DataDateMissingActivityInput, type P6OutOfSequencePolicy as DataDateOutOfSequencePolicy, type P6ProjectPlannedStartChange as DataDateProjectPlannedStartChange, type P6ProjectState as DataDateProjectState, type P6PropertyContractRow as DataDatePropertyContractRow, type P6PropertyEdgeCases as DataDatePropertyEdgeCases, type P6RawProjectOptions as DataDateRawProjectOptions, type P6RawScheduleOptions as DataDateRawScheduleOptions, type P6RequiredHistoricalField as DataDateRequiredHistoricalField, type P6ResourceAssignment as DataDateResourceAssignment, type P6ScheduleDiagnostic as DataDateScheduleDiagnostic, type P6ScheduleDiagnosticCode as DataDateScheduleDiagnosticCode, type P6ScheduleInput as DataDateScheduleInput, type P6ScheduleReadiness as DataDateScheduleReadiness, type P6ScheduleResult as DataDateScheduleResult, type P6ScheduleRunLog as DataDateScheduleRunLog, type P6ScheduleSettings as DataDateScheduleSettings, type P6ScheduleWarning as DataDateScheduleWarning, type P6SettingsChange as DataDateSettingsChange, type DateGesture, type DateGestureKind, type DateGesturePreview, type DatesBatchVerdict, type DeletedActivitySnapshot, type DeletedLinkSnapshot, type DispatchAction, type DispatchActionKind, type DispatchManyAction, type DispatchManyChangeSetSource, type DispatchManyResult, type DispatchOptions, type DispatchRejectReason, type DispatchResult, type DispatchTrackEvent, EDIT_ALERT_KEY, EDIT_DENIAL_REASON, ENTITY_CHANGE_KIND, type EditAlertKey, type EditDenialReason, type EditResult, type EditableColumnName, type EffectiveGraphAudit, type EntityChange, type ActivityBatchLinkInput as ErgonomicActivityBatchLinkInput, type ExpectedProgressAdapter, FILTER_FIELD, FILTER_LOGIC, FILTER_OPERATOR, FILTER_REJECTION_REASON, FILTER_VALUE_KIND, FLAT_WBS_DEPTH, type FilterCriterion, type FilterCriterionGroup, type FilterCriterionValue, type FilterDateRange, type FilterField, type FilterLogic, type FilterOperator, type FilterRejection, type FilterState, type FilterValueKind, GROUP_ID_PREFIX, GROUP_ID_SEPARATOR, type GroupCriterion, type GroupCriterionInput, type GroupLevelWindow, type GroupState, type GroupStateInput, type ImpactRequestSyncInput, LINK_BATCH_OPERATION_KIND, LINK_CODE, LINK_CODE_TO_TYPE, LINK_REJECTION_REASON, LINK_RELATIONSHIP, LINK_TYPE, LINK_TYPE_CODE, type Link, type LinkBatchOperationKind, type LinkBatchRequest, type LinkBatchVerdict, type LinkCreateRequest, type LinkId, type LinkPatchRequest, type LinkRejection, type LinkRelationship, type LinkType, type LinkTypeCode, type LinkUpdateAction, type LinksBatchOperation, type LoadDiagnostic, type LoadDiagnosticCode, type LookaheadActualIntent, LookaheadActualTransitionError, type LookaheadActualTransitionErrorCode, type LookaheadConversionFormerParent, type LookaheadConversionGroup, type LookaheadConversionInput, type LookaheadConversionMilestoneMove, type LookaheadConversionPlan, type LookaheadConversionResult, type LookaheadDerivedCalendars, type LookaheadDerivedFields, type LookaheadDerivedFieldsResolver, type LookaheadDerivedInput, type LookaheadProgressActualActivityState, type LookaheadProgressActualInput, type LookaheadProgressActualPlan, MINIMUM_GROUP_DEPTH, MINIMUM_GROUP_LEVEL, type MutationContext, NEW_ACTIVITY_DEFAULTS, NOT_STARTED_PROGRESS, ORDER_DIRECTION, ORDER_MODE, type OrderDirection, type OrderMode, type OrderRule, type OrderState, type ParsedInput, type PendingRequest, type PersistableActivityField, type PersistedEntityIdentity, type PersistenceCheckpoint, type PipelineColumnName, type ProjectWorkHours, REJECTION_REASON, ROOT_PARENT_ID, SCHEDULE_CORE_STATUS, SCHEDULE_EFFECT_KIND, SIR_AUTO_REJECT_REASON, STATUS, STATUS_CRITERIA, type ScheduleActivitiesApi, type ScheduleApiNamespaces, type ScheduleAutoScheduleAction, type ScheduleBaselinesApi, type ScheduleCalendarsApi, type ScheduleCellsApi, ScheduleCore, type ScheduleCoreInput, type ScheduleCoreReporter, type ScheduleCoreStatus, type ScheduleCriticalPathApi, type ScheduleP6Api as ScheduleDataDatesApi, type ScheduleDiagnosticsApi, type ScheduleEffect, type ScheduleHistoryApi, type ScheduleImpactRequestsApi, type ScheduleLinksApi, type SchedulePersistenceApi, type ScheduleProjectionApi, type ScheduleSelectionApi, type ScheduleViewApi, type SectorMetadata, type SelectionToggleInput, type StaticActivityDefaults, type StatusCriteria, type TrackingEvent, UNASSIGNED_GROUP_LABEL, UNASSIGNED_VALUE_ID, type UndoOptions, VIEW_ATTRIBUTE_KIND, VISUAL_ROW_KIND, type ViewAttributeAssignmentInput, type ViewAttributeCatalogInput, type ViewAttributeFilterCriterion, type ViewAttributeOrderRule, type ViewAttributeValueInput, type ViewFilterInput, type ViewStateChange, type ViewStatePropChange, type VisualRow, WORK_TIME_DIRECTION, type WbsDepth, type WithProplannerId, type WorkTimeDirection, allowedSecondaryConstraintTypes, appendGroupRowId, buildGroupRowId, checkNoUpdatedLinks, computeExpectedProgress, createLookaheadDerivedFields, createOutbuildP6ScheduleSettings as createOutbuildDataDateScheduleSettings, createSchedule, expectedProgressFromBaseline, formatUtcAsP6WallDate, getActiveBaseline, getUnsavedActivities, isRootParent, isViewAttributeCriterion, isViewAttributeOrderRule, mapP6ScheduleOptions as mapDataDateScheduleOptions, normalizeParentKey, parseFromBackend, parseP6DayAsCalendarStart, parseP6WallDateAsUtc, planLookaheadProgressActuals, prepareLookaheadProgressActuals, resolveExpectedFinishDateSelection, resolveLookaheadActualDateSelection, willRunCriticalPath, yieldToBrowser };
+export { ACTIVITY_BATCH_ACTION_KIND, ACTIVITY_BATCH_MODE, ACTIVITY_DATE_EDGE, ACTIVITY_FIELD, ACTIVITY_PONDERATOR_CRITERION, ACTIVITY_PROGRESS_ORIGIN, ACTIVITY_TYPE, type ActivityBaselineSnapshot, type ActivityBatchAction, type ActivityBatchInput, type ActivityBatchItem, type ActivityBatchItemInput, type ActivityBatchLinkInput$1 as ActivityBatchLinkInput, type ActivityBatchMode, type ActivityBatchParentReference, type ActivityBatchReference, type ActivityBulkEdit, type ActivityClipboardEntry, type ActivityClipboardReferences, type ActivityClipboardSnapshot, type ActivityCreateInput, type ActivityCreationOverrides, type ActivityCreter, type ActivityDateEdge, type ActivityDateEdit, type ActivityField, type ActivityFieldEdit, type ActivityFieldValue, type ActivityId, type ActivityLookaheadSyncInput, type ActivityMoveInput, type ActivityStatus, type ActivityType, type ApplyLookaheadConversionInput, type BackendActivityInput, type BackendCalendarExceptionInput, type BackendCalendarInput, type BackendLinkInput, type BackendScheduleInput, type BackendSectorInput, type BackendShiftInput, type BaselinePoint, type BaselineVersion, type BranchOrderChange, CALENDAR_UNIT, CHANGE_SET_SOURCE_KIND, COLUMN, COMPLETED_PROGRESS, CONFIRMATION_KIND, CONSTRAINT_TYPE, CONSTRAINT_TYPE_TO_LABEL, CONSTRAINT_WARNING_KIND, CREATION_KIND, type Calendar, type CalendarId, type CalendarLike, type CalendarUnit, type CalendarWorktime, type ChangeSet, type ChangeSetSource, type ColumnName, type ConfirmationAlternative, type ConfirmationKind, type ConfirmationRequest, type ConstraintType, type ConstraintWarning, type CoreActivity, type CoreBaselinePoint, type CreationKind, type CriticalPathResult, P6_PROPERTY_CONTRACT as DATA_DATE_PROPERTY_CONTRACT, DATE_GESTURE_KIND, DEFAULT_HOURS_PER_DAY, DISPATCH_ACTION_KIND, DISPATCH_ACTION_KINDS, DISPATCH_LINK_OPERATION_KIND, DISPATCH_TRACK_EVENT, type P6ActivityCalculationInputs as DataDateActivityCalculationInputs, type P6ActivityColumnKey as DataDateActivityColumnKey, type P6ActivityData as DataDateActivityData, type P6ActivityDraftState as DataDateActivityDraftState, type P6ActivityInputPatch as DataDateActivityInputPatch, type P6ActivityState as DataDateActivityState, type P6ActivityType as DataDateActivityType, P6CapabilityError as DataDateCapabilityError, type P6CapabilityErrorCode as DataDateCapabilityErrorCode, type P6DependencyReference as DataDateDependencyReference, type P6DiagnosticProjectIdentity as DataDateDiagnosticProjectIdentity, type P6DiagnosticRelationship as DataDateDiagnosticRelationship, type P6DiagnosticRelationshipType as DataDateDiagnosticRelationshipType, type P6DurationType as DataDateDurationType, type P6EndingActivityOption as DataDateEndingActivityOption, type P6EndingActivityPage as DataDateEndingActivityPage, type P6EndingActivitySearch as DataDateEndingActivitySearch, type P6MappedScheduleOptions as DataDateMappedScheduleOptions, type P6MissingActivityInput as DataDateMissingActivityInput, type P6OutOfSequencePolicy as DataDateOutOfSequencePolicy, type P6ProjectPlannedStartChange as DataDateProjectPlannedStartChange, type P6ProjectState as DataDateProjectState, type P6PropertyContractRow as DataDatePropertyContractRow, type P6PropertyEdgeCases as DataDatePropertyEdgeCases, type P6RawProjectOptions as DataDateRawProjectOptions, type P6RawScheduleOptions as DataDateRawScheduleOptions, type P6RequiredHistoricalField as DataDateRequiredHistoricalField, type P6ResourceAssignment as DataDateResourceAssignment, type P6ScheduleDiagnostic as DataDateScheduleDiagnostic, type P6ScheduleDiagnosticCode as DataDateScheduleDiagnosticCode, type P6ScheduleInput as DataDateScheduleInput, type P6ScheduleReadiness as DataDateScheduleReadiness, type P6ScheduleResult as DataDateScheduleResult, type P6ScheduleRunLog as DataDateScheduleRunLog, type P6ScheduleSettings as DataDateScheduleSettings, type P6ScheduleWarning as DataDateScheduleWarning, type P6SettingsChange as DataDateSettingsChange, type DateGesture, type DateGestureKind, type DateGesturePreview, type DatesBatchVerdict, type DeletedActivitySnapshot, type DeletedLinkSnapshot, type DispatchAction, type DispatchActionKind, type DispatchManyAction, type DispatchManyChangeSetSource, type DispatchManyResult, type DispatchOptions, type DispatchRejectReason, type DispatchResult, type DispatchTrackEvent, EDIT_ALERT_KEY, EDIT_DENIAL_REASON, ENTITY_CHANGE_KIND, type EditAlertKey, type EditDenialReason, type EditResult, type EditableColumnName, type EffectiveGraphAudit, type EntityChange, type ActivityBatchLinkInput as ErgonomicActivityBatchLinkInput, type ExpectedProgressAdapter, FILTER_FIELD, FILTER_LOGIC, FILTER_OPERATOR, FILTER_REJECTION_REASON, FILTER_VALUE_KIND, FLAT_WBS_DEPTH, type FilterCriterion, type FilterCriterionGroup, type FilterCriterionValue, type FilterDateRange, type FilterField, type FilterLogic, type FilterOperator, type FilterRejection, type FilterState, type FilterValueKind, GROUP_ID_PREFIX, GROUP_ID_SEPARATOR, type GroupCriterion, type GroupCriterionInput, type GroupLevelWindow, type GroupState, type GroupStateInput, type ImpactRequestSyncInput, LINK_BATCH_OPERATION_KIND, LINK_CODE, LINK_CODE_TO_TYPE, LINK_REJECTION_REASON, LINK_RELATIONSHIP, LINK_TYPE, LINK_TYPE_CODE, type Link, type LinkBatchOperationKind, type LinkBatchRequest, type LinkBatchVerdict, type LinkCreateRequest, type LinkId, type LinkPatchRequest, type LinkRejection, type LinkRelationship, type LinkType, type LinkTypeCode, type LinkUpdateAction, type LinksBatchOperation, type LoadDiagnostic, type LoadDiagnosticCode, type LookaheadActualIntent, LookaheadActualTransitionError, type LookaheadActualTransitionErrorCode, type LookaheadConversionFormerParent, type LookaheadConversionGroup, type LookaheadConversionInput, type LookaheadConversionMilestoneMove, type LookaheadConversionPlan, type LookaheadConversionResult, type LookaheadDerivedCalendars, type LookaheadDerivedFields, type LookaheadDerivedFieldsResolver, type LookaheadDerivedInput, type LookaheadProgressActualActivityState, type LookaheadProgressActualInput, type LookaheadProgressActualPlan, MINIMUM_GROUP_DEPTH, MINIMUM_GROUP_LEVEL, type MutationContext, NEW_ACTIVITY_DEFAULTS, NOT_STARTED_PROGRESS, ORDER_DIRECTION, ORDER_MODE, type OrderDirection, type OrderMode, type OrderRule, type OrderState, type ParsedInput, type PendingRequest, type PersistableActivityField, type PersistedEntityIdentity, type PersistenceCheckpoint, type PipelineColumnName, type ProjectWorkHours, REJECTION_REASON, ROOT_PARENT_ID, SCHEDULE_CORE_STATUS, SCHEDULE_EFFECT_KIND, SIR_AUTO_REJECT_REASON, STATUS, STATUS_CRITERIA, type ScheduleActivitiesApi, type ScheduleApiNamespaces, type ScheduleAutoScheduleAction, type ScheduleBaselinesApi, type ScheduleCalendarsApi, type ScheduleCellsApi, ScheduleCore, type ScheduleCoreInput, type ScheduleCoreReporter, type ScheduleCoreStatus, type ScheduleCriticalPathApi, type ScheduleP6Api as ScheduleDataDatesApi, type ScheduleDiagnosticsApi, type ScheduleEffect, type ScheduleHistoryApi, type ScheduleImpactRequestsApi, type ScheduleLinksApi, type SchedulePersistenceApi, type ScheduleProjectionApi, type ScheduleSelectionApi, type ScheduleViewApi, type SectorMetadata, type SelectionToggleInput, type StaticActivityDefaults, type StatusCriteria, type TrackingEvent, UNASSIGNED_GROUP_LABEL, UNASSIGNED_VALUE_ID, type UndoOptions, VIEW_ATTRIBUTE_KIND, VISUAL_ROW_KIND, type ViewAttributeAssignmentInput, type ViewAttributeCatalogInput, type ViewAttributeFilterCriterion, type ViewAttributeOrderRule, type ViewAttributeValueInput, type ViewFilterInput, type ViewStateChange, type ViewStatePropChange, type VisualRow, WORK_TIME_DIRECTION, type WbsDepth, type WithProplannerId, type WorkTimeDirection, allowedSecondaryConstraintTypes, appendGroupRowId, buildGroupRowId, checkNoUpdatedLinks, computeExpectedProgress, createLookaheadDerivedFields, createOutbuildP6ScheduleSettings as createOutbuildDataDateScheduleSettings, createSchedule, expectedProgressFromBaseline, formatUtcAsP6WallDate, getActiveBaseline, getUnsavedActivities, isRootParent, isViewAttributeCriterion, isViewAttributeOrderRule, mapP6ScheduleOptions as mapDataDateScheduleOptions, normalizeParentKey, parseFromBackend, parseP6DayAsCalendarStart, parseP6WallDateAsUtc, planLookaheadProgressActuals, prepareLookaheadProgressActuals, resolveExpectedFinishDateSelection, resolveLookaheadActualDateSelection, willRunCriticalPath, yieldToBrowser };

package/dist/index.js

@@ -340,6 +340,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",
@@ -522,6 +523,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
@@ -604,6 +606,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
@@ -946,6 +954,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",
@@ -11742,6 +11751,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,
@@ -11762,6 +11772,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,
@@ -18379,8 +18390,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: {
@@ -18392,6 +18402,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) {
@@ -18997,6 +19058,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);
   }
@@ -23413,7 +23480,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;
@@ -31169,6 +31236,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();