dabke 0.82.0 → 0.83.0

package/dist/cpsat/rules/rules.types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"rules.types.d.ts","sourceRoot":"","sources":["../../../src/cpsat/rules/rules.types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AAE3D,MAAM,MAAM,uBAAuB,CAAC,OAAO,GAAG,GAAG,IAAI,CAAC,MAAM,EAAE,OAAO,KAAK,eAAe,CAAC;AAG1F,MAAM,WAAW,iBAAiB;IAChC,iBAAiB,EAAE,OAAO,sBAAsB,EAAE,oBAAoB,CAAC;IACvE,qBAAqB,EAAE,OAAO,0BAA0B,EAAE,wBAAwB,CAAC;IACnF,qBAAqB,EAAE,OAAO,0BAA0B,EAAE,wBAAwB,CAAC;IACnF,sBAAsB,EAAE,OAAO,2BAA2B,EAAE,wBAAwB,CAAC;IACrF,eAAe,EAAE,OAAO,oBAAoB,EAAE,iBAAiB,CAAC;IAChE,gBAAgB,EAAE,OAAO,qBAAqB,EAAE,kBAAkB,CAAC;IACnE,gBAAgB,EAAE,OAAO,qBAAqB,EAAE,kBAAkB,CAAC;IACnE,sBAAsB,EAAE,OAAO,2BAA2B,EAAE,wBAAwB,CAAC;IACrF,eAAe,EAAE,OAAO,oBAAoB,EAAE,iBAAiB,CAAC;IAChE,gBAAgB,EAAE,OAAO,qBAAqB,EAAE,kBAAkB,CAAC;IACnE,yBAAyB,EAAE,OAAO,8BAA8B,EAAE,0BAA0B,CAAC;IAC7F,UAAU,EAAE,OAAO,eAAe,EAAE,aAAa,CAAC;IAClD,eAAe,EAAE,OAAO,oBAAoB,EAAE,kBAAkB,CAAC;IACjE,qBAAqB,EAAE,OAAO,0BAA0B,EAAE,uBAAuB,CAAC;IAClF,oBAAoB,EAAE,OAAO,yBAAyB,EAAE,sBAAsB,CAAC;IAC/E,qBAAqB,EAAE,OAAO,0BAA0B,EAAE,uBAAuB,CAAC;IAClF,4BAA4B,EAAE,OAAO,iCAAiC,EAAE,8BAA8B,CAAC;IACvG,2BAA2B,EAAE,OAAO,gCAAgC,EAAE,6BAA6B,CAAC;IACpG,2BAA2B,EAAE,OAAO,gCAAgC,EAAE,6BAA6B,CAAC;IACpG,0BAA0B,EAAE,OAAO,+BAA+B,EAAE,4BAA4B,CAAC;IACjG,4BAA4B,EAAE,OAAO,iCAAiC,EAAE,8BAA8B,CAAC;CACxG;AAED,MAAM,MAAM,aAAa,GAAG,MAAM,iBAAiB,CAAC;AAEpD,MAAM,MAAM,kBAAkB,GAAG;IAC/B,CAAC,QAAQ,EAAE,MAAM,GAAG,uBAAuB,CAAC,GAAG,CAAC,CAAC;CAClD,CAAC;AAEF,MAAM,MAAM,yBAAyB,GAAG;KACrC,CAAC,IAAI,aAAa,GAAG,uBAAuB,CAAC,iBAAiB,CAAC,CAAC,CAAC,CAAC;CACpE,CAAC;AAEF,MAAM,MAAM,oBAAoB,CAAC,CAAC,IAChC,CAAC,SAAS,uBAAuB,CAAC,MAAM,MAAM,CAAC,GAAG,MAAM,GAAG,KAAK,CAAC;AAEnE,MAAM,MAAM,8BAA8B,CAAC,CAAC,SAAS,kBAAkB,IAAI;KACxE,CAAC,IAAI,MAAM,CAAC,GAAG,oBAAoB,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;CAC3C,CAAC;AAEF;;;;;;;;;;;;;;;GAeG;AACH,MAAM,MAAM,oBAAoB,GAAG;KAChC,CAAC,IAAI,aAAa,GAAG;QAAE,IAAI,EAAE,CAAC,CAAA;KAAE,GAAG,iBAAiB,CAAC,CAAC,CAAC;CACzD,CAAC,aAAa,CAAC,CAAC"}
+{"version":3,"file":"rules.types.d.ts","sourceRoot":"","sources":["../../../src/cpsat/rules/rules.types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AAE3D,MAAM,MAAM,uBAAuB,CAAC,OAAO,GAAG,GAAG,IAAI,CAAC,MAAM,EAAE,OAAO,KAAK,eAAe,CAAC;AAG1F,MAAM,WAAW,iBAAiB;IAChC,iBAAiB,EAAE,OAAO,sBAAsB,EAAE,oBAAoB,CAAC;IACvE,qBAAqB,EAAE,OAAO,0BAA0B,EAAE,wBAAwB,CAAC;IACnF,qBAAqB,EAAE,OAAO,0BAA0B,EAAE,wBAAwB,CAAC;IACnF,sBAAsB,EAAE,OAAO,2BAA2B,EAAE,wBAAwB,CAAC;IACrF,eAAe,EAAE,OAAO,oBAAoB,EAAE,iBAAiB,CAAC;IAChE,eAAe,EAAE,OAAO,oBAAoB,EAAE,iBAAiB,CAAC;IAChE,gBAAgB,EAAE,OAAO,qBAAqB,EAAE,kBAAkB,CAAC;IACnE,gBAAgB,EAAE,OAAO,qBAAqB,EAAE,kBAAkB,CAAC;IACnE,sBAAsB,EAAE,OAAO,2BAA2B,EAAE,wBAAwB,CAAC;IACrF,eAAe,EAAE,OAAO,oBAAoB,EAAE,iBAAiB,CAAC;IAChE,eAAe,EAAE,OAAO,oBAAoB,EAAE,iBAAiB,CAAC;IAChE,gBAAgB,EAAE,OAAO,qBAAqB,EAAE,kBAAkB,CAAC;IACnE,yBAAyB,EAAE,OAAO,8BAA8B,EAAE,0BAA0B,CAAC;IAC7F,aAAa,EAAE,OAAO,kBAAkB,EAAE,gBAAgB,CAAC;IAC3D,UAAU,EAAE,OAAO,eAAe,EAAE,aAAa,CAAC;IAClD,eAAe,EAAE,OAAO,oBAAoB,EAAE,kBAAkB,CAAC;IACjE,qBAAqB,EAAE,OAAO,0BAA0B,EAAE,uBAAuB,CAAC;IAClF,oBAAoB,EAAE,OAAO,yBAAyB,EAAE,sBAAsB,CAAC;IAC/E,qBAAqB,EAAE,OAAO,0BAA0B,EAAE,uBAAuB,CAAC;IAClF,4BAA4B,EAAE,OAAO,iCAAiC,EAAE,8BAA8B,CAAC;IACvG,2BAA2B,EAAE,OAAO,gCAAgC,EAAE,6BAA6B,CAAC;IACpG,2BAA2B,EAAE,OAAO,gCAAgC,EAAE,6BAA6B,CAAC;IACpG,0BAA0B,EAAE,OAAO,+BAA+B,EAAE,4BAA4B,CAAC;IACjG,4BAA4B,EAAE,OAAO,iCAAiC,EAAE,8BAA8B,CAAC;CACxG;AAED,MAAM,MAAM,aAAa,GAAG,MAAM,iBAAiB,CAAC;AAEpD,MAAM,MAAM,kBAAkB,GAAG;IAC/B,CAAC,QAAQ,EAAE,MAAM,GAAG,uBAAuB,CAAC,GAAG,CAAC,CAAC;CAClD,CAAC;AAEF,MAAM,MAAM,yBAAyB,GAAG;KACrC,CAAC,IAAI,aAAa,GAAG,uBAAuB,CAAC,iBAAiB,CAAC,CAAC,CAAC,CAAC;CACpE,CAAC;AAEF,MAAM,MAAM,oBAAoB,CAAC,CAAC,IAChC,CAAC,SAAS,uBAAuB,CAAC,MAAM,MAAM,CAAC,GAAG,MAAM,GAAG,KAAK,CAAC;AAEnE,MAAM,MAAM,8BAA8B,CAAC,CAAC,SAAS,kBAAkB,IAAI;KACxE,CAAC,IAAI,MAAM,CAAC,GAAG,oBAAoB,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;CAC3C,CAAC;AAEF;;;;;;;;;;;;;;;GAeG;AACH,MAAM,MAAM,oBAAoB,GAAG;KAChC,CAAC,IAAI,aAAa,GAAG;QAAE,IAAI,EAAE,CAAC,CAAA;KAAE,GAAG,iBAAiB,CAAC,CAAC,CAAC;CACzD,CAAC,aAAa,CAAC,CAAC"}

package/dist/cpsat/rules/scope.types.d.ts

@@ -79,7 +79,7 @@ type NonEmptyArray<T> = [T, ...T[]];
 /**
  * Recurring calendar period for time scoping.
  *
- * @category Rules
+ * @category Supporting Types
  */
 export interface RecurringPeriod {
     name: string;

package/dist/index.d.ts

@@ -1,5 +1,7 @@
 /**
- * @privateRemarks
+ * Scheduling library powered by constraint programming (CP-SAT).
+ *
+ * @remarks
  * ## Core Concepts
  *
  * **Schedule**: The primary API. Small, composable functions
@@ -48,6 +50,6 @@ export type { HourlyPay, SalariedPay, SchedulingMember, ShiftPattern, Priority,
 export { OBJECTIVE_WEIGHTS } from "./cpsat/utils.js";
 export type { ValidationGroup, ScheduleValidation, ScheduleError, CoverageError, RuleError, SolverError, ScheduleViolation, CoverageViolation, RuleViolation, SchedulePassed, CoveragePassed, RulePassed, ValidationSummary, } from "./cpsat/validation.types.js";
 export { summarizeValidation } from "./cpsat/validation-reporter.js";
-export { schedule, partialSchedule, Schedule, t, time, cover, shift, maxHoursPerDay, maxHoursPerWeek, minHoursPerDay, minHoursPerWeek, maxShiftsPerDay, maxConsecutiveDays, minConsecutiveDays, minRestBetweenShifts, preference, preferLocation, timeOff, assignTogether, defineRule, minimizeCost, dayMultiplier, daySurcharge, timeSurcharge, overtimeMultiplier, overtimeSurcharge, dailyOvertimeMultiplier, dailyOvertimeSurcharge, tieredOvertimeMultiplier, weekdays, weekend, } from "./schedule.js";
-export type { CoverageEntry, CoverageOptions, CoverageVariant, RuleEntry, RuleResolveContext, RuleOptions, EntityOnlyRuleOptions, TimeOffOptions, AssignTogetherOptions, CostRuleOptions, ScheduleConfig, SolveResult, SolveStatus, SolveOptions, } from "./schedule.js";
+export { schedule, partialSchedule, Schedule, t, time, cover, shift, maxHoursPerDay, maxHoursPerWeek, minHoursPerDay, minHoursPerWeek, maxDaysPerWeek, minDaysPerWeek, maxShiftsPerDay, maxConsecutiveDays, minConsecutiveDays, minRestBetweenShifts, mustAssign, preference, preferLocation, timeOff, assignTogether, defineRule, minimizeCost, dayMultiplier, daySurcharge, timeSurcharge, overtimeMultiplier, overtimeSurcharge, dailyOvertimeMultiplier, dailyOvertimeSurcharge, tieredOvertimeMultiplier, weekdays, weekend, } from "./schedule/index.js";
+export type { CoverageEntry, CoverageOptions, CoverageVariant, RuleEntry, RuleResolveContext, RuleOptions, EntityOnlyRuleOptions, TimeOffOptions, AssignTogetherOptions, CostRuleOptions, ScheduleConfig, SolveResult, SolveStatus, SolveOptions, } from "./schedule/index.js";
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AAMH,YAAY,EAAE,SAAS,EAAE,SAAS,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAEzE,OAAO,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAM7C,OAAO,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAE/C,YAAY,EACV,YAAY,EACZ,aAAa,EACb,cAAc,EACd,YAAY,EACZ,uBAAuB,EACvB,WAAW,GACZ,MAAM,mBAAmB,CAAC;AAE3B,OAAO,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAElD,OAAO,EAAE,mBAAmB,EAAE,oBAAoB,EAAE,kBAAkB,EAAE,MAAM,qBAAqB,CAAC;AAMpG,OAAO,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AAExD,YAAY,EACV,kBAAkB,EAClB,iBAAiB,EACjB,eAAe,EACf,qBAAqB,EACrB,SAAS,EACT,gBAAgB,GACjB,MAAM,0BAA0B,CAAC;AAMlC,OAAO,EAAE,mBAAmB,EAAE,kBAAkB,EAAE,MAAM,qBAAqB,CAAC;AAE9E,YAAY,EAAE,eAAe,EAAE,uBAAuB,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAMlG,OAAO,EAAE,qBAAqB,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAEvE,YAAY,EAAE,aAAa,EAAE,gBAAgB,EAAE,qBAAqB,EAAE,MAAM,iBAAiB,CAAC;AAM9F,YAAY,EACV,oBAAoB,EACpB,kBAAkB,EAClB,uBAAuB,GACxB,MAAM,8BAA8B,CAAC;AAEtC,YAAY,EAAE,eAAe,EAAE,MAAM,8BAA8B,CAAC;AAEpE,YAAY,EAAE,YAAY,EAAE,MAAM,6CAA6C,CAAC;AAMhF,YAAY,EACV,SAAS,EACT,WAAW,EACX,gBAAgB,EAChB,YAAY,EACZ,QAAQ,GACT,MAAM,kBAAkB,CAAC;AAM1B,OAAO,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AAMrD,YAAY,EACV,eAAe,EACf,kBAAkB,EAClB,aAAa,EACb,aAAa,EACb,SAAS,EACT,WAAW,EACX,iBAAiB,EACjB,iBAAiB,EACjB,aAAa,EACb,cAAc,EACd,cAAc,EACd,UAAU,EACV,iBAAiB,GAClB,MAAM,6BAA6B,CAAC;AAErC,OAAO,EAAE,mBAAmB,EAAE,MAAM,gCAAgC,CAAC;AAMrE,OAAO,EACL,QAAQ,EACR,eAAe,EACf,QAAQ,EACR,CAAC,EACD,IAAI,EACJ,KAAK,EACL,KAAK,EACL,cAAc,EACd,eAAe,EACf,cAAc,EACd,eAAe,EACf,eAAe,EACf,kBAAkB,EAClB,kBAAkB,EAClB,oBAAoB,EACpB,UAAU,EACV,cAAc,EACd,OAAO,EACP,cAAc,EACd,UAAU,EACV,YAAY,EACZ,aAAa,EACb,YAAY,EACZ,aAAa,EACb,kBAAkB,EAClB,iBAAiB,EACjB,uBAAuB,EACvB,sBAAsB,EACtB,wBAAwB,EACxB,QAAQ,EACR,OAAO,GACR,MAAM,eAAe,CAAC;AAEvB,YAAY,EACV,aAAa,EACb,eAAe,EACf,eAAe,EACf,SAAS,EACT,kBAAkB,EAClB,WAAW,EACX,qBAAqB,EACrB,cAAc,EACd,qBAAqB,EACrB,eAAe,EACf,cAAc,EACd,WAAW,EACX,WAAW,EACX,YAAY,GACb,MAAM,eAAe,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgCG;AAMH,YAAY,EAAE,SAAS,EAAE,SAAS,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAEzE,OAAO,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAM7C,OAAO,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAE/C,YAAY,EACV,YAAY,EACZ,aAAa,EACb,cAAc,EACd,YAAY,EACZ,uBAAuB,EACvB,WAAW,GACZ,MAAM,mBAAmB,CAAC;AAE3B,OAAO,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAElD,OAAO,EAAE,mBAAmB,EAAE,oBAAoB,EAAE,kBAAkB,EAAE,MAAM,qBAAqB,CAAC;AAMpG,OAAO,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AAExD,YAAY,EACV,kBAAkB,EAClB,iBAAiB,EACjB,eAAe,EACf,qBAAqB,EACrB,SAAS,EACT,gBAAgB,GACjB,MAAM,0BAA0B,CAAC;AAMlC,OAAO,EAAE,mBAAmB,EAAE,kBAAkB,EAAE,MAAM,qBAAqB,CAAC;AAE9E,YAAY,EAAE,eAAe,EAAE,uBAAuB,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAMlG,OAAO,EAAE,qBAAqB,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAEvE,YAAY,EAAE,aAAa,EAAE,gBAAgB,EAAE,qBAAqB,EAAE,MAAM,iBAAiB,CAAC;AAM9F,YAAY,EACV,oBAAoB,EACpB,kBAAkB,EAClB,uBAAuB,GACxB,MAAM,8BAA8B,CAAC;AAEtC,YAAY,EAAE,eAAe,EAAE,MAAM,8BAA8B,CAAC;AAEpE,YAAY,EAAE,YAAY,EAAE,MAAM,6CAA6C,CAAC;AAMhF,YAAY,EACV,SAAS,EACT,WAAW,EACX,gBAAgB,EAChB,YAAY,EACZ,QAAQ,GACT,MAAM,kBAAkB,CAAC;AAM1B,OAAO,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AAMrD,YAAY,EACV,eAAe,EACf,kBAAkB,EAClB,aAAa,EACb,aAAa,EACb,SAAS,EACT,WAAW,EACX,iBAAiB,EACjB,iBAAiB,EACjB,aAAa,EACb,cAAc,EACd,cAAc,EACd,UAAU,EACV,iBAAiB,GAClB,MAAM,6BAA6B,CAAC;AAErC,OAAO,EAAE,mBAAmB,EAAE,MAAM,gCAAgC,CAAC;AAMrE,OAAO,EACL,QAAQ,EACR,eAAe,EACf,QAAQ,EACR,CAAC,EACD,IAAI,EACJ,KAAK,EACL,KAAK,EACL,cAAc,EACd,eAAe,EACf,cAAc,EACd,eAAe,EACf,cAAc,EACd,cAAc,EACd,eAAe,EACf,kBAAkB,EAClB,kBAAkB,EAClB,oBAAoB,EACpB,UAAU,EACV,UAAU,EACV,cAAc,EACd,OAAO,EACP,cAAc,EACd,UAAU,EACV,YAAY,EACZ,aAAa,EACb,YAAY,EACZ,aAAa,EACb,kBAAkB,EAClB,iBAAiB,EACjB,uBAAuB,EACvB,sBAAsB,EACtB,wBAAwB,EACxB,QAAQ,EACR,OAAO,GACR,MAAM,qBAAqB,CAAC;AAE7B,YAAY,EACV,aAAa,EACb,eAAe,EACf,eAAe,EACf,SAAS,EACT,kBAAkB,EAClB,WAAW,EACX,qBAAqB,EACrB,cAAc,EACd,qBAAqB,EACrB,eAAe,EACf,cAAc,EACd,WAAW,EACX,WAAW,EACX,YAAY,GACb,MAAM,qBAAqB,CAAC"}

package/dist/index.js

@@ -1,5 +1,7 @@
 /**
- * @privateRemarks
+ * Scheduling library powered by constraint programming (CP-SAT).
+ *
+ * @remarks
  * ## Core Concepts
  *
  * **Schedule**: The primary API. Small, composable functions
@@ -56,5 +58,5 @@ export { summarizeValidation } from "./cpsat/validation-reporter.js";
 // ============================================================================
 // Schedule API
 // ============================================================================
-export { schedule, partialSchedule, Schedule, t, time, cover, shift, maxHoursPerDay, maxHoursPerWeek, minHoursPerDay, minHoursPerWeek, maxShiftsPerDay, maxConsecutiveDays, minConsecutiveDays, minRestBetweenShifts, preference, preferLocation, timeOff, assignTogether, defineRule, minimizeCost, dayMultiplier, daySurcharge, timeSurcharge, overtimeMultiplier, overtimeSurcharge, dailyOvertimeMultiplier, dailyOvertimeSurcharge, tieredOvertimeMultiplier, weekdays, weekend, } from "./schedule.js";
+export { schedule, partialSchedule, Schedule, t, time, cover, shift, maxHoursPerDay, maxHoursPerWeek, minHoursPerDay, minHoursPerWeek, maxDaysPerWeek, minDaysPerWeek, maxShiftsPerDay, maxConsecutiveDays, minConsecutiveDays, minRestBetweenShifts, mustAssign, preference, preferLocation, timeOff, assignTogether, defineRule, minimizeCost, dayMultiplier, daySurcharge, timeSurcharge, overtimeMultiplier, overtimeSurcharge, dailyOvertimeMultiplier, dailyOvertimeSurcharge, tieredOvertimeMultiplier, weekdays, weekend, } from "./schedule/index.js";
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AAQH,OAAO,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAE7C,+EAA+E;AAC/E,gBAAgB;AAChB,+EAA+E;AAE/E,OAAO,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAW/C,OAAO,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAElD,OAAO,EAAE,mBAAmB,EAAE,oBAAoB,EAAE,kBAAkB,EAAE,MAAM,qBAAqB,CAAC;AAEpG,+EAA+E;AAC/E,gBAAgB;AAChB,+EAA+E;AAE/E,OAAO,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AAWxD,+EAA+E;AAC/E,0BAA0B;AAC1B,+EAA+E;AAE/E,OAAO,EAAE,mBAAmB,EAAE,kBAAkB,EAAE,MAAM,qBAAqB,CAAC;AAI9E,+EAA+E;AAC/E,mBAAmB;AACnB,+EAA+E;AAE/E,OAAO,EAAE,qBAAqB,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AA8BvE,+EAA+E;AAC/E,YAAY;AACZ,+EAA+E;AAE/E,OAAO,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AAsBrD,OAAO,EAAE,mBAAmB,EAAE,MAAM,gCAAgC,CAAC;AAErE,+EAA+E;AAC/E,eAAe;AACf,+EAA+E;AAE/E,OAAO,EACL,QAAQ,EACR,eAAe,EACf,QAAQ,EACR,CAAC,EACD,IAAI,EACJ,KAAK,EACL,KAAK,EACL,cAAc,EACd,eAAe,EACf,cAAc,EACd,eAAe,EACf,eAAe,EACf,kBAAkB,EAClB,kBAAkB,EAClB,oBAAoB,EACpB,UAAU,EACV,cAAc,EACd,OAAO,EACP,cAAc,EACd,UAAU,EACV,YAAY,EACZ,aAAa,EACb,YAAY,EACZ,aAAa,EACb,kBAAkB,EAClB,iBAAiB,EACjB,uBAAuB,EACvB,sBAAsB,EACtB,wBAAwB,EACxB,QAAQ,EACR,OAAO,GACR,MAAM,eAAe,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgCG;AAQH,OAAO,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAE7C,+EAA+E;AAC/E,gBAAgB;AAChB,+EAA+E;AAE/E,OAAO,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAW/C,OAAO,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAElD,OAAO,EAAE,mBAAmB,EAAE,oBAAoB,EAAE,kBAAkB,EAAE,MAAM,qBAAqB,CAAC;AAEpG,+EAA+E;AAC/E,gBAAgB;AAChB,+EAA+E;AAE/E,OAAO,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AAWxD,+EAA+E;AAC/E,0BAA0B;AAC1B,+EAA+E;AAE/E,OAAO,EAAE,mBAAmB,EAAE,kBAAkB,EAAE,MAAM,qBAAqB,CAAC;AAI9E,+EAA+E;AAC/E,mBAAmB;AACnB,+EAA+E;AAE/E,OAAO,EAAE,qBAAqB,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AA8BvE,+EAA+E;AAC/E,YAAY;AACZ,+EAA+E;AAE/E,OAAO,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AAsBrD,OAAO,EAAE,mBAAmB,EAAE,MAAM,gCAAgC,CAAC;AAErE,+EAA+E;AAC/E,eAAe;AACf,+EAA+E;AAE/E,OAAO,EACL,QAAQ,EACR,eAAe,EACf,QAAQ,EACR,CAAC,EACD,IAAI,EACJ,KAAK,EACL,KAAK,EACL,cAAc,EACd,eAAe,EACf,cAAc,EACd,eAAe,EACf,cAAc,EACd,cAAc,EACd,eAAe,EACf,kBAAkB,EAClB,kBAAkB,EAClB,oBAAoB,EACpB,UAAU,EACV,UAAU,EACV,cAAc,EACd,OAAO,EACP,cAAc,EACd,UAAU,EACV,YAAY,EACZ,aAAa,EACb,YAAY,EACZ,aAAa,EACb,kBAAkB,EAClB,iBAAiB,EACjB,uBAAuB,EACvB,sBAAsB,EACtB,wBAAwB,EACxB,QAAQ,EACR,OAAO,GACR,MAAM,qBAAqB,CAAC"}

package/dist/schedule/cost.d.ts

@@ -0,0 +1,204 @@
+/**
+ * Cost optimization rules: minimize labor cost with modifiers.
+ *
+ * @module
+ */
+import type { DayOfWeek, TimeOfDay } from "../types.js";
+import type { OvertimeTier } from "../cpsat/rules/overtime-tiered-multiplier.js";
+import type { RecurringPeriod } from "../cpsat/rules/scope.types.js";
+import type { RuleEntry } from "./rules.js";
+/**
+ * Options for cost rules.
+ *
+ * Cost rules are objective terms, not constraints. The `priority` field from
+ * {@link RuleOptions} does not apply.
+ *
+ * @category Cost Optimization
+ */
+export interface CostRuleOptions {
+    /** Who this rule applies to (role name, skill name, or member ID). */
+    appliesTo?: string | string[];
+    /** Restrict to specific days of the week. */
+    dayOfWeek?: readonly [DayOfWeek, ...DayOfWeek[]];
+    /** Restrict to a date range. */
+    dateRange?: {
+        start: string;
+        end: string;
+    };
+    /** Restrict to specific dates (YYYY-MM-DD). */
+    dates?: string[];
+    /** Restrict to recurring calendar periods. */
+    recurringPeriods?: [RecurringPeriod, ...RecurringPeriod[]];
+}
+/**
+ * Tells the solver to minimize total labor cost.
+ *
+ * @remarks
+ * Without this rule, cost modifiers only affect post-solve calculation.
+ * When present, the solver actively prefers cheaper assignments.
+ *
+ * For hourly members, penalizes each assignment proportionally to cost.
+ * For salaried members, adds a fixed weekly salary cost when they have
+ * any assignment that week (zero marginal cost up to contracted hours).
+ *
+ * Cost modifiers adjust the calculation:
+ * - `dayMultiplier(factor, opts?)` - multiply base rate on specific days
+ * - `daySurcharge(amount, opts?)` - flat extra per hour on specific days
+ * - `timeSurcharge(amount, window, opts?)` - flat extra per hour during a time window
+ * - `overtimeMultiplier({ after, factor }, opts?)` - weekly overtime multiplier
+ * - `overtimeSurcharge({ after, amount }, opts?)` - weekly overtime surcharge
+ * - `dailyOvertimeMultiplier({ after, factor }, opts?)` - daily overtime multiplier
+ * - `dailyOvertimeSurcharge({ after, amount }, opts?)` - daily overtime surcharge
+ * - `tieredOvertimeMultiplier(tiers, opts?)` - multiple overtime thresholds
+ *
+ * @example
+ * ```ts
+ * minimizeCost()
+ * ```
+ *
+ * @category Cost Optimization
+ */
+export declare function minimizeCost(opts?: CostRuleOptions): RuleEntry;
+/**
+ * Multiplies the base rate for assignments on specified days.
+ *
+ * @remarks
+ * The base cost (1x) is already counted by {@link minimizeCost};
+ * this rule adds only the extra portion above 1x.
+ *
+ * @category Cost Optimization
+ *
+ * @example Weekend multiplier
+ * ```typescript
+ * dayMultiplier(1.5, { dayOfWeek: weekend })
+ * ```
+ */
+export declare function dayMultiplier(factor: number, opts?: CostRuleOptions): RuleEntry;
+/**
+ * Adds a flat extra amount per hour for assignments on specified days.
+ *
+ * @remarks
+ * The surcharge is independent of the member's base rate.
+ *
+ * @category Cost Optimization
+ *
+ * @example Weekend surcharge
+ * ```typescript
+ * daySurcharge(500, { dayOfWeek: weekend })
+ * ```
+ */
+export declare function daySurcharge(amountPerHour: number, opts?: CostRuleOptions): RuleEntry;
+/**
+ * Adds a flat surcharge per hour for the portion of a shift that overlaps a time-of-day window.
+ *
+ * @remarks
+ * The window supports overnight spans (e.g., 22:00-06:00). The surcharge
+ * is independent of the member's base rate.
+ *
+ * @param amountPerHour - Flat surcharge per hour in smallest currency unit
+ * @param window - Time-of-day window
+ * @param opts - Entity and time scoping
+ *
+ * @category Cost Optimization
+ *
+ * @example Night differential
+ * ```typescript
+ * timeSurcharge(200, { from: t(22), until: t(6) })
+ * ```
+ */
+export declare function timeSurcharge(amountPerHour: number, window: {
+    from: TimeOfDay;
+    until: TimeOfDay;
+}, opts?: CostRuleOptions): RuleEntry;
+/**
+ * Applies a multiplier to hours beyond a weekly threshold.
+ *
+ * @remarks
+ * Only the extra portion above 1x is added (the base cost is already
+ * counted by {@link minimizeCost}).
+ *
+ * @category Cost Optimization
+ *
+ * @example
+ * ```typescript
+ * overtimeMultiplier({ after: 40, factor: 1.5 })
+ * ```
+ */
+export declare function overtimeMultiplier(opts: {
+    after: number;
+    factor: number;
+} & CostRuleOptions): RuleEntry;
+/**
+ * Adds a flat surcharge per hour beyond a weekly threshold.
+ *
+ * @remarks
+ * The surcharge is independent of the member's base rate.
+ *
+ * @category Cost Optimization
+ *
+ * @example
+ * ```typescript
+ * overtimeSurcharge({ after: 40, amount: 1000 })
+ * ```
+ */
+export declare function overtimeSurcharge(opts: {
+    after: number;
+    amount: number;
+} & CostRuleOptions): RuleEntry;
+/**
+ * Applies a multiplier to hours beyond a daily threshold.
+ *
+ * @remarks
+ * Only the extra portion above 1x is added (the base cost is already
+ * counted by {@link minimizeCost}).
+ *
+ * @category Cost Optimization
+ *
+ * @example
+ * ```typescript
+ * dailyOvertimeMultiplier({ after: 8, factor: 1.5 })
+ * ```
+ */
+export declare function dailyOvertimeMultiplier(opts: {
+    after: number;
+    factor: number;
+} & CostRuleOptions): RuleEntry;
+/**
+ * Adds a flat surcharge per hour beyond a daily threshold.
+ *
+ * @remarks
+ * The surcharge is independent of the member's base rate.
+ *
+ * @category Cost Optimization
+ *
+ * @example
+ * ```typescript
+ * dailyOvertimeSurcharge({ after: 8, amount: 500 })
+ * ```
+ */
+export declare function dailyOvertimeSurcharge(opts: {
+    after: number;
+    amount: number;
+} & CostRuleOptions): RuleEntry;
+/**
+ * Applies multiple overtime thresholds with increasing multipliers.
+ *
+ * @remarks
+ * Each tier applies only to the hours between its threshold and the next.
+ * Tiers must be sorted by threshold ascending.
+ *
+ * @category Cost Optimization
+ *
+ * @example
+ * ```typescript
+ * // Hours 0-40: base rate
+ * // Hours 40-48: 1.5x
+ * // Hours 48+: 2.0x
+ * tieredOvertimeMultiplier([
+ *   { after: 40, factor: 1.5 },
+ *   { after: 48, factor: 2.0 },
+ * ])
+ * ```
+ */
+export declare function tieredOvertimeMultiplier(tiers: [OvertimeTier, ...OvertimeTier[]], opts?: CostRuleOptions): RuleEntry;
+//# sourceMappingURL=cost.d.ts.map

package/dist/schedule/cost.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cost.d.ts","sourceRoot":"","sources":["../../src/schedule/cost.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AACxD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,8CAA8C,CAAC;AACjF,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,+BAA+B,CAAC;AACrE,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAO5C;;;;;;;GAOG;AACH,MAAM,WAAW,eAAe;IAC9B,sEAAsE;IACtE,SAAS,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE,CAAC;IAC9B,6CAA6C;IAC7C,SAAS,CAAC,EAAE,SAAS,CAAC,SAAS,EAAE,GAAG,SAAS,EAAE,CAAC,CAAC;IACjD,gCAAgC;IAChC,SAAS,CAAC,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,GAAG,EAAE,MAAM,CAAA;KAAE,CAAC;IAC3C,+CAA+C;IAC/C,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;IACjB,8CAA8C;IAC9C,gBAAgB,CAAC,EAAE,CAAC,eAAe,EAAE,GAAG,eAAe,EAAE,CAAC,CAAC;CAC5D;AAUD;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH,wBAAgB,YAAY,CAAC,IAAI,CAAC,EAAE,eAAe,GAAG,SAAS,CAE9D;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,aAAa,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,eAAe,GAAG,SAAS,CAE/E;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,YAAY,CAAC,aAAa,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,eAAe,GAAG,SAAS,CAErF;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,aAAa,CAC3B,aAAa,EAAE,MAAM,EACrB,MAAM,EAAE;IAAE,IAAI,EAAE,SAAS,CAAC;IAAC,KAAK,EAAE,SAAS,CAAA;CAAE,EAC7C,IAAI,CAAC,EAAE,eAAe,GACrB,SAAS,CAEX;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,kBAAkB,CAChC,IAAI,EAAE;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,GAAG,eAAe,GACxD,SAAS,CAEX;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,iBAAiB,CAC/B,IAAI,EAAE;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,GAAG,eAAe,GACxD,SAAS,CAEX;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,uBAAuB,CACrC,IAAI,EAAE;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,GAAG,eAAe,GACxD,SAAS,CAEX;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,sBAAsB,CACpC,IAAI,EAAE;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,GAAG,eAAe,GACxD,SAAS,CAEX;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,wBAAwB,CACtC,KAAK,EAAE,CAAC,YAAY,EAAE,GAAG,YAAY,EAAE,CAAC,EACxC,IAAI,CAAC,EAAE,eAAe,GACrB,SAAS,CAEX"}

package/dist/schedule/cost.js

@@ -0,0 +1,187 @@
+/**
+ * Cost optimization rules: minimize labor cost with modifiers.
+ *
+ * @module
+ */
+import { defineRule } from "./rules.js";
+// ============================================================================
+// Cost Rules
+// ============================================================================
+function makeCostRule(rule, fields) {
+    return defineRule(rule, fields);
+}
+/**
+ * Tells the solver to minimize total labor cost.
+ *
+ * @remarks
+ * Without this rule, cost modifiers only affect post-solve calculation.
+ * When present, the solver actively prefers cheaper assignments.
+ *
+ * For hourly members, penalizes each assignment proportionally to cost.
+ * For salaried members, adds a fixed weekly salary cost when they have
+ * any assignment that week (zero marginal cost up to contracted hours).
+ *
+ * Cost modifiers adjust the calculation:
+ * - `dayMultiplier(factor, opts?)` - multiply base rate on specific days
+ * - `daySurcharge(amount, opts?)` - flat extra per hour on specific days
+ * - `timeSurcharge(amount, window, opts?)` - flat extra per hour during a time window
+ * - `overtimeMultiplier({ after, factor }, opts?)` - weekly overtime multiplier
+ * - `overtimeSurcharge({ after, amount }, opts?)` - weekly overtime surcharge
+ * - `dailyOvertimeMultiplier({ after, factor }, opts?)` - daily overtime multiplier
+ * - `dailyOvertimeSurcharge({ after, amount }, opts?)` - daily overtime surcharge
+ * - `tieredOvertimeMultiplier(tiers, opts?)` - multiple overtime thresholds
+ *
+ * @example
+ * ```ts
+ * minimizeCost()
+ * ```
+ *
+ * @category Cost Optimization
+ */
+export function minimizeCost(opts) {
+    return makeCostRule("minimize-cost", { ...opts });
+}
+/**
+ * Multiplies the base rate for assignments on specified days.
+ *
+ * @remarks
+ * The base cost (1x) is already counted by {@link minimizeCost};
+ * this rule adds only the extra portion above 1x.
+ *
+ * @category Cost Optimization
+ *
+ * @example Weekend multiplier
+ * ```typescript
+ * dayMultiplier(1.5, { dayOfWeek: weekend })
+ * ```
+ */
+export function dayMultiplier(factor, opts) {
+    return makeCostRule("day-cost-multiplier", { factor, ...opts });
+}
+/**
+ * Adds a flat extra amount per hour for assignments on specified days.
+ *
+ * @remarks
+ * The surcharge is independent of the member's base rate.
+ *
+ * @category Cost Optimization
+ *
+ * @example Weekend surcharge
+ * ```typescript
+ * daySurcharge(500, { dayOfWeek: weekend })
+ * ```
+ */
+export function daySurcharge(amountPerHour, opts) {
+    return makeCostRule("day-cost-surcharge", { amountPerHour, ...opts });
+}
+/**
+ * Adds a flat surcharge per hour for the portion of a shift that overlaps a time-of-day window.
+ *
+ * @remarks
+ * The window supports overnight spans (e.g., 22:00-06:00). The surcharge
+ * is independent of the member's base rate.
+ *
+ * @param amountPerHour - Flat surcharge per hour in smallest currency unit
+ * @param window - Time-of-day window
+ * @param opts - Entity and time scoping
+ *
+ * @category Cost Optimization
+ *
+ * @example Night differential
+ * ```typescript
+ * timeSurcharge(200, { from: t(22), until: t(6) })
+ * ```
+ */
+export function timeSurcharge(amountPerHour, window, opts) {
+    return makeCostRule("time-cost-surcharge", { amountPerHour, window, ...opts });
+}
+/**
+ * Applies a multiplier to hours beyond a weekly threshold.
+ *
+ * @remarks
+ * Only the extra portion above 1x is added (the base cost is already
+ * counted by {@link minimizeCost}).
+ *
+ * @category Cost Optimization
+ *
+ * @example
+ * ```typescript
+ * overtimeMultiplier({ after: 40, factor: 1.5 })
+ * ```
+ */
+export function overtimeMultiplier(opts) {
+    return makeCostRule("overtime-weekly-multiplier", { ...opts });
+}
+/**
+ * Adds a flat surcharge per hour beyond a weekly threshold.
+ *
+ * @remarks
+ * The surcharge is independent of the member's base rate.
+ *
+ * @category Cost Optimization
+ *
+ * @example
+ * ```typescript
+ * overtimeSurcharge({ after: 40, amount: 1000 })
+ * ```
+ */
+export function overtimeSurcharge(opts) {
+    return makeCostRule("overtime-weekly-surcharge", { ...opts });
+}
+/**
+ * Applies a multiplier to hours beyond a daily threshold.
+ *
+ * @remarks
+ * Only the extra portion above 1x is added (the base cost is already
+ * counted by {@link minimizeCost}).
+ *
+ * @category Cost Optimization
+ *
+ * @example
+ * ```typescript
+ * dailyOvertimeMultiplier({ after: 8, factor: 1.5 })
+ * ```
+ */
+export function dailyOvertimeMultiplier(opts) {
+    return makeCostRule("overtime-daily-multiplier", { ...opts });
+}
+/**
+ * Adds a flat surcharge per hour beyond a daily threshold.
+ *
+ * @remarks
+ * The surcharge is independent of the member's base rate.
+ *
+ * @category Cost Optimization
+ *
+ * @example
+ * ```typescript
+ * dailyOvertimeSurcharge({ after: 8, amount: 500 })
+ * ```
+ */
+export function dailyOvertimeSurcharge(opts) {
+    return makeCostRule("overtime-daily-surcharge", { ...opts });
+}
+/**
+ * Applies multiple overtime thresholds with increasing multipliers.
+ *
+ * @remarks
+ * Each tier applies only to the hours between its threshold and the next.
+ * Tiers must be sorted by threshold ascending.
+ *
+ * @category Cost Optimization
+ *
+ * @example
+ * ```typescript
+ * // Hours 0-40: base rate
+ * // Hours 40-48: 1.5x
+ * // Hours 48+: 2.0x
+ * tieredOvertimeMultiplier([
+ *   { after: 40, factor: 1.5 },
+ *   { after: 48, factor: 2.0 },
+ * ])
+ * ```
+ */
+export function tieredOvertimeMultiplier(tiers, opts) {
+    return makeCostRule("overtime-tiered-multiplier", { tiers, ...opts });
+}
+//# sourceMappingURL=cost.js.map

package/dist/schedule/cost.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cost.js","sourceRoot":"","sources":["../../src/schedule/cost.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAMH,OAAO,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AA2BxC,+EAA+E;AAC/E,aAAa;AACb,+EAA+E;AAE/E,SAAS,YAAY,CAAC,IAAY,EAAE,MAA+B;IACjE,OAAO,UAAU,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;AAClC,CAAC;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH,MAAM,UAAU,YAAY,CAAC,IAAsB;IACjD,OAAO,YAAY,CAAC,eAAe,EAAE,EAAE,GAAG,IAAI,EAAE,CAAC,CAAC;AACpD,CAAC;AAED;;;;;;;;;;;;;GAaG;AACH,MAAM,UAAU,aAAa,CAAC,MAAc,EAAE,IAAsB;IAClE,OAAO,YAAY,CAAC,qBAAqB,EAAE,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,CAAC,CAAC;AAClE,CAAC;AAED;;;;;;;;;;;;GAYG;AACH,MAAM,UAAU,YAAY,CAAC,aAAqB,EAAE,IAAsB;IACxE,OAAO,YAAY,CAAC,oBAAoB,EAAE,EAAE,aAAa,EAAE,GAAG,IAAI,EAAE,CAAC,CAAC;AACxE,CAAC;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,MAAM,UAAU,aAAa,CAC3B,aAAqB,EACrB,MAA6C,EAC7C,IAAsB;IAEtB,OAAO,YAAY,CAAC,qBAAqB,EAAE,EAAE,aAAa,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,CAAC,CAAC;AACjF,CAAC;AAED;;;;;;;;;;;;;GAaG;AACH,MAAM,UAAU,kBAAkB,CAChC,IAAyD;IAEzD,OAAO,YAAY,CAAC,4BAA4B,EAAE,EAAE,GAAG,IAAI,EAAE,CAAC,CAAC;AACjE,CAAC;AAED;;;;;;;;;;;;GAYG;AACH,MAAM,UAAU,iBAAiB,CAC/B,IAAyD;IAEzD,OAAO,YAAY,CAAC,2BAA2B,EAAE,EAAE,GAAG,IAAI,EAAE,CAAC,CAAC;AAChE,CAAC;AAED;;;;;;;;;;;;;GAaG;AACH,MAAM,UAAU,uBAAuB,CACrC,IAAyD;IAEzD,OAAO,YAAY,CAAC,2BAA2B,EAAE,EAAE,GAAG,IAAI,EAAE,CAAC,CAAC;AAChE,CAAC;AAED;;;;;;;;;;;;GAYG;AACH,MAAM,UAAU,sBAAsB,CACpC,IAAyD;IAEzD,OAAO,YAAY,CAAC,0BAA0B,EAAE,EAAE,GAAG,IAAI,EAAE,CAAC,CAAC;AAC/D,CAAC;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACH,MAAM,UAAU,wBAAwB,CACtC,KAAwC,EACxC,IAAsB;IAEtB,OAAO,YAAY,CAAC,4BAA4B,EAAE,EAAE,KAAK,EAAE,GAAG,IAAI,EAAE,CAAC,CAAC;AACxE,CAAC"}

package/dist/schedule/coverage.d.ts

@@ -0,0 +1,85 @@
+/**
+ * Coverage definitions: staffing requirements per semantic time period.
+ *
+ * @module
+ */
+import type { DayOfWeek } from "../types.js";
+import type { CoverageVariant } from "../cpsat/semantic-time.js";
+import type { Priority } from "../cpsat/types.js";
+export type { CoverageVariant } from "../cpsat/semantic-time.js";
+/**
+ * Options for a {@link cover} call.
+ *
+ * @remarks
+ * Day/date scoping controls which days this coverage entry applies to.
+ * An entry without `dayOfWeek` or `dates` applies every day in the
+ * scheduling period.
+ *
+ * @category Coverage
+ */
+export interface CoverageOptions {
+    /** Additional skill ID filter (AND logic with the target role). */
+    skillIds?: [string, ...string[]];
+    /** Restrict to specific days of the week. */
+    dayOfWeek?: readonly [DayOfWeek, ...DayOfWeek[]];
+    /** Restrict to specific dates (YYYY-MM-DD). */
+    dates?: string[];
+    /** Defaults to `"MANDATORY"`. */
+    priority?: Priority;
+}
+/**
+ * A coverage entry returned by {@link cover}.
+ *
+ * @remarks
+ * Carries the semantic time name and target type information for
+ * compile-time validation by {@link schedule}. This is an opaque
+ * token; pass it directly into the `coverage` array.
+ */
+export interface CoverageEntry<T extends string = string, R extends string = string> {
+    /** @internal */ readonly _type: "coverage";
+    /** @internal */ readonly timeName: T;
+    /** @internal */ readonly target: R | R[];
+    /** @internal */ readonly count: number;
+    /** @internal */ readonly options: CoverageOptions;
+    /** @internal  When present, this entry uses variant-based resolution. */
+    readonly variants?: readonly CoverageVariant[];
+}
+/**
+ * Defines a staffing requirement for a semantic time period.
+ *
+ * @remarks
+ * Entries for the same time and role **stack additively**.
+ * For weekday vs weekend staffing, use mutually exclusive `dayOfWeek`
+ * on both entries.
+ *
+ * @param timeName - Name of a declared semantic time
+ * @param target - Role name (string), array of role names (OR logic), or skill name
+ * @param count - Number of people needed
+ * @param opts - Options: `skillIds` (AND filter), `dayOfWeek`, `dates`, `priority`
+ *
+ * @example
+ * ```typescript
+ * coverage: [
+ *   // 2 waiters during lunch
+ *   cover("lunch", "waiter", 2),
+ *
+ *   // 1 manager OR supervisor during dinner
+ *   cover("dinner", ["manager", "supervisor"], 1),
+ *
+ *   // 1 person with keyholder skill at opening
+ *   cover("opening", "keyholder", 1),
+ *
+ *   // 1 senior waiter (role + skill AND)
+ *   cover("lunch", "waiter", 1, { skillIds: ["senior"] }),
+ *
+ *   // Different counts by day (mutually exclusive dayOfWeek!)
+ *   cover("lunch", "waiter", 2, { dayOfWeek: weekdays }),
+ *   cover("lunch", "waiter", 3, { dayOfWeek: weekend }),
+ * ]
+ * ```
+ *
+ * @category Coverage
+ */
+export declare function cover<T extends string, const R extends string>(timeName: T, target: R | [R, ...R[]], count: number, opts?: CoverageOptions): CoverageEntry<T, R>;
+export declare function cover<T extends string, const R extends string>(timeName: T, target: R | [R, ...R[]], ...variants: [CoverageVariant, ...CoverageVariant[]]): CoverageEntry<T, R>;
+//# sourceMappingURL=coverage.d.ts.map

package/dist/schedule/coverage.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"coverage.d.ts","sourceRoot":"","sources":["../../src/schedule/coverage.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAC7C,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,2BAA2B,CAAC;AACjE,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAElD,YAAY,EAAE,eAAe,EAAE,MAAM,2BAA2B,CAAC;AAEjE;;;;;;;;;GASG;AACH,MAAM,WAAW,eAAe;IAC9B,mEAAmE;IACnE,QAAQ,CAAC,EAAE,CAAC,MAAM,EAAE,GAAG,MAAM,EAAE,CAAC,CAAC;IACjC,6CAA6C;IAC7C,SAAS,CAAC,EAAE,SAAS,CAAC,SAAS,EAAE,GAAG,SAAS,EAAE,CAAC,CAAC;IACjD,+CAA+C;IAC/C,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;IACjB,iCAAiC;IACjC,QAAQ,CAAC,EAAE,QAAQ,CAAC;CACrB;AAED;;;;;;;GAOG;AACH,MAAM,WAAW,aAAa,CAAC,CAAC,SAAS,MAAM,GAAG,MAAM,EAAE,CAAC,SAAS,MAAM,GAAG,MAAM;IACjF,gBAAgB,CAAC,QAAQ,CAAC,KAAK,EAAE,UAAU,CAAC;IAC5C,gBAAgB,CAAC,QAAQ,CAAC,QAAQ,EAAE,CAAC,CAAC;IACtC,gBAAgB,CAAC,QAAQ,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,EAAE,CAAC;IAC1C,gBAAgB,CAAC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACxC,gBAAgB,CAAC,QAAQ,CAAC,OAAO,EAAE,eAAe,CAAC;IACnD,yEAAyE;IACzE,QAAQ,CAAC,QAAQ,CAAC,EAAE,SAAS,eAAe,EAAE,CAAC;CAChD;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAmCG;AACH,wBAAgB,KAAK,CAAC,CAAC,SAAS,MAAM,EAAE,KAAK,CAAC,CAAC,SAAS,MAAM,EAC5D,QAAQ,EAAE,CAAC,EACX,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,EAAE,GAAG,CAAC,EAAE,CAAC,EACvB,KAAK,EAAE,MAAM,EACb,IAAI,CAAC,EAAE,eAAe,GACrB,aAAa,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;AACvB,wBAAgB,KAAK,CAAC,CAAC,SAAS,MAAM,EAAE,KAAK,CAAC,CAAC,SAAS,MAAM,EAC5D,QAAQ,EAAE,CAAC,EACX,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,EAAE,GAAG,CAAC,EAAE,CAAC,EACvB,GAAG,QAAQ,EAAE,CAAC,eAAe,EAAE,GAAG,eAAe,EAAE,CAAC,GACnD,aAAa,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC"}

package/dist/schedule/coverage.js

@@ -0,0 +1,33 @@
+/**
+ * Coverage definitions: staffing requirements per semantic time period.
+ *
+ * @module
+ */
+export function cover(timeName, target, countOrFirstVariant, ...rest) {
+    if (typeof countOrFirstVariant === "number") {
+        // Simple form: cover(time, target, count, opts?)
+        return {
+            _type: "coverage",
+            timeName,
+            target,
+            count: countOrFirstVariant,
+            options: rest[0] ?? {},
+        };
+    }
+    // Variant form: cover(time, target, ...variants)
+    const variants = [countOrFirstVariant, ...rest];
+    const defaults = variants.filter((v) => !v.dayOfWeek && !v.dates);
+    if (defaults.length > 1) {
+        throw new Error("cover() accepts at most one default variant (without dayOfWeek or dates). " +
+            `Found ${defaults.length} default variants.`);
+    }
+    return {
+        _type: "coverage",
+        timeName,
+        target,
+        count: 0,
+        options: {},
+        variants,
+    };
+}
+//# sourceMappingURL=coverage.js.map

package/dist/schedule/coverage.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"coverage.js","sourceRoot":"","sources":["../../src/schedule/coverage.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AA8FH,MAAM,UAAU,KAAK,CACnB,QAAW,EACX,MAAuB,EACvB,mBAA6C,EAC7C,GAAG,IAAe;IAElB,IAAI,OAAO,mBAAmB,KAAK,QAAQ,EAAE,CAAC;QAC5C,iDAAiD;QACjD,OAAO;YACL,KAAK,EAAE,UAAU;YACjB,QAAQ;YACR,MAAM;YACN,KAAK,EAAE,mBAAmB;YAC1B,OAAO,EAAG,IAAI,CAAC,CAAC,CAAiC,IAAI,EAAE;SACxD,CAAC;IACJ,CAAC;IAED,iDAAiD;IACjD,MAAM,QAAQ,GAAG,CAAC,mBAAmB,EAAE,GAAI,IAA0B,CAAC,CAAC;IAEvE,MAAM,QAAQ,GAAG,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,SAAS,IAAI,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC;IAClE,IAAI,QAAQ,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACxB,MAAM,IAAI,KAAK,CACb,4EAA4E;YAC1E,SAAS,QAAQ,CAAC,MAAM,oBAAoB,CAC/C,CAAC;IACJ,CAAC;IAED,OAAO;QACL,KAAK,EAAE,UAAU;QACjB,QAAQ;QACR,MAAM;QACN,KAAK,EAAE,CAAC;QACR,OAAO,EAAE,EAAE;QACX,QAAQ;KACT,CAAC;AACJ,CAAC"}