+ 7*iScshRt^RIt^RIt^RIHtHt^RIHtHtH t H t H t ^RI H t HtHt^RIHt^RIHt^RIHt^RIHt^R IHt] ]]]]3,]]]]]3,3,t] ]]3,t ] ]]]]3,]]]]]3,3,t!!R R 4t"R t#R t$Rt%Rt&Rt'Rt(Rt)R]# ]$ ]# ]$ ]# R]$ ]% R2 t*R]& ]$ ]' ]$ ]' R]$ ]% R2 t+R]# R]# R]# R]% R2 t,R]& R]' R]' R]% R2 t-RUu0uFp]!V^,^4kK upt.^]P^,t0]!R]R7!RR]Pb44t2RRlt3R R!lt4RR"R#llt5RR$R%llt6R&R'lt7RR(R)llt8R*R+lt9/R,RbR-RbR.RbR/RbR0RbR1RbR2RbR3RbR4RbR5RbR6RbR7RbR8RbR9RbR:RbR;RbRRbR?RbR@RbRARbRBRbRCRbRDRbRERbRFRbRGRbRHRbRIRbRJRbRKRbRLRbRMRbC/RNRbRORbRPRbRQRbRRRbRSRbRTRbRURbRVRbRWRbRXRbRYRbRZRbR[RbR\RbR]RbR^RbC/R_RbR`RbRaRbRbRbRcRbRdRbReRbRfRbRgRbRhRbRiRbRjRbRkRbRlRbRmRbRnRbRoRbC/RpERbRqERbRrERbRsERbRtERbRuERbRvERbRwERbRxERbRyERbRzER bR{ER bR|ER bR}ER bR~ER bRER bRERbC/RRbRERbRERbRERbRERbRERbRERbRERbRERbRERbRERbRERbRERbRERbRERbRERbRERbC/RERbRER bRER!bRER"bRER#bRER$bRER%bRER&bRER'bRER(bRER)bRER*bRER+bRER,bRER-bRER.bRER/bC/RER0bRER1bRER2bRER3bRER4bRER5bRER6bRER7bRER8bRER9bRER:bRER;bRERbRER?bCRER@RERARERBRERCRERDRERERERFRERGRERHRERIRERJ/ Ct:]:Pw4UUu/uFwrW!bK upptr!&roriginalZColor.originalls ~~rfallbackFc&<V^8dQhRS[RS[/#)rrJr$)boolr<rrrrr6ps!!D!S!rc sNVPPfC\\\\\3,VP 44p\ V,#VP4# \d/pT'dTP4uRp?#\R4ThRp?ii;i)aReturns the name of the color if it can be found in `COLORS_BY_VALUE` dictionary, otherwise returns the hexadecimal representation of the color or raises `ValueError`. Args: fallback: If True, falls back to returning the hexadecimal representation of the color instead of raising a ValueError when no named color is found. Returns: The name of the color, or the hexadecimal representation of the color. Raises: ValueError: When no named color is found and fallback is `False`. Nz=no named color found, use fallback=True, as_hex() or as_rgb()) r;rrr9int as_rgb_tupleCOLORS_BY_VALUEKeyErroras_hex ValueError)r!rJrgbZes&$ ras_namedZColor.as_namedps ::   #uS#s]+T->->-@AC m&s++;;=  m;;=($%dekll  ms$ A++ B$6B B$ BB$crErFr<rrrrr6src  saVPR,Uu.uFp\V4NK ppVPPe/VP\VPP44RP RV44o\ ;QJdRV4F 'dK RM RM !RV44'd0RP V3Rl\ ^\S4^444oRS,#uupi) a+Returns the hexadecimal representation of the color. Hex string representing the color can be 3, 4, 6, or 8 characters depending on whether the string a "short" representation of the color is possible and whether there's an alpha channel. Returns: The hexadecimal representation of the color. NiNZc3s("TFqR xK R#5i)Z02xN.0v& r Color.as_hex..s4Vc7Vsc3s2"TF q\9xK R#5ir) repeat_colorsrYcr[rr\r]s26aM!6sFTc3s6<"TFpSV,xK R#5irrW)rYr`rQs& rr\r]sI0H1VAYY0HsZ#)r; float_to_255rZappendZjoinZallZrangelen)r!r`ZvaluesrQs& @rrQZ Color.as_hexs,0::b>:>a,q/>: ::   ' MM,tzz'7'78 94V44 3262333262 2 2WWIaVa0HIIFV|;sC=crErFrUrrrrr6src  sVPPfdR\VPP4 R\VPP4 R\VPP 4 R2#R\VPP4 R\VPP4 R\VPP 4 R\ VP4^4 R2 #)zFColor as an `rgb(, , )` or `rgba(, , , )` string.zrgb(, )zrgba()r;rrarrrround _alpha_floatrGrHras_rgbZ Color.as_rgbs ::   #,tzz||45R TZZ\\8R7SSUVbcgcmcmcocoVpUqqrs s TZZ\\232l4::<<6P5QQST`aeakakamamTnSooq**,a014 rrNc6<V^8dQhRS[S[,RS[/#rrr$)rrL ColorTuplerrrrr6sXd^zrc sRVPR,4wr#pVf/VPPfW#V3#W#W@P43#V'dW#W@P43#W#V3#)aReturns the color as an RGB or RGBA tuple. Args: alpha: Whether to include the alpha channel. There are three options for this input: - `None` (default): Include alpha only if it's set. (e.g. not `None`) - `True`: Always include alpha. - `False`: Always omit alpha. Returns: A tuple that contains the values of the red, green, and blue channels in the range 0 to 255. If alpha is included, it is in the range 0 to 1. c38"TFp\V4xK R#5ir)rar_r[rr\Z%Color.as_rgb_tuple..s;Nq<??NrV)r;rrf)r!rrrr&$ rrNZColor.as_rgb_tuplesn, , )` or `hsl(, , , )` string.F)rzhsl(hz0.0frcz0.0%rdT)r;r as_hsl_tuplere)r!hsZlias& ras_hslZ Color.as_hsls ::   #((u(5HA"!c'$r!DBt9A> >++$+7KA"!c'$r!DBt9BuQ{m1M Mrcrhri)rrL HslColorTuplerrrrr6sXd^}rc s:\VPPVPPVPP4wr#pVf/VPP fW$V3#W$W0P 43#V'dW$W0P 43#W$V3#)aReturns the color as an HSL or HSLA tuple. Args: alpha: Whether to include the alpha channel. - `None` (default): Include the alpha channel only if it's set (e.g. not `None`). - `True`: Always include alpha. - `False`: Always omit alpha. Returns: The color as a tuple of hue, saturation, lightness, and alpha (if included). All elements are in the range 0 to 1. Note: This is HSL as used in HTML and most other places, not HLS as used in Python's `colorsys`. )rr;rrrrrf)r!rrpZlrqrmrroZColor.as_hsl_tuples"TZZ\\4::<<Fa =zz'QwQ 1 1 333 --// /7NrcrErF)rrrrrr6sCCeCrcsbVPPf^#VPP#r)r;rrGrHrrfZColor._alpha_floats&JJ$$,qB$**2B2BBrcsh<V^8dQhRS[S[,RS[S[.S[3,RS[P/#)rsourcer?r$)rBrrrr rrrrr6s;  #Y )13%2C)D    rcsl\P!VP\P!4R7#))Z serialization)r Z"with_info_plain_validator_function _validateZto_string_ser_schema)rCrur?&&&r__get_pydantic_core_schema__Z"Color.__get_pydantic_core_schema__s)== MM)I)I)K  rcs*<V^8dQhRS[RS[RR/#)r_Color__input_value_r$r2r%rrrrr6s"""c"c"g"rcsV!V4#rrW)rCryrzrwrrvZColor._validates =!!rcrErFrUrrrrr6s,,,rcs&VPRR7#)TrJ)rTrGrHr__str__Z Color.__str__s}}d}++rcs<V^8dQhRR/#)rr$z_repr.ReprArgsrWrrrrr6sWW/Wrcs\RVPRR73.RVP43.,#)NTr{rS)rTrNrGrHr __repr_args__ZColor.__repr_args__s1t}}d}345%ARARAT9U8VVVrcrK)rotherr$)rrLrrrrr6sXXCXDXrcst\V\4;'d"VP4VP48H#r)r8r2rN)r!r~r&r__eq__Z Color.__eq__s.%'WWD,=,=,?5CUCUCW,WWrcrErFrMrrrrr6s))#)rcs4\VP44#r)ZhashrNrGrHr__hash__ZColor.__hash__sD%%'((r)r>r;)r(r)r*r+r,r-r"Z classmethodrDrIrTrQrgrNrsrorfrxrvr|r}rrr.r/r0r1rr2r2Hs $I$!5!!4$d4NNd:CC  "",,WWXX))rr2csJV^8dQhR\\R3,R\/#)rr3.r$)r9rrr"rrrs&oouS#Xo4orc s\V4^8XdRV4wrp\WVR4#\V4^8Xd1RVR,4wrp\WV\V^,44#\RR4h)zParse a tuple or list to get RGBA values. Args: value: A tuple or list. Returns: An `RGBA` tuple parsed from the input tuple. Raises: PydanticCustomError: If tuple is not valid. c3rkrparse_color_valuerXr[rr\parse_tuple..s7A$Q''rlNc3rkrrrXr[rr\rs;A$Q''rlrVr7z:value is not a valid color: tuples must have length 3 or 4)rbrparse_float_alphar)r3rrrs& rr:r:sp 5zQ77aA!T"" Uq;r;aA!.uQx899!-1mnnrc0V^8dQhR\R\/#)rr3r$)r<rrrrrrs8s8sS8sT8srcsVP4p\V,wr#p\W#VR4# \dMi;i\P !\ T4pT'dPTP4EvrgRT4wr#pT'd\T^,^4^, pMRp\Y#YH4#\P !\T4pT'dITP4EvrgRT4wr#pT'd\T^4^, pMRp\Y#YH4#\P !\T4;'g\P !\T4pT'd\TP4!#\P !\T4;'g\P !\T4pT'd\TP4!#\RR4h)aParse a string representing a color to an RGBA tuple. Possible formats for the input string include: * named color, see `COLORS_BY_NAME` * hex short eg. `fff` (prefix can be `#`, `0x` or nothing) * hex long eg. `ffffff` (prefix can be `#`, `0x` or nothing) * `rgb(, , )` * `rgba(, , , )` Args: value: A string representing a color. Returns: An `RGBA` tuple parsed from the input string. Raises: ValueError: If the input string cannot be parsed to an RGBA tuple. Nc3sH"TFp\V^,^4xK R#5i)rNrrXr[rr\parse_str..7s/3a3q1ub>>3s "c3s:"TFp\V^4xK R#5i)iNrrXr[rr\rAs+s!3q"::ssr7zBvalue is not a valid color: string not recognised as a valid color)ZlowerCOLORS_BY_NAME ints_to_rgbarPreZ fullmatch r_hex_shortZgroupsrM r_hex_longr_rgbr_rgb_v4_styler_hslr_hsl_v4_style parse_hslr) r3Z value_lowerrrrZmrSrrrs & rr=r=so(++-K+ -aA!T**    [+.A((*/3/a %(Q^c%9EEA!++ Z-A((*+s+a 2J$EEA!++ UK(UUBLL,UAQXXZ(( UK(UUBLL,UA!((*%% m-q rrs / ==c sV^8dQhR\\\3,R\\\3,R\\\3,R\\,R\ /#)rrrrrr$)rrMr<rrrrrrrrSsV l lE#s(O lc3h lE#s(O lT\]bTc los lrcsf\\V4\V4\V4\V44#)aConverts integer or string values for RGB color and an optional alpha value to an `RGBA` object. Args: r: An integer or string representing the red color value. g: An integer or string representing the green color value. b: An integer or string representing the blue color value. alpha: A float representing the alpha value. Defaults to None. Returns: An instance of the `RGBA` class with the corresponding color and alpha values. )rrr)rrrrs&&&&rrrSs. !!$&7&:Parse an alpha value checking it's a valid float in the range 0 to 1. Args: value: The input value to parse. Returns: The parsed value as a float, or `None` if the value was None or equal 1. Raises: PydanticCustomError: If the input value cannot be successfully parsed as a float in the expected range. NZ%r7z>value is not a valid color: alpha values must be a valid floatzDvalue is not a valid color: alpha values must be in the range 0 to 1i)r8r<ZendswithrrRrmathZisclose)r3rr[rrr}s }s eS ! !ennS&9&9%*%+E%LE ||E1 eq  "-1wxx s!-1qrrss,BB BB-c svV^8dQhR\R\R\R\R\\,R\/#)rrph_unitssatlightrr$)r<rrrrrrrrs;333s33S3%3\`3rcs\V^d4\V^d4re\V4pVR9dVR,R, pM)VR8XdV\,\, pM V^,p\WvV4wrp \ WV \ V44#)a Parse raw hue, saturation, lightness, and alpha values and convert to RGBA. Args: h: The hue value. h_units: The unit for hue value. sat: The saturation value. light: The lightness value. alpha: Alpha value. Returns: An instance of `RGBA`. rnZrad>NZdeg)rrradsrrr) rprrrrZs_valueZl_valueZh_valuerrrs &&&&& rrrs)c24EeS4QWAhG-C-#% E D.4'A+73GA! a*51 22rcr)rr`r$)rrMrrrrrs  E c rcs8\\V^,44#)aConverts a float value between 0 and 1 (inclusive) to an integer between 0 and 255 (inclusive). Args: c: The float value to be converted. Must be between 0 and 1 (inclusive). Returns: The integer equivalent of the given float value rounded to the nearest whole number. Raises: ValueError: If the given float value is outside the acceptable range of 0 to 1 (inclusive). )rMre)r`rHrraras uQW~ rZ aliceblueZ antiquewhiteZaquaZ aquamarineZazureZbeigeZbisqueZblackZblanchedalmondZblueZ bluevioletZbrownZ burlywoodZ cadetblueZ chartreuseZ chocolateZcoralZcornflowerblueZcornsilkZcrimsonZcyanZdarkblueZdarkcyanZ darkgoldenrodZdarkgrayZ darkgreenZdarkgreyZ darkkhakiZ darkmagentaZdarkolivegreenZ darkorangeZ darkorchidZdarkredZ darksalmonZ darkseagreenZ darkslateblueZ darkslategrayZ darkslategreyZ darkturquoiseZ darkvioletZdeeppinkZ deepskyblueZdimgrayZdimgreyZ dodgerblueZ firebrickZ floralwhiteZ forestgreenZfuchsiaZ gainsboroZ ghostwhiteZgoldZ goldenrodZgrayZgreenZ greenyellowZgreyZhoneydewZhotpinkZ indianredZindigoZivoryZkhakiZlavenderZ lavenderblushZ lawngreenZ lemonchiffonZ lightblueZ lightcoralZ lightcyanZlightgoldenrodyellowZ lightgrayZ lightgreenZ lightgreyZ lightpinkZ lightsalmonZ lightseagreenZ lightskyblueZlightslategrayZlightslategreyZlightsteelblueZ lightyellowZlimeZ limegreenZlinenZmagentaZmaroonZmediumaquamarineZ mediumblueZ mediumorchidZ mediumpurpleZmediumseagreenZmediumslateblueZmediumspringgreenZmediumturquoiseZmediumvioletredZ midnightblueZ mintcreamZ mistyroseZmoccasinZ navajowhiteZnavyZoldlaceZoliveZ olivedrabZorangeZ orangeredZorchidZ palegoldenrodZ palegreenZ paleturquoiseZ palevioletredZ papayawhipZ peachpuffZperuZpinkZplumZ powderblueZpurpleZredZ rosybrownZ royalblueZ saddlebrownZsalmonZ sandybrownZseagreenZseashellZsiennaZsilverZskyblueZ slateblueZ slategrayZ slategreyZsnowZ springgreenZ steelblueZtanZtealZthistleZtomatoZ turquoiseZvioletZwheatZwhiteZ whitesmokeZyellowZ yellowgreenr))r))rr)ri)rrr)r)r)rrr)rr)rrr)ii+i)*r))i_i)rrr)i)rriP)dii)rrr)r<)rr)rrr)rii )rr)rrr)iik)rrr)Ur/)rr)2)rrr)iiz)r)Hi=r)rOr)r)ir)rr)rr)rrr)rr)"r)rrr)rrr)rrr)rrr)rrr)rrr)r )rr)rrr)rr)rrr)rr)r\r)iKr)rrr)rr)rrr)rrr)i|ir)rrr)rr)rrr)rr)rrr)rrr)rr)rii)rrr)rr)rrr)iwir)rr)rrr)rrr)rrr)rrr)rrr)ifrr)rrr)irr)rp)riq)i{ihr)rr)rrr)ii)rr)rrr)rr)rri)rrr)rrr)irr)rrr)rii#)rrr)rEr)rri)rir)ir)irr)rrr)rii)rri)rri?)ri)rr)rrr)rrr)rrr)rrr)iArr)rri)rrir)iii`)i.riW)rrr)riRi-)rrr)rrr)ijiZr)rrr)rrr)rrr)iFrr)rrr)rrr)rrr)riciG)i@ri)rrr)rrr)rrr)rrr)rrr)rrr)=r,rrZcolorsysrrZtypingrrrrrZ pydantic_corerrr Ztyping_extensionsr Z _internalr Z#_internal._schema_generation_sharedr r@Z json_schemar Zwarningsrr9rMrrjr<r5rtrZ_r_255Z_r_commaZ_r_alphaZ_r_hZ_r_slrrrrrrr^ZpirZRepresentationr2r:r=rrrrrarZitemsrO)r`ZkrZs000rrs   +77FF(^(/ 5c3'sCe/C)DD E *c/ " eE5%/0%ueU8R2SST !!$   +2I T  6(8*VHCzRZQ[[ef xjz%H:hZWab!&VHCxz(S]^!$s5'UG:hZzZ*<<);AQUB);< 477{ L & r)E r)  r)jo,8sv l 6y<38 TTOT MT/ T  _ T  _ T oT YToT KT.T ]TTT-T !T" ^#T$o%T&'T(})T* M+T, -T. /T0^1T23T45T67T89T:=;T<m=T>-?T@.ATB{CTD/ETFOGTH]ITJ\KTL\MTN]OTP-QTRSTT=UTVWTXYTZ.[T\]T^?_T`=aTb}cTdeTf/gTh MiTjkTl OmTn [oTp>qTr OsTtuTvwTxyTz l{T| _}T~ _T@ATB_CTDETFOGTHITJ/KTLMTNOOTPQTR/STTUTVWTX?YTZ^[T\O]T^o_T`oaTbocTd?eTf KgThiTj _kTl}mTn koTpqTr+sTtNuTvOwTxnyTz{T|}T~~T@~ATBMCTDETFGTHITJ?KTL KMTNOTP ]QTRSTT mUTVWTX oYTZ_[T\]T^__T`_aTb/cTdeTf NgTh OiTj OkTl/mTn moTp ;qTrsTtuTv=wTx oyTz.{T| }T~T@ mATB oCTDETFGTHITJKTL OMTN=OTPQTR ? M  m o _ _/ m>gTl%3$8$8$:;$:DA14$:;q=p