npm - @photostructure/fs-metadata - Versions diffs - 0.3.3 → 0.5.0 - Mend

@photostructure/fs-metadata 0.3.3 → 0.5.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (183) hide show

package/C++_REVIEW_TODO.md +291 -0
package/CHANGELOG.md +33 -1
package/CLAUDE.md +169 -0
package/CONTRIBUTING.md +25 -0
package/coverage/base.css +224 -0
package/coverage/block-navigation.js +87 -0
package/coverage/favicon.png +0 -0
package/coverage/index.html +131 -0
package/coverage/lcov-report/base.css +224 -0
package/coverage/lcov-report/block-navigation.js +87 -0
package/coverage/lcov-report/favicon.png +0 -0
package/coverage/lcov-report/index.html +131 -0
package/coverage/lcov-report/prettify.css +1 -0
package/coverage/lcov-report/prettify.js +2 -0
package/coverage/lcov-report/sort-arrow-sprite.png +0 -0
package/coverage/lcov-report/sorter.js +196 -0
package/coverage/lcov-report/src/array.ts.html +217 -0
package/coverage/lcov-report/src/async.ts.html +547 -0
package/coverage/lcov-report/src/debuglog.ts.html +187 -0
package/coverage/lcov-report/src/defer.ts.html +175 -0
package/coverage/lcov-report/src/dirname.ts.html +124 -0
package/coverage/lcov-report/src/error.ts.html +322 -0
package/coverage/lcov-report/src/fs.ts.html +316 -0
package/coverage/lcov-report/src/glob.ts.html +472 -0
package/coverage/lcov-report/src/hidden.ts.html +724 -0
package/coverage/lcov-report/src/index.html +521 -0
package/coverage/lcov-report/src/index.ts.html +676 -0
package/coverage/lcov-report/src/linux/dev_disk.ts.html +316 -0
package/coverage/lcov-report/src/linux/index.html +146 -0
package/coverage/lcov-report/src/linux/mount_points.ts.html +364 -0
package/coverage/lcov-report/src/linux/mtab.ts.html +493 -0
package/coverage/lcov-report/src/mount_point.ts.html +106 -0
package/coverage/lcov-report/src/number.ts.html +148 -0
package/coverage/lcov-report/src/object.ts.html +265 -0
package/coverage/lcov-report/src/options.ts.html +475 -0
package/coverage/lcov-report/src/path.ts.html +268 -0
package/coverage/lcov-report/src/platform.ts.html +112 -0
package/coverage/lcov-report/src/random.ts.html +205 -0
package/coverage/lcov-report/src/remote_info.ts.html +553 -0
package/coverage/lcov-report/src/stack_path.ts.html +298 -0
package/coverage/lcov-report/src/string.ts.html +382 -0
package/coverage/lcov-report/src/string_enum.ts.html +208 -0
package/coverage/lcov-report/src/system_volume.ts.html +301 -0
package/coverage/lcov-report/src/unc.ts.html +274 -0
package/coverage/lcov-report/src/units.ts.html +274 -0
package/coverage/lcov-report/src/uuid.ts.html +157 -0
package/coverage/lcov-report/src/volume_health_status.ts.html +259 -0
package/coverage/lcov-report/src/volume_metadata.ts.html +787 -0
package/coverage/lcov-report/src/volume_mount_points.ts.html +388 -0
package/coverage/lcov.info +3581 -0
package/coverage/prettify.css +1 -0
package/coverage/prettify.js +2 -0
package/coverage/sort-arrow-sprite.png +0 -0
package/coverage/sorter.js +196 -0
package/coverage/src/array.ts.html +217 -0
package/coverage/src/async.ts.html +547 -0
package/coverage/src/debuglog.ts.html +187 -0
package/coverage/src/defer.ts.html +175 -0
package/coverage/src/dirname.ts.html +124 -0
package/coverage/src/error.ts.html +322 -0
package/coverage/src/fs.ts.html +316 -0
package/coverage/src/glob.ts.html +472 -0
package/coverage/src/hidden.ts.html +724 -0
package/coverage/src/index.html +521 -0
package/coverage/src/index.ts.html +676 -0
package/coverage/src/linux/dev_disk.ts.html +316 -0
package/coverage/src/linux/index.html +146 -0
package/coverage/src/linux/mount_points.ts.html +364 -0
package/coverage/src/linux/mtab.ts.html +493 -0
package/coverage/src/mount_point.ts.html +106 -0
package/coverage/src/number.ts.html +148 -0
package/coverage/src/object.ts.html +265 -0
package/coverage/src/options.ts.html +475 -0
package/coverage/src/path.ts.html +268 -0
package/coverage/src/platform.ts.html +112 -0
package/coverage/src/random.ts.html +205 -0
package/coverage/src/remote_info.ts.html +553 -0
package/coverage/src/stack_path.ts.html +298 -0
package/coverage/src/string.ts.html +382 -0
package/coverage/src/string_enum.ts.html +208 -0
package/coverage/src/system_volume.ts.html +301 -0
package/coverage/src/unc.ts.html +274 -0
package/coverage/src/units.ts.html +274 -0
package/coverage/src/uuid.ts.html +157 -0
package/coverage/src/volume_health_status.ts.html +259 -0
package/coverage/src/volume_metadata.ts.html +787 -0
package/coverage/src/volume_mount_points.ts.html +388 -0
package/jest.config.cjs +67 -6
package/package.json +51 -40
package/prebuilds/linux-x64/@photostructure+fs-metadata.glibc.node +0 -0
package/scripts/check-memory.mjs +243 -0
package/scripts/clang-tidy.mjs +73 -0
package/scripts/is-platform.mjs +12 -0
package/scripts/post-build.mjs +21 -0
package/scripts/run-asan.sh +92 -0
package/scripts/valgrind-test.mjs +83 -0
package/scripts/valgrind.sh +70 -0
package/src/async.ts +3 -3
package/src/binding.cpp +3 -3
package/src/darwin/hidden.cpp +14 -0
package/src/darwin/raii_utils.h +85 -0
package/src/darwin/volume_metadata.cpp +35 -60
package/src/darwin/volume_mount_points.cpp +31 -22
package/src/error.ts +3 -3
package/src/fs.ts +1 -1
package/src/glob.ts +2 -2
package/src/hidden.ts +6 -6
package/src/index.ts +19 -23
package/src/linux/blkid_cache.cpp +15 -12
package/src/linux/dev_disk.ts +2 -2
package/src/linux/gio_mount_points.cpp +7 -7
package/src/linux/gio_utils.cpp +19 -8
package/src/linux/gio_volume_metadata.cpp +15 -15
package/src/linux/mount_points.ts +9 -9
package/src/linux/mtab.ts +7 -7
package/src/linux/volume_metadata.cpp +6 -1
package/src/object.ts +9 -4
package/src/options.ts +4 -4
package/src/path.ts +4 -4
package/src/remote_info.ts +5 -5
package/src/system_volume.ts +8 -8
package/src/test-utils/assert.ts +2 -2
package/src/test-utils/debuglog-child.ts +1 -3
package/src/test-utils/debuglog-enabled-child.ts +10 -0
package/src/test-utils/hidden-tests.ts +1 -1
package/src/test-utils/platform.ts +3 -3
package/src/types/native_bindings.ts +3 -3
package/src/types/volume_metadata.ts +2 -2
package/src/unc.ts +2 -2
package/src/uuid.ts +1 -1
package/src/volume_health_status.ts +6 -6
package/src/volume_metadata.ts +20 -23
package/src/volume_mount_points.ts +12 -17
package/src/windows/drive_status.h +30 -13
package/src/windows/hidden.cpp +12 -0
package/src/windows/volume_metadata.cpp +17 -7
package/tsup.config.ts +8 -2
package/dist/index.cjs +0 -1439
package/dist/index.cjs.map +0 -1
package/dist/index.mjs +0 -1396
package/dist/index.mjs.map +0 -1
package/dist/types/array.d.ts +0 -25
package/dist/types/async.d.ts +0 -42
package/dist/types/debuglog.d.ts +0 -3
package/dist/types/defer.d.ts +0 -10
package/dist/types/dirname.d.ts +0 -1
package/dist/types/error.d.ts +0 -17
package/dist/types/fs.d.ts +0 -22
package/dist/types/glob.d.ts +0 -17
package/dist/types/hidden.d.ts +0 -29
package/dist/types/index.d.ts +0 -91
package/dist/types/linux/dev_disk.d.ts +0 -13
package/dist/types/linux/mount_points.d.ts +0 -6
package/dist/types/linux/mtab.d.ts +0 -47
package/dist/types/mount_point.d.ts +0 -2
package/dist/types/number.d.ts +0 -3
package/dist/types/object.d.ts +0 -13
package/dist/types/options.d.ts +0 -33
package/dist/types/path.d.ts +0 -17
package/dist/types/platform.d.ts +0 -4
package/dist/types/random.d.ts +0 -12
package/dist/types/remote_info.d.ts +0 -6
package/dist/types/stack_path.d.ts +0 -2
package/dist/types/string.d.ts +0 -37
package/dist/types/string_enum.d.ts +0 -19
package/dist/types/system_volume.d.ts +0 -14
package/dist/types/types/hidden_metadata.d.ts +0 -32
package/dist/types/types/mount_point.d.ts +0 -46
package/dist/types/types/native_bindings.d.ts +0 -51
package/dist/types/types/options.d.ts +0 -47
package/dist/types/types/remote_info.d.ts +0 -33
package/dist/types/types/volume_metadata.d.ts +0 -46
package/dist/types/unc.d.ts +0 -11
package/dist/types/units.d.ts +0 -38
package/dist/types/uuid.d.ts +0 -16
package/dist/types/volume_health_status.d.ts +0 -24
package/dist/types/volume_metadata.d.ts +0 -8
package/dist/types/volume_mount_points.d.ts +0 -6
package/jest.config.base.cjs +0 -63
package/prebuilds/darwin-arm64/@photostructure+fs-metadata.glibc.node +0 -0
package/prebuilds/linux-arm64/@photostructure+fs-metadata.musl.node +0 -0
package/prebuilds/linux-x64/@photostructure+fs-metadata.musl.node +0 -0
package/prebuilds/win32-x64/@photostructure+fs-metadata.glibc.node +0 -0

package/coverage/lcov-report/src/path.ts.html ADDED Viewed

@@ -0,0 +1,268 @@
+<!doctype html>
+<html lang="en">
+<head>
+    <title>Code coverage report for src/path.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> / <a href="index.html">src</a> path.ts</h1>
+        <div class='clearfix'>
+            <div class='fl pad1y space-right2'>
+                <span class="strong">100% </span>
+                <span class="quiet">Statements</span>
+                <span class='fraction'>61/61</span>
+            </div>
+            <div class='fl pad1y space-right2'>
+                <span class="strong">88.88% </span>
+                <span class="quiet">Branches</span>
+                <span class='fraction'>24/27</span>
+            </div>
+            <div class='fl pad1y space-right2'>
+                <span class="strong">100% </span>
+                <span class="quiet">Functions</span>
+                <span class='fraction'>4/4</span>
+            </div>
+            <div class='fl pad1y space-right2'>
+                <span class="strong">100% </span>
+                <span class="quiet">Lines</span>
+                <span class='fraction'>61/61</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></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">214x</span>
+<span class="cline-any cline-yes">214x</span>
+<span class="cline-any cline-yes">214x</span>
+<span class="cline-any cline-yes">214x</span>
+<span class="cline-any cline-yes">199x</span>
+<span class="cline-any cline-yes">199x</span>
+<span class="cline-any cline-yes">214x</span>
+<span class="cline-any cline-yes">214x</span>
+<span class="cline-any cline-yes">214x</span>
+<span class="cline-any cline-yes">214x</span>
+<span class="cline-any cline-yes">214x</span>
+<span class="cline-any cline-yes">214x</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">4738x</span>
+<span class="cline-any cline-yes">4738x</span>
+<span class="cline-any cline-yes">4738x</span>
+<span class="cline-any cline-yes">4738x</span>
+<span class="cline-any cline-yes">4738x</span>
+<span class="cline-any cline-yes">4640x</span>
+<span class="cline-any cline-yes">4640x</span>
+<span class="cline-any cline-yes">4651x</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">4738x</span>
+<span class="cline-any cline-yes">14x</span>
+<span class="cline-any cline-yes">14x</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">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">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">31x</span>
+<span class="cline-any cline-yes">31x</span>
+<span class="cline-any cline-yes">31x</span>
+<span class="cline-any cline-yes">31x</span>
+<span class="cline-any cline-neutral">&nbsp;</span></td><td class="text"><pre class="prettyprint lang-js">// src/path.ts
+&nbsp;
+import { dirname, resolve } from "node:path";
+import { isWindows } from "./platform";
+import { isBlank } from "./string";
+&nbsp;
+export function normalizePath(
+  mountPoint: string | undefined,
+): string | undefined {
+  if (isBlank(mountPoint)) return undefined;
+&nbsp;
+  const result = isWindows
+<span class="branch-0 cbranch-no" title="branch not covered" >    ? normalizeWindowsPath(mountPoint)</span>
+    : normalizePosixPath(mountPoint);
+&nbsp;
+  // Make sure the native code doesn't see anything weird:
+  return result != null ? resolve(result) <span class="branch-0 cbranch-no" title="branch not covered" >: undefined;</span>
+}
+&nbsp;
+/**
+ * Normalizes a Linux or macOS mount point by removing any trailing slashes.
+ * This is a no-op for root mount points.
+ */
+export function normalizePosixPath(
+  mountPoint: string | undefined,
+): string | undefined {
+  if (isBlank(mountPoint)) return undefined;
+  if (mountPoint === "/") return mountPoint;
+&nbsp;
+  // Fast path: check last char only if no trailing slash
+  if (mountPoint[mountPoint.length - 1] !== "/") return mountPoint;
+&nbsp;
+  // Slower path: trim trailing slashes
+  let end = mountPoint.length - 1;
+  while (end &gt; 0 &amp;&amp; mountPoint[end] === "/") {
+    end--;
+  }
+  return mountPoint.slice(0, end + 1);
+}
+&nbsp;
+/**
+ * Normalizes a Windows mount point by ensuring drive letters end with a
+ * backslash.
+ */
+export function normalizeWindowsPath(mountPoint: string): string {
+  // Terrible things happen if we give syscalls "C:" instead of "C:\"
+&nbsp;
+  return /^[a-z]:$/i.test(mountPoint)
+    ? mountPoint.toUpperCase() + "\\"
+    : mountPoint;
+}
+&nbsp;
+/**
+ * @return true if `path` is the root directory--this is platform-specific. Only
+ * "/" on linux/macOS is considered a root directory. On Windows, the root
+ * directory is a drive letter followed by a colon, e.g. "C:\".
+ */
+export function isRootDirectory(path: string): boolean {
+  const n = normalizePath(path);
+  return n == null ? false : isWindows <span class="branch-0 cbranch-no" title="branch not covered" >? dirname(n) === n </span>: n === "/";
+}
+&nbsp;</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 2025-06-01T20:18:02.849Z
+            </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>

package/coverage/lcov-report/src/platform.ts.html ADDED Viewed

@@ -0,0 +1,112 @@
+<!doctype html>
+<html lang="en">
+<head>
+    <title>Code coverage report for src/platform.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> / <a href="index.html">src</a> platform.ts</h1>
+        <div class='clearfix'>
+            <div class='fl pad1y space-right2'>
+                <span class="strong">100% </span>
+                <span class="quiet">Statements</span>
+                <span class='fraction'>9/9</span>
+            </div>
+            <div class='fl pad1y space-right2'>
+                <span class="strong">100% </span>
+                <span class="quiet">Branches</span>
+                <span class='fraction'>0/0</span>
+            </div>
+            <div class='fl pad1y space-right2'>
+                <span class="strong">100% </span>
+                <span class="quiet">Functions</span>
+                <span class='fraction'>0/0</span>
+            </div>
+            <div class='fl pad1y space-right2'>
+                <span class="strong">100% </span>
+                <span class="quiet">Lines</span>
+                <span class='fraction'>9/9</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></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-neutral">&nbsp;</span></td><td class="text"><pre class="prettyprint lang-js">// src/platform.ts
+&nbsp;
+import { arch, platform } from "node:process";
+&nbsp;
+export const isLinux = platform === "linux";
+export const isWindows = platform === "win32";
+export const isMacOS = platform === "darwin";
+&nbsp;
+export const isArm = isLinux &amp;&amp; arch.startsWith("arm");
+&nbsp;</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 2025-06-01T20:18:02.849Z
+            </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>

package/coverage/lcov-report/src/random.ts.html ADDED Viewed

@@ -0,0 +1,205 @@
+<!doctype html>
+<html lang="en">
+<head>
+    <title>Code coverage report for src/random.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> / <a href="index.html">src</a> random.ts</h1>
+        <div class='clearfix'>
+            <div class='fl pad1y space-right2'>
+                <span class="strong">100% </span>
+                <span class="quiet">Statements</span>
+                <span class='fraction'>40/40</span>
+            </div>
+            <div class='fl pad1y space-right2'>
+                <span class="strong">88.88% </span>
+                <span class="quiet">Branches</span>
+                <span class='fraction'>8/9</span>
+            </div>
+            <div class='fl pad1y space-right2'>
+                <span class="strong">100% </span>
+                <span class="quiet">Functions</span>
+                <span class='fraction'>4/4</span>
+            </div>
+            <div class='fl pad1y space-right2'>
+                <span class="strong">100% </span>
+                <span class="quiet">Lines</span>
+                <span class='fraction'>40/40</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></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">255x</span>
+<span class="cline-any cline-yes">255x</span>
+<span class="cline-any cline-yes">255x</span>
+<span class="cline-any cline-yes">1x</span>
+<span class="cline-any cline-yes">14x</span>
+<span class="cline-any cline-yes">14x</span>
+<span class="cline-any cline-yes">14x</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">3x</span>
+<span class="cline-any cline-yes">3x</span>
+<span class="cline-any cline-yes">3x</span>
+<span class="cline-any cline-yes">3x</span>
+<span class="cline-any cline-yes">53x</span>
+<span class="cline-any cline-yes">53x</span>
+<span class="cline-any cline-yes">53x</span>
+<span class="cline-any cline-yes">53x</span>
+<span class="cline-any cline-yes">53x</span>
+<span class="cline-any cline-yes">53x</span>
+<span class="cline-any cline-yes">3x</span>
+<span class="cline-any cline-yes">3x</span>
+<span class="cline-any cline-yes">1x</span>
+<span class="cline-any cline-yes">51x</span>
+<span class="cline-any cline-yes">51x</span>
+<span class="cline-any cline-yes">2x</span>
+<span class="cline-any cline-yes">2x</span>
+<span class="cline-any cline-yes">49x</span>
+<span class="cline-any cline-yes">49x</span>
+<span class="cline-any cline-neutral">&nbsp;</span></td><td class="text"><pre class="prettyprint lang-js">// src/random.ts
+&nbsp;
+import { randomInt } from "node:crypto";
+&nbsp;
+const CharCode_a = "a".charCodeAt(0);
+/**
+ * @return a random character `[a-z]`
+ */
+export function randomLetter(): string {
+  return String.fromCharCode(CharCode_a + randomInt(0, 26));
+}
+&nbsp;
+export function randomLetters(length: number): string {
+  return Array.from({ length }, randomLetter).join("");
+}
+&nbsp;
+/**
+ * Shuffle an array using the Fisher-Yates (Knuth) algorithm.
+ * @param a The array to shuffle
+ * @returns A shallow shuffled copy of `a`
+ */
+export function shuffle&lt;T&gt;(a: T[]): T[] {
+  if (a.length &lt;= 1) <span class="branch-0 cbranch-no" title="branch not covered" >return a;</span>
+  a = [...a]; // Copy the array
+  for (let i = a.length - 1; i &gt; 0; i--) {
+    // Pick a random index from 0 to i
+    const j = Math.floor(Math.random() * (i + 1));
+    // Swap elements at indices i and j
+    // eslint-disable-next-line @typescript-eslint/no-non-null-assertion
+    [a[i], a[j]] = [a[j]!, a[i]!];
+  }
+  return a;
+}
+&nbsp;
+export function pickRandom&lt;T&gt;(a: T[]): T {
+  if (a == null || a.length === 0) {
+    throw new Error("Cannot pick from an empty array");
+  }
+  return a[randomInt(0, a.length)] as T;
+}
+&nbsp;</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 2025-06-01T20:18:02.849Z
+            </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>