@runtypelabs/persona 4.14.0 → 4.16.0

package/src/welcome.ts

@@ -0,0 +1,130 @@
+import type {
+  AgentWidgetConfig,
+  AgentWidgetMessage,
+  AgentWidgetWelcomeDismiss,
+  AgentWidgetWelcomeIcon,
+  AgentWidgetWelcomeVariant,
+} from "./types";
+
+/**
+ * Single source of truth for the welcome surface. Renderers consume the
+ * resolved shape only and never read `copy.welcome*` directly.
+ *
+ * The defaults live here, not in `defaults.ts`: `mergeConfigUpdate`
+ * re-applies `mergeWithDefaults` after every patch, so anything defaulted
+ * there would be materialized into the stored config and presence-based
+ * precedence could no longer tell a host-set value from a default.
+ */
+
+/** Default welcome title, applied when neither `welcome` nor `copy` sets one. */
+export const DEFAULT_WELCOME_TITLE = "Hello 👋";
+
+/**
+ * Scope statement in the assistant's voice, deliberately generic so the
+ * placeholder shape reads as something to replace with domain copy.
+ */
+export const DEFAULT_WELCOME_SUBTITLE =
+  "I can answer questions and help you get things done here.";
+
+export interface ResolvedWelcomeConfig {
+  title: string;
+  subtitle: string;
+  icon?: AgentWidgetWelcomeIcon;
+  variant: AgentWidgetWelcomeVariant;
+  dismiss: AgentWidgetWelcomeDismiss;
+  /** Undefined under `variant: "hero"`, which suppresses the greeting. */
+  message?: string;
+}
+
+// Keyed on the config object: the resolver runs on every render, so warnings
+// fire once per config identity instead of once per frame.
+const warnedConfigs = new WeakSet<AgentWidgetConfig>();
+
+const isSet = <T, K extends keyof T>(source: T | undefined, key: K): boolean =>
+  !!source && source[key] !== undefined;
+
+const warnOnce = (config: AgentWidgetConfig | undefined, messages: string[]) => {
+  if (!config || config.debug !== true || !messages.length) return;
+  if (warnedConfigs.has(config)) return;
+  warnedConfigs.add(config);
+  messages.forEach((message) => console.warn(`[persona] ${message}`));
+};
+
+/**
+ * Per-field, presence-based precedence: `welcome.*` wins, else the legacy
+ * `copy` alias, else the default above.
+ */
+export const resolveWelcomeConfig = (
+  config?: AgentWidgetConfig
+): ResolvedWelcomeConfig => {
+  const welcome = config?.welcome;
+  const copy = config?.copy;
+
+  const variant: AgentWidgetWelcomeVariant = isSet(welcome, "variant")
+    ? welcome!.variant!
+    : copy?.showWelcomeCard === false
+      ? "none"
+      : "card";
+
+  // Hero IS the greeting: `dismiss` is forced and `message` is suppressed.
+  const dismiss: AgentWidgetWelcomeDismiss =
+    variant === "hero"
+      ? "on-first-message"
+      : isSet(welcome, "dismiss")
+        ? welcome!.dismiss!
+        : "never";
+
+  const conflicts: string[] = [];
+  if (isSet(welcome, "title") && isSet(copy, "welcomeTitle")) {
+    conflicts.push(
+      "welcome.title and copy.welcomeTitle are both set; welcome.title wins. copy.welcomeTitle is deprecated."
+    );
+  }
+  if (isSet(welcome, "subtitle") && isSet(copy, "welcomeSubtitle")) {
+    conflicts.push(
+      "welcome.subtitle and copy.welcomeSubtitle are both set; welcome.subtitle wins. copy.welcomeSubtitle is deprecated."
+    );
+  }
+  if (isSet(welcome, "variant") && isSet(copy, "showWelcomeCard")) {
+    conflicts.push(
+      "welcome.variant and copy.showWelcomeCard are both set; welcome.variant wins. copy.showWelcomeCard is deprecated."
+    );
+  }
+  if (variant === "hero" && isSet(welcome, "message")) {
+    conflicts.push(
+      'welcome.message is ignored when welcome.variant is "hero": the hero is the greeting.'
+    );
+  }
+  if (variant === "hero" && isSet(welcome, "dismiss") && welcome!.dismiss !== "on-first-message") {
+    conflicts.push(
+      'welcome.dismiss is pinned to "on-first-message" when welcome.variant is "hero".'
+    );
+  }
+  warnOnce(config, conflicts);
+
+  return {
+    title: isSet(welcome, "title")
+      ? welcome!.title!
+      : copy?.welcomeTitle ?? DEFAULT_WELCOME_TITLE,
+    subtitle: isSet(welcome, "subtitle")
+      ? welcome!.subtitle!
+      : copy?.welcomeSubtitle ?? DEFAULT_WELCOME_SUBTITLE,
+    icon: welcome?.icon,
+    variant,
+    dismiss,
+    message: variant === "hero" ? undefined : welcome?.message,
+  };
+};
+
+/**
+ * Derived visibility, never stored. "User activity" is the same predicate the
+ * starters use: the session contains at least one `role: "user"` message.
+ */
+export const isWelcomeVisible = (
+  resolved: ResolvedWelcomeConfig,
+  messages: readonly AgentWidgetMessage[] | undefined
+): boolean => {
+  if (resolved.variant === "none") return false;
+  if (resolved.dismiss === "never") return true;
+  return !(messages ?? []).some((message) => message.role === "user");
+};

package/dist/chunk-MMUPR2JW.js

@@ -1 +0,0 @@
-var zt=(e,t)=>{let n=document.createElement(e);return t&&(n.className=t),n};var Bt=()=>document.createDocumentFragment(),Ft=(e,t={},...n)=>{let o=document.createElement(e);if(t.className&&(o.className=t.className),t.text!==void 0&&(o.textContent=t.text),t.attrs)for(let[s,a]of Object.entries(t.attrs))o.setAttribute(s,a);if(t.style){let s=o.style,a=t.style;for(let c of Object.keys(a)){let l=a[c];l!=null&&(s[c]=l)}}let r=n.filter(s=>s!=null);return r.length>0&&o.append(...r),o},Kt=(...e)=>e.filter(Boolean).join(" ");import{Activity as A,ArrowDown as k,ArrowUp as P,ArrowUpRight as L,Bot as I,ChevronDown as R,ChevronUp as D,ChevronRight as H,ChevronLeft as O,Check as z,Clipboard as B,ClipboardCopy as F,CodeXml as K,Copy as W,File as U,FileCode as j,FileSpreadsheet as $,FileText as q,ImagePlus as V,Loader as X,LoaderCircle as G,Mic as _,Paperclip as Y,RefreshCw as Z,Search as J,Send as Q,ShieldAlert as ee,ShieldCheck as te,ShieldX as ne,Square as oe,ThumbsDown as re,ThumbsUp as ie,Upload as se,Volume2 as ae,X as le,User as ce,Mail as de,Phone as ue,Calendar as me,Clock as pe,Building as ge,MapPin as he,Lock as fe,Key as we,CreditCard as ye,AtSign as be,Hash as ve,Globe as xe,Link as Ce,CircleCheck as Se,CircleX as Ee,TriangleAlert as Te,Info as Me,Ban as Ne,Shield as Ae,ArrowLeft as ke,ArrowRight as Pe,ExternalLink as Le,Ellipsis as Ie,EllipsisVertical as Re,Menu as De,House as He,Plus as Oe,Minus as ze,Pencil as Be,Trash as Fe,Trash2 as Ke,Save as We,Download as Ue,Share as je,Funnel as $e,Settings as qe,RotateCw as Ve,Maximize as Xe,Minimize as Ge,ShoppingCart as _e,ShoppingBag as Ye,Package as Ze,Truck as Je,Tag as Qe,Gift as et,Receipt as tt,Wallet as nt,Store as ot,DollarSign as rt,Percent as it,Play as st,Pause as at,VolumeX as lt,Camera as ct,Image as dt,Film as ut,Headphones as mt,MessageCircle as pt,MessageSquare as gt,Bell as ht,Heart as ft,Star as wt,Eye as yt,EyeOff as bt,Bookmark as vt,CalendarDays as xt,History as Ct,Timer as St,Folder as Et,FolderOpen as Tt,Files as Mt,Sparkles as Nt,Zap as At,Sun as kt,Moon as Pt,Flag as Lt,Monitor as It,Smartphone as Rt}from"lucide";var Dt={activity:A,"arrow-down":k,"arrow-up":P,"arrow-up-right":L,bot:I,"chevron-down":R,"chevron-up":D,"chevron-right":H,"chevron-left":O,check:z,clipboard:B,"clipboard-copy":F,"code-xml":K,copy:W,file:U,"file-code":j,"file-spreadsheet":$,"file-text":q,"image-plus":V,loader:X,"loader-circle":G,mic:_,paperclip:Y,"refresh-cw":Z,search:J,send:Q,"shield-alert":ee,"shield-check":te,"shield-x":ne,square:oe,"thumbs-down":re,"thumbs-up":ie,upload:se,"volume-2":ae,x:le,user:ce,mail:de,phone:ue,calendar:me,clock:pe,building:ge,"map-pin":he,lock:fe,key:we,"credit-card":ye,"at-sign":be,hash:ve,globe:xe,link:Ce,"circle-check":Se,"circle-x":Ee,"triangle-alert":Te,info:Me,ban:Ne,shield:Ae,"arrow-left":ke,"arrow-right":Pe,"external-link":Le,ellipsis:Ie,"ellipsis-vertical":Re,menu:De,house:He,plus:Oe,minus:ze,pencil:Be,trash:Fe,"trash-2":Ke,save:We,download:Ue,share:je,funnel:$e,settings:qe,"rotate-cw":Ve,maximize:Xe,minimize:Ge,"shopping-cart":_e,"shopping-bag":Ye,package:Ze,truck:Je,tag:Qe,gift:et,receipt:tt,wallet:nt,store:ot,"dollar-sign":rt,percent:it,play:st,pause:at,"volume-x":lt,camera:ct,image:dt,film:ut,headphones:mt,"message-circle":pt,"message-square":gt,bell:ht,heart:ft,star:wt,eye:yt,"eye-off":bt,bookmark:vt,"calendar-days":xt,history:Ct,timer:St,folder:Et,"folder-open":Tt,files:Mt,sparkles:Nt,zap:At,sun:kt,moon:Pt,flag:Lt,monitor:It,smartphone:Rt},jt=(e,t=24,n="currentColor",o=2)=>{let r=Dt[e];return r?Ht(r,t,n,o):(console.warn(`Lucide icon "${e}" is not in the Persona registry. Add it to packages/widget/src/utils/icons.ts (see docs/icon-registry-shortlist.md).`),null)};function Ht(e,t,n,o){if(!Array.isArray(e))return null;let r=document.createElementNS("http://www.w3.org/2000/svg","svg");return r.setAttribute("width",String(t)),r.setAttribute("height",String(t)),r.setAttribute("viewBox","0 0 24 24"),r.setAttribute("fill","none"),r.setAttribute("stroke",n),r.setAttribute("stroke-width",String(o)),r.setAttribute("stroke-linecap","round"),r.setAttribute("stroke-linejoin","round"),r.setAttribute("aria-hidden","true"),e.forEach(s=>{if(!Array.isArray(s)||s.length<2)return;let a=s[0],c=s[1];if(!c)return;let l=document.createElementNS("http://www.w3.org/2000/svg",a);Object.entries(c).forEach(([h,f])=>{h!=="stroke"&&l.setAttribute(h,String(f))}),r.appendChild(l)}),r}function qt(e){let t={trigger:e.trigger??"@",position:e.triggerPosition??"anywhere",allowSpaces:!1,sources:Array.isArray(e.sources)?e.sources:[],searchPlaceholder:e.searchPlaceholder,showButton:e.showButton!==!1,buttonIconName:e.buttonIconName,buttonTooltipText:e.buttonTooltipText},n=(e.triggers??[]).map(o=>({trigger:o.trigger,position:o.triggerPosition??"anywhere",allowSpaces:o.allowSpaces??!1,sources:Array.isArray(o.sources)?o.sources:[],searchPlaceholder:o.searchPlaceholder,showButton:o.showButton===!0,buttonIconName:o.buttonIconName,buttonTooltipText:o.buttonTooltipText}));return[t,...n]}function T(e){let t=e.getRootNode?.();return t instanceof ShadowRoot||t instanceof Document?t:e.ownerDocument??document}function b(e,t,n){let o=e instanceof Document?e.head:e,r=t.replace(/["\\]/g,"\\$&");if(o.querySelector(`style[data-persona-plugin-style="${r}"]`))return;let a=(e instanceof Document?e:e.ownerDocument??document).createElement("style");a.setAttribute("data-persona-plugin-style",t),a.textContent=n,o.appendChild(a)}function Xt(e,t,n){if(e instanceof Document||e instanceof ShadowRoot){b(e,t,n);return}let o=e;if(o.isConnected){b(T(o),t,n);return}let r=o.ownerDocument??document;b(r,t,n),queueMicrotask(()=>{let s=T(o);s!==r&&b(s,t,n)})}function Ot(e){let t=e.getRootNode?.();return t instanceof ShadowRoot?t:(e.ownerDocument??document).body}function Gt(e){let{anchor:t,content:n,placement:o="bottom-start",offset:r=6,matchAnchorWidth:s=!1,horizontalOffset:a,verticalOffset:c,zIndex:l=2147483e3,onOpen:h,onDismiss:f}=e,M=e.container??Ot(t),d=!1,w=null,v=()=>{if(!d)return;let i=t.getBoundingClientRect();n.style.position="fixed",s&&(n.style.minWidth=`${i.width}px`),a&&(n.style.maxWidth=`${i.width}px`);let m=n.getBoundingClientRect(),u=c?.()??null,y=u!=null?i.top+u:i.top,x=o==="top-start"||o==="top-end"?y-r-m.height:i.bottom+r,g=o==="bottom-end"||o==="top-end"?i.right-m.width:i.left,E=a?.()??null;if(E!=null){let N=Math.max(i.left,i.right-m.width);g=Math.min(Math.max(i.left+E,i.left),N)}n.style.top=`${x}px`,n.style.left=`${g}px`},p=()=>{d&&(d=!1,w&&(w(),w=null),n.remove())},S=()=>{if(d)return;d=!0,l!=null&&(n.style.zIndex=String(l)),M.appendChild(n),v();let i=(t.ownerDocument??document).defaultView??window,m=t.ownerDocument??document,u=()=>{if(!t.isConnected){p(),f?.("anchor-removed");return}v()},y=C=>{let g=typeof C.composedPath=="function"?C.composedPath():[];g.includes(n)||g.includes(t)||(p(),f?.("outside"))},x=i.setTimeout(()=>{m.addEventListener("pointerdown",y,!0)},0);i.addEventListener("scroll",u,!0),i.addEventListener("resize",u),w=()=>{i.clearTimeout(x),m.removeEventListener("pointerdown",y,!0),i.removeEventListener("scroll",u,!0),i.removeEventListener("resize",u)},h?.()};return{get isOpen(){return d},open:S,close:p,toggle:()=>d?p():S(),reposition:v,destroy:p}}function _t(e){return(typeof e.composedPath=="function"?e.composedPath():[]).some(n=>n instanceof HTMLElement&&(n.tagName==="INPUT"||n.tagName==="TEXTAREA"||n.isContentEditable))}export{zt as a,Bt as b,Ft as c,Kt as d,jt as e,qt as f,Xt as g,Gt as h,_t as i};