@runtypelabs/persona 4.17.1 → 4.18.0

package/src/components/history-shell-copy.ts

@@ -0,0 +1,99 @@
+/**
+ * History copy the SHELL renders outside the lazy Messages chunk: the header
+ * button, the destructive confirmations, the "show earlier messages" pill, and
+ * the reset notices.
+ *
+ * Lives in core so a control can be labelled before the chunk loads. The chunk
+ * spreads these defaults into its own resolved table, so every key still has
+ * exactly one default. `AgentWidgetHistoryCopy` (types.ts) stays the single
+ * authoritative host-facing type.
+ *
+ * House style: sentence case, no em-dashes, no all-caps.
+ */
+
+import type { AgentWidgetHistoryCopy } from "../types";
+
+const SHELL_COPY_KEYS = [
+  "viewTitle",
+  "openHistoryLabel",
+  "openHistoryBusyLabel",
+  "newConversationLabel",
+  // The rail toggle's pair: the shell renders the overlay trigger before the
+  // chunk loads, and relabels the view's toggle while the rail floats.
+  "expandLabel",
+  "collapseLabel",
+  // The rail's resize handle is shell chrome, not part of the view.
+  "resizeLabel",
+  "showEarlierMessagesLabel",
+  "openConversationLoadingLabel",
+  "openConversationErrorTitle",
+  "openConversationRetryLabel",
+  "openConversationBackLabel",
+  "confirmCancelLabel",
+  "deleteConversationConfirmTitle",
+  "deleteConversationConfirm",
+  "deleteConversationConfirmLabel",
+  "clearHistoryConfirmTitle",
+  "clearHistoryConfirm",
+  "clearHistoryVerifiedConfirm",
+  "clearHistoryConfirmLabel",
+  "resetIdentityConfirmTitle",
+  "resetIdentityConfirm",
+  "resetIdentityConfirmLabel",
+  "conversationDeletedNotice",
+  "identityResetNotice",
+  "identityResetUnconfirmedNotice",
+] as const;
+
+export type HistoryShellCopyKey = (typeof SHELL_COPY_KEYS)[number];
+
+export type ResolvedHistoryShellCopy = Required<
+  Pick<AgentWidgetHistoryCopy, HistoryShellCopyKey>
+>;
+
+export const HISTORY_SHELL_COPY_DEFAULTS: ResolvedHistoryShellCopy = {
+  viewTitle: "Messages",
+  openHistoryLabel: "Messages",
+  openHistoryBusyLabel: "Messages, available once the reply finishes",
+  newConversationLabel: "New conversation",
+  expandLabel: "Expand conversation list",
+  collapseLabel: "Collapse conversation list",
+  resizeLabel: "Resize conversation list",
+  showEarlierMessagesLabel: "Show earlier messages",
+  openConversationLoadingLabel: "Loading conversation",
+  openConversationErrorTitle: "Could not open the conversation.",
+  openConversationRetryLabel: "Try again",
+  openConversationBackLabel: "Back to messages",
+  confirmCancelLabel: "Cancel",
+  deleteConversationConfirmTitle: "Delete conversation",
+  deleteConversationConfirm: "Delete this conversation? This cannot be undone.",
+  deleteConversationConfirmLabel: "Delete",
+  clearHistoryConfirmTitle: "Delete all conversations",
+  clearHistoryConfirm:
+    "Delete all conversations for this assistant on this browser? This cannot be undone.",
+  clearHistoryVerifiedConfirm:
+    "Delete all conversations for this assistant and signed-in user? This cannot be undone.",
+  clearHistoryConfirmLabel: "Delete all",
+  resetIdentityConfirmTitle: "Forget this device",
+  resetIdentityConfirm:
+    "Forget this device? All Persona data stored in this browser is cleared. Records are not deleted elsewhere.",
+  resetIdentityConfirmLabel: "Forget this device",
+  conversationDeletedNotice:
+    "That conversation was deleted. You are now in a new conversation.",
+  identityResetNotice: "This device was forgotten.",
+  identityResetUnconfirmedNotice:
+    "This device was cleared here, but the server could not confirm it.",
+};
+
+/** Empty-string overrides are ignored so a control never loses its label. */
+export function resolveHistoryShellCopy(
+  copy: AgentWidgetHistoryCopy | undefined
+): ResolvedHistoryShellCopy {
+  if (!copy) return HISTORY_SHELL_COPY_DEFAULTS;
+  const resolved = { ...HISTORY_SHELL_COPY_DEFAULTS };
+  for (const key of SHELL_COPY_KEYS) {
+    const value = copy[key];
+    if (typeof value === "string" && value.length > 0) resolved[key] = value;
+  }
+  return resolved;
+}

package/src/components/history-view/announcer.ts

@@ -0,0 +1,40 @@
+/**
+ * Polite live region owned by the view (loading, deletion, rate limit, removal,
+ * identity changes). Chunk-local rather than `utils/live-region.ts` because that
+ * helper depends on `widget.css`'s sr-only class and hosts on `document.body`
+ * under Shadow DOM; this one is self-contained and lives inside the view root.
+ */
+
+export interface HistoryAnnouncer {
+  element: HTMLElement;
+  announce(message: string): void;
+  destroy(): void;
+}
+
+export function createHistoryAnnouncer(): HistoryAnnouncer {
+  const element = document.createElement("div");
+  element.className = "persona-history-sr-only";
+  element.setAttribute("role", "status");
+  element.setAttribute("aria-live", "polite");
+  element.setAttribute("aria-atomic", "true");
+  element.setAttribute("data-persona-history-live-region", "");
+
+  // Clear and set must land in separate tasks or an identical repeat is silent.
+  let pending: ReturnType<typeof setTimeout> | undefined;
+
+  return {
+    element,
+    announce(message: string) {
+      if (pending !== undefined) clearTimeout(pending);
+      element.textContent = "";
+      pending = setTimeout(() => {
+        pending = undefined;
+        element.textContent = message;
+      }, 0);
+    },
+    destroy() {
+      if (pending !== undefined) clearTimeout(pending);
+      element.remove();
+    },
+  };
+}

package/src/components/history-view/copy.ts

@@ -0,0 +1,105 @@
+/**
+ * Resolved copy for the history ("Messages") view.
+ *
+ * `AgentWidgetHistoryCopy` (types.ts) is the single authoritative
+ * host-overridable type; the defaults live here, in the chunk. The handful of
+ * strings the shell must render before this chunk loads come from
+ * `components/history-shell-copy.ts` so each key still has one default.
+ *
+ * House style: sentence case, no em-dashes, no all-caps.
+ */
+
+import type { AgentWidgetHistoryCopy } from "../../types";
+import { HISTORY_SHELL_COPY_DEFAULTS } from "../history-shell-copy";
+
+export type HistoryViewCopyInput = AgentWidgetHistoryCopy;
+
+export type ResolvedHistoryViewCopy = Required<AgentWidgetHistoryCopy>;
+
+export const HISTORY_VIEW_COPY_DEFAULTS: ResolvedHistoryViewCopy = {
+  ...HISTORY_SHELL_COPY_DEFAULTS,
+  emptyTitle: "No conversations yet",
+  emptyDescription: "Start a conversation and it will show up here.",
+  errorTitle: "Could not load conversations",
+  errorDescription: "Something went wrong. Please try again.",
+  retryLabel: "Retry",
+  rateLimitedTitle: "Too many requests",
+  rateLimitedDescription: "Please wait a moment before trying again.",
+  groupStarred: "Starred",
+  groupToday: "Today",
+  groupYesterday: "Yesterday",
+  groupPrevious7Days: "Previous 7 days",
+  groupPrevious30Days: "Previous 30 days",
+  groupMonthYear: "{month} {year}",
+  browserOnlyTitle: "On this device",
+  browserOnlyDescription:
+    "Another browser or device keeps its own separate history.",
+  verifyingTitle: "Checking your account",
+  verifyingDescription: "Looking for messages linked to your account.",
+  verifiedTitle: "Available across signed-in devices",
+  verifiedDescription:
+    "This list refreshes when the chat opens rather than syncing live.",
+  authenticationRequiredTitle: "Sign in to see your messages",
+  authenticationRequiredDescription:
+    "Your session expired. Sign in again to load account history.",
+  identityProviderFailedTitle: "Account history is unavailable",
+  identityProviderFailedDescription:
+    "We could not verify your account, so account history is not shown here.",
+  proofNotAdmittedTitle: "Account history is unavailable",
+  proofNotAdmittedDescription:
+    "This assistant is not set up to accept your account identity.",
+  retryIdentityLabel: "Try again",
+  backLabel: "Back to conversation",
+  closeLabel: "Close conversation list",
+  loadingLabel: "Loading conversations",
+  loadMoreLabel: "Load more",
+  loadingMoreLabel: "Loading more conversations",
+  conversationsTitle: "Conversations",
+  rowActionsLabel: "Conversation options",
+  listOptionsLabel: "Conversation options",
+  deleteConversationLabel: "Delete",
+  clearHistoryLabel: "Delete all conversations",
+  resetIdentityLabel: "Forget this device",
+  messageCountLabel: "{count} messages",
+  messageCountLabelOne: "1 message",
+  conversationRemovedNotice: "Conversation deleted.",
+  historyClearedNotice: "All conversations were deleted.",
+  unavailableTitle: "Conversation history is unavailable",
+  unavailableDescription: "Try again later.",
+  newConversationRequiredTitle: "Start a new conversation",
+  newConversationRequiredDescription:
+    "The previous conversation is gone. Start a new one to keep chatting.",
+  rateLimitedWaitDescription: "You can try again in {seconds} seconds.",
+  openFailedLabel: "Could not open that conversation.",
+  deleteFailedLabel: "Could not delete that conversation.",
+  relativeNow: "now",
+  relativeMinutes: "{value}m",
+  relativeHours: "{value}h",
+  relativeDays: "{value}d",
+  relativeWeeks: "{value}w",
+  relativeYears: "{value}y",
+};
+
+/** Idempotent: safe to call on an already-resolved copy object. */
+export function resolveHistoryViewCopy(
+  copy: HistoryViewCopyInput | undefined
+): ResolvedHistoryViewCopy {
+  if (!copy) return HISTORY_VIEW_COPY_DEFAULTS;
+  const resolved = { ...HISTORY_VIEW_COPY_DEFAULTS };
+  for (const [key, value] of Object.entries(copy)) {
+    if (typeof value === "string" && value.length > 0) {
+      (resolved as Record<string, string>)[key] = value;
+    }
+  }
+  return resolved;
+}
+
+/** `{name}` substitution. Missing keys are left alone rather than blanked. */
+export function fillTemplate(
+  template: string,
+  values: Record<string, string | number>
+): string {
+  return template.replace(/\{(\w+)\}/g, (match, key: string) =>
+    key in values ? String(values[key]) : match
+  );
+}