mirror of
https://github.com/acamarata/qibla.git
synced 2026-06-30 19:04:28 +00:00
553 lines
No EOL
21 KiB
HTML
553 lines
No EOL
21 KiB
HTML
|
|
<!doctype html>
|
|
<html lang="en">
|
|
|
|
<head>
|
|
<title>Code coverage report for index.ts</title>
|
|
<meta charset="utf-8" />
|
|
<link rel="stylesheet" href="prettify.css" />
|
|
<link rel="stylesheet" href="base.css" />
|
|
<link rel="shortcut icon" type="image/x-icon" href="favicon.png" />
|
|
<meta name="viewport" content="width=device-width, initial-scale=1" />
|
|
<style type='text/css'>
|
|
.coverage-summary .sorter {
|
|
background-image: url(sort-arrow-sprite.png);
|
|
}
|
|
</style>
|
|
</head>
|
|
|
|
<body>
|
|
<div class='wrapper'>
|
|
<div class='pad1'>
|
|
<h1><a href="index.html">All files</a> index.ts</h1>
|
|
<div class='clearfix'>
|
|
|
|
<div class='fl pad1y space-right2'>
|
|
<span class="strong">100% </span>
|
|
<span class="quiet">Statements</span>
|
|
<span class='fraction'>156/156</span>
|
|
</div>
|
|
|
|
|
|
<div class='fl pad1y space-right2'>
|
|
<span class="strong">100% </span>
|
|
<span class="quiet">Branches</span>
|
|
<span class='fraction'>19/19</span>
|
|
</div>
|
|
|
|
|
|
<div class='fl pad1y space-right2'>
|
|
<span class="strong">100% </span>
|
|
<span class="quiet">Functions</span>
|
|
<span class='fraction'>5/5</span>
|
|
</div>
|
|
|
|
|
|
<div class='fl pad1y space-right2'>
|
|
<span class="strong">100% </span>
|
|
<span class="quiet">Lines</span>
|
|
<span class='fraction'>156/156</span>
|
|
</div>
|
|
|
|
|
|
</div>
|
|
<p class="quiet">
|
|
Press <em>n</em> or <em>j</em> to go to the next uncovered block, <em>b</em>, <em>p</em> or <em>k</em> for the previous block.
|
|
</p>
|
|
<template id="filterTemplate">
|
|
<div class="quiet">
|
|
Filter:
|
|
<input type="search" id="fileSearch">
|
|
</div>
|
|
</template>
|
|
</div>
|
|
<div class='status-line high'></div>
|
|
<pre><table class="coverage">
|
|
<tr><td class="line-count quiet"><a name='L1'></a><a href='#L1'>1</a>
|
|
<a name='L2'></a><a href='#L2'>2</a>
|
|
<a name='L3'></a><a href='#L3'>3</a>
|
|
<a name='L4'></a><a href='#L4'>4</a>
|
|
<a name='L5'></a><a href='#L5'>5</a>
|
|
<a name='L6'></a><a href='#L6'>6</a>
|
|
<a name='L7'></a><a href='#L7'>7</a>
|
|
<a name='L8'></a><a href='#L8'>8</a>
|
|
<a name='L9'></a><a href='#L9'>9</a>
|
|
<a name='L10'></a><a href='#L10'>10</a>
|
|
<a name='L11'></a><a href='#L11'>11</a>
|
|
<a name='L12'></a><a href='#L12'>12</a>
|
|
<a name='L13'></a><a href='#L13'>13</a>
|
|
<a name='L14'></a><a href='#L14'>14</a>
|
|
<a name='L15'></a><a href='#L15'>15</a>
|
|
<a name='L16'></a><a href='#L16'>16</a>
|
|
<a name='L17'></a><a href='#L17'>17</a>
|
|
<a name='L18'></a><a href='#L18'>18</a>
|
|
<a name='L19'></a><a href='#L19'>19</a>
|
|
<a name='L20'></a><a href='#L20'>20</a>
|
|
<a name='L21'></a><a href='#L21'>21</a>
|
|
<a name='L22'></a><a href='#L22'>22</a>
|
|
<a name='L23'></a><a href='#L23'>23</a>
|
|
<a name='L24'></a><a href='#L24'>24</a>
|
|
<a name='L25'></a><a href='#L25'>25</a>
|
|
<a name='L26'></a><a href='#L26'>26</a>
|
|
<a name='L27'></a><a href='#L27'>27</a>
|
|
<a name='L28'></a><a href='#L28'>28</a>
|
|
<a name='L29'></a><a href='#L29'>29</a>
|
|
<a name='L30'></a><a href='#L30'>30</a>
|
|
<a name='L31'></a><a href='#L31'>31</a>
|
|
<a name='L32'></a><a href='#L32'>32</a>
|
|
<a name='L33'></a><a href='#L33'>33</a>
|
|
<a name='L34'></a><a href='#L34'>34</a>
|
|
<a name='L35'></a><a href='#L35'>35</a>
|
|
<a name='L36'></a><a href='#L36'>36</a>
|
|
<a name='L37'></a><a href='#L37'>37</a>
|
|
<a name='L38'></a><a href='#L38'>38</a>
|
|
<a name='L39'></a><a href='#L39'>39</a>
|
|
<a name='L40'></a><a href='#L40'>40</a>
|
|
<a name='L41'></a><a href='#L41'>41</a>
|
|
<a name='L42'></a><a href='#L42'>42</a>
|
|
<a name='L43'></a><a href='#L43'>43</a>
|
|
<a name='L44'></a><a href='#L44'>44</a>
|
|
<a name='L45'></a><a href='#L45'>45</a>
|
|
<a name='L46'></a><a href='#L46'>46</a>
|
|
<a name='L47'></a><a href='#L47'>47</a>
|
|
<a name='L48'></a><a href='#L48'>48</a>
|
|
<a name='L49'></a><a href='#L49'>49</a>
|
|
<a name='L50'></a><a href='#L50'>50</a>
|
|
<a name='L51'></a><a href='#L51'>51</a>
|
|
<a name='L52'></a><a href='#L52'>52</a>
|
|
<a name='L53'></a><a href='#L53'>53</a>
|
|
<a name='L54'></a><a href='#L54'>54</a>
|
|
<a name='L55'></a><a href='#L55'>55</a>
|
|
<a name='L56'></a><a href='#L56'>56</a>
|
|
<a name='L57'></a><a href='#L57'>57</a>
|
|
<a name='L58'></a><a href='#L58'>58</a>
|
|
<a name='L59'></a><a href='#L59'>59</a>
|
|
<a name='L60'></a><a href='#L60'>60</a>
|
|
<a name='L61'></a><a href='#L61'>61</a>
|
|
<a name='L62'></a><a href='#L62'>62</a>
|
|
<a name='L63'></a><a href='#L63'>63</a>
|
|
<a name='L64'></a><a href='#L64'>64</a>
|
|
<a name='L65'></a><a href='#L65'>65</a>
|
|
<a name='L66'></a><a href='#L66'>66</a>
|
|
<a name='L67'></a><a href='#L67'>67</a>
|
|
<a name='L68'></a><a href='#L68'>68</a>
|
|
<a name='L69'></a><a href='#L69'>69</a>
|
|
<a name='L70'></a><a href='#L70'>70</a>
|
|
<a name='L71'></a><a href='#L71'>71</a>
|
|
<a name='L72'></a><a href='#L72'>72</a>
|
|
<a name='L73'></a><a href='#L73'>73</a>
|
|
<a name='L74'></a><a href='#L74'>74</a>
|
|
<a name='L75'></a><a href='#L75'>75</a>
|
|
<a name='L76'></a><a href='#L76'>76</a>
|
|
<a name='L77'></a><a href='#L77'>77</a>
|
|
<a name='L78'></a><a href='#L78'>78</a>
|
|
<a name='L79'></a><a href='#L79'>79</a>
|
|
<a name='L80'></a><a href='#L80'>80</a>
|
|
<a name='L81'></a><a href='#L81'>81</a>
|
|
<a name='L82'></a><a href='#L82'>82</a>
|
|
<a name='L83'></a><a href='#L83'>83</a>
|
|
<a name='L84'></a><a href='#L84'>84</a>
|
|
<a name='L85'></a><a href='#L85'>85</a>
|
|
<a name='L86'></a><a href='#L86'>86</a>
|
|
<a name='L87'></a><a href='#L87'>87</a>
|
|
<a name='L88'></a><a href='#L88'>88</a>
|
|
<a name='L89'></a><a href='#L89'>89</a>
|
|
<a name='L90'></a><a href='#L90'>90</a>
|
|
<a name='L91'></a><a href='#L91'>91</a>
|
|
<a name='L92'></a><a href='#L92'>92</a>
|
|
<a name='L93'></a><a href='#L93'>93</a>
|
|
<a name='L94'></a><a href='#L94'>94</a>
|
|
<a name='L95'></a><a href='#L95'>95</a>
|
|
<a name='L96'></a><a href='#L96'>96</a>
|
|
<a name='L97'></a><a href='#L97'>97</a>
|
|
<a name='L98'></a><a href='#L98'>98</a>
|
|
<a name='L99'></a><a href='#L99'>99</a>
|
|
<a name='L100'></a><a href='#L100'>100</a>
|
|
<a name='L101'></a><a href='#L101'>101</a>
|
|
<a name='L102'></a><a href='#L102'>102</a>
|
|
<a name='L103'></a><a href='#L103'>103</a>
|
|
<a name='L104'></a><a href='#L104'>104</a>
|
|
<a name='L105'></a><a href='#L105'>105</a>
|
|
<a name='L106'></a><a href='#L106'>106</a>
|
|
<a name='L107'></a><a href='#L107'>107</a>
|
|
<a name='L108'></a><a href='#L108'>108</a>
|
|
<a name='L109'></a><a href='#L109'>109</a>
|
|
<a name='L110'></a><a href='#L110'>110</a>
|
|
<a name='L111'></a><a href='#L111'>111</a>
|
|
<a name='L112'></a><a href='#L112'>112</a>
|
|
<a name='L113'></a><a href='#L113'>113</a>
|
|
<a name='L114'></a><a href='#L114'>114</a>
|
|
<a name='L115'></a><a href='#L115'>115</a>
|
|
<a name='L116'></a><a href='#L116'>116</a>
|
|
<a name='L117'></a><a href='#L117'>117</a>
|
|
<a name='L118'></a><a href='#L118'>118</a>
|
|
<a name='L119'></a><a href='#L119'>119</a>
|
|
<a name='L120'></a><a href='#L120'>120</a>
|
|
<a name='L121'></a><a href='#L121'>121</a>
|
|
<a name='L122'></a><a href='#L122'>122</a>
|
|
<a name='L123'></a><a href='#L123'>123</a>
|
|
<a name='L124'></a><a href='#L124'>124</a>
|
|
<a name='L125'></a><a href='#L125'>125</a>
|
|
<a name='L126'></a><a href='#L126'>126</a>
|
|
<a name='L127'></a><a href='#L127'>127</a>
|
|
<a name='L128'></a><a href='#L128'>128</a>
|
|
<a name='L129'></a><a href='#L129'>129</a>
|
|
<a name='L130'></a><a href='#L130'>130</a>
|
|
<a name='L131'></a><a href='#L131'>131</a>
|
|
<a name='L132'></a><a href='#L132'>132</a>
|
|
<a name='L133'></a><a href='#L133'>133</a>
|
|
<a name='L134'></a><a href='#L134'>134</a>
|
|
<a name='L135'></a><a href='#L135'>135</a>
|
|
<a name='L136'></a><a href='#L136'>136</a>
|
|
<a name='L137'></a><a href='#L137'>137</a>
|
|
<a name='L138'></a><a href='#L138'>138</a>
|
|
<a name='L139'></a><a href='#L139'>139</a>
|
|
<a name='L140'></a><a href='#L140'>140</a>
|
|
<a name='L141'></a><a href='#L141'>141</a>
|
|
<a name='L142'></a><a href='#L142'>142</a>
|
|
<a name='L143'></a><a href='#L143'>143</a>
|
|
<a name='L144'></a><a href='#L144'>144</a>
|
|
<a name='L145'></a><a href='#L145'>145</a>
|
|
<a name='L146'></a><a href='#L146'>146</a>
|
|
<a name='L147'></a><a href='#L147'>147</a>
|
|
<a name='L148'></a><a href='#L148'>148</a>
|
|
<a name='L149'></a><a href='#L149'>149</a>
|
|
<a name='L150'></a><a href='#L150'>150</a>
|
|
<a name='L151'></a><a href='#L151'>151</a>
|
|
<a name='L152'></a><a href='#L152'>152</a>
|
|
<a name='L153'></a><a href='#L153'>153</a>
|
|
<a name='L154'></a><a href='#L154'>154</a>
|
|
<a name='L155'></a><a href='#L155'>155</a>
|
|
<a name='L156'></a><a href='#L156'>156</a>
|
|
<a name='L157'></a><a href='#L157'>157</a></td><td class="line-coverage quiet"><span class="cline-any cline-yes">1x</span>
|
|
<span class="cline-any cline-yes">1x</span>
|
|
<span class="cline-any cline-yes">1x</span>
|
|
<span class="cline-any cline-yes">1x</span>
|
|
<span class="cline-any cline-yes">1x</span>
|
|
<span class="cline-any cline-yes">1x</span>
|
|
<span class="cline-any cline-yes">1x</span>
|
|
<span class="cline-any cline-yes">1x</span>
|
|
<span class="cline-any cline-yes">1x</span>
|
|
<span class="cline-any cline-yes">1x</span>
|
|
<span class="cline-any cline-yes">1x</span>
|
|
<span class="cline-any cline-yes">1x</span>
|
|
<span class="cline-any cline-yes">1x</span>
|
|
<span class="cline-any cline-yes">1x</span>
|
|
<span class="cline-any cline-yes">1x</span>
|
|
<span class="cline-any cline-yes">1x</span>
|
|
<span class="cline-any cline-yes">1x</span>
|
|
<span class="cline-any cline-yes">1x</span>
|
|
<span class="cline-any cline-yes">1x</span>
|
|
<span class="cline-any cline-yes">1x</span>
|
|
<span class="cline-any cline-yes">1x</span>
|
|
<span class="cline-any cline-yes">1x</span>
|
|
<span class="cline-any cline-yes">1x</span>
|
|
<span class="cline-any cline-yes">1x</span>
|
|
<span class="cline-any cline-yes">1x</span>
|
|
<span class="cline-any cline-yes">1x</span>
|
|
<span class="cline-any cline-yes">1x</span>
|
|
<span class="cline-any cline-yes">1x</span>
|
|
<span class="cline-any cline-yes">1x</span>
|
|
<span class="cline-any cline-yes">1x</span>
|
|
<span class="cline-any cline-yes">1x</span>
|
|
<span class="cline-any cline-yes">1x</span>
|
|
<span class="cline-any cline-yes">1x</span>
|
|
<span class="cline-any cline-yes">1x</span>
|
|
<span class="cline-any cline-yes">1x</span>
|
|
<span class="cline-any cline-yes">1x</span>
|
|
<span class="cline-any cline-yes">1x</span>
|
|
<span class="cline-any cline-yes">1x</span>
|
|
<span class="cline-any cline-yes">15x</span>
|
|
<span class="cline-any cline-yes">2x</span>
|
|
<span class="cline-any cline-yes">2x</span>
|
|
<span class="cline-any cline-yes">15x</span>
|
|
<span class="cline-any cline-yes">2x</span>
|
|
<span class="cline-any cline-yes">2x</span>
|
|
<span class="cline-any cline-yes">11x</span>
|
|
<span class="cline-any cline-yes">11x</span>
|
|
<span class="cline-any cline-yes">11x</span>
|
|
<span class="cline-any cline-yes">11x</span>
|
|
<span class="cline-any cline-yes">11x</span>
|
|
<span class="cline-any cline-yes">11x</span>
|
|
<span class="cline-any cline-yes">11x</span>
|
|
<span class="cline-any cline-yes">11x</span>
|
|
<span class="cline-any cline-yes">11x</span>
|
|
<span class="cline-any cline-yes">11x</span>
|
|
<span class="cline-any cline-yes">1x</span>
|
|
<span class="cline-any cline-yes">1x</span>
|
|
<span class="cline-any cline-yes">1x</span>
|
|
<span class="cline-any cline-yes">1x</span>
|
|
<span class="cline-any cline-yes">1x</span>
|
|
<span class="cline-any cline-yes">1x</span>
|
|
<span class="cline-any cline-yes">1x</span>
|
|
<span class="cline-any cline-yes">1x</span>
|
|
<span class="cline-any cline-yes">10x</span>
|
|
<span class="cline-any cline-yes">10x</span>
|
|
<span class="cline-any cline-yes">10x</span>
|
|
<span class="cline-any cline-yes">10x</span>
|
|
<span class="cline-any cline-yes">1x</span>
|
|
<span class="cline-any cline-yes">1x</span>
|
|
<span class="cline-any cline-yes">1x</span>
|
|
<span class="cline-any cline-yes">1x</span>
|
|
<span class="cline-any cline-yes">1x</span>
|
|
<span class="cline-any cline-yes">1x</span>
|
|
<span class="cline-any cline-yes">1x</span>
|
|
<span class="cline-any cline-yes">1x</span>
|
|
<span class="cline-any cline-yes">9x</span>
|
|
<span class="cline-any cline-yes">9x</span>
|
|
<span class="cline-any cline-yes">9x</span>
|
|
<span class="cline-any cline-yes">9x</span>
|
|
<span class="cline-any cline-yes">1x</span>
|
|
<span class="cline-any cline-yes">1x</span>
|
|
<span class="cline-any cline-yes">1x</span>
|
|
<span class="cline-any cline-yes">1x</span>
|
|
<span class="cline-any cline-yes">1x</span>
|
|
<span class="cline-any cline-yes">1x</span>
|
|
<span class="cline-any cline-yes">1x</span>
|
|
<span class="cline-any cline-yes">1x</span>
|
|
<span class="cline-any cline-yes">1x</span>
|
|
<span class="cline-any cline-yes">1x</span>
|
|
<span class="cline-any cline-yes">1x</span>
|
|
<span class="cline-any cline-yes">1x</span>
|
|
<span class="cline-any cline-yes">1x</span>
|
|
<span class="cline-any cline-yes">1x</span>
|
|
<span class="cline-any cline-yes">9x</span>
|
|
<span class="cline-any cline-yes">9x</span>
|
|
<span class="cline-any cline-yes">9x</span>
|
|
<span class="cline-any cline-yes">9x</span>
|
|
<span class="cline-any cline-yes">9x</span>
|
|
<span class="cline-any cline-yes">1x</span>
|
|
<span class="cline-any cline-yes">1x</span>
|
|
<span class="cline-any cline-yes">9x</span>
|
|
<span class="cline-any cline-yes">1x</span>
|
|
<span class="cline-any cline-yes">1x</span>
|
|
<span class="cline-any cline-yes">7x</span>
|
|
<span class="cline-any cline-yes">7x</span>
|
|
<span class="cline-any cline-yes">7x</span>
|
|
<span class="cline-any cline-yes">7x</span>
|
|
<span class="cline-any cline-yes">7x</span>
|
|
<span class="cline-any cline-yes">7x</span>
|
|
<span class="cline-any cline-yes">7x</span>
|
|
<span class="cline-any cline-yes">7x</span>
|
|
<span class="cline-any cline-yes">7x</span>
|
|
<span class="cline-any cline-yes">7x</span>
|
|
<span class="cline-any cline-yes">7x</span>
|
|
<span class="cline-any cline-yes">7x</span>
|
|
<span class="cline-any cline-yes">7x</span>
|
|
<span class="cline-any cline-yes">7x</span>
|
|
<span class="cline-any cline-yes">9x</span>
|
|
<span class="cline-any cline-yes">6x</span>
|
|
<span class="cline-any cline-yes">6x</span>
|
|
<span class="cline-any cline-yes">9x</span>
|
|
<span class="cline-any cline-yes">556x</span>
|
|
<span class="cline-any cline-yes">556x</span>
|
|
<span class="cline-any cline-yes">556x</span>
|
|
<span class="cline-any cline-yes">556x</span>
|
|
<span class="cline-any cline-yes">556x</span>
|
|
<span class="cline-any cline-yes">556x</span>
|
|
<span class="cline-any cline-yes">556x</span>
|
|
<span class="cline-any cline-yes">556x</span>
|
|
<span class="cline-any cline-yes">556x</span>
|
|
<span class="cline-any cline-yes">556x</span>
|
|
<span class="cline-any cline-yes">556x</span>
|
|
<span class="cline-any cline-yes">6x</span>
|
|
<span class="cline-any cline-yes">6x</span>
|
|
<span class="cline-any cline-yes">1x</span>
|
|
<span class="cline-any cline-yes">1x</span>
|
|
<span class="cline-any cline-yes">1x</span>
|
|
<span class="cline-any cline-yes">1x</span>
|
|
<span class="cline-any cline-yes">1x</span>
|
|
<span class="cline-any cline-yes">1x</span>
|
|
<span class="cline-any cline-yes">1x</span>
|
|
<span class="cline-any cline-yes">1x</span>
|
|
<span class="cline-any cline-yes">1x</span>
|
|
<span class="cline-any cline-yes">1x</span>
|
|
<span class="cline-any cline-yes">1x</span>
|
|
<span class="cline-any cline-yes">8x</span>
|
|
<span class="cline-any cline-yes">8x</span>
|
|
<span class="cline-any cline-yes">8x</span>
|
|
<span class="cline-any cline-yes">8x</span>
|
|
<span class="cline-any cline-yes">8x</span>
|
|
<span class="cline-any cline-yes">8x</span>
|
|
<span class="cline-any cline-yes">8x</span>
|
|
<span class="cline-any cline-yes">8x</span>
|
|
<span class="cline-any cline-yes">8x</span>
|
|
<span class="cline-any cline-yes">8x</span>
|
|
<span class="cline-any cline-yes">8x</span>
|
|
<span class="cline-any cline-yes">8x</span>
|
|
<span class="cline-any cline-neutral"> </span></td><td class="text"><pre class="prettyprint lang-js">/**
|
|
* Qibla direction utilities. Pure math, zero external dependencies.
|
|
*
|
|
* Computes the initial bearing (forward azimuth) from any point on Earth to
|
|
* the Ka'bah using the spherical law of cosines. Includes compass direction
|
|
* lookup, great-circle interpolation, and haversine distance.
|
|
*
|
|
* Ka'bah coordinates sourced from verified GPS data.
|
|
*
|
|
* @module
|
|
*/
|
|
|
|
export * from "./types.js";
|
|
|
|
import {
|
|
KAABA_LAT,
|
|
KAABA_LNG,
|
|
EARTH_RADIUS_KM,
|
|
COMPASS_ABBR,
|
|
COMPASS_NAMES,
|
|
type CompassAbbr,
|
|
type CompassName,
|
|
} from "./types.js";
|
|
|
|
const DEG = Math.PI / 180;
|
|
|
|
/**
|
|
* Qibla bearing in degrees clockwise from true north.
|
|
*
|
|
* Uses the forward azimuth formula from spherical trigonometry.
|
|
* Result range: [0, 360).
|
|
*
|
|
* @param lat - Observer latitude in decimal degrees (-90 to 90).
|
|
* @param lng - Observer longitude in decimal degrees (-180 to 180).
|
|
* @returns Bearing in degrees clockwise from north (0 = N, 90 = E, 180 = S, 270 = W).
|
|
* @throws {RangeError} If latitude is outside [-90, 90] or longitude outside [-180, 180].
|
|
*/
|
|
export function qiblaAngle(lat: number, lng: number): number {
|
|
if (lat < -90 || lat > 90) {
|
|
throw new RangeError(`Latitude must be between -90 and 90, got ${lat}`);
|
|
}
|
|
if (lng < -180 || lng > 180) {
|
|
throw new RangeError(`Longitude must be between -180 and 180, got ${lng}`);
|
|
}
|
|
const φ1 = lat * DEG,
|
|
λ1 = lng * DEG;
|
|
const φ2 = KAABA_LAT * DEG,
|
|
λ2 = KAABA_LNG * DEG;
|
|
const y = Math.sin(λ2 - λ1) * Math.cos(φ2);
|
|
const x =
|
|
Math.cos(φ1) * Math.sin(φ2) -
|
|
Math.sin(φ1) * Math.cos(φ2) * Math.cos(λ2 - λ1);
|
|
return (Math.atan2(y, x) / DEG + 360) % 360;
|
|
}
|
|
|
|
/**
|
|
* Eight-point compass abbreviation for a bearing.
|
|
*
|
|
* @param bearing - Bearing in degrees (0-360).
|
|
* @returns Two-letter compass abbreviation (N, NE, E, SE, S, SW, W, NW).
|
|
*/
|
|
export function compassDir(bearing: number): CompassAbbr {
|
|
// Non-null assertion: index is always 0-7 (Math.round(bearing/45) % 8), which is within COMPASS_ABBR bounds.
|
|
// eslint-disable-next-line @typescript-eslint/no-non-null-assertion
|
|
return COMPASS_ABBR[Math.round(bearing / 45) % 8]!;
|
|
}
|
|
|
|
/**
|
|
* Full compass direction name for a bearing.
|
|
*
|
|
* @param bearing - Bearing in degrees (0-360).
|
|
* @returns Full direction name (North, Northeast, etc.).
|
|
*/
|
|
export function compassName(bearing: number): CompassName {
|
|
// Non-null assertion: index is always 0-7 (Math.round(bearing/45) % 8), which is within COMPASS_NAMES bounds.
|
|
// eslint-disable-next-line @typescript-eslint/no-non-null-assertion
|
|
return COMPASS_NAMES[Math.round(bearing / 45) % 8]!;
|
|
}
|
|
|
|
/**
|
|
* Great-circle waypoints from [lat, lng] to the Ka'bah.
|
|
*
|
|
* Uses the Slerp (spherical linear interpolation) formula. Useful for
|
|
* drawing Qibla direction lines on maps.
|
|
*
|
|
* @param lat - Origin latitude in decimal degrees.
|
|
* @param lng - Origin longitude in decimal degrees.
|
|
* @param steps - Number of segments (default: 120, producing 121 points).
|
|
* @returns Array of [latitude, longitude] pairs in degrees.
|
|
* @throws {RangeError} If latitude is outside [-90, 90] or longitude outside [-180, 180].
|
|
*/
|
|
export function qiblaGreatCircle(
|
|
lat: number,
|
|
lng: number,
|
|
steps = 120,
|
|
): [number, number][] {
|
|
if (lat < -90 || lat > 90) {
|
|
throw new RangeError(`Latitude must be between -90 and 90, got ${lat}`);
|
|
}
|
|
if (lng < -180 || lng > 180) {
|
|
throw new RangeError(`Longitude must be between -180 and 180, got ${lng}`);
|
|
}
|
|
const φ1 = lat * DEG,
|
|
λ1 = lng * DEG;
|
|
const φ2 = KAABA_LAT * DEG,
|
|
λ2 = KAABA_LNG * DEG;
|
|
|
|
const d =
|
|
2 *
|
|
Math.asin(
|
|
Math.sqrt(
|
|
Math.sin((φ2 - φ1) / 2) ** 2 +
|
|
Math.cos(φ1) * Math.cos(φ2) * Math.sin((λ2 - λ1) / 2) ** 2,
|
|
),
|
|
);
|
|
|
|
if (d === 0) return [[lat, lng]];
|
|
|
|
const points: [number, number][] = [];
|
|
for (let i = 0; i <= steps; i++) {
|
|
const f = i / steps;
|
|
const A = Math.sin((1 - f) * d) / Math.sin(d);
|
|
const B = Math.sin(f * d) / Math.sin(d);
|
|
const x = A * Math.cos(φ1) * Math.cos(λ1) + B * Math.cos(φ2) * Math.cos(λ2);
|
|
const y = A * Math.cos(φ1) * Math.sin(λ1) + B * Math.cos(φ2) * Math.sin(λ2);
|
|
const z = A * Math.sin(φ1) + B * Math.sin(φ2);
|
|
points.push([
|
|
Math.atan2(z, Math.sqrt(x * x + y * y)) / DEG,
|
|
Math.atan2(y, x) / DEG,
|
|
]);
|
|
}
|
|
return points;
|
|
}
|
|
|
|
/**
|
|
* Haversine distance between two coordinate pairs.
|
|
*
|
|
* @param lat1 - First point latitude in decimal degrees.
|
|
* @param lng1 - First point longitude in decimal degrees.
|
|
* @param lat2 - Second point latitude in decimal degrees.
|
|
* @param lng2 - Second point longitude in decimal degrees.
|
|
* @returns Distance in kilometers (spherical Earth approximation).
|
|
*/
|
|
export function distanceKm(
|
|
lat1: number,
|
|
lng1: number,
|
|
lat2: number,
|
|
lng2: number,
|
|
): number {
|
|
const dLat = (lat2 - lat1) * DEG;
|
|
const dLng = (lng2 - lng1) * DEG;
|
|
const a =
|
|
Math.sin(dLat / 2) ** 2 +
|
|
Math.cos(lat1 * DEG) * Math.cos(lat2 * DEG) * Math.sin(dLng / 2) ** 2;
|
|
return EARTH_RADIUS_KM * 2 * Math.atan2(Math.sqrt(a), Math.sqrt(1 - a));
|
|
}
|
|
</pre></td></tr></table></pre>
|
|
|
|
<div class='push'></div><!-- for sticky footer -->
|
|
</div><!-- /wrapper -->
|
|
<div class='footer quiet pad2 space-top1 center small'>
|
|
Code coverage generated by
|
|
<a href="https://istanbul.js.org/" target="_blank" rel="noopener noreferrer">istanbul</a>
|
|
at 2026-05-30T19:40:15.551Z
|
|
</div>
|
|
<script src="prettify.js"></script>
|
|
<script>
|
|
window.onload = function () {
|
|
prettyPrint();
|
|
};
|
|
</script>
|
|
<script src="sorter.js"></script>
|
|
<script src="block-navigation.js"></script>
|
|
</body>
|
|
</html>
|
|
|