cronli5 0.7.2 → 0.8.2

package/dist/lang/fr.js

@@ -193,6 +193,7 @@ function normalizeOptions(options) {
     // satisfied without the 12-hour machinery the es donor carried.
     ampm: false,
     lenient: !!options.lenient,
+    quartz: !!options.quartz,
     seconds: !!options.seconds,
     short: !!options.short,
     style,
@@ -338,6 +339,9 @@ function minutesList(schedule, opts) {
     opts
   ) ?? "aux minutes " + joinList(segmentWords(segmentsOf(schedule, "minute"))) + " de chaque heure";
 }
+function withoutHourAnchor(lead) {
+  return lead.replace(/ de chaque heure$/, "");
+}
 function minuteRangeLead(minuteField) {
   const bounds = minuteField.split("-");
   return "chaque minute de " + bounds[0] + " \xE0 " + bounds[1];
@@ -375,7 +379,7 @@ function renderMinuteFrequency(schedule, plan, opts) {
   } else if (plan.hours.kind === "window") {
     phrase += " " + hourWindow(plan.hours, opts);
   } else if (plan.hours.kind === "step") {
-    phrase += ", " + stepHourSpan(stepSegment(schedule, "hour"), opts);
+    phrase = withoutHourAnchor(phrase) + ", " + stepHourSpan(stepSegment(schedule, "hour"), opts);
   }
   return phrase + trailingQualifier(schedule, opts);
 }
@@ -412,7 +416,7 @@ function renderMinuteSpanAcrossHourStep(schedule, plan, opts) {
   if (plan.form === "wildcard") {
     return "chaque minute, " + stepHourSpan(segment, opts) + trailingQualifier(schedule, opts);
   }
-  const lead = plan.form === "list" ? minutesList(schedule, opts) : minuteRangeLead(schedule.pattern.minute);
+  const lead = withoutHourAnchor(plan.form === "list" ? minutesList(schedule, opts) : minuteRangeLead(schedule.pattern.minute));
   return lead + ", " + (cadence ?? stepHours(segment, opts)) + trailingQualifier(schedule, opts);
 }
 function renderEveryHour(schedule, plan, opts) {
@@ -585,7 +589,7 @@ function renderCompactClockTimes(schedule, plan, opts) {
     );
   }
   const cadence = unevenHourCadence(schedule, opts);
-  const phrase = cadence ? minutesList(schedule, opts) + ", " + cadence + trailingQualifier(schedule, opts) : minutesList(schedule, opts) + ", " + hourContextTimes(schedule, opts) + trailingQualifier(schedule, opts);
+  const phrase = cadence ? withoutHourAnchor(minutesList(schedule, opts)) + ", " + cadence + trailingQualifier(schedule, opts) : minutesList(schedule, opts) + ", " + hourContextTimes(schedule, opts) + trailingQualifier(schedule, opts);
   return schedule.analyses.clockSecond ? secondsLeadClause(schedule, opts) + ", " + phrase : phrase;
 }
 var renderers = {

package/dist/lang/pt.cjs

@@ -305,6 +305,7 @@ function normalizeOptions(options) {
     // `{ampm}` option overrides it.
     ampm: typeof options.ampm === "boolean" ? options.ampm : style.ampm,
     lenient: !!options.lenient,
+    quartz: !!options.quartz,
     seconds: !!options.seconds,
     short: !!options.short,
     style,
@@ -452,6 +453,9 @@ function minutesList(schedule, opts) {
     opts
   ) ?? "nos minutos " + joinList(segmentWords(segmentsOf(schedule, "minute"))) + " de cada hora";
 }
+function withoutHourAnchor(lead) {
+  return lead.replace(/ de cada hora$/, "");
+}
 function minuteRangeLead(minuteField) {
   const bounds = minuteField.split("-");
   return "a cada minuto do " + bounds[0] + " ao " + bounds[1];
@@ -522,7 +526,7 @@ function renderMinuteFrequency(schedule, plan, opts) {
   } else if (plan.hours.kind === "window") {
     phrase += " " + hourWindow(plan.hours, opts);
   } else if (plan.hours.kind === "step") {
-    phrase += ", " + stepHourSpan(stepSegment(schedule, "hour"), opts);
+    phrase = withoutHourAnchor(phrase) + ", " + stepHourSpan(stepSegment(schedule, "hour"), opts);
   }
   return phrase + trailingQualifier(schedule, opts);
 }
@@ -559,7 +563,7 @@ function renderMinuteSpanAcrossHourStep(schedule, plan, opts) {
   if (plan.form === "wildcard") {
     return "a cada minuto, " + stepHourSpan(segment, opts) + trailingQualifier(schedule, opts);
   }
-  const lead = plan.form === "list" ? minutesList(schedule, opts) : minuteRangeLead(schedule.pattern.minute);
+  const lead = withoutHourAnchor(plan.form === "list" ? minutesList(schedule, opts) : minuteRangeLead(schedule.pattern.minute));
   return lead + ", " + (cadence ?? stepHours(segment, opts)) + trailingQualifier(schedule, opts);
 }
 function renderEveryHour(schedule, plan, opts) {
@@ -864,7 +868,7 @@ function renderCompactClockTimes(schedule, plan, opts) {
     );
   }
   const cadence = unevenHourCadence(schedule, opts);
-  const phrase = cadence ? minutesList(schedule, opts) + ", " + cadence + trailingQualifier(schedule, opts) : minutesList(schedule, opts) + ", " + hourContextTimes(schedule, opts) + trailingQualifier(schedule, opts);
+  const phrase = cadence ? withoutHourAnchor(minutesList(schedule, opts)) + ", " + cadence + trailingQualifier(schedule, opts) : minutesList(schedule, opts) + ", " + hourContextTimes(schedule, opts) + trailingQualifier(schedule, opts);
   return schedule.analyses.clockSecond ? secondsLeadClause(schedule, opts) + ", " + phrase : phrase;
 }
 var renderers = {

package/dist/lang/pt.js

@@ -279,6 +279,7 @@ function normalizeOptions(options) {
     // `{ampm}` option overrides it.
     ampm: typeof options.ampm === "boolean" ? options.ampm : style.ampm,
     lenient: !!options.lenient,
+    quartz: !!options.quartz,
     seconds: !!options.seconds,
     short: !!options.short,
     style,
@@ -426,6 +427,9 @@ function minutesList(schedule, opts) {
     opts
   ) ?? "nos minutos " + joinList(segmentWords(segmentsOf(schedule, "minute"))) + " de cada hora";
 }
+function withoutHourAnchor(lead) {
+  return lead.replace(/ de cada hora$/, "");
+}
 function minuteRangeLead(minuteField) {
   const bounds = minuteField.split("-");
   return "a cada minuto do " + bounds[0] + " ao " + bounds[1];
@@ -496,7 +500,7 @@ function renderMinuteFrequency(schedule, plan, opts) {
   } else if (plan.hours.kind === "window") {
     phrase += " " + hourWindow(plan.hours, opts);
   } else if (plan.hours.kind === "step") {
-    phrase += ", " + stepHourSpan(stepSegment(schedule, "hour"), opts);
+    phrase = withoutHourAnchor(phrase) + ", " + stepHourSpan(stepSegment(schedule, "hour"), opts);
   }
   return phrase + trailingQualifier(schedule, opts);
 }
@@ -533,7 +537,7 @@ function renderMinuteSpanAcrossHourStep(schedule, plan, opts) {
   if (plan.form === "wildcard") {
     return "a cada minuto, " + stepHourSpan(segment, opts) + trailingQualifier(schedule, opts);
   }
-  const lead = plan.form === "list" ? minutesList(schedule, opts) : minuteRangeLead(schedule.pattern.minute);
+  const lead = withoutHourAnchor(plan.form === "list" ? minutesList(schedule, opts) : minuteRangeLead(schedule.pattern.minute));
   return lead + ", " + (cadence ?? stepHours(segment, opts)) + trailingQualifier(schedule, opts);
 }
 function renderEveryHour(schedule, plan, opts) {
@@ -838,7 +842,7 @@ function renderCompactClockTimes(schedule, plan, opts) {
     );
   }
   const cadence = unevenHourCadence(schedule, opts);
-  const phrase = cadence ? minutesList(schedule, opts) + ", " + cadence + trailingQualifier(schedule, opts) : minutesList(schedule, opts) + ", " + hourContextTimes(schedule, opts) + trailingQualifier(schedule, opts);
+  const phrase = cadence ? withoutHourAnchor(minutesList(schedule, opts)) + ", " + cadence + trailingQualifier(schedule, opts) : minutesList(schedule, opts) + ", " + hourContextTimes(schedule, opts) + trailingQualifier(schedule, opts);
   return schedule.analyses.clockSecond ? secondsLeadClause(schedule, opts) + ", " + phrase : phrase;
 }
 var renderers = {

package/dist/lang/zh.cjs

@@ -346,6 +346,9 @@ function minuteHourClause(schedule) {
 function renderMinutePast(schedule) {
   return minuteHourClause(schedule);
 }
+function withoutHourAnchor(clause) {
+  return clause.replace(/^每小时/, "");
+}
 function hourSegmentWords(segment) {
   if (segment.kind === "range") {
     return [hourWord(+segment.bounds[0]) + "\u81F3" + hourWord(+segment.bounds[1])];
@@ -373,7 +376,8 @@ function renderMinuteFrequency(schedule, plan) {
   if (hours.kind === "step" || hours.kind === "during") {
     const hourCad = unevenHourCadence(schedule);
     if (hourCad !== null) {
-      return hourCad + (hourCad.indexOf("\u81F3") === -1 ? "" : "\uFF0C") + base;
+      const minuteBase = hours.kind === "step" ? withoutHourAnchor(base) : base;
+      return hourCad + (hourCad.indexOf("\u81F3") === -1 ? "" : "\uFF0C") + minuteBase;
     }
   }
   if (hours.kind === "window" && hours.from === hours.to) {
@@ -406,9 +410,9 @@ function renderMinuteSpanAcrossHourStep(schedule, plan) {
   const hourStep = stepSegment(schedule, "hour");
   const { form } = plan;
   if (form === "list") {
-    return hourCadencePhrase(schedule) + "\uFF0C" + renderMinutePast(schedule);
+    return hourCadencePhrase(schedule) + "\uFF0C" + withoutHourAnchor(renderMinutePast(schedule));
   }
-  const minuteTail = form === "wildcard" ? "\u6BCF\u5206\u949F" : minuteHourClause(schedule) + "\uFF0C\u6BCF\u5206\u949F";
+  const minuteTail = form === "wildcard" ? "\u6BCF\u5206\u949F" : withoutHourAnchor(minuteHourClause(schedule)) + "\uFF0C\u6BCF\u5206\u949F";
   if (hourStep.startToken !== "*") {
     return hourCadencePhrase(schedule) + "\uFF0C" + minuteTail;
   }
@@ -436,7 +440,7 @@ function renderCompactClockTimes(schedule, plan) {
   const tail = secs.length && schedule.pattern.second !== "0" ? "\uFF0C\u7B2C" + valueText(secs) + "\u79D2" : "";
   if (!compact.fold) {
     const hourCad = unevenHourCadence(schedule);
-    return hourCad === null ? minuteHourClause(schedule) + "\uFF0C\u5728" + hourList(schedule) + tail : hourCad + "\uFF0C" + minuteHourClause(schedule) + tail;
+    return hourCad === null ? minuteHourClause(schedule) + "\uFF0C\u5728" + hourList(schedule) + tail : hourCad + "\uFF0C" + withoutHourAnchor(minuteHourClause(schedule)) + tail;
   }
   if (compact.minute > 0) {
     return minuteHourClause(schedule) + "\uFF0C\u5728" + hourList(schedule) + tail;
@@ -599,6 +603,10 @@ function composeSecondsOnHour(schedule, plan, opts) {
   if (composedClock && schedule.pattern.minute === "0") {
     return composeMinuteZeroClocks(schedule, sec);
   }
+  const fusedSingleMinute = composeSingleMinuteClocks(schedule, rest, sec, opts);
+  if (fusedSingleMinute !== null) {
+    return fusedSingleMinute;
+  }
   const restText = render(schedule, rest, opts);
   const secTail = clockRestCarriesSecond(rest) ? "" : sec;
   if (composedClock && isDaily(schedule)) {
@@ -609,6 +617,13 @@ function composeSecondsOnHour(schedule, plan, opts) {
   }
   return restText + secTail;
 }
+function composeSingleMinuteClocks(schedule, rest, sec, opts) {
+  if (rest.kind !== "clockTimes" || schedule.shapes.minute !== "single" || clockRestCarriesSecond(rest)) {
+    return null;
+  }
+  const core = render(schedule, rest, opts) + minuteZeroSecondTail(schedule, sec);
+  return isDaily(schedule) ? "\u6BCF\u5929" + core : core;
+}
 function composeMinuteZeroClocks(schedule, sec) {
   if (hasHourWindow(schedule)) {
     return isDaily(schedule) ? "\u6BCF\u5929" + hourRangeWindow(schedule, sec) : hourRangeWindow(schedule, sec);
@@ -616,11 +631,16 @@ function composeMinuteZeroClocks(schedule, sec) {
   const clocks = hourFires(schedule).map(function clock(hour) {
     return hour === 12 ? "\u6B63\u5348" : hourWord(hour) + "0\u5206";
   });
-  const nested = strideFromSegments(segmentsOf(schedule, "second"), "\u79D2", "\u79D2", "");
-  const tail = sec === "\u6BCF\u79D2" ? "\u7684\u6BCF\u4E00\u79D2" : "\u7684" + (nested ?? sec);
-  const core = joinAnd(clocks) + tail;
+  const core = joinAnd(clocks) + minuteZeroSecondTail(schedule, sec);
   return isDaily(schedule) ? "\u6BCF\u5929" + core : core;
 }
+function minuteZeroSecondTail(schedule, sec) {
+  if (sec === "\u6BCF\u79D2") {
+    return "\u7684\u6BCF\u4E00\u79D2";
+  }
+  const nested = strideFromSegments(segmentsOf(schedule, "second"), "\u79D2", "\u79D2", "");
+  return "\u7684" + (nested ?? sec);
+}
 function hasHourWindow(schedule) {
   return segmentsOf(schedule, "hour").some(function range(segment) {
     return segment.kind === "range";
@@ -667,7 +687,7 @@ function composeSecondsListed(schedule) {
   }
   const hourCad = unevenHourCadence(schedule);
   if (hourCad !== null) {
-    return hourCad + "\uFF0C" + minutes + "\uFF0C" + sec;
+    return hourCad + "\uFF0C" + withoutHourAnchor(minutes) + "\uFF0C" + sec;
   }
   return hourFrame(schedule) + minutes + "\uFF0C" + sec;
 }
@@ -945,6 +965,7 @@ function normalizeOptions(options) {
   return {
     ampm: typeof options.ampm === "boolean" ? options.ampm : false,
     lenient: !!options.lenient,
+    quartz: !!options.quartz,
     seconds: !!options.seconds,
     short: !!options.short,
     style,

package/dist/lang/zh.js

@@ -320,6 +320,9 @@ function minuteHourClause(schedule) {
 function renderMinutePast(schedule) {
   return minuteHourClause(schedule);
 }
+function withoutHourAnchor(clause) {
+  return clause.replace(/^每小时/, "");
+}
 function hourSegmentWords(segment) {
   if (segment.kind === "range") {
     return [hourWord(+segment.bounds[0]) + "\u81F3" + hourWord(+segment.bounds[1])];
@@ -347,7 +350,8 @@ function renderMinuteFrequency(schedule, plan) {
   if (hours.kind === "step" || hours.kind === "during") {
     const hourCad = unevenHourCadence(schedule);
     if (hourCad !== null) {
-      return hourCad + (hourCad.indexOf("\u81F3") === -1 ? "" : "\uFF0C") + base;
+      const minuteBase = hours.kind === "step" ? withoutHourAnchor(base) : base;
+      return hourCad + (hourCad.indexOf("\u81F3") === -1 ? "" : "\uFF0C") + minuteBase;
     }
   }
   if (hours.kind === "window" && hours.from === hours.to) {
@@ -380,9 +384,9 @@ function renderMinuteSpanAcrossHourStep(schedule, plan) {
   const hourStep = stepSegment(schedule, "hour");
   const { form } = plan;
   if (form === "list") {
-    return hourCadencePhrase(schedule) + "\uFF0C" + renderMinutePast(schedule);
+    return hourCadencePhrase(schedule) + "\uFF0C" + withoutHourAnchor(renderMinutePast(schedule));
   }
-  const minuteTail = form === "wildcard" ? "\u6BCF\u5206\u949F" : minuteHourClause(schedule) + "\uFF0C\u6BCF\u5206\u949F";
+  const minuteTail = form === "wildcard" ? "\u6BCF\u5206\u949F" : withoutHourAnchor(minuteHourClause(schedule)) + "\uFF0C\u6BCF\u5206\u949F";
   if (hourStep.startToken !== "*") {
     return hourCadencePhrase(schedule) + "\uFF0C" + minuteTail;
   }
@@ -410,7 +414,7 @@ function renderCompactClockTimes(schedule, plan) {
   const tail = secs.length && schedule.pattern.second !== "0" ? "\uFF0C\u7B2C" + valueText(secs) + "\u79D2" : "";
   if (!compact.fold) {
     const hourCad = unevenHourCadence(schedule);
-    return hourCad === null ? minuteHourClause(schedule) + "\uFF0C\u5728" + hourList(schedule) + tail : hourCad + "\uFF0C" + minuteHourClause(schedule) + tail;
+    return hourCad === null ? minuteHourClause(schedule) + "\uFF0C\u5728" + hourList(schedule) + tail : hourCad + "\uFF0C" + withoutHourAnchor(minuteHourClause(schedule)) + tail;
   }
   if (compact.minute > 0) {
     return minuteHourClause(schedule) + "\uFF0C\u5728" + hourList(schedule) + tail;
@@ -573,6 +577,10 @@ function composeSecondsOnHour(schedule, plan, opts) {
   if (composedClock && schedule.pattern.minute === "0") {
     return composeMinuteZeroClocks(schedule, sec);
   }
+  const fusedSingleMinute = composeSingleMinuteClocks(schedule, rest, sec, opts);
+  if (fusedSingleMinute !== null) {
+    return fusedSingleMinute;
+  }
   const restText = render(schedule, rest, opts);
   const secTail = clockRestCarriesSecond(rest) ? "" : sec;
   if (composedClock && isDaily(schedule)) {
@@ -583,6 +591,13 @@ function composeSecondsOnHour(schedule, plan, opts) {
   }
   return restText + secTail;
 }
+function composeSingleMinuteClocks(schedule, rest, sec, opts) {
+  if (rest.kind !== "clockTimes" || schedule.shapes.minute !== "single" || clockRestCarriesSecond(rest)) {
+    return null;
+  }
+  const core = render(schedule, rest, opts) + minuteZeroSecondTail(schedule, sec);
+  return isDaily(schedule) ? "\u6BCF\u5929" + core : core;
+}
 function composeMinuteZeroClocks(schedule, sec) {
   if (hasHourWindow(schedule)) {
     return isDaily(schedule) ? "\u6BCF\u5929" + hourRangeWindow(schedule, sec) : hourRangeWindow(schedule, sec);
@@ -590,11 +605,16 @@ function composeMinuteZeroClocks(schedule, sec) {
   const clocks = hourFires(schedule).map(function clock(hour) {
     return hour === 12 ? "\u6B63\u5348" : hourWord(hour) + "0\u5206";
   });
-  const nested = strideFromSegments(segmentsOf(schedule, "second"), "\u79D2", "\u79D2", "");
-  const tail = sec === "\u6BCF\u79D2" ? "\u7684\u6BCF\u4E00\u79D2" : "\u7684" + (nested ?? sec);
-  const core = joinAnd(clocks) + tail;
+  const core = joinAnd(clocks) + minuteZeroSecondTail(schedule, sec);
   return isDaily(schedule) ? "\u6BCF\u5929" + core : core;
 }
+function minuteZeroSecondTail(schedule, sec) {
+  if (sec === "\u6BCF\u79D2") {
+    return "\u7684\u6BCF\u4E00\u79D2";
+  }
+  const nested = strideFromSegments(segmentsOf(schedule, "second"), "\u79D2", "\u79D2", "");
+  return "\u7684" + (nested ?? sec);
+}
 function hasHourWindow(schedule) {
   return segmentsOf(schedule, "hour").some(function range(segment) {
     return segment.kind === "range";
@@ -641,7 +661,7 @@ function composeSecondsListed(schedule) {
   }
   const hourCad = unevenHourCadence(schedule);
   if (hourCad !== null) {
-    return hourCad + "\uFF0C" + minutes + "\uFF0C" + sec;
+    return hourCad + "\uFF0C" + withoutHourAnchor(minutes) + "\uFF0C" + sec;
   }
   return hourFrame(schedule) + minutes + "\uFF0C" + sec;
 }
@@ -919,6 +939,7 @@ function normalizeOptions(options) {
   return {
     ampm: typeof options.ampm === "boolean" ? options.ampm : false,
     lenient: !!options.lenient,
+    quartz: !!options.quartz,
     seconds: !!options.seconds,
     short: !!options.short,
     style,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "cronli5",
-  "version": "0.7.2",
+  "version": "0.8.2",
   "description": "Cron Like I'm Five: A Cron to English Utility",
   "repository": {
     "type": "git",

package/src/core/index.ts

@@ -5,16 +5,20 @@
 
 import {applyQuartzAliases, normalizeCronPattern} from './normalize.js';
 import type {NormalizedOptions, Pattern} from './schedule.js';
+import {applyQuartz} from './quartz.js';
 import {parseCronPattern} from './parse.js';
 import type {CronPattern} from '../types.js';
 import {validateCronPattern} from './validate.js';
 
-// Parse, alias, validate, and normalize cron input into a canonical
-// cron-like object of string fields, ready for semantic analysis and
-// rendering.
+// Parse, apply Quartz semantics, alias, validate, and normalize cron input
+// into a canonical cron-like object of string fields, ready for semantic
+// analysis and rendering. Quartz handling runs first: it gates the `?` token
+// (rejected unless `quartz`) and re-indexes the Quartz day-of-week to the
+// canonical cron numbering the rest of the core expects.
 function prepare(cronPattern: CronPattern, opts: NormalizedOptions): Pattern {
   const pattern = parseCronPattern(cronPattern, opts);
 
+  applyQuartz(pattern, opts.quartz);
   applyQuartzAliases(pattern);
   validateCronPattern(pattern);
 

package/src/core/quartz.ts

@@ -0,0 +1,97 @@
+// Quartz input semantics. cronli5 accepts Quartz tokens (`?`, `L`, `W`, `#`),
+// but Quartz numbers the day-of-week differently from standard cron: Quartz is
+// 1 = Sunday … 7 = Saturday, while cron is 0/7 = Sunday, 1 = Monday. Reading a
+// Quartz pattern with cron indexing silently shifts every weekday by one, so a
+// Quartz `2` (Monday) would read as Tuesday. This module gates and re-indexes
+// the input so the rest of the core keeps facing canonical cron values.
+//
+// The `?` token (Quartz's "no specific value", mandatory in Quartz, absent in
+// standard cron) is the unambiguous mark of a Quartz pattern. Outside Quartz
+// mode it is rejected outright rather than aliased to `*`, so a real Quartz
+// cron errors loudly instead of being mis-read; inside Quartz mode it is the
+// equivalent of `*`.
+
+import type {CronLike} from './specs.js';
+import {isNonNegativeInteger} from './util.js';
+
+// The error a `?` raises outside Quartz mode: a clear pointer at the option
+// that makes Quartz semantics (and `?`) available.
+const quartzTokenMessage =
+  '`?` is a Quartz token — pass { quartz: true } to enable Quartz semantics.';
+
+// In standard (non-Quartz) mode, `?` is not a valid value: reject it with a
+// pointer at the `quartz` option. In Quartz mode, accept `?` as `*` and
+// re-index the day-of-week from Quartz numbering (1 = Sunday) to the canonical
+// cron numbering (0 = Sunday) the rest of the core expects. Operates in place
+// on the raw cron-like object, before aliasing and validation.
+function applyQuartz(cronPattern: CronLike, quartz: boolean): void {
+  if (!quartz) {
+    rejectQuartzToken(cronPattern.date);
+    rejectQuartzToken(cronPattern.weekday);
+
+    return;
+  }
+
+  if ('' + cronPattern.date === '?') {
+    cronPattern.date = '*';
+  }
+
+  if ('' + cronPattern.weekday === '?') {
+    cronPattern.weekday = '*';
+
+    return;
+  }
+
+  cronPattern.weekday = reindexWeekday('' + cronPattern.weekday);
+}
+
+// Throw the Quartz-token error if a field is exactly `?`.
+function rejectQuartzToken(value: string | number): void {
+  if ('' + value === '?') {
+    throw new Error(quartzTokenMessage);
+  }
+}
+
+// Re-index a Quartz day-of-week field to canonical cron numbering. Every
+// numeric weekday position maps n -> n-1 (Quartz 1 = Sunday becomes cron 0),
+// across singles, ranges, and step bounds, and inside the DOW operators `nL`
+// (last weekday) and `n#k` (kth weekday). Day NAMES (`MON`) are unambiguous and
+// left untouched, as is the bare `L` alias (Saturday in both numberings) and
+// `*`. Quartz has no weekday 0; it is rejected here.
+function reindexWeekday(value: string): string {
+  if (value === '*') {
+    return value;
+  }
+
+  return value.split(',').map(reindexSegment).join(',');
+}
+
+// Re-index one comma-separated weekday segment: a single, a range, or either
+// of those followed by a `#k` or `L` operator (or a `/step`).
+function reindexSegment(segment: string): string {
+  const operator = (/(#\d+|L)$/).exec(segment);
+  const suffix = operator ? operator[0] : '';
+  const core = suffix ? segment.slice(0, -suffix.length) : segment;
+  const step = core.split('/');
+  const range = step[0].split('-').map(reindexNumber).join('-');
+  const head = step.length === 2 ? range + '/' + step[1] : range;
+
+  return head + suffix;
+}
+
+// Re-index a single weekday token: a number maps n -> n-1 (rejecting 0, which
+// Quartz does not use); a name passes through unchanged.
+function reindexNumber(token: string): string {
+  if (!isNonNegativeInteger(token)) {
+    return token;
+  }
+
+  if (token === '0') {
+    throw new Error('`cronli5` was passed an invalid Quartz day-of-week ' +
+      'value "0"; Quartz numbers weekdays 1 (Sunday) through 7 (Saturday).');
+  }
+
+  return '' + (+token - 1);
+}
+
+export {applyQuartz, quartzTokenMessage};

package/src/core/schedule.ts

@@ -147,6 +147,7 @@ export interface DialectStyle {
 export interface NormalizedOptions<Style = DialectStyle> {
   ampm: boolean;
   lenient: boolean;
+  quartz: boolean;
   seconds: boolean;
   short: boolean;
   style: Style;

package/src/core/specs.ts

@@ -55,9 +55,9 @@ const fieldSpecs: Record<Field, FieldSpec> = {
   second: {cyclic: true, max: 59, min: 0, top: 59},
   minute: {cyclic: true, max: 59, min: 0, top: 59},
   hour: {cyclic: true, max: 23, min: 0, top: 23},
-  date: {aliases: {'?': '*'}, cyclic: true, max: 31, min: 1, top: 31},
+  date: {cyclic: true, max: 31, min: 1, top: 31},
   month: {cyclic: true, max: 12, min: 1, numbers: monthNumbers, top: 12},
-  weekday: {aliases: {'?': '*', L: '6'}, cyclic: true, max: 7, min: 0,
+  weekday: {aliases: {L: '6'}, cyclic: true, max: 7, min: 0,
     numbers: weekdayNumbers, top: 6},
   year: {max: 9999, min: 1970}
 };

package/src/cronli5.ts

@@ -29,7 +29,7 @@
 
 import {analyze, prepare} from './core/index.js';
 import type {NormalizedOptions} from './core/schedule.js';
-import type {CronPattern, Cronli5Language, Cronli5Options}
+import type {Cronli5, CronPattern, Cronli5Language, Cronli5Options}
   from './types.js';
 import en from './lang/en/index.js';
 
@@ -88,8 +88,25 @@ function interpretCronPattern(
   return lang.describe({...schedule, plan}, opts);
 }
 
-export default cronli5;
+// Two named convenience methods are attached to the callable export as sugar
+// over the `sentence` option: `.sentence(...)` forces the capitalized
+// standalone, `.fragment(...)` forces the embeddable fragment (the default).
+// The method's own intent wins, so a passed-through `sentence` flag is
+// overridden. There is no `toString` method on purpose — it would shadow
+// `Function.prototype.toString` (called arg-less by `String()`, template
+// literals, and console/debug) and break coercion; named methods sidestep that.
+function sentence(cronPattern: CronPattern, options?: Cronli5Options): string {
+  return cronli5(cronPattern, {...options, sentence: true});
+}
+
+function fragment(cronPattern: CronPattern, options?: Cronli5Options): string {
+  return cronli5(cronPattern, {...options, sentence: false});
+}
+
+const callable: Cronli5 = Object.assign(cronli5, {sentence, fragment});
+
+export default callable;
 export type {
-  Cronli5Dialect, Cronli5Language, Cronli5Options, CronPattern,
+  Cronli5, Cronli5Dialect, Cronli5Language, Cronli5Options, CronPattern,
   CronPatternObject
 } from './types.js';