@sentropic/design-system-svelte 0.34.70 → 0.34.71

package/dist/timeRange.d.ts

@@ -0,0 +1,75 @@
+export type TimeRangeMode = "relative" | "absolute";
+export type TimeRange = {
+    mode: TimeRangeMode;
+    /** Present ONLY for relative ranges — the resolved preset token (e.g. "30m"). */
+    relative?: string;
+    /** Epoch ms, inclusive lower bound. Always <= `to`. */
+    from: number;
+    /** Epoch ms, inclusive upper bound. */
+    to: number;
+};
+export type TimeRangePreset = string | {
+    token: string;
+    label?: string;
+    durationMs?: number;
+};
+export declare const DEFAULT_TIME_RANGE_PRESETS: string[];
+/**
+ * Parses a preset token ("30m", "1h", "7d", "2w", ...) into a duration in ms.
+ * Returns null when the token doesn't match the locked grammar
+ * `^(\d+)(m|h|d|w)$`.
+ */
+export declare function parsePresetMs(token: string): number | null;
+/**
+ * Resolves a relative preset token to a concrete {@link TimeRange} anchored at
+ * `now`. `to` is clamped to `max` (if given) and `from` is clamped to `min`
+ * (if given). Returns null when the token doesn't parse OR when, after
+ * clamping, the window collapses (`from > to`) — the caller (the component)
+ * treats a null resolution as "disable this preset".
+ */
+export declare function resolveRelative(token: string, now: number, opts?: {
+    min?: number;
+    max?: number;
+}): TimeRange | null;
+export type AbsoluteSplit = {
+    fromDate: string;
+    fromTime: string;
+    toDate: string;
+    toTime: string;
+};
+/**
+ * Splits an epoch-ms `from`/`to` pair into local-timezone date/time parts, one
+ * pair per bound. Used to seed the Custom tab's calendar + time pickers +
+ * typed inputs from a concrete range (relative or absolute).
+ */
+export declare function splitAbsolute(from: number, to: number): AbsoluteSplit;
+export type AbsoluteDraft = {
+    fromDate?: string;
+    fromTime?: string;
+    toDate?: string;
+    toTime?: string;
+};
+/**
+ * Composes a staged Custom-tab draft into a concrete {from,to} epoch-ms pair.
+ * Returns null when the draft is incomplete, any part fails to parse, or the
+ * composed `from` is after `to` — the caller uses null to disable Apply and
+ * show an inline error.
+ */
+export declare function composeAbsolute(draft: AbsoluteDraft): {
+    from: number;
+    to: number;
+} | null;
+/**
+ * Human label for a preset token ("30m" -> "30 dernières minutes" / "Last 30
+ * minutes"). Falls back to the raw token when it doesn't match the grammar
+ * (e.g. a caller-provided custom token) so the UI never renders empty text.
+ */
+export declare function formatPresetLabel(token: string, locale?: string): string;
+/**
+ * Human label for the picker's trigger button: the preset label for a
+ * relative value, or a formatted date range for an absolute one — collapsing
+ * to a single date + "HH:mm–HH:mm" when both bounds fall on the same local
+ * calendar day.
+ */
+export declare function formatTriggerLabel(value: TimeRange, locale?: string): string;
+//# sourceMappingURL=timeRange.d.ts.map

package/dist/timeRange.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"timeRange.d.ts","sourceRoot":"","sources":["../src/lib/timeRange.ts"],"names":[],"mappings":"AAIA,MAAM,MAAM,aAAa,GAAG,UAAU,GAAG,UAAU,CAAC;AAEpD,MAAM,MAAM,SAAS,GAAG;IACtB,IAAI,EAAE,aAAa,CAAC;IACpB,iFAAiF;IACjF,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,uDAAuD;IACvD,IAAI,EAAE,MAAM,CAAC;IACb,uCAAuC;IACvC,EAAE,EAAE,MAAM,CAAC;CACZ,CAAC;AAEF,MAAM,MAAM,eAAe,GACvB,MAAM,GACN;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IAAC,UAAU,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC;AAE3D,eAAO,MAAM,0BAA0B,EAAE,MAAM,EAU9C,CAAC;AAYF;;;;GAIG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAQ1D;AAED;;;;;;GAMG;AACH,wBAAgB,eAAe,CAC7B,KAAK,EAAE,MAAM,EACb,GAAG,EAAE,MAAM,EACX,IAAI,CAAC,EAAE;IAAE,GAAG,CAAC,EAAE,MAAM,CAAC;IAAC,GAAG,CAAC,EAAE,MAAM,CAAA;CAAE,GACpC,SAAS,GAAG,IAAI,CAalB;AAgBD,MAAM,MAAM,aAAa,GAAG;IAC1B,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;CAChB,CAAC;AAEF;;;;GAIG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,GAAG,aAAa,CASrE;AAED,MAAM,MAAM,aAAa,GAAG;IAC1B,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB,CAAC;AAqBF;;;;;GAKG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,aAAa,GAAG;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,EAAE,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,CAOzF;AAuCD;;;;GAIG;AACH,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,SAAU,GAAG,MAAM,CAMzE;AAED;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,SAAS,EAAE,MAAM,SAAU,GAAG,MAAM,CA4B7E"}

package/dist/timeRange.js

@@ -0,0 +1,198 @@
+// TimeRangePicker — pure, framework-free helpers. Kept separate from the
+// component so the value contract (token grammar, resolution, formatting) is
+// unit-testable without mounting Svelte at all.
+export const DEFAULT_TIME_RANGE_PRESETS = [
+    "30m",
+    "1h",
+    "3h",
+    "6h",
+    "12h",
+    "24h",
+    "3d",
+    "7d",
+    "30d"
+];
+/** token grammar: <digits><unit>, unit in m|h|d|w. */
+const TOKEN_RE = /^(\d+)(m|h|d|w)$/;
+const UNIT_MS = {
+    m: 60_000,
+    h: 3_600_000,
+    d: 86_400_000,
+    w: 604_800_000
+};
+/**
+ * Parses a preset token ("30m", "1h", "7d", "2w", ...) into a duration in ms.
+ * Returns null when the token doesn't match the locked grammar
+ * `^(\d+)(m|h|d|w)$`.
+ */
+export function parsePresetMs(token) {
+    const match = TOKEN_RE.exec(token);
+    if (!match)
+        return null;
+    const amount = Number(match[1]);
+    const unit = match[2];
+    const unitMs = UNIT_MS[unit];
+    if (!unitMs)
+        return null;
+    return amount * unitMs;
+}
+/**
+ * Resolves a relative preset token to a concrete {@link TimeRange} anchored at
+ * `now`. `to` is clamped to `max` (if given) and `from` is clamped to `min`
+ * (if given). Returns null when the token doesn't parse OR when, after
+ * clamping, the window collapses (`from > to`) — the caller (the component)
+ * treats a null resolution as "disable this preset".
+ */
+export function resolveRelative(token, now, opts) {
+    const durationMs = parsePresetMs(token);
+    if (durationMs == null)
+        return null;
+    let to = now;
+    let from = now - durationMs;
+    if (opts?.max != null)
+        to = Math.min(to, opts.max);
+    if (opts?.min != null)
+        from = Math.max(from, opts.min);
+    if (from > to)
+        return null;
+    return { mode: "relative", relative: token, from, to };
+}
+function pad2(n) {
+    return String(n).padStart(2, "0");
+}
+/** Local-tz "YYYY-MM-DD" for a Date. */
+function toISODate(d) {
+    return `${d.getFullYear()}-${pad2(d.getMonth() + 1)}-${pad2(d.getDate())}`;
+}
+/** Local-tz "HH:mm" for a Date. */
+function toHHMM(d) {
+    return `${pad2(d.getHours())}:${pad2(d.getMinutes())}`;
+}
+/**
+ * Splits an epoch-ms `from`/`to` pair into local-timezone date/time parts, one
+ * pair per bound. Used to seed the Custom tab's calendar + time pickers +
+ * typed inputs from a concrete range (relative or absolute).
+ */
+export function splitAbsolute(from, to) {
+    const f = new Date(from);
+    const t = new Date(to);
+    return {
+        fromDate: toISODate(f),
+        fromTime: toHHMM(f),
+        toDate: toISODate(t),
+        toTime: toHHMM(t)
+    };
+}
+const DATE_RE = /^(\d{4})-(\d{2})-(\d{2})$/;
+const TIME_RE = /^(\d{1,2}):(\d{2})$/;
+function parseLocalDateTime(dateStr, timeStr) {
+    const dm = DATE_RE.exec(dateStr);
+    const tm = TIME_RE.exec(timeStr);
+    if (!dm || !tm)
+        return null;
+    const year = Number(dm[1]);
+    const month = Number(dm[2]);
+    const day = Number(dm[3]);
+    const hour = Number(tm[1]);
+    const minute = Number(tm[2]);
+    if (month < 1 || month > 12 || day < 1 || day > 31)
+        return null;
+    if (hour < 0 || hour > 23 || minute < 0 || minute > 59)
+        return null;
+    const d = new Date(year, month - 1, day, hour, minute, 0, 0);
+    const ms = d.getTime();
+    return Number.isNaN(ms) ? null : ms;
+}
+/**
+ * Composes a staged Custom-tab draft into a concrete {from,to} epoch-ms pair.
+ * Returns null when the draft is incomplete, any part fails to parse, or the
+ * composed `from` is after `to` — the caller uses null to disable Apply and
+ * show an inline error.
+ */
+export function composeAbsolute(draft) {
+    if (!draft.fromDate || !draft.fromTime || !draft.toDate || !draft.toTime)
+        return null;
+    const from = parseLocalDateTime(draft.fromDate, draft.fromTime);
+    const to = parseLocalDateTime(draft.toDate, draft.toTime);
+    if (from == null || to == null)
+        return null;
+    if (from > to)
+        return null;
+    return { from, to };
+}
+function isFrLocale(locale) {
+    return (locale ?? "fr-FR").toLowerCase().startsWith("fr");
+}
+const UNIT_META_FR = {
+    m: { singular: "minute", plural: "minutes", masculine: false },
+    h: { singular: "heure", plural: "heures", masculine: false },
+    d: { singular: "jour", plural: "jours", masculine: true },
+    w: { singular: "semaine", plural: "semaines", masculine: false }
+};
+const UNIT_META_EN = {
+    m: { singular: "minute", plural: "minutes", masculine: false },
+    h: { singular: "hour", plural: "hours", masculine: false },
+    d: { singular: "day", plural: "days", masculine: false },
+    w: { singular: "week", plural: "weeks", masculine: false }
+};
+function frPresetLabel(amount, unit) {
+    const meta = UNIT_META_FR[unit];
+    if (!meta)
+        return `${amount}${unit}`;
+    const unitLabel = amount === 1 ? meta.singular : meta.plural;
+    if (amount === 1) {
+        return `${meta.masculine ? "Dernier" : "Dernière"} ${unitLabel}`;
+    }
+    return `${amount} ${meta.masculine ? "derniers" : "dernières"} ${unitLabel}`;
+}
+function enPresetLabel(amount, unit) {
+    const meta = UNIT_META_EN[unit];
+    if (!meta)
+        return `Last ${amount}${unit}`;
+    if (amount === 1)
+        return `Last ${meta.singular}`;
+    return `Last ${amount} ${meta.plural}`;
+}
+/**
+ * Human label for a preset token ("30m" -> "30 dernières minutes" / "Last 30
+ * minutes"). Falls back to the raw token when it doesn't match the grammar
+ * (e.g. a caller-provided custom token) so the UI never renders empty text.
+ */
+export function formatPresetLabel(token, locale = "fr-FR") {
+    const match = TOKEN_RE.exec(token);
+    if (!match)
+        return token;
+    const amount = Number(match[1]);
+    const unit = match[2];
+    return isFrLocale(locale) ? frPresetLabel(amount, unit) : enPresetLabel(amount, unit);
+}
+/**
+ * Human label for the picker's trigger button: the preset label for a
+ * relative value, or a formatted date range for an absolute one — collapsing
+ * to a single date + "HH:mm–HH:mm" when both bounds fall on the same local
+ * calendar day.
+ */
+export function formatTriggerLabel(value, locale = "fr-FR") {
+    if (value.mode === "relative" && value.relative) {
+        return formatPresetLabel(value.relative, locale);
+    }
+    const from = new Date(value.from);
+    const to = new Date(value.to);
+    const dateFormatter = new Intl.DateTimeFormat(locale, {
+        day: "2-digit",
+        month: "2-digit",
+        year: "numeric"
+    });
+    const timeFormatter = new Intl.DateTimeFormat(locale, {
+        hour: "2-digit",
+        minute: "2-digit",
+        hour12: false
+    });
+    const sameDay = from.getFullYear() === to.getFullYear() &&
+        from.getMonth() === to.getMonth() &&
+        from.getDate() === to.getDate();
+    if (sameDay) {
+        return `${dateFormatter.format(from)} ${timeFormatter.format(from)}–${timeFormatter.format(to)}`;
+    }
+    return `${dateFormatter.format(from)} ${timeFormatter.format(from)} – ${dateFormatter.format(to)} ${timeFormatter.format(to)}`;
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@sentropic/design-system-svelte",
-  "version": "0.34.70",
+  "version": "0.34.71",
   "type": "module",
   "publishConfig": {
     "access": "public"