dabke 0.78.0

package/dist/cpsat/rules/max-shifts-day.d.ts

@@ -0,0 +1,69 @@
+import * as z from "zod";
+import type { CompilationRule } from "../model-builder.js";
+declare const MaxShiftsDaySchema: z.ZodObject<{
+    shifts: z.ZodNumber;
+    priority: z.ZodUnion<readonly [z.ZodLiteral<"LOW">, z.ZodLiteral<"MEDIUM">, z.ZodLiteral<"HIGH">, z.ZodLiteral<"MANDATORY">]>;
+} & {
+    employeeIds: z.ZodOptional<z.ZodArray<z.ZodString>>;
+} & {
+    roleIds: z.ZodOptional<z.ZodArray<z.ZodString>>;
+} & {
+    skillIds: z.ZodOptional<z.ZodArray<z.ZodString>>;
+} & {
+    dateRange: z.ZodOptional<z.ZodObject<{
+        start: z.ZodString;
+        end: z.ZodString;
+    }, z.core.$strip>>;
+} & {
+    specificDates: z.ZodOptional<z.ZodArray<z.ZodString>>;
+} & {
+    dayOfWeek: z.ZodOptional<z.ZodArray<z.ZodUnion<readonly [z.ZodLiteral<"monday">, z.ZodLiteral<"tuesday">, z.ZodLiteral<"wednesday">, z.ZodLiteral<"thursday">, z.ZodLiteral<"friday">, z.ZodLiteral<"saturday">, z.ZodLiteral<"sunday">]>>>;
+} & {
+    recurringPeriods: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        name: z.ZodString;
+        startMonth: z.ZodNumber;
+        startDay: z.ZodNumber;
+        endMonth: z.ZodNumber;
+        endDay: z.ZodNumber;
+    }, z.core.$strip>>>;
+}, z.core.$strip>;
+export type MaxShiftsDayConfig = z.infer<typeof MaxShiftsDaySchema>;
+/**
+ * Limits how many shifts a person can work in a single day.
+ *
+ * This rule controls the maximum number of distinct shift assignments per day,
+ * regardless of shift duration. For limiting total hours worked, use `max-hours-day`.
+ *
+ * Supports entity scoping (people, roles, skills) and time scoping
+ * (date ranges, specific dates, days of week, recurring periods).
+ *
+ * @example Limit to one shift per day (common for most schedules)
+ * ```ts
+ * createMaxShiftsDayRule({
+ *   shifts: 1,
+ *   priority: "MANDATORY",
+ * });
+ * ```
+ *
+ * @example Allow up to two shifts per day for part-time workers
+ * ```ts
+ * createMaxShiftsDayRule({
+ *   roleIds: ["part-time"],
+ *   shifts: 2,
+ *   priority: "HIGH",
+ * });
+ * ```
+ *
+ * @example Students can work 2 shifts on weekends only
+ * ```ts
+ * createMaxShiftsDayRule({
+ *   roleIds: ["student"],
+ *   shifts: 2,
+ *   dayOfWeek: ["saturday", "sunday"],
+ *   priority: "MANDATORY",
+ * });
+ * ```
+ */
+export declare function createMaxShiftsDayRule(config: MaxShiftsDayConfig): CompilationRule;
+export {};
+//# sourceMappingURL=max-shifts-day.d.ts.map

package/dist/cpsat/rules/max-shifts-day.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"max-shifts-day.d.ts","sourceRoot":"","sources":["../../../src/cpsat/rules/max-shifts-day.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,CAAC,MAAM,KAAK,CAAC;AACzB,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AAM3D,QAAA,MAAM,kBAAkB;;;;;;;;;;;;;;;;;;;;;;;;;;iBAcvB,CAAC;AAEF,MAAM,MAAM,kBAAkB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,kBAAkB,CAAC,CAAC;AAEpE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAmCG;AACH,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,kBAAkB,GAAG,eAAe,CAmClF"}

package/dist/cpsat/rules/max-shifts-day.js

@@ -0,0 +1,170 @@
+import * as z from "zod";
+import { parseDayString, priorityToPenalty } from "../utils.js";
+import { normalizeScope, withScopes } from "./scoping.js";
+const MaxShiftsDaySchema = withScopes(z.object({
+    shifts: z.number().int().min(1),
+    priority: z.union([
+        z.literal("LOW"),
+        z.literal("MEDIUM"),
+        z.literal("HIGH"),
+        z.literal("MANDATORY"),
+    ]),
+}), {
+    entities: ["employees", "roles", "skills"],
+    times: ["dateRange", "specificDates", "dayOfWeek", "recurring"],
+});
+/**
+ * Limits how many shifts a person can work in a single day.
+ *
+ * This rule controls the maximum number of distinct shift assignments per day,
+ * regardless of shift duration. For limiting total hours worked, use `max-hours-day`.
+ *
+ * Supports entity scoping (people, roles, skills) and time scoping
+ * (date ranges, specific dates, days of week, recurring periods).
+ *
+ * @example Limit to one shift per day (common for most schedules)
+ * ```ts
+ * createMaxShiftsDayRule({
+ *   shifts: 1,
+ *   priority: "MANDATORY",
+ * });
+ * ```
+ *
+ * @example Allow up to two shifts per day for part-time workers
+ * ```ts
+ * createMaxShiftsDayRule({
+ *   roleIds: ["part-time"],
+ *   shifts: 2,
+ *   priority: "HIGH",
+ * });
+ * ```
+ *
+ * @example Students can work 2 shifts on weekends only
+ * ```ts
+ * createMaxShiftsDayRule({
+ *   roleIds: ["student"],
+ *   shifts: 2,
+ *   dayOfWeek: ["saturday", "sunday"],
+ *   priority: "MANDATORY",
+ * });
+ * ```
+ */
+export function createMaxShiftsDayRule(config) {
+    const parsed = MaxShiftsDaySchema.parse(config);
+    const { shifts, priority } = parsed;
+    return {
+        compile(b) {
+            const scope = normalizeScope(parsed, b.employees);
+            const targetEmployees = resolveEmployees(scope, b.employees);
+            const activeDays = resolveActiveDays(scope, b.days);
+            if (targetEmployees.length === 0 || activeDays.length === 0)
+                return;
+            for (const emp of targetEmployees) {
+                for (const day of activeDays) {
+                    const terms = [];
+                    for (const pattern of b.shiftPatterns) {
+                        if (!b.canAssign(emp, pattern))
+                            continue;
+                        if (!b.patternAvailableOnDay(pattern, day))
+                            continue;
+                        terms.push({
+                            var: b.assignment(emp.id, pattern.id, day),
+                            coeff: 1,
+                        });
+                    }
+                    if (terms.length === 0)
+                        continue;
+                    if (priority === "MANDATORY") {
+                        b.addLinear(terms, "<=", shifts);
+                    }
+                    else {
+                        b.addSoftLinear(terms, "<=", shifts, priorityToPenalty(priority));
+                    }
+                }
+            }
+        },
+    };
+}
+function resolveEmployees(scope, employees) {
+    const entity = scope.entity;
+    switch (entity.type) {
+        case "employees":
+            return employees.filter((e) => entity.employeeIds.includes(e.id));
+        case "roles":
+            return employees.filter((e) => e.roleIds.some((r) => entity.roleIds.includes(r)));
+        case "skills":
+            return employees.filter((e) => e.skillIds?.some((s) => entity.skillIds.includes(s)));
+        case "global":
+        default:
+            return employees;
+    }
+}
+function getDayOfWeekName(dayIndex) {
+    const names = {
+        0: "sunday",
+        1: "monday",
+        2: "tuesday",
+        3: "wednesday",
+        4: "thursday",
+        5: "friday",
+        6: "saturday",
+    };
+    return names[dayIndex % 7] ?? "sunday";
+}
+function resolveActiveDays(scope, allDays) {
+    const timeScope = scope.time;
+    if (!timeScope) {
+        return allDays;
+    }
+    switch (timeScope.type) {
+        case "always":
+            return allDays;
+        case "dateRange": {
+            const start = timeScope.start;
+            const end = timeScope.end;
+            return allDays.filter((day) => day >= start && day <= end);
+        }
+        case "specificDates":
+            return allDays.filter((day) => timeScope.dates.includes(day));
+        case "dayOfWeek": {
+            const targetDays = new Set(timeScope.days);
+            return allDays.filter((day) => {
+                const date = parseDayString(day);
+                const dayName = getDayOfWeekName(date.getUTCDay());
+                return targetDays.has(dayName);
+            });
+        }
+        case "recurring": {
+            return allDays.filter((day) => {
+                const date = parseDayString(day);
+                const month = date.getUTCMonth() + 1;
+                const dayOfMonth = date.getUTCDate();
+                return timeScope.periods.some((period) => isDateInRecurringPeriod(month, dayOfMonth, period));
+            });
+        }
+        default:
+            return allDays;
+    }
+}
+function isDateInRecurringPeriod(month, dayOfMonth, period) {
+    const { startMonth, startDay, endMonth, endDay } = period;
+    if (startMonth <= endMonth) {
+        if (month < startMonth || month > endMonth)
+            return false;
+        if (month === startMonth && dayOfMonth < startDay)
+            return false;
+        if (month === endMonth && dayOfMonth > endDay)
+            return false;
+        return true;
+    }
+    else {
+        if (month > endMonth && month < startMonth)
+            return false;
+        if (month === startMonth && dayOfMonth < startDay)
+            return false;
+        if (month === endMonth && dayOfMonth > endDay)
+            return false;
+        return true;
+    }
+}
+//# sourceMappingURL=max-shifts-day.js.map

package/dist/cpsat/rules/max-shifts-day.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"max-shifts-day.js","sourceRoot":"","sources":["../../../src/cpsat/rules/max-shifts-day.ts"],"names":[],"mappings":"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"}

package/dist/cpsat/rules/min-consecutive-days.d.ts

@@ -0,0 +1,29 @@
+import * as z from "zod";
+import type { CompilationRule } from "../model-builder.js";
+declare const MinConsecutiveDaysSchema: z.ZodObject<{
+    days: z.ZodNumber;
+    priority: z.ZodUnion<readonly [z.ZodLiteral<"LOW">, z.ZodLiteral<"MEDIUM">, z.ZodLiteral<"HIGH">, z.ZodLiteral<"MANDATORY">]>;
+} & {
+    employeeIds: z.ZodOptional<z.ZodArray<z.ZodString>>;
+} & {
+    roleIds: z.ZodOptional<z.ZodArray<z.ZodString>>;
+} & {
+    skillIds: z.ZodOptional<z.ZodArray<z.ZodString>>;
+}, z.core.$strip>;
+export type MinConsecutiveDaysConfig = z.infer<typeof MinConsecutiveDaysSchema>;
+/**
+ * Requires that once a person starts working, they continue for a minimum
+ * number of consecutive days.
+ *
+ * @example
+ * ```ts
+ * const rule = createMinConsecutiveDaysRule({
+ *   days: 3,
+ *   priority: "MANDATORY",
+ * });
+ * builder = new ModelBuilder({ ...config, rules: [rule] });
+ * ```
+ */
+export declare function createMinConsecutiveDaysRule(config: MinConsecutiveDaysConfig): CompilationRule;
+export {};
+//# sourceMappingURL=min-consecutive-days.d.ts.map

package/dist/cpsat/rules/min-consecutive-days.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"min-consecutive-days.d.ts","sourceRoot":"","sources":["../../../src/cpsat/rules/min-consecutive-days.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,CAAC,MAAM,KAAK,CAAC;AACzB,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AAI3D,QAAA,MAAM,wBAAwB;;;;;;;;;iBAW7B,CAAC;AAEF,MAAM,MAAM,wBAAwB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,wBAAwB,CAAC,CAAC;AAEhF;;;;;;;;;;;;GAYG;AACH,wBAAgB,4BAA4B,CAAC,MAAM,EAAE,wBAAwB,GAAG,eAAe,CA0G9F"}

package/dist/cpsat/rules/min-consecutive-days.js

@@ -0,0 +1,104 @@
+import * as z from "zod";
+import { priorityToPenalty } from "../utils.js";
+import { withScopes } from "./scoping.js";
+const MinConsecutiveDaysSchema = withScopes(z.object({
+    days: z.number().min(0),
+    priority: z.union([
+        z.literal("LOW"),
+        z.literal("MEDIUM"),
+        z.literal("HIGH"),
+        z.literal("MANDATORY"),
+    ]),
+}), { entities: ["employees", "roles", "skills"], times: [] });
+/**
+ * Requires that once a person starts working, they continue for a minimum
+ * number of consecutive days.
+ *
+ * @example
+ * ```ts
+ * const rule = createMinConsecutiveDaysRule({
+ *   days: 3,
+ *   priority: "MANDATORY",
+ * });
+ * builder = new ModelBuilder({ ...config, rules: [rule] });
+ * ```
+ */
+export function createMinConsecutiveDaysRule(config) {
+    const { days, priority, employeeIds } = MinConsecutiveDaysSchema.parse(config);
+    return {
+        compile(b) {
+            if (days <= 1)
+                return;
+            const employees = employeeIds
+                ? b.employees.filter((e) => employeeIds.includes(e.id))
+                : b.employees;
+            for (const emp of employees) {
+                const worksByDay = [];
+                for (const day of b.days) {
+                    const worksVar = b.boolVar(`works_${emp.id}_${day}`);
+                    worksByDay.push(worksVar);
+                    const dayAssignments = b.shiftPatterns
+                        .filter((p) => b.canAssign(emp, p) && b.patternAvailableOnDay(p, day))
+                        .map((p) => b.assignment(emp.id, p.id, day));
+                    if (dayAssignments.length === 0) {
+                        b.addLinear([{ var: worksVar, coeff: 1 }], "==", 0);
+                    }
+                    else {
+                        for (const assignVar of dayAssignments) {
+                            b.addLinear([
+                                { var: worksVar, coeff: 1 },
+                                { var: assignVar, coeff: -1 },
+                            ], ">=", 0);
+                        }
+                        b.addLinear([{ var: worksVar, coeff: 1 }, ...dayAssignments.map((v) => ({ var: v, coeff: -1 }))], "<=", 0);
+                    }
+                }
+                for (let i = 0; i < b.days.length; i++) {
+                    const dayLabel = b.days[i];
+                    if (!dayLabel)
+                        continue;
+                    const worksToday = worksByDay[i];
+                    if (!worksToday)
+                        continue;
+                    const worksYesterday = i > 0 ? worksByDay[i - 1] : undefined;
+                    const startVar = b.boolVar(`work_start_${emp.id}_${dayLabel}`);
+                    b.addLinear([
+                        { var: startVar, coeff: 1 },
+                        { var: worksToday, coeff: -1 },
+                    ], "<=", 0);
+                    if (worksYesterday) {
+                        b.addLinear([
+                            { var: startVar, coeff: 1 },
+                            { var: worksYesterday, coeff: 1 },
+                        ], "<=", 1);
+                        b.addLinear([
+                            { var: startVar, coeff: 1 },
+                            { var: worksYesterday, coeff: 1 },
+                            { var: worksToday, coeff: -1 },
+                        ], ">=", 0);
+                    }
+                    else {
+                        b.addLinear([
+                            { var: startVar, coeff: 1 },
+                            { var: worksToday, coeff: -1 },
+                        ], ">=", 0);
+                    }
+                    const window = worksByDay.slice(i, i + days).filter(Boolean);
+                    if (window.length === 0)
+                        continue;
+                    const terms = [
+                        ...window.map((v) => ({ var: v, coeff: 1 })),
+                        { var: startVar, coeff: -days },
+                    ];
+                    if (priority === "MANDATORY") {
+                        b.addLinear(terms, ">=", 0);
+                    }
+                    else {
+                        b.addSoftLinear(terms, ">=", 0, priorityToPenalty(priority));
+                    }
+                }
+            }
+        },
+    };
+}
+//# sourceMappingURL=min-consecutive-days.js.map

package/dist/cpsat/rules/min-consecutive-days.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"min-consecutive-days.js","sourceRoot":"","sources":["../../../src/cpsat/rules/min-consecutive-days.ts"],"names":[],"mappings":"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"}

package/dist/cpsat/rules/min-hours-day.d.ts

@@ -0,0 +1,28 @@
+import * as z from "zod";
+import type { CompilationRule } from "../model-builder.js";
+declare const MinHoursDaySchema: z.ZodObject<{
+    hours: z.ZodNumber;
+    priority: z.ZodUnion<readonly [z.ZodLiteral<"LOW">, z.ZodLiteral<"MEDIUM">, z.ZodLiteral<"HIGH">, z.ZodLiteral<"MANDATORY">]>;
+} & {
+    employeeIds: z.ZodOptional<z.ZodArray<z.ZodString>>;
+} & {
+    roleIds: z.ZodOptional<z.ZodArray<z.ZodString>>;
+} & {
+    skillIds: z.ZodOptional<z.ZodArray<z.ZodString>>;
+}, z.core.$strip>;
+export type MinHoursDayConfig = z.infer<typeof MinHoursDaySchema>;
+/**
+ * Ensures a person works at least a minimum number of hours per day.
+ *
+ * @example
+ * ```ts
+ * const rule = createMinHoursDayRule({
+ *   hours: 6,
+ *   priority: "MANDATORY",
+ * });
+ * builder = new ModelBuilder({ ...config, rules: [rule] });
+ * ```
+ */
+export declare function createMinHoursDayRule(config: MinHoursDayConfig): CompilationRule;
+export {};
+//# sourceMappingURL=min-hours-day.d.ts.map

package/dist/cpsat/rules/min-hours-day.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"min-hours-day.d.ts","sourceRoot":"","sources":["../../../src/cpsat/rules/min-hours-day.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,CAAC,MAAM,KAAK,CAAC;AACzB,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AAK3D,QAAA,MAAM,iBAAiB;;;;;;;;;iBAWtB,CAAC;AAEF,MAAM,MAAM,iBAAiB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,iBAAiB,CAAC,CAAC;AAElE;;;;;;;;;;;GAWG;AACH,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,iBAAiB,GAAG,eAAe,CAmChF"}

package/dist/cpsat/rules/min-hours-day.js

@@ -0,0 +1,61 @@
+import * as z from "zod";
+import { priorityToPenalty } from "../utils.js";
+import { withScopes } from "./scoping.js";
+const MinHoursDaySchema = withScopes(z.object({
+    hours: z.number().min(0),
+    priority: z.union([
+        z.literal("LOW"),
+        z.literal("MEDIUM"),
+        z.literal("HIGH"),
+        z.literal("MANDATORY"),
+    ]),
+}), { entities: ["employees", "roles", "skills"], times: [] });
+/**
+ * Ensures a person works at least a minimum number of hours per day.
+ *
+ * @example
+ * ```ts
+ * const rule = createMinHoursDayRule({
+ *   hours: 6,
+ *   priority: "MANDATORY",
+ * });
+ * builder = new ModelBuilder({ ...config, rules: [rule] });
+ * ```
+ */
+export function createMinHoursDayRule(config) {
+    const { hours, priority, employeeIds } = MinHoursDaySchema.parse(config);
+    const minMinutes = hours * 60;
+    return {
+        compile(b) {
+            if (hours <= 0)
+                return;
+            const employees = employeeIds
+                ? b.employees.filter((e) => employeeIds.includes(e.id))
+                : b.employees;
+            for (const emp of employees) {
+                for (const day of b.days) {
+                    const terms = [];
+                    for (const pattern of b.shiftPatterns) {
+                        if (!b.canAssign(emp, pattern))
+                            continue;
+                        if (!b.patternAvailableOnDay(pattern, day))
+                            continue;
+                        terms.push({
+                            var: b.assignment(emp.id, pattern.id, day),
+                            coeff: b.patternDuration(pattern.id),
+                        });
+                    }
+                    if (terms.length === 0)
+                        continue;
+                    if (priority === "MANDATORY") {
+                        b.addLinear(terms, ">=", minMinutes);
+                    }
+                    else {
+                        b.addSoftLinear(terms, ">=", minMinutes, priorityToPenalty(priority));
+                    }
+                }
+            }
+        },
+    };
+}
+//# sourceMappingURL=min-hours-day.js.map

package/dist/cpsat/rules/min-hours-day.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"min-hours-day.js","sourceRoot":"","sources":["../../../src/cpsat/rules/min-hours-day.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,CAAC,MAAM,KAAK,CAAC;AAGzB,OAAO,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAChD,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAE1C,MAAM,iBAAiB,GAAG,UAAU,CAClC,CAAC,CAAC,MAAM,CAAC;IACP,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IACxB,QAAQ,EAAE,CAAC,CAAC,KAAK,CAAC;QAChB,CAAC,CAAC,OAAO,CAAC,KAAK,CAAC;QAChB,CAAC,CAAC,OAAO,CAAC,QAAQ,CAAC;QACnB,CAAC,CAAC,OAAO,CAAC,MAAM,CAAC;QACjB,CAAC,CAAC,OAAO,CAAC,WAAW,CAAC;KACvB,CAAC;CACH,CAAC,EACF,EAAE,QAAQ,EAAE,CAAC,WAAW,EAAE,OAAO,EAAE,QAAQ,CAAC,EAAE,KAAK,EAAE,EAAE,EAAE,CAC1D,CAAC;AAIF;;;;;;;;;;;GAWG;AACH,MAAM,UAAU,qBAAqB,CAAC,MAAyB;IAC7D,MAAM,EAAE,KAAK,EAAE,QAAQ,EAAE,WAAW,EAAE,GAAG,iBAAiB,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;IACzE,MAAM,UAAU,GAAG,KAAK,GAAG,EAAE,CAAC;IAE9B,OAAO;QACL,OAAO,CAAC,CAAC;YACP,IAAI,KAAK,IAAI,CAAC;gBAAE,OAAO;YAEvB,MAAM,SAAS,GAAG,WAAW;gBAC3B,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,WAAW,CAAC,QAAQ,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;gBACvD,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;YAEhB,KAAK,MAAM,GAAG,IAAI,SAAS,EAAE,CAAC;gBAC5B,KAAK,MAAM,GAAG,IAAI,CAAC,CAAC,IAAI,EAAE,CAAC;oBACzB,MAAM,KAAK,GAAW,EAAE,CAAC;oBACzB,KAAK,MAAM,OAAO,IAAI,CAAC,CAAC,aAAa,EAAE,CAAC;wBACtC,IAAI,CAAC,CAAC,CAAC,SAAS,CAAC,GAAG,EAAE,OAAO,CAAC;4BAAE,SAAS;wBACzC,IAAI,CAAC,CAAC,CAAC,qBAAqB,CAAC,OAAO,EAAE,GAAG,CAAC;4BAAE,SAAS;wBACrD,KAAK,CAAC,IAAI,CAAC;4BACT,GAAG,EAAE,CAAC,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,EAAE,OAAO,CAAC,EAAE,EAAE,GAAG,CAAC;4BAC1C,KAAK,EAAE,CAAC,CAAC,eAAe,CAAC,OAAO,CAAC,EAAE,CAAC;yBACrC,CAAC,CAAC;oBACL,CAAC;oBAED,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC;wBAAE,SAAS;oBAEjC,IAAI,QAAQ,KAAK,WAAW,EAAE,CAAC;wBAC7B,CAAC,CAAC,SAAS,CAAC,KAAK,EAAE,IAAI,EAAE,UAAU,CAAC,CAAC;oBACvC,CAAC;yBAAM,CAAC;wBACN,CAAC,CAAC,aAAa,CAAC,KAAK,EAAE,IAAI,EAAE,UAAU,EAAE,iBAAiB,CAAC,QAAQ,CAAC,CAAC,CAAC;oBACxE,CAAC;gBACH,CAAC;YACH,CAAC;QACH,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/cpsat/rules/min-hours-week.d.ts

@@ -0,0 +1,29 @@
+import * as z from "zod";
+import type { CompilationRule } from "../model-builder.js";
+declare const MinHoursWeekSchema: z.ZodObject<{
+    hours: z.ZodNumber;
+    priority: z.ZodUnion<readonly [z.ZodLiteral<"LOW">, z.ZodLiteral<"MEDIUM">, z.ZodLiteral<"HIGH">, z.ZodLiteral<"MANDATORY">]>;
+    weekStartsOn: z.ZodOptional<z.ZodUnion<readonly [z.ZodLiteral<"monday">, z.ZodLiteral<"tuesday">, z.ZodLiteral<"wednesday">, z.ZodLiteral<"thursday">, z.ZodLiteral<"friday">, z.ZodLiteral<"saturday">, z.ZodLiteral<"sunday">]>>;
+} & {
+    employeeIds: z.ZodOptional<z.ZodArray<z.ZodString>>;
+} & {
+    roleIds: z.ZodOptional<z.ZodArray<z.ZodString>>;
+} & {
+    skillIds: z.ZodOptional<z.ZodArray<z.ZodString>>;
+}, z.core.$strip>;
+export type MinHoursWeekConfig = z.infer<typeof MinHoursWeekSchema>;
+/**
+ * Enforces a minimum total number of hours per scheduling week.
+ *
+ * @example
+ * ```ts
+ * const rule = createMinHoursWeekRule({
+ *   hours: 30,
+ *   priority: "HIGH",
+ * });
+ * builder = new ModelBuilder({ ...config, rules: [rule] });
+ * ```
+ */
+export declare function createMinHoursWeekRule(config: MinHoursWeekConfig): CompilationRule;
+export {};
+//# sourceMappingURL=min-hours-week.d.ts.map

package/dist/cpsat/rules/min-hours-week.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"min-hours-week.d.ts","sourceRoot":"","sources":["../../../src/cpsat/rules/min-hours-week.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,CAAC,MAAM,KAAK,CAAC;AAEzB,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AAK3D,QAAA,MAAM,kBAAkB;;;;;;;;;;iBAavB,CAAC;AAEF,MAAM,MAAM,kBAAkB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,kBAAkB,CAAC,CAAC;AAEpE;;;;;;;;;;;GAWG;AACH,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,kBAAkB,GAAG,eAAe,CAwClF"}

package/dist/cpsat/rules/min-hours-week.js

@@ -0,0 +1,68 @@
+import * as z from "zod";
+import { DayOfWeekSchema } from "../../types.js";
+import { priorityToPenalty, splitIntoWeeks } from "../utils.js";
+import { withScopes } from "./scoping.js";
+const MinHoursWeekSchema = withScopes(z.object({
+    hours: z.number().min(0),
+    priority: z.union([
+        z.literal("LOW"),
+        z.literal("MEDIUM"),
+        z.literal("HIGH"),
+        z.literal("MANDATORY"),
+    ]),
+    // Optional override; defaults to ModelBuilder.weekStartsOn
+    weekStartsOn: DayOfWeekSchema.optional(),
+}), { entities: ["employees", "roles", "skills"], times: [] });
+/**
+ * Enforces a minimum total number of hours per scheduling week.
+ *
+ * @example
+ * ```ts
+ * const rule = createMinHoursWeekRule({
+ *   hours: 30,
+ *   priority: "HIGH",
+ * });
+ * builder = new ModelBuilder({ ...config, rules: [rule] });
+ * ```
+ */
+export function createMinHoursWeekRule(config) {
+    const parsed = MinHoursWeekSchema.parse(config);
+    const { hours, priority, employeeIds } = parsed;
+    const minMinutes = hours * 60;
+    return {
+        compile(b) {
+            if (hours <= 0)
+                return;
+            const employees = employeeIds
+                ? b.employees.filter((e) => employeeIds.includes(e.id))
+                : b.employees;
+            const weeks = splitIntoWeeks(b.days, parsed.weekStartsOn ?? b.weekStartsOn);
+            for (const emp of employees) {
+                for (const weekDays of weeks) {
+                    const terms = [];
+                    for (const day of weekDays) {
+                        for (const pattern of b.shiftPatterns) {
+                            if (!b.canAssign(emp, pattern))
+                                continue;
+                            if (!b.patternAvailableOnDay(pattern, day))
+                                continue;
+                            terms.push({
+                                var: b.assignment(emp.id, pattern.id, day),
+                                coeff: b.patternDuration(pattern.id),
+                            });
+                        }
+                    }
+                    if (terms.length === 0)
+                        continue;
+                    if (priority === "MANDATORY") {
+                        b.addLinear(terms, ">=", minMinutes);
+                    }
+                    else {
+                        b.addSoftLinear(terms, ">=", minMinutes, priorityToPenalty(priority));
+                    }
+                }
+            }
+        },
+    };
+}
+//# sourceMappingURL=min-hours-week.js.map

package/dist/cpsat/rules/min-hours-week.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"min-hours-week.js","sourceRoot":"","sources":["../../../src/cpsat/rules/min-hours-week.ts"],"names":[],"mappings":"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"}

package/dist/cpsat/rules/min-rest-between-shifts.d.ts

@@ -0,0 +1,28 @@
+import * as z from "zod";
+import type { CompilationRule } from "../model-builder.js";
+export type MinRestBetweenShiftsConfig = z.infer<typeof MinRestBetweenShiftsSchema>;
+declare const MinRestBetweenShiftsSchema: z.ZodObject<{
+    hours: z.ZodNumber;
+    priority: z.ZodUnion<readonly [z.ZodLiteral<"LOW">, z.ZodLiteral<"MEDIUM">, z.ZodLiteral<"HIGH">, z.ZodLiteral<"MANDATORY">]>;
+} & {
+    employeeIds: z.ZodOptional<z.ZodArray<z.ZodString>>;
+} & {
+    roleIds: z.ZodOptional<z.ZodArray<z.ZodString>>;
+} & {
+    skillIds: z.ZodOptional<z.ZodArray<z.ZodString>>;
+}, z.core.$strip>;
+/**
+ * Enforces a minimum rest period between any two shifts a person works.
+ *
+ * @example
+ * ```ts
+ * const rule = createMinRestBetweenShiftsRule({
+ *   hours: 10,
+ *   priority: "MANDATORY",
+ * });
+ * builder = new ModelBuilder({ ...config, rules: [rule] });
+ * ```
+ */
+export declare function createMinRestBetweenShiftsRule(config: MinRestBetweenShiftsConfig): CompilationRule;
+export {};
+//# sourceMappingURL=min-rest-between-shifts.d.ts.map

package/dist/cpsat/rules/min-rest-between-shifts.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"min-rest-between-shifts.d.ts","sourceRoot":"","sources":["../../../src/cpsat/rules/min-rest-between-shifts.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,CAAC,MAAM,KAAK,CAAC;AACzB,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AAI3D,MAAM,MAAM,0BAA0B,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,0BAA0B,CAAC,CAAC;AAEpF,QAAA,MAAM,0BAA0B;;;;;;;;;iBAW/B,CAAC;AAEF;;;;;;;;;;;GAWG;AACH,wBAAgB,8BAA8B,CAC5C,MAAM,EAAE,0BAA0B,GACjC,eAAe,CAsFjB"}