An open source design system that's fully customizable and agent ready
TypeScript
refactor(timestamp): rename system_unix format to unix_seconds (#4720)
freddymeta6878727e32c5
diff --git a/.changeset/timestamp-rename-unix-seconds.md b/.changeset/timestamp-rename-unix-seconds.mdnew file mode 100644index 0000000000..8da9e05ad8--- /dev/null+++ b/.changeset/timestamp-rename-unix-seconds.md@@ -0,0 +1,7 @@+---+'@astryxdesign/core': patch+---++[feat] Timestamp: rename the recently added `system_unix` format to `unix_seconds`. The value is absolute Unix time in whole seconds since the epoch — not a wall-clock `system_*` rendering — so it does not belong to the `system_*` family; the explicit unit name also leaves room for a future `unix_millis`. Behavior is unchanged (zone-independent epoch seconds). This renames a format value that only just shipped, before it has consumers.++@freddymetadiff --git a/packages/core/src/Timestamp/Timestamp.doc.mjs b/packages/core/src/Timestamp/Timestamp.doc.mjsindex f4c7772516..0ff84ef851 100644--- a/packages/core/src/Timestamp/Timestamp.doc.mjs+++ b/packages/core/src/Timestamp/Timestamp.doc.mjs@@ -26,9 +26,9 @@ export const docs = {},{name: 'format',- type: "'relative' | 'relative_short' | 'auto' | 'date' | 'date_long' | 'date_weekday' | 'date_time' | 'time' | 'system_date' | 'system_date_time' | 'system_time' | 'system_unix'",+ type: "'relative' | 'relative_short' | 'auto' | 'date' | 'date_long' | 'date_weekday' | 'date_time' | 'time' | 'system_date' | 'system_date_time' | 'system_time' | 'unix_seconds'",description:- "Display format. 'relative' shows '2 hours ago', 'relative_short' shows the same tiers abbreviated ('2h ago', '1d ago', '3mo ago') for compact surfaces, 'date' shows 'Mar 21, 2025', 'date_long' shows 'March 21, 2025', 'date_weekday' shows 'Wed, Mar 21, 2025', 'date_time' shows 'Mar 21, 2025, 2:51 PM', 'time' shows '2:51 PM', 'system_*' variants use ISO-style formatting ('system_unix' is the Unix time in whole seconds since the epoch, an absolute/zone-independent value), 'auto' switches from relative to date_time based on recency.",+ "Display format. 'relative' shows '2 hours ago', 'relative_short' shows the same tiers abbreviated ('2h ago', '1d ago', '3mo ago') for compact surfaces, 'date' shows 'Mar 21, 2025', 'date_long' shows 'March 21, 2025', 'date_weekday' shows 'Wed, Mar 21, 2025', 'date_time' shows 'Mar 21, 2025, 2:51 PM', 'time' shows '2:51 PM', 'system_*' variants use ISO-style formatting, 'unix_seconds' shows the Unix time in whole seconds since the epoch (an absolute, zone-independent value), 'auto' switches from relative to date_time based on recency.",default: "'auto'",},{@@ -185,7 +185,7 @@ export const docsDense = {},propDescriptions: {value: 'date/time as unix seconds or ISO string',- format: "display mode: 'relative', 'auto', 'date', 'date_long', 'date_weekday', 'date_time', 'time', 'system_date', 'system_date_time', 'system_time', 'system_unix'",+ format: "display mode: 'relative', 'auto', 'date', 'date_long', 'date_weekday', 'date_time', 'time', 'system_date', 'system_date_time', 'system_time', 'unix_seconds'",autoThreshold: 'seconds threshold for auto relative\u2192date_time switch',hasTooltip: 'show copyable full-time hover card on hover (relative mode, or any format with tooltipEntries)',tooltipEntries:diff --git a/packages/core/src/Timestamp/Timestamp.test.tsx b/packages/core/src/Timestamp/Timestamp.test.tsxindex 84a20eed50..b35e76a9b7 100644--- a/packages/core/src/Timestamp/Timestamp.test.tsx+++ b/packages/core/src/Timestamp/Timestamp.test.tsx@@ -343,22 +343,22 @@ describe('Timestamp', () => {expect(el.textContent).toMatch(/\d{2}:\d{2}:\d{2}/);});- it('renders system_unix format as whole epoch seconds (zone-independent)', () => {+ it('renders unix_seconds format as whole epoch seconds (zone-independent)', () => {// 2026-02-19T17:00:00Z is 1771520400 seconds since the epoch. The value is// absolute, so it is the same regardless of the viewer's zone.render(<Timestampvalue="2026-02-19T17:00:00Z"- format="system_unix"+ format="unix_seconds"data-testid="ts"/>,);expect(screen.getByTestId('ts').textContent).toBe('1771520400');});- it('renders system_unix from a Unix-seconds value input unchanged', () => {+ it('renders unix_seconds from a Unix-seconds value input unchanged', () => {render(- <Timestamp value={1771520400} format="system_unix" data-testid="ts" />,+ <Timestamp value={1771520400} format="unix_seconds" data-testid="ts" />,);expect(screen.getByTestId('ts').textContent).toBe('1771520400');});diff --git a/packages/core/src/Timestamp/Timestamp.tsx b/packages/core/src/Timestamp/Timestamp.tsxindex cbcaf26a10..92cdc5c2b8 100644--- a/packages/core/src/Timestamp/Timestamp.tsx+++ b/packages/core/src/Timestamp/Timestamp.tsx@@ -53,7 +53,7 @@ export type TimestampFormat =| 'system_date'| 'system_date_time'| 'system_time'- | 'system_unix';+ | 'unix_seconds';export interface TimestampProps extends BaseProps<HTMLTimeElement> {/** Ref forwarded to the root `<time>` element. */@@ -75,7 +75,7 @@ export interface TimestampProps extends BaseProps<HTMLTimeElement> {* - `'system_date'`: "2025-03-21"* - `'system_date_time'`: "2025-03-21 14:51:53"* - `'system_time'`: "14:51:53"- * - `'system_unix'`: "1742565113" — Unix time in whole seconds since the+ * - `'unix_seconds'`: "1742565113" — Unix time in whole seconds since the* epoch. Absolute (zone-independent), so it ignores any tooltip time zone.* @default 'auto'*/diff --git a/packages/core/src/Timestamp/formatInstant.ts b/packages/core/src/Timestamp/formatInstant.tsindex 4b9e2da419..6938dd5114 100644--- a/packages/core/src/Timestamp/formatInstant.ts+++ b/packages/core/src/Timestamp/formatInstant.ts@@ -214,7 +214,7 @@ export function formatInstant(return `${pad(w.hour)}:${pad(w.minute)}:${pad(w.second)}`;}- case 'system_unix':+ case 'unix_seconds':// Unix time in whole seconds since the epoch. The epoch is an absolute// instant, so this is zone-independent — `timeZone` is intentionally// ignored (a wall-clock zone can't change how many seconds have elapsed).