@canonical/react-ds-app-launchpad 0.9.0-experimental.5 → 0.9.0-experimental.6

package/dist/esm/ui/RelativeTime/RelativeTime.js

@@ -0,0 +1,66 @@
+import { jsx as _jsx } from "react/jsx-runtime";
+import { useCallback, useEffect, useMemo, useRef, useState } from "react";
+import { formatHumanTime, getOptimalUpdateInterval, parseInstant, } from "./utils/index.js";
+const componentCssClassName = "ds relative-time";
+/**
+ * The RelativeTime component displays timestamps in a human-readable relative format (like "2 hours ago" or "in 3 days").
+ *
+ * It features automatic live updates with interval optimization based on time distance, configurable "now" threshold,
+ * and renders as proper semantic HTML using the <time> element. The component leverages the Temporal API for calculations and Intl.RelativeTimeFormat for localization.
+ */
+const RelativeTime = ({ id, className, style, time, relativeTimeFormat, nowThreshold = 10, disableLiveUpdate = false, nowKeyword = "now", invalidDateKeyword = "invalid date", }) => {
+    const [relativeTime, setRelativeTime] = useState("");
+    const [localeTimeString, setLocaleTimeString] = useState("");
+    const [stringTime, setStringTime] = useState("");
+    const intervalRef = useRef(null);
+    const instantTime = useMemo(() => {
+        try {
+            return parseInstant(time);
+        }
+        catch (error) {
+            console.error(error);
+            return null;
+        }
+    }, [time]);
+    const updateRelativeTime = useCallback(() => {
+        if (instantTime === null) {
+            setRelativeTime(invalidDateKeyword);
+            setLocaleTimeString("");
+            setStringTime("");
+            return null;
+        }
+        const timeFormatter = relativeTimeFormat ||
+            new Intl.RelativeTimeFormat(undefined, { numeric: "auto" });
+        setRelativeTime(formatHumanTime(instantTime, {
+            nowThreshold,
+            nowKeyword,
+            relativeTimeFormat: timeFormatter,
+        }));
+        setLocaleTimeString(instantTime.toLocaleString());
+        setStringTime(instantTime.toString());
+    }, [
+        instantTime,
+        relativeTimeFormat,
+        nowThreshold,
+        nowKeyword,
+        invalidDateKeyword,
+    ]);
+    useEffect(() => {
+        // initial calculation
+        updateRelativeTime();
+        if (disableLiveUpdate || instantTime === null)
+            return;
+        const updateInterval = getOptimalUpdateInterval(instantTime);
+        // SSR check
+        if (typeof window === "undefined")
+            return;
+        intervalRef.current = window.setInterval(updateRelativeTime, updateInterval);
+        return () => {
+            if (intervalRef.current)
+                window.clearInterval(intervalRef.current);
+        };
+    }, [instantTime, disableLiveUpdate, updateRelativeTime]);
+    return (_jsx("time", { id: id, style: style, className: [componentCssClassName, className].filter(Boolean).join(" "), title: localeTimeString, dateTime: stringTime, children: relativeTime }));
+};
+export default RelativeTime;
+//# sourceMappingURL=RelativeTime.js.map

package/dist/esm/ui/RelativeTime/RelativeTime.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"RelativeTime.js","sourceRoot":"","sources":["../../../../src/ui/RelativeTime/RelativeTime.tsx"],"names":[],"mappings":"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"}

package/dist/esm/ui/RelativeTime/index.js

@@ -0,0 +1,4 @@
+/* @canonical/generator-ds 0.9.0-experimental.4 */
+export { default as RelativeTime } from "./RelativeTime.js";
+export * from "./types.js";
+//# sourceMappingURL=index.js.map

package/dist/esm/ui/RelativeTime/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/ui/RelativeTime/index.ts"],"names":[],"mappings":"AAAA,kDAAkD;AAClD,OAAO,EAAE,OAAO,IAAI,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAC5D,cAAc,YAAY,CAAC"}

package/dist/esm/ui/RelativeTime/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/esm/ui/RelativeTime/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../../src/ui/RelativeTime/types.ts"],"names":[],"mappings":""}

package/dist/esm/ui/RelativeTime/utils/constants.js

@@ -0,0 +1,6 @@
+export const MINUTE_IN_SECONDS = 60;
+export const HOUR_IN_SECONDS = MINUTE_IN_SECONDS * 60;
+export const DAY_IN_SECONDS = HOUR_IN_SECONDS * 24;
+export const MONTH_IN_SECONDS = DAY_IN_SECONDS * 30;
+export const YEAR_IN_SECONDS = DAY_IN_SECONDS * 365;
+//# sourceMappingURL=constants.js.map

package/dist/esm/ui/RelativeTime/utils/constants.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.js","sourceRoot":"","sources":["../../../../../src/ui/RelativeTime/utils/constants.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,iBAAiB,GAAG,EAAE,CAAC;AACpC,MAAM,CAAC,MAAM,eAAe,GAAG,iBAAiB,GAAG,EAAE,CAAC;AACtD,MAAM,CAAC,MAAM,cAAc,GAAG,eAAe,GAAG,EAAE,CAAC;AACnD,MAAM,CAAC,MAAM,gBAAgB,GAAG,cAAc,GAAG,EAAE,CAAC;AACpD,MAAM,CAAC,MAAM,eAAe,GAAG,cAAc,GAAG,GAAG,CAAC"}

package/dist/esm/ui/RelativeTime/utils/formatHumanTime.js

@@ -0,0 +1,43 @@
+import { Temporal } from "@js-temporal/polyfill";
+/**
+ * Formats a given instant as a human-readable time relative to the current time.
+ * @param instant The instant to format.
+ * @param options The options to use for formatting.
+ * @returns A human-readable relative time string
+ */
+function formatHumanTime(instant, options) {
+    const now = Temporal.Now.instant();
+    const deltaSeconds = instant.epochSeconds - now.epochSeconds;
+    const absDeltaSeconds = Math.abs(deltaSeconds);
+    if (absDeltaSeconds < options.nowThreshold) {
+        return options.nowKeyword;
+    }
+    const timeZone = Temporal.Now.timeZoneId() || "UTC";
+    const instantZDT = instant.toZonedDateTimeISO(timeZone);
+    const nowZDT = now.toZonedDateTimeISO(timeZone);
+    const diff = instantZDT.since(nowZDT, { largestUnit: "years" });
+    const units = [
+        "years",
+        "months",
+        "days",
+        "hours",
+        "minutes",
+        "seconds",
+    ];
+    let rtfUnit = "seconds";
+    let rtfValue = 0;
+    for (const unit of units) {
+        const value = diff[unit];
+        if (value !== 0) {
+            rtfUnit = unit;
+            rtfValue = value;
+            break;
+        }
+    }
+    if (rtfValue === 0) {
+        return options.nowKeyword;
+    }
+    return options.relativeTimeFormat.format(rtfValue, rtfUnit);
+}
+export default formatHumanTime;
+//# sourceMappingURL=formatHumanTime.js.map

package/dist/esm/ui/RelativeTime/utils/formatHumanTime.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"formatHumanTime.js","sourceRoot":"","sources":["../../../../../src/ui/RelativeTime/utils/formatHumanTime.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AAgBjD;;;;;GAKG;AACH,SAAS,eAAe,CACtB,OAAyB,EACzB,OAAyB;IAEzB,MAAM,GAAG,GAAG,QAAQ,CAAC,GAAG,CAAC,OAAO,EAAE,CAAC;IACnC,MAAM,YAAY,GAAG,OAAO,CAAC,YAAY,GAAG,GAAG,CAAC,YAAY,CAAC;IAC7D,MAAM,eAAe,GAAG,IAAI,CAAC,GAAG,CAAC,YAAY,CAAC,CAAC;IAE/C,IAAI,eAAe,GAAG,OAAO,CAAC,YAAY,EAAE,CAAC;QAC3C,OAAO,OAAO,CAAC,UAAU,CAAC;IAC5B,CAAC;IAED,MAAM,QAAQ,GAAG,QAAQ,CAAC,GAAG,CAAC,UAAU,EAAE,IAAI,KAAK,CAAC;IACpD,MAAM,UAAU,GAAG,OAAO,CAAC,kBAAkB,CAAC,QAAQ,CAAC,CAAC;IACxD,MAAM,MAAM,GAAG,GAAG,CAAC,kBAAkB,CAAC,QAAQ,CAAC,CAAC;IAChD,MAAM,IAAI,GAAG,UAAU,CAAC,KAAK,CAAC,MAAM,EAAE,EAAE,WAAW,EAAE,OAAO,EAAE,CAAC,CAAC;IAEhE,MAAM,KAAK,GAAG;QACZ,OAAO;QACP,QAAQ;QACR,MAAM;QACN,OAAO;QACP,SAAS;QACT,SAAS;KAC8B,CAAC;IAE1C,IAAI,OAAO,GAAgC,SAAS,CAAC;IACrD,IAAI,QAAQ,GAAG,CAAC,CAAC;IAEjB,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,MAAM,KAAK,GAAG,IAAI,CAAC,IAAI,CAAC,CAAC;QACzB,IAAI,KAAK,KAAK,CAAC,EAAE,CAAC;YAChB,OAAO,GAAG,IAAI,CAAC;YACf,QAAQ,GAAG,KAAK,CAAC;YACjB,MAAM;QACR,CAAC;IACH,CAAC;IAED,IAAI,QAAQ,KAAK,CAAC,EAAE,CAAC;QACnB,OAAO,OAAO,CAAC,UAAU,CAAC;IAC5B,CAAC;IAED,OAAO,OAAO,CAAC,kBAAkB,CAAC,MAAM,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;AAC9D,CAAC;AAED,eAAe,eAAe,CAAC"}

package/dist/esm/ui/RelativeTime/utils/getOptimalUpdateInterval.js

@@ -0,0 +1,24 @@
+import { Temporal } from "@js-temporal/polyfill";
+import * as constants from "./constants.js";
+/**
+ * Calcualte the optimal update interval for a given instant based on the time distance from now.
+ * @returns The optimal update interval in milliseconds.
+ */
+function getOptimalUpdateInterval(instant) {
+    const now = Temporal.Now.instant();
+    const deltaSeconds = instant.epochSeconds - now.epochSeconds;
+    const absDeltaSeconds = Math.abs(deltaSeconds);
+    if (absDeltaSeconds < constants.MINUTE_IN_SECONDS) {
+        return 1000;
+    }
+    if (absDeltaSeconds < constants.HOUR_IN_SECONDS) {
+        return constants.MINUTE_IN_SECONDS * 1000;
+    }
+    if (absDeltaSeconds < constants.DAY_IN_SECONDS) {
+        return constants.HOUR_IN_SECONDS * 1000;
+    }
+    // for any other time distance, update once a day
+    return constants.DAY_IN_SECONDS * 1000;
+}
+export default getOptimalUpdateInterval;
+//# sourceMappingURL=getOptimalUpdateInterval.js.map

package/dist/esm/ui/RelativeTime/utils/getOptimalUpdateInterval.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"getOptimalUpdateInterval.js","sourceRoot":"","sources":["../../../../../src/ui/RelativeTime/utils/getOptimalUpdateInterval.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AACjD,OAAO,KAAK,SAAS,MAAM,gBAAgB,CAAC;AAE5C;;;GAGG;AACH,SAAS,wBAAwB,CAAC,OAAyB;IACzD,MAAM,GAAG,GAAG,QAAQ,CAAC,GAAG,CAAC,OAAO,EAAE,CAAC;IACnC,MAAM,YAAY,GAAG,OAAO,CAAC,YAAY,GAAG,GAAG,CAAC,YAAY,CAAC;IAC7D,MAAM,eAAe,GAAG,IAAI,CAAC,GAAG,CAAC,YAAY,CAAC,CAAC;IAE/C,IAAI,eAAe,GAAG,SAAS,CAAC,iBAAiB,EAAE,CAAC;QAClD,OAAO,IAAI,CAAC;IACd,CAAC;IAED,IAAI,eAAe,GAAG,SAAS,CAAC,eAAe,EAAE,CAAC;QAChD,OAAO,SAAS,CAAC,iBAAiB,GAAG,IAAI,CAAC;IAC5C,CAAC;IAED,IAAI,eAAe,GAAG,SAAS,CAAC,cAAc,EAAE,CAAC;QAC/C,OAAO,SAAS,CAAC,eAAe,GAAG,IAAI,CAAC;IAC1C,CAAC;IACD,iDAAiD;IACjD,OAAO,SAAS,CAAC,cAAc,GAAG,IAAI,CAAC;AACzC,CAAC;AAED,eAAe,wBAAwB,CAAC"}

package/dist/esm/ui/RelativeTime/utils/index.js

@@ -0,0 +1,4 @@
+export { default as formatHumanTime } from "./formatHumanTime.js";
+export { default as getOptimalUpdateInterval } from "./getOptimalUpdateInterval.js";
+export { default as parseInstant } from "./parseInstant.js";
+//# sourceMappingURL=index.js.map

package/dist/esm/ui/RelativeTime/utils/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../src/ui/RelativeTime/utils/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,IAAI,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAClE,OAAO,EAAE,OAAO,IAAI,wBAAwB,EAAE,MAAM,+BAA+B,CAAC;AACpF,OAAO,EAAE,OAAO,IAAI,YAAY,EAAE,MAAM,mBAAmB,CAAC"}

package/dist/esm/ui/RelativeTime/utils/parseInstant.js

@@ -0,0 +1,22 @@
+import { Temporal } from "@js-temporal/polyfill";
+/**
+ * Parser for Temporal.Instant.
+ * @param time - instance, date or string to parse
+ * @throws Error if time is invalid
+ */
+function parseInstant(time) {
+    if (time instanceof Temporal.Instant) {
+        return time;
+    }
+    if (time instanceof Date) {
+        return Temporal.Instant.fromEpochMilliseconds(time.getTime());
+    }
+    try {
+        return Temporal.Instant.from(time);
+    }
+    catch (e) {
+        throw new Error(`Invalid time string (ISO string or Date object expected): ${time}`);
+    }
+}
+export default parseInstant;
+//# sourceMappingURL=parseInstant.js.map

package/dist/esm/ui/RelativeTime/utils/parseInstant.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"parseInstant.js","sourceRoot":"","sources":["../../../../../src/ui/RelativeTime/utils/parseInstant.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AAEjD;;;;GAIG;AACH,SAAS,YAAY,CAAC,IAAsC;IAC1D,IAAI,IAAI,YAAY,QAAQ,CAAC,OAAO,EAAE,CAAC;QACrC,OAAO,IAAI,CAAC;IACd,CAAC;IACD,IAAI,IAAI,YAAY,IAAI,EAAE,CAAC;QACzB,OAAO,QAAQ,CAAC,OAAO,CAAC,qBAAqB,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC,CAAC;IAChE,CAAC;IACD,IAAI,CAAC;QACH,OAAO,QAAQ,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACrC,CAAC;IAAC,OAAO,CAAC,EAAE,CAAC;QACX,MAAM,IAAI,KAAK,CACb,6DAA6D,IAAI,EAAE,CACpE,CAAC;IACJ,CAAC;AACH,CAAC;AAED,eAAe,YAAY,CAAC"}

package/dist/types/ui/RelativeTime/RelativeTime.d.ts

@@ -0,0 +1,11 @@
+import type React from "react";
+import type { RelativeTimeProps } from "./types.js";
+/**
+ * The RelativeTime component displays timestamps in a human-readable relative format (like "2 hours ago" or "in 3 days").
+ *
+ * It features automatic live updates with interval optimization based on time distance, configurable "now" threshold,
+ * and renders as proper semantic HTML using the <time> element. The component leverages the Temporal API for calculations and Intl.RelativeTimeFormat for localization.
+ */
+declare const RelativeTime: ({ id, className, style, time, relativeTimeFormat, nowThreshold, disableLiveUpdate, nowKeyword, invalidDateKeyword, }: RelativeTimeProps) => React.ReactElement;
+export default RelativeTime;
+//# sourceMappingURL=RelativeTime.d.ts.map

package/dist/types/ui/RelativeTime/RelativeTime.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"RelativeTime.d.ts","sourceRoot":"","sources":["../../../../src/ui/RelativeTime/RelativeTime.tsx"],"names":[],"mappings":"AAEA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAE/B,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AASpD;;;;;GAKG;AACH,QAAA,MAAM,YAAY,yHAUf,iBAAiB,KAAG,KAAK,CAAC,YA0E5B,CAAC;AAEF,eAAe,YAAY,CAAC"}

package/dist/types/ui/RelativeTime/index.d.ts

@@ -0,0 +1,3 @@
+export { default as RelativeTime } from "./RelativeTime.js";
+export * from "./types.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/types/ui/RelativeTime/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/ui/RelativeTime/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,OAAO,IAAI,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAC5D,cAAc,YAAY,CAAC"}

package/dist/types/ui/RelativeTime/types.d.ts

@@ -0,0 +1,36 @@
+import type { Temporal } from "@js-temporal/polyfill";
+import type React from "react";
+export interface RelativeTimeProps {
+    /** A unique identifier for the RelativeTime */
+    id?: string;
+    /** Additional CSS classes */
+    className?: string;
+    /** Inline styles */
+    style?: React.CSSProperties;
+    /**
+     * The time to be displayed as a relative time (ISO string or Date object).
+     */
+    time: string | Date | Temporal.Instant;
+    /**
+     * Disable live duration updates (default: false).
+     */
+    disableLiveUpdate?: boolean;
+    /**
+     * custom relative time format (default: local language and narrow style).
+     * @see https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Intl/RelativeTimeFormat
+     */
+    relativeTimeFormat?: Intl.RelativeTimeFormat;
+    /**
+     * The threshold in seconds for when to display the relative time as "just now" (default is 10).
+     */
+    nowThreshold?: number;
+    /**
+     * The keyword to use for "now" (default: "now")
+     */
+    nowKeyword?: string;
+    /**
+     * The keyword to use when the given time is not a valid. (default: "invalid date")
+     */
+    invalidDateKeyword?: string;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types/ui/RelativeTime/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../src/ui/RelativeTime/types.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AACtD,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAE/B,MAAM,WAAW,iBAAiB;IAChC,+CAA+C;IAC/C,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,6BAA6B;IAC7B,SAAS,CAAC,EAAE,MAAM,CAAC;IAEnB,oBAAoB;IACpB,KAAK,CAAC,EAAE,KAAK,CAAC,aAAa,CAAC;IAE5B;;OAEG;IACH,IAAI,EAAE,MAAM,GAAG,IAAI,GAAG,QAAQ,CAAC,OAAO,CAAC;IAEvC;;OAEG;IACH,iBAAiB,CAAC,EAAE,OAAO,CAAC;IAE5B;;;OAGG;IACH,kBAAkB,CAAC,EAAE,IAAI,CAAC,kBAAkB,CAAC;IAE7C;;OAEG;IACH,YAAY,CAAC,EAAE,MAAM,CAAC;IAEtB;;OAEG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;IAEpB;;OAEG;IACH,kBAAkB,CAAC,EAAE,MAAM,CAAC;CAC7B"}

package/dist/types/ui/RelativeTime/utils/constants.d.ts

@@ -0,0 +1,6 @@
+export declare const MINUTE_IN_SECONDS = 60;
+export declare const HOUR_IN_SECONDS: number;
+export declare const DAY_IN_SECONDS: number;
+export declare const MONTH_IN_SECONDS: number;
+export declare const YEAR_IN_SECONDS: number;
+//# sourceMappingURL=constants.d.ts.map

package/dist/types/ui/RelativeTime/utils/constants.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../../../../../src/ui/RelativeTime/utils/constants.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,iBAAiB,KAAK,CAAC;AACpC,eAAO,MAAM,eAAe,QAAyB,CAAC;AACtD,eAAO,MAAM,cAAc,QAAuB,CAAC;AACnD,eAAO,MAAM,gBAAgB,QAAsB,CAAC;AACpD,eAAO,MAAM,eAAe,QAAuB,CAAC"}

package/dist/types/ui/RelativeTime/utils/formatHumanTime.d.ts

@@ -0,0 +1,21 @@
+import { Temporal } from "@js-temporal/polyfill";
+type FormatterOptions = {
+    /** The threshold in seconds for considering the time as "now". */
+    nowThreshold: number;
+    /** The keyword to use for "now". */
+    nowKeyword: string;
+    /**
+     * The Intl.RelativeTimeFormat instance to use for formatting.
+     * @see https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Intl/RelativeTimeFormat
+     */
+    relativeTimeFormat: Intl.RelativeTimeFormat;
+};
+/**
+ * Formats a given instant as a human-readable time relative to the current time.
+ * @param instant The instant to format.
+ * @param options The options to use for formatting.
+ * @returns A human-readable relative time string
+ */
+declare function formatHumanTime(instant: Temporal.Instant, options: FormatterOptions): string;
+export default formatHumanTime;
+//# sourceMappingURL=formatHumanTime.d.ts.map

package/dist/types/ui/RelativeTime/utils/formatHumanTime.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"formatHumanTime.d.ts","sourceRoot":"","sources":["../../../../../src/ui/RelativeTime/utils/formatHumanTime.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AAEjD,KAAK,gBAAgB,GAAG;IACtB,kEAAkE;IAClE,YAAY,EAAE,MAAM,CAAC;IAErB,oCAAoC;IACpC,UAAU,EAAE,MAAM,CAAC;IAEnB;;;OAGG;IACH,kBAAkB,EAAE,IAAI,CAAC,kBAAkB,CAAC;CAC7C,CAAC;AAEF;;;;;GAKG;AACH,iBAAS,eAAe,CACtB,OAAO,EAAE,QAAQ,CAAC,OAAO,EACzB,OAAO,EAAE,gBAAgB,GACxB,MAAM,CAwCR;AAED,eAAe,eAAe,CAAC"}

package/dist/types/ui/RelativeTime/utils/getOptimalUpdateInterval.d.ts

@@ -0,0 +1,8 @@
+import { Temporal } from "@js-temporal/polyfill";
+/**
+ * Calcualte the optimal update interval for a given instant based on the time distance from now.
+ * @returns The optimal update interval in milliseconds.
+ */
+declare function getOptimalUpdateInterval(instant: Temporal.Instant): number;
+export default getOptimalUpdateInterval;
+//# sourceMappingURL=getOptimalUpdateInterval.d.ts.map

package/dist/types/ui/RelativeTime/utils/getOptimalUpdateInterval.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"getOptimalUpdateInterval.d.ts","sourceRoot":"","sources":["../../../../../src/ui/RelativeTime/utils/getOptimalUpdateInterval.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AAGjD;;;GAGG;AACH,iBAAS,wBAAwB,CAAC,OAAO,EAAE,QAAQ,CAAC,OAAO,GAAG,MAAM,CAkBnE;AAED,eAAe,wBAAwB,CAAC"}

package/dist/types/ui/RelativeTime/utils/index.d.ts

@@ -0,0 +1,4 @@
+export { default as formatHumanTime } from "./formatHumanTime.js";
+export { default as getOptimalUpdateInterval } from "./getOptimalUpdateInterval.js";
+export { default as parseInstant } from "./parseInstant.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/types/ui/RelativeTime/utils/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/ui/RelativeTime/utils/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,IAAI,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAClE,OAAO,EAAE,OAAO,IAAI,wBAAwB,EAAE,MAAM,+BAA+B,CAAC;AACpF,OAAO,EAAE,OAAO,IAAI,YAAY,EAAE,MAAM,mBAAmB,CAAC"}

package/dist/types/ui/RelativeTime/utils/parseInstant.d.ts

@@ -0,0 +1,9 @@
+import { Temporal } from "@js-temporal/polyfill";
+/**
+ * Parser for Temporal.Instant.
+ * @param time - instance, date or string to parse
+ * @throws Error if time is invalid
+ */
+declare function parseInstant(time: Temporal.Instant | Date | string): Temporal.Instant;
+export default parseInstant;
+//# sourceMappingURL=parseInstant.d.ts.map

package/dist/types/ui/RelativeTime/utils/parseInstant.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"parseInstant.d.ts","sourceRoot":"","sources":["../../../../../src/ui/RelativeTime/utils/parseInstant.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AAEjD;;;;GAIG;AACH,iBAAS,YAAY,CAAC,IAAI,EAAE,QAAQ,CAAC,OAAO,GAAG,IAAI,GAAG,MAAM,oBAc3D;AAED,eAAe,YAAY,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@canonical/react-ds-app-launchpad",
-  "version": "0.9.0-experimental.5",
+  "version": "0.9.0-experimental.6",
   "type": "module",
   "module": "dist/esm/index.js",
   "types": "dist/types/index.d.ts",
@@ -41,6 +41,7 @@
     "@canonical/storybook-config": "^0.9.0-experimental.5",
     "@canonical/styles": "^0.9.0-experimental.2",
     "@canonical/utils": "^0.9.0-experimental.4",
+    "@js-temporal/polyfill": "^0.4.4",
     "highlight.js": "^11.11.1",
     "react": "^19.0.0",
     "react-dom": "^19.0.0"
@@ -68,5 +69,5 @@
     "vite-tsconfig-paths": "^5.1.4",
     "vitest": "^2.1.8"
   },
-  "gitHead": "bc797d0c134200c372d31a8db89659caba2d6384"
+  "gitHead": "88907393fcb7f317006ac5198c849fd6ba0b8c0b"
 }