@jcsoftdev/ui 0.3.0 → 0.5.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.
- package/CHANGELOG.md +200 -1
- package/README.md +56 -3
- package/bin/ui-theme.mjs +13 -2
- package/dist/atoms/button/button.d.ts +8 -1
- package/dist/atoms/button/button.js +10 -3
- package/dist/atoms/checkbox/checkbox.js +3 -1
- package/dist/atoms/chip/chip.d.ts +11 -3
- package/dist/atoms/chip/chip.js +8 -1
- package/dist/atoms/chip/index.d.ts +1 -1
- package/dist/atoms/chip/index.js +2 -0
- package/dist/atoms/divider/divider.d.ts +15 -0
- package/dist/atoms/divider/divider.js +27 -0
- package/dist/atoms/divider/index.d.ts +1 -0
- package/dist/atoms/divider/index.js +1 -0
- package/dist/atoms/due-chip/due-chip.d.ts +31 -0
- package/dist/atoms/due-chip/due-chip.js +41 -0
- package/dist/atoms/due-chip/index.d.ts +2 -0
- package/dist/atoms/due-chip/index.js +6 -0
- package/dist/atoms/due-chip/model.d.ts +25 -0
- package/dist/atoms/due-chip/model.js +44 -0
- package/dist/atoms/icon-button/icon-button.d.ts +22 -0
- package/dist/atoms/icon-button/icon-button.js +38 -0
- package/dist/atoms/icon-button/index.d.ts +1 -0
- package/dist/atoms/icon-button/index.js +8 -0
- package/dist/atoms/index.d.ts +6 -0
- package/dist/atoms/index.js +6 -0
- package/dist/atoms/internal/hit-area.d.ts +6 -0
- package/dist/atoms/internal/hit-area.js +4 -0
- package/dist/atoms/kbd/index.d.ts +1 -0
- package/dist/atoms/kbd/index.js +4 -0
- package/dist/atoms/kbd/kbd.d.ts +7 -0
- package/dist/atoms/kbd/kbd.js +17 -0
- package/dist/atoms/radio-group/radio-group.js +6 -2
- package/dist/atoms/seal/index.d.ts +1 -0
- package/dist/atoms/seal/index.js +4 -0
- package/dist/atoms/seal/seal.d.ts +30 -0
- package/dist/atoms/seal/seal.js +71 -0
- package/dist/atoms/spinner/index.d.ts +1 -0
- package/dist/atoms/spinner/index.js +5 -0
- package/dist/atoms/spinner/spinner.d.ts +19 -0
- package/dist/atoms/spinner/spinner.js +31 -0
- package/dist/atoms/switch/switch.js +3 -1
- package/dist/auth/auth-illustration/auth-illustration.d.ts +35 -0
- package/dist/auth/auth-illustration/auth-illustration.js +72 -0
- package/dist/auth/auth-illustration/index.d.ts +3 -0
- package/dist/auth/auth-illustration/index.js +11 -0
- package/dist/auth/auth-illustration/look.d.ts +30 -0
- package/dist/auth/auth-illustration/look.js +0 -0
- package/dist/auth/auth-illustration/model.d.ts +133 -0
- package/dist/auth/auth-illustration/model.js +202 -0
- package/dist/auth/auth-illustration/use-art-pointer.d.ts +9 -0
- package/dist/auth/auth-illustration/use-art-pointer.js +69 -0
- package/dist/auth/auth-layout/auth-layout.d.ts +80 -0
- package/dist/auth/auth-layout/auth-layout.js +190 -0
- package/dist/auth/auth-layout/index.d.ts +1 -0
- package/dist/auth/auth-layout/index.js +1 -0
- package/dist/auth/character/character.d.ts +12 -0
- package/dist/auth/character/character.js +333 -0
- package/dist/auth/character/index.d.ts +1 -0
- package/dist/auth/character/index.js +1 -0
- package/dist/auth/index.d.ts +4 -0
- package/dist/auth/index.js +4 -0
- package/dist/auth/internal/auth-context.d.ts +17 -0
- package/dist/auth/internal/auth-context.js +10 -0
- package/dist/auth/internal/auth-styles.d.ts +1 -0
- package/dist/auth/internal/auth-styles.js +29 -0
- package/dist/auth/internal/portal-glyphs.d.ts +6 -0
- package/dist/auth/internal/portal-glyphs.js +39 -0
- package/dist/auth/login-form/context.d.ts +51 -0
- package/dist/auth/login-form/context.js +12 -0
- package/dist/auth/login-form/index.d.ts +2 -0
- package/dist/auth/login-form/index.js +23 -0
- package/dist/auth/login-form/login-form.d.ts +66 -0
- package/dist/auth/login-form/login-form.js +233 -0
- package/dist/auth/login-form/parts.d.ts +71 -0
- package/dist/auth/login-form/parts.js +371 -0
- package/dist/auth/looks/auth-illustration-any.d.ts +16 -0
- package/dist/auth/looks/auth-illustration-any.js +24 -0
- package/dist/auth/looks/index.d.ts +1 -0
- package/dist/auth/looks/index.js +1 -0
- package/dist/auth/mosaic/index.d.ts +1 -0
- package/dist/auth/mosaic/index.js +1 -0
- package/dist/auth/mosaic/mosaic.d.ts +11 -0
- package/dist/auth/mosaic/mosaic.js +195 -0
- package/dist/auth/slabs/index.d.ts +1 -0
- package/dist/auth/slabs/index.js +1 -0
- package/dist/auth/slabs/slabs.d.ts +13 -0
- package/dist/auth/slabs/slabs.js +136 -0
- package/dist/auth/stack/index.d.ts +1 -0
- package/dist/auth/stack/index.js +1 -0
- package/dist/auth/stack/stack.d.ts +6 -0
- package/dist/auth/stack/stack.js +222 -0
- package/dist/auth/statement/index.d.ts +1 -0
- package/dist/auth/statement/index.js +1 -0
- package/dist/auth/statement/statement.d.ts +13 -0
- package/dist/auth/statement/statement.js +99 -0
- package/dist/calendar/date-calendar/date-calendar.d.ts +32 -0
- package/dist/calendar/date-calendar/date-calendar.js +189 -0
- package/dist/calendar/date-calendar/index.d.ts +1 -0
- package/dist/calendar/date-calendar/index.js +6 -0
- package/dist/calendar/index.d.ts +1 -0
- package/dist/calendar/index.js +1 -0
- package/dist/calendar/internal/date-utils.d.ts +26 -0
- package/dist/calendar/internal/date-utils.js +95 -1
- package/dist/containers/aside/aside.d.ts +14 -0
- package/dist/containers/aside/aside.js +25 -0
- package/dist/containers/aside/index.d.ts +1 -0
- package/dist/containers/aside/index.js +5 -0
- package/dist/containers/banner/banner.d.ts +4 -1
- package/dist/containers/banner/banner.js +9 -1
- package/dist/containers/description-list/description-list.d.ts +29 -6
- package/dist/containers/description-list/description-list.js +47 -6
- package/dist/containers/feed/feed.d.ts +23 -0
- package/dist/containers/feed/feed.js +77 -0
- package/dist/containers/feed/index.d.ts +2 -0
- package/dist/containers/feed/index.js +10 -0
- package/dist/containers/feed/model.d.ts +19 -0
- package/dist/containers/feed/model.js +38 -0
- package/dist/containers/index.d.ts +6 -0
- package/dist/containers/index.js +6 -0
- package/dist/containers/kpi/kpi.d.ts +50 -8
- package/dist/containers/kpi/kpi.js +91 -39
- package/dist/containers/list-detail/index.d.ts +1 -0
- package/dist/containers/list-detail/index.js +20 -0
- package/dist/containers/list-detail/list-detail.d.ts +55 -0
- package/dist/containers/list-detail/list-detail.js +221 -0
- package/dist/containers/note/index.d.ts +1 -0
- package/dist/containers/note/index.js +4 -0
- package/dist/containers/note/note.d.ts +13 -0
- package/dist/containers/note/note.js +27 -0
- package/dist/containers/section/index.d.ts +1 -0
- package/dist/containers/section/index.js +6 -0
- package/dist/containers/section/section.d.ts +68 -0
- package/dist/containers/section/section.js +198 -0
- package/dist/containers/shortcuts/index.d.ts +1 -0
- package/dist/containers/shortcuts/index.js +8 -0
- package/dist/containers/shortcuts/shortcuts.d.ts +18 -0
- package/dist/containers/shortcuts/shortcuts.js +50 -0
- package/dist/containers/table/selection.d.ts +9 -0
- package/dist/containers/table/selection.js +20 -0
- package/dist/containers/table/table.d.ts +66 -4
- package/dist/containers/table/table.js +128 -7
- package/dist/containers/timeline/index.d.ts +1 -1
- package/dist/containers/timeline/index.js +4 -2
- package/dist/containers/timeline/timeline.d.ts +32 -5
- package/dist/containers/timeline/timeline.js +154 -90
- package/dist/forms/chip-group/chip-group.d.ts +54 -0
- package/dist/forms/chip-group/chip-group.js +114 -0
- package/dist/forms/chip-group/index.d.ts +1 -0
- package/dist/forms/chip-group/index.js +6 -0
- package/dist/forms/combobox/combobox.d.ts +60 -0
- package/dist/forms/combobox/combobox.js +281 -0
- package/dist/forms/combobox/index.d.ts +1 -0
- package/dist/forms/combobox/index.js +6 -0
- package/dist/forms/date-picker/date-picker.d.ts +40 -0
- package/dist/forms/date-picker/date-picker.js +183 -0
- package/dist/forms/date-picker/date-time-picker.d.ts +43 -0
- package/dist/forms/date-picker/date-time-picker.js +121 -0
- package/dist/forms/date-picker/index.d.ts +2 -0
- package/dist/forms/date-picker/index.js +10 -0
- package/dist/forms/date-picker/model.d.ts +35 -0
- package/dist/forms/date-picker/model.js +83 -0
- package/dist/forms/dropzone/dropzone.d.ts +30 -2
- package/dist/forms/dropzone/dropzone.js +153 -23
- package/dist/forms/field/field.d.ts +16 -10
- package/dist/forms/field/field.js +41 -5
- package/dist/forms/index.d.ts +5 -0
- package/dist/forms/index.js +5 -0
- package/dist/forms/input/index.d.ts +1 -1
- package/dist/forms/input/index.js +4 -1
- package/dist/forms/input/input.d.ts +21 -5
- package/dist/forms/input/input.js +75 -9
- package/dist/forms/input-icon/input-icon.d.ts +1 -1
- package/dist/forms/internal/listbox-items.d.ts +18 -0
- package/dist/forms/internal/listbox-items.js +88 -0
- package/dist/forms/internal/listbox.d.ts +44 -0
- package/dist/forms/internal/listbox.js +74 -0
- package/dist/forms/number-stepper/model.d.ts +16 -0
- package/dist/forms/number-stepper/model.js +23 -0
- package/dist/forms/number-stepper/number-stepper.d.ts +36 -6
- package/dist/forms/number-stepper/number-stepper.js +86 -37
- package/dist/forms/password-input/index.d.ts +1 -0
- package/dist/forms/password-input/index.js +1 -0
- package/dist/forms/password-input/password-input.d.ts +16 -0
- package/dist/forms/password-input/password-input.js +45 -0
- package/dist/forms/select-menu/index.d.ts +1 -0
- package/dist/forms/select-menu/index.js +6 -0
- package/dist/forms/select-menu/select-menu.d.ts +35 -0
- package/dist/forms/select-menu/select-menu.js +230 -0
- package/dist/i18n/strings.d.ts +153 -0
- package/dist/i18n/strings.js +86 -2
- package/dist/i18n/ui-strings-provider.d.ts +1 -1
- package/dist/i18n/ui-strings-provider.js +6 -2
- package/dist/icons/eye.d.ts +2 -0
- package/dist/icons/eye.js +11 -0
- package/dist/icons/graduation-cap.d.ts +2 -0
- package/dist/icons/graduation-cap.js +12 -0
- package/dist/icons/house.d.ts +2 -0
- package/dist/icons/house.js +11 -0
- package/dist/icons/index.d.ts +4 -0
- package/dist/icons/index.js +8 -0
- package/dist/icons/mail.d.ts +2 -0
- package/dist/icons/mail.js +11 -0
- package/dist/navigation/index.d.ts +1 -0
- package/dist/navigation/index.js +1 -0
- package/dist/navigation/stepper/index.d.ts +1 -1
- package/dist/navigation/stepper/index.js +3 -1
- package/dist/navigation/stepper/stepper.d.ts +8 -0
- package/dist/navigation/stepper/stepper.js +68 -45
- package/dist/navigation/tabs/index.d.ts +1 -0
- package/dist/navigation/tabs/index.js +6 -0
- package/dist/navigation/tabs/tabs-nav.d.ts +37 -0
- package/dist/navigation/tabs/tabs-nav.js +57 -0
- package/dist/navigation/wizard/index.d.ts +1 -0
- package/dist/navigation/wizard/index.js +6 -0
- package/dist/navigation/wizard/model.d.ts +33 -0
- package/dist/navigation/wizard/model.js +34 -0
- package/dist/navigation/wizard/wizard.d.ts +45 -0
- package/dist/navigation/wizard/wizard.js +169 -0
- package/dist/overlays/alert-dialog/alert-dialog.d.ts +103 -0
- package/dist/overlays/alert-dialog/alert-dialog.js +342 -0
- package/dist/overlays/alert-dialog/index.d.ts +1 -0
- package/dist/overlays/alert-dialog/index.js +26 -0
- package/dist/overlays/dropdown-menu/dropdown-menu.d.ts +17 -1
- package/dist/overlays/dropdown-menu/dropdown-menu.js +12 -4
- package/dist/overlays/dropdown-menu/index.d.ts +1 -1
- package/dist/overlays/dropdown-menu/index.js +8 -2
- package/dist/overlays/index.d.ts +2 -0
- package/dist/overlays/index.js +2 -0
- package/dist/overlays/testing/index.d.ts +5 -0
- package/dist/overlays/testing/index.js +4 -0
- package/dist/overlays/toaster/index.d.ts +2 -1
- package/dist/overlays/toaster/index.js +4 -2
- package/dist/overlays/toaster/toast-store.d.ts +6 -2
- package/dist/overlays/toaster/toast.d.ts +3 -0
- package/dist/overlays/toaster/toast.js +3 -0
- package/dist/overlays/toaster/toaster.d.ts +3 -0
- package/dist/overlays/toaster/toaster.js +36 -3
- package/dist/overlays/tooltip/index.d.ts +1 -0
- package/dist/overlays/tooltip/index.js +4 -0
- package/dist/overlays/tooltip/model.d.ts +10 -0
- package/dist/overlays/tooltip/model.js +13 -0
- package/dist/overlays/tooltip/tooltip.d.ts +41 -0
- package/dist/overlays/tooltip/tooltip.js +116 -0
- package/dist/primitives/use-dismissable-layer.js +1 -1
- package/dist/states/error-state/error-state.d.ts +6 -1
- package/dist/states/error-state/error-state.js +13 -9
- package/dist/states/skeleton/skeleton.d.ts +8 -2
- package/dist/states/skeleton/skeleton.js +44 -2
- package/icons/svg/eye.svg +4 -0
- package/icons/svg/graduation-cap.svg +5 -0
- package/icons/svg/house.svg +4 -0
- package/icons/svg/mail.svg +4 -0
- package/package.json +2 -2
- package/scripts/build-theme.mjs +12 -1
- package/src/atoms/button/button.tsx +25 -3
- package/src/atoms/checkbox/checkbox.tsx +3 -1
- package/src/atoms/chip/chip.tsx +18 -3
- package/src/atoms/chip/index.ts +2 -0
- package/src/atoms/divider/divider.tsx +40 -0
- package/src/atoms/divider/index.ts +1 -0
- package/src/atoms/due-chip/due-chip.tsx +75 -0
- package/src/atoms/due-chip/index.ts +2 -0
- package/src/atoms/due-chip/model.ts +67 -0
- package/src/atoms/icon-button/icon-button.tsx +58 -0
- package/src/atoms/icon-button/index.ts +6 -0
- package/src/atoms/index.ts +6 -0
- package/src/atoms/internal/hit-area.ts +7 -0
- package/src/atoms/kbd/index.ts +1 -0
- package/src/atoms/kbd/kbd.tsx +20 -0
- package/src/atoms/radio-group/radio-group.tsx +8 -2
- package/src/atoms/seal/index.ts +1 -0
- package/src/atoms/seal/seal.tsx +107 -0
- package/src/atoms/spinner/index.ts +1 -0
- package/src/atoms/spinner/spinner.tsx +49 -0
- package/src/atoms/switch/switch.tsx +3 -1
- package/src/auth/auth-illustration/auth-illustration.tsx +100 -0
- package/src/auth/auth-illustration/index.ts +8 -0
- package/src/auth/auth-illustration/look.ts +32 -0
- package/src/auth/auth-illustration/model.ts +330 -0
- package/src/auth/auth-illustration/use-art-pointer.ts +78 -0
- package/src/auth/auth-layout/auth-layout.tsx +282 -0
- package/src/auth/auth-layout/index.ts +1 -0
- package/src/auth/character/character.tsx +346 -0
- package/src/auth/character/index.ts +1 -0
- package/src/auth/index.ts +4 -0
- package/src/auth/internal/auth-context.ts +26 -0
- package/src/auth/internal/auth-styles.tsx +39 -0
- package/src/auth/internal/portal-glyphs.tsx +32 -0
- package/src/auth/login-form/context.ts +78 -0
- package/src/auth/login-form/index.ts +21 -0
- package/src/auth/login-form/login-form.tsx +330 -0
- package/src/auth/login-form/parts.tsx +457 -0
- package/src/auth/looks/auth-illustration-any.tsx +38 -0
- package/src/auth/looks/index.ts +1 -0
- package/src/auth/mosaic/index.ts +1 -0
- package/src/auth/mosaic/mosaic.tsx +255 -0
- package/src/auth/slabs/index.ts +1 -0
- package/src/auth/slabs/slabs.tsx +181 -0
- package/src/auth/stack/index.ts +1 -0
- package/src/auth/stack/stack.tsx +267 -0
- package/src/auth/statement/index.ts +1 -0
- package/src/auth/statement/statement.tsx +122 -0
- package/src/calendar/date-calendar/date-calendar.tsx +230 -0
- package/src/calendar/date-calendar/index.ts +5 -0
- package/src/calendar/index.ts +1 -0
- package/src/calendar/internal/date-utils.ts +115 -0
- package/src/containers/aside/aside.tsx +40 -0
- package/src/containers/aside/index.ts +1 -0
- package/src/containers/banner/banner.tsx +18 -1
- package/src/containers/description-list/description-list.tsx +85 -9
- package/src/containers/feed/feed.tsx +99 -0
- package/src/containers/feed/index.ts +8 -0
- package/src/containers/feed/model.ts +54 -0
- package/src/containers/index.ts +6 -0
- package/src/containers/kpi/kpi.tsx +161 -62
- package/src/containers/list-detail/index.ts +15 -0
- package/src/containers/list-detail/list-detail.tsx +293 -0
- package/src/containers/note/index.ts +1 -0
- package/src/containers/note/note.tsx +38 -0
- package/src/containers/section/index.ts +11 -0
- package/src/containers/section/section.tsx +281 -0
- package/src/containers/shortcuts/index.ts +6 -0
- package/src/containers/shortcuts/shortcuts.tsx +92 -0
- package/src/containers/table/selection.ts +26 -0
- package/src/containers/table/table.tsx +215 -13
- package/src/containers/timeline/index.ts +3 -0
- package/src/containers/timeline/timeline.tsx +204 -93
- package/src/forms/chip-group/chip-group.tsx +184 -0
- package/src/forms/chip-group/index.ts +8 -0
- package/src/forms/combobox/combobox.tsx +359 -0
- package/src/forms/combobox/index.ts +7 -0
- package/src/forms/date-picker/date-picker.tsx +239 -0
- package/src/forms/date-picker/date-time-picker.tsx +178 -0
- package/src/forms/date-picker/index.ts +10 -0
- package/src/forms/date-picker/model.ts +108 -0
- package/src/forms/dropzone/dropzone.tsx +217 -35
- package/src/forms/field/field.tsx +72 -7
- package/src/forms/index.ts +5 -0
- package/src/forms/input/index.ts +8 -1
- package/src/forms/input/input.tsx +99 -12
- package/src/forms/input-icon/input-icon.tsx +1 -1
- package/src/forms/internal/listbox-items.tsx +103 -0
- package/src/forms/internal/listbox.ts +124 -0
- package/src/forms/number-stepper/model.ts +35 -0
- package/src/forms/number-stepper/number-stepper.tsx +132 -42
- package/src/forms/password-input/index.ts +1 -0
- package/src/forms/password-input/password-input.tsx +57 -0
- package/src/forms/select-menu/index.ts +7 -0
- package/src/forms/select-menu/select-menu.tsx +280 -0
- package/src/i18n/strings.ts +153 -0
- package/src/i18n/ui-strings-provider.tsx +15 -4
- package/src/icons/eye.tsx +12 -0
- package/src/icons/graduation-cap.tsx +13 -0
- package/src/icons/house.tsx +12 -0
- package/src/icons/index.ts +4 -0
- package/src/icons/mail.tsx +12 -0
- package/src/navigation/index.ts +1 -0
- package/src/navigation/stepper/index.ts +7 -1
- package/src/navigation/stepper/stepper.tsx +41 -5
- package/src/navigation/tabs/index.ts +7 -0
- package/src/navigation/tabs/tabs-nav.tsx +131 -0
- package/src/navigation/wizard/index.ts +7 -0
- package/src/navigation/wizard/model.ts +61 -0
- package/src/navigation/wizard/wizard.tsx +222 -0
- package/src/overlays/alert-dialog/alert-dialog.tsx +486 -0
- package/src/overlays/alert-dialog/index.ts +19 -0
- package/src/overlays/dropdown-menu/dropdown-menu.tsx +29 -4
- package/src/overlays/dropdown-menu/index.ts +3 -0
- package/src/overlays/index.ts +2 -0
- package/src/overlays/testing/index.ts +5 -0
- package/src/overlays/toaster/index.ts +2 -0
- package/src/overlays/toaster/toast-store.ts +6 -2
- package/src/overlays/toaster/toast.ts +6 -0
- package/src/overlays/toaster/toaster.tsx +44 -2
- package/src/overlays/tooltip/index.ts +1 -0
- package/src/overlays/tooltip/model.ts +18 -0
- package/src/overlays/tooltip/tooltip.tsx +166 -0
- package/src/primitives/use-dismissable-layer.ts +7 -2
- package/src/states/error-state/error-state.tsx +19 -8
- package/src/states/skeleton/skeleton.tsx +68 -2
- package/styles/tailwind.css +33 -30
- package/styles/theme.css +33 -30
|
@@ -76,3 +76,118 @@ export function formatHour(hour: number, locale?: string): string {
|
|
|
76
76
|
timeZone: "UTC",
|
|
77
77
|
}).format(new Date(Date.UTC(1970, 0, 1, hour)));
|
|
78
78
|
}
|
|
79
|
+
|
|
80
|
+
const ISO_DATE = /^(\d{4})-(\d{2})-(\d{2})$/;
|
|
81
|
+
|
|
82
|
+
/** True for a real calendar date written "YYYY-MM-DD" (rejects "2026-02-30"). */
|
|
83
|
+
export function isIsoDate(value: string): boolean {
|
|
84
|
+
const match = ISO_DATE.exec(value);
|
|
85
|
+
if (!match) return false;
|
|
86
|
+
const [year, month, day] = [Number(match[1]), Number(match[2]), Number(match[3])];
|
|
87
|
+
const date = new Date(Date.UTC(year, month - 1, day));
|
|
88
|
+
return (
|
|
89
|
+
date.getUTCFullYear() === year && date.getUTCMonth() === month - 1 && date.getUTCDate() === day
|
|
90
|
+
);
|
|
91
|
+
}
|
|
92
|
+
|
|
93
|
+
/** Builds "YYYY-MM-DD" from numeric parts; no time zone is involved. */
|
|
94
|
+
export function toIsoDate(year: number, month: number, day: number): string {
|
|
95
|
+
return `${String(year).padStart(4, "0")}-${String(month).padStart(2, "0")}-${String(day).padStart(2, "0")}`;
|
|
96
|
+
}
|
|
97
|
+
|
|
98
|
+
/** Same day of the month `amount` months away, or the last day when the month is shorter. */
|
|
99
|
+
export function addMonths(value: string, amount: number): string {
|
|
100
|
+
const date = parseDate(value);
|
|
101
|
+
const target = new Date(Date.UTC(date.getUTCFullYear(), date.getUTCMonth() + amount, 1));
|
|
102
|
+
const last = new Date(
|
|
103
|
+
Date.UTC(target.getUTCFullYear(), target.getUTCMonth() + 1, 0),
|
|
104
|
+
).getUTCDate();
|
|
105
|
+
return toIsoDate(
|
|
106
|
+
target.getUTCFullYear(),
|
|
107
|
+
target.getUTCMonth() + 1,
|
|
108
|
+
Math.min(date.getUTCDate(), last),
|
|
109
|
+
);
|
|
110
|
+
}
|
|
111
|
+
|
|
112
|
+
/** The viewer's calendar date today, read from local fields (never from the UTC date). */
|
|
113
|
+
export function todayIso(now: Date = new Date()): string {
|
|
114
|
+
return toIsoDate(now.getFullYear(), now.getMonth() + 1, now.getDate());
|
|
115
|
+
}
|
|
116
|
+
|
|
117
|
+
/** `value` pulled inside `[min, max]`. ISO dates compare correctly as strings. */
|
|
118
|
+
export function clampDate(value: string, min?: string, max?: string): string {
|
|
119
|
+
if (min && value < min) return min;
|
|
120
|
+
if (max && value > max) return max;
|
|
121
|
+
return value;
|
|
122
|
+
}
|
|
123
|
+
|
|
124
|
+
/** Regions whose calendars conventionally start the week on Sunday. */
|
|
125
|
+
const SUNDAY_REGIONS = new Set([
|
|
126
|
+
"US",
|
|
127
|
+
"CA",
|
|
128
|
+
"MX",
|
|
129
|
+
"BR",
|
|
130
|
+
"JP",
|
|
131
|
+
"KR",
|
|
132
|
+
"IL",
|
|
133
|
+
"IN",
|
|
134
|
+
"PH",
|
|
135
|
+
"TW",
|
|
136
|
+
"HK",
|
|
137
|
+
"ZA",
|
|
138
|
+
"CO",
|
|
139
|
+
"VE",
|
|
140
|
+
"SA",
|
|
141
|
+
]);
|
|
142
|
+
|
|
143
|
+
/**
|
|
144
|
+
* First day of the week for a BCP 47 locale: Sunday (0) where that is the convention of the
|
|
145
|
+
* region (en-US, es-MX, pt-BR, ...), Monday (1) everywhere else, including es-PE and en-GB.
|
|
146
|
+
*/
|
|
147
|
+
export function weekStartFor(locale: string): WeekStart {
|
|
148
|
+
const region = /[-_]([A-Za-z]{2})(?:[-_]|$)/.exec(locale)?.[1]?.toUpperCase();
|
|
149
|
+
if (region) return SUNDAY_REGIONS.has(region) ? 0 : 1;
|
|
150
|
+
return locale.toLowerCase().startsWith("en") || locale.toLowerCase().startsWith("ja") ? 0 : 1;
|
|
151
|
+
}
|
|
152
|
+
|
|
153
|
+
/** "September 2026" with only the first letter capitalised ("Setiembre de 2026"). */
|
|
154
|
+
export function formatMonthTitle(value: string, locale?: string): string {
|
|
155
|
+
const raw = format(value, locale, { month: "long", year: "numeric" });
|
|
156
|
+
return raw.charAt(0).toLocaleUpperCase(locale) + raw.slice(1);
|
|
157
|
+
}
|
|
158
|
+
|
|
159
|
+
/** Full date for a screen reader, e.g. "Monday, September 7, 2026". */
|
|
160
|
+
export function formatFullDate(value: string, locale?: string): string {
|
|
161
|
+
return format(value, locale, { dateStyle: "full" });
|
|
162
|
+
}
|
|
163
|
+
|
|
164
|
+
/** Weekday names in column order starting at `weekStartsOn`. */
|
|
165
|
+
export function weekdayNames(
|
|
166
|
+
locale: string | undefined,
|
|
167
|
+
weekStartsOn: WeekStart,
|
|
168
|
+
): { narrow: string; long: string }[] {
|
|
169
|
+
// 2024-01-07 was a Sunday.
|
|
170
|
+
return Array.from({ length: 7 }, (_, index) => {
|
|
171
|
+
const day = addDays("2024-01-07", weekStartsOn + index);
|
|
172
|
+
return {
|
|
173
|
+
narrow: format(day, locale, { weekday: "narrow" }),
|
|
174
|
+
long: format(day, locale, { weekday: "long" }),
|
|
175
|
+
};
|
|
176
|
+
});
|
|
177
|
+
}
|
|
178
|
+
|
|
179
|
+
/** Six full weeks of "YYYY-MM-DD" covering the month of `value`, so the grid keeps its height. */
|
|
180
|
+
export function monthWeeks(value: string, weekStartsOn: WeekStart): string[][] {
|
|
181
|
+
const date = parseDate(value);
|
|
182
|
+
let cursor = startOfWeek(
|
|
183
|
+
formatDate(new Date(Date.UTC(date.getUTCFullYear(), date.getUTCMonth(), 1))),
|
|
184
|
+
weekStartsOn,
|
|
185
|
+
);
|
|
186
|
+
return Array.from({ length: 6 }, () =>
|
|
187
|
+
Array.from({ length: 7 }, () => {
|
|
188
|
+
const day = cursor;
|
|
189
|
+
cursor = addDays(cursor, 1);
|
|
190
|
+
return day;
|
|
191
|
+
}),
|
|
192
|
+
);
|
|
193
|
+
}
|
|
@@ -0,0 +1,40 @@
|
|
|
1
|
+
"use client";
|
|
2
|
+
|
|
3
|
+
import type { ComponentPropsWithoutRef, ReactNode } from "react";
|
|
4
|
+
import { useUiStrings } from "../../i18n/index.js";
|
|
5
|
+
import { cn } from "../../utils/cn.js";
|
|
6
|
+
|
|
7
|
+
export type AsideProps = ComponentPropsWithoutRef<"aside">;
|
|
8
|
+
|
|
9
|
+
/**
|
|
10
|
+
* Complementary column content (`<aside>`), named "Related information" unless given an
|
|
11
|
+
* `aria-label`. The column's width, surface and gutter belong to the page layout; the aside and
|
|
12
|
+
* its parts render flush to it.
|
|
13
|
+
*/
|
|
14
|
+
export function Aside({ className, "aria-label": ariaLabel, ...props }: AsideProps) {
|
|
15
|
+
const strings = useUiStrings();
|
|
16
|
+
return (
|
|
17
|
+
<aside
|
|
18
|
+
aria-label={ariaLabel ?? strings.aside}
|
|
19
|
+
className={cn("flex min-w-0 flex-col", className)}
|
|
20
|
+
{...props}
|
|
21
|
+
/>
|
|
22
|
+
);
|
|
23
|
+
}
|
|
24
|
+
|
|
25
|
+
export interface AsideHeaderProps extends Omit<ComponentPropsWithoutRef<"div">, "title"> {
|
|
26
|
+
title: ReactNode;
|
|
27
|
+
/** End slot, usually a link. */
|
|
28
|
+
action?: ReactNode;
|
|
29
|
+
}
|
|
30
|
+
|
|
31
|
+
export function AsideHeader({ title, action, className, ...props }: AsideHeaderProps) {
|
|
32
|
+
return (
|
|
33
|
+
<div className={cn("flex items-center justify-between gap-2 pt-4 pb-2", className)} {...props}>
|
|
34
|
+
<h2 className="m-0 min-w-0 font-semibold text-fs-120 text-ink-3 tracking-wide">{title}</h2>
|
|
35
|
+
{action !== undefined ? (
|
|
36
|
+
<div className="shrink-0 text-fs-120 text-ink-3 [&_a]:hover:text-ink">{action}</div>
|
|
37
|
+
) : null}
|
|
38
|
+
</div>
|
|
39
|
+
);
|
|
40
|
+
}
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
export { Aside, AsideHeader, type AsideHeaderProps, type AsideProps } from "./aside.js";
|
|
@@ -12,6 +12,19 @@ const toneClasses: Record<BannerTone, string> = {
|
|
|
12
12
|
danger: "bg-danger-soft",
|
|
13
13
|
};
|
|
14
14
|
|
|
15
|
+
export type BannerAppearance = "soft" | "outline";
|
|
16
|
+
|
|
17
|
+
/**
|
|
18
|
+
* `outline` keeps the page surface and lets only the border carry the tone: a quieter notice
|
|
19
|
+
* for content that sits inside a form or a card, where a tinted block would shout.
|
|
20
|
+
*/
|
|
21
|
+
const outlineToneClasses: Record<BannerTone, string> = {
|
|
22
|
+
info: "border border-info/40 bg-surface",
|
|
23
|
+
success: "border border-success/40 bg-surface",
|
|
24
|
+
warning: "border border-warning/40 bg-surface",
|
|
25
|
+
danger: "border border-danger/40 bg-surface",
|
|
26
|
+
};
|
|
27
|
+
|
|
15
28
|
const toneIconClasses: Record<BannerTone, string> = {
|
|
16
29
|
info: "text-info",
|
|
17
30
|
success: "text-success",
|
|
@@ -34,6 +47,8 @@ export type BannerPart = "root" | "icon" | "body" | "title" | "action";
|
|
|
34
47
|
|
|
35
48
|
export interface BannerProps extends Omit<ComponentPropsWithoutRef<"div">, "role" | "title"> {
|
|
36
49
|
tone?: BannerTone;
|
|
50
|
+
/** `soft` (default) tints the whole banner; `outline` keeps the surface and tints only the border. */
|
|
51
|
+
appearance?: BannerAppearance;
|
|
37
52
|
/** Bold first line above the content. */
|
|
38
53
|
title?: ReactNode;
|
|
39
54
|
/** Decorative icon on the left; marked `aria-hidden`. Defaults to a glyph for the tone; `null` hides it. */
|
|
@@ -46,6 +61,7 @@ export interface BannerProps extends Omit<ComponentPropsWithoutRef<"div">, "role
|
|
|
46
61
|
|
|
47
62
|
export function Banner({
|
|
48
63
|
tone = "info",
|
|
64
|
+
appearance = "soft",
|
|
49
65
|
title,
|
|
50
66
|
icon,
|
|
51
67
|
action,
|
|
@@ -58,9 +74,10 @@ export function Banner({
|
|
|
58
74
|
return (
|
|
59
75
|
<div
|
|
60
76
|
role={toneRole[tone]}
|
|
77
|
+
data-appearance={appearance}
|
|
61
78
|
className={cn(
|
|
62
79
|
"flex flex-wrap items-start gap-x-3 gap-y-2 rounded-banner px-3.5 py-3 text-fs-130 text-ink",
|
|
63
|
-
toneClasses[tone],
|
|
80
|
+
appearance === "outline" ? outlineToneClasses[tone] : toneClasses[tone],
|
|
64
81
|
classNames?.root,
|
|
65
82
|
className,
|
|
66
83
|
)}
|
|
@@ -1,21 +1,59 @@
|
|
|
1
|
-
import type { ComponentPropsWithoutRef } from "react";
|
|
1
|
+
import type { ComponentPropsWithoutRef, ReactNode } from "react";
|
|
2
2
|
import { cn } from "../../utils/cn.js";
|
|
3
3
|
|
|
4
|
-
export type
|
|
4
|
+
export type DescriptionListLayout = "auto" | "inline" | "stacked";
|
|
5
|
+
|
|
6
|
+
export interface DescriptionListProps extends ComponentPropsWithoutRef<"dl"> {
|
|
7
|
+
/**
|
|
8
|
+
* `auto` (default) puts the term beside the value and stacks them when the list's own container
|
|
9
|
+
* is narrower than 24rem; `inline` never stacks; `stacked` always puts the term over the value.
|
|
10
|
+
*/
|
|
11
|
+
layout?: DescriptionListLayout;
|
|
12
|
+
/** Side the values align to. Defaults to `end` (right in LTR); `start` reads like a form summary. */
|
|
13
|
+
valueAlign?: "end" | "start";
|
|
14
|
+
/** Pairs per row once the container is at least 28rem wide; one column below. Defaults to 1. */
|
|
15
|
+
columns?: 1 | 2 | 3;
|
|
16
|
+
}
|
|
17
|
+
|
|
18
|
+
const layoutClasses: Record<DescriptionListLayout, string> = {
|
|
19
|
+
auto: "grid-cols-[auto_minmax(0,1fr)] @max-sm/dl:grid-cols-1 @max-sm/dl:gap-y-0.5 @max-sm/dl:[&_dd]:mb-2 @max-sm/dl:[&_dd]:text-start",
|
|
20
|
+
inline: "grid-cols-[auto_minmax(0,1fr)]",
|
|
21
|
+
stacked: "grid-cols-1 gap-y-0.5 [&_dd]:mb-2 [&_dd]:text-start",
|
|
22
|
+
};
|
|
23
|
+
|
|
24
|
+
const columnClasses: Record<DescriptionListLayout, Record<2 | 3, string>> = {
|
|
25
|
+
auto: {
|
|
26
|
+
2: "@md/dl:grid-cols-[auto_minmax(0,1fr)_auto_minmax(0,1fr)]",
|
|
27
|
+
3: "@md/dl:grid-cols-[auto_minmax(0,1fr)_auto_minmax(0,1fr)_auto_minmax(0,1fr)]",
|
|
28
|
+
},
|
|
29
|
+
inline: {
|
|
30
|
+
2: "grid-cols-[auto_minmax(0,1fr)] @md/dl:grid-cols-[auto_minmax(0,1fr)_auto_minmax(0,1fr)]",
|
|
31
|
+
3: "grid-cols-[auto_minmax(0,1fr)] @md/dl:grid-cols-[auto_minmax(0,1fr)_auto_minmax(0,1fr)_auto_minmax(0,1fr)]",
|
|
32
|
+
},
|
|
33
|
+
stacked: { 2: "@md/dl:grid-cols-2", 3: "@md/dl:grid-cols-3" },
|
|
34
|
+
};
|
|
5
35
|
|
|
6
36
|
/**
|
|
7
|
-
*
|
|
8
|
-
*
|
|
9
|
-
*
|
|
37
|
+
* Key-value list: terms and values in a grid, no page padding. Compose flat `<dt>`/`<dd>` pairs
|
|
38
|
+
* or `DescriptionListItem`s (which fill an empty value with a placeholder) as children. Layout
|
|
39
|
+
* (`auto`/`inline`/`stacked`), value alignment and multi-column rows are container-query driven.
|
|
10
40
|
*/
|
|
11
|
-
export function DescriptionList({
|
|
41
|
+
export function DescriptionList({
|
|
42
|
+
className,
|
|
43
|
+
layout = "auto",
|
|
44
|
+
valueAlign = "end",
|
|
45
|
+
columns = 1,
|
|
46
|
+
...props
|
|
47
|
+
}: DescriptionListProps) {
|
|
12
48
|
return (
|
|
13
49
|
<div className="@container/dl min-w-0">
|
|
14
50
|
<dl
|
|
15
51
|
className={cn(
|
|
16
|
-
"grid
|
|
17
|
-
"[&_dt]:text-ink-3 [&_dd]:m-0 [&_dd]:min-w-0 [&_dd]:break-words [&_dd]:
|
|
18
|
-
"
|
|
52
|
+
"grid gap-x-4 gap-y-2.25 text-fs-130",
|
|
53
|
+
"[&_dt]:text-ink-3 [&_dd]:m-0 [&_dd]:min-w-0 [&_dd]:break-words [&_dd]:font-semibold",
|
|
54
|
+
valueAlign === "end" ? "[&_dd]:text-end" : "[&_dd]:text-start",
|
|
55
|
+
layoutClasses[layout],
|
|
56
|
+
columns !== 1 && columnClasses[layout][columns],
|
|
19
57
|
className,
|
|
20
58
|
)}
|
|
21
59
|
{...props}
|
|
@@ -23,3 +61,41 @@ export function DescriptionList({ className, ...props }: DescriptionListProps) {
|
|
|
23
61
|
</div>
|
|
24
62
|
);
|
|
25
63
|
}
|
|
64
|
+
|
|
65
|
+
export interface DescriptionListItemProps {
|
|
66
|
+
term: ReactNode;
|
|
67
|
+
/** The value. `null`, `undefined`, `false` and `""` render the placeholder instead. */
|
|
68
|
+
children?: ReactNode;
|
|
69
|
+
/** Shown for an empty value. Defaults to an em dash. */
|
|
70
|
+
placeholder?: ReactNode;
|
|
71
|
+
/** Screen-reader text for an empty value (the placeholder itself is decorative). */
|
|
72
|
+
emptyLabel?: string;
|
|
73
|
+
className?: string;
|
|
74
|
+
}
|
|
75
|
+
|
|
76
|
+
/** A `dt`/`dd` pair placed straight in the grid, with a placeholder for a missing value. */
|
|
77
|
+
export function DescriptionListItem({
|
|
78
|
+
term,
|
|
79
|
+
children,
|
|
80
|
+
placeholder = "—",
|
|
81
|
+
emptyLabel,
|
|
82
|
+
className,
|
|
83
|
+
}: DescriptionListItemProps) {
|
|
84
|
+
const empty =
|
|
85
|
+
children === null || children === undefined || children === false || children === "";
|
|
86
|
+
return (
|
|
87
|
+
<>
|
|
88
|
+
<dt>{term}</dt>
|
|
89
|
+
<dd data-empty={empty ? "" : undefined} className={className}>
|
|
90
|
+
{empty ? (
|
|
91
|
+
<>
|
|
92
|
+
<span aria-hidden="true">{placeholder}</span>
|
|
93
|
+
{emptyLabel ? <span className="sr-only">{emptyLabel}</span> : null}
|
|
94
|
+
</>
|
|
95
|
+
) : (
|
|
96
|
+
children
|
|
97
|
+
)}
|
|
98
|
+
</dd>
|
|
99
|
+
</>
|
|
100
|
+
);
|
|
101
|
+
}
|
|
@@ -0,0 +1,99 @@
|
|
|
1
|
+
"use client";
|
|
2
|
+
|
|
3
|
+
import type { ComponentPropsWithoutRef, ReactNode } from "react";
|
|
4
|
+
import { useUiStrings } from "../../i18n/index.js";
|
|
5
|
+
import type { ClassNames } from "../../utils/class-names.js";
|
|
6
|
+
import { cn } from "../../utils/cn.js";
|
|
7
|
+
import { type FeedTimeOptions, formatFeedTime, toDateTimeAttribute } from "./model.js";
|
|
8
|
+
|
|
9
|
+
export type FeedProps = ComponentPropsWithoutRef<"ol">;
|
|
10
|
+
|
|
11
|
+
/** Compact activity list: an outlined mark per event, a rail between them, a timestamp under each. Flush. */
|
|
12
|
+
export function Feed({ className, ...props }: FeedProps) {
|
|
13
|
+
return <ol className={cn("m-0 flex list-none flex-col p-0", className)} {...props} />;
|
|
14
|
+
}
|
|
15
|
+
|
|
16
|
+
export type FeedEventPart = "mark" | "rail" | "body" | "text" | "meta" | "time";
|
|
17
|
+
|
|
18
|
+
export interface FeedEventProps extends ComponentPropsWithoutRef<"li">, FeedTimeOptions {
|
|
19
|
+
/** Decorative glyph inside the mark (`aria-hidden`). Without it the mark is a dot. */
|
|
20
|
+
icon?: ReactNode;
|
|
21
|
+
/**
|
|
22
|
+
* When it happened: an ISO instant (`2026-03-04T15:30:00Z`), a calendar date (`2026-03-04`) or
|
|
23
|
+
* a `Date`. Rendered as `<time datetime>` and formatted with the locale of the UI strings.
|
|
24
|
+
*/
|
|
25
|
+
time?: string | Date;
|
|
26
|
+
/** Replaces the formatted `time` text (the machine value stays on `datetime`). */
|
|
27
|
+
timeLabel?: ReactNode;
|
|
28
|
+
/** Extra line under the text, after the time (an actor, a place). */
|
|
29
|
+
meta?: ReactNode;
|
|
30
|
+
/** Per-part classes merged with `cn`; consumer classes win. `className` still targets the item. */
|
|
31
|
+
classNames?: ClassNames<FeedEventPart>;
|
|
32
|
+
}
|
|
33
|
+
|
|
34
|
+
export function FeedEvent({
|
|
35
|
+
icon,
|
|
36
|
+
time,
|
|
37
|
+
timeLabel,
|
|
38
|
+
meta,
|
|
39
|
+
locale,
|
|
40
|
+
timeZone,
|
|
41
|
+
relative,
|
|
42
|
+
now,
|
|
43
|
+
className,
|
|
44
|
+
classNames,
|
|
45
|
+
children,
|
|
46
|
+
...props
|
|
47
|
+
}: FeedEventProps) {
|
|
48
|
+
const strings = useUiStrings();
|
|
49
|
+
const text =
|
|
50
|
+
timeLabel ??
|
|
51
|
+
(time === undefined
|
|
52
|
+
? null
|
|
53
|
+
: formatFeedTime(time, { locale: locale ?? strings.locale, timeZone, relative, now }));
|
|
54
|
+
return (
|
|
55
|
+
<li
|
|
56
|
+
className={cn(
|
|
57
|
+
"group/ev relative grid grid-cols-[1.25rem_minmax(0,1fr)] gap-2.5 py-2",
|
|
58
|
+
className,
|
|
59
|
+
)}
|
|
60
|
+
{...props}
|
|
61
|
+
>
|
|
62
|
+
<span
|
|
63
|
+
aria-hidden="true"
|
|
64
|
+
className={cn(
|
|
65
|
+
"absolute top-6.5 -bottom-2 left-2.25 w-px bg-divider group-last/ev:hidden",
|
|
66
|
+
classNames?.rail,
|
|
67
|
+
)}
|
|
68
|
+
/>
|
|
69
|
+
<span
|
|
70
|
+
aria-hidden="true"
|
|
71
|
+
className={cn(
|
|
72
|
+
"relative grid size-5 place-items-center rounded-pill border-divider bg-surface text-ink-3 [&_svg]:size-3",
|
|
73
|
+
classNames?.mark,
|
|
74
|
+
)}
|
|
75
|
+
>
|
|
76
|
+
{icon ?? <span className="size-1.5 rounded-pill bg-current" />}
|
|
77
|
+
</span>
|
|
78
|
+
<div className={cn("min-w-0", classNames?.body)}>
|
|
79
|
+
<p className={cn("m-0 text-fs-130 leading-snug [&_b]:font-medium", classNames?.text)}>
|
|
80
|
+
{children}
|
|
81
|
+
</p>
|
|
82
|
+
{text !== null || meta !== undefined ? (
|
|
83
|
+
<p className={cn("m-0 text-meta text-ink-3 tabular-nums", classNames?.meta)}>
|
|
84
|
+
{text !== null ? (
|
|
85
|
+
<time
|
|
86
|
+
dateTime={time === undefined ? undefined : toDateTimeAttribute(time)}
|
|
87
|
+
className={classNames?.time}
|
|
88
|
+
>
|
|
89
|
+
{text}
|
|
90
|
+
</time>
|
|
91
|
+
) : null}
|
|
92
|
+
{text !== null && meta !== undefined ? " · " : null}
|
|
93
|
+
{meta}
|
|
94
|
+
</p>
|
|
95
|
+
) : null}
|
|
96
|
+
</div>
|
|
97
|
+
</li>
|
|
98
|
+
);
|
|
99
|
+
}
|
|
@@ -0,0 +1,54 @@
|
|
|
1
|
+
import { isIsoDate, parseDate } from "../../calendar/internal/date-utils.js";
|
|
2
|
+
|
|
3
|
+
export interface FeedTimeOptions {
|
|
4
|
+
locale?: string | undefined;
|
|
5
|
+
/** IANA zone used to show an instant (default: the viewer's). Calendar dates never use a zone. */
|
|
6
|
+
timeZone?: string | undefined;
|
|
7
|
+
/** Show "5 minutes ago" for instants within a week of `now` instead of the absolute time. */
|
|
8
|
+
relative?: boolean | undefined;
|
|
9
|
+
/** Reference instant for `relative` (default: the current time). */
|
|
10
|
+
now?: Date | string | number | undefined;
|
|
11
|
+
}
|
|
12
|
+
|
|
13
|
+
const DATE_ONLY = /^\d{4}-\d{2}-\d{2}$/;
|
|
14
|
+
|
|
15
|
+
/** True when `value` is a calendar date ("YYYY-MM-DD") rather than an instant. */
|
|
16
|
+
export function isCalendarDate(value: string): boolean {
|
|
17
|
+
return DATE_ONLY.test(value) && isIsoDate(value);
|
|
18
|
+
}
|
|
19
|
+
|
|
20
|
+
/** The value for a `<time datetime>` attribute: strings pass through, dates become ISO instants. */
|
|
21
|
+
export function toDateTimeAttribute(value: string | Date): string {
|
|
22
|
+
return typeof value === "string" ? value : value.toISOString();
|
|
23
|
+
}
|
|
24
|
+
|
|
25
|
+
/**
|
|
26
|
+
* Display text for a feed timestamp. A calendar date ("2026-03-04") is formatted in UTC so it
|
|
27
|
+
* never shifts a day; an instant is shown as date and time in `timeZone`; with `relative`, an
|
|
28
|
+
* instant within a week of `now` reads "5 minutes ago". Invalid input comes back unchanged.
|
|
29
|
+
*/
|
|
30
|
+
export function formatFeedTime(value: string | Date, options: FeedTimeOptions = {}): string {
|
|
31
|
+
const { locale, timeZone, relative = false, now } = options;
|
|
32
|
+
if (typeof value === "string" && isCalendarDate(value)) {
|
|
33
|
+
return new Intl.DateTimeFormat(locale, { dateStyle: "medium", timeZone: "UTC" }).format(
|
|
34
|
+
parseDate(value),
|
|
35
|
+
);
|
|
36
|
+
}
|
|
37
|
+
const instant = typeof value === "string" ? new Date(value) : value;
|
|
38
|
+
if (Number.isNaN(instant.getTime())) return String(value);
|
|
39
|
+
if (relative) {
|
|
40
|
+
const reference = now === undefined ? new Date() : new Date(now);
|
|
41
|
+
const seconds = Math.round((instant.getTime() - reference.getTime()) / 1000);
|
|
42
|
+
const abs = Math.abs(seconds);
|
|
43
|
+
const rtf = new Intl.RelativeTimeFormat(locale, { numeric: "auto" });
|
|
44
|
+
if (abs < 60) return rtf.format(seconds === 0 ? 0 : Math.sign(seconds) * abs, "second");
|
|
45
|
+
if (abs < 3600) return rtf.format(Math.round(seconds / 60), "minute");
|
|
46
|
+
if (abs < 86400) return rtf.format(Math.round(seconds / 3600), "hour");
|
|
47
|
+
if (abs < 7 * 86400) return rtf.format(Math.round(seconds / 86400), "day");
|
|
48
|
+
}
|
|
49
|
+
return new Intl.DateTimeFormat(locale, {
|
|
50
|
+
dateStyle: "medium",
|
|
51
|
+
timeStyle: "short",
|
|
52
|
+
...(timeZone ? { timeZone } : {}),
|
|
53
|
+
}).format(instant);
|
|
54
|
+
}
|
package/src/containers/index.ts
CHANGED
|
@@ -1,4 +1,5 @@
|
|
|
1
1
|
export * from "./action-bar/index.js";
|
|
2
|
+
export * from "./aside/index.js";
|
|
2
3
|
export * from "./banner/index.js";
|
|
3
4
|
export * from "./card/index.js";
|
|
4
5
|
export * from "./carousel/index.js";
|
|
@@ -9,6 +10,7 @@ export * from "./confirm-action/index.js";
|
|
|
9
10
|
export * from "./data-grid/index.js";
|
|
10
11
|
export * from "./description-list/index.js";
|
|
11
12
|
export * from "./facts/index.js";
|
|
13
|
+
export * from "./feed/index.js";
|
|
12
14
|
export * from "./file-tree/index.js";
|
|
13
15
|
export * from "./generic-row/index.js";
|
|
14
16
|
export * from "./grid/index.js";
|
|
@@ -18,13 +20,17 @@ export * from "./item-card-group/index.js";
|
|
|
18
20
|
export * from "./kanban/index.js";
|
|
19
21
|
export * from "./kpi/index.js";
|
|
20
22
|
export * from "./kpi-group/index.js";
|
|
23
|
+
export * from "./list-detail/index.js";
|
|
24
|
+
export * from "./note/index.js";
|
|
21
25
|
export * from "./page/index.js";
|
|
22
26
|
export * from "./page-header/index.js";
|
|
23
27
|
export * from "./resizable/index.js";
|
|
24
28
|
export * from "./responsive-list/index.js";
|
|
25
29
|
export * from "./scrolly/index.js";
|
|
30
|
+
export * from "./section/index.js";
|
|
26
31
|
export * from "./settings-layout/index.js";
|
|
27
32
|
export * from "./settings-row/index.js";
|
|
33
|
+
export * from "./shortcuts/index.js";
|
|
28
34
|
export * from "./stack/index.js";
|
|
29
35
|
export * from "./table/index.js";
|
|
30
36
|
export * from "./timeline/index.js";
|