cronli5 0.1.7 → 0.2.1

package/dist/cronli5.js

@@ -107,6 +107,43 @@ function orderWeekdaysForDisplay(segments) {
 function toFieldNumber(token, numberMap) {
   return isNonNegativeInteger(token) ? +token : numberMap[token.toUpperCase()];
 }
+function segmentsOf(ir, field) {
+  return ir.analyses.segments[field] ?? [];
+}
+function stepSegment(ir, field) {
+  return segmentsOf(ir, field)[0];
+}
+function singleValues(segments) {
+  const values = [];
+  for (const segment of segments) {
+    if (segment.kind !== "single") {
+      return null;
+    }
+    values.push(+segment.value);
+  }
+  return values;
+}
+function offsetCleanStride(stride) {
+  return stride.start < stride.interval && 24 % stride.interval === 0;
+}
+function hourListStride(values) {
+  if (values.length < 2) {
+    return null;
+  }
+  const interval = values[1] - values[0];
+  if (interval < 2) {
+    return null;
+  }
+  for (let i = 2; i < values.length; i += 1) {
+    if (values[i] - values[i - 1] !== interval) {
+      return null;
+    }
+  }
+  if (values[0] !== 0 && values.length < 5) {
+    return null;
+  }
+  return { interval, last: values[values.length - 1], start: values[0] };
+}
 
 // src/core/validate.ts
 function validateCronPattern(cronPattern) {
@@ -455,6 +492,9 @@ function isDiscreteList(field) {
 function isDiscreteHours(hourField) {
   return hourField !== "*" && !isPlainRange(hourField) && !isPlainStep(hourField);
 }
+function isOpenStep(field) {
+  return field.indexOf("/") !== -1 && field.indexOf("-") === -1 && field.indexOf(",") === -1;
+}
 
 // src/core/analyze.ts
 function getOccurrences(start, interval, max) {
@@ -591,9 +631,9 @@ function analyze(pattern) {
     segments
   };
   const content = { analyses, pattern, shapes };
-  return { ...content, plan: selectStrategy(content) };
+  return { ...content, plan: selectPlan(content) };
 }
-function selectStrategy(content) {
+function selectPlan(content) {
   const { analyses, pattern, shapes } = content;
   if (pattern.second !== "0") {
     const seconds = planSeconds(pattern, shapes, analyses);
@@ -849,7 +889,8 @@ var dialects = {
     pm: "p.m.",
     sep: ":",
     serialComma: true,
-    through: " through "
+    through: " through ",
+    untilWindow: true
   },
   house: {
     am: "AM",
@@ -866,7 +907,7 @@ var dialects = {
 };
 function resolveDialect(dialect) {
   if (typeof dialect === "object" && dialect !== null) {
-    return { ...dialects.us, ...dialect };
+    return { ...dialects.us, untilWindow: false, ...dialect };
   }
   const name = dialect === "uk" ? "gb" : dialect;
   return dialects[name] || dialects.us;
@@ -938,7 +979,9 @@ function normalizeOptions(options) {
   };
 }
 function describe(ir, opts) {
-  return applyYear(render(ir, ir.plan, opts), ir, opts);
+  const body = confinement(ir, opts) ?? render(ir, ir.plan, opts);
+  const lead = isDayUnion(ir, opts) ? dayUnionMonthLead(ir, opts) : "";
+  return applyYear(lead + body, ir, opts);
 }
 function render(ir, plan, opts) {
   const renderer = renderers[plan.kind];
@@ -1023,7 +1066,7 @@ function secondsClause(ir, anchor, opts) {
   }
   if (shape === "step") {
     return stepCycle60(
-      ir.analyses.segments.second[0],
+      stepSegment(ir, "second"),
       "second",
       anchor,
       opts
@@ -1031,19 +1074,19 @@ function secondsClause(ir, anchor, opts) {
   }
   if (shape === "range") {
     const bounds = secondField.split("-");
-    const num = seriesNumber(bounds, opts);
+    const num = seriesNumber();
     return "every second from " + num(bounds[0]) + through(opts) + num(bounds[1]) + " past the " + anchor;
   }
   if (shape === "single") {
     return "at " + getNumber(secondField, opts) + " " + pluralize(secondField, "second") + " past the " + anchor;
   }
   return strideFromSegments(
-    ir.analyses.segments.second,
+    segmentsOf(ir, "second"),
     "second",
     anchor,
     opts
   ) ?? listPastThe(
-    segmentWords(ir.analyses.segments.second, opts),
+    segmentWords(segmentsOf(ir, "second"), opts),
     "second",
     anchor,
     opts
@@ -1060,15 +1103,15 @@ function renderRangeOfMinutes(ir, plan, opts) {
   return minuteRangeLead(ir.pattern.minute, opts) + trailingQualifier(ir, opts);
 }
 function renderMultipleMinutes(ir, plan, opts) {
-  const stride = strideFromSegments(ir.analyses.segments.minute, "minute", "hour", opts);
+  const stride = strideFromSegments(segmentsOf(ir, "minute"), "minute", "hour", opts);
   return (stride ?? listPastThe(segmentWords(
-    ir.analyses.segments.minute,
+    segmentsOf(ir, "minute"),
     opts
   ), "minute", "hour", opts)) + trailingQualifier(ir, opts);
 }
 function renderMinuteFrequency(ir, plan, opts) {
   let phrase = stepCycle60(
-    ir.analyses.segments.minute[0],
+    stepSegment(ir, "minute"),
     "minute",
     "hour",
     opts
@@ -1077,9 +1120,14 @@ function renderMinuteFrequency(ir, plan, opts) {
     const cadence = unevenHourCadence(ir, opts);
     phrase += cadence ? ", " + cadence : " during the " + hourTimesFromPlan(ir, plan.hours.times, false, opts) + " hours";
   } else if (plan.hours.kind === "window") {
-    phrase += " " + hourWindow(plan.hours, opts);
+    phrase += " " + rangeWindow({
+      continuous: false,
+      from: plan.hours.from,
+      throughMinute: plan.hours.last,
+      to: plan.hours.to
+    }, opts);
   } else if (plan.hours.kind === "step") {
-    phrase += " " + everyNthHour(ir.analyses.segments.hour[0], opts);
+    phrase += " " + everyNthHour(stepSegment(ir, "hour"), opts);
   }
   return phrase + trailingQualifier(ir, opts);
 }
@@ -1097,15 +1145,21 @@ function renderMinutesAcrossHours(ir, plan, opts) {
     }
     return "every minute during the " + hourTimesFromPlan(ir, plan.times, false, opts) + " hours" + trailingQualifier(ir, opts);
   }
-  const lead = plan.form === "range" ? minuteRangeLead(ir.pattern.minute, opts) : (
-    // The 'list' form is a minute list, which has segments; an offset/uneven
-    // step enumerated to that list reads as a stride.
-    strideFromSegments(ir.analyses.segments.minute, "minute", "hour", opts) ?? listPastThe(
-      segmentWords(ir.analyses.segments.minute, opts),
-      "minute",
-      "hour",
-      opts
-    )
+  if (plan.form === "range") {
+    const lead2 = minuteRangeLead(ir.pattern.minute, opts);
+    if (cadence !== null) {
+      return lead2 + ", " + cadence + trailingQualifier(ir, opts);
+    }
+    if (singleHourFire(plan.times)) {
+      return lead2 + ", at " + hourTimesFromPlan(ir, plan.times, true, opts) + trailingQualifier(ir, opts);
+    }
+    return lead2 + " during the " + hourTimesFromPlan(ir, plan.times, false, opts) + " hours" + trailingQualifier(ir, opts);
+  }
+  const lead = strideFromSegments(segmentsOf(ir, "minute"), "minute", "hour", opts) ?? listPastThe(
+    segmentWords(segmentsOf(ir, "minute"), opts),
+    "minute",
+    "hour",
+    opts
   );
   if (cadence !== null) {
     return lead + ", " + cadence + trailingQualifier(ir, opts);
@@ -1127,12 +1181,12 @@ function everyNthHour(segment, opts) {
   return start === 0 ? base : base + " starting at " + getTime({ hour: start, minute: 0 }, opts);
 }
 function renderMinuteSpanAcrossHourStep(ir, plan, opts) {
-  const segment = ir.analyses.segments.hour[0];
+  const segment = stepSegment(ir, "hour");
   if (plan.form === "wildcard") {
     return "every minute " + everyNthHour(segment, opts) + trailingQualifier(ir, opts);
   }
-  const lead = plan.form === "list" ? strideFromSegments(ir.analyses.segments.minute, "minute", "hour", opts) ?? listPastThe(
-    segmentWords(ir.analyses.segments.minute, opts),
+  const lead = plan.form === "list" ? strideFromSegments(segmentsOf(ir, "minute"), "minute", "hour", opts) ?? listPastThe(
+    segmentWords(segmentsOf(ir, "minute"), opts),
     "minute",
     "hour",
     opts
@@ -1142,7 +1196,7 @@ function renderMinuteSpanAcrossHourStep(ir, plan, opts) {
 }
 function minuteRangeLead(minuteField, opts) {
   const bounds = minuteField.split("-");
-  const num = seriesNumber(bounds, opts);
+  const num = seriesNumber();
   return "every minute from " + num(bounds[0]) + through(opts) + num(bounds[1]) + " past the hour";
 }
 function renderEveryHour(ir, plan, opts) {
@@ -1163,12 +1217,12 @@ function rangeMinuteLead(ir, opts) {
     return "every hour";
   }
   return strideFromSegments(
-    ir.analyses.segments.minute,
+    segmentsOf(ir, "minute"),
     "minute",
     "hour",
     opts
   ) ?? listPastThe(
-    segmentWords(ir.analyses.segments.minute, opts),
+    segmentWords(segmentsOf(ir, "minute"), opts),
     "minute",
     "hour",
     opts
@@ -1179,14 +1233,28 @@ function renderHourStep(ir, plan, opts) {
   if (cadence !== null) {
     return cadence + trailingQualifier(ir, opts);
   }
-  return stepHours(ir.analyses.segments.hour[0], opts) + trailingQualifier(ir, opts);
+  return stepHours(stepSegment(ir, "hour"), opts) + trailingQualifier(ir, opts);
 }
 function boundedWindow(plan) {
-  const last = plan.minuteForm === "wildcard" ? plan.boundMinute ?? 0 : 0;
-  return { from: plan.from, last, to: plan.to };
+  const continuous = plan.minuteForm === "wildcard";
+  const closeMinute = continuous ? plan.boundMinute ?? 0 : 0;
+  return { from: plan.from, closeMinute, to: plan.to, continuous };
+}
+function rangeWindow(window, opts) {
+  const { from, to, throughMinute, continuous } = window;
+  const open = "from " + getTime({ hour: from, minute: 0 }, opts);
+  if (opts.style.untilWindow && !opts.short && from !== to) {
+    return continuous ? open + " until " + getTime({ hour: (to + 1) % 24, minute: 0 }, opts) : open + through(opts) + getTime({ hour: to, minute: 0 }, opts);
+  }
+  return open + through(opts) + getTime({ hour: to, minute: throughMinute }, opts);
 }
 function hourWindow(window, opts) {
-  return "from " + getTime({ hour: window.from, minute: 0 }, opts) + through(opts) + getTime({ hour: window.to, minute: window.last }, opts);
+  return rangeWindow({
+    continuous: window.continuous,
+    from: window.from,
+    throughMinute: window.closeMinute,
+    to: window.to
+  }, opts);
 }
 function renderClockTimes(ir, plan, opts) {
   if (ir.shapes.minute === "single") {
@@ -1205,7 +1273,10 @@ function renderClockTimes(ir, plan, opts) {
       plain
     }, opts);
   });
-  return interpretDayQualifier(ir, opts) + "at " + joinList(times, opts);
+  return interpretDayQualifier(ir, opts) + "at " + joinList(times, opts) + dayUnionTrail(ir, opts);
+}
+function dayUnionTrail(ir, opts) {
+  return isDayUnion(ir, opts) ? dayUnionCondition(ir, opts) : "";
 }
 function renderCompactClockTimes(ir, plan, opts) {
   if (plan.fold) {
@@ -1213,20 +1284,20 @@ function renderCompactClockTimes(ir, plan, opts) {
     if (cadence2 !== null) {
       return cadence2;
     }
-    const hasRange = ir.analyses.segments.hour.some(function range(segment) {
+    const hasRange = segmentsOf(ir, "hour").some(function range(segment) {
       return segment.kind === "range";
     });
     if (hasRange && !ir.analyses.clockSecond) {
       return foldedHourWindows(ir, plan, opts) + trailingQualifier(ir, opts);
     }
     const fold = { minute: plan.minute, second: ir.analyses.clockSecond };
-    return interpretDayQualifier(ir, opts) + "at " + hourSegmentTimes(ir, fold, true, opts);
+    return interpretDayQualifier(ir, opts) + "at " + hourSegmentTimes(ir, fold, true, opts) + dayUnionTrail(ir, opts);
   }
   const minuteLead = (
     // The non-fold branch is a minute list, which has segments. An
     // offset/uneven step enumerated to that list reads as a stride.
-    strideFromSegments(ir.analyses.segments.minute, "minute", "hour", opts) ?? listPastThe(
-      segmentWords(ir.analyses.segments.minute, opts),
+    strideFromSegments(segmentsOf(ir, "minute"), "minute", "hour", opts) ?? listPastThe(
+      segmentWords(segmentsOf(ir, "minute"), opts),
       "minute",
       "hour",
       opts
@@ -1239,26 +1310,162 @@ function renderCompactClockTimes(ir, plan, opts) {
 function foldedHourWindows(ir, plan, opts) {
   const minute = plan.minute;
   const windows = [];
-  const singles = [];
-  ir.analyses.segments.hour.forEach(function classify(segment) {
+  const times = collectHourOutliers(ir).map(function time(hour) {
+    return getTime({ hour, minute }, opts);
+  });
+  segmentsOf(ir, "hour").forEach(function classify(segment) {
     if (segment.kind === "range") {
-      windows.push("from " + getTime(
-        { hour: segment.bounds[0], minute: 0 },
-        opts
-      ) + through(opts) + getTime({ hour: segment.bounds[1], minute }, opts));
-    } else if (segment.kind === "step") {
-      singles.push(...segment.fires);
-    } else {
-      singles.push(+segment.value);
+      windows.push(rangeWindow({
+        continuous: false,
+        from: +segment.bounds[0],
+        throughMinute: minute,
+        to: +segment.bounds[1]
+      }, opts));
+    }
+  });
+  const phrase = rangeMinuteLead(ir, opts) + " " + joinList(windows, opts);
+  return phrase + outlierTail(times, opts);
+}
+function collectHourOutliers(ir) {
+  const hours = [];
+  segmentsOf(ir, "hour").forEach(function classify(segment) {
+    if (segment.kind === "step") {
+      hours.push(...segment.fires);
+    } else if (segment.kind !== "range") {
+      hours.push(+segment.value);
     }
   });
-  let phrase = rangeMinuteLead(ir, opts) + " " + joinList(windows, opts);
-  if (singles.length) {
-    phrase += " and at " + joinList(singles.map(function time(hour) {
-      return getTime({ hour, minute }, opts);
-    }), opts);
+  return hours;
+}
+function outlierTail(times, opts) {
+  if (!times.length) {
+    return "";
   }
-  return phrase;
+  return " and at " + joinList(times, opts);
+}
+function isCadenceField(token) {
+  return token === "*" || token.startsWith("*/") && token.indexOf("-") === -1;
+}
+function leadingCadence(ir, opts) {
+  const { second, minute } = ir.pattern;
+  if (isCadenceField(second)) {
+    return { secondLead: true, text: secondsClause(ir, "minute", opts) };
+  }
+  if (second === "0" && isCadenceField(minute)) {
+    const text = minute === "*" ? "every minute" : (
+      // A clean minute step's first segment is a step segment.
+      stepCycle60(
+        stepSegment(ir, "minute"),
+        "minute",
+        "hour",
+        opts
+      )
+    );
+    return { secondLead: false, text };
+  }
+  return null;
+}
+function minuteConfinement(ir, opts) {
+  const minute = ir.pattern.minute;
+  if (minute === "*") {
+    return "";
+  }
+  if (isCadenceField(minute)) {
+    return " of every other minute";
+  }
+  const segments = segmentsOf(ir, "minute");
+  if (ir.shapes.minute === "single") {
+    return " during minute :" + pad(minute);
+  }
+  if (ir.shapes.minute === "range") {
+    const bounds = minute.split("-");
+    return " during minutes :" + pad(bounds[0]) + through(opts) + ":" + pad(bounds[1]);
+  }
+  const values = segmentWords(segments, opts).map(function colon(word) {
+    return ":" + pad(word);
+  });
+  return " during minutes " + joinList(values, opts);
+}
+function hourConfinement(ir, opts) {
+  const hour = ir.pattern.hour;
+  if (hour === "*") {
+    const minutePinned = ir.pattern.minute !== "*" && !isCadenceField(ir.pattern.minute);
+    return minutePinned ? " of every hour" : "";
+  }
+  if (isCadenceField(hour)) {
+    return hour === "*/2" ? " of every other hour" : "";
+  }
+  if (ir.shapes.hour === "single") {
+    const h = +hour;
+    if (ir.shapes.minute === "step") {
+      return " from " + getTime({ hour: h, minute: 0 }, opts) + " until " + getTime({ hour: (h + 1) % 24, minute: 0 }, opts);
+    }
+    if (ir.pattern.minute !== "*" && !isCadenceField(ir.pattern.minute)) {
+      return " at " + getTime({ hour: h, minute: 0 }, opts);
+    }
+    return " of the " + getTime({ hour: h, minute: 0 }, opts) + " hour";
+  }
+  if (ir.shapes.hour === "range") {
+    const bounds = hour.split("-");
+    return " " + rangeWindow({
+      continuous: ir.pattern.minute === "*",
+      from: +bounds[0],
+      throughMinute: 0,
+      to: +bounds[1]
+    }, opts);
+  }
+  return " during the " + hourSegmentTimes(ir, { minute: 0, second: null }, false, opts) + " hours";
+}
+function isContiguousHourRange(ir) {
+  return ir.shapes.hour === "range";
+}
+function confinableHour(ir) {
+  if (ir.shapes.hour !== "step") {
+    return true;
+  }
+  const segment = stepSegment(ir, "hour");
+  return ir.pattern.hour === "*/2" || segment.startToken.indexOf("-") !== -1;
+}
+function isMinuteStride(ir) {
+  if (ir.shapes.minute !== "list") {
+    return false;
+  }
+  const values = singleValues(segmentsOf(ir, "minute"));
+  return values !== null && arithmeticStep(values) !== null;
+}
+function confinementEligible(ir, lead) {
+  const { minute, hour } = ir.pattern;
+  const minuteStep = isCadenceField(minute) && minute !== "*";
+  if (!confinableHour(ir)) {
+    return false;
+  }
+  if (lead.secondLead) {
+    if (minuteStep) {
+      return minute === "*/2" && !isContiguousHourRange(ir);
+    }
+    if (isMinuteStride(ir) || ir.shapes.minute === "list" && ir.shapes.hour === "list") {
+      return false;
+    }
+    return true;
+  }
+  if (hour === "*/2") {
+    return true;
+  }
+  return ir.shapes.hour === "single" && minute === "*/2";
+}
+function confinement(ir, opts) {
+  if (!opts.style.untilWindow || opts.short) {
+    return null;
+  }
+  if (ir.pattern.minute === "*" && ir.pattern.hour === "*") {
+    return null;
+  }
+  const lead = leadingCadence(ir, opts);
+  if (!lead || !confinementEligible(ir, lead)) {
+    return null;
+  }
+  const minutePart = lead.secondLead ? minuteConfinement(ir, opts) : "";
+  return lead.text + minutePart + hourConfinement(ir, opts) + trailingQualifier(ir, opts);
 }
 var renderers = {
   clockTimes: renderClockTimes,
@@ -1290,19 +1497,9 @@ function renderStride(stride, opts) {
   if (start < interval && tiles) {
     return cadence + " from " + getNumber(start, opts) + " " + pluralize(start, unit) + " past the " + anchor;
   }
-  const num = seriesNumber([start, last], opts);
+  const num = seriesNumber();
   return cadence + " from " + num(start) + through(opts) + num(last) + " " + pluralize(last, unit) + " past the " + anchor;
 }
-function singleValues(segments) {
-  const values = [];
-  for (const segment of segments) {
-    if (segment.kind !== "single") {
-      return null;
-    }
-    values.push(+segment.value);
-  }
-  return values;
-}
 function strideFromSegments(segments, unit, anchor, opts) {
   const values = singleValues(segments);
   const step = values && arithmeticStep(values);
@@ -1351,9 +1548,6 @@ function hourStrideCadence(stride, opts) {
   }
   return cadence + " from " + getTime({ hour: start, minute: 0 }, opts) + through(opts) + getTime({ hour: last, minute: 0 }, opts);
 }
-function offsetCleanStride(stride) {
-  return stride.start < stride.interval && 24 % stride.interval === 0;
-}
 function unevenHourCadence(ir, opts) {
   const stride = hourStride(ir);
   if (!stride || offsetCleanStride(stride)) {
@@ -1361,26 +1555,8 @@ function unevenHourCadence(ir, opts) {
   }
   return hourStrideCadence(stride, opts);
 }
-function hourListStride(values) {
-  if (values.length < 2) {
-    return null;
-  }
-  const interval = values[1] - values[0];
-  if (interval < 2) {
-    return null;
-  }
-  for (let i = 2; i < values.length; i += 1) {
-    if (values[i] - values[i - 1] !== interval) {
-      return null;
-    }
-  }
-  if (values[0] !== 0 && values.length < 5) {
-    return null;
-  }
-  return { interval, last: values[values.length - 1], start: values[0] };
-}
 function hourStride(ir) {
-  const segments = ir.analyses.segments.hour;
+  const segments = segmentsOf(ir, "hour");
   if (segments.length === 1 && segments[0].kind === "step") {
     const segment = segments[0];
     if (segment.fires.length < 2) {
@@ -1417,9 +1593,9 @@ function hourCadence(ir, minute, opts) {
   if (ir.pattern.second === "0" && fires <= maxClockTimes && offsetCleanStride(stride)) {
     return null;
   }
-  const confinement = minute === 0 && subMinuteSecond(ir) && cleanStrideSegment(ir);
-  if (confinement) {
-    return secondsClause(ir, "minute", opts) + " for one minute " + everyNthHour(confinement, opts) + trailingQualifier(ir, opts);
+  const minuteZeroStride = minute === 0 && subMinuteSecond(ir) && cleanStrideSegment(ir);
+  if (minuteZeroStride) {
+    return secondsClause(ir, "minute", opts) + " for one minute " + everyNthHour(minuteZeroStride, opts) + trailingQualifier(ir, opts);
   }
   if (minute === 0 && ir.pattern.second === "0") {
     return hourStrideCadence(stride, opts) + trailingQualifier(ir, opts);
@@ -1427,7 +1603,7 @@ function hourCadence(ir, minute, opts) {
   return hourCadenceLead(ir, minute, opts) + ", " + hourStrideCadence(stride, opts) + trailingQualifier(ir, opts);
 }
 function cleanStrideSegment(ir) {
-  const segments = ir.analyses.segments.hour;
+  const segments = segmentsOf(ir, "hour");
   const segment = segments.length === 1 && segments[0];
   if (!segment || segment.kind !== "step" || segment.startToken.indexOf("-") !== -1 || !(segment.interval in stepOrdinals)) {
     return null;
@@ -1435,32 +1611,28 @@ function cleanStrideSegment(ir) {
   return segment;
 }
 function hasHourWindow(ir) {
-  return ir.analyses.segments.hour.some(function range(segment) {
+  return segmentsOf(ir, "hour").some(function range(segment) {
     return segment.kind === "range";
   });
 }
 function hourRangeWindowTail(ir, opts) {
   const windows = [];
-  const singles = [];
-  ir.analyses.segments.hour.forEach(function classify(segment) {
+  const outlierHours = collectHourOutliers(ir);
+  segmentsOf(ir, "hour").forEach(function classify(segment) {
     if (segment.kind === "range") {
-      windows.push("from " + getTime(
-        { hour: +segment.bounds[0], minute: 0 },
-        opts
-      ) + through(opts) + getTime({ hour: +segment.bounds[1], minute: 0 }, opts));
-    } else if (segment.kind === "step") {
-      singles.push(...segment.fires);
-    } else {
-      singles.push(+segment.value);
+      windows.push(rangeWindow({
+        continuous: false,
+        from: +segment.bounds[0],
+        throughMinute: 0,
+        to: +segment.bounds[1]
+      }, opts));
     }
   });
-  let phrase = "every hour " + joinList(windows, opts);
-  if (singles.length) {
-    phrase += " and at " + joinList(singles.map(function time(hour) {
-      return getTime({ hour, minute: 0 }, opts);
-    }), opts);
-  }
-  return phrase;
+  const phrase = "every hour " + joinList(windows, opts);
+  const times = outlierHours.map(function time(hour) {
+    return getTime({ hour, minute: 0 }, opts);
+  });
+  return phrase + outlierTail(times, opts);
 }
 function hourRangeCadence(ir, minute, opts) {
   if (minute !== 0 || !hasHourWindow(ir)) {
@@ -1474,25 +1646,29 @@ function hourRangeCadence(ir, minute, opts) {
   }
   return hourCadenceLead(ir, minute, opts) + ", " + hourRangeWindowTail(ir, opts) + trailingQualifier(ir, opts);
 }
-function seriesNumber(values, opts) {
-  const anyBig = values.some(function big(v) {
-    return +v > 10;
-  });
+function seriesNumber() {
   return function format(n) {
-    return anyBig ? "" + n : getNumber(n, opts);
+    return "" + n;
+  };
+}
+function listNumber(count, opts) {
+  return count > 1 ? function asNumeral(n) {
+    return "" + n;
+  } : function spelled(n) {
+    return getNumber(n, opts);
   };
 }
 function numberWords(fires, opts) {
-  return fires.map(seriesNumber(fires, opts));
+  return fires.map(listNumber(fires.length, opts));
 }
 function segmentWords(segments, opts) {
-  const values = segments.flatMap(function collect(segment) {
+  const count = segments.reduce(function tally(sum, segment) {
     if (segment.kind === "range") {
-      return segment.bounds;
+      return sum + 1;
     }
-    return segment.kind === "step" ? segment.fires : [segment.value];
-  });
-  const num = seriesNumber(values, opts);
+    return sum + (segment.kind === "step" ? segment.fires.length : 1);
+  }, 0);
+  const num = listNumber(count, opts);
   return segments.flatMap(function word(segment) {
     if (segment.kind === "range") {
       return [num(segment.bounds[0]) + through(opts) + num(segment.bounds[1])];
@@ -1524,6 +1700,9 @@ function hourTimes(hours, opts) {
   });
   return joinList(times, opts);
 }
+function singleHourFire(times) {
+  return times.kind === "fires" && times.fires.length === 1;
+}
 function hourTimesFromPlan(ir, times, atContext, opts) {
   if (times.kind === "fires") {
     return hourTimes(times.fires, opts);
@@ -1538,7 +1717,7 @@ function segmentHours(segment) {
 }
 function hourSegmentTimes(ir, fold, atContext, opts) {
   const { minute, second } = fold;
-  const segments = ir.analyses.segments.hour;
+  const segments = segmentsOf(ir, "hour");
   const plain = mixedTwelve(segments.flatMap(function entries(segment) {
     return segmentHours(segment).map(function entry(hour) {
       return { hour: +hour, minute, second };
@@ -1571,28 +1750,47 @@ function disambiguateTimes(pieces, segments, atContext) {
     return index === 0 ? piece : "at " + piece;
   });
 }
-function joinList(items, opts) {
+function joinWith(items, conjunction, opts) {
   if (items.length <= 1) {
     return items.join("");
   }
   if (items.length === 2) {
-    return items[0] + " and " + items[1];
+    return items[0] + conjunction + items[1];
   }
-  const and = opts.style.serialComma ? ", and " : " and ";
-  return items.slice(0, -1).join(", ") + and + items[items.length - 1];
+  const tail = opts.style.serialComma ? "," + conjunction : conjunction;
+  return items.slice(0, -1).join(", ") + tail + items[items.length - 1];
+}
+function joinList(items, opts) {
+  return joinWith(items, " and ", opts);
 }
-var trailingWords = { all: "", month: "in ", stepDate: "on ", weekday: "on " };
+function joinOr(items, opts) {
+  return joinWith(items, " or ", opts);
+}
+var trailingWords = {
+  all: "",
+  month: "in ",
+  recurringWeekday: true,
+  stepDate: "on ",
+  weekday: "on "
+};
 var leadingWords = {
   all: "every day",
   month: "every day in ",
+  recurringWeekday: false,
   stepDate: "",
   weekday: "every "
 };
 function trailingQualifier(ir, opts) {
+  if (isDayUnion(ir, opts)) {
+    return dayUnionCondition(ir, opts);
+  }
   const phrase = dayQualifier(ir, trailingWords, opts);
   return phrase && " " + phrase;
 }
 function interpretDayQualifier(ir, opts) {
+  if (isDayUnion(ir, opts)) {
+    return "";
+  }
   return dayQualifier(ir, leadingWords, opts) + " ";
 }
 function dayQualifier(ir, words, opts) {
@@ -1604,7 +1802,11 @@ function dayQualifier(ir, words, opts) {
     return datePhrase(ir, words, opts);
   }
   if (pattern.weekday !== "*") {
-    const weekdays = quartzWeekdayPhrase(pattern.weekday, opts) || words.weekday + weekdayPhrase(ir, opts);
+    const quartzWeekday = quartzWeekdayPhrase(pattern.weekday, opts);
+    if (quartzWeekday) {
+      return monthScopeForRecurrence(quartzWeekday, ir, opts);
+    }
+    const weekdays = words.weekday + weekdayPhrase(ir, words.recurringWeekday, opts);
     return weekdays + monthScope(ir, opts);
   }
   if (pattern.month !== "*") {
@@ -1616,10 +1818,14 @@ function datePhrase(ir, words, opts) {
   const pattern = ir.pattern;
   const quartzDate = quartzDatePhrase(pattern.date, opts);
   if (quartzDate) {
-    return quartzDate + monthScope(ir, opts);
+    return monthScopeForRecurrence(quartzDate, ir, opts);
   }
   if (isOpenStep(pattern.date)) {
-    return words.stepDate + stepDates(pattern.date) + monthScope(ir, opts);
+    return monthScopeForRecurrence(
+      words.stepDate + stepDates(pattern.date),
+      ir,
+      opts
+    );
   }
   if (pattern.month !== "*" && !monthFoldsIntoDate(ir)) {
     return "on the " + dateOrdinals(ir, opts) + monthScope(ir, opts);
@@ -1631,13 +1837,88 @@ function datePhrase(ir, words, opts) {
 }
 function monthFoldsIntoDate(ir) {
   return !oddEvenMonth(ir.pattern.month) && // Reached only with a restricted month, which has segments.
-  ir.analyses.segments.month.every(function flat(segment) {
+  segmentsOf(ir, "month").every(function flat(segment) {
     return segment.kind !== "range";
   });
 }
+function isDayUnion(ir, opts) {
+  return ir.pattern.date !== "*" && ir.pattern.weekday !== "*" && !!opts.style.untilWindow && !opts.short;
+}
+function dayUnionCondition(ir, opts) {
+  const pieces = [
+    ...dayUnionDatePieces(ir, opts),
+    ...dayUnionWeekdayPieces(ir, opts)
+  ];
+  return " whenever the day is " + joinOr(pieces, opts);
+}
+function dayUnionMonthLead(ir, opts) {
+  if (ir.pattern.month === "*") {
+    return "";
+  }
+  return "in " + monthName(ir, opts) + " ";
+}
+function dayUnionDatePieces(ir, opts) {
+  const dateField = ir.pattern.date;
+  const quartz = quartzDatePhrase(dateField, opts);
+  if (quartz) {
+    return [quartz.replace(/^on /, "")];
+  }
+  const oddEven = oddEvenDay(dateField);
+  if (oddEven) {
+    return [oddEven];
+  }
+  const pieces = [];
+  segmentsOf(ir, "date").forEach(function expand(segment) {
+    if (segment.kind === "range") {
+      pieces.push("from the " + getOrdinal(segment.bounds[0]) + through(opts) + "the " + getOrdinal(segment.bounds[1]));
+    } else if (segment.kind === "step") {
+      segment.fires.forEach(function fire(value) {
+        pieces.push("the " + getOrdinal(value));
+      });
+    } else {
+      pieces.push("the " + getOrdinal(segment.value));
+    }
+  });
+  return pieces;
+}
+function dayUnionWeekdayPieces(ir, opts) {
+  const weekdayField = ir.pattern.weekday;
+  const quartz = quartzWeekdayPhrase(weekdayField, opts);
+  if (quartz) {
+    return [quartz.replace(/^on /, "")];
+  }
+  const pieces = [];
+  segmentsOf(ir, "weekday").forEach(function expand(segment) {
+    if (segment.kind === "range" && segment.bounds[0] === "1" && segment.bounds[1] === "5") {
+      pieces.push("a weekday");
+    } else if (segment.kind === "range") {
+      pieces.push("a " + getWeekday(segment.bounds[0], opts) + through(opts) + "a " + getWeekday(segment.bounds[1], opts));
+    } else if (segment.kind === "step") {
+      segment.fires.forEach(function fire(value) {
+        pieces.push("a " + getWeekday(value, opts));
+      });
+    } else {
+      pieces.push("a " + getWeekday(segment.value, opts));
+    }
+  });
+  return pieces;
+}
+function oddEvenDay(dateField) {
+  if (!isOpenStep(dateField)) {
+    return null;
+  }
+  const [start, step] = dateField.split("/");
+  if (+step !== 2) {
+    return null;
+  }
+  if (start === "*" || start === "1") {
+    return "an odd-numbered day";
+  }
+  return start === "2" ? "an even-numbered day" : null;
+}
 function dateOrWeekday(ir, opts) {
   const pattern = ir.pattern;
-  const weekdayPart = quartzWeekdayPhrase(pattern.weekday, opts) || "on " + weekdayPhrase(ir, opts);
+  const weekdayPart = quartzWeekdayPhrase(pattern.weekday, opts) || "on " + weekdayPhrase(ir, false, opts);
   if (pattern.month !== "*" && monthFoldsIntoDate(ir) && !quartzDatePhrase(pattern.date, opts) && !isOpenStep(pattern.date)) {
     return "on " + monthDatePhrase(ir, opts) + " or " + weekdayPart + " in " + monthName(ir, opts);
   }
@@ -1688,10 +1969,13 @@ function quartzWeekdayPhrase(weekdayField, opts) {
 function monthDatePhrase(ir, opts) {
   const month = monthName(ir, opts);
   const days = renderSegments(
-    ir.analyses.segments.date,
+    segmentsOf(ir, "date"),
     opts.style.ordinals ? getOrdinal : cardinalDay,
     opts
   );
+  if (opts.style.dayFirst && ir.shapes.date === "single" && ir.shapes.month !== "single") {
+    return "the " + getOrdinal(ir.pattern.date) + " of " + month;
+  }
   return opts.style.dayFirst ? days + " " + month : month + " " + days;
 }
 function cardinalDay(value) {
@@ -1703,6 +1987,19 @@ function monthScope(ir, opts) {
   }
   return " in " + monthName(ir, opts);
 }
+function monthScopeForRecurrence(phrase, ir, opts) {
+  if (ir.pattern.month === "*") {
+    return phrase;
+  }
+  const carriesRecurrence = phrase.indexOf(" of the month") !== -1;
+  if (carriesRecurrence && ir.shapes.month === "range") {
+    return phrase.replace(" of the month", " of each month") + " from " + monthName(ir, opts);
+  }
+  if (carriesRecurrence && (ir.shapes.month === "single" || ir.shapes.month === "step")) {
+    return phrase.replace(" of the month", "") + " in " + monthName(ir, opts);
+  }
+  return phrase + " in " + monthName(ir, opts);
+}
 function stepDates(dateField) {
   const parts = dateField.split("/");
   const interval = +parts[1];
@@ -1715,14 +2012,14 @@ function stepDates(dateField) {
   return phrase;
 }
 function dateOrdinals(ir, opts) {
-  return renderSegments(ir.analyses.segments.date, getOrdinal, opts);
+  return renderSegments(segmentsOf(ir, "date"), getOrdinal, opts);
 }
 function monthName(ir, opts) {
   const oddEven = oddEvenMonth(ir.pattern.month);
   if (oddEven) {
     return oddEven;
   }
-  return renderSegments(ir.analyses.segments.month, function name(value) {
+  return renderSegments(segmentsOf(ir, "month"), function name(value) {
     return getMonth(value, opts);
   }, opts);
 }
@@ -1739,11 +2036,21 @@ function oddEvenMonth(monthField) {
   }
   return start === "2" ? "every even-numbered month" : null;
 }
-function weekdayPhrase(ir, opts) {
-  const segments = orderWeekdaysForDisplay(ir.analyses.segments.weekday);
-  return renderSegments(segments, function name(value) {
+function weekdayPhrase(ir, recurring, opts) {
+  const segments = orderWeekdaysForDisplay(segmentsOf(ir, "weekday"));
+  const hasRange = segments.some(function range(segment) {
+    return segment.kind === "range";
+  });
+  const name = recurring && !hasRange ? function plural(value) {
+    return pluralWeekday(value, opts);
+  } : function singular(value) {
     return getWeekday(value, opts);
-  }, opts);
+  };
+  return renderSegments(segments, name, opts);
+}
+function pluralWeekday(value, opts) {
+  const name = getWeekday(value, opts);
+  return opts.short ? name : name + "s";
 }
 function renderSegments(segments, word, opts) {
   const pieces = [];
@@ -1758,16 +2065,13 @@ function renderSegments(segments, word, opts) {
   });
   return joinList(pieces, opts);
 }
-function isOpenStep(field) {
-  return field.indexOf("/") !== -1 && field.indexOf("-") === -1 && field.indexOf(",") === -1;
-}
 function applyYear(description, ir, opts) {
   const yearField = ir.pattern.year;
   if (yearField === "*") {
     return description;
   }
   if (yearField.indexOf("/") !== -1) {
-    return description + " " + stepYears(yearField, opts);
+    return description + ", " + stepYears(yearField, opts);
   }
   const label = yearLabel(yearField, opts);
   if (yearField.indexOf("-") === -1 && yearField.indexOf(",") === -1 && ir.pattern.date !== "*" && description.indexOf(" at ") !== -1) {
@@ -1780,6 +2084,9 @@ function yearLabel(yearField, opts) {
   if (yearField.indexOf(",") !== -1) {
     return joinList(yearField.split(","), opts);
   }
+  if (yearField.indexOf("-") !== -1) {
+    return yearField.split("-").join(through(opts));
+  }
   return yearField;
 }
 function stepYears(yearField, opts) {
@@ -1789,7 +2096,7 @@ function stepYears(yearField, opts) {
   if (interval <= 1) {
     return "every year";
   }
-  let phrase = "every " + getNumber(interval, opts) + " years";
+  let phrase = interval === 2 ? "every other year" : "every " + getNumber(interval, opts) + " years";
   if (start !== "*" && start !== "0") {
     phrase += " from " + start;
   }
@@ -1891,7 +2198,7 @@ function interpretCronPattern(cronPattern, lang, opts) {
     return lang.reboot;
   }
   const ir = analyze(prepare(cronPattern, opts));
-  const plan = lang.strategy ? lang.strategy(ir, ir.plan) : ir.plan;
+  const plan = lang.plan ? lang.plan(ir, ir.plan) : ir.plan;
   return lang.describe({ ...ir, plan }, opts);
 }
 var cronli5_default = cronli5;