dabke 0.81.1 → 0.83.0

package/dist/datetime.utils.js

@@ -1,36 +1,3 @@
-/**
- * Converts a JavaScript Date to a CalendarDate
- */
-export function dateToCalendarDate(date) {
-    return {
-        year: date.getFullYear(),
-        month: date.getMonth() + 1, // JS months are 0-indexed
-        day: date.getDate(),
-    };
-}
-/**
- * Converts a DateTime to a JavaScript Date
- * Internal helper function
- */
-export function dateTimeToDate(dateTime) {
-    return new Date(dateTime.year || 0, (dateTime.month || 1) - 1, dateTime.day || 1, dateTime.hours || 0, dateTime.minutes || 0, dateTime.seconds || 0);
-}
-/**
- * Compares two DateTimes
- * Returns:
- *  -1 if dateTime1 < dateTime2
- *   0 if dateTime1 = dateTime2
- *   1 if dateTime1 > dateTime2
- */
-export function compareDateTimes(dateTime1, dateTime2) {
-    const date1 = dateTimeToDate(dateTime1);
-    const date2 = dateTimeToDate(dateTime2);
-    if (date1 < date2)
-        return -1;
-    if (date1 > date2)
-        return 1;
-    return 0;
-}
 export const DAY_OF_WEEK_MAP = {
     sunday: 0, // JavaScript Date week starts on Sunday
     monday: 1,
@@ -50,267 +17,13 @@ const DAY_NAMES = [
     "saturday",
 ];
 /**
- * Helper to get the day of week name from a Date (local time)
- */
-export function toDayOfWeek(date) {
-    // getDay() always returns 0-6
-    return DAY_NAMES[date.getDay()];
-}
-/**
- * Helper to get the day of week name from a Date (UTC)
+ * Helper to get the day of week name from a Date (UTC).
  * Use this when working with date strings like "2026-01-10" that are timezone-agnostic.
  */
 export function toDayOfWeekUTC(date) {
     // getUTCDay() always returns 0-6
     return DAY_NAMES[date.getUTCDay()];
 }
-/**
- * Formats a date as YYYY-MM-DD string
- */
-export function formatDateString(date) {
-    const year = date.getFullYear();
-    const month = (date.getMonth() + 1).toString().padStart(2, "0");
-    const day = date.getDate().toString().padStart(2, "0");
-    return `${year}-${month}-${day}`;
-}
-/**
- * Generates an array of day strings (YYYY-MM-DD) from a time horizon.
- *
- * @param horizon - The time horizon with start (inclusive) and end (inclusive) dates
- * @returns Array of day strings in YYYY-MM-DD format
- *
- * @example
- * ```typescript
- * const days = generateDays({
- *   start: new Date('2025-01-01'),
- *   end: new Date('2025-01-04')
- * });
- * // Returns: ["2025-01-01", "2025-01-02", "2025-01-03", "2025-01-04"]
- * ```
- */
-export function generateDays(horizon) {
-    const days = [];
-    const current = new Date(horizon.start);
-    while (current <= horizon.end) {
-        days.push(formatDateString(current));
-        current.setDate(current.getDate() + 1);
-    }
-    return days;
-}
-/**
- * Splits a time period into consecutive day ranges.
- *
- * Each range represents a single calendar day within the period from start to end.
- * This is useful for rules that need to apply constraints on a per-day basis,
- * such as maximum or minimum hours per day.
- *
- * @param start - The start date of the period (inclusive)
- * @param end - The end date of the period (exclusive)
- * @returns An array of [startDate, endDate] tuples, where each tuple represents
- * a single day. The last range's end date will be the provided end date.
- *
- * @example
- * ```typescript
- * const ranges = splitPeriodIntoDays({
- *   start: new Date('2025-01-01'),
- *   end: new Date('2025-01-03')
- * });
- * // Returns:
- * // [
- * //   [Date('2025-01-01'), Date('2025-01-02')],
- * //   [Date('2025-01-02'), Date('2025-01-03')]
- * // ]
- * ```
- */
-export function splitPeriodIntoDays({ start, end }) {
-    const ranges = [];
-    let leftBound = new Date(start);
-    let done = false;
-    // Loop through each day
-    leftBound = new Date(start);
-    while (!done) {
-        // Create next day date
-        let rightBound = new Date(leftBound);
-        rightBound.setDate(rightBound.getDate() + 1);
-        if (rightBound >= end) {
-            rightBound = end;
-            done = true;
-        }
-        ranges.push([leftBound, rightBound]);
-        leftBound = rightBound;
-    }
-    return ranges;
-}
-/**
- * Splits a time period into consecutive week ranges.
- *
- * Each range represents a week period starting on the specified day of the week.
- * This is useful for rules that need to apply constraints on a per-week basis,
- * such as maximum or minimum hours per week.
- *
- * The first range starts at the provided start date (not necessarily on weekStartsOn).
- * Subsequent ranges align to the weekStartsOn day. The last range's end date will be
- * the provided end date.
- *
- * @param start - The start date of the period (inclusive)
- * @param end - The end date of the period (exclusive)
- * @param weekStartsOn - The day of the week that weeks start on (e.g., "monday", "sunday")
- * @returns An array of [startDate, endDate] tuples, where each tuple represents
- * a week period aligned to the specified week start day.
- *
- * @example
- * ```typescript
- * const ranges = splitPeriodIntoWeeks({
- *   start: new Date('2025-01-01'), // Wednesday
- *   end: new Date('2025-01-15'),
- *   weekStartsOn: 'monday'
- * });
- * // Returns ranges starting from Jan 1 (Wed), then aligning to Mondays:
- * // [
- * //   [Date('2025-01-01 Wed'), Date('2025-01-06 Mon')],
- * //   [Date('2025-01-06 Mon'), Date('2025-01-13 Mon')],
- * //   [Date('2025-01-13 Mon'), Date('2025-01-15 Wed')]
- * // ]
- * ```
- */
-export function splitPeriodIntoWeeks({ start, end, weekStartsOn, }) {
-    const DAYS_OF_WEEK = [
-        "sunday",
-        "monday",
-        "tuesday",
-        "wednesday",
-        "thursday",
-        "friday",
-        "saturday",
-    ];
-    const ranges = [];
-    let leftBound = new Date(start);
-    let done = false;
-    const startDayIndex = DAYS_OF_WEEK.indexOf(weekStartsOn);
-    // Create weekly ranges
-    while (!done) {
-        const dayOfWeek = leftBound.getDay(); // 0 = Sunday, 1 = Monday, etc.
-        const daysToNextWeek = (7 - ((dayOfWeek - startDayIndex) % 7)) % 7;
-        const daysToAdd = daysToNextWeek === 0 ? 7 : daysToNextWeek;
-        let rightBound = new Date(leftBound);
-        rightBound.setDate(rightBound.getDate() + daysToAdd);
-        if (rightBound >= end) {
-            rightBound = end;
-            done = true;
-        }
-        ranges.push([leftBound, rightBound]);
-        leftBound = rightBound;
-    }
-    return ranges;
-}
-/**
- * Checks if two DateTime ranges overlap in both date and time.
- * Ranges overlap if they share any moment in time.
- *
- * Two ranges overlap if: range1.start < range2.end AND range2.start < range1.end
- *
- * @param range1 First time range with start (inclusive) and end (exclusive)
- * @param range2 Second time range with start (inclusive) and end (exclusive)
- * @returns true if ranges overlap, false otherwise
- *
- * @example
- * ```typescript
- * // Same day, overlapping times (9-17 overlaps with 12-20)
- * dateTimeRangesOverlap(
- *   {
- *     start: { year: 2025, month: 6, day: 1, hours: 9, minutes: 0 },
- *     end: { year: 2025, month: 6, day: 1, hours: 17, minutes: 0 }
- *   },
- *   {
- *     start: { year: 2025, month: 6, day: 1, hours: 12, minutes: 0 },
- *     end: { year: 2025, month: 6, day: 1, hours: 20, minutes: 0 }
- *   }
- * ); // true
- *
- * // Different days - no overlap
- * dateTimeRangesOverlap(
- *   {
- *     start: { year: 2025, month: 6, day: 1, hours: 9, minutes: 0 },
- *     end: { year: 2025, month: 6, day: 1, hours: 17, minutes: 0 }
- *   },
- *   {
- *     start: { year: 2025, month: 6, day: 2, hours: 9, minutes: 0 },
- *     end: { year: 2025, month: 6, day: 2, hours: 17, minutes: 0 }
- *   }
- * ); // false
- *
- * // Works naturally with Shift objects
- * dateTimeRangesOverlap(
- *   { start: shift1.startDateTime, end: shift1.endDateTime },
- *   { start: shift2.startDateTime, end: shift2.endDateTime }
- * );
- * ```
- */
-export function dateTimeRangesOverlap(range1, range2) {
-    // Use existing compareDateTimes for temporal comparison
-    // Ranges overlap if: start1 < end2 AND start2 < end1
-    return (compareDateTimes(range1.start, range2.end) < 0 && compareDateTimes(range2.start, range1.end) < 0);
-}
-/**
- * Calculates the number of complete days between two dates
- * @param start The start date
- * @param end The end date
- * @returns Number of complete days from start to end (can be negative if end < start)
- *
- * @example
- * ```typescript
- * daysBetween(new Date('2025-01-01'), new Date('2025-01-05')); // 4
- * ```
- */
-export function daysBetween(start, end) {
-    const ms = end.getTime() - start.getTime();
-    return Math.floor(ms / (1000 * 60 * 60 * 24));
-}
-/**
- * Adds a number of minutes to a base date and returns a DateTime.
- * Treats the base date as a reference point (typically midnight of horizon start),
- * and the minutes parameter as absolute minutes from that point.
- *
- * @param baseDate The starting date (used as reference point)
- * @param minutes Absolute minutes from the base date
- * @returns DateTime representing the result
- *
- * @example
- * ```typescript
- * // Add 90 minutes from midnight
- * addMinutesToDate(new Date('2025-01-01'), 90);
- * // Returns: { year: 2025, month: 1, day: 1, hours: 1, minutes: 30 }
- *
- * // Add 1500 minutes (spans to next day)
- * addMinutesToDate(new Date('2025-01-01'), 1500);
- * // Returns: { year: 2025, month: 1, day: 2, hours: 1, minutes: 0 }
- * ```
- */
-export function addMinutesToDate(baseDate, minutes) {
-    const days = Math.floor(minutes / 1440);
-    const minutesInDay = minutes % 1440;
-    const targetDate = new Date(baseDate);
-    targetDate.setDate(targetDate.getDate() + days);
-    return {
-        year: targetDate.getFullYear(),
-        month: targetDate.getMonth() + 1,
-        day: targetDate.getDate(),
-        hours: Math.floor(minutesInDay / 60),
-        minutes: minutesInDay % 60,
-    };
-}
-/**
- * Returns the points where a range should be split, filtered to within [start, end).
- * Always includes range start. Sorted ascending.
- */
-export function splitPoints([start, end], splitAt) {
-    const points = new Set([start]);
-    for (const p of splitAt) {
-        if (p > start && p < end)
-            points.add(p);
-    }
-    return [...points].toSorted((a, b) => a - b);
-}
 /**
  * Computes the list of day strings (YYYY-MM-DD) from a SchedulingPeriod.
  *

package/dist/datetime.utils.js.map

@@ -1 +1 @@
-{"version":3,"file":"datetime.utils.js","sourceRoot":"","sources":["../src/datetime.utils.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"datetime.utils.js","sourceRoot":"","sources":["../src/datetime.utils.ts"],"names":[],"mappings":"AAEA,MAAM,CAAC,MAAM,eAAe,GAA8B;IACxD,MAAM,EAAE,CAAC,EAAE,wCAAwC;IACnD,MAAM,EAAE,CAAC;IACT,OAAO,EAAE,CAAC;IACV,SAAS,EAAE,CAAC;IACZ,QAAQ,EAAE,CAAC;IACX,MAAM,EAAE,CAAC;IACT,QAAQ,EAAE,CAAC;CACZ,CAAC;AAEF,MAAM,SAAS,GAAG;IAChB,QAAQ;IACR,QAAQ;IACR,SAAS;IACT,WAAW;IACX,UAAU;IACV,QAAQ;IACR,UAAU;CACF,CAAC;AAEX;;;GAGG;AACH,MAAM,UAAU,cAAc,CAAC,IAAU;IACvC,iCAAiC;IACjC,OAAO,SAAS,CAAC,IAAI,CAAC,SAAS,EAAE,CAAc,CAAC;AAClD,CAAC;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAmCG;AACH,MAAM,UAAU,qBAAqB,CAAC,MAAwB;IAC5D,MAAM,EAAE,SAAS,EAAE,SAAS,EAAE,KAAK,EAAE,GAAG,MAAM,CAAC;IAC/C,MAAM,WAAW,GAAG,SAAS,CAAC,CAAC,CAAC,IAAI,GAAG,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;IAC1D,MAAM,YAAY,GAAG,KAAK,CAAC,CAAC,CAAC,IAAI,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;IAEnD,MAAM,SAAS,GAAG,IAAI,IAAI,CAAC,GAAG,SAAS,CAAC,KAAK,YAAY,CAAC,CAAC;IAC3D,MAAM,OAAO,GAAG,IAAI,IAAI,CAAC,GAAG,SAAS,CAAC,GAAG,YAAY,CAAC,CAAC;IACvD,MAAM,MAAM,GAAa,EAAE,CAAC;IAE5B,MAAM,OAAO,GAAG,IAAI,IAAI,CAAC,SAAS,CAAC,CAAC;IACpC,OAAO,OAAO,IAAI,OAAO,EAAE,CAAC;QAC1B,MAAM,IAAI,GAAG,OAAO,CAAC,cAAc,EAAE,CAAC;QACtC,MAAM,KAAK,GAAG,CAAC,OAAO,CAAC,WAAW,EAAE,GAAG,CAAC,CAAC,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC;QACtE,MAAM,GAAG,GAAG,OAAO,CAAC,UAAU,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC;QAC7D,MAAM,GAAG,GAAG,GAAG,IAAI,IAAI,KAAK,IAAI,GAAG,EAAE,CAAC;QACtC,MAAM,GAAG,GAAG,cAAc,CAAC,OAAO,CAAC,CAAC;QAEpC,IAAI,CAAC,CAAC,WAAW,IAAI,WAAW,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,CAAC,YAAY,IAAI,YAAY,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC;YACvF,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QACnB,CAAC;QAED,OAAO,CAAC,UAAU,CAAC,OAAO,CAAC,UAAU,EAAE,GAAG,CAAC,CAAC,CAAC;IAC/C,CAAC;IAED,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/dist/index.d.ts

@@ -1,15 +1,12 @@
 /**
  * Scheduling library powered by constraint programming (CP-SAT).
  *
- * Define teams, shifts, coverage, and rules declaratively. dabke compiles
- * them into a constraint model and solves for an optimized schedule.
- *
  * @remarks
  * ## Core Concepts
  *
- * **Schedule Definition**: The primary API. Small, composable functions
+ * **Schedule**: The primary API. Small, composable functions
  * ({@link time}, {@link cover}, {@link shift}, rule functions) produce a
- * complete scheduling configuration via {@link defineSchedule}. Each concept
+ * complete scheduling configuration via {@link schedule}. Each concept
  * is a single function call with full type safety.
  *
  * **Times vs Shift Patterns**: These are two distinct concepts.
@@ -28,97 +25,31 @@
  * - Scoping: apply rules globally, per person, per role, per skill, or per time period
  * - Priority: `MANDATORY` (hard constraint) vs `LOW`/`MEDIUM`/`HIGH` (soft preferences)
  *
- * **Solving**: {@link ScheduleDefinition.createSchedulerConfig} merges the
- * static definition with runtime data (members, scheduling period).
- * {@link ModelBuilder} compiles the config into a solver request;
- * {@link HttpSolverClient} sends it to the CP-SAT solver.
- *
- * @example Define a schedule
- * ```typescript
- * import {
- *   defineSchedule, t, time, cover, shift,
- *   maxHoursPerWeek, minRestBetweenShifts, timeOff,
- *   weekdays, weekend,
- * } from "dabke";
- *
- * const schedule = defineSchedule({
- *   roles: ["nurse", "doctor"],
- *   skills: ["charge_nurse"],
- *
- *   times: {
- *     morning_round: time({ startTime: t(7), endTime: t(9) }),
- *     day_ward: time({ startTime: t(7), endTime: t(15) }),
- *     night_ward: time({ startTime: t(23), endTime: t(7) }),
- *   },
- *
- *   coverage: [
- *     cover("morning_round", "doctor", 1),
- *     cover("day_ward", "nurse", 3, { dayOfWeek: weekdays }),
- *     cover("day_ward", "nurse", 2, { dayOfWeek: weekend }),
- *     cover("night_ward", "nurse", 2),
- *     cover("night_ward", "charge_nurse", 1),
- *   ],
- *
- *   shiftPatterns: [
- *     shift("day", t(7), t(15)),
- *     shift("night", t(23), t(7)),
- *   ],
- *
- *   rules: [
- *     maxHoursPerWeek(40),
- *     minRestBetweenShifts(11),
- *     timeOff({ appliesTo: "alice", dayOfWeek: weekend }),
- *   ],
- * });
- * ```
- *
- * @example Solve a schedule
- * ```typescript
- * import { ModelBuilder, HttpSolverClient, parseSolverResponse } from "dabke";
- *
- * const config = schedule.createSchedulerConfig({
- *   schedulingPeriod: {
- *     dateRange: { start: "2026-02-09", end: "2026-02-15" },
- *   },
- *   members: [
- *     { id: "alice", roles: ["nurse"], skills: ["charge_nurse"] },
- *     { id: "bob", roles: ["nurse"] },
- *     { id: "carol", roles: ["doctor"] },
- *   ],
- * });
- *
- * const builder = new ModelBuilder(config);
- * const { request, canSolve, validation } = builder.compile();
- * if (canSolve) {
- *   const client = new HttpSolverClient(fetch, "http://localhost:8080");
- *   const response = await client.solve(request);
- *   const result = parseSolverResponse(response);
- * }
- * ```
+ * **Solving**: {@link Schedule.compile} compiles the config into a
+ * solver request; {@link Schedule.solve} sends it to the CP-SAT solver
+ * and returns a {@link SolveResult}.
  *
  * @packageDocumentation
  */
-export type { TimeOfDay, DayOfWeek, DateTime, SchedulingPeriod } from "./types.js";
+export type { TimeOfDay, DayOfWeek, SchedulingPeriod } from "./types.js";
 export { DayOfWeekSchema } from "./types.js";
-export { dateTimeToDate } from "./datetime.utils.js";
-export { ORSchedulingError } from "./errors.js";
 export { HttpSolverClient } from "./client.js";
 export type { SolverClient, SolverRequest, SolverResponse, SolverStatus, SoftConstraintViolation, FetcherLike, } from "./client.types.js";
 export { SOLVER_STATUS } from "./client.types.js";
 export { SolverRequestSchema, SolverResponseSchema, SolverStatusSchema } from "./client.schemas.js";
 export { ModelBuilder } from "./cpsat/model-builder.js";
-export type { ModelBuilderConfig, CompilationResult, CompilationRule, RuleValidationContext, CostContext, CostEntry, CostContribution, } from "./cpsat/model-builder.js";
+export type { ModelBuilderConfig, CompilationResult, CompilationRule, RuleValidationContext, CostEntry, CostContribution, } from "./cpsat/model-builder.js";
 export { parseSolverResponse, resolveAssignments } from "./cpsat/response.js";
 export type { ShiftAssignment, ResolvedShiftAssignment, SolverResult } from "./cpsat/response.js";
-export type { CpsatRuleRegistry, CpsatRuleName, CpsatRuleConfigEntry, CpsatRuleFactories, } from "./cpsat/rules/rules.types.js";
+export { calculateScheduleCost, COST_CATEGORY } from "./cpsat/cost.js";
+export type { CostBreakdown, MemberCostDetail, CostCalculationConfig } from "./cpsat/cost.js";
+export type { CpsatRuleConfigEntry, CpsatRuleFactories, CreateCpsatRuleFunction, } from "./cpsat/rules/rules.types.js";
 export type { RecurringPeriod } from "./cpsat/rules/scope.types.js";
 export type { OvertimeTier } from "./cpsat/rules/overtime-tiered-multiplier.js";
-export type { HourlyPay, SalariedPay, SchedulingMember, ShiftPattern, CoverageRequirement, Priority, ModelBuilderOptions, } from "./cpsat/types.js";
+export type { HourlyPay, SalariedPay, SchedulingMember, ShiftPattern, Priority, } from "./cpsat/types.js";
 export { OBJECTIVE_WEIGHTS } from "./cpsat/utils.js";
-export type { ValidationReporter } from "./cpsat/validation-reporter.js";
-export type { ScheduleValidation, ScheduleError, ScheduleViolation, SchedulePassed, CoverageError, CoverageViolation, CoveragePassed, RuleError, RuleViolation, RulePassed, SolverError, ValidationContext, ValidationSummary, GroupKey, } from "./cpsat/validation.types.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 { groupKey } from "./cpsat/validation.types.js";
-export { defineSchedule, t, time, cover, shift, maxHoursPerDay, maxHoursPerWeek, minHoursPerDay, minHoursPerWeek, maxShiftsPerDay, maxConsecutiveDays, minConsecutiveDays, minRestBetweenShifts, preference, preferLocation, timeOff, assignTogether, minimizeCost, dayMultiplier, daySurcharge, timeSurcharge, overtimeMultiplier, overtimeSurcharge, dailyOvertimeMultiplier, dailyOvertimeSurcharge, tieredOvertimeMultiplier, weekdays, weekend, } from "./schedule.js";
-export type { CoverageEntry, CoverageOptions, CoverageVariant, RuleEntry, RuleOptions, EntityOnlyRuleOptions, TimeOffOptions, AssignTogetherOptions, CostRuleOptions, RuntimeArgs, ScheduleDefinition, ScheduleConfig, } 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;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAmGG;AAMH,YAAY,EAAE,SAAS,EAAE,SAAS,EAAE,QAAQ,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAEnF,OAAO,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAM7C,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAMrD,OAAO,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAMhD,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,WAAW,EACX,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,YAAY,EACV,iBAAiB,EACjB,aAAa,EACb,oBAAoB,EACpB,kBAAkB,GACnB,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,mBAAmB,EACnB,QAAQ,EACR,mBAAmB,GACpB,MAAM,kBAAkB,CAAC;AAM1B,OAAO,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AAMrD,YAAY,EAAE,kBAAkB,EAAE,MAAM,gCAAgC,CAAC;AAEzE,YAAY,EACV,kBAAkB,EAClB,aAAa,EACb,iBAAiB,EACjB,cAAc,EACd,aAAa,EACb,iBAAiB,EACjB,cAAc,EACd,SAAS,EACT,aAAa,EACb,UAAU,EACV,WAAW,EACX,iBAAiB,EACjB,iBAAiB,EACjB,QAAQ,GACT,MAAM,6BAA6B,CAAC;AAErC,OAAO,EAAE,mBAAmB,EAAE,MAAM,gCAAgC,CAAC;AAErE,OAAO,EAAE,QAAQ,EAAE,MAAM,6BAA6B,CAAC;AAMvD,OAAO,EACL,cAAc,EACd,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,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,WAAW,EACX,qBAAqB,EACrB,cAAc,EACd,qBAAqB,EACrB,eAAe,EACf,WAAW,EACX,kBAAkB,EAClB,cAAc,GACf,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,15 +1,12 @@
 /**
  * Scheduling library powered by constraint programming (CP-SAT).
  *
- * Define teams, shifts, coverage, and rules declaratively. dabke compiles
- * them into a constraint model and solves for an optimized schedule.
- *
  * @remarks
  * ## Core Concepts
  *
- * **Schedule Definition**: The primary API. Small, composable functions
+ * **Schedule**: The primary API. Small, composable functions
  * ({@link time}, {@link cover}, {@link shift}, rule functions) produce a
- * complete scheduling configuration via {@link defineSchedule}. Each concept
+ * complete scheduling configuration via {@link schedule}. Each concept
  * is a single function call with full type safety.
  *
  * **Times vs Shift Patterns**: These are two distinct concepts.
@@ -28,86 +25,14 @@
  * - Scoping: apply rules globally, per person, per role, per skill, or per time period
  * - Priority: `MANDATORY` (hard constraint) vs `LOW`/`MEDIUM`/`HIGH` (soft preferences)
  *
- * **Solving**: {@link ScheduleDefinition.createSchedulerConfig} merges the
- * static definition with runtime data (members, scheduling period).
- * {@link ModelBuilder} compiles the config into a solver request;
- * {@link HttpSolverClient} sends it to the CP-SAT solver.
- *
- * @example Define a schedule
- * ```typescript
- * import {
- *   defineSchedule, t, time, cover, shift,
- *   maxHoursPerWeek, minRestBetweenShifts, timeOff,
- *   weekdays, weekend,
- * } from "dabke";
- *
- * const schedule = defineSchedule({
- *   roles: ["nurse", "doctor"],
- *   skills: ["charge_nurse"],
- *
- *   times: {
- *     morning_round: time({ startTime: t(7), endTime: t(9) }),
- *     day_ward: time({ startTime: t(7), endTime: t(15) }),
- *     night_ward: time({ startTime: t(23), endTime: t(7) }),
- *   },
- *
- *   coverage: [
- *     cover("morning_round", "doctor", 1),
- *     cover("day_ward", "nurse", 3, { dayOfWeek: weekdays }),
- *     cover("day_ward", "nurse", 2, { dayOfWeek: weekend }),
- *     cover("night_ward", "nurse", 2),
- *     cover("night_ward", "charge_nurse", 1),
- *   ],
- *
- *   shiftPatterns: [
- *     shift("day", t(7), t(15)),
- *     shift("night", t(23), t(7)),
- *   ],
- *
- *   rules: [
- *     maxHoursPerWeek(40),
- *     minRestBetweenShifts(11),
- *     timeOff({ appliesTo: "alice", dayOfWeek: weekend }),
- *   ],
- * });
- * ```
- *
- * @example Solve a schedule
- * ```typescript
- * import { ModelBuilder, HttpSolverClient, parseSolverResponse } from "dabke";
- *
- * const config = schedule.createSchedulerConfig({
- *   schedulingPeriod: {
- *     dateRange: { start: "2026-02-09", end: "2026-02-15" },
- *   },
- *   members: [
- *     { id: "alice", roles: ["nurse"], skills: ["charge_nurse"] },
- *     { id: "bob", roles: ["nurse"] },
- *     { id: "carol", roles: ["doctor"] },
- *   ],
- * });
- *
- * const builder = new ModelBuilder(config);
- * const { request, canSolve, validation } = builder.compile();
- * if (canSolve) {
- *   const client = new HttpSolverClient(fetch, "http://localhost:8080");
- *   const response = await client.solve(request);
- *   const result = parseSolverResponse(response);
- * }
- * ```
+ * **Solving**: {@link Schedule.compile} compiles the config into a
+ * solver request; {@link Schedule.solve} sends it to the CP-SAT solver
+ * and returns a {@link SolveResult}.
  *
  * @packageDocumentation
  */
 export { DayOfWeekSchema } from "./types.js";
 // ============================================================================
-// Date/time utilities
-// ============================================================================
-export { dateTimeToDate } from "./datetime.utils.js";
-// ============================================================================
-// Errors
-// ============================================================================
-export { ORSchedulingError } from "./errors.js";
-// ============================================================================
 // Solver client
 // ============================================================================
 export { HttpSolverClient } from "./client.js";
@@ -122,13 +47,16 @@ export { ModelBuilder } from "./cpsat/model-builder.js";
 // ============================================================================
 export { parseSolverResponse, resolveAssignments } from "./cpsat/response.js";
 // ============================================================================
+// Cost calculation
+// ============================================================================
+export { calculateScheduleCost, COST_CATEGORY } from "./cpsat/cost.js";
+// ============================================================================
 // Constants
 // ============================================================================
 export { OBJECTIVE_WEIGHTS } from "./cpsat/utils.js";
 export { summarizeValidation } from "./cpsat/validation-reporter.js";
-export { groupKey } from "./cpsat/validation.types.js";
 // ============================================================================
-// Schedule Definition API (v2)
+// Schedule API
 // ============================================================================
-export { defineSchedule, t, time, cover, shift, maxHoursPerDay, maxHoursPerWeek, minHoursPerDay, minHoursPerWeek, maxShiftsPerDay, maxConsecutiveDays, minConsecutiveDays, minRestBetweenShifts, preference, preferLocation, timeOff, assignTogether, 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;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAmGG;AAQH,OAAO,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAE7C,+EAA+E;AAC/E,sBAAsB;AACtB,+EAA+E;AAE/E,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAErD,+EAA+E;AAC/E,SAAS;AACT,+EAA+E;AAE/E,OAAO,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAEhD,+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;AAYxD,+EAA+E;AAC/E,0BAA0B;AAC1B,+EAA+E;AAE/E,OAAO,EAAE,mBAAmB,EAAE,kBAAkB,EAAE,MAAM,qBAAqB,CAAC;AAiC9E,+EAA+E;AAC/E,YAAY;AACZ,+EAA+E;AAE/E,OAAO,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AAyBrD,OAAO,EAAE,mBAAmB,EAAE,MAAM,gCAAgC,CAAC;AAErE,OAAO,EAAE,QAAQ,EAAE,MAAM,6BAA6B,CAAC;AAEvD,+EAA+E;AAC/E,+BAA+B;AAC/B,+EAA+E;AAE/E,OAAO,EACL,cAAc,EACd,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,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"}