@easyteam/auto-scheduler-modal-ui 0.1.4 → 0.1.5

package/dist/index.cjs

@@ -1251,7 +1251,7 @@ var buildStyles = (defaultStyles2, overrides) => ({
   }
 });
 
-// src/buildSchedulePayload.ts
+// src/utils/ruleIdMapping.ts
 var UI_TO_BACKEND_RULE_ID = {
   max_weekly_hours: "max-weekly-hours",
   max_daily_hours: "max-daily-hours",
@@ -1263,15 +1263,17 @@ var UI_TO_BACKEND_RULE_ID = {
   maximize_sales: "maximize-sales-performance",
   staff_preferences: "staff-open-shift-preferences"
 };
-var MAXIMIZE_CONVERSION_RATE_RULE_ID = "maximize-conversion-rate";
-var TRAFFIC_FORECAST_INCENTIVE_RULE_ID = "traffic-forecast-incentive";
-var SALES_OPTIMIZATION_UI_IDS = /* @__PURE__ */ new Set(["maximize_sales", "cost_to_sales_ratio"]);
 var BACKEND_TO_UI_RULE_ID = Object.fromEntries(
   Object.entries(UI_TO_BACKEND_RULE_ID).map(([ui, backend]) => [backend, ui])
 );
 function toBackendRuleId(uiOptionId) {
   return UI_TO_BACKEND_RULE_ID[uiOptionId];
 }
+
+// src/buildSchedulePayload.ts
+var MAXIMIZE_CONVERSION_RATE_RULE_ID = "maximize-conversion-rate";
+var TRAFFIC_FORECAST_INCENTIVE_RULE_ID = "traffic-forecast-incentive";
+var SALES_OPTIMIZATION_UI_IDS = /* @__PURE__ */ new Set(["maximize_sales", "cost_to_sales_ratio"]);
 function buildParametersForRule(backendRuleId, constraintValues, _optimizationValues) {
   var _a, _b, _c, _d;
   const params = {};
@@ -1585,6 +1587,22 @@ function withHorizonQuery(url, options) {
 }
 
 // src/utils/violationMessages.ts
+var INTERNAL_VIOLATION_PATTERNS = [
+  /\w+Rule\{/,
+  /\[I@/,
+  /Employee\{id=/,
+  /Accumulator violation \(Rule:/,
+  /^Schedule has \d+ hard, \d+ medium, and \d+ soft constraint violation/,
+  /ConstraintMatch\{/,
+  /MatchAnalysis\{/,
+  /Indictment\{/,
+  /Hard constraint violation \(count:/
+];
+function isInternalViolationText(text) {
+  const trimmed = text == null ? void 0 : text.trim();
+  if (!trimmed) return false;
+  return INTERNAL_VIOLATION_PATTERNS.some((pattern) => pattern.test(trimmed));
+}
 var SYSTEM_CONSTRAINT_MESSAGES = {
   "system-unassigned-Hard": {
     title: "Not enough eligible staff to cover all shifts",
@@ -1604,15 +1622,19 @@ var SYSTEM_CONSTRAINT_MESSAGES = {
   },
   "system-employee-unavailable-time-Hard": {
     title: "Unavailable time",
-    detail: "Unavailable time"
+    detail: "Some open shifts fall outside the available time windows for the remaining eligible team members."
   },
   "system-employee-available-time-Hard": {
     title: "Outside available time",
-    detail: "Outside available time"
+    detail: "Some open shifts fall outside the available time windows for the remaining eligible team members."
   },
   "system-employee-time-off-Hard": {
     title: "Time off prevents assignment",
     detail: "Some open shifts overlap with approved time off for the remaining eligible team members."
+  },
+  "system-no-overlapping-shifts-Hard": {
+    title: "Overlapping shifts",
+    detail: "Some team members would be assigned to overlapping shifts if all open shifts are assigned."
   }
 };
 var RULE_ID_MESSAGES = {
@@ -1628,108 +1650,251 @@ var RULE_ID_MESSAGES = {
     title: "Minimum rest between shifts",
     detail: "Some team members would not receive the required rest time if all open shifts are assigned."
   },
-  "min-days-off-per-week": {
+  "max-work-days-per-week": {
     title: "Maximum work days per week exceeded",
     detail: "Some team members would exceed the allowed work days this week if all open shifts are assigned."
   },
+  "min-days-off-per-week": {
+    title: "Minimum days off not met",
+    detail: "Some team members would not receive the required days off this week if all open shifts are assigned."
+  },
   "fair-hour-distribution": {
     title: "Work distribution not balanced",
-    detail: "Work distribution not balanced"
+    detail: "Some team members would receive an uneven share of shifts if all open shifts are assigned."
   },
   "overtime-balance": {
     title: "Overtime balance rule violated",
-    detail: "Overtime balance rule violated"
+    detail: "Some team members would exceed overtime limits if all open shifts are assigned."
+  },
+  "labor-cost-optimization": {
+    title: "Labor cost optimization conflict",
+    detail: "Some open shifts cannot be assigned while meeting labor cost optimization priorities."
+  },
+  "maximize-sales-performance": {
+    title: "Sales optimization conflict",
+    detail: "Some open shifts cannot be assigned while meeting sales optimization priorities."
+  },
+  "staff-open-shift-preferences": {
+    title: "Staff preferences conflict",
+    detail: "Some open shifts cannot be assigned while respecting all staff shift preferences."
+  },
+  "split-shift-penalty": {
+    title: "Split shift rule violated",
+    detail: "Some team members would receive split shifts that violate scheduling preferences."
+  },
+  "shift-continuity-penalty": {
+    title: "Shift continuity rule violated",
+    detail: "Some team members would receive shift patterns that violate continuity preferences."
   },
   "manager-cashier-ratio": {
     title: "Staffing ratio violated",
-    detail: "Staffing ratio violated"
+    detail: "Some open shifts cannot be assigned while meeting required staffing ratios."
   },
   "min-staffing": {
     title: "Minimum staffing not met",
-    detail: "Minimum staffing not met"
+    detail: "Some time periods would not meet minimum staffing requirements if all open shifts are assigned."
   },
   "shift-duration-limits": {
     title: "Shift duration outside allowed range",
-    detail: "Shift duration outside allowed range"
+    detail: "Some open shifts fall outside the allowed shift duration range."
   },
   "max-consecutive-days": {
     title: "Shift sequence rule violated",
-    detail: "Shift sequence rule violated"
+    detail: "Some team members would violate consecutive shift rules if all open shifts are assigned."
   },
   "some-transactional-rule": {
     title: "Policy rule violated",
-    detail: "Policy rule violated"
+    detail: "Some open shifts cannot be assigned while meeting all policy requirements."
+  }
+};
+var CONSTRAINT_NAME_MESSAGES = {
+  "AccumulatorDays-Hard": {
+    title: "Maximum work days per week exceeded",
+    detail: "Some team members would exceed the allowed work days this week if all open shifts are assigned."
+  },
+  "Accumulator-Hard": {
+    title: "Hours limit exceeded",
+    detail: "Some team members would exceed hour limits if all open shifts are assigned."
+  },
+  "Spacer-Hard": {
+    title: "Rest period not met",
+    detail: "Some team members would not receive the required rest time if all open shifts are assigned."
+  },
+  "SpacerPeriodic-Hard": {
+    title: "Required rest period not met",
+    detail: "Some team members would not receive the required rest period if all open shifts are assigned."
+  },
+  "Composition-Hard": {
+    title: "Staffing ratio violated",
+    detail: "Some open shifts cannot be assigned while meeting required staffing ratios."
+  },
+  "Transactional-Hard": {
+    title: "Policy rule violated",
+    detail: "Some open shifts cannot be assigned while meeting all policy requirements."
+  },
+  "Balancer-Hard": {
+    title: "Work distribution not balanced",
+    detail: "Some team members would receive an uneven share of shifts if all open shifts are assigned."
+  },
+  "Coverage-Hard": {
+    title: "Minimum staffing not met",
+    detail: "Some time periods would not meet minimum staffing requirements if all open shifts are assigned."
+  },
+  "Sizing-Hard": {
+    title: "Shift duration outside allowed range",
+    detail: "Some open shifts fall outside the allowed shift duration range."
+  },
+  "Sequencer-Hard": {
+    title: "Shift sequence rule violated",
+    detail: "Some team members would violate consecutive shift rules if all open shifts are assigned."
+  },
+  "OptimizerMinimize-Hard": {
+    title: "Optimization rule violated",
+    detail: "Some open shifts cannot be assigned while meeting all optimization priorities."
+  },
+  "OptimizerMaximize-Hard": {
+    title: "Optimization rule violated",
+    detail: "Some open shifts cannot be assigned while meeting all optimization priorities."
   }
 };
 var ARCHETYPE_FALLBACK_MESSAGES = {
-  "Accumulator violation (HARD)": {
+  AccumulatorDays: {
+    title: "Maximum work days per week exceeded",
+    detail: "Some team members would exceed the allowed work days this week if all open shifts are assigned."
+  },
+  Accumulator: {
     title: "Hours limit exceeded",
-    detail: "Hours limit exceeded"
+    detail: "Some team members would exceed hour limits if all open shifts are assigned."
   },
-  "Spacer violation (HARD)": {
+  Spacer: {
     title: "Rest period not met",
-    detail: "Rest period not met"
+    detail: "Some team members would not receive the required rest time if all open shifts are assigned."
   },
-  "Spacer periodic violation (HARD)": {
+  SpacerPeriodic: {
     title: "Required rest period not met",
-    detail: "Required rest period not met"
+    detail: "Some team members would not receive the required rest period if all open shifts are assigned."
   },
-  "Composition violation (HARD)": {
+  Composition: {
     title: "Staffing ratio violated",
-    detail: "Staffing ratio violated"
+    detail: "Some open shifts cannot be assigned while meeting required staffing ratios."
   },
-  "Transactional violation (HARD)": {
+  Transactional: {
     title: "Policy rule violated",
-    detail: "Policy rule violated"
+    detail: "Some open shifts cannot be assigned while meeting all policy requirements."
   },
-  "Balancer violation (HARD)": {
+  Balancer: {
     title: "Work distribution not balanced",
-    detail: "Work distribution not balanced"
+    detail: "Some team members would receive an uneven share of shifts if all open shifts are assigned."
   },
-  "Coverage violation (HARD)": {
+  Coverage: {
     title: "Minimum staffing not met",
-    detail: "Minimum staffing not met"
+    detail: "Some time periods would not meet minimum staffing requirements if all open shifts are assigned."
   },
-  "Sizing violation (HARD)": {
+  Sizing: {
     title: "Shift duration outside allowed range",
-    detail: "Shift duration outside allowed range"
+    detail: "Some open shifts fall outside the allowed shift duration range."
   },
-  "Sequencer violation (HARD)": {
+  Sequencer: {
     title: "Shift sequence rule violated",
-    detail: "Shift sequence rule violated"
+    detail: "Some team members would violate consecutive shift rules if all open shifts are assigned."
   },
-  "Overtime balance violation (HARD)": {
-    title: "Overtime balance rule violated",
-    detail: "Overtime balance rule violated"
+  OptimizerMinimize: {
+    title: "Optimization rule violated",
+    detail: "Some open shifts cannot be assigned while meeting all optimization priorities."
+  },
+  OptimizerMaximize: {
+    title: "Optimization rule violated",
+    detail: "Some open shifts cannot be assigned while meeting all optimization priorities."
   }
 };
 var FALLBACK_MESSAGE = {
   title: "Rule violated",
-  detail: "Rule violated"
+  detail: "Please adjust constraints and try again."
 };
-function getSystemConstraintMessage(constraintName, description) {
-  if (constraintName && constraintName in SYSTEM_CONSTRAINT_MESSAGES) {
-    return SYSTEM_CONSTRAINT_MESSAGES[constraintName];
+function parseBackendConstraintName(constraintName) {
+  if (!(constraintName == null ? void 0 : constraintName.trim())) return {};
+  let name = constraintName.trim();
+  for (const suffix of ["Hard", "Medium", "Soft"]) {
+    if (name.endsWith(`-${suffix}`)) {
+      name = name.slice(0, -(suffix.length + 1));
+      break;
+    }
+  }
+  if (name.startsWith("system-")) {
+    return {};
+  }
+  const lastDash = name.lastIndexOf("-");
+  if (lastDash > 0) {
+    return {
+      ruleId: name.slice(0, lastDash),
+      archetype: name.slice(lastDash + 1)
+    };
   }
-  if (description == null ? void 0 : description.trim()) {
-    return { title: description, detail: description };
+  return { archetype: name };
+}
+function resolveRuleIdMessage(ruleId) {
+  if (!(ruleId == null ? void 0 : ruleId.trim())) return void 0;
+  return RULE_ID_MESSAGES[ruleId.trim()];
+}
+function stripSeveritySuffix(name) {
+  return name.replace(/-(Hard|Medium|Soft)$/, "");
+}
+function resolveConstraintNameMessage(constraintName) {
+  if (!(constraintName == null ? void 0 : constraintName.trim())) return void 0;
+  const trimmed = constraintName.trim();
+  const exact = CONSTRAINT_NAME_MESSAGES[trimmed];
+  if (exact) return exact;
+  const severityStripped = stripSeveritySuffix(trimmed);
+  const directRuleId = resolveRuleIdMessage(severityStripped);
+  if (directRuleId) return directRuleId;
+  const parsed = parseBackendConstraintName(trimmed);
+  if (parsed.ruleId) {
+    const fromEmbeddedRuleId = resolveRuleIdMessage(parsed.ruleId);
+    if (fromEmbeddedRuleId) return fromEmbeddedRuleId;
   }
-  return FALLBACK_MESSAGE;
+  if (parsed.archetype && parsed.archetype in ARCHETYPE_FALLBACK_MESSAGES) {
+    return ARCHETYPE_FALLBACK_MESSAGES[parsed.archetype];
+  }
+  return void 0;
 }
-function getRuleBasedViolationMessage(ruleId, constraintName, description) {
-  if (ruleId && ruleId in RULE_ID_MESSAGES) {
-    return RULE_ID_MESSAGES[ruleId];
+function safeDescriptionMessage(description) {
+  if (!(description == null ? void 0 : description.trim()) || isInternalViolationText(description)) {
+    return void 0;
   }
-  if (constraintName && constraintName in ARCHETYPE_FALLBACK_MESSAGES) {
-    return ARCHETYPE_FALLBACK_MESSAGES[constraintName];
+  return { title: description.trim(), detail: description.trim() };
+}
+function getSystemConstraintMessage(constraintName, description) {
+  var _a;
+  if (constraintName && constraintName in SYSTEM_CONSTRAINT_MESSAGES) {
+    return SYSTEM_CONSTRAINT_MESSAGES[constraintName];
   }
-  if (description == null ? void 0 : description.trim()) {
-    return { title: description, detail: description };
+  const fromConstraintName = resolveConstraintNameMessage(constraintName);
+  if (fromConstraintName) return fromConstraintName;
+  return (_a = safeDescriptionMessage(description)) != null ? _a : FALLBACK_MESSAGE;
+}
+function getRuleBasedViolationMessage(ruleId, constraintName, description, archetype) {
+  var _a;
+  const fromRuleId = resolveRuleIdMessage(ruleId);
+  if (fromRuleId) return fromRuleId;
+  const fromConstraintName = resolveConstraintNameMessage(constraintName);
+  if (fromConstraintName) return fromConstraintName;
+  if ((archetype == null ? void 0 : archetype.trim()) && archetype.trim() in ARCHETYPE_FALLBACK_MESSAGES) {
+    return ARCHETYPE_FALLBACK_MESSAGES[archetype.trim()];
   }
-  return FALLBACK_MESSAGE;
+  return (_a = safeDescriptionMessage(description)) != null ? _a : FALLBACK_MESSAGE;
 }
 
 // src/utils/mapViolationsToResult.ts
+function resolveCustomViolationMessage(ruleId, customMessages) {
+  if (!customMessages) return void 0;
+  const direct = customMessages[ruleId];
+  if (direct) return direct;
+  const uiRuleId = BACKEND_TO_UI_RULE_ID[ruleId];
+  if (uiRuleId) {
+    return customMessages[uiRuleId];
+  }
+  return void 0;
+}
 function mapViolationsToResult(violations, summary, customMessages) {
   var _a;
   const hardViolations = violations.filter((v) => v.isHardViolation === true);
@@ -1737,7 +1902,7 @@ function mapViolationsToResult(violations, summary, customMessages) {
   const violatedConstraints = [];
   for (const v of hardViolations) {
     const hasRuleId = v.ruleId != null && v.ruleId !== void 0 && String(v.ruleId).trim() !== "";
-    const msg = hasRuleId ? (_a = customMessages == null ? void 0 : customMessages[v.ruleId]) != null ? _a : getRuleBasedViolationMessage(v.ruleId, v.constraintName, v.description) : getSystemConstraintMessage(v.constraintName, v.description);
+    const msg = hasRuleId ? (_a = resolveCustomViolationMessage(v.ruleId, customMessages)) != null ? _a : getRuleBasedViolationMessage(v.ruleId, v.constraintName, v.description, v.archetype) : getSystemConstraintMessage(v.constraintName, v.description);
     if (!seenTitles.has(msg.title)) {
       seenTitles.add(msg.title);
       violatedConstraints.push(msg);
@@ -1747,18 +1912,12 @@ function mapViolationsToResult(violations, summary, customMessages) {
     violatedConstraints,
     recommendedFixes: []
   };
-  if (violatedConstraints.length === 0 && (summary == null ? void 0 : summary.trim())) {
-    result.violatedConstraints = [
-      {
-        title: "Schedule could not be created",
-        detail: summary
-      }
-    ];
-  } else if (violatedConstraints.length === 0) {
+  if (violatedConstraints.length === 0) {
+    const safeSummary = (summary == null ? void 0 : summary.trim()) && !isInternalViolationText(summary) ? summary.trim() : void 0;
     result.violatedConstraints = [
       {
         title: "Schedule could not be created",
-        detail: "Please adjust constraints and try again."
+        detail: safeSummary != null ? safeSummary : "Please adjust constraints and try again."
       }
     ];
   }
@@ -2072,11 +2231,21 @@ function AutoSchedulerModal({
   const dynamicViolationMessages = (0, import_react3.useMemo)(() => {
     const map = {};
     for (const opt of effectiveHardConstraintOptions) {
-      map[opt.id] = { title: opt.name, detail: opt.description || opt.name };
+      const msg = { title: opt.name, detail: opt.description || opt.name };
+      map[opt.id] = msg;
+      const backendRuleId = toBackendRuleId(opt.id);
+      if (backendRuleId) {
+        map[backendRuleId] = msg;
+      }
     }
     for (const group of effectiveSoftConstraintGroups) {
       for (const opt of group.options) {
-        map[opt.id] = { title: opt.title, detail: opt.subtitle || opt.title };
+        const msg = { title: opt.title, detail: opt.subtitle || opt.title };
+        map[opt.id] = msg;
+        const backendRuleId = toBackendRuleId(opt.id);
+        if (backendRuleId) {
+          map[backendRuleId] = msg;
+        }
       }
     }
     return map;