nucleus-core-ts 0.9.914 → 0.9.916

package/dist/.build-ok

@@ -1 +1 @@
-0.9.914
+0.9.916

package/dist/fe/components/ChatPanel/components/ChatPanel.js

@@ -46,11 +46,11 @@ export function ChatPanel(props) {
         }).then((res)=>res.json()).then((data)=>{
             if (data?.data) {
                 store.addMessage(data.data);
-                store.bumpConversationPreview(conversationId, data.data.content ?? 'Attachment', data.data.createdAt);
+                store.bumpConversationPreview(conversationId, data.data.content ?? say.attachmentPreview, data.data.createdAt);
             }
             store.setSending(false);
         }).catch(()=>{
-            store.setError('Failed to upload attachment');
+            store.setError(say.uploadFailed);
             store.setSending(false);
         });
     };
@@ -65,7 +65,7 @@ export function ChatPanel(props) {
                         children: [
                             /*#__PURE__*/ _jsx("span", {
                                 className: theme.sidebar.title,
-                                children: props.title ?? 'Messages'
+                                children: props.title ?? say.panelTitle
                             }),
                             (props.directory || props.onNewConversation) && /*#__PURE__*/ _jsx("button", {
                                 type: "button",
@@ -79,7 +79,7 @@ export function ChatPanel(props) {
                                     stroke: "currentColor",
                                     children: [
                                         /*#__PURE__*/ _jsx("title", {
-                                            children: "New"
+                                            children: say.newConversationIconTitle
                                         }),
                                         /*#__PURE__*/ _jsx("path", {
                                             strokeLinecap: "round",

package/dist/fe/components/ChatPanel/components/ConversationList.js

@@ -23,7 +23,7 @@ export function ConversationList({ conversations, activeId, currentUserId, isLoa
     return /*#__PURE__*/ _jsx("div", {
         className: theme.sidebar.list,
         children: conversations.map((conversation)=>{
-            const title = conversationTitle(conversation, currentUserId, resolveUserName);
+            const title = conversationTitle(conversation, currentUserId, say, resolveUserName);
             const unread = conversation.myParticipant?.unreadCount ?? conversation.unreadCount;
             const otherId = otherParticipantId(conversation, currentUserId);
             const avatarUrl = conversation.avatarUrl ?? (otherId ? resolveUserAvatar?.(otherId) : undefined);
@@ -52,7 +52,7 @@ export function ConversationList({ conversations, activeId, currentUserId, isLoa
                                     }),
                                     /*#__PURE__*/ _jsx("span", {
                                         className: theme.conversation.time,
-                                        children: formatRelativeTime(conversation.lastMessageAt)
+                                        children: formatRelativeTime(conversation.lastMessageAt, say)
                                     })
                                 ]
                             }),
@@ -61,7 +61,7 @@ export function ConversationList({ conversations, activeId, currentUserId, isLoa
                                 children: [
                                     /*#__PURE__*/ _jsx("span", {
                                         className: theme.conversation.preview,
-                                        children: conversation.lastMessagePreview || 'No messages yet'
+                                        children: conversation.lastMessagePreview || say.noMessagesPreview
                                     }),
                                     unread > 0 && /*#__PURE__*/ _jsx("span", {
                                         className: theme.conversation.badge,

package/dist/fe/components/ChatPanel/components/MessageComposer.js

@@ -103,7 +103,7 @@ export function MessageComposer({ theme, value, disabled, uploadEnabled, onChang
                         className: theme.composer.sendButton,
                         disabled: !canSend,
                         onClick: submit,
-                        children: "Send"
+                        children: say.send
                     })
                 ]
             })

package/dist/fe/components/ChatPanel/components/MessageThread.js

@@ -4,20 +4,20 @@ import { useEffect, useRef } from 'react';
 import { cn } from '../../../utils/cn';
 import { conversationTitle, formatClockTime } from '../helpers';
 import { DEFAULT_CHAT_LABELS } from '../labels';
-function Attachments({ message, theme }) {
+function Attachments({ message, theme, say }) {
     if (message.attachments.length === 0) return null;
     return /*#__PURE__*/ _jsx("span", {
         className: theme.attachment.grid,
         children: message.attachments.map((attachment)=>attachment.kind === 'image' ? /*#__PURE__*/ _jsx("img", {
                 src: attachment.url,
-                alt: attachment.originalName ?? 'image',
+                alt: attachment.originalName ?? say.imageAttachment,
                 className: theme.attachment.image
             }, attachment.id) : /*#__PURE__*/ _jsx("a", {
                 href: attachment.url,
                 target: "_blank",
                 rel: "noreferrer",
                 className: theme.attachment.file,
-                children: attachment.originalName ?? 'Download file'
+                children: attachment.originalName ?? say.downloadFile
             }, attachment.id))
     });
 }
@@ -40,16 +40,19 @@ export function MessageThread({ conversation, messages, currentUserId, typing, h
             children: say.selectConversation
         });
     }
-    const title = conversationTitle(conversation, currentUserId, resolveUserName);
+    const title = conversationTitle(conversation, currentUserId, say, resolveUserName);
     const activeParticipants = conversation.participants.filter((p)=>!p.leftAt);
-    const subtitle = conversation.type === 'group' ? `${activeParticipants.length} participants` : undefined;
+    const subtitle = conversation.type === 'group' ? say.participantCount(activeParticipants.length) : undefined;
     const otherReaders = conversation.participants.filter((p)=>p.userId !== currentUserId && !p.leftAt);
     const isReadByOthers = (message)=>{
         const created = Date.parse(message.createdAt);
         return otherReaders.some((p)=>p.lastReadAt != null && Date.parse(p.lastReadAt) >= created);
     };
     const typingUsers = typing.filter((t)=>t.conversationId === conversation.id && Date.now() - t.at < 6000);
-    const typingLabel = typingUsers.length === 1 ? `${resolveUserName?.(typingUsers[0]?.userId ?? '') ?? 'Someone'} is typing` : 'Several people are typing';
+    // The whole sentence comes from one label, ellipsis included. Building it as
+    // `${name} is typing` + '...' would leave "is typing" untranslatable, and in
+    // Turkish the verb goes after the name anyway.
+    const typingLabel = typingUsers.length === 1 ? say.typingOne(resolveUserName?.(typingUsers[0]?.userId ?? '') ?? say.someone) : say.typingMany;
     return /*#__PURE__*/ _jsxs("div", {
         className: theme.thread.base,
         children: [
@@ -76,7 +79,7 @@ export function MessageThread({ conversation, messages, currentUserId, typing, h
                         type: "button",
                         className: theme.thread.loadMore,
                         onClick: onLoadOlder,
-                        children: isLoading ? 'Loading...' : 'Load earlier messages'
+                        children: isLoading ? say.loadingMessages : say.loadEarlier
                     }),
                     messages.length === 0 && !isLoading ? /*#__PURE__*/ _jsx("div", {
                         className: theme.thread.empty,
@@ -90,7 +93,7 @@ export function MessageThread({ conversation, messages, currentUserId, typing, h
                                 children: [
                                     conversation.type === 'group' && !own && message.senderId && /*#__PURE__*/ _jsx("div", {
                                         className: theme.message.sender,
-                                        children: resolveUserName?.(message.senderId) ?? 'User'
+                                        children: resolveUserName?.(message.senderId) ?? say.unknownSender
                                     }),
                                     message.deletedAt ? /*#__PURE__*/ _jsx("span", {
                                         className: theme.message.deleted,
@@ -102,7 +105,8 @@ export function MessageThread({ conversation, messages, currentUserId, typing, h
                                             }),
                                             /*#__PURE__*/ _jsx(Attachments, {
                                                 message: message,
-                                                theme: theme
+                                                theme: theme,
+                                                say: say
                                             })
                                         ]
                                     }),
@@ -110,15 +114,15 @@ export function MessageThread({ conversation, messages, currentUserId, typing, h
                                         className: theme.message.meta,
                                         children: [
                                             /*#__PURE__*/ _jsx("span", {
-                                                children: formatClockTime(message.createdAt)
+                                                children: formatClockTime(message.createdAt, say)
                                             }),
                                             message.editedAt && /*#__PURE__*/ _jsx("span", {
                                                 className: theme.message.edited,
-                                                children: "· edited"
+                                                children: say.edited
                                             }),
                                             own && !message.deletedAt && /*#__PURE__*/ _jsx("span", {
                                                 className: cn(theme.message.receipt, isReadByOthers(message) && theme.message.receiptRead),
-                                                title: isReadByOthers(message) ? 'Görüldü' : 'Gönderildi',
+                                                title: isReadByOthers(message) ? say.receiptRead : say.receiptSent,
                                                 children: isReadByOthers(message) ? '✓✓' : '✓'
                                             })
                                         ]
@@ -129,12 +133,9 @@ export function MessageThread({ conversation, messages, currentUserId, typing, h
                     })
                 ]
             }),
-            typingUsers.length > 0 && /*#__PURE__*/ _jsxs("div", {
+            typingUsers.length > 0 && /*#__PURE__*/ _jsx("div", {
                 className: theme.typing,
-                children: [
-                    typingLabel,
-                    "..."
-                ]
+                children: typingLabel
             })
         ]
     });

package/dist/fe/components/ChatPanel/helpers.d.ts

@@ -1,6 +1,26 @@
+import type { ChatPanelLabels } from './labels';
 import type { ChatConversationDTO } from './types';
 export declare function otherParticipantId(conversation: ChatConversationDTO, currentUserId: string): string | null;
-export declare function conversationTitle(conversation: ChatConversationDTO, currentUserId: string, resolveUserName?: (userId: string) => string | undefined): string;
+export declare function conversationTitle(conversation: ChatConversationDTO, currentUserId: string, labels: ChatPanelLabels, resolveUserName?: (userId: string) => string | undefined): string;
 export declare function initialsOf(name: string): string;
-export declare function formatRelativeTime(iso: string | null): string;
-export declare function formatClockTime(iso: string): string;
+/**
+ * The age of a message, in the panel's own words.
+ *
+ * The units used to be English letters written into the source (`5m`, `3h`,
+ * `2d`), which no installation could change, and the fallback past a week was a
+ * bare `toLocaleDateString()` — no locale, so the string came out in the
+ * SERVER's locale during the server render and the BROWSER's after hydration.
+ * The same row rendered twice, differently, and React tore. Both halves now
+ * come from the labels: the units as functions of the number, the date under
+ * the named `locale`.
+ */
+export declare function formatRelativeTime(iso: string | null, labels: ChatPanelLabels): string;
+/**
+ * The clock beneath a message.
+ *
+ * `hour12` is pinned as well as the locale: left to the environment, a locale
+ * that prints "2:32 PM" on one machine prints "14:32" on the other, which is
+ * the same hydration tear by a different route. A 24-hour clock is the one both
+ * ends can agree on without asking anybody.
+ */
+export declare function formatClockTime(iso: string, labels: ChatPanelLabels): string;

package/dist/fe/components/ChatPanel/helpers.js

@@ -3,33 +3,51 @@ export function otherParticipantId(conversation, currentUserId) {
     const other = conversation.participants.find((p)=>p.userId !== currentUserId);
     return other?.userId ?? null;
 }
-export function conversationTitle(conversation, currentUserId, resolveUserName) {
-    if (conversation.type === 'group') return conversation.title || 'Group chat';
+export function conversationTitle(conversation, currentUserId, labels, resolveUserName) {
+    if (conversation.type === 'group') return conversation.title || labels.groupChat;
     const otherId = otherParticipantId(conversation, currentUserId);
-    if (otherId) return resolveUserName?.(otherId) || 'Direct message';
-    return conversation.title || 'Direct message';
+    if (otherId) return resolveUserName?.(otherId) || labels.directMessage;
+    return conversation.title || labels.directMessage;
 }
 export function initialsOf(name) {
     const parts = name.trim().split(/\s+/).slice(0, 2);
     const initials = parts.map((p)=>p[0]?.toUpperCase() ?? '').join('');
     return initials || '?';
 }
-export function formatRelativeTime(iso) {
+/**
+ * The age of a message, in the panel's own words.
+ *
+ * The units used to be English letters written into the source (`5m`, `3h`,
+ * `2d`), which no installation could change, and the fallback past a week was a
+ * bare `toLocaleDateString()` — no locale, so the string came out in the
+ * SERVER's locale during the server render and the BROWSER's after hydration.
+ * The same row rendered twice, differently, and React tore. Both halves now
+ * come from the labels: the units as functions of the number, the date under
+ * the named `locale`.
+ */ export function formatRelativeTime(iso, labels) {
     if (!iso) return '';
     const date = new Date(iso);
     const diffMs = Date.now() - date.getTime();
     const mins = Math.floor(diffMs / 60000);
     const hours = Math.floor(diffMs / 3600000);
     const days = Math.floor(diffMs / 86400000);
-    if (mins < 1) return 'now';
-    if (mins < 60) return `${mins}m`;
-    if (hours < 24) return `${hours}h`;
-    if (days < 7) return `${days}d`;
-    return date.toLocaleDateString();
+    if (mins < 1) return labels.justNow;
+    if (mins < 60) return labels.minutesAgo(mins);
+    if (hours < 24) return labels.hoursAgo(hours);
+    if (days < 7) return labels.daysAgo(days);
+    return date.toLocaleDateString(labels.locale);
 }
-export function formatClockTime(iso) {
-    return new Date(iso).toLocaleTimeString([], {
+/**
+ * The clock beneath a message.
+ *
+ * `hour12` is pinned as well as the locale: left to the environment, a locale
+ * that prints "2:32 PM" on one machine prints "14:32" on the other, which is
+ * the same hydration tear by a different route. A 24-hour clock is the one both
+ * ends can agree on without asking anybody.
+ */ export function formatClockTime(iso, labels) {
+    return new Date(iso).toLocaleTimeString(labels.locale, {
         hour: '2-digit',
-        minute: '2-digit'
+        minute: '2-digit',
+        hour12: false
     });
 }

package/dist/fe/components/ChatPanel/hooks/useChat.js

@@ -1,23 +1,28 @@
 'use client';
 import { useEffect, useEffectEvent, useRef } from 'react';
 import { usePubSub } from '../../../../src/Client/PubSub';
+import { DEFAULT_CHAT_LABELS } from '../labels';
 import { useChatStore } from '../store';
 const TYPING_THROTTLE_MS = 2500;
-function errMsg(error) {
-    return error instanceof Error ? error.message : 'Something went wrong';
+function errMsg(error, fallback) {
+    return error instanceof Error ? error.message : fallback;
 }
-function previewFor(message) {
+function previewFor(message, say) {
     if (message.content?.trim()) {
         const trimmed = message.content.trim();
         return trimmed.length > 120 ? `${trimmed.slice(0, 117)}...` : trimmed;
     }
     if (message.attachments.length > 0) {
-        return message.attachments.length > 1 ? `${message.attachments.length} attachments` : 'Attachment';
+        return message.attachments.length > 1 ? say.attachmentsPreview(message.attachments.length) : say.attachmentPreview;
     }
     return '';
 }
 export function useChat(props) {
     const { currentUserId, actions, topic = 'chat', wsUrl, wsPath } = props;
+    const say = {
+        ...DEFAULT_CHAT_LABELS,
+        ...props.labels
+    };
     const store = useChatStore();
     const lastSeenEventIdRef = useRef(null);
     const eventsInitializedRef = useRef(false);
@@ -43,7 +48,7 @@ export function useChat(props) {
                 store.setLoadingConversations(false);
             },
             onErrorHandle: (error)=>{
-                store.setError(errMsg(error));
+                store.setError(errMsg(error, say.genericError));
                 store.setLoadingConversations(false);
             }
         });
@@ -89,7 +94,7 @@ export function useChat(props) {
                 markReadNow(conversationId);
             },
             onErrorHandle: (error)=>{
-                store.setError(errMsg(error));
+                store.setError(errMsg(error, say.genericError));
                 store.setLoadingMessages(false);
             }
         });
@@ -151,12 +156,12 @@ export function useChat(props) {
             onAfterHandle: (data)=>{
                 if (data?.data) {
                     store.addMessage(data.data);
-                    store.bumpConversationPreview(active, previewFor(data.data), data.data.createdAt);
+                    store.bumpConversationPreview(active, previewFor(data.data, say), data.data.createdAt);
                 }
                 store.setSending(false);
             },
             onErrorHandle: (error)=>{
-                store.setError(errMsg(error));
+                store.setError(errMsg(error, say.genericError));
                 store.setSending(false);
             }
         });
@@ -188,7 +193,7 @@ export function useChat(props) {
                     openConversation(data.data.id);
                 }
             },
-            onErrorHandle: (error)=>store.setError(errMsg(error))
+            onErrorHandle: (error)=>store.setError(errMsg(error, say.genericError))
         });
     });
     const createGroup = useEffectEvent((title, participantIds)=>{
@@ -204,7 +209,7 @@ export function useChat(props) {
                     openConversation(data.data.id);
                 }
             },
-            onErrorHandle: (error)=>store.setError(errMsg(error))
+            onErrorHandle: (error)=>store.setError(errMsg(error, say.genericError))
         });
     });
     const handleRealtime = useEffectEvent((payload)=>{
@@ -215,7 +220,7 @@ export function useChat(props) {
                     const message = payload.message;
                     const conversationId = payload.conversationId;
                     if (!message || !conversationId) return;
-                    store.bumpConversationPreview(conversationId, previewFor(message), message.createdAt);
+                    store.bumpConversationPreview(conversationId, previewFor(message, say), message.createdAt);
                     store.clearTyping(conversationId, message.senderId ?? '');
                     if (conversationId === active) {
                         store.addMessage(message);

package/dist/fe/components/ChatPanel/labels.d.ts

@@ -9,6 +9,11 @@
  * each other.
  *
  * Defaults stay English, so nothing that does not pass labels changes.
+ *
+ * Anything that interpolates a value is a FUNCTION of that value, never a
+ * translated fragment glued to an untranslated one: "3 participants" is
+ * "3 katılımcı" in Turkish but "typing" moves to the end of its sentence, and
+ * a concatenation would produce a sentence in neither language.
  */
 export type ChatPanelLabels = {
     /** While the conversation list is still arriving. */
@@ -36,5 +41,69 @@ export type ChatPanelLabels = {
     newMessageTitle: string;
     searchPeople: string;
     noPeopleFound: string;
+    /** The sidebar heading, when the consumer passes no `title` prop. */
+    panelTitle: string;
+    /** The accessible name of the plus icon inside the "new conversation" button. */
+    newConversationIconTitle: string;
+    /** The send button. */
+    send: string;
+    /** A conversation row whose last message does not exist yet. */
+    noMessagesPreview: string;
+    /** A group with no title of its own. */
+    groupChat: string;
+    /** A one-to-one conversation whose other person cannot be named. */
+    directMessage: string;
+    /** A sender whose name the host could not resolve. */
+    unknownSender: string;
+    /** The group thread's subtitle. */
+    participantCount: (count: number) => string;
+    /** The load-older button, while the page is in flight. */
+    loadingMessages: string;
+    /** The load-older button, at rest. */
+    loadEarlier: string;
+    /** One named person is typing. Carries its own trailing ellipsis. */
+    typingOne: (name: string) => string;
+    /** More than one person is typing. Carries its own trailing ellipsis. */
+    typingMany: string;
+    /** Stands in for a typist whose name the host could not resolve. */
+    someone: string;
+    /** Marks a message its sender changed after sending. */
+    edited: string;
+    /** The delivery tick's tooltip, once somebody else has read the message. */
+    receiptRead: string;
+    /** The delivery tick's tooltip, before anybody has read it. */
+    receiptSent: string;
+    /** Alt text for an image attachment that arrived without a file name. */
+    imageAttachment: string;
+    /** The link on a non-image attachment that arrived without a file name. */
+    downloadFile: string;
+    /** A conversation row previewing a message that is only a file. */
+    attachmentPreview: string;
+    /** A conversation row previewing a message that is only files. */
+    attachmentsPreview: (count: number) => string;
+    /** Shown when an attachment upload fails. */
+    uploadFailed: string;
+    /** Shown when a request fails without saying why. */
+    genericError: string;
+    /**
+     * The relative stamps on conversation rows. Kept short on purpose — they sit
+     * in a column beside a name that must not be pushed out of the row.
+     */
+    justNow: string;
+    minutesAgo: (minutes: number) => string;
+    hoursAgo: (hours: number) => string;
+    daysAgo: (days: number) => string;
+    /**
+     * The BCP-47 tag the panel formats dates and clock times with.
+     *
+     * It is a label rather than a guess because the guess tore: calling
+     * `toLocaleDateString()` with no argument reads the SERVER's locale while the
+     * page renders on the server and the BROWSER's once React takes over, so one
+     * message produced two different strings and hydration mismatched. Naming the
+     * locale makes both passes agree. Clock times are additionally forced to
+     * `hour12: false` for the same reason — whether a locale prints "14:32" or
+     * "2:32 PM" must not depend on which machine did the printing.
+     */
+    locale: string;
 };
 export declare const DEFAULT_CHAT_LABELS: ChatPanelLabels;

package/dist/fe/components/ChatPanel/labels.js

@@ -9,6 +9,11 @@
  * each other.
  *
  * Defaults stay English, so nothing that does not pass labels changes.
+ *
+ * Anything that interpolates a value is a FUNCTION of that value, never a
+ * translated fragment glued to an untranslated one: "3 participants" is
+ * "3 katılımcı" in Turkish but "typing" moves to the end of its sentence, and
+ * a concatenation would produce a sentence in neither language.
  */ export const DEFAULT_CHAT_LABELS = {
     loadingConversations: 'Loading conversations...',
     noConversations: 'No conversations yet',
@@ -23,5 +28,32 @@
     close: 'Close',
     newMessageTitle: 'New message',
     searchPeople: 'Search people...',
-    noPeopleFound: 'No people found'
+    noPeopleFound: 'No people found',
+    panelTitle: 'Messages',
+    newConversationIconTitle: 'New',
+    send: 'Send',
+    noMessagesPreview: 'No messages yet',
+    groupChat: 'Group chat',
+    directMessage: 'Direct message',
+    unknownSender: 'User',
+    participantCount: (count)=>`${count} participants`,
+    loadingMessages: 'Loading...',
+    loadEarlier: 'Load earlier messages',
+    typingOne: (name)=>`${name} is typing...`,
+    typingMany: 'Several people are typing...',
+    someone: 'Someone',
+    edited: '· edited',
+    receiptRead: 'Read',
+    receiptSent: 'Sent',
+    imageAttachment: 'Image',
+    downloadFile: 'Download file',
+    attachmentPreview: 'Attachment',
+    attachmentsPreview: (count)=>`${count} attachments`,
+    uploadFailed: 'Failed to upload attachment',
+    genericError: 'Something went wrong',
+    justNow: 'now',
+    minutesAgo: (minutes)=>`${minutes}m`,
+    hoursAgo: (hours)=>`${hours}h`,
+    daysAgo: (days)=>`${days}d`,
+    locale: 'en-US'
 };

package/dist/fe/components/IntegrationsPage/components/MappingScheduleFields.js

@@ -1,9 +1,10 @@
 'use client';
 import { jsx as _jsx, jsxs as _jsxs, Fragment as _Fragment } from "react/jsx-runtime";
-import { useId } from 'react';
+import { useEffect, useId, useState } from 'react';
 import { describeCron, parseCron } from '../../../../src/Shared/cron';
 import { useLabels } from '../text/context';
 import { integrationsPageTheme } from '../theme';
+import { describeNextRuns } from './nextRuns';
 import { Field, Notice, Section } from './Primitives';
 /**
  * Running this import without anybody clicking anything.
@@ -131,6 +132,10 @@ export function MappingScheduleFields({ enabled, cron, timezone, needsPassword,
                             children: preset.label
                         }, preset.cron))
                 }),
+                cron.trim() !== '' ? /*#__PURE__*/ _jsx(NextRunsList, {
+                    cron: cron,
+                    timezone: timezone
+                }) : null,
                 needsPassword ? /*#__PURE__*/ _jsx(Notice, {
                     title: t.cannotRunTitle,
                     tone: "warning",
@@ -147,3 +152,51 @@ export function MappingScheduleFields({ enabled, cron, timezone, needsPassword,
         })
     });
 }
+/** The next few firings, listed. Its own component so it can hold the clock. */ function NextRunsList({ cron, timezone }) {
+    const labels = useLabels();
+    /*
+   * The clock is read after mount, never during render.
+   *
+   * "From now" on the server and "from now" in the browser are different
+   * instants, so rendering this straight away would produce two different
+   * lists for one page and tear on hydration.
+   */ const [from, setFrom] = useState(null);
+    useEffect(()=>setFrom(new Date()), [
+        cron,
+        timezone
+    ]);
+    if (!from) return null;
+    const { runs, error } = describeNextRuns({
+        expression: cron,
+        timeZone: timezone,
+        from,
+        count: 5
+    });
+    if (error) {
+        return /*#__PURE__*/ _jsx(Notice, {
+            title: labels.schedulePreview.badTitle,
+            tone: "warning",
+            children: error
+        });
+    }
+    if (runs.length === 0) return /*#__PURE__*/ _jsx("p", {
+        className: theme.field.hint,
+        children: labels.schedulePreview.none
+    });
+    return /*#__PURE__*/ _jsxs("div", {
+        className: "flex flex-col gap-1",
+        children: [
+            /*#__PURE__*/ _jsx("p", {
+                className: theme.field.label,
+                children: labels.schedulePreview.title
+            }),
+            /*#__PURE__*/ _jsx("ul", {
+                className: "flex flex-col gap-0.5",
+                children: runs.map((run)=>/*#__PURE__*/ _jsx("li", {
+                        className: theme.field.hint,
+                        children: run.label
+                    }, run.iso))
+            })
+        ]
+    });
+}

package/dist/fe/components/IntegrationsPage/components/nextRuns.d.ts

@@ -0,0 +1,29 @@
+/**
+ * The next few moments this schedule will actually fire, written out.
+ *
+ * A cron expression is a promise about a time nobody is awake for, and it is
+ * checked by reading it — which is exactly how "0 2 * * *" and "2 0 * * *"
+ * survive review. Worse, the hour is in a timezone that is written in another
+ * box: an expression that reads correctly can still fire at four in the
+ * afternoon because the zone beside it says UTC and the company is in Istanbul.
+ *
+ * None of that is visible until the night it does not happen, and by then the
+ * operator is asleep. Printing the real firings turns the expression back into
+ * something a person can compare against what they meant.
+ *
+ * The times come from the SAME function the scheduler uses, so this cannot
+ * flatter an expression the scheduler would read differently.
+ */
+export type NextRun = {
+    iso: string;
+    label: string;
+};
+export declare function describeNextRuns(input: {
+    expression: string;
+    timeZone?: string | null;
+    from: Date;
+    count?: number;
+}): {
+    runs: NextRun[];
+    error?: string;
+};

package/dist/fe/components/IntegrationsPage/components/nextRuns.js

@@ -0,0 +1,50 @@
+import { nextFireTimes } from '../../../../src/Shared/cron';
+/**
+ * A fixed, unambiguous format rather than the reader's locale.
+ *
+ * `toLocaleString()` here would render the server's locale on the server and
+ * the browser's on the client — two different strings for one row, and a
+ * hydration tear. It would also print 8/5/2026, which in Turkey reads as the
+ * 8th of May. Year-first with the zone spelled out cannot be misread in either
+ * direction.
+ */ function partsIn(when, timeZone) {
+    const parts = new Intl.DateTimeFormat('en-CA', {
+        timeZone,
+        year: 'numeric',
+        month: '2-digit',
+        day: '2-digit',
+        hour: '2-digit',
+        minute: '2-digit',
+        weekday: 'short',
+        hour12: false
+    }).formatToParts(when);
+    const out = {};
+    for (const part of parts)out[part.type] = part.value;
+    return out;
+}
+export function describeNextRuns(input) {
+    const zone = input.timeZone?.trim() || 'UTC';
+    const { times, error } = nextFireTimes({
+        expression: input.expression,
+        timeZone: zone,
+        from: input.from,
+        count: input.count ?? 5
+    });
+    if (error) return {
+        runs: [],
+        error
+    };
+    const runs = times.map((when)=>{
+        // `nextFireTimes` has already refused an unusable zone, so this cannot
+        // throw here — and if it ever did, printing confident times the scheduler
+        // will not honour would be worse than the crash.
+        const at = partsIn(when, zone);
+        return {
+            iso: when.toISOString(),
+            label: `${at.year}-${at.month}-${at.day} ${at.weekday} ${at.hour}:${at.minute} (${zone})`
+        };
+    });
+    return {
+        runs
+    };
+}