@askly/widget 3.0.0 → 3.1.0

package/README.md

@@ -90,6 +90,50 @@ askly.showNewMessage("Hi, I have a question about billing.");
 `AsklyProvider` initialises the widget on mount and removes it on unmount; `useAsklyEvent(name, handler)`
 and `useAsklyIdentity(identity)` wrap `Askly.on()` and `Askly.identify()`.
 
+### Languages
+
+The widget's own texts (buttons, labels, notices) come in English, Arabic, German, Spanish,
+French, Hindi and Portuguese. The language is the portal's setting when there is one, else the
+`locale` option, else the visitor's browser language; anything unsupported falls back to
+English. Other languages are fetched as a small chunk (about 3 KB) only when used. Arabic (and
+other right-to-left languages) lays the widget out right to left. Dates and numbers follow the
+locale. Content your team writes, such as the welcome message, FAQs and articles, is shown as
+written.
+
+```javascript
+Askly.init({ appId: "…", locale: "fr" });   // or data-locale="fr"
+Askly.setLocale("pt-BR");                  // switch at runtime
+Askly.updateTexts({ start_new_chat: "Talk to us", tab_help: "Docs" }); // your own wording, any locale
+```
+
+The keys for `updateTexts()` are the ones in `src/i18n/en.ts`; TypeScript users can import
+`AsklyTextKey`.
+
+### Accessibility
+
+The launcher is a button with its open state exposed; the panel is a dialog that takes focus
+when it opens, returns it when it closes, closes on Escape, and keeps keyboard focus inside on
+phones where it fills the screen. Sections are tabs with arrow-key navigation, the conversation
+is a live log so replies are read out, every icon button is named, errors are announced inline,
+colours meet WCAG 2.2 AA contrast, and the test suite runs axe on every screen.
+
+### Launcher options
+
+```javascript
+Askly.init({
+  appId: "…",
+  position: "left",                 // which side; default "right"
+  offset: { bottom: 40, side: 32 },  // px from the viewport edges (default 24, 16 on phones)
+  hideLauncher: true,                // no launcher: open through the API or a custom one
+  customLauncherSelector: "#contact-us, .help-link", // host elements that open and close the panel
+});
+```
+
+Each has a `data-` attribute (`data-position`, `data-offset-bottom`, `data-offset-side`,
+`data-hide-launcher`, `data-custom-launcher-selector`). Custom launchers get `aria-expanded`
+kept in sync. "Powered by Askly" is removed for plans that include white-label, from the
+portal; an embed cannot remove it.
+
 ### Theming from your page
 
 Colours come from the portal. If you need to adjust them per page, set these two custom

package/dist/app/HelpTab-BrWJK4wa.js

@@ -0,0 +1 @@
+import{g as e,t,n as l,b as a,o as c,aa as n,ab as s,C as r,d as i,f as o,B as m}from"./shared-Cp0FX5Ux.js";function p(e){switch(e){case"guide":return{title:t("help_collection_guide_title"),desc:t("help_collection_guide_desc")};case"faq":return{title:t("help_collection_faq_title"),desc:t("help_collection_faq_desc")};case"troubleshooting":return{title:t("help_collection_troubleshooting_title"),desc:t("help_collection_troubleshooting_desc")};default:return{title:t("help_collection_other_title"),desc:t("help_collection_other_desc")}}}function d(d){const{allArticles:h,articleFeedback:u,articlesLoading:E,handleSearchChange:_,handleSelectArticle:y,organizationLogo:f,organizationName:N,searchError:b,searchLoading:k,searchQuery:v,searchResults:g,selectedArticle:x,selectedCollection:w,setActiveTab:C,setArticleFeedback:z,setInput:S,setSelectedArticle:A,setSelectedCollection:L,themeColor:I}=d;return e.createElement("div",{className:"chat-body help-layout"},x?e.createElement("div",{className:"help-article-reader"},e.createElement("div",{className:"article-breadcrumb"},e.createElement("button",{type:"button",className:"article-breadcrumb-link",onClick:()=>{A(null),L(null)}},t("header_help_center")),e.createElement("span",{"aria-hidden":"true"},"/"),e.createElement("span",{className:"article-breadcrumb-type"},x.document_type?p(x.document_type.toLowerCase()).title:t("help_document_type_fallback"))),e.createElement("button",{type:"button",className:"help-back-btn",onClick:()=>A(null),style:{marginBottom:14}},e.createElement(l,{size:16,className:"askly-flip-rtl"}),e.createElement("span",null,t("help_back_to_articles"))),e.createElement("h1",{className:"help-article-heading",tabIndex:-1},x.title),e.createElement("div",{className:"article-author-bar"},e.createElement("img",{src:f||"https://askly.co.in/logo-small.png",alt:N,className:"article-author-avatar"}),e.createElement("div",{className:"article-author-text"},e.createElement("span",{className:"article-author-name"},t("help_written_by",{organizationName:N})),e.createElement("span",{className:"article-author-meta"},t("help_updated_recently")," • ",e.createElement("span",{"aria-hidden":"true"},"⏱ "),a("help_read_time",(q=x.content,Math.max(1,Math.ceil((q||"").split(/\s+/).length/180))))))),e.createElement("div",{className:"help-article-body",dangerouslySetInnerHTML:{__html:c(n(x.content))}}),e.createElement("div",{className:"article-feedback"},e.createElement("div",{className:"article-feedback-title"},t("help_feedback_title")),u[x.id]?e.createElement("div",{className:"article-feedback-thanks",role:"status"},e.createElement("span",{"aria-hidden":"true"},"🎉 "),t("help_feedback_thanks")):e.createElement("div",{className:"article-feedback-options"},e.createElement("button",{type:"button",className:"article-feedback-btn",onClick:()=>z(e=>({...e,[x.id]:"yes"}))},e.createElement("span",{"aria-hidden":"true"},"😃 "),t("help_feedback_yes")),e.createElement("button",{type:"button",className:"article-feedback-btn",onClick:()=>z(e=>({...e,[x.id]:"somewhat"}))},e.createElement("span",{"aria-hidden":"true"},"😐 "),t("help_feedback_somewhat")),e.createElement("button",{type:"button",className:"article-feedback-btn",onClick:()=>z(e=>({...e,[x.id]:"no"}))},e.createElement("span",{"aria-hidden":"true"},"😞 "),t("help_feedback_no"))),e.createElement("button",{type:"button",className:"article-handoff",onClick:()=>{S(t("help_handoff_prefill",{title:x.title})),C("messages")}},e.createElement("div",{className:"article-handoff-text"},e.createElement("span",{className:"article-handoff-title"},e.createElement(s,{size:13})," ",t("help_handoff_title")),e.createElement("span",{className:"article-handoff-desc"},t("help_handoff_desc"))),e.createElement(r,{size:16,className:"article-handoff-chevron askly-flip-rtl"})))):e.createElement("div",null,e.createElement("div",{className:"home-search-input-wrapper",style:{marginBottom:14}},e.createElement(i,{size:14,className:"search-icon-svg"}),e.createElement("input",{type:"text",value:v,onChange:_,placeholder:t("help_search_placeholder"),"aria-label":t("help_search_label")}),k&&e.createElement("span",{className:"search-loader"})),w&&e.createElement("div",{style:{display:"flex",alignItems:"center",gap:8,marginBottom:12}},e.createElement("button",{type:"button",onClick:()=>L(null),style:{all:"unset",cursor:"pointer",fontSize:12,color:I,fontWeight:500,display:"flex",alignItems:"center",gap:4}},e.createElement(l,{size:14,className:"askly-flip-rtl"}),e.createElement("span",null,t("help_all_collections"))),e.createElement("span",{style:{fontSize:12,color:"var(--text-4)"},"aria-hidden":"true"},"/"),e.createElement("span",{style:{fontSize:12,fontWeight:600,color:"var(--text-1)",textTransform:"capitalize"}},p(w).title)),e.createElement("div",{className:"help-articles-list"},""===v.trim()?w?(()=>{const l=h.filter(e=>(e.document_type||"guide").toLowerCase()===w.toLowerCase());return e.createElement("div",{style:{display:"flex",flexDirection:"column",gap:10,width:"100%"}},e.createElement("div",{style:{fontSize:11,fontWeight:600,color:"var(--text-3)",textTransform:"uppercase",letterSpacing:"0.5px"}},t("help_collection_articles",{collection:p(w).title,count:o(l.length)})),e.createElement("div",{style:{display:"flex",flexDirection:"column",gap:8}},l.map(t=>e.createElement("button",{type:"button",key:t.id,className:"help-article-row",onClick:()=>y(t)},e.createElement("div",{style:{display:"flex",flexDirection:"column",gap:3,alignItems:"flex-start",textAlign:"start"}},e.createElement("span",{className:"article-row-title"},t.title),t.content&&e.createElement("span",{className:"article-row-preview"},t.content.replace(/[\n\r]+/g," ").slice(0,85),"…")),e.createElement(r,{size:14,className:"article-row-chevron askly-flip-rtl"})))))})():e.createElement("div",{className:"help-collections"},(()=>{if(E)return[0,1,2].map(t=>e.createElement("div",{key:t,className:"help-collection-card is-skeleton"},e.createElement("div",{className:"help-collection-left"},e.createElement("span",{className:"askly-skeleton help-collection-icon-skel"}),e.createElement("div",{className:"help-collection-text"},e.createElement("span",{className:"askly-skeleton askly-skeleton-line",style:{width:"60%"}}),e.createElement("span",{className:"askly-skeleton askly-skeleton-line",style:{width:"90%"}})))));const l={};h.forEach(e=>{const t=(e.document_type||"guide").toLowerCase();l[t]||(l[t]=[]),l[t].push(e)});const c=Object.keys(l);return 0===c.length?e.createElement("div",{className:"askly-empty-state"},e.createElement("div",{className:"askly-empty-icon"},e.createElement(m,{size:22})),e.createElement("div",{className:"askly-empty-title"},t("help_empty_title")),e.createElement("div",{className:"askly-empty-desc"},t("help_empty_desc"))):c.map(t=>{const c=l[t],{title:n,desc:s}=p(t);return e.createElement("button",{type:"button",key:t,className:"help-collection-card",onClick:()=>L(t)},e.createElement("div",{className:"help-collection-left"},e.createElement("div",{className:"help-collection-icon"},e.createElement(m,{size:16})),e.createElement("div",{className:"help-collection-text"},e.createElement("div",{className:"help-collection-title"},n),e.createElement("div",{className:"help-collection-desc"},s),e.createElement("div",{className:"help-collection-count"},a("help_article_count",c.length)))),e.createElement(r,{size:16,className:"help-collection-chevron askly-flip-rtl"}))})})()):b?e.createElement("div",{className:"no-search-results"},b):0!==g.length||k?g.map(t=>e.createElement("button",{type:"button",key:t.id,className:"help-article-row",onClick:()=>y(t)},e.createElement("div",{style:{display:"flex",flexDirection:"column",gap:3,alignItems:"flex-start",textAlign:"start"}},e.createElement("span",{className:"article-row-title"},t.title),e.createElement("span",{className:"article-row-preview"},t.content.slice(0,80),"…")),e.createElement(r,{size:14,className:"article-row-chevron askly-flip-rtl"}))):e.createElement("div",{className:"no-search-results",role:"status"},t("help_search_no_results",{query:v})))));var q}export{d as HelpTab};

package/dist/app/VoiceRecorder-rdqySW9p.js

@@ -0,0 +1 @@
+import{x as e,y as t,t as a,b as s,g as n,f as c,X as l}from"./shared-Cp0FX5Ux.js";function i({phase:i,meterRef:o,maxMs:r,onStop:m,onCancel:v}){const[u,p]=e([]),[d,y]=e(0);t(()=>{if("recording"!==i)return;const e=setInterval(()=>{const{level:e,elapsedMs:t}=o.current;y(t),p(t=>(t.length>=80?t.slice(1):t).concat(e))},100);return()=>clearInterval(e)},[i]);const b="recording"===i,_=r-d,h=Math.max(0,Math.ceil(_/1e3)),k=b&&_<=1e4,E=a("transcribing"===i?"voice_status_transcribing":b?"voice_status_listening":"voice_status_waiting"),g=b&&_<=5e3?`${E} ${s("voice_seconds_left",h)}`:E;return n.createElement("div",{className:`askly-voice ${i}`},n.createElement("button",{type:"button",className:"askly-voice-btn",onClick:v,title:a("voice_cancel"),"aria-label":a("voice_cancel")},n.createElement(l,{size:20})),n.createElement("span",{className:"askly-voice-meter","aria-hidden":"true"},u.map((e,t)=>n.createElement("i",{key:t,style:{height:`${Math.round(2+22*Math.min(1,e))}px`}}))),n.createElement("span",{className:"askly-voice-status",role:"status"},g),k&&n.createElement("span",{className:"askly-voice-time","aria-hidden":"true"},a("voice_countdown",{count:c(h)})),b?n.createElement("button",{type:"button",className:"askly-voice-btn done",onClick:m,title:a("voice_stop"),"aria-label":a("voice_stop")},n.createElement("span",{className:"askly-voice-stop"})):n.createElement("span",{className:"askly-voice-btn done busy","aria-hidden":"true"},n.createElement("span",{className:"askly-voice-spinner"})))}export{i as VoiceRecorder};

package/dist/app/ar-V_LzQrur.js

@@ -0,0 +1 @@
+const e={launcher_open:"فتح محادثة الدعم",launcher_close:"إغلاق محادثة الدعم",launcher_open_unread_zero:"فتح محادثة الدعم، لا توجد رسائل جديدة",launcher_open_unread_one:"فتح محادثة الدعم، رسالة جديدة واحدة",launcher_open_unread_two:"فتح محادثة الدعم، رسالتان جديدتان",launcher_open_unread_few:"فتح محادثة الدعم، {count} رسائل جديدة",launcher_open_unread_many:"فتح محادثة الدعم، {count} رسالة جديدة",launcher_open_unread_other:"فتح محادثة الدعم، {count} رسالة جديدة",launcher_unread_overflow:"{count}+",panel_label:"دعم {organizationName}",header_messages:"الرسائل",header_help_center:"مركز المساعدة",header_back_to_conversations:"الرجوع إلى المحادثات",header_expand:"تكبير النافذة",header_collapse:"تصغير النافذة",header_close:"إغلاق",conversation_label:"محادثة",sending_to_team:"جارٍ الإرسال إلى الفريق…",uploading_attachment:"جارٍ رفع المرفق…",new_messages_zero:"لا توجد رسائل جديدة",new_messages_one:"رسالة جديدة واحدة",new_messages_two:"رسالتان جديدتان",new_messages_few:"{count} رسائل جديدة",new_messages_many:"{count} رسالة جديدة",new_messages_other:"{count} رسالة جديدة",reaction_helpful:"مفيد",reaction_not_helpful:"غير مفيد",copy_message:"نسخ الرسالة",copied:"تم النسخ",message_from_agent:"موظف الدعم",message_from_you:"أنت",terms_notice:"بالدردشة معنا، فإنك توافق على {terms}",terms_link:"الشروط",powered_by:"مدعوم من {brand}",tab_explore:"استكشاف",tab_messages:"الرسائل",tab_help:"المساعدة",tabs_label:"الأقسام",conversations_empty_title:"لا توجد محادثات بعد",conversations_empty_desc:"ابدأ محادثة وسيساعدك وكيل الذكاء الاصطناعي وفريقنا.",conversation_no_messages:"لا توجد رسائل بعد",conversation_title:"محادثة رقم {number}",start_new_chat:"اطرح سؤالًا",composer_label:"الرسالة",composer_placeholder:"اكتب رسالتك…",composer_placeholder_lead_required:"أضف بريدك الإلكتروني أعلاه للمتابعة…",composer_placeholder_security_check:"أكمل التحقق الأمني للدردشة…",composer_hint:"اضغط Enter للإرسال، وShift+Enter لسطر جديد",attach_file:"إرفاق ملف (10 ميغابايت كحد أقصى)",insert_emoji:"إدراج رمز تعبيري",emoji_picker_label:"اختر رمزًا تعبيريًا",send_message:"إرسال الرسالة",attachment_image_alt:"صورة مرفقة",attachment_file_label:"ملف مرفق: {name}",notice_security_check_required:"يرجى إكمال التحقق الأمني أولًا.",voice_start:"إدخال صوتي",voice_finish:"إنهاء التسجيل",voice_status_waiting:"في انتظار الميكروفون…",voice_status_listening:"جارٍ الاستماع…",voice_status_transcribing:"جارٍ التحويل إلى نص…",voice_seconds_left_zero:"انتهى الوقت",voice_countdown:"{count} ث",voice_seconds_left_one:"ثانية واحدة متبقية",voice_seconds_left_two:"ثانيتان متبقيتان",voice_seconds_left_few:"{count} ثوانٍ متبقية",voice_seconds_left_many:"{count} ثانية متبقية",voice_seconds_left_other:"{count} ثانية متبقية",voice_cancel:"إلغاء الإدخال الصوتي",voice_stop:"إيقاف التسجيل وتحويله إلى نص",voice_retry:"حاول مرة أخرى",voice_error_insecure:"يتطلب الإدخال الصوتي صفحة آمنة (https).",voice_error_unsupported:"الإدخال الصوتي غير مدعوم في هذا المتصفح.",voice_error_denied:"الوصول إلى الميكروفون محظور. اسمح به من إعدادات الموقع في متصفحك لاستخدام الإدخال الصوتي.",voice_error_no_microphone:"لم يتم العثور على ميكروفون.",voice_error_no_speech:"لم نسمع ذلك جيدًا. يرجى المحاولة مرة أخرى.",voice_error_no_audio:"لا يصدر أي صوت من الميكروفون. تأكد من أنه غير مكتوم ومن اختيار الميكروفون الصحيح.",voice_error_limit:"الإدخال الصوتي غير متاح حاليًا. يرجى كتابة رسالتك.",voice_error_disabled:"الإدخال الصوتي معطَّل.",voice_error_network:"تعذّر تحويل تسجيلك إلى نص. تحقق من اتصالك وحاول مرة أخرى.",voice_error_failed:"تعذّر تحويل تسجيلك إلى نص. يرجى المحاولة مرة أخرى أو كتابة رسالتك.",lead_prompt:"اترك بريدك الإلكتروني وسنردّ عليك هناك إذا غادرت.",lead_email_placeholder:"you@example.com",lead_email_label:"بريدك الإلكتروني",lead_save:"حفظ",lead_saving:"جارٍ الحفظ…",lead_dismiss:"لا، شكرًا",lead_error_invalid_email:"لا يبدو هذا عنوان بريد إلكتروني صحيحًا.",lead_error_save_failed:"تعذّر الحفظ الآن. يمكنك متابعة المحادثة.",greeting_default:"مرحبًا من {organizationName}. كيف يمكننا مساعدتك؟",greeting_default_persona:"مرحبًا، أنا {ai_name} من {organizationName}. كيف يمكنني مساعدتك؟",greeting_dismiss:"إغلاق الترحيب",welcome_default:"مرحبًا! كيف يمكنني مساعدتك اليوم؟",explore_hero_title:"أهلًا بك",explore_hero_subtitle:"كيف يمكننا مساعدتك؟",explore_search_placeholder:"ابحث عن مساعدة…",explore_cta_title:"اسأل وكيل الذكاء الاصطناعي",explore_cta_sub:"إجابات فورية على مدار الساعة — أو تواصل مع الفريق",explore_tile_help_title:"مركز المساعدة",explore_tile_help_sub:"أدلة ومستندات",explore_tile_messages_title:"الرسائل",explore_tile_messages_sub:"محادثاتك",explore_popular_questions:"أسئلة شائعة",explore_ask_ai_about_this:"اسأل وكيل الذكاء الاصطناعي عن هذا",explore_recommended_reading:"قراءات مقترحة",help_search_placeholder:"ابحث في المقالات…",help_search_label:"البحث في المقالات",help_searching:"جارٍ البحث…",help_search_no_results:"لا توجد مقالات مطابقة لـ «{query}»",help_all_collections:"جميع المجموعات",help_back_to_articles:"الرجوع إلى المقالات",help_document_type_fallback:"دليل",help_written_by:"بقلم فريق دعم {organizationName}",help_updated_recently:"تم التحديث مؤخرًا",help_read_time_zero:"أقل من دقيقة للقراءة",help_read_time_one:"دقيقة واحدة للقراءة",help_read_time_two:"دقيقتان للقراءة",help_read_time_few:"{count} دقائق للقراءة",help_read_time_many:"{count} دقيقة للقراءة",help_read_time_other:"{count} دقيقة للقراءة",help_feedback_title:"هل أجاب هذا عن سؤالك؟",help_feedback_thanks:"شكرًا على ملاحظاتك!",help_feedback_yes:"نعم",help_feedback_somewhat:"إلى حدٍّ ما",help_feedback_no:"لا",help_handoff_title:"لا تزال لديك أسئلة؟",help_handoff_desc:"اسأل وكيل الذكاء الاصطناعي للحصول على إجابات فورية",help_handoff_prefill:"لديّ سؤال حول المقالة «{title}»: ",help_collection_articles:"مقالات {collection} ({count})",help_article_count_zero:"لا توجد مقالات",help_article_count_one:"مقالة واحدة",help_article_count_two:"مقالتان",help_article_count_few:"{count} مقالات",help_article_count_many:"{count} مقالة",help_article_count_other:"{count} مقالة",help_empty_title:"وثائق المساعدة",help_empty_desc:"ابحث أعلاه للحصول على حلول فورية من قاعدة معارفنا.",help_collection_guide_title:"الأدلة والدروس",help_collection_guide_desc:"شروحات الإعداد والقواعد وأدلة البدء",help_collection_faq_title:"الأسئلة المتكررة",help_collection_faq_desc:"إجابات سريعة عن الأسئلة الشائعة حول الحساب والخدمة",help_collection_troubleshooting_title:"استكشاف الأخطاء والدعم",help_collection_troubleshooting_desc:"حلول خطوة بخطوة للمشكلات التقنية",help_collection_other_title:"القواعد والوثائق",help_collection_other_desc:"الشروط الرسمية والقواعد ووثائق السياسات",help_featured_article:"مقالة مميزة",help_untitled_article:"مقالة بدون عنوان",help_unavailable:"تعذّر تحميل مركز المساعدة. تحقق من اتصالك وحاول مرة أخرى.",link_opens_new_tab:"(يُفتح في علامة تبويب جديدة)",error_search_rate_limited:"أنت تبحث بسرعة كبيرة. يرجى الانتظار قليلًا ثم المحاولة مرة أخرى.",error_search_unavailable:"البحث غير متاح حاليًا. يرجى المحاولة مرة أخرى بعد قليل.",error_send_rate_limited:"أنت ترسل الرسائل بسرعة كبيرة. يرجى الانتظار قليلًا ثم المحاولة مرة أخرى.",error_send_failed:"عذرًا، حدث خطأ ما. يرجى المحاولة مرة أخرى.",error_attachment_rejected:"لا يمكن إرفاق هذا الملف. قد يكون كبيرًا جدًا (الحد 10 ميغابايت) أو من نوع غير مسموح به.",error_attachment_upload_failed:"تعذّر رفع هذا المرفق. يرجى المحاولة مرة أخرى."};export{e as default};