@f-ewald/components 1.28.0 → 1.30.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (42) hide show
  1. package/README.md +4 -0
  2. package/custom-elements.json +1817 -84
  3. package/dist/countdown-timer.d.ts +31 -0
  4. package/dist/countdown-timer.d.ts.map +1 -0
  5. package/dist/countdown-timer.js +74 -0
  6. package/dist/countdown-timer.js.map +1 -0
  7. package/dist/cron-schedule.d.ts +55 -0
  8. package/dist/cron-schedule.d.ts.map +1 -0
  9. package/dist/cron-schedule.js +768 -0
  10. package/dist/cron-schedule.js.map +1 -0
  11. package/dist/fullscreen-button.d.ts +43 -0
  12. package/dist/fullscreen-button.d.ts.map +1 -0
  13. package/dist/fullscreen-button.js +172 -0
  14. package/dist/fullscreen-button.js.map +1 -0
  15. package/dist/index.d.ts +6 -1
  16. package/dist/index.d.ts.map +1 -1
  17. package/dist/index.js +5 -0
  18. package/dist/index.js.map +1 -1
  19. package/dist/scroll-dots.d.ts +54 -0
  20. package/dist/scroll-dots.d.ts.map +1 -0
  21. package/dist/scroll-dots.js +178 -0
  22. package/dist/scroll-dots.js.map +1 -0
  23. package/dist/timeline-container.d.ts +21 -5
  24. package/dist/timeline-container.d.ts.map +1 -1
  25. package/dist/timeline-container.js +35 -7
  26. package/dist/timeline-container.js.map +1 -1
  27. package/dist/timeline-entry.d.ts +32 -0
  28. package/dist/timeline-entry.d.ts.map +1 -1
  29. package/dist/timeline-entry.js +130 -3
  30. package/dist/timeline-entry.js.map +1 -1
  31. package/dist/utils/cron.d.ts +83 -0
  32. package/dist/utils/cron.d.ts.map +1 -0
  33. package/dist/utils/cron.js +409 -0
  34. package/dist/utils/cron.js.map +1 -0
  35. package/docs/countdown-timer.md +40 -0
  36. package/docs/cron-schedule.md +82 -0
  37. package/docs/fullscreen-button.md +70 -0
  38. package/docs/scroll-dots.md +65 -0
  39. package/docs/timeline-container.md +30 -6
  40. package/docs/timeline-entry.md +18 -0
  41. package/llms.txt +171 -8
  42. package/package.json +1 -1
@@ -1 +1 @@
1
- {"version":3,"file":"timeline-entry.js","sourceRoot":"","sources":["../src/timeline-entry.ts"],"names":[],"mappings":";;;;;;AAAA,OAAO,EAAE,UAAU,EAAE,GAAG,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,KAAK,CAAC;AACrD,OAAO,EAAE,aAAa,EAAE,QAAQ,EAAE,KAAK,EAAE,MAAM,mBAAmB,CAAC;AACnE,OAAO,oBAAoB,CAAC;AAC5B,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAGrC;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AAEI,IAAM,aAAa,GAAnB,MAAM,aAAc,SAAQ,UAAU;IAAtC;;QACL,uEAAuE;QAC3D,aAAQ,GAAkB,IAAI,CAAC;QAE3C;;;WAGG;QACS,UAAK,GAAoB,SAAS,CAAC;QAE/C;;;WAGG;QACyC,YAAO,GAAG,KAAK,CAAC;QAE5D;;;;WAIG;QACyC,YAAO,GAAG,KAAK,CAAC;QAE5D,gEAAgE;QAC/C,iBAAY,GAAG,KAAK,CAAC;IAsOxC,CAAC;aApOiB,WAAM,GAAG;QACvB,MAAM;QACN,GAAG,CAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;KAsLF;KACF,AAzLqB,CAyLpB;IAEO,iBAAiB;QACxB,KAAK,CAAC,iBAAiB,EAAE,CAAC;QAC1B,IAAI,CAAC,IAAI,CAAC,YAAY,CAAC,MAAM,CAAC;YAAE,IAAI,CAAC,YAAY,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC;IACxE,CAAC;IAED,6EAA6E;IACrE,qBAAqB,CAAC,KAAY;QACxC,IAAI,CAAC,YAAY,GAAI,KAAK,CAAC,MAA0B,CAAC,aAAa,CAAC,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC;IACpG,CAAC;IAEQ,MAAM;QACb,OAAO,IAAI,CAAA;;;;;YAKH,IAAI,CAAC,OAAO;YACZ,CAAC,CAAC,IAAI,CAAA;;;;;;;eAOH;YACH,CAAC,CAAC,IAAI,CAAA,oBAAoB,IAAI,CAAC,KAAK,WAAW;;;;oCAIvB,IAAI,CAAC,YAAY,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,OAAO;kDAClB,IAAI,CAAC,qBAAqB;;cAE9D,IAAI,CAAC,QAAQ;YACb,CAAC,CAAC,IAAI,CAAA,wCAAwC,IAAI,CAAC,QAAQ,mBAAmB;YAC9E,CAAC,CAAC,OAAO;;;;;KAKlB,CAAC;IACJ,CAAC;CACF,CAAA;AA5Pa;IAAX,QAAQ,EAAE;+CAAgC;AAM/B;IAAX,QAAQ,EAAE;4CAAoC;AAMH;IAA3C,QAAQ,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC;8CAAiB;AAOhB;IAA3C,QAAQ,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC;8CAAiB;AAG3C;IAAhB,KAAK,EAAE;mDAA8B;AAxB3B,aAAa;IADzB,aAAa,CAAC,gBAAgB,CAAC;GACnB,aAAa,CA8PzB","sourcesContent":["import { LitElement, css, html, nothing } from \"lit\";\nimport { customElement, property, state } from \"lit/decorators.js\";\nimport \"./relative-time.js\";\nimport { tokens } from \"./tokens.js\";\nimport type { StatusPillColor } from \"./status-pill.js\";\n\n/**\n * One event on a `timeline-container`: a dot on the vertical line, an optional\n * headline, a relative timestamp (\"3 hours ago\"), and freely nested content.\n * The connecting line is drawn here — its segment above the dot is hidden on\n * the first entry and the segment below is hidden on the last, so the line caps\n * exactly at the first and last dots. Only meaningful inside a\n * `timeline-container`; demonstrated through it.\n *\n * `datetime` is the entry's one timestamp. A nested element that has its own\n * timestamp prop (e.g. `chat-message`'s `timestamp`) should leave it unset —\n * setting both renders the same time twice.\n *\n * The dot's `color` types the entry using the shared status-pill palette —\n * `primary` by default, plus `neutral`, `info`, `success`, `warning`, and\n * `danger`.\n *\n * Set `compact` for dense, one-line system-status entries: it tightens the\n * vertical spacing and renders the content smaller and muted.\n *\n * Set `running` to replace the dot with an animated gray ring spinner,\n * indicating the entry represents in-progress work; `color` has no visible\n * effect while `running` is set.\n *\n * @element timeline-entry\n * @slot headline - Optional headline/title for the event.\n * @slot - The event content; nest any elements here.\n */\n@customElement(\"timeline-entry\")\nexport class TimelineEntry extends LitElement {\n /** ISO 8601 or SQLite datetime string, rendered as a relative time. */\n @property() datetime: string | null = null;\n\n /**\n * Visual type of the entry's dot, from the shared status-pill palette:\n * `primary` (default), `neutral`, `info`, `success`, `warning`, or `danger`.\n */\n @property() color: StatusPillColor = \"primary\";\n\n /**\n * Dense, one-line presentation for system-status entries: tighter vertical\n * spacing and smaller, muted content.\n */\n @property({ type: Boolean, reflect: true }) compact = false;\n\n /**\n * Shows an animated ring spinner in place of the dot, indicating the entry\n * represents in-progress work. Overrides `color` while set — the spinner\n * always uses the muted/gray palette.\n */\n @property({ type: Boolean, reflect: true }) running = false;\n\n /** Whether the headline slot currently has assigned content. */\n @state() private _hasHeadline = false;\n\n static override styles = [\n tokens,\n css`\n :host {\n display: block;\n font-family: var(\n --ui-font,\n ui-sans-serif,\n system-ui,\n sans-serif,\n \"Apple Color Emoji\",\n \"Segoe UI Emoji\",\n \"Segoe UI Symbol\",\n \"Noto Color Emoji\"\n );\n }\n .entry {\n display: flex;\n gap: 0.75rem;\n }\n .rail {\n position: relative;\n flex: 0 0 auto;\n width: 0.75rem;\n }\n .line {\n position: absolute;\n left: 50%;\n width: 2px;\n transform: translateX(-50%);\n background: var(--ui-border, #e2e8f0);\n }\n .line-top {\n top: 0;\n height: 0.5rem;\n }\n .line-bottom {\n top: 0.5rem;\n bottom: 0;\n }\n .dot {\n position: absolute;\n top: 0.125rem;\n left: 50%;\n width: 0.75rem;\n height: 0.75rem;\n transform: translateX(-50%);\n border-radius: 9999px;\n /* Same lighter-on-top token gradient as map-circle/user-avatar; the\n base color is swapped per the color property via the private\n --_dot var. */\n background: linear-gradient(\n to bottom,\n color-mix(in srgb, var(--_dot, var(--ui-primary, #4f46e5)) 70%, #ffffff) 0%,\n color-mix(in srgb, var(--_dot, var(--ui-primary, #4f46e5)) 70%, #000000) 100%\n );\n }\n .dot.neutral {\n --_dot: var(--ui-text-muted, #64748b);\n }\n .dot.info {\n --_dot: var(--ui-info, #0ea5e9);\n }\n .dot.primary {\n --_dot: var(--ui-primary, #4f46e5);\n }\n .dot.success {\n --_dot: var(--ui-success, #16a34a);\n }\n .dot.warning {\n --_dot: var(--ui-warning, #d97706);\n }\n .dot.danger {\n --_dot: var(--ui-danger, #dc2626);\n }\n .spinner {\n position: absolute;\n top: 0.125rem;\n left: 0;\n display: block;\n width: 0.75rem;\n height: 0.75rem;\n border-radius: 9999px;\n /* Opaque backing so the connecting line is masked exactly like it is\n behind the solid .dot, instead of showing through the ring's\n hollow center and corners. */\n background: var(--ui-surface, #ffffff);\n }\n .spinner svg {\n display: block;\n width: 100%;\n height: 100%;\n }\n .spinner-track {\n fill: none;\n stroke: color-mix(in srgb, var(--ui-text-muted, #64748b) 25%, transparent);\n stroke-width: 3;\n }\n .spinner-arc {\n fill: none;\n stroke: var(--ui-text-muted, #64748b);\n stroke-width: 3;\n stroke-linecap: round;\n /* r=9 gives a 56.55-unit circumference. Keeping the dash and gap\n total equal to that circumference makes the fixed-length arc loop\n seamlessly while its dash offset advances around the static ring. */\n stroke-dasharray: 42.41 14.14;\n animation: spinner-orbit 0.8s linear infinite;\n }\n @keyframes spinner-orbit {\n from {\n stroke-dashoffset: 0;\n }\n to {\n stroke-dashoffset: -56.55;\n }\n }\n @media (prefers-reduced-motion: reduce) {\n .spinner-arc {\n animation: none;\n }\n }\n @media (forced-colors: active) {\n .spinner {\n background: Canvas;\n }\n .spinner-track {\n stroke: GrayText;\n }\n .spinner-arc {\n stroke: CanvasText;\n }\n }\n :host(:first-child) .line-top {\n display: none;\n }\n :host(:last-child) .line-bottom {\n display: none;\n }\n .body {\n flex: 1 1 auto;\n min-width: 0;\n padding-bottom: 1.5rem;\n }\n :host(:last-child) .body {\n padding-bottom: 0;\n }\n .head {\n display: flex;\n align-items: baseline;\n gap: 0.5rem;\n flex-wrap: wrap;\n }\n .headline {\n font-weight: var(--ui-font-weight-semibold, 600);\n font-size: var(--ui-font-size, 0.875rem);\n line-height: var(--ui-line-height-tight, 1.25);\n color: var(--ui-text, #0f172a);\n }\n .headline.empty {\n display: none;\n }\n .time {\n font-size: var(--ui-font-size-sm, 0.75rem);\n line-height: var(--ui-line-height-tight, 1.25);\n color: var(--ui-text-muted, #64748b);\n }\n .content {\n margin-top: 0.25rem;\n font-size: var(--ui-font-size, 0.875rem);\n line-height: var(--ui-line-height-normal, 1.5);\n color: var(--ui-text, #0f172a);\n }\n :host([compact]) .body {\n padding-bottom: 0.5rem;\n }\n :host([compact]:last-child) .body {\n padding-bottom: 0;\n }\n :host([compact]) .content {\n margin-top: 0.125rem;\n font-size: var(--ui-font-size-sm, 0.75rem);\n color: var(--ui-text-muted, #64748b);\n }\n `,\n ];\n\n override connectedCallback(): void {\n super.connectedCallback();\n if (!this.hasAttribute(\"role\")) this.setAttribute(\"role\", \"listitem\");\n }\n\n /** Collapses the headline when nothing is slotted so the time sits alone. */\n private _onHeadlineSlotChange(event: Event): void {\n this._hasHeadline = (event.target as HTMLSlotElement).assignedNodes({ flatten: true }).length > 0;\n }\n\n override render() {\n return html`\n <div class=\"entry\">\n <div class=\"rail\" aria-hidden=\"true\">\n <span class=\"line line-top\"></span>\n <span class=\"line line-bottom\"></span>\n ${this.running\n ? html`\n <span class=\"spinner\">\n <svg viewBox=\"0 0 24 24\">\n <circle class=\"spinner-track\" cx=\"12\" cy=\"12\" r=\"9\"></circle>\n <circle class=\"spinner-arc\" cx=\"12\" cy=\"12\" r=\"9\"></circle>\n </svg>\n </span>\n `\n : html`<span class=\"dot ${this.color}\"></span>`}\n </div>\n <div class=\"body\">\n <div class=\"head\">\n <span class=\"headline ${this._hasHeadline ? \"\" : \"empty\"}\">\n <slot name=\"headline\" @slotchange=${this._onHeadlineSlotChange}></slot>\n </span>\n ${this.datetime\n ? html`<relative-time class=\"time\" datetime=${this.datetime}></relative-time>`\n : nothing}\n </div>\n <div class=\"content\"><slot></slot></div>\n </div>\n </div>\n `;\n }\n}\n\ndeclare global {\n interface HTMLElementTagNameMap {\n \"timeline-entry\": TimelineEntry;\n }\n}\n"]}
1
+ {"version":3,"file":"timeline-entry.js","sourceRoot":"","sources":["../src/timeline-entry.ts"],"names":[],"mappings":";;;;;;AAAA,OAAO,EAAE,UAAU,EAAE,GAAG,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,KAAK,CAAC;AACrD,OAAO,EAAE,aAAa,EAAE,QAAQ,EAAE,KAAK,EAAE,MAAM,mBAAmB,CAAC;AACnE,OAAO,oBAAoB,CAAC;AAC5B,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAGrC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAyCG;AAEI,IAAM,aAAa,GAAnB,MAAM,aAAc,SAAQ,UAAU;IAAtC;;QACL,uEAAuE;QAC3D,aAAQ,GAAkB,IAAI,CAAC;QAE3C,iFAAiF;QACrE,UAAK,GAAkB,IAAI,CAAC;QAExC;;;WAGG;QACyC,gBAAW,GAAG,KAAK,CAAC;QAEhE;;;WAGG;QACS,UAAK,GAAoB,SAAS,CAAC;QAE/C;;;WAGG;QACyC,YAAO,GAAG,KAAK,CAAC;QAE5D;;;;WAIG;QACyC,YAAO,GAAG,KAAK,CAAC;QAE5D,gEAAgE;QAC/C,iBAAY,GAAG,KAAK,CAAC;QAEtC,6DAA6D;QAC5C,cAAS,GAAG,KAAK,CAAC;IAuUrC,CAAC;aArUiB,WAAM,GAAG;QACvB,MAAM;QACN,GAAG,CAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;KA8PF;KACF,AAjQqB,CAiQpB;IAEO,iBAAiB;QACxB,KAAK,CAAC,iBAAiB,EAAE,CAAC;QAC1B,IAAI,CAAC,IAAI,CAAC,YAAY,CAAC,MAAM,CAAC;YAAE,IAAI,CAAC,YAAY,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC;IACxE,CAAC;IAED;;;;OAIG;IACK,WAAW;QACjB,MAAM,QAAQ,GACZ,IAAI,CAAC,KAAK,KAAK,IAAI,IAAI,IAAI,CAAC,KAAK,KAAK,EAAE;YACtC,CAAC,CAAC,IAAI,CAAA,GAAG,IAAI,CAAC,KAAK,EAAE;YACrB,CAAC,CAAC,IAAI,CAAC,QAAQ;gBACb,CAAC,CAAC,IAAI,CAAA,2BAA2B,IAAI,CAAC,QAAQ,mBAAmB;gBACjE,CAAC,CAAC,OAAO,CAAC;QAChB,4EAA4E;QAC5E,0EAA0E;QAC1E,oEAAoE;QACpE,MAAM,KAAK,GAAG,QAAQ,KAAK,OAAO,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC;QACtD,OAAO,IAAI,CAAA,qBAAqB,KAAK,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE;uCACjB,IAAI,CAAC,kBAAkB,IAAI,QAAQ;YAC9D,CAAC;IACX,CAAC;IAED,+EAA+E;IACvE,kBAAkB,CAAC,KAAY;QACrC,IAAI,CAAC,SAAS,GAAI,KAAK,CAAC,MAA0B,CAAC,aAAa,CAAC,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC;IACjG,CAAC;IAED,6EAA6E;IACrE,qBAAqB,CAAC,KAAY;QACxC,IAAI,CAAC,YAAY,GAAI,KAAK,CAAC,MAA0B,CAAC,aAAa,CAAC,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC;IACpG,CAAC;IAEQ,MAAM;QACb,OAAO,IAAI,CAAA;;UAEL,IAAI,CAAC,WAAW,CAAC,CAAC,CAAC,IAAI,CAAA,qBAAqB,IAAI,CAAC,WAAW,EAAE,QAAQ,CAAC,CAAC,CAAC,OAAO;;;;YAI9E,IAAI,CAAC,OAAO;YACZ,CAAC,CAAC,IAAI,CAAA;;;;;;;eAOH;YACH,CAAC,CAAC,IAAI,CAAA,oBAAoB,IAAI,CAAC,KAAK,WAAW;;;;oCAIvB,IAAI,CAAC,YAAY,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,OAAO;kDAClB,IAAI,CAAC,qBAAqB;;cAE9D,IAAI,CAAC,WAAW,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC,WAAW,EAAE;;;;;KAKxD,CAAC;IACJ,CAAC;CACF,CAAA;AAzWa;IAAX,QAAQ,EAAE;+CAAgC;AAG/B;IAAX,QAAQ,EAAE;4CAA6B;AAMI;IAA3C,QAAQ,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC;kDAAqB;AAMpD;IAAX,QAAQ,EAAE;4CAAoC;AAMH;IAA3C,QAAQ,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC;8CAAiB;AAOhB;IAA3C,QAAQ,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC;8CAAiB;AAG3C;IAAhB,KAAK,EAAE;mDAA8B;AAGrB;IAAhB,KAAK,EAAE;gDAA2B;AApCxB,aAAa;IADzB,aAAa,CAAC,gBAAgB,CAAC;GACnB,aAAa,CA2WzB","sourcesContent":["import { LitElement, css, html, nothing } from \"lit\";\nimport { customElement, property, state } from \"lit/decorators.js\";\nimport \"./relative-time.js\";\nimport { tokens } from \"./tokens.js\";\nimport type { StatusPillColor } from \"./status-pill.js\";\n\n/**\n * One event on a `timeline-container`: a dot on the vertical line, an optional\n * headline, a relative timestamp (\"3 hours ago\"), and freely nested content.\n * The connecting line is drawn here — its segment above the dot is hidden on\n * the first entry and the segment below is hidden on the last, so the line caps\n * exactly at the first and last dots. Only meaningful inside a\n * `timeline-container`; demonstrated through it.\n *\n * `datetime` is the entry's one timestamp. A nested element that has its own\n * timestamp prop (e.g. `chat-message`'s `timestamp`) should leave it unset —\n * setting both renders the same time twice.\n *\n * `label` is a free-text alternative for a timeline whose axis is not a wall\n * clock — a year, an era, a phase. It wins over `datetime` when both are set.\n * Slot `label` instead when it needs its own styling, since a property is\n * rendered inside this component's shadow DOM and cannot be reached from\n * outside.\n *\n * `alternating` is set by `timeline-container` and should not be set by hand:\n * it switches the entry to three columns — label, line, body — with the sides\n * swapping on every second entry. The entry fills whatever height it is given,\n * so the line spans it rather than only its content — do not override the\n * host's `display` from outside, since a light-DOM rule beats the `:host`\n * declaration this relies on.\n *\n * The dot's `color` types the entry using the shared status-pill palette —\n * `primary` by default, plus `neutral`, `info`, `success`, `warning`, and\n * `danger`.\n *\n * Set `compact` for dense, one-line system-status entries: it tightens the\n * vertical spacing and renders the content smaller and muted.\n *\n * Set `running` to replace the dot with an animated gray ring spinner,\n * indicating the entry represents in-progress work; `color` has no visible\n * effect while `running` is set.\n *\n * @element timeline-entry\n * @slot headline - Optional headline/title for the event.\n * @slot label - Optional replacement for the `label` property, for a label that\n * needs its own styling.\n * @slot - The event content; nest any elements here.\n */\n@customElement(\"timeline-entry\")\nexport class TimelineEntry extends LitElement {\n /** ISO 8601 or SQLite datetime string, rendered as a relative time. */\n @property() datetime: string | null = null;\n\n /** Free-text label shown in place of the relative time; wins over `datetime`. */\n @property() label: string | null = null;\n\n /**\n * Three-column alternating presentation. Set by `timeline-container` from its\n * own `layout`; setting it directly is not supported.\n */\n @property({ type: Boolean, reflect: true }) alternating = false;\n\n /**\n * Visual type of the entry's dot, from the shared status-pill palette:\n * `primary` (default), `neutral`, `info`, `success`, `warning`, or `danger`.\n */\n @property() color: StatusPillColor = \"primary\";\n\n /**\n * Dense, one-line presentation for system-status entries: tighter vertical\n * spacing and smaller, muted content.\n */\n @property({ type: Boolean, reflect: true }) compact = false;\n\n /**\n * Shows an animated ring spinner in place of the dot, indicating the entry\n * represents in-progress work. Overrides `color` while set — the spinner\n * always uses the muted/gray palette.\n */\n @property({ type: Boolean, reflect: true }) running = false;\n\n /** Whether the headline slot currently has assigned content. */\n @state() private _hasHeadline = false;\n\n /** Whether the label slot currently has assigned content. */\n @state() private _hasLabel = false;\n\n static override styles = [\n tokens,\n css`\n :host {\n display: block;\n font-family: var(\n --ui-font,\n ui-sans-serif,\n system-ui,\n sans-serif,\n \"Apple Color Emoji\",\n \"Segoe UI Emoji\",\n \"Segoe UI Symbol\",\n \"Noto Color Emoji\"\n );\n }\n .entry {\n display: flex;\n gap: 0.75rem;\n }\n .rail {\n position: relative;\n flex: 0 0 auto;\n width: 0.75rem;\n }\n .line {\n position: absolute;\n left: 50%;\n width: 2px;\n transform: translateX(-50%);\n background: var(--ui-border, #e2e8f0);\n }\n .line-top {\n top: 0;\n height: 0.5rem;\n }\n .line-bottom {\n top: 0.5rem;\n bottom: 0;\n }\n .dot {\n position: absolute;\n top: 0.125rem;\n left: 50%;\n width: 0.75rem;\n height: 0.75rem;\n transform: translateX(-50%);\n border-radius: 9999px;\n /* Same lighter-on-top token gradient as map-circle/user-avatar; the\n base color is swapped per the color property via the private\n --_dot var. */\n background: linear-gradient(\n to bottom,\n color-mix(in srgb, var(--_dot, var(--ui-primary, #4f46e5)) 70%, #ffffff) 0%,\n color-mix(in srgb, var(--_dot, var(--ui-primary, #4f46e5)) 70%, #000000) 100%\n );\n }\n .dot.neutral {\n --_dot: var(--ui-text-muted, #64748b);\n }\n .dot.info {\n --_dot: var(--ui-info, #0ea5e9);\n }\n .dot.primary {\n --_dot: var(--ui-primary, #4f46e5);\n }\n .dot.success {\n --_dot: var(--ui-success, #16a34a);\n }\n .dot.warning {\n --_dot: var(--ui-warning, #d97706);\n }\n .dot.danger {\n --_dot: var(--ui-danger, #dc2626);\n }\n .spinner {\n position: absolute;\n top: 0.125rem;\n left: 0;\n display: block;\n width: 0.75rem;\n height: 0.75rem;\n border-radius: 9999px;\n /* Opaque backing so the connecting line is masked exactly like it is\n behind the solid .dot, instead of showing through the ring's\n hollow center and corners. */\n background: var(--ui-surface, #ffffff);\n }\n .spinner svg {\n display: block;\n width: 100%;\n height: 100%;\n }\n .spinner-track {\n fill: none;\n stroke: color-mix(in srgb, var(--ui-text-muted, #64748b) 25%, transparent);\n stroke-width: 3;\n }\n .spinner-arc {\n fill: none;\n stroke: var(--ui-text-muted, #64748b);\n stroke-width: 3;\n stroke-linecap: round;\n /* r=9 gives a 56.55-unit circumference. Keeping the dash and gap\n total equal to that circumference makes the fixed-length arc loop\n seamlessly while its dash offset advances around the static ring. */\n stroke-dasharray: 42.41 14.14;\n animation: spinner-orbit 0.8s linear infinite;\n }\n @keyframes spinner-orbit {\n from {\n stroke-dashoffset: 0;\n }\n to {\n stroke-dashoffset: -56.55;\n }\n }\n @media (prefers-reduced-motion: reduce) {\n .spinner-arc {\n animation: none;\n }\n }\n @media (forced-colors: active) {\n .spinner {\n background: Canvas;\n }\n .spinner-track {\n stroke: GrayText;\n }\n .spinner-arc {\n stroke: CanvasText;\n }\n }\n :host(:first-child) .line-top {\n display: none;\n }\n :host(:last-child) .line-bottom {\n display: none;\n }\n .body {\n flex: 1 1 auto;\n min-width: 0;\n padding-bottom: 1.5rem;\n }\n :host(:last-child) .body {\n padding-bottom: 0;\n }\n .head {\n display: flex;\n align-items: baseline;\n gap: 0.5rem;\n flex-wrap: wrap;\n }\n .headline {\n font-weight: var(--ui-font-weight-semibold, 600);\n font-size: var(--ui-font-size, 0.875rem);\n line-height: var(--ui-line-height-tight, 1.25);\n color: var(--ui-text, #0f172a);\n }\n .headline.empty {\n display: none;\n }\n .time {\n font-size: var(--ui-font-size-sm, 0.75rem);\n line-height: var(--ui-line-height-tight, 1.25);\n color: var(--ui-text-muted, #64748b);\n }\n .content {\n margin-top: 0.25rem;\n font-size: var(--ui-font-size, 0.875rem);\n line-height: var(--ui-line-height-normal, 1.5);\n color: var(--ui-text, #0f172a);\n }\n :host([compact]) .body {\n padding-bottom: 0.5rem;\n }\n :host([compact]:last-child) .body {\n padding-bottom: 0;\n }\n :host([compact]) .content {\n margin-top: 0.125rem;\n font-size: var(--ui-font-size-sm, 0.75rem);\n color: var(--ui-text-muted, #64748b);\n }\n .time.empty {\n display: none;\n }\n\n /*\n * Alternating layout. minmax(0, 1fr) rather than a bare 1fr: an\n * auto-sized track grows to its content's minimum width, which would\n * push the middle column - and with it the line and dot - off center.\n */\n /* A grid host so its single auto row stretches to whatever height the\n consumer gives the entry. The line is drawn inside that row, so\n without this it spans only the content and leaves gaps between\n consecutive entries. Flex does not do this: with a content-sized\n height there is no free space for flex-grow to distribute. */\n :host([alternating]) {\n display: grid;\n }\n :host([alternating]) .entry {\n display: grid;\n grid-template-columns: minmax(0, 1fr) auto minmax(0, 1fr);\n align-items: center;\n column-gap: 1.5rem;\n }\n :host([alternating]) .meta,\n :host([alternating]) .rail,\n :host([alternating]) .body {\n grid-row: 1;\n }\n :host([alternating]) .meta {\n grid-column: 1;\n justify-self: end;\n text-align: right;\n }\n :host([alternating]) .rail {\n grid-column: 2;\n align-self: stretch;\n }\n :host([alternating]) .body {\n grid-column: 3;\n padding: 1.5rem 0;\n }\n :host([alternating]:nth-child(even)) .meta {\n grid-column: 3;\n justify-self: start;\n text-align: left;\n }\n :host([alternating]:nth-child(even)) .body {\n grid-column: 1;\n }\n /* The dot marks the middle of the entry rather than its headline, and\n the line runs the entry's full height so consecutive entries join. */\n :host([alternating]) .dot {\n top: 50%;\n transform: translate(-50%, -50%);\n }\n :host([alternating]) .spinner {\n top: 50%;\n transform: translateY(-50%);\n }\n :host([alternating]) .line-top {\n top: 0;\n height: 50%;\n }\n :host([alternating]) .line-bottom {\n top: 50%;\n bottom: 0;\n }\n :host([alternating]) .time {\n font-size: var(--ui-font-size-lg, 1rem);\n font-weight: var(--ui-font-weight-medium, 500);\n letter-spacing: var(--ui-tracking-wide, 0.04em);\n }\n `,\n ];\n\n override connectedCallback(): void {\n super.connectedCallback();\n if (!this.hasAttribute(\"role\")) this.setAttribute(\"role\", \"listitem\");\n }\n\n /**\n * The entry's one time/label element: a slotted label, else the `label`\n * property, else a relative time. Placed inline beside the headline in the\n * default layout and in its own column when alternating.\n */\n private _renderMeta() {\n const fallback =\n this.label !== null && this.label !== \"\"\n ? html`${this.label}`\n : this.datetime\n ? html`<relative-time datetime=${this.datetime}></relative-time>`\n : nothing;\n // Collapsed rather than omitted when there is nothing to show: the slot has\n // to stay in the tree for its slotchange to report late-assigned content,\n // but an empty span would otherwise still claim the head row's gap.\n const empty = fallback === nothing && !this._hasLabel;\n return html`<span class=\"time ${empty ? \"empty\" : \"\"}\">\n <slot name=\"label\" @slotchange=${this._onLabelSlotChange}>${fallback}</slot>\n </span>`;\n }\n\n /** Tracks whether the label slot has content, so an empty one can collapse. */\n private _onLabelSlotChange(event: Event): void {\n this._hasLabel = (event.target as HTMLSlotElement).assignedNodes({ flatten: true }).length > 0;\n }\n\n /** Collapses the headline when nothing is slotted so the time sits alone. */\n private _onHeadlineSlotChange(event: Event): void {\n this._hasHeadline = (event.target as HTMLSlotElement).assignedNodes({ flatten: true }).length > 0;\n }\n\n override render() {\n return html`\n <div class=\"entry\">\n ${this.alternating ? html`<div class=\"meta\">${this._renderMeta()}</div>` : nothing}\n <div class=\"rail\" aria-hidden=\"true\">\n <span class=\"line line-top\"></span>\n <span class=\"line line-bottom\"></span>\n ${this.running\n ? html`\n <span class=\"spinner\">\n <svg viewBox=\"0 0 24 24\">\n <circle class=\"spinner-track\" cx=\"12\" cy=\"12\" r=\"9\"></circle>\n <circle class=\"spinner-arc\" cx=\"12\" cy=\"12\" r=\"9\"></circle>\n </svg>\n </span>\n `\n : html`<span class=\"dot ${this.color}\"></span>`}\n </div>\n <div class=\"body\">\n <div class=\"head\">\n <span class=\"headline ${this._hasHeadline ? \"\" : \"empty\"}\">\n <slot name=\"headline\" @slotchange=${this._onHeadlineSlotChange}></slot>\n </span>\n ${this.alternating ? nothing : this._renderMeta()}\n </div>\n <div class=\"content\"><slot></slot></div>\n </div>\n </div>\n `;\n }\n}\n\ndeclare global {\n interface HTMLElementTagNameMap {\n \"timeline-entry\": TimelineEntry;\n }\n}\n"]}
@@ -0,0 +1,83 @@
1
+ /**
2
+ * Pure helpers for standard 5-field POSIX/Vixie cron expressions
3
+ * (`minute hour day-of-month month day-of-week`).
4
+ *
5
+ * Supported syntax: `*`, single values, lists (`,`), ranges (`-`), steps
6
+ * (`/`), three-letter month/weekday names, `7` as an alias for Sunday, and the
7
+ * `@yearly`/`@annually`/`@monthly`/`@weekly`/`@daily`/`@midnight`/`@hourly`
8
+ * shorthands. `?` is tolerated on the day fields (read as `*`) for
9
+ * Quartz-flavoured input but is never emitted. `@reboot` and the Quartz-only
10
+ * `L`/`W`/`#` characters are deliberately unsupported — they have no
11
+ * representation in the five numeric fields.
12
+ */
13
+ /** A single term within one cron field. */
14
+ export type CronTerm = {
15
+ kind: "all";
16
+ } | {
17
+ kind: "value";
18
+ value: number;
19
+ } | {
20
+ kind: "range";
21
+ from: number;
22
+ to: number;
23
+ } | {
24
+ kind: "step";
25
+ from: number;
26
+ to: number | null;
27
+ step: number;
28
+ };
29
+ /** One cron field: a non-empty, comma-joined list of terms. */
30
+ export type CronField = CronTerm[];
31
+ /** A parsed cron expression's five fields. */
32
+ export interface CronExpression {
33
+ minute: CronField;
34
+ hour: CronField;
35
+ dayOfMonth: CronField;
36
+ month: CronField;
37
+ dayOfWeek: CronField;
38
+ }
39
+ /** The preset form mode whose controls can round-trip an expression. */
40
+ export type CronFrequency = "minute" | "hourly" | "daily" | "weekly" | "monthly" | "yearly" | "advanced";
41
+ /** The five cron field names, in expression order. */
42
+ export declare const CRON_FIELD_NAMES: readonly ["minute", "hour", "dayOfMonth", "month", "dayOfWeek"];
43
+ /** One of the five cron field names. */
44
+ export type CronFieldName = (typeof CRON_FIELD_NAMES)[number];
45
+ /** Inclusive `[min, max]` value bounds for each cron field. */
46
+ export declare const CRON_FIELD_BOUNDS: Record<CronFieldName, [number, number]>;
47
+ /** Human-readable labels for each cron field. */
48
+ export declare const CRON_FIELD_LABELS: Record<CronFieldName, string>;
49
+ /** Full weekday names indexed by cron day-of-week value (0 = Sunday). */
50
+ export declare const WEEKDAY_NAMES: string[];
51
+ /** Three-letter weekday abbreviations indexed by cron value (0 = Sun). */
52
+ export declare const WEEKDAY_ABBREVIATIONS: string[];
53
+ /** Full month names indexed from 0, so month `n` is `MONTH_NAMES[n - 1]`. */
54
+ export declare const MONTH_NAMES: string[];
55
+ /** Three-letter month abbreviations indexed from 0 (`Jan` is month 1). */
56
+ export declare const MONTH_ABBREVIATIONS: string[];
57
+ /** Supported `@`-shorthands mapped to their five-field equivalents. */
58
+ export declare const CRON_ALIASES: Record<string, string>;
59
+ /**
60
+ * Parses a cron expression, expanding any supported `@`-shorthand first.
61
+ * Returns `null` when the input is not a valid supported expression.
62
+ */
63
+ export declare function parseCron(expression: string): CronExpression | null;
64
+ /** Serializes an expression canonically: numeric values, `*` for unconstrained fields. */
65
+ export declare function formatCron(expression: CronExpression): string;
66
+ /** Builds a field from an explicit list of values, or `[{ kind: "all" }]` when empty. */
67
+ export declare function fieldFromValues(values: number[]): CronField;
68
+ /** Every value a field matches, ascending and de-duplicated. */
69
+ export declare function expandField(field: CronField, name: CronFieldName): number[];
70
+ /** Whether a field is unconstrained (`*`, possibly among redundant terms). */
71
+ export declare function isEveryValue(field: CronField): boolean;
72
+ /**
73
+ * The preset form mode whose controls can reproduce `expression` exactly,
74
+ * or `"advanced"` when only the per-field editor can.
75
+ */
76
+ export declare function detectFrequency(expression: CronExpression): CronFrequency;
77
+ /**
78
+ * A compact English description of an expression, e.g. `"Every hour"`,
79
+ * `"10:17 every Monday"`, `"09:00 on day 1 of every month"`. Returns the raw
80
+ * input unchanged when it cannot be parsed.
81
+ */
82
+ export declare function describeCron(expression: string | CronExpression): string;
83
+ //# sourceMappingURL=cron.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"cron.d.ts","sourceRoot":"","sources":["../../src/utils/cron.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,2CAA2C;AAC3C,MAAM,MAAM,QAAQ,GAChB;IAAE,IAAI,EAAE,KAAK,CAAA;CAAE,GACf;IAAE,IAAI,EAAE,OAAO,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,GAChC;IAAE,IAAI,EAAE,OAAO,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,EAAE,EAAE,MAAM,CAAA;CAAE,GAC3C;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,EAAE,EAAE,MAAM,GAAG,IAAI,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAAC;AAEpE,+DAA+D;AAC/D,MAAM,MAAM,SAAS,GAAG,QAAQ,EAAE,CAAC;AAEnC,8CAA8C;AAC9C,MAAM,WAAW,cAAc;IAC7B,MAAM,EAAE,SAAS,CAAC;IAClB,IAAI,EAAE,SAAS,CAAC;IAChB,UAAU,EAAE,SAAS,CAAC;IACtB,KAAK,EAAE,SAAS,CAAC;IACjB,SAAS,EAAE,SAAS,CAAC;CACtB;AAED,wEAAwE;AACxE,MAAM,MAAM,aAAa,GACrB,QAAQ,GACR,QAAQ,GACR,OAAO,GACP,QAAQ,GACR,SAAS,GACT,QAAQ,GACR,UAAU,CAAC;AAEf,sDAAsD;AACtD,eAAO,MAAM,gBAAgB,YAC3B,QAAQ,EACR,MAAM,EACN,YAAY,EACZ,OAAO,EACP,WAAW,CACH,CAAC;AAEX,wCAAwC;AACxC,MAAM,MAAM,aAAa,GAAG,CAAC,OAAO,gBAAgB,CAAC,CAAC,MAAM,CAAC,CAAC;AAE9D,+DAA+D;AAC/D,eAAO,MAAM,iBAAiB,EAAE,MAAM,CAAC,aAAa,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC,CAMrE,CAAC;AAEF,iDAAiD;AACjD,eAAO,MAAM,iBAAiB,EAAE,MAAM,CAAC,aAAa,EAAE,MAAM,CAM3D,CAAC;AAEF,yEAAyE;AACzE,eAAO,MAAM,aAAa,UAQzB,CAAC;AAEF,0EAA0E;AAC1E,eAAO,MAAM,qBAAqB,UAAoD,CAAC;AAEvF,6EAA6E;AAC7E,eAAO,MAAM,WAAW,UAavB,CAAC;AAEF,0EAA0E;AAC1E,eAAO,MAAM,mBAAmB,UAa/B,CAAC;AAEF,uEAAuE;AACvE,eAAO,MAAM,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAQ/C,CAAC;AAwEF;;;GAGG;AACH,wBAAgB,SAAS,CAAC,UAAU,EAAE,MAAM,GAAG,cAAc,GAAG,IAAI,CAenE;AAaD,0FAA0F;AAC1F,wBAAgB,UAAU,CAAC,UAAU,EAAE,cAAc,GAAG,MAAM,CAI7D;AAED,yFAAyF;AACzF,wBAAgB,eAAe,CAAC,MAAM,EAAE,MAAM,EAAE,GAAG,SAAS,CAI3D;AAED,gEAAgE;AAChE,wBAAgB,WAAW,CAAC,KAAK,EAAE,SAAS,EAAE,IAAI,EAAE,aAAa,GAAG,MAAM,EAAE,CAgB3E;AAED,8EAA8E;AAC9E,wBAAgB,YAAY,CAAC,KAAK,EAAE,SAAS,GAAG,OAAO,CAEtD;AAwBD;;;GAGG;AACH,wBAAgB,eAAe,CAAC,UAAU,EAAE,cAAc,GAAG,aAAa,CA0BzE;AAmFD;;;;GAIG;AACH,wBAAgB,YAAY,CAAC,UAAU,EAAE,MAAM,GAAG,cAAc,GAAG,MAAM,CAoCxE"}
@@ -0,0 +1,409 @@
1
+ /**
2
+ * Pure helpers for standard 5-field POSIX/Vixie cron expressions
3
+ * (`minute hour day-of-month month day-of-week`).
4
+ *
5
+ * Supported syntax: `*`, single values, lists (`,`), ranges (`-`), steps
6
+ * (`/`), three-letter month/weekday names, `7` as an alias for Sunday, and the
7
+ * `@yearly`/`@annually`/`@monthly`/`@weekly`/`@daily`/`@midnight`/`@hourly`
8
+ * shorthands. `?` is tolerated on the day fields (read as `*`) for
9
+ * Quartz-flavoured input but is never emitted. `@reboot` and the Quartz-only
10
+ * `L`/`W`/`#` characters are deliberately unsupported — they have no
11
+ * representation in the five numeric fields.
12
+ */
13
+ /** The five cron field names, in expression order. */
14
+ export const CRON_FIELD_NAMES = [
15
+ "minute",
16
+ "hour",
17
+ "dayOfMonth",
18
+ "month",
19
+ "dayOfWeek",
20
+ ];
21
+ /** Inclusive `[min, max]` value bounds for each cron field. */
22
+ export const CRON_FIELD_BOUNDS = {
23
+ minute: [0, 59],
24
+ hour: [0, 23],
25
+ dayOfMonth: [1, 31],
26
+ month: [1, 12],
27
+ dayOfWeek: [0, 6],
28
+ };
29
+ /** Human-readable labels for each cron field. */
30
+ export const CRON_FIELD_LABELS = {
31
+ minute: "Minute",
32
+ hour: "Hour",
33
+ dayOfMonth: "Day of month",
34
+ month: "Month",
35
+ dayOfWeek: "Day of week",
36
+ };
37
+ /** Full weekday names indexed by cron day-of-week value (0 = Sunday). */
38
+ export const WEEKDAY_NAMES = [
39
+ "Sunday",
40
+ "Monday",
41
+ "Tuesday",
42
+ "Wednesday",
43
+ "Thursday",
44
+ "Friday",
45
+ "Saturday",
46
+ ];
47
+ /** Three-letter weekday abbreviations indexed by cron value (0 = Sun). */
48
+ export const WEEKDAY_ABBREVIATIONS = ["Sun", "Mon", "Tue", "Wed", "Thu", "Fri", "Sat"];
49
+ /** Full month names indexed from 0, so month `n` is `MONTH_NAMES[n - 1]`. */
50
+ export const MONTH_NAMES = [
51
+ "January",
52
+ "February",
53
+ "March",
54
+ "April",
55
+ "May",
56
+ "June",
57
+ "July",
58
+ "August",
59
+ "September",
60
+ "October",
61
+ "November",
62
+ "December",
63
+ ];
64
+ /** Three-letter month abbreviations indexed from 0 (`Jan` is month 1). */
65
+ export const MONTH_ABBREVIATIONS = [
66
+ "Jan",
67
+ "Feb",
68
+ "Mar",
69
+ "Apr",
70
+ "May",
71
+ "Jun",
72
+ "Jul",
73
+ "Aug",
74
+ "Sep",
75
+ "Oct",
76
+ "Nov",
77
+ "Dec",
78
+ ];
79
+ /** Supported `@`-shorthands mapped to their five-field equivalents. */
80
+ export const CRON_ALIASES = {
81
+ "@yearly": "0 0 1 1 *",
82
+ "@annually": "0 0 1 1 *",
83
+ "@monthly": "0 0 1 * *",
84
+ "@weekly": "0 0 * * 0",
85
+ "@daily": "0 0 * * *",
86
+ "@midnight": "0 0 * * *",
87
+ "@hourly": "0 * * * *",
88
+ };
89
+ const NAME_LOOKUPS = {
90
+ month: Object.fromEntries(MONTH_ABBREVIATIONS.map((name, index) => [name.toLowerCase(), index + 1])),
91
+ dayOfWeek: Object.fromEntries(WEEKDAY_ABBREVIATIONS.map((name, index) => [name.toLowerCase(), index])),
92
+ };
93
+ function parseValue(token, field) {
94
+ const named = NAME_LOOKUPS[field]?.[token.toLowerCase()];
95
+ if (named !== undefined)
96
+ return named;
97
+ if (!/^\d+$/.test(token))
98
+ return null;
99
+ const value = Number(token);
100
+ const [min, max] = CRON_FIELD_BOUNDS[field];
101
+ // Vixie cron accepts 7 as a second spelling of Sunday.
102
+ if (field === "dayOfWeek" && value === 7)
103
+ return 0;
104
+ return value >= min && value <= max ? value : null;
105
+ }
106
+ function parseTerm(token, field) {
107
+ const [base, stepToken, ...rest] = token.split("/");
108
+ if (rest.length > 0 || base === undefined || base === "")
109
+ return null;
110
+ if (stepToken !== undefined) {
111
+ if (!/^\d+$/.test(stepToken))
112
+ return null;
113
+ const step = Number(stepToken);
114
+ if (step < 1)
115
+ return null;
116
+ const [min, max] = CRON_FIELD_BOUNDS[field];
117
+ if (base === "*" || base === "?")
118
+ return { kind: "step", from: min, to: null, step };
119
+ const range = base.split("-");
120
+ if (range.length === 1) {
121
+ const from = parseValue(range[0], field);
122
+ return from === null ? null : { kind: "step", from, to: null, step };
123
+ }
124
+ if (range.length !== 2)
125
+ return null;
126
+ const from = parseValue(range[0], field);
127
+ const to = parseValue(range[1], field);
128
+ if (from === null || to === null || to < from || to > max)
129
+ return null;
130
+ return { kind: "step", from, to, step };
131
+ }
132
+ if (base === "*" || base === "?")
133
+ return { kind: "all" };
134
+ const range = base.split("-");
135
+ if (range.length === 1) {
136
+ const value = parseValue(range[0], field);
137
+ return value === null ? null : { kind: "value", value };
138
+ }
139
+ if (range.length !== 2)
140
+ return null;
141
+ const from = parseValue(range[0], field);
142
+ const to = parseValue(range[1], field);
143
+ if (from === null || to === null || to < from)
144
+ return null;
145
+ return { kind: "range", from, to };
146
+ }
147
+ function parseField(text, field) {
148
+ const tokens = text.split(",");
149
+ const terms = [];
150
+ for (const token of tokens) {
151
+ const term = parseTerm(token.trim(), field);
152
+ if (!term)
153
+ return null;
154
+ terms.push(term);
155
+ }
156
+ return terms.length > 0 ? terms : null;
157
+ }
158
+ /**
159
+ * Parses a cron expression, expanding any supported `@`-shorthand first.
160
+ * Returns `null` when the input is not a valid supported expression.
161
+ */
162
+ export function parseCron(expression) {
163
+ const trimmed = expression.trim();
164
+ if (!trimmed)
165
+ return null;
166
+ const expanded = CRON_ALIASES[trimmed.toLowerCase()] ?? trimmed;
167
+ const parts = expanded.split(/\s+/);
168
+ if (parts.length !== CRON_FIELD_NAMES.length)
169
+ return null;
170
+ const fields = {};
171
+ for (const [index, name] of CRON_FIELD_NAMES.entries()) {
172
+ const parsed = parseField(parts[index], name);
173
+ if (!parsed)
174
+ return null;
175
+ fields[name] = parsed;
176
+ }
177
+ return fields;
178
+ }
179
+ function formatTerm(term, field) {
180
+ if (term.kind === "all")
181
+ return "*";
182
+ if (term.kind === "value")
183
+ return String(term.value);
184
+ if (term.kind === "range")
185
+ return `${term.from}-${term.to}`;
186
+ const [min, max] = CRON_FIELD_BOUNDS[field];
187
+ const end = term.to ?? max;
188
+ if (term.from === min && end === max)
189
+ return `*/${term.step}`;
190
+ return `${term.from}-${end}/${term.step}`;
191
+ }
192
+ /** Serializes an expression canonically: numeric values, `*` for unconstrained fields. */
193
+ export function formatCron(expression) {
194
+ return CRON_FIELD_NAMES.map((name) => expression[name].map((term) => formatTerm(term, name)).join(",")).join(" ");
195
+ }
196
+ /** Builds a field from an explicit list of values, or `[{ kind: "all" }]` when empty. */
197
+ export function fieldFromValues(values) {
198
+ const unique = [...new Set(values)].sort((a, b) => a - b);
199
+ if (unique.length === 0)
200
+ return [{ kind: "all" }];
201
+ return unique.map((value) => ({ kind: "value", value }));
202
+ }
203
+ /** Every value a field matches, ascending and de-duplicated. */
204
+ export function expandField(field, name) {
205
+ const [min, max] = CRON_FIELD_BOUNDS[name];
206
+ const values = new Set();
207
+ for (const term of field) {
208
+ if (term.kind === "all") {
209
+ for (let value = min; value <= max; value += 1)
210
+ values.add(value);
211
+ }
212
+ else if (term.kind === "value") {
213
+ values.add(term.value);
214
+ }
215
+ else if (term.kind === "range") {
216
+ for (let value = term.from; value <= term.to; value += 1)
217
+ values.add(value);
218
+ }
219
+ else {
220
+ const end = term.to ?? max;
221
+ for (let value = term.from; value <= end; value += term.step)
222
+ values.add(value);
223
+ }
224
+ }
225
+ return [...values].sort((a, b) => a - b);
226
+ }
227
+ /** Whether a field is unconstrained (`*`, possibly among redundant terms). */
228
+ export function isEveryValue(field) {
229
+ return field.some((term) => term.kind === "all");
230
+ }
231
+ function singleValue(field) {
232
+ if (field.length !== 1)
233
+ return null;
234
+ const term = field[0];
235
+ return term.kind === "value" ? term.value : null;
236
+ }
237
+ function wholeFieldStep(field, name) {
238
+ if (field.length !== 1)
239
+ return null;
240
+ const term = field[0];
241
+ if (term.kind !== "step" || term.to !== null)
242
+ return null;
243
+ return term.from === CRON_FIELD_BOUNDS[name][0] ? term.step : null;
244
+ }
245
+ /**
246
+ * Whether a checkbox grid can represent the field, i.e. it selects a finite
247
+ * set of values. Ranges and steps qualify — the grid shows them checked and
248
+ * re-serializes them as a plain list once the user edits the selection.
249
+ */
250
+ function isSelectableSet(field) {
251
+ return !isEveryValue(field);
252
+ }
253
+ /**
254
+ * The preset form mode whose controls can reproduce `expression` exactly,
255
+ * or `"advanced"` when only the per-field editor can.
256
+ */
257
+ export function detectFrequency(expression) {
258
+ const { minute, hour, dayOfMonth, month, dayOfWeek } = expression;
259
+ const everyDayOfMonth = isEveryValue(dayOfMonth);
260
+ const everyMonth = isEveryValue(month);
261
+ const everyDayOfWeek = isEveryValue(dayOfWeek);
262
+ if (everyDayOfMonth && everyMonth && everyDayOfWeek) {
263
+ if (isEveryValue(hour)) {
264
+ if (isEveryValue(minute) || wholeFieldStep(minute, "minute") !== null)
265
+ return "minute";
266
+ if (singleValue(minute) !== null)
267
+ return "hourly";
268
+ return "advanced";
269
+ }
270
+ if (singleValue(minute) === null)
271
+ return "advanced";
272
+ if (wholeFieldStep(hour, "hour") !== null)
273
+ return "hourly";
274
+ if (singleValue(hour) !== null)
275
+ return "daily";
276
+ return "advanced";
277
+ }
278
+ if (singleValue(minute) === null || singleValue(hour) === null)
279
+ return "advanced";
280
+ if (everyDayOfMonth && everyMonth && isSelectableSet(dayOfWeek))
281
+ return "weekly";
282
+ if (everyDayOfWeek && isSelectableSet(dayOfMonth)) {
283
+ if (everyMonth)
284
+ return "monthly";
285
+ if (isSelectableSet(month))
286
+ return "yearly";
287
+ }
288
+ return "advanced";
289
+ }
290
+ function pad(value) {
291
+ return String(value).padStart(2, "0");
292
+ }
293
+ /** `"09:05"` for hour 9, minute 5. */
294
+ function formatTime(hour, minute) {
295
+ return `${pad(hour)}:${pad(minute)}`;
296
+ }
297
+ /** `"a, b and c"`. */
298
+ function joinList(parts) {
299
+ if (parts.length <= 1)
300
+ return parts[0] ?? "";
301
+ return `${parts.slice(0, -1).join(", ")} and ${parts.at(-1)}`;
302
+ }
303
+ function describeWeekdays(field) {
304
+ const days = expandField(field, "dayOfWeek");
305
+ if (days.length === 1)
306
+ return WEEKDAY_NAMES[days[0]];
307
+ return joinList(days.map((day) => WEEKDAY_ABBREVIATIONS[day]));
308
+ }
309
+ function describeMonthDays(field) {
310
+ const days = expandField(field, "dayOfMonth");
311
+ return joinList(days.map((day) => String(day)));
312
+ }
313
+ function describeMonths(field) {
314
+ const months = expandField(field, "month");
315
+ if (months.length === 1)
316
+ return MONTH_NAMES[months[0] - 1];
317
+ return joinList(months.map((month) => MONTH_ABBREVIATIONS[month - 1]));
318
+ }
319
+ function describeFieldTerms(field, name) {
320
+ const label = name === "month" ? "month" : name === "dayOfMonth" ? "day" : name;
321
+ const readable = (value) => {
322
+ if (name === "month")
323
+ return MONTH_ABBREVIATIONS[value - 1];
324
+ if (name === "dayOfWeek")
325
+ return WEEKDAY_ABBREVIATIONS[value];
326
+ return String(value);
327
+ };
328
+ const parts = field.map((term) => {
329
+ if (term.kind === "all")
330
+ return `every ${label}`;
331
+ if (term.kind === "value")
332
+ return readable(term.value);
333
+ if (term.kind === "range")
334
+ return `${readable(term.from)}–${readable(term.to)}`;
335
+ const [min, max] = CRON_FIELD_BOUNDS[name];
336
+ const end = term.to ?? max;
337
+ if (term.from === min && end === max)
338
+ return `every ${term.step}`;
339
+ return `every ${term.step} from ${readable(term.from)} to ${readable(end)}`;
340
+ });
341
+ return joinList(parts);
342
+ }
343
+ function describeDayScope(expression) {
344
+ const { dayOfMonth, month, dayOfWeek } = expression;
345
+ const everyDayOfMonth = isEveryValue(dayOfMonth);
346
+ const everyMonth = isEveryValue(month);
347
+ const everyDayOfWeek = isEveryValue(dayOfWeek);
348
+ if (everyDayOfMonth && everyMonth && everyDayOfWeek)
349
+ return "every day";
350
+ const parts = [];
351
+ if (!everyDayOfMonth) {
352
+ parts.push(everyMonth
353
+ ? `on day ${describeMonthDays(dayOfMonth)} of every month`
354
+ : `on ${describeMonthDays(dayOfMonth)} ${describeMonths(month)}`);
355
+ }
356
+ else if (!everyMonth) {
357
+ parts.push(`every day in ${describeMonths(month)}`);
358
+ }
359
+ // cron ORs day-of-month and day-of-week whenever both are restricted.
360
+ if (!everyDayOfWeek)
361
+ parts.push(`every ${describeWeekdays(dayOfWeek)}`);
362
+ return parts.join(parts.length > 1 ? " or " : "");
363
+ }
364
+ function describeAdvanced(expression) {
365
+ const parts = CRON_FIELD_NAMES.filter((name) => !isEveryValue(expression[name])).map((name) => `${CRON_FIELD_LABELS[name].toLowerCase()} ${describeFieldTerms(expression[name], name)}`);
366
+ return parts.length === 0 ? "Every minute" : `Custom: ${joinList(parts)}`;
367
+ }
368
+ /**
369
+ * A compact English description of an expression, e.g. `"Every hour"`,
370
+ * `"10:17 every Monday"`, `"09:00 on day 1 of every month"`. Returns the raw
371
+ * input unchanged when it cannot be parsed.
372
+ */
373
+ export function describeCron(expression) {
374
+ const parsed = typeof expression === "string" ? parseCron(expression) : expression;
375
+ if (!parsed)
376
+ return typeof expression === "string" ? expression.trim() : "";
377
+ const { minute, hour } = parsed;
378
+ const scope = describeDayScope(parsed);
379
+ const everyDay = scope === "every day";
380
+ const suffix = everyDay ? "" : ` ${scope}`;
381
+ if (isEveryValue(hour)) {
382
+ if (isEveryValue(minute))
383
+ return everyDay ? "Every minute" : `Every minute${suffix}`;
384
+ const minuteStep = wholeFieldStep(minute, "minute");
385
+ if (minuteStep !== null)
386
+ return `Every ${minuteStep} minutes${suffix}`;
387
+ const minuteValue = singleValue(minute);
388
+ if (minuteValue !== null) {
389
+ return minuteValue === 0
390
+ ? `Every hour${suffix}`
391
+ : `Every hour at :${pad(minuteValue)}${suffix}`;
392
+ }
393
+ return describeAdvanced(parsed);
394
+ }
395
+ const minuteValue = singleValue(minute);
396
+ if (minuteValue === null)
397
+ return describeAdvanced(parsed);
398
+ const hourStep = wholeFieldStep(hour, "hour");
399
+ if (hourStep !== null) {
400
+ const at = minuteValue === 0 ? "" : ` at :${pad(minuteValue)}`;
401
+ return `Every ${hourStep} hours${at}${suffix}`;
402
+ }
403
+ const hourValue = singleValue(hour);
404
+ if (hourValue === null)
405
+ return describeAdvanced(parsed);
406
+ const time = formatTime(hourValue, minuteValue);
407
+ return everyDay ? `${time} every day` : `${time} ${scope}`;
408
+ }
409
+ //# sourceMappingURL=cron.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"cron.js","sourceRoot":"","sources":["../../src/utils/cron.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * Pure helpers for standard 5-field POSIX/Vixie cron expressions\n * (`minute hour day-of-month month day-of-week`).\n *\n * Supported syntax: `*`, single values, lists (`,`), ranges (`-`), steps\n * (`/`), three-letter month/weekday names, `7` as an alias for Sunday, and the\n * `@yearly`/`@annually`/`@monthly`/`@weekly`/`@daily`/`@midnight`/`@hourly`\n * shorthands. `?` is tolerated on the day fields (read as `*`) for\n * Quartz-flavoured input but is never emitted. `@reboot` and the Quartz-only\n * `L`/`W`/`#` characters are deliberately unsupported — they have no\n * representation in the five numeric fields.\n */\n\n/** A single term within one cron field. */\nexport type CronTerm =\n | { kind: \"all\" }\n | { kind: \"value\"; value: number }\n | { kind: \"range\"; from: number; to: number }\n | { kind: \"step\"; from: number; to: number | null; step: number };\n\n/** One cron field: a non-empty, comma-joined list of terms. */\nexport type CronField = CronTerm[];\n\n/** A parsed cron expression's five fields. */\nexport interface CronExpression {\n minute: CronField;\n hour: CronField;\n dayOfMonth: CronField;\n month: CronField;\n dayOfWeek: CronField;\n}\n\n/** The preset form mode whose controls can round-trip an expression. */\nexport type CronFrequency =\n | \"minute\"\n | \"hourly\"\n | \"daily\"\n | \"weekly\"\n | \"monthly\"\n | \"yearly\"\n | \"advanced\";\n\n/** The five cron field names, in expression order. */\nexport const CRON_FIELD_NAMES = [\n \"minute\",\n \"hour\",\n \"dayOfMonth\",\n \"month\",\n \"dayOfWeek\",\n] as const;\n\n/** One of the five cron field names. */\nexport type CronFieldName = (typeof CRON_FIELD_NAMES)[number];\n\n/** Inclusive `[min, max]` value bounds for each cron field. */\nexport const CRON_FIELD_BOUNDS: Record<CronFieldName, [number, number]> = {\n minute: [0, 59],\n hour: [0, 23],\n dayOfMonth: [1, 31],\n month: [1, 12],\n dayOfWeek: [0, 6],\n};\n\n/** Human-readable labels for each cron field. */\nexport const CRON_FIELD_LABELS: Record<CronFieldName, string> = {\n minute: \"Minute\",\n hour: \"Hour\",\n dayOfMonth: \"Day of month\",\n month: \"Month\",\n dayOfWeek: \"Day of week\",\n};\n\n/** Full weekday names indexed by cron day-of-week value (0 = Sunday). */\nexport const WEEKDAY_NAMES = [\n \"Sunday\",\n \"Monday\",\n \"Tuesday\",\n \"Wednesday\",\n \"Thursday\",\n \"Friday\",\n \"Saturday\",\n];\n\n/** Three-letter weekday abbreviations indexed by cron value (0 = Sun). */\nexport const WEEKDAY_ABBREVIATIONS = [\"Sun\", \"Mon\", \"Tue\", \"Wed\", \"Thu\", \"Fri\", \"Sat\"];\n\n/** Full month names indexed from 0, so month `n` is `MONTH_NAMES[n - 1]`. */\nexport const MONTH_NAMES = [\n \"January\",\n \"February\",\n \"March\",\n \"April\",\n \"May\",\n \"June\",\n \"July\",\n \"August\",\n \"September\",\n \"October\",\n \"November\",\n \"December\",\n];\n\n/** Three-letter month abbreviations indexed from 0 (`Jan` is month 1). */\nexport const MONTH_ABBREVIATIONS = [\n \"Jan\",\n \"Feb\",\n \"Mar\",\n \"Apr\",\n \"May\",\n \"Jun\",\n \"Jul\",\n \"Aug\",\n \"Sep\",\n \"Oct\",\n \"Nov\",\n \"Dec\",\n];\n\n/** Supported `@`-shorthands mapped to their five-field equivalents. */\nexport const CRON_ALIASES: Record<string, string> = {\n \"@yearly\": \"0 0 1 1 *\",\n \"@annually\": \"0 0 1 1 *\",\n \"@monthly\": \"0 0 1 * *\",\n \"@weekly\": \"0 0 * * 0\",\n \"@daily\": \"0 0 * * *\",\n \"@midnight\": \"0 0 * * *\",\n \"@hourly\": \"0 * * * *\",\n};\n\nconst NAME_LOOKUPS: Partial<Record<CronFieldName, Record<string, number>>> = {\n month: Object.fromEntries(\n MONTH_ABBREVIATIONS.map((name, index) => [name.toLowerCase(), index + 1]),\n ),\n dayOfWeek: Object.fromEntries(\n WEEKDAY_ABBREVIATIONS.map((name, index) => [name.toLowerCase(), index]),\n ),\n};\n\nfunction parseValue(token: string, field: CronFieldName): number | null {\n const named = NAME_LOOKUPS[field]?.[token.toLowerCase()];\n if (named !== undefined) return named;\n if (!/^\\d+$/.test(token)) return null;\n\n const value = Number(token);\n const [min, max] = CRON_FIELD_BOUNDS[field];\n // Vixie cron accepts 7 as a second spelling of Sunday.\n if (field === \"dayOfWeek\" && value === 7) return 0;\n return value >= min && value <= max ? value : null;\n}\n\nfunction parseTerm(token: string, field: CronFieldName): CronTerm | null {\n const [base, stepToken, ...rest] = token.split(\"/\");\n if (rest.length > 0 || base === undefined || base === \"\") return null;\n\n if (stepToken !== undefined) {\n if (!/^\\d+$/.test(stepToken)) return null;\n const step = Number(stepToken);\n if (step < 1) return null;\n\n const [min, max] = CRON_FIELD_BOUNDS[field];\n if (base === \"*\" || base === \"?\") return { kind: \"step\", from: min, to: null, step };\n\n const range = base.split(\"-\");\n if (range.length === 1) {\n const from = parseValue(range[0]!, field);\n return from === null ? null : { kind: \"step\", from, to: null, step };\n }\n if (range.length !== 2) return null;\n const from = parseValue(range[0]!, field);\n const to = parseValue(range[1]!, field);\n if (from === null || to === null || to < from || to > max) return null;\n return { kind: \"step\", from, to, step };\n }\n\n if (base === \"*\" || base === \"?\") return { kind: \"all\" };\n\n const range = base.split(\"-\");\n if (range.length === 1) {\n const value = parseValue(range[0]!, field);\n return value === null ? null : { kind: \"value\", value };\n }\n if (range.length !== 2) return null;\n const from = parseValue(range[0]!, field);\n const to = parseValue(range[1]!, field);\n if (from === null || to === null || to < from) return null;\n return { kind: \"range\", from, to };\n}\n\nfunction parseField(text: string, field: CronFieldName): CronField | null {\n const tokens = text.split(\",\");\n const terms: CronField = [];\n for (const token of tokens) {\n const term = parseTerm(token.trim(), field);\n if (!term) return null;\n terms.push(term);\n }\n return terms.length > 0 ? terms : null;\n}\n\n/**\n * Parses a cron expression, expanding any supported `@`-shorthand first.\n * Returns `null` when the input is not a valid supported expression.\n */\nexport function parseCron(expression: string): CronExpression | null {\n const trimmed = expression.trim();\n if (!trimmed) return null;\n\n const expanded = CRON_ALIASES[trimmed.toLowerCase()] ?? trimmed;\n const parts = expanded.split(/\\s+/);\n if (parts.length !== CRON_FIELD_NAMES.length) return null;\n\n const fields = {} as CronExpression;\n for (const [index, name] of CRON_FIELD_NAMES.entries()) {\n const parsed = parseField(parts[index]!, name);\n if (!parsed) return null;\n fields[name] = parsed;\n }\n return fields;\n}\n\nfunction formatTerm(term: CronTerm, field: CronFieldName): string {\n if (term.kind === \"all\") return \"*\";\n if (term.kind === \"value\") return String(term.value);\n if (term.kind === \"range\") return `${term.from}-${term.to}`;\n\n const [min, max] = CRON_FIELD_BOUNDS[field];\n const end = term.to ?? max;\n if (term.from === min && end === max) return `*/${term.step}`;\n return `${term.from}-${end}/${term.step}`;\n}\n\n/** Serializes an expression canonically: numeric values, `*` for unconstrained fields. */\nexport function formatCron(expression: CronExpression): string {\n return CRON_FIELD_NAMES.map((name) =>\n expression[name].map((term) => formatTerm(term, name)).join(\",\"),\n ).join(\" \");\n}\n\n/** Builds a field from an explicit list of values, or `[{ kind: \"all\" }]` when empty. */\nexport function fieldFromValues(values: number[]): CronField {\n const unique = [...new Set(values)].sort((a, b) => a - b);\n if (unique.length === 0) return [{ kind: \"all\" }];\n return unique.map((value) => ({ kind: \"value\", value }) as CronTerm);\n}\n\n/** Every value a field matches, ascending and de-duplicated. */\nexport function expandField(field: CronField, name: CronFieldName): number[] {\n const [min, max] = CRON_FIELD_BOUNDS[name];\n const values = new Set<number>();\n for (const term of field) {\n if (term.kind === \"all\") {\n for (let value = min; value <= max; value += 1) values.add(value);\n } else if (term.kind === \"value\") {\n values.add(term.value);\n } else if (term.kind === \"range\") {\n for (let value = term.from; value <= term.to; value += 1) values.add(value);\n } else {\n const end = term.to ?? max;\n for (let value = term.from; value <= end; value += term.step) values.add(value);\n }\n }\n return [...values].sort((a, b) => a - b);\n}\n\n/** Whether a field is unconstrained (`*`, possibly among redundant terms). */\nexport function isEveryValue(field: CronField): boolean {\n return field.some((term) => term.kind === \"all\");\n}\n\nfunction singleValue(field: CronField): number | null {\n if (field.length !== 1) return null;\n const term = field[0]!;\n return term.kind === \"value\" ? term.value : null;\n}\n\nfunction wholeFieldStep(field: CronField, name: CronFieldName): number | null {\n if (field.length !== 1) return null;\n const term = field[0]!;\n if (term.kind !== \"step\" || term.to !== null) return null;\n return term.from === CRON_FIELD_BOUNDS[name][0] ? term.step : null;\n}\n\n/**\n * Whether a checkbox grid can represent the field, i.e. it selects a finite\n * set of values. Ranges and steps qualify — the grid shows them checked and\n * re-serializes them as a plain list once the user edits the selection.\n */\nfunction isSelectableSet(field: CronField): boolean {\n return !isEveryValue(field);\n}\n\n/**\n * The preset form mode whose controls can reproduce `expression` exactly,\n * or `\"advanced\"` when only the per-field editor can.\n */\nexport function detectFrequency(expression: CronExpression): CronFrequency {\n const { minute, hour, dayOfMonth, month, dayOfWeek } = expression;\n const everyDayOfMonth = isEveryValue(dayOfMonth);\n const everyMonth = isEveryValue(month);\n const everyDayOfWeek = isEveryValue(dayOfWeek);\n\n if (everyDayOfMonth && everyMonth && everyDayOfWeek) {\n if (isEveryValue(hour)) {\n if (isEveryValue(minute) || wholeFieldStep(minute, \"minute\") !== null) return \"minute\";\n if (singleValue(minute) !== null) return \"hourly\";\n return \"advanced\";\n }\n if (singleValue(minute) === null) return \"advanced\";\n if (wholeFieldStep(hour, \"hour\") !== null) return \"hourly\";\n if (singleValue(hour) !== null) return \"daily\";\n return \"advanced\";\n }\n\n if (singleValue(minute) === null || singleValue(hour) === null) return \"advanced\";\n\n if (everyDayOfMonth && everyMonth && isSelectableSet(dayOfWeek)) return \"weekly\";\n if (everyDayOfWeek && isSelectableSet(dayOfMonth)) {\n if (everyMonth) return \"monthly\";\n if (isSelectableSet(month)) return \"yearly\";\n }\n return \"advanced\";\n}\n\nfunction pad(value: number): string {\n return String(value).padStart(2, \"0\");\n}\n\n/** `\"09:05\"` for hour 9, minute 5. */\nfunction formatTime(hour: number, minute: number): string {\n return `${pad(hour)}:${pad(minute)}`;\n}\n\n/** `\"a, b and c\"`. */\nfunction joinList(parts: string[]): string {\n if (parts.length <= 1) return parts[0] ?? \"\";\n return `${parts.slice(0, -1).join(\", \")} and ${parts.at(-1)}`;\n}\n\nfunction describeWeekdays(field: CronField): string {\n const days = expandField(field, \"dayOfWeek\");\n if (days.length === 1) return WEEKDAY_NAMES[days[0]!]!;\n return joinList(days.map((day) => WEEKDAY_ABBREVIATIONS[day]!));\n}\n\nfunction describeMonthDays(field: CronField): string {\n const days = expandField(field, \"dayOfMonth\");\n return joinList(days.map((day) => String(day)));\n}\n\nfunction describeMonths(field: CronField): string {\n const months = expandField(field, \"month\");\n if (months.length === 1) return MONTH_NAMES[months[0]! - 1]!;\n return joinList(months.map((month) => MONTH_ABBREVIATIONS[month - 1]!));\n}\n\nfunction describeFieldTerms(field: CronField, name: CronFieldName): string {\n const label = name === \"month\" ? \"month\" : name === \"dayOfMonth\" ? \"day\" : name;\n const readable = (value: number): string => {\n if (name === \"month\") return MONTH_ABBREVIATIONS[value - 1]!;\n if (name === \"dayOfWeek\") return WEEKDAY_ABBREVIATIONS[value]!;\n return String(value);\n };\n const parts = field.map((term) => {\n if (term.kind === \"all\") return `every ${label}`;\n if (term.kind === \"value\") return readable(term.value);\n if (term.kind === \"range\") return `${readable(term.from)}–${readable(term.to)}`;\n const [min, max] = CRON_FIELD_BOUNDS[name];\n const end = term.to ?? max;\n if (term.from === min && end === max) return `every ${term.step}`;\n return `every ${term.step} from ${readable(term.from)} to ${readable(end)}`;\n });\n return joinList(parts);\n}\n\nfunction describeDayScope(expression: CronExpression): string {\n const { dayOfMonth, month, dayOfWeek } = expression;\n const everyDayOfMonth = isEveryValue(dayOfMonth);\n const everyMonth = isEveryValue(month);\n const everyDayOfWeek = isEveryValue(dayOfWeek);\n\n if (everyDayOfMonth && everyMonth && everyDayOfWeek) return \"every day\";\n\n const parts: string[] = [];\n if (!everyDayOfMonth) {\n parts.push(\n everyMonth\n ? `on day ${describeMonthDays(dayOfMonth)} of every month`\n : `on ${describeMonthDays(dayOfMonth)} ${describeMonths(month)}`,\n );\n } else if (!everyMonth) {\n parts.push(`every day in ${describeMonths(month)}`);\n }\n // cron ORs day-of-month and day-of-week whenever both are restricted.\n if (!everyDayOfWeek) parts.push(`every ${describeWeekdays(dayOfWeek)}`);\n return parts.join(parts.length > 1 ? \" or \" : \"\");\n}\n\nfunction describeAdvanced(expression: CronExpression): string {\n const parts = CRON_FIELD_NAMES.filter((name) => !isEveryValue(expression[name])).map(\n (name) => `${CRON_FIELD_LABELS[name].toLowerCase()} ${describeFieldTerms(expression[name], name)}`,\n );\n return parts.length === 0 ? \"Every minute\" : `Custom: ${joinList(parts)}`;\n}\n\n/**\n * A compact English description of an expression, e.g. `\"Every hour\"`,\n * `\"10:17 every Monday\"`, `\"09:00 on day 1 of every month\"`. Returns the raw\n * input unchanged when it cannot be parsed.\n */\nexport function describeCron(expression: string | CronExpression): string {\n const parsed = typeof expression === \"string\" ? parseCron(expression) : expression;\n if (!parsed) return typeof expression === \"string\" ? expression.trim() : \"\";\n\n const { minute, hour } = parsed;\n const scope = describeDayScope(parsed);\n const everyDay = scope === \"every day\";\n const suffix = everyDay ? \"\" : ` ${scope}`;\n\n if (isEveryValue(hour)) {\n if (isEveryValue(minute)) return everyDay ? \"Every minute\" : `Every minute${suffix}`;\n const minuteStep = wholeFieldStep(minute, \"minute\");\n if (minuteStep !== null) return `Every ${minuteStep} minutes${suffix}`;\n const minuteValue = singleValue(minute);\n if (minuteValue !== null) {\n return minuteValue === 0\n ? `Every hour${suffix}`\n : `Every hour at :${pad(minuteValue)}${suffix}`;\n }\n return describeAdvanced(parsed);\n }\n\n const minuteValue = singleValue(minute);\n if (minuteValue === null) return describeAdvanced(parsed);\n\n const hourStep = wholeFieldStep(hour, \"hour\");\n if (hourStep !== null) {\n const at = minuteValue === 0 ? \"\" : ` at :${pad(minuteValue)}`;\n return `Every ${hourStep} hours${at}${suffix}`;\n }\n\n const hourValue = singleValue(hour);\n if (hourValue === null) return describeAdvanced(parsed);\n\n const time = formatTime(hourValue, minuteValue);\n return everyDay ? `${time} every day` : `${time} ${scope}`;\n}\n"]}