@usereq/widget 0.2.25 → 1.0.0-experimental.0

package/src/chat-widget/chat-widget-appearance.ts

@@ -1,134 +0,0 @@
-import type { CSSProperties } from "react";
-
-export type ChatWidgetGradient = {
-  from: string;
-  to: string;
-  angle?: number | null;
-};
-
-/** Solid hex or gradient. Mirrors `ChatColor` in `@usereq/ui`. */
-export type ChatWidgetColor = string | ChatWidgetGradient;
-
-export type ChatWidgetIconPack = "lucide" | "heroicons" | "phosphor";
-
-export type ChatWidgetIconSlot =
-  | "launcher"
-  | "send"
-  | "close"
-  | "minimize"
-  | "attach"
-  | "mic";
-
-export type ChatWidgetIcons = {
-  pack?: ChatWidgetIconPack | null;
-  overrides?: Partial<Record<ChatWidgetIconSlot, string>> | null;
-};
-
-/**
- * Every appearance token the agents row can store.
- *
- * This deliberately mirrors `ChatAppearance` in `@usereq/ui` field-for-field,
- * but is declared standalone rather than imported: `shared/widget-config` is
- * consumed by `apps/api`, which has no `@usereq/ui` dependency. Structural
- * typing means the two still line up where they meet.
- *
- * Keep in sync with `widgetAppearanceSchema` in the API's `widget.model.ts`
- * and `AgentWidgetAppearance` in the dashboard.
- */
-export type ChatWidgetAppearance = {
-  // — Legacy gradient (still the fallback when `primary` is unset) —
-  avatarOrbColor1?: string | null;
-  avatarOrbColor2?: string | null;
-
-  // — Brand —
-  primary?: ChatWidgetColor | null;
-  primaryForeground?: string | null;
-  secondary?: string | null;
-  secondaryForeground?: string | null;
-  actionText?: string | null;
-
-  // — Surface tokens (panel) —
-  background?: string | null;
-  foreground?: string | null;
-  muted?: string | null;
-  mutedForeground?: string | null;
-  border?: string | null;
-  ring?: string | null;
-
-  // — Granular text overrides —
-  textPrimary?: string | null;
-  textForeground?: string | null;
-  textMutedForeground?: string | null;
-
-  // — Icon pack swap (persist-only for now) —
-  icons?: ChatWidgetIcons | null;
-};
-
-/**
- * Only the three legacy fields are guaranteed present — every other token
- * stays optional on purpose, because `undefined` means "not customized, use
- * the design-system default". Filling them with defaults here would emit
- * `--chat-*` variables for tokens the user never set and lock the panel out
- * of the host theme.
- */
-export type ResolvedChatWidgetAppearance = ChatWidgetAppearance & {
-  avatarOrbColor1: string;
-  avatarOrbColor2: string;
-  actionText: string;
-};
-
-export const DEFAULT_CHAT_WIDGET_APPEARANCE: ResolvedChatWidgetAppearance = {
-  avatarOrbColor1: "#2563eb",
-  avatarOrbColor2: "#60a5fa",
-  actionText: "Need help?",
-};
-
-/**
- * Fills defaults for the three legacy fields and passes every other token
- * through untouched.
- *
- * The spread is load-bearing: this function used to construct a fresh
- * three-key object, which silently discarded the entire saved theme
- * (background, primary, text colors…) on its way to the embed. Any new token
- * added to `ChatWidgetAppearance` now survives without editing this function.
- */
-export function resolveChatWidgetAppearance(
-  appearance?: Partial<ChatWidgetAppearance> | null,
-): ResolvedChatWidgetAppearance {
-  return {
-    ...(appearance ?? {}),
-    avatarOrbColor1:
-      normalizeString(appearance?.avatarOrbColor1) ??
-      DEFAULT_CHAT_WIDGET_APPEARANCE.avatarOrbColor1,
-    avatarOrbColor2:
-      normalizeString(appearance?.avatarOrbColor2) ??
-      DEFAULT_CHAT_WIDGET_APPEARANCE.avatarOrbColor2,
-    actionText:
-      normalizeString(appearance?.actionText) ??
-      DEFAULT_CHAT_WIDGET_APPEARANCE.actionText,
-  };
-}
-
-export function getChatWidgetGradientStyle(
-  appearance?: Partial<ChatWidgetAppearance> | null,
-): CSSProperties {
-  const resolved = resolveChatWidgetAppearance(appearance);
-  return {
-    background: `linear-gradient(135deg, ${resolved.avatarOrbColor1}, ${resolved.avatarOrbColor2})`,
-  };
-}
-
-export function getChatWidgetAvatarStyle(
-  appearance?: Partial<ChatWidgetAppearance> | null,
-): CSSProperties {
-  const resolved = resolveChatWidgetAppearance(appearance);
-  return {
-    background: `linear-gradient(135deg, ${resolved.avatarOrbColor1}, ${resolved.avatarOrbColor2})`,
-    boxShadow: `0 10px 24px color-mix(in srgb, ${resolved.avatarOrbColor1} 22%, transparent)`,
-  };
-}
-
-function normalizeString(value: string | null | undefined): string | null {
-  const trimmed = value?.trim();
-  return trimmed ? trimmed : null;
-}

package/src/chat-widget/message-reveal.ts

@@ -1,52 +0,0 @@
-/**
- * Staggered reveal timing for assistant message turns. Pure helper (no React)
- * used by the custom element to drip assistant replies in one-by-one with a
- * brief "typing" hold between them.
- */
-
-export type AssistantMessageRevealSource = {
-  id: string;
-  content: string;
-};
-
-export type AssistantMessageRevealStep<
-  T extends AssistantMessageRevealSource = AssistantMessageRevealSource,
-> = {
-  message: T;
-  delayMs: number;
-};
-
-export function buildAssistantMessageRevealSteps<
-  T extends AssistantMessageRevealSource,
->(
-  messages: T[],
-  options?: {
-    initialDelayMs?: number;
-    typingHoldMs?: number;
-    interMessageDelayMs?: number;
-    interMessageDelayJitterMs?: number;
-  },
-): AssistantMessageRevealStep<T>[] {
-  if (messages.length === 0) {
-    return [];
-  }
-
-  const initialDelayMs = options?.initialDelayMs ?? 0;
-  const typingHoldMs = options?.typingHoldMs ?? 1260;
-  const interMessageDelayMs = options?.interMessageDelayMs ?? 1520;
-  const jitterMs = Math.max(0, options?.interMessageDelayJitterMs ?? 100);
-
-  return messages.map((message, index) => {
-    const baseDelay =
-      index === 0 ? initialDelayMs + typingHoldMs : interMessageDelayMs;
-    const jitter =
-      index === 0 || jitterMs === 0
-        ? 0
-        : Math.round((Math.random() * 2 - 1) * jitterMs);
-
-    return {
-      message,
-      delayMs: Math.max(0, baseDelay + jitter),
-    };
-  });
-}

package/src/chat-widget/stop-confirmation.ts

@@ -1,288 +0,0 @@
-export const STOP_CONFIRMATION_KIND = "stop_confirmation" as const;
-export const STOP_CONFIRMATION_RESULT_KIND =
-  "stop_confirmation_result" as const;
-
-export const DEFAULT_STOP_CONVERSATION_PROMPT =
-  "Do you want to stop this conversation?";
-
-export type StopConfirmationState = "pending" | "accepted" | "rejected";
-export type StopConfirmationDecision = "accepted" | "rejected";
-
-export type StopConfirmationPromptEnvelope = {
-  kind: typeof STOP_CONFIRMATION_KIND;
-  confirmationId: string;
-  state: StopConfirmationState;
-  prompt: string;
-};
-
-export type StopConfirmationResultEnvelope = {
-  kind: typeof STOP_CONFIRMATION_RESULT_KIND;
-  confirmationId: string;
-  decision: StopConfirmationDecision;
-};
-
-export type StopConfirmationEnvelope =
-  | StopConfirmationPromptEnvelope
-  | StopConfirmationResultEnvelope;
-
-export type StopConfirmationMessageLike = {
-  id: string;
-  content: string;
-  createdAt?: string;
-};
-
-export type StopConfirmationRenderItem<T extends StopConfirmationMessageLike> =
-  | {
-      type: "message";
-      message: T;
-    }
-  | {
-      type: "confirmation";
-      message: T;
-      envelope: StopConfirmationPromptEnvelope;
-      latestEnvelope: StopConfirmationEnvelope;
-    };
-
-function isRecord(value: unknown): value is Record<string, unknown> {
-  return typeof value === "object" && value !== null && !Array.isArray(value);
-}
-
-function normalizeState(value: unknown): StopConfirmationState {
-  return value === "accepted" || value === "rejected" ? value : "pending";
-}
-
-function normalizeDecision(value: unknown): StopConfirmationDecision | null {
-  return value === "accepted" || value === "rejected" ? value : null;
-}
-
-function normalizePrompt(value: unknown): string {
-  if (typeof value !== "string") {
-    return DEFAULT_STOP_CONVERSATION_PROMPT;
-  }
-  const trimmed = value.trim();
-  return trimmed.length > 0 ? trimmed : DEFAULT_STOP_CONVERSATION_PROMPT;
-}
-
-export function createStopConfirmationPromptEnvelope(input: {
-  confirmationId: string;
-  prompt?: string;
-  state?: StopConfirmationState;
-}): StopConfirmationPromptEnvelope {
-  return {
-    kind: STOP_CONFIRMATION_KIND,
-    confirmationId: input.confirmationId,
-    state: normalizeState(input.state),
-    prompt: normalizePrompt(input.prompt),
-  };
-}
-
-export function createStopConfirmationResultEnvelope(input: {
-  confirmationId: string;
-  decision: StopConfirmationDecision;
-}): StopConfirmationResultEnvelope {
-  return {
-    kind: STOP_CONFIRMATION_RESULT_KIND,
-    confirmationId: input.confirmationId,
-    decision: input.decision,
-  };
-}
-
-export function encodeStopConfirmationEnvelope(
-  envelope: StopConfirmationEnvelope,
-): string {
-  return JSON.stringify(envelope);
-}
-
-export function encodeStopConfirmationPrompt(input: {
-  confirmationId: string;
-  prompt?: string;
-  state?: StopConfirmationState;
-}): string {
-  return encodeStopConfirmationEnvelope(
-    createStopConfirmationPromptEnvelope(input),
-  );
-}
-
-export function encodeStopConfirmationResult(input: {
-  confirmationId: string;
-  decision: StopConfirmationDecision;
-}): string {
-  return encodeStopConfirmationEnvelope(
-    createStopConfirmationResultEnvelope(input),
-  );
-}
-
-export function parseStopConfirmationEnvelope(
-  content: string | null | undefined,
-): StopConfirmationEnvelope | null {
-  if (typeof content !== "string" || content.trim() === "") {
-    return null;
-  }
-
-  let parsed: unknown;
-  try {
-    parsed = JSON.parse(content);
-  } catch {
-    return null;
-  }
-
-  if (!isRecord(parsed) || typeof parsed.kind !== "string") {
-    return null;
-  }
-
-  if (parsed.kind === STOP_CONFIRMATION_KIND) {
-    if (typeof parsed.confirmationId !== "string" || !parsed.confirmationId.trim()) {
-      return null;
-    }
-
-    return {
-      kind: STOP_CONFIRMATION_KIND,
-      confirmationId: parsed.confirmationId,
-      state: normalizeState(parsed.state),
-      prompt: normalizePrompt(parsed.prompt),
-    };
-  }
-
-  if (parsed.kind === STOP_CONFIRMATION_RESULT_KIND) {
-    const decision = normalizeDecision(parsed.decision);
-    if (
-      typeof parsed.confirmationId !== "string" ||
-      !parsed.confirmationId.trim() ||
-      decision == null
-    ) {
-      return null;
-    }
-
-    return {
-      kind: STOP_CONFIRMATION_RESULT_KIND,
-      confirmationId: parsed.confirmationId,
-      decision,
-    };
-  }
-
-  return null;
-}
-
-export function foldStopConfirmationMessages<T extends StopConfirmationMessageLike>(
-  messages: T[],
-): StopConfirmationRenderItem<T>[] {
-  const byConfirmationId = new Map<
-    string,
-    {
-      firstIndex: number;
-      latestIndex: number;
-      latestEnvelope: StopConfirmationEnvelope;
-    }
-  >();
-
-  messages.forEach((message, index) => {
-    const envelope = parseStopConfirmationEnvelope(message.content);
-    if (!envelope) {
-      return;
-    }
-
-    const entry = byConfirmationId.get(envelope.confirmationId);
-    const sortValue = safeCreatedAtValue(message.createdAt, index);
-    if (!entry) {
-      byConfirmationId.set(envelope.confirmationId, {
-        firstIndex: index,
-        latestIndex: index,
-        latestEnvelope: envelope,
-      });
-      return;
-    }
-
-    const currentSortValue = safeCreatedAtValue(
-      messages[entry.latestIndex]?.createdAt,
-      entry.latestIndex,
-    );
-
-    if (sortValue >= currentSortValue) {
-      byConfirmationId.set(envelope.confirmationId, {
-        firstIndex: entry.firstIndex,
-        latestIndex: index,
-        latestEnvelope: envelope,
-      });
-    }
-  });
-
-  const renderItems: StopConfirmationRenderItem<T>[] = [];
-
-  messages.forEach((message, index) => {
-    const envelope = parseStopConfirmationEnvelope(message.content);
-    if (!envelope) {
-      renderItems.push({ type: "message", message });
-      return;
-    }
-
-    const entry = byConfirmationId.get(envelope.confirmationId);
-    if (!entry || entry.firstIndex !== index) {
-      return;
-    }
-
-    const promptEnvelope =
-      entry.latestEnvelope.kind === STOP_CONFIRMATION_KIND
-        ? entry.latestEnvelope
-        : createStopConfirmationPromptEnvelope({
-            confirmationId: entry.latestEnvelope.confirmationId,
-            prompt: DEFAULT_STOP_CONVERSATION_PROMPT,
-          });
-
-    renderItems.push({
-      type: "confirmation",
-      message,
-      envelope: promptEnvelope,
-      latestEnvelope: entry.latestEnvelope,
-    });
-  });
-
-  return renderItems;
-}
-
-export function getPendingStopConfirmationId<T extends StopConfirmationMessageLike>(
-  messages: T[],
-): string | null {
-  const latestByConfirmationId = new Map<
-    string,
-    {
-      sortValue: number;
-      envelope: StopConfirmationEnvelope;
-    }
-  >();
-
-  messages.forEach((message, index) => {
-    const envelope = parseStopConfirmationEnvelope(message.content);
-    if (!envelope) {
-      return;
-    }
-
-    const sortValue = safeCreatedAtValue(message.createdAt, index);
-    const current = latestByConfirmationId.get(envelope.confirmationId);
-    if (!current || sortValue >= current.sortValue) {
-      latestByConfirmationId.set(envelope.confirmationId, {
-        sortValue,
-        envelope,
-      });
-    }
-  });
-
-  for (const [confirmationId, entry] of latestByConfirmationId.entries()) {
-    if (
-      entry.envelope.kind === STOP_CONFIRMATION_KIND &&
-      entry.envelope.state === "pending"
-    ) {
-      return confirmationId;
-    }
-  }
-
-  return null;
-}
-
-function safeCreatedAtValue(value: string | undefined, fallbackIndex: number): number {
-  if (typeof value !== "string") {
-    return fallbackIndex;
-  }
-
-  const timestamp = Date.parse(value);
-  return Number.isNaN(timestamp) ? fallbackIndex : timestamp;
-}