@outbuild-company/schedule-core 1.14.2 → 1.15.0

package/dist/index.d.cts

@@ -493,6 +493,7 @@ declare const DISPATCH_ACTION_KIND: {
     readonly ACTIVITY_MOVE: "activity-move";
     readonly ACTIVITY_INDENT: "activity-indent";
     readonly ACTIVITY_OUTDENT: "activity-outdent";
+    readonly ACTIVITY_TYPE_SET: "activity-type-set";
     readonly ACTIVITY_SET_PROGRESS: "activity-set-progress";
     readonly ACTIVITY_LOOKAHEAD_CONVERT: "activity-lookahead-convert";
     readonly SELECTION_TOGGLE: "selection-toggle";
@@ -502,6 +503,7 @@ declare const DISPATCH_ACTION_KIND: {
     readonly SORT_SET: "sort-set";
     readonly SIR_SYNC: "sir-sync";
     readonly ACTIVITY_LOOKAHEAD_SYNC: "activity-lookahead-sync";
+    readonly SCHEDULE_AUTO_SCHEDULE: "schedule-auto-schedule";
 };
 /** Discriminator accepted by {@link ScheduleCore.applyActivityBatch}. */
 declare const ACTIVITY_BATCH_ACTION_KIND: "activity-batch";
@@ -685,6 +687,8 @@ type LinksBatchOperation = {
 } | {
     kind: typeof DISPATCH_LINK_OPERATION_KIND.UPDATE;
     linkId: LinkId;
+    source?: ActivityId;
+    target?: ActivityId;
     type?: LinkType;
     /** Replacement lag in working days; dispatch converts it to stored hours. */
     lag?: number;
@@ -784,6 +788,21 @@ interface ActivityBatchAction {
     readonly links: ReadonlyArray<ActivityBatchLinkInput$1>;
     readonly eventSource?: string;
 }
+/** In-place dependency update preserving the existing link identity. */
+interface LinkUpdateAction {
+    readonly kind: typeof DISPATCH_ACTION_KIND.LINK_UPDATE;
+    readonly linkId: LinkId;
+    readonly source?: ActivityId;
+    readonly target?: ActivityId;
+    readonly type?: LinkType;
+    /** Replacement lag in working days; dispatch converts it to stored hours. */
+    readonly lag?: number;
+}
+/** Explicit request to run canonical schedule finalization. */
+interface ScheduleAutoScheduleAction {
+    readonly kind: typeof DISPATCH_ACTION_KIND.SCHEDULE_AUTO_SCHEDULE;
+    readonly activityId?: ActivityId;
+}
 /**
  * Complete union of public commands accepted by {@link ScheduleCore.dispatch}.
  *
@@ -846,13 +865,7 @@ type DispatchAction = {
     /** Dependency lag in working days; omitted lag defaults to zero. */
     lag?: number;
     linkId?: LinkId;
-} | {
-    kind: typeof DISPATCH_ACTION_KIND.LINK_UPDATE;
-    linkId: LinkId;
-    type?: LinkType;
-    /** Replacement lag in working days; dispatch converts it to stored hours. */
-    lag?: number;
-} | {
+} | LinkUpdateAction | {
     kind: typeof DISPATCH_ACTION_KIND.LINK_DELETE;
     linkId: LinkId;
 } | {
@@ -885,6 +898,10 @@ type DispatchAction = {
     kind: typeof DISPATCH_ACTION_KIND.ACTIVITY_OUTDENT;
     activityIds: ReadonlyArray<ActivityId>;
     eventSource?: string;
+} | {
+    kind: typeof DISPATCH_ACTION_KIND.ACTIVITY_TYPE_SET;
+    activityId: ActivityId;
+    type: ActivityType;
 } | {
     kind: typeof DISPATCH_ACTION_KIND.ACTIVITY_SET_PROGRESS;
     activityId: ActivityId;
@@ -931,7 +948,7 @@ type DispatchAction = {
     persistedProgress?: number;
     acknowledgePersistedLookahead?: boolean;
     eventSource?: string;
-};
+} | ScheduleAutoScheduleAction;
 /**
  * Supported creation fields with duration expressed in working days.
  *
@@ -940,7 +957,9 @@ type DispatchAction = {
 type ActivityCreationOverrides = Omit<CreationOverrides, 'durationHours'> & {
     readonly durationDays?: number;
 };
-type InternalDispatchAction = DispatchAction | ActivityBatchAction;
+/** One ordered input accepted by {@link ScheduleCore.dispatchMany}. */
+type DispatchManyAction = DispatchAction | ActivityBatchAction;
+type InternalDispatchAction = DispatchManyAction;
 /** Per-operation derived-work controls; both default to `false`. */
 interface DispatchOptions {
     /** Skips autoscheduling for this operation when `true`. */
@@ -966,6 +985,13 @@ type DispatchResult = {
     reason: string;
     alertKey?: string | undefined;
 };
+/** Ordered per-command results plus the single deferred finalization payload. */
+interface DispatchManyResult {
+    readonly results: readonly DispatchResult[];
+    readonly changeSet: ChangeSet | null;
+    /** Whether this batch's deferred autoschedule pass actually ran. */
+    readonly autoScheduled: boolean;
+}
 /** Accepted conversion result always carries the snapshots planned in-queue. */
 type LookaheadConversionResult = (Extract<DispatchResult, {
     ok: true;
@@ -1042,15 +1068,21 @@ interface ViewStateChange {
     readonly checked?: ViewStatePropChange;
     readonly visible?: ViewStatePropChange;
 }
-/** Lifecycle sources used when no public dispatch command initiated a change set. */
+/** Aggregate and lifecycle change-set source kinds. */
 declare const CHANGE_SET_SOURCE_KIND: {
+    readonly DISPATCH_MANY: "dispatch-many";
     readonly INIT: "init";
     readonly UNDO: "undo";
     readonly REDO: "redo";
 };
+/** Truthful source for one partial ordered public dispatch batch. */
+interface DispatchManyChangeSetSource {
+    readonly kind: typeof CHANGE_SET_SOURCE_KIND.DISPATCH_MANY;
+    readonly actions: readonly DispatchManyAction[];
+}
 /** Public command, activity batch, or lifecycle operation that produced changes. */
-type ChangeSetSource = InternalDispatchAction | {
-    kind: (typeof CHANGE_SET_SOURCE_KIND)[keyof typeof CHANGE_SET_SOURCE_KIND];
+type ChangeSetSource = InternalDispatchAction | DispatchManyChangeSetSource | {
+    kind: typeof CHANGE_SET_SOURCE_KIND.INIT | typeof CHANGE_SET_SOURCE_KIND.UNDO | typeof CHANGE_SET_SOURCE_KIND.REDO;
 };
 /**
  * Complete ordered projection payload produced by an accepted operation.
@@ -1059,7 +1091,7 @@ type ChangeSetSource = InternalDispatchAction | {
  * set updates external projection only; persistence remains consumer-owned.
  */
 interface ChangeSet {
-    /** Command or lifecycle operation that produced the payload. */
+    /** Command, ordered dispatch batch, or lifecycle operation that produced it. */
     source: ChangeSetSource;
     /** Activity create, update, and delete records. */
     activities: ReadonlyArray<EntityChange<CoreActivity>>;
@@ -1270,6 +1302,8 @@ interface LinkCreateRequest {
 }
 /** Optional dependency fields to replace. */
 interface LinkPatchRequest {
+    readonly sourceId?: ActivityId;
+    readonly targetId?: ActivityId;
     readonly relationship?: LinkRelationship;
     /** Replacement lag in working days. */
     readonly lagDays?: number;
@@ -1288,6 +1322,8 @@ type LinkBatchRequest = ({
 } & LinkCreateRequest) | {
     readonly kind: typeof LINK_BATCH_OPERATION_KIND.UPDATE;
     readonly linkId: LinkId;
+    readonly sourceId?: ActivityId;
+    readonly targetId?: ActivityId;
     readonly relationship?: LinkRelationship;
     readonly lagDays?: number;
 } | {
@@ -1459,6 +1495,8 @@ interface ScheduleActivitiesApi {
      * @returns The complete dispatch result.
      */
     setProgress(activityId: ActivityId, progress: typeof COMPLETED_PROGRESS | typeof NOT_STARTED_PROGRESS, context?: MutationContext): Promise<DispatchResult>;
+    /** Sets the canonical activity shape when compatible with its hierarchy. */
+    setType(activityId: ActivityId, type: ActivityType, options?: DispatchOptions): Promise<DispatchResult>;
     /** @returns The complete result of copying the current selection to core-owned clipboard state. */
     copy(context?: MutationContext): Promise<DispatchResult>;
     /**
@@ -1482,6 +1520,8 @@ interface ScheduleActivitiesApi {
      * @returns The complete dispatch result.
      */
     lookaheadSync(input: ActivityLookaheadSyncInput): Promise<DispatchResult>;
+    /** Runs canonical autoscheduling for one activity or the whole schedule. */
+    autoSchedule(activityId?: ActivityId, options?: DispatchOptions): Promise<DispatchResult>;
     /**
      * Creates a read-only date prediction bound to the current schedule revision.
      *
@@ -2254,6 +2294,7 @@ declare class ScheduleCore {
      * @returns A complete consumer projection change set.
      */
     createProjectionChangeSetFrom(source: ScheduleCore): ChangeSet;
+    private _snapshotProjection;
     /** @returns Deleted persisted activity identities since the last save. */
     getDeletedActivitiesSinceLastSave(): ReadonlyArray<Readonly<DeletedActivitySnapshot>>;
     /** @returns Deleted persisted link identities since the last save. */
@@ -2272,6 +2313,12 @@ declare class ScheduleCore {
      * verdicts, effects, tracking events, and warnings when present.
      */
     dispatch(action: DispatchAction, options?: DispatchOptions): Promise<DispatchResult>;
+    /**
+     * Applies commands in order and runs deferred scheduling finalization once.
+     *
+     * Rejected commands do not roll back earlier accepted commands.
+     */
+    dispatchMany(actions: readonly DispatchManyAction[], options?: DispatchOptions): Promise<DispatchManyResult>;
     /**
      * Serializes and applies an activity creation batch.
      *
@@ -2286,6 +2333,8 @@ declare class ScheduleCore {
     /** Applies one revision-guarded conversion through the serialized dispatcher. */
     applyLookaheadConversion(input: ApplyLookaheadConversionInput): Promise<LookaheadConversionResult>;
     private _dispatchInner;
+    private _dispatchManyInner;
+    private _aggregateDispatchManyChangeSets;
     private _runDispatch;
     /**
      * Queues critical-path calculation for the current revision.
@@ -2570,4 +2619,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, 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 ConstraintType, type ConstraintWarning, type CoreActivity, type CoreBaselinePoint, type CreationKind, type CriticalPathResult, DATE_GESTURE_KIND, DEFAULT_HOURS_PER_DAY, DISPATCH_ACTION_KIND, DISPATCH_ACTION_KINDS, DISPATCH_LINK_OPERATION_KIND, DISPATCH_TRACK_EVENT, type DateGesture, type DateGestureKind, type DateGesturePreview, type DatesBatchVerdict, type DeletedActivitySnapshot, type DeletedLinkSnapshot, type DispatchAction, type DispatchActionKind, 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, type FilterCriterion, type FilterCriterionValue, type FilterDateRange, type FilterField, type FilterLogic, type FilterOperator, type FilterRejection, type FilterState, type FilterValueKind, 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 LinksBatchOperation, type LoadDiagnostic, type LoadDiagnosticCode, type LookaheadConversionFormerParent, type LookaheadConversionGroup, type LookaheadConversionInput, type LookaheadConversionMilestoneMove, type LookaheadConversionPlan, type LookaheadConversionResult, type MutationContext, NEW_ACTIVITY_DEFAULTS, NOT_STARTED_PROGRESS, ORDER_DIRECTION, type OrderDirection, 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 ScheduleBaselinesApi, type ScheduleCalendarsApi, ScheduleCore, type ScheduleCoreInput, type ScheduleCoreReporter, type ScheduleCoreStatus, type ScheduleCriticalPathApi, 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, type UndoOptions, type ViewFilterInput, type ViewStateChange, type ViewStatePropChange, WORK_TIME_DIRECTION, type WithProplannerId, type WorkTimeDirection, checkNoUpdatedLinks, computeExpectedProgress, createSchedule, expectedProgressFromBaseline, getActiveBaseline, getUnsavedActivities, isRootParent, normalizeParentKey, parseFromBackend, 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 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, 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 ConstraintType, type ConstraintWarning, type CoreActivity, type CoreBaselinePoint, type CreationKind, type CriticalPathResult, DATE_GESTURE_KIND, DEFAULT_HOURS_PER_DAY, DISPATCH_ACTION_KIND, DISPATCH_ACTION_KINDS, DISPATCH_LINK_OPERATION_KIND, DISPATCH_TRACK_EVENT, 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, type FilterCriterion, type FilterCriterionValue, type FilterDateRange, type FilterField, type FilterLogic, type FilterOperator, type FilterRejection, type FilterState, type FilterValueKind, 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 LookaheadConversionFormerParent, type LookaheadConversionGroup, type LookaheadConversionInput, type LookaheadConversionMilestoneMove, type LookaheadConversionPlan, type LookaheadConversionResult, type MutationContext, NEW_ACTIVITY_DEFAULTS, NOT_STARTED_PROGRESS, ORDER_DIRECTION, type OrderDirection, 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, ScheduleCore, type ScheduleCoreInput, type ScheduleCoreReporter, type ScheduleCoreStatus, type ScheduleCriticalPathApi, 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, type UndoOptions, type ViewFilterInput, type ViewStateChange, type ViewStatePropChange, WORK_TIME_DIRECTION, type WithProplannerId, type WorkTimeDirection, checkNoUpdatedLinks, computeExpectedProgress, createSchedule, expectedProgressFromBaseline, getActiveBaseline, getUnsavedActivities, isRootParent, normalizeParentKey, parseFromBackend, willRunCriticalPath, yieldToBrowser };

package/dist/index.d.ts

@@ -493,6 +493,7 @@ declare const DISPATCH_ACTION_KIND: {
     readonly ACTIVITY_MOVE: "activity-move";
     readonly ACTIVITY_INDENT: "activity-indent";
     readonly ACTIVITY_OUTDENT: "activity-outdent";
+    readonly ACTIVITY_TYPE_SET: "activity-type-set";
     readonly ACTIVITY_SET_PROGRESS: "activity-set-progress";
     readonly ACTIVITY_LOOKAHEAD_CONVERT: "activity-lookahead-convert";
     readonly SELECTION_TOGGLE: "selection-toggle";
@@ -502,6 +503,7 @@ declare const DISPATCH_ACTION_KIND: {
     readonly SORT_SET: "sort-set";
     readonly SIR_SYNC: "sir-sync";
     readonly ACTIVITY_LOOKAHEAD_SYNC: "activity-lookahead-sync";
+    readonly SCHEDULE_AUTO_SCHEDULE: "schedule-auto-schedule";
 };
 /** Discriminator accepted by {@link ScheduleCore.applyActivityBatch}. */
 declare const ACTIVITY_BATCH_ACTION_KIND: "activity-batch";
@@ -685,6 +687,8 @@ type LinksBatchOperation = {
 } | {
     kind: typeof DISPATCH_LINK_OPERATION_KIND.UPDATE;
     linkId: LinkId;
+    source?: ActivityId;
+    target?: ActivityId;
     type?: LinkType;
     /** Replacement lag in working days; dispatch converts it to stored hours. */
     lag?: number;
@@ -784,6 +788,21 @@ interface ActivityBatchAction {
     readonly links: ReadonlyArray<ActivityBatchLinkInput$1>;
     readonly eventSource?: string;
 }
+/** In-place dependency update preserving the existing link identity. */
+interface LinkUpdateAction {
+    readonly kind: typeof DISPATCH_ACTION_KIND.LINK_UPDATE;
+    readonly linkId: LinkId;
+    readonly source?: ActivityId;
+    readonly target?: ActivityId;
+    readonly type?: LinkType;
+    /** Replacement lag in working days; dispatch converts it to stored hours. */
+    readonly lag?: number;
+}
+/** Explicit request to run canonical schedule finalization. */
+interface ScheduleAutoScheduleAction {
+    readonly kind: typeof DISPATCH_ACTION_KIND.SCHEDULE_AUTO_SCHEDULE;
+    readonly activityId?: ActivityId;
+}
 /**
  * Complete union of public commands accepted by {@link ScheduleCore.dispatch}.
  *
@@ -846,13 +865,7 @@ type DispatchAction = {
     /** Dependency lag in working days; omitted lag defaults to zero. */
     lag?: number;
     linkId?: LinkId;
-} | {
-    kind: typeof DISPATCH_ACTION_KIND.LINK_UPDATE;
-    linkId: LinkId;
-    type?: LinkType;
-    /** Replacement lag in working days; dispatch converts it to stored hours. */
-    lag?: number;
-} | {
+} | LinkUpdateAction | {
     kind: typeof DISPATCH_ACTION_KIND.LINK_DELETE;
     linkId: LinkId;
 } | {
@@ -885,6 +898,10 @@ type DispatchAction = {
     kind: typeof DISPATCH_ACTION_KIND.ACTIVITY_OUTDENT;
     activityIds: ReadonlyArray<ActivityId>;
     eventSource?: string;
+} | {
+    kind: typeof DISPATCH_ACTION_KIND.ACTIVITY_TYPE_SET;
+    activityId: ActivityId;
+    type: ActivityType;
 } | {
     kind: typeof DISPATCH_ACTION_KIND.ACTIVITY_SET_PROGRESS;
     activityId: ActivityId;
@@ -931,7 +948,7 @@ type DispatchAction = {
     persistedProgress?: number;
     acknowledgePersistedLookahead?: boolean;
     eventSource?: string;
-};
+} | ScheduleAutoScheduleAction;
 /**
  * Supported creation fields with duration expressed in working days.
  *
@@ -940,7 +957,9 @@ type DispatchAction = {
 type ActivityCreationOverrides = Omit<CreationOverrides, 'durationHours'> & {
     readonly durationDays?: number;
 };
-type InternalDispatchAction = DispatchAction | ActivityBatchAction;
+/** One ordered input accepted by {@link ScheduleCore.dispatchMany}. */
+type DispatchManyAction = DispatchAction | ActivityBatchAction;
+type InternalDispatchAction = DispatchManyAction;
 /** Per-operation derived-work controls; both default to `false`. */
 interface DispatchOptions {
     /** Skips autoscheduling for this operation when `true`. */
@@ -966,6 +985,13 @@ type DispatchResult = {
     reason: string;
     alertKey?: string | undefined;
 };
+/** Ordered per-command results plus the single deferred finalization payload. */
+interface DispatchManyResult {
+    readonly results: readonly DispatchResult[];
+    readonly changeSet: ChangeSet | null;
+    /** Whether this batch's deferred autoschedule pass actually ran. */
+    readonly autoScheduled: boolean;
+}
 /** Accepted conversion result always carries the snapshots planned in-queue. */
 type LookaheadConversionResult = (Extract<DispatchResult, {
     ok: true;
@@ -1042,15 +1068,21 @@ interface ViewStateChange {
     readonly checked?: ViewStatePropChange;
     readonly visible?: ViewStatePropChange;
 }
-/** Lifecycle sources used when no public dispatch command initiated a change set. */
+/** Aggregate and lifecycle change-set source kinds. */
 declare const CHANGE_SET_SOURCE_KIND: {
+    readonly DISPATCH_MANY: "dispatch-many";
     readonly INIT: "init";
     readonly UNDO: "undo";
     readonly REDO: "redo";
 };
+/** Truthful source for one partial ordered public dispatch batch. */
+interface DispatchManyChangeSetSource {
+    readonly kind: typeof CHANGE_SET_SOURCE_KIND.DISPATCH_MANY;
+    readonly actions: readonly DispatchManyAction[];
+}
 /** Public command, activity batch, or lifecycle operation that produced changes. */
-type ChangeSetSource = InternalDispatchAction | {
-    kind: (typeof CHANGE_SET_SOURCE_KIND)[keyof typeof CHANGE_SET_SOURCE_KIND];
+type ChangeSetSource = InternalDispatchAction | DispatchManyChangeSetSource | {
+    kind: typeof CHANGE_SET_SOURCE_KIND.INIT | typeof CHANGE_SET_SOURCE_KIND.UNDO | typeof CHANGE_SET_SOURCE_KIND.REDO;
 };
 /**
  * Complete ordered projection payload produced by an accepted operation.
@@ -1059,7 +1091,7 @@ type ChangeSetSource = InternalDispatchAction | {
  * set updates external projection only; persistence remains consumer-owned.
  */
 interface ChangeSet {
-    /** Command or lifecycle operation that produced the payload. */
+    /** Command, ordered dispatch batch, or lifecycle operation that produced it. */
     source: ChangeSetSource;
     /** Activity create, update, and delete records. */
     activities: ReadonlyArray<EntityChange<CoreActivity>>;
@@ -1270,6 +1302,8 @@ interface LinkCreateRequest {
 }
 /** Optional dependency fields to replace. */
 interface LinkPatchRequest {
+    readonly sourceId?: ActivityId;
+    readonly targetId?: ActivityId;
     readonly relationship?: LinkRelationship;
     /** Replacement lag in working days. */
     readonly lagDays?: number;
@@ -1288,6 +1322,8 @@ type LinkBatchRequest = ({
 } & LinkCreateRequest) | {
     readonly kind: typeof LINK_BATCH_OPERATION_KIND.UPDATE;
     readonly linkId: LinkId;
+    readonly sourceId?: ActivityId;
+    readonly targetId?: ActivityId;
     readonly relationship?: LinkRelationship;
     readonly lagDays?: number;
 } | {
@@ -1459,6 +1495,8 @@ interface ScheduleActivitiesApi {
      * @returns The complete dispatch result.
      */
     setProgress(activityId: ActivityId, progress: typeof COMPLETED_PROGRESS | typeof NOT_STARTED_PROGRESS, context?: MutationContext): Promise<DispatchResult>;
+    /** Sets the canonical activity shape when compatible with its hierarchy. */
+    setType(activityId: ActivityId, type: ActivityType, options?: DispatchOptions): Promise<DispatchResult>;
     /** @returns The complete result of copying the current selection to core-owned clipboard state. */
     copy(context?: MutationContext): Promise<DispatchResult>;
     /**
@@ -1482,6 +1520,8 @@ interface ScheduleActivitiesApi {
      * @returns The complete dispatch result.
      */
     lookaheadSync(input: ActivityLookaheadSyncInput): Promise<DispatchResult>;
+    /** Runs canonical autoscheduling for one activity or the whole schedule. */
+    autoSchedule(activityId?: ActivityId, options?: DispatchOptions): Promise<DispatchResult>;
     /**
      * Creates a read-only date prediction bound to the current schedule revision.
      *
@@ -2254,6 +2294,7 @@ declare class ScheduleCore {
      * @returns A complete consumer projection change set.
      */
     createProjectionChangeSetFrom(source: ScheduleCore): ChangeSet;
+    private _snapshotProjection;
     /** @returns Deleted persisted activity identities since the last save. */
     getDeletedActivitiesSinceLastSave(): ReadonlyArray<Readonly<DeletedActivitySnapshot>>;
     /** @returns Deleted persisted link identities since the last save. */
@@ -2272,6 +2313,12 @@ declare class ScheduleCore {
      * verdicts, effects, tracking events, and warnings when present.
      */
     dispatch(action: DispatchAction, options?: DispatchOptions): Promise<DispatchResult>;
+    /**
+     * Applies commands in order and runs deferred scheduling finalization once.
+     *
+     * Rejected commands do not roll back earlier accepted commands.
+     */
+    dispatchMany(actions: readonly DispatchManyAction[], options?: DispatchOptions): Promise<DispatchManyResult>;
     /**
      * Serializes and applies an activity creation batch.
      *
@@ -2286,6 +2333,8 @@ declare class ScheduleCore {
     /** Applies one revision-guarded conversion through the serialized dispatcher. */
     applyLookaheadConversion(input: ApplyLookaheadConversionInput): Promise<LookaheadConversionResult>;
     private _dispatchInner;
+    private _dispatchManyInner;
+    private _aggregateDispatchManyChangeSets;
     private _runDispatch;
     /**
      * Queues critical-path calculation for the current revision.
@@ -2570,4 +2619,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, 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 ConstraintType, type ConstraintWarning, type CoreActivity, type CoreBaselinePoint, type CreationKind, type CriticalPathResult, DATE_GESTURE_KIND, DEFAULT_HOURS_PER_DAY, DISPATCH_ACTION_KIND, DISPATCH_ACTION_KINDS, DISPATCH_LINK_OPERATION_KIND, DISPATCH_TRACK_EVENT, type DateGesture, type DateGestureKind, type DateGesturePreview, type DatesBatchVerdict, type DeletedActivitySnapshot, type DeletedLinkSnapshot, type DispatchAction, type DispatchActionKind, 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, type FilterCriterion, type FilterCriterionValue, type FilterDateRange, type FilterField, type FilterLogic, type FilterOperator, type FilterRejection, type FilterState, type FilterValueKind, 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 LinksBatchOperation, type LoadDiagnostic, type LoadDiagnosticCode, type LookaheadConversionFormerParent, type LookaheadConversionGroup, type LookaheadConversionInput, type LookaheadConversionMilestoneMove, type LookaheadConversionPlan, type LookaheadConversionResult, type MutationContext, NEW_ACTIVITY_DEFAULTS, NOT_STARTED_PROGRESS, ORDER_DIRECTION, type OrderDirection, 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 ScheduleBaselinesApi, type ScheduleCalendarsApi, ScheduleCore, type ScheduleCoreInput, type ScheduleCoreReporter, type ScheduleCoreStatus, type ScheduleCriticalPathApi, 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, type UndoOptions, type ViewFilterInput, type ViewStateChange, type ViewStatePropChange, WORK_TIME_DIRECTION, type WithProplannerId, type WorkTimeDirection, checkNoUpdatedLinks, computeExpectedProgress, createSchedule, expectedProgressFromBaseline, getActiveBaseline, getUnsavedActivities, isRootParent, normalizeParentKey, parseFromBackend, 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 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, 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 ConstraintType, type ConstraintWarning, type CoreActivity, type CoreBaselinePoint, type CreationKind, type CriticalPathResult, DATE_GESTURE_KIND, DEFAULT_HOURS_PER_DAY, DISPATCH_ACTION_KIND, DISPATCH_ACTION_KINDS, DISPATCH_LINK_OPERATION_KIND, DISPATCH_TRACK_EVENT, 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, type FilterCriterion, type FilterCriterionValue, type FilterDateRange, type FilterField, type FilterLogic, type FilterOperator, type FilterRejection, type FilterState, type FilterValueKind, 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 LookaheadConversionFormerParent, type LookaheadConversionGroup, type LookaheadConversionInput, type LookaheadConversionMilestoneMove, type LookaheadConversionPlan, type LookaheadConversionResult, type MutationContext, NEW_ACTIVITY_DEFAULTS, NOT_STARTED_PROGRESS, ORDER_DIRECTION, type OrderDirection, 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, ScheduleCore, type ScheduleCoreInput, type ScheduleCoreReporter, type ScheduleCoreStatus, type ScheduleCriticalPathApi, 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, type UndoOptions, type ViewFilterInput, type ViewStateChange, type ViewStatePropChange, WORK_TIME_DIRECTION, type WithProplannerId, type WorkTimeDirection, checkNoUpdatedLinks, computeExpectedProgress, createSchedule, expectedProgressFromBaseline, getActiveBaseline, getUnsavedActivities, isRootParent, normalizeParentKey, parseFromBackend, willRunCriticalPath, yieldToBrowser };