scschedule 4.0.0 → 4.1.0

package/README.md

@@ -263,6 +263,19 @@ ranges.forEach((range) => {
 })
 ```
 
+#### `getApplicableRuleForDate(schedule: Schedule, date: SDate | SDateString): ApplicableRule`
+
+Returns the rules that apply for a given date, indicating whether they come from the weekly schedule or an override. When `source` is `'weekly'`, `rules` is the weekly schedule (`true` or `WeeklyScheduleRule[]`). When `source` is `'override'`, `rules` is the override's rules and `overrideIndex` identifies which override applies.
+
+```typescript
+import { getApplicableRuleForDate } from 'scschedule'
+import { sDate } from 'scdate'
+
+const result = getApplicableRuleForDate(restaurant, sDate('2025-12-15'))
+// result.source === 'weekly' | 'override'
+// result.rules === true | WeeklyScheduleRule[]
+```
+
 ## Usage Examples
 
 ### Basic Business Hours
@@ -607,6 +620,7 @@ The library is written in TypeScript and provides full type definitions. All typ
 
 ```typescript
 import type {
+  ApplicableRule,
   Schedule,
   WeeklyScheduleRule,
   OverrideScheduleRule,

package/dist/{internal/getApplicableRuleForDate.d.ts → getApplicableRuleForDate.d.ts}

@@ -1,5 +1,5 @@
 import { SDate } from 'scdate';
-import type { Schedule, SDateString, WeeklyScheduleRule } from '../types.js';
+import type { Schedule, SDateString, WeeklyScheduleRule } from './types.js';
 export type ApplicableRule = {
     source: 'weekly';
     rules: WeeklyScheduleRule[] | true;

package/dist/getAvailableRangesFromSchedule.js

@@ -1,5 +1,5 @@
 import { addDaysToDate, doesWeekdaysIncludeWeekday, getTimestampFromDateAndTime, getWeekdayFromDate, isAfterTime, isSameDateOrBefore, } from 'scdate';
-import { getApplicableRuleForDate } from './internal/getApplicableRuleForDate.js';
+import { getApplicableRuleForDate } from './getApplicableRuleForDate.js';
 /**
  * Returns all available time ranges within a schedule for the specified
  * date range.

package/dist/getNextAvailableFromSchedule.js

@@ -1,5 +1,5 @@
 import { addDaysToDate, doesWeekdaysIncludeWeekday, getDateFromTimestamp, getTimeFromTimestamp, getTimestampFromDateAndTime, getWeekdayFromDate, isAfterTime, isBeforeTime, sTimestamp, } from 'scdate';
-import { getApplicableRuleForDate } from './internal/getApplicableRuleForDate.js';
+import { getApplicableRuleForDate } from './getApplicableRuleForDate.js';
 import { isScheduleAvailable } from './isScheduleAvailable.js';
 /**
  * Finds the next available timestamp in a schedule starting from the

package/dist/getNextUnavailableFromSchedule.js

@@ -1,5 +1,5 @@
 import { addDaysToDate, addMinutesToTimestamp, doesWeekdaysIncludeWeekday, getDateFromTimestamp, getTimeFromTimestamp, getTimestampFromDateAndTime, getWeekdayFromDate, isAfterTime, isBeforeTimestamp, isSameTimeOrAfter, sTimestamp, } from 'scdate';
-import { getApplicableRuleForDate } from './internal/getApplicableRuleForDate.js';
+import { getApplicableRuleForDate } from './getApplicableRuleForDate.js';
 import { isScheduleAvailable } from './isScheduleAvailable.js';
 /**
  * Collects "range end + 1 minute" candidate timestamps for a given date's

package/dist/index.d.ts

@@ -4,6 +4,7 @@ export * from './constants.js';
 export type * from './types.js';
 export * from './validateSchedule.js';
 export * from './cleanupExpiredOverridesFromSchedule.js';
+export * from './getApplicableRuleForDate.js';
 export * from './getAvailableRangesFromSchedule.js';
 export * from './getNextAvailableFromSchedule.js';
 export * from './getNextUnavailableFromSchedule.js';

package/dist/index.js

@@ -7,6 +7,7 @@ export * from './validateSchedule.js';
 // Export schedule management functions
 export * from './cleanupExpiredOverridesFromSchedule.js';
 // Export availability query functions
+export * from './getApplicableRuleForDate.js';
 export * from './getAvailableRangesFromSchedule.js';
 export * from './getNextAvailableFromSchedule.js';
 export * from './getNextUnavailableFromSchedule.js';

package/dist/internal/index.d.ts

@@ -2,7 +2,6 @@ export type * from './types.js';
 export * from './doOverridesOverlap.js';
 export * from './doRulesOverlap.js';
 export * from './doTimeRangesOverlap.js';
-export * from './getApplicableRuleForDate.js';
 export * from './getEffectiveTimesForWeekday.js';
 export * from './isTimeInTimeRange.js';
 export * from './normalizeScheduleForValidation.js';

package/dist/internal/index.js

@@ -2,7 +2,6 @@
 export * from './doOverridesOverlap.js';
 export * from './doRulesOverlap.js';
 export * from './doTimeRangesOverlap.js';
-export * from './getApplicableRuleForDate.js';
 export * from './getEffectiveTimesForWeekday.js';
 export * from './isTimeInTimeRange.js';
 export * from './normalizeScheduleForValidation.js';

package/dist/internal/validateNoSpilloverConflictsAtOverrideBoundaries.js

@@ -1,7 +1,7 @@
 import { addDaysToDate, doesWeekdaysIncludeWeekday, getWeekdayFromDate, sDate, } from 'scdate';
 import { ValidationIssue } from '../constants.js';
 import { doTimeRangesOverlap } from './doTimeRangesOverlap.js';
-import { getApplicableRuleForDate } from './getApplicableRuleForDate.js';
+import { getApplicableRuleForDate } from '../getApplicableRuleForDate.js';
 import { splitCrossMidnightTimeRange } from './splitCrossMidnightTimeRange.js';
 /**
  * Validates that cross-midnight spillover at override boundaries doesn't

package/dist/isScheduleAvailable.js

@@ -1,5 +1,5 @@
 import { addDaysToDate, doesWeekdaysIncludeWeekday, getDateFromTimestamp, getTimeFromTimestamp, getWeekdayFromDate, } from 'scdate';
-import { getApplicableRuleForDate } from './internal/getApplicableRuleForDate.js';
+import { getApplicableRuleForDate } from './getApplicableRuleForDate.js';
 import { isTimeInTimeRange } from './internal/isTimeInTimeRange.js';
 /**
  * Checks if a schedule is available at the specified timestamp.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "scschedule",
-  "version": "4.0.0",
+  "version": "4.1.0",
   "type": "module",
   "exports": {
     ".": "./dist/index.js"
@@ -20,15 +20,15 @@
     "test": "vitest run"
   },
   "dependencies": {
-    "scdate": "4.0.0"
+    "scdate": "workspace:*"
   },
   "devDependencies": {
-    "@eslint/js": "^9.39.2",
+    "@eslint/js": "^9.39.3",
     "@tsconfig/strictest": "^2.0.8",
-    "@types/node": "^24.10.13",
-    "eslint": "^9.39.2",
+    "@types/node": "^24.11.0",
+    "eslint": "^9.39.3",
     "typescript": "^5.9.3",
-    "typescript-eslint": "^8.55.0",
+    "typescript-eslint": "^8.56.1",
     "vitest": "^4.0.18"
   },
   "repository": {
@@ -46,4 +46,4 @@
   "publishConfig": {
     "access": "public"
   }
-}
+}