@f-ewald/components 1.29.0 → 1.30.1

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.
package/llms.txt CHANGED
@@ -402,7 +402,7 @@ Import: `import "@f-ewald/components/calendar-day.js";`
402
402
 
403
403
  Properties: `date` (attribute `date`) : string, default —; `timeMarker` (attribute `time-marker`) : boolean, default false; `minWidth` (attribute `min-width`) : string, default ""
404
404
  Events: none
405
- CSS custom properties: `--ui-border`, `--ui-danger`, `--ui-focus-ring`, `--ui-font`, `--ui-font-size-lg`, `--ui-font-size-sm`, `--ui-font-size-xs`, `--ui-font-weight-medium`, `--ui-font-weight-regular`, `--ui-font-weight-semibold`, `--ui-hover-overlay`, `--ui-info`, `--ui-line-height-tight`, `--ui-primary`, `--ui-radius-sm`, `--ui-success`, `--ui-surface`, `--ui-surface-muted`, `--ui-text`, `--ui-text-muted`, `--ui-warning`
405
+ CSS custom properties: `--ui-border`, `--ui-danger`, `--ui-focus-ring`, `--ui-font`, `--ui-font-size-lg`, `--ui-font-size-sm`, `--ui-font-size-xs`, `--ui-font-weight-medium`, `--ui-font-weight-regular`, `--ui-font-weight-semibold`, `--ui-hover-overlay`, `--ui-info`, `--ui-line-height-tight`, `--ui-on-accent`, `--ui-primary`, `--ui-radius-sm`, `--ui-success`, `--ui-surface`, `--ui-surface-muted`, `--ui-text`, `--ui-text-muted`, `--ui-warning`
406
406
 
407
407
  Example:
408
408
  ```html
@@ -704,6 +704,65 @@ Example:
704
704
  <copy-link-button value="https://example.com/listing/42" label="Copy listing link"></copy-link-button>
705
705
  ```
706
706
 
707
+ ## <countdown-timer>
708
+
709
+ Per-second ticking count-down timer, e.g. a live "Retrying in 3 seconds"
710
+ indicator while waiting to retry a failed request. Renders nothing while
711
+ `until` is unset or unparseable. Remaining time is clamped to zero — it
712
+ never goes negative once the target instant has passed.
713
+
714
+ Import: `import "@f-ewald/components/countdown-timer.js";`
715
+
716
+ Properties: `until` (attribute `until`) : string | null, default null; `format` (attribute `format`) : DurationFormat, default "seconds"; `prefix` (attribute `prefix`) : string, default ""; `suffix` (attribute `suffix`) : string, default ""
717
+ Events: none
718
+ CSS custom properties: none
719
+
720
+ Example:
721
+ ```html
722
+ <countdown-timer until="2026-07-19T12:00:10Z" prefix="Retrying in "></countdown-timer>
723
+ <countdown-timer until="2026-07-19T12:00:10Z" format="compact" prefix="retrying in "></countdown-timer>
724
+ ```
725
+
726
+ ## <cron-schedule>
727
+
728
+ Repeat-schedule picker that reads and writes a standard 5-field cron
729
+ expression. The collapsed trigger shows a compact English description of
730
+ the current schedule ("Every hour", "10:17 every Monday"); clicking it
731
+ opens an anchored panel with the schedule form.
732
+
733
+ The panel offers frequency presets (every N minutes, hourly, daily, weekly,
734
+ monthly, yearly) plus an `Advanced` mode that edits each cron field as a
735
+ list of terms, so any valid expression — including compound fields that mix
736
+ ranges, steps, and single values — is reachable. Edits apply immediately:
737
+ each change updates `value` and fires `change`; closing the panel only
738
+ dismisses it.
739
+
740
+ An unparseable `value` (e.g. `@reboot`, which has no five-field form) is
741
+ preserved verbatim and shown as-is on the trigger; the panel then starts
742
+ from the default hourly schedule.
743
+
744
+ The host is `display: block` with a full-width trigger, matching the other
745
+ value-entry fields. To shrink an instance to its content, constrain the
746
+ host: `cron-schedule { display: inline-block; }`.
747
+
748
+ Import: `import "@f-ewald/components/cron-schedule.js";`
749
+
750
+ Properties: `value` (attribute `value`) : string, default "0 * * * *"; `label` (attribute `label`) : string, default ""; `disabled` (attribute `disabled`) : boolean, default false; `open` (attribute `open`) : boolean, default false; `description` (JS property only) : string, default —
751
+ Events: `change`
752
+ CSS custom properties: `--ui-border`, `--ui-focus-ring`, `--ui-font`, `--ui-font-mono`, `--ui-font-size-sm`, `--ui-font-size-xs`, `--ui-font-weight-medium`, `--ui-line-height-tight`, `--ui-primary`, `--ui-radius`, `--ui-radius-sm`, `--ui-shadow-lg`, `--ui-surface`, `--ui-surface-muted`, `--ui-text`, `--ui-text-muted`, `--ui-tracking-wide`
753
+
754
+ Example:
755
+ ```html
756
+ <cron-schedule label="Backup schedule" value="0 * * * *"></cron-schedule>
757
+
758
+ <script type="module">
759
+ const schedule = document.querySelector("cron-schedule");
760
+ schedule.addEventListener("change", (e) => {
761
+ console.log(e.detail.value, schedule.description);
762
+ });
763
+ </script>
764
+ ```
765
+
707
766
  ## <data-table>
708
767
 
709
768
  A generic, presentational table shell: renders a `<thead>` from `columns`
package/package.json CHANGED
@@ -1,7 +1,7 @@
1
1
  {
2
2
  "name": "@f-ewald/components",
3
3
  "private": false,
4
- "version": "1.29.0",
4
+ "version": "1.30.1",
5
5
  "description": "A collection of universally usable web components for various tasks.",
6
6
  "type": "module",
7
7
  "main": "dist/index.js",