@outbuild-company/schedule-core 1.17.2 → 1.19.0

package/dist/index.cjs

@@ -291,6 +291,7 @@ var READ_ONLY = {
   DURATION_BASE: "duration_base",
   COST_BASE: "cost_base",
   WORK_BASE: "work_base",
+  BASELINE_VARIANCE: "baseline_variance",
   CALENDAR_DURATION: "calendarDuration",
   IS_CRITICAL: "is_critical",
   EARLY_START: "earlyStart",
@@ -353,6 +354,7 @@ var DISPATCH_ACTION_KIND = {
   SORT_SET: "sort-set",
   VIEW_ATTRIBUTES_SET: "view-attributes-set",
   GROUP_SET: "group-set",
+  WBS_DEPTH_SET: "wbs-depth-set",
   SIR_SYNC: "sir-sync",
   ACTIVITY_LOOKAHEAD_SYNC: "activity-lookahead-sync",
   SCHEDULE_AUTO_SCHEDULE: "schedule-auto-schedule"
@@ -687,6 +689,12 @@ function createScheduleNamespaces(engine) {
         kind: DISPATCH_ACTION_KIND.GROUP_SET,
         group
       }),
+      wbsDepth: () => engine.getWbsDepth(),
+      setWbsDepth: (wbsDepth, context = {}) => engine.dispatch({
+        ...context,
+        kind: DISPATCH_ACTION_KIND.WBS_DEPTH_SET,
+        wbsDepth
+      }),
       setVisibility: (activityIds, context = {}) => engine.dispatch({
         ...context,
         kind: DISPATCH_ACTION_KIND.VISIBILITY_SET,
@@ -1044,6 +1052,7 @@ var FILTER_FIELD = {
   TOTAL_SLACK_DAYS: "totalSlackDays",
   EXPECTED_PROGRESS_BASELINE: "expectedProgressBaseline",
   BASELINE_DURATION_DAYS: "baselineDurationDays",
+  BASELINE_VARIANCE_DAYS: "baselineVarianceDays",
   BASELINE_COST: "baselineCost",
   BASELINE_WORK_HOURS: "baselineWorkHours",
   EXPECTED_PROGRESS: "expectedProgress",
@@ -1211,6 +1220,10 @@ var FIELD_REGISTRY = {
     valueKind: FILTER_VALUE_KIND.NUMBER,
     extract: (activity) => activity.baselineSnapshot?.durationDays ?? null
   },
+  [FILTER_FIELD.BASELINE_VARIANCE_DAYS]: {
+    valueKind: FILTER_VALUE_KIND.NUMBER,
+    extract: (activity) => activity.baselineVarianceDays
+  },
   [FILTER_FIELD.BASELINE_COST]: {
     valueKind: FILTER_VALUE_KIND.NUMBER,
     extract: (activity) => activity.baselineSnapshot?.cost ?? null
@@ -1301,6 +1314,7 @@ var GROUP_ID_SEPARATOR = ":";
 var UNASSIGNED_GROUP_LABEL = "Unassigned";
 var MINIMUM_GROUP_DEPTH = 1;
 var MINIMUM_GROUP_LEVEL = 1;
+var FLAT_WBS_DEPTH = 0;
 function buildGroupRowId(attributeKey, valueId) {
   return `${GROUP_ID_PREFIX}${GROUP_ID_SEPARATOR}${attributeKey}${GROUP_ID_SEPARATOR}${valueId}`;
 }
@@ -2278,6 +2292,17 @@ function dispatchGroupSet(action, deps) {
   adapter.setGroup(group);
   return { ok: true, changes: emptyViewChanges(action) };
 }
+function dispatchWbsDepthSet(action, deps) {
+  const { adapter } = deps;
+  const { wbsDepth } = action;
+  if (wbsDepth !== null) {
+    if (!isFiniteInteger(wbsDepth) || wbsDepth < FLAT_WBS_DEPTH) {
+      return { ok: false, reason: FILTER_REJECTION_REASON.INVALID_VALUE };
+    }
+  }
+  adapter.setWbsDepth(wbsDepth);
+  return { ok: true, changes: emptyViewChanges(action) };
+}
 
 // src/shared/assert-never.ts
 function assertNever(value, message) {
@@ -2356,7 +2381,8 @@ var ACTIVITY_PROPERTY = {
   CUSTOM_ID: "customId",
   NEW_ACTIVITIES_ARRAY: "newActivityIds",
   HAS_NEW_ACTIVITIES: "hasNewActivities",
-  CALENDAR_DURATION: "calendarDuration"};
+  CALENDAR_DURATION: "calendarDuration",
+  BASELINE_VARIANCE_DAYS: "baselineVarianceDays"};
 var LINK_PROPERTY = {
   SOURCE: "source",
   TARGET: "target",
@@ -6288,12 +6314,16 @@ function mergeCorrelativeShiftIntoDiff(diff, correlativeBefore, activityId, live
     after: liveActivity.correlativeId
   };
 }
+var DERIVED_DISPLAY_FIELDS = [
+  ACTIVITY_PROPERTY.CALENDAR_DURATION,
+  ACTIVITY_PROPERTY.BASELINE_VARIANCE_DAYS
+];
 function diffActivity(before, after) {
   const fields = {};
   const beforeRec = before ?? {};
   const afterRec = after;
   const keys = /* @__PURE__ */ new Set([...Object.keys(beforeRec), ...Object.keys(afterRec)]);
-  keys.delete(ACTIVITY_PROPERTY.CALENDAR_DURATION);
+  for (const derived of DERIVED_DISPLAY_FIELDS) keys.delete(derived);
   for (const k of keys) {
     if (Object.hasOwn(beforeRec, k) !== Object.hasOwn(afterRec, k) || !fieldValueEqual(beforeRec[k], afterRec[k])) {
       fields[k] = {
@@ -6543,6 +6573,43 @@ function applyStatusPass(state, criteria) {
   return changed;
 }
 
+// src/propagations/shared/get-visible-baseline.ts
+function getVisibleBaseline(activity) {
+  const points = activity?.baselinePoints;
+  if (!Array.isArray(points) || points.length === 0) return null;
+  return points.find((point) => point.isVisibleVersion) ?? null;
+}
+
+// src/columns/baseline-variance/compute.ts
+var VARIANCE_DECIMAL_SCALE = 100;
+var roundToVariancePrecision = (days) => Math.round(days * VARIANCE_DECIMAL_SCALE) / VARIANCE_DECIMAL_SCALE;
+function computeBaselineVarianceDays(activity, calendars, hoursPerDay) {
+  if (hoursPerDay <= 0) return null;
+  const baselineEnd = getVisibleBaseline(activity)?.endDate;
+  const activityEnd = activity.endDate;
+  if (!baselineEnd || !activityEnd) return null;
+  const finishesLate = activityEnd.getTime() > baselineEnd.getTime();
+  const finishesEarly = baselineEnd.getTime() > activityEnd.getTime();
+  if (!finishesLate && !finishesEarly) return 0;
+  const durationHours = calendars.calculateDuration({
+    startDate: finishesLate ? baselineEnd : activityEnd,
+    endDate: finishesLate ? activityEnd : baselineEnd,
+    task: activity
+  });
+  const magnitude = roundToVariancePrecision(durationHours / hoursPerDay);
+  return finishesLate ? magnitude : -magnitude;
+}
+function applyBaselineVariancePass(state, hoursPerDay) {
+  const changed = [];
+  state.forEachActivity((activity, id) => {
+    const variance = computeBaselineVarianceDays(activity, state, hoursPerDay);
+    if (activity.baselineVarianceDays === variance) return;
+    activity.baselineVarianceDays = variance;
+    changed.push(String(id));
+  });
+  return changed;
+}
+
 // src/critical-path/legacy/shims/moment.js
 function moment(input) {
   const d = input instanceof Date ? new Date(input.getTime()) : input && typeof input === "object" && typeof input.valueOf === "function" ? new Date(input.valueOf()) : new Date(input);
@@ -11167,6 +11234,7 @@ var NON_SCHEDULING_KINDS = /* @__PURE__ */ new Set([
   DISPATCH_ACTION_KIND.SORT_SET,
   DISPATCH_ACTION_KIND.VIEW_ATTRIBUTES_SET,
   DISPATCH_ACTION_KIND.GROUP_SET,
+  DISPATCH_ACTION_KIND.WBS_DEPTH_SET,
   DISPATCH_ACTION_KIND.SIR_SYNC,
   DISPATCH_ACTION_KIND.ACTIVITY_LOOKAHEAD_SYNC,
   DISPATCH_ACTION_KIND.PERSISTENCE_ACKNOWLEDGE,
@@ -11183,7 +11251,8 @@ var PURE_VIEW_STATE_KINDS = /* @__PURE__ */ new Set([
   DISPATCH_ACTION_KIND.FILTER_SET,
   DISPATCH_ACTION_KIND.SORT_SET,
   DISPATCH_ACTION_KIND.VIEW_ATTRIBUTES_SET,
-  DISPATCH_ACTION_KIND.GROUP_SET
+  DISPATCH_ACTION_KIND.GROUP_SET,
+  DISPATCH_ACTION_KIND.WBS_DEPTH_SET
 ]);
 function reappliesViewState(action) {
   return !PURE_VIEW_STATE_KINDS.has(action.kind);
@@ -11267,6 +11336,7 @@ var DERIVED_PASS = {
   REAL_WORK: "real-work",
   EXPECTED_PROGRESS: "expected-progress",
   REAL_COST: "real-cost",
+  BASELINE_VARIANCE: "baseline-variance",
   CRITICAL_PATH: "critical-path"
 };
 function resolveDerivedPasses(action, autoSchedule, options) {
@@ -11284,6 +11354,9 @@ function resolveDerivedPasses(action, autoSchedule, options) {
   if (runsLoadRecomputes && resolveRunRealCost(action)) {
     passes.add(DERIVED_PASS.REAL_COST);
   }
+  if (dispatchChangesSchedulingState(action)) {
+    passes.add(DERIVED_PASS.BASELINE_VARIANCE);
+  }
   const runsCriticalPath = runsLoadRecomputes && resolveRunCriticalPath(action) && !options.skipCriticalPath;
   if (runsCriticalPath) passes.add(DERIVED_PASS.CRITICAL_PATH);
   return passes;
@@ -11946,6 +12019,9 @@ async function runDerivedRecomputes(deps, passes, now) {
   if (passes.has(DERIVED_PASS.REAL_COST)) {
     emitRealCost(deps.adapter);
   }
+  if (passes.has(DERIVED_PASS.BASELINE_VARIANCE)) {
+    applyBaselineVariancePass(deps.adapter, deps.sector.hoursPerDay);
+  }
   if (passes.has(DERIVED_PASS.CRITICAL_PATH)) {
     await applyCriticalPath(deps.adapter, deps.sector.hoursPerDay);
   }
@@ -12893,6 +12969,7 @@ var NEW_ACTIVITY_DEFAULTS = Object.freeze({
   tagIds: [],
   baselinePoints: [],
   baselineSnapshot: null,
+  baselineVarianceDays: null,
   recursiveDurationHours: 0,
   isCritical: false,
   freeSlackHours: null,
@@ -16624,6 +16701,7 @@ async function dispatchBaselineApply(action, deps) {
     deps.reporter,
     deps.defaultBaseCalendarId ?? null
   );
+  applyBaselineVariancePass(deps.adapter, deps.sector.hoursPerDay);
   if (activeBaselineSignature(deps) !== activeBaselineBefore) {
     recomputeBaselineWeightedFields(
       deps,
@@ -17064,6 +17142,12 @@ async function performDispatch(action, options, deps) {
       hoursPerDay: deps.sector.hoursPerDay
     });
   }
+  if (action.kind === DISPATCH_ACTION_KIND.WBS_DEPTH_SET) {
+    return dispatchWbsDepthSet(action, {
+      adapter: deps.adapter,
+      hoursPerDay: deps.sector.hoursPerDay
+    });
+  }
   if (action.kind === DISPATCH_ACTION_KIND.SIR_SYNC) {
     return dispatchSirSync(action, deps);
   }
@@ -20203,35 +20287,95 @@ function sortedChildNodes(node, direction) {
   if (direction === ORDER_DIRECTION.DESCENDING) children.reverse();
   return children;
 }
-function emitWbsOrderedActivities(memberActivities, activitiesInVisualOrder, parentOf, rows) {
-  const members = new Set(
+var FIRST_WBS_LEVEL = 1;
+var WHOLE_WBS = Number.POSITIVE_INFINITY;
+function activityRow(activity) {
+  return {
+    kind: VISUAL_ROW_KIND.ACTIVITY,
+    activityId: String(activity.id)
+  };
+}
+function buildWbsTree(included, activitiesInVisualOrder, parentOf) {
+  const roots = [];
+  const childrenOf = /* @__PURE__ */ new Map();
+  for (const activity of activitiesInVisualOrder) {
+    if (!included.has(String(activity.id))) continue;
+    const parentId = parentOf(activity.id);
+    const parentKey = parentId === null ? null : String(parentId);
+    if (parentKey === null || !included.has(parentKey)) {
+      roots.push(activity);
+      continue;
+    }
+    const siblings = childrenOf.get(parentKey);
+    if (siblings === void 0) childrenOf.set(parentKey, [activity]);
+    else siblings.push(activity);
+  }
+  return { roots, childrenOf };
+}
+function emitWbsRows(included, input) {
+  const { roots, childrenOf } = buildWbsTree(
+    included,
+    input.activitiesInVisualOrder,
+    input.parentOf
+  );
+  const cap = input.wbsDepth ?? WHOLE_WBS;
+  const childrenOfActivity = (activity) => childrenOf.get(String(activity.id)) ?? [];
+  const foldToActivities = (siblings) => {
+    const folded = [];
+    const walk = (nodes) => {
+      for (const node of nodes) {
+        const children = childrenOfActivity(node);
+        if (children.length === 0) folded.push(node);
+        else walk(children);
+      }
+    };
+    walk(siblings);
+    return folded;
+  };
+  const emit = (siblings, level) => {
+    if (level > cap) {
+      const folded = foldToActivities(siblings);
+      const ordered = input.comparator === null ? folded : sortSiblingsInOrderMode(
+        folded,
+        input.comparator,
+        input.orderMode,
+        () => false
+      );
+      for (const activity of ordered) input.rows.push(activityRow(activity));
+      return;
+    }
+    for (const activity of siblings) {
+      input.rows.push(activityRow(activity));
+      const children = childrenOfActivity(activity);
+      if (children.length > 0) emit(children, level + 1);
+    }
+  };
+  emit(roots, FIRST_WBS_LEVEL);
+}
+function emitWbsOrderedActivities(memberActivities, input) {
+  const included = new Set(
     memberActivities.map((activity) => String(activity.id))
   );
-  const included = new Set(members);
-  for (const memberId of members) {
-    let ancestorId = parentOf(memberId);
+  for (const member of memberActivities) {
+    let ancestorId = input.parentOf(member.id);
     while (ancestorId !== null) {
       included.add(String(ancestorId));
-      ancestorId = parentOf(ancestorId);
+      ancestorId = input.parentOf(ancestorId);
     }
   }
-  for (const activity of activitiesInVisualOrder) {
-    if (!included.has(String(activity.id))) continue;
-    rows.push({
-      kind: VISUAL_ROW_KIND.ACTIVITY,
-      activityId: String(activity.id)
-    });
-  }
+  emitWbsRows(included, input);
 }
 function emitActivities(node, context) {
   const { rows } = context;
   if (context.group.includeWbs) {
-    emitWbsOrderedActivities(
-      node.activities,
-      context.activitiesInVisualOrder,
-      context.parentOf,
+    emitWbsOrderedActivities(node.activities, {
+      activitiesInVisualOrder: context.activitiesInVisualOrder,
+      parentOf: context.parentOf,
+      wbsDepth: context.wbsDepth,
+      comparator: context.comparator,
+      orderMode: context.orderMode,
       rows
-    );
+    });
     return;
   }
   for (const activity of sortSiblingsInOrderMode(
@@ -20282,10 +20426,20 @@ function projectVisualRows(input) {
     (activity) => input.isVisible(activity.id)
   );
   if (input.group === null || input.catalog === null) {
-    return visibleActivities.map((activity) => ({
-      kind: VISUAL_ROW_KIND.ACTIVITY,
-      activityId: String(activity.id)
-    }));
+    if (input.wbsDepth === null) return visibleActivities.map(activityRow);
+    const rows2 = [];
+    emitWbsRows(
+      new Set(visibleActivities.map((activity) => String(activity.id))),
+      {
+        activitiesInVisualOrder: visibleActivities,
+        parentOf: input.parentOf,
+        wbsDepth: input.wbsDepth,
+        comparator: input.comparator,
+        orderMode: input.orderMode,
+        rows: rows2
+      }
+    );
+    return rows2;
   }
   const { group, catalog } = input;
   const root = buildGroupTree(
@@ -20303,6 +20457,7 @@ function projectVisualRows(input) {
     hasChildren: input.hasChildren,
     comparator: input.comparator,
     orderMode: input.orderMode,
+    wbsDepth: input.wbsDepth,
     secondaryCatalog: input.secondaryCatalog,
     rows
   };
@@ -20316,6 +20471,7 @@ function projectVisualRows(input) {
 var ViewAttributeStore = class _ViewAttributeStore {
   catalogs = /* @__PURE__ */ new Map();
   group = null;
+  wbsDepth = null;
   getCatalog(key) {
     return this.catalogs.get(key) ?? null;
   }
@@ -20335,10 +20491,17 @@ var ViewAttributeStore = class _ViewAttributeStore {
   setGroup(nextGroup) {
     this.group = nextGroup;
   }
+  getWbsDepth() {
+    return this.wbsDepth;
+  }
+  setWbsDepth(nextDepth) {
+    this.wbsDepth = nextDepth;
+  }
   clone() {
     const fork = new _ViewAttributeStore();
     fork.catalogs = new Map(this.catalogs);
     fork.group = this.group === null ? null : cloneDomainValue(this.group);
+    fork.wbsDepth = this.wbsDepth;
     return fork;
   }
 };
@@ -20576,6 +20739,13 @@ var ScheduleState = class _ScheduleState {
     this._viewAttributes.setGroup(nextGroup);
     this.invalidateVisualRows();
   }
+  getWbsDepth() {
+    return this._viewAttributes.getWbsDepth();
+  }
+  setWbsDepth(nextDepth) {
+    this._viewAttributes.setWbsDepth(nextDepth);
+    this.invalidateVisualRows();
+  }
   invalidateVisualRows() {
     this._cache.visualRows = null;
   }
@@ -20598,7 +20768,8 @@ var ScheduleState = class _ScheduleState {
       catalog,
       secondaryCatalog,
       comparator: this.getOrderComparator(),
-      orderMode: this.getOrderMode()
+      orderMode: this.getOrderMode(),
+      wbsDepth: this._viewAttributes.getWbsDepth()
     });
     return this._cache.visualRows;
   }
@@ -21195,7 +21366,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) {
+  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) {
     return DISPATCH_HISTORY_POLICY.SKIP;
   }
   return DISPATCH_HISTORY_POLICY.RECORD;
@@ -21711,6 +21882,7 @@ var ACTIVITY_SAVE_FIELD_POLICY = {
   isCritical: SAVE_FIELD_POLICY.IGNORED,
   freeSlackHours: SAVE_FIELD_POLICY.IGNORED,
   calendarDuration: SAVE_FIELD_POLICY.IGNORED,
+  baselineVarianceDays: SAVE_FIELD_POLICY.IGNORED,
   expectedProgress: SAVE_FIELD_POLICY.IGNORED,
   expectedProgressBaseline: SAVE_FIELD_POLICY.IGNORED,
   status: SAVE_FIELD_POLICY.IGNORED,
@@ -22337,6 +22509,7 @@ function parseActivity(raw, context) {
       isMilestone
     ),
     baselineSnapshot: null,
+    baselineVarianceDays: null,
     recursiveDurationHours: durationToHours(
       Number(raw.sumOfDurationRecursively ?? 0),
       context.hoursPerDay
@@ -23559,6 +23732,7 @@ async function runInitialPasses(deps) {
       applyExpectedProgressLive(state, now);
       applyStatusPass(state, sector.statusCriteria);
     }
+    applyBaselineVariancePass(state, sector.hoursPerDay);
     return;
   }
   const result = await scheduler.schedule({});
@@ -23571,6 +23745,7 @@ async function runInitialPasses(deps) {
     applyExpectedProgressLive(state, now);
     applyStatusPass(state, sector.statusCriteria);
   }
+  applyBaselineVariancePass(state, sector.hoursPerDay);
 }
 function recomputeSkippedLeafEnds(state) {
   state.forEachActivity((activity) => {
@@ -24448,6 +24623,11 @@ var ScheduleCore = class _ScheduleCore {
     this.assertReady();
     return cloneDomainValue(this.coreRuntime.state.getGroup());
   }
+  /** @returns How deep the WBS reaches the screen, or `null` for every level. */
+  getWbsDepth() {
+    this.assertReady();
+    return this.coreRuntime.state.getWbsDepth();
+  }
   /** @returns Whether the parent currently has a direct child. */
   hasChild(parentId) {
     this.assertReady();
@@ -25419,6 +25599,7 @@ exports.FILTER_LOGIC = FILTER_LOGIC;
 exports.FILTER_OPERATOR = FILTER_OPERATOR;
 exports.FILTER_REJECTION_REASON = FILTER_REJECTION_REASON;
 exports.FILTER_VALUE_KIND = FILTER_VALUE_KIND;
+exports.FLAT_WBS_DEPTH = FLAT_WBS_DEPTH;
 exports.GROUP_ID_PREFIX = GROUP_ID_PREFIX;
 exports.GROUP_ID_SEPARATOR = GROUP_ID_SEPARATOR;
 exports.LINK_BATCH_OPERATION_KIND = LINK_BATCH_OPERATION_KIND;