e!dZddlmZddlZddlmZmZmZmZddl Z ddl m Z ddl m ZerddlmZGd d e jZGd d e jZGd dee Z dS)a( The Panel TextToSpeak Widget provides functionality for *text to speech* via the the HTML5 SpeechSynthesis API. See https://developer.mozilla.org/en-US/docs/Web/API/SpeechSynthesis The term *utterance* is used throughout the API. It is the smallest unit of speech in spoken language analysis. ) annotationsN) TYPE_CHECKINGClassVarMappingType)Widget) TextToSpeech)ModelceZdZdZejdddZejddZejddZ ejdd Z ejdd Z e d Z e d Zd S)Voicea The current device (i.e. OS and Browser) provides a list of Voices. Each with a unique name and speaking a specific language. Wraps the HTML5 SpeecSynthesisVoice API See https://developer.mozilla.org/en-US/docs/Web/API/SpeechSynthesisVoice TFz A Boolean indicating whether the voice is the default voice for the current app language (True), or not (False.))constantdefaultdoczL Returns a BCP 47 language tag indicating the language of the voice.)rrz A Boolean indicating whether the voice is supplied by a local speech synthesizer service (True), or a remote speech synthesizer service (False.)zA Returns a human-readable name that represents the voice.ze Returns the type of URI and location of the speech synthesis service for this voice.cVg}|D]#}tdi|}||$|S)z?Returns a list of Voice objects from the list of dicts provided)r append)voicesresult_voicevoices z&Voice.group_by_lang..Is$%E%EUej%E%E%E%E%E%Erci|]}|gSrr)rrs r z'Voice.group_by_lang..Js333t$333rc:i|]\}}|t|dS)c|jSrname)xs rz0Voice.group_by_lang...Ms16r)key)sorted)rr)values rr"z'Voice.group_by_lang..Ms/\\\zsE#ve)9)9:::\\\r)r*listsetrritems)r sorted_langrrs r group_by_langzVoice.group_by_langBs IT#%E%Ef%E%E%E"E"EFFGG 33{333 - -E 5:  % %e , , , ,\\V\\^^\\\ rN)__name__ __module__ __qualname____doc__paramBooleanrStringr local_servicer& voice_uri staticmethodrr0rrrr r semT5?@AAAG 5<,O P P PD"EM46()))M 5<,D E E ED d1#$$$I\  \   rr cBeZdZdZejddZejddZej ddd Z ej dd d Z ejd Z ej ddd Z fdZddZdZejdddZxZS) Utterancez An *utterance* is the smallest unit of speech in spoken language analysis. The Utterance Model wraps the HTML5 SpeechSynthesisUtterance API See https://developer.mozilla.org/en-US/docs/Web/API/SpeechSynthesisUtterance z The text that will be synthesised when the utterance is spoken. The text may be provided as plain text, or a well-formed SSML document.rrz' The language of the utterance.?)g@zj The pitch at which the utterance will be spoken at expressed as a number between 0 and 2.)rboundsr)g?g$@zm The speed at which the utterance will be spoken at expressed as a number between 0.1 and 10.z< The voice that will be used to speak the utterance.r)r@r?zg The volume that the utterance will be spoken at expressed as a number between 0 and 1.c |dg}tjdi|i|_||dS)Nrr)popsuper__init___voices_by_language set_voices)selfparamsr __class__s rrFzUtterance.__init__qsSHb))""6"""#%  rTc|j|j|j|j|jd}|jr|jjr|jj|d<|r#ttj |d<|S)znReturns the object parameter values in a dictionary Returns: Dict: [description] )rpitchratetextvolumeruuid) rrMrNr+rPrr&strrQuuid4)rI include_uuidrs rto_dictzUtterance.to_dictwsqIZIJk    : .$*/ ."joF7O  / ..F6N rc|s,dg|jj_d|jj_d|_dSt||_t|j|jj_d|jvrd}n,t|jd}||jj_||_|j ddS)zCUpdates the `lang` and `voice` parameter objects, default and valuezen-USNrr) r5robjectsrr r0rGr,keystrigger)rIr default_langs rrHzUtterance.set_voicess '.iDJO #&-DJO #DI F#(#6#6v#>#> "&t'?'D'D'F'F"G"G  d. . ."LL 8 = = ? ?@@CL".    6"""""rrwatchcJ|jr|js+d|jj_d|_g|jj_dS|j|j}|jr|j|vr|j}n|d}|D] }|jr|} ||jj_||jj_||_dS)Nr)rGrr5rrrW)rIr default_voicers r_handle_lang_changedzUtterance._handle_lang_changeds' ty '+DJ  $DJ')DJ  $ F)$)4 : *$*.. JMM"1IM * *=*$)M#)  #0  " r)T)r1r2r3r4r5r7r+ObjectSelectorrNumberrMrNrrPrFrUrHdependsr_ __classcell__rKs@rr<r<Qsa EL*& ' ' 'E 5 1* + + +D ELZ>( ) ) )E 5<K>+ - - -D !E &? @ @ @EU\#j?#$$$F     &###$U]6&&&##'&#####rr<c eZdZUdZejddZejdZejdZ ejdZ ejdd Z ejdd Z ejd Z ejdd Zejdd ZejZdddddddddddd Zded<eZded<fdZejdddZddZdZxZS)r a9 The `TextToSpeech` widget wraps the HTML5 SpeechSynthesis API See https://developer.mozilla.org/en-US/docs/Web/API/SpeechSynthesis Reference: https://panel.holoviz.org/reference/widgets/TextToSpeech.html :Example: >>> TextToSpeech(name="Speech Synthesis", value="Data apps are nice") TzF Whether or not to automatically speak when the value changes.r>z9 Removes all utterances from the utterance queue.rBz9 Puts the TextToSpeak object into a paused state.zj Puts the TextToSpeak object into a non-paused state: resumes it if it was already paused.z\ A Boolean that returns true if the TextToSpeak object is in a paused state.)readonlyrzh A Boolean that returns true if the utterance queue contains as-yet-unspoken utterances.z8 Speak. I.e. send a new Utterance to the browseru A Boolean that returns true if an utterance is currently in the process of being spoken — even if TextToSpeak is in a paused state.zm Returns a list of Voice objects representing all the available voices on the current device.Nr) auto_speakrr&rMrNspeakr+rrrP_voicesz"ClassVar[Mapping[str, str | None]]_renamezClassVar[Type[Model]] _widget_typec|dp d|vo|j}t|}|r||d<|S)Nrhr+)getrgrE_process_param_changerU)rImsgrhrKs rrnz"TextToSpeech._process_param_changesY  HW^%Ggg++C00  *<<>>CL rrir[cg}|jD]#}tdi|}||$||_||jdS)Nr)rir rrrH)rIrrrs r_update_voiceszTextToSpeech._update_voicess]l ! !FOOFOOE MM%    $$$$$rcd|jdSNzTextToSpeech(name=)r%)rIdepths r__repr__zTextToSpeech.__repr__s3DI2222rcd|jdSrsr%)rIs r__str__zTextToSpeech.__str__s2DI2222rr)r1r2r3r4r5r6rgEventcancelpauseresumepausedpendingrhspeakingListrrirj__annotations___BkTextToSpeechrkrnrbrqrvrxrcrds@rr r s  t2IJJJJU[<===F EK< = = =EU[()))FU]D/FemT0'(((G EK; < < rsU#"""""  CCCCCC"!!!!!!22222E 222j^#^#^#^#^##^#^#^#BN3N3N3N3N39fN3N3N3N3N3r