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/system_volume.ts.html ADDED Viewed

@@ -0,0 +1,301 @@
+<!doctype html>
+<html lang="en">
+<head>
+    <title>Code coverage report for src/system_volume.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> system_volume.ts</h1>
+        <div class='clearfix'>
+            <div class='fl pad1y space-right2'>
+                <span class="strong">87.5% </span>
+                <span class="quiet">Statements</span>
+                <span class='fraction'>63/72</span>
+            </div>
+            <div class='fl pad1y space-right2'>
+                <span class="strong">75% </span>
+                <span class="quiet">Branches</span>
+                <span class='fraction'>6/8</span>
+            </div>
+            <div class='fl pad1y space-right2'>
+                <span class="strong">100% </span>
+                <span class="quiet">Functions</span>
+                <span class='fraction'>2/2</span>
+            </div>
+            <div class='fl pad1y space-right2'>
+                <span class="strong">87.5% </span>
+                <span class="quiet">Lines</span>
+                <span class='fraction'>63/72</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></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">1552x</span>
+<span class="cline-any cline-yes">1552x</span>
+<span class="cline-any cline-yes">1552x</span>
+<span class="cline-any cline-yes">1552x</span>
+<span class="cline-any cline-yes">1552x</span>
+<span class="cline-any cline-yes">1552x</span>
+<span class="cline-any cline-no">&nbsp;</span>
+<span class="cline-any cline-no">&nbsp;</span>
+<span class="cline-any cline-no">&nbsp;</span>
+<span class="cline-any cline-no">&nbsp;</span>
+<span class="cline-any cline-no">&nbsp;</span>
+<span class="cline-any cline-no">&nbsp;</span>
+<span class="cline-any cline-yes">1552x</span>
+<span class="cline-any cline-yes">1552x</span>
+<span class="cline-any cline-yes">1548x</span>
+<span class="cline-any cline-yes">1548x</span>
+<span class="cline-any cline-yes">1552x</span>
+<span class="cline-any cline-yes">1552x</span>
+<span class="cline-any cline-yes">1552x</span>
+<span class="cline-any cline-yes">1552x</span>
+<span class="cline-any cline-yes">1552x</span>
+<span class="cline-any cline-yes">1552x</span>
+<span class="cline-any cline-yes">1552x</span>
+<span class="cline-any cline-yes">1552x</span>
+<span class="cline-any cline-yes">1552x</span>
+<span class="cline-any cline-yes">1552x</span>
+<span class="cline-any cline-yes">1552x</span>
+<span class="cline-any cline-yes">1552x</span>
+<span class="cline-any cline-yes">1552x</span>
+<span class="cline-any cline-yes">1552x</span>
+<span class="cline-any cline-yes">1x</span>
+<span class="cline-any cline-yes">1503x</span>
+<span class="cline-any cline-yes">1503x</span>
+<span class="cline-any cline-yes">1503x</span>
+<span class="cline-any cline-yes">1503x</span>
+<span class="cline-any cline-yes">1503x</span>
+<span class="cline-any cline-yes">1503x</span>
+<span class="cline-any cline-yes">1503x</span>
+<span class="cline-any cline-no">&nbsp;</span>
+<span class="cline-any cline-no">&nbsp;</span>
+<span class="cline-any cline-no">&nbsp;</span>
+<span class="cline-any cline-yes">1503x</span>
+<span class="cline-any cline-yes">1503x</span>
+<span class="cline-any cline-yes">1503x</span>
+<span class="cline-any cline-yes">1503x</span>
+<span class="cline-any cline-yes">1503x</span>
+<span class="cline-any cline-yes">1503x</span>
+<span class="cline-any cline-neutral">&nbsp;</span></td><td class="text"><pre class="prettyprint lang-js">// src/system_volume.ts
+&nbsp;
+import { debug } from "./debuglog";
+import { compileGlob } from "./glob";
+import { SystemFsTypesDefault, SystemPathPatternsDefault } from "./options";
+import { normalizePath } from "./path";
+import { isWindows } from "./platform";
+import { isNotBlank } from "./string";
+import type { MountPoint } from "./types/mount_point";
+import type { Options } from "./types/options";
+&nbsp;
+/**
+ * Configuration for system volume detection
+ *
+ * @see {@link MountPoint.isSystemVolume}
+ */
+export type SystemVolumeConfig = Pick&lt;
+  Options,
+  "systemPathPatterns" | "systemFsTypes"
+&gt;;
+&nbsp;
+/**
+ * Determines if a mount point represents a system volume based on its path and
+ * filesystem type
+ */
+export function isSystemVolume(
+  mountPoint: string,
+  fstype: string | undefined,
+  config: Partial&lt;SystemVolumeConfig&gt; = {},
+): boolean {
+  if (isWindows) <span class="branch-0 cbranch-no" title="branch not covered" >{</span>
+<span class="cstat-no" title="statement not covered" >    const systemDrive = normalizePath(process.env["SystemDrive"]);</span>
+<span class="cstat-no" title="statement not covered" >    if (systemDrive != null &amp;&amp; mountPoint === systemDrive) {</span>
+<span class="cstat-no" title="statement not covered" >      debug("[isSystemVolume] %s is the Windows system drive", mountPoint);</span>
+<span class="cstat-no" title="statement not covered" >      return true;</span>
+<span class="cstat-no" title="statement not covered" >    }</span>
+<span class="cstat-no" title="statement not covered" >  }</span>
+  const isSystemFsType =
+    isNotBlank(fstype) &amp;&amp;
+    ((config.systemFsTypes ?? SystemFsTypesDefault) as string[]).includes(
+      fstype,
+    );
+  const hasSystemPath = compileGlob(
+    config.systemPathPatterns ?? SystemPathPatternsDefault,
+  ).test(mountPoint);
+  const result = isSystemFsType || hasSystemPath;
+  debug("[isSystemVolume]", {
+    mountPoint,
+    fstype,
+    result,
+    isSystemFsType,
+    hasSystemPath,
+  });
+  return result;
+}
+&nbsp;
+export function assignSystemVolume(
+  mp: MountPoint,
+  config: Partial&lt;SystemVolumeConfig&gt;,
+) {
+  const result = isSystemVolume(mp.mountPoint, mp.fstype, config);
+&nbsp;
+  if (isWindows) <span class="branch-0 cbranch-no" title="branch not covered" >{</span>
+<span class="cstat-no" title="statement not covered" >    // native code actually knows the system drive and has more in-depth</span>
+<span class="cstat-no" title="statement not covered" >    // metadata information that we trust more than these heuristics</span>
+<span class="cstat-no" title="statement not covered" >    mp.isSystemVolume ??= result;</span>
+  } else {
+    // macOS and Linux don't have a concept of an explicit "system drive" like
+    // Windows--always trust our heuristics
+    mp.isSystemVolume = result;
+  }
+}
+&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/unc.ts.html ADDED Viewed

@@ -0,0 +1,274 @@
+<!doctype html>
+<html lang="en">
+<head>
+    <title>Code coverage report for src/unc.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> unc.ts</h1>
+        <div class='clearfix'>
+            <div class='fl pad1y space-right2'>
+                <span class="strong">96.82% </span>
+                <span class="quiet">Statements</span>
+                <span class='fraction'>61/63</span>
+            </div>
+            <div class='fl pad1y space-right2'>
+                <span class="strong">95.65% </span>
+                <span class="quiet">Branches</span>
+                <span class='fraction'>22/23</span>
+            </div>
+            <div class='fl pad1y space-right2'>
+                <span class="strong">100% </span>
+                <span class="quiet">Functions</span>
+                <span class='fraction'>1/1</span>
+            </div>
+            <div class='fl pad1y space-right2'>
+                <span class="strong">96.82% </span>
+                <span class="quiet">Lines</span>
+                <span class='fraction'>61/63</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></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">43x</span>
+<span class="cline-any cline-yes">43x</span>
+<span class="cline-any cline-yes">43x</span>
+<span class="cline-any cline-yes">43x</span>
+<span class="cline-any cline-yes">10x</span>
+<span class="cline-any cline-yes">10x</span>
+<span class="cline-any cline-yes">33x</span>
+<span class="cline-any cline-yes">33x</span>
+<span class="cline-any cline-yes">43x</span>
+<span class="cline-any cline-yes">2x</span>
+<span class="cline-any cline-yes">2x</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">43x</span>
+<span class="cline-any cline-yes">43x</span>
+<span class="cline-any cline-yes">43x</span>
+<span class="cline-any cline-yes">43x</span>
+<span class="cline-any cline-yes">43x</span>
+<span class="cline-any cline-yes">43x</span>
+<span class="cline-any cline-yes">43x</span>
+<span class="cline-any cline-yes">4x</span>
+<span class="cline-any cline-yes">4x</span>
+<span class="cline-any cline-yes">27x</span>
+<span class="cline-any cline-yes">27x</span>
+<span class="cline-any cline-yes">27x</span>
+<span class="cline-any cline-yes">27x</span>
+<span class="cline-any cline-yes">27x</span>
+<span class="cline-any cline-yes">43x</span>
+<span class="cline-any cline-yes">43x</span>
+<span class="cline-any cline-yes">24x</span>
+<span class="cline-any cline-yes">43x</span>
+<span class="cline-any cline-yes">8x</span>
+<span class="cline-any cline-yes">8x</span>
+<span class="cline-any cline-yes">19x</span>
+<span class="cline-any cline-yes">19x</span>
+<span class="cline-any cline-yes">19x</span>
+<span class="cline-any cline-yes">43x</span>
+<span class="cline-any cline-yes">14x</span>
+<span class="cline-any cline-yes">14x</span>
+<span class="cline-any cline-yes">5x</span>
+<span class="cline-any cline-yes">5x</span>
+<span class="cline-any cline-yes">43x</span>
+<span class="cline-any cline-yes">43x</span>
+<span class="cline-any cline-no">&nbsp;</span>
+<span class="cline-any cline-no">&nbsp;</span>
+<span class="cline-any cline-yes">5x</span>
+<span class="cline-any cline-yes">5x</span>
+<span class="cline-any cline-yes">5x</span>
+<span class="cline-any cline-neutral">&nbsp;</span></td><td class="text"><pre class="prettyprint lang-js">// src/unc.ts
+&nbsp;
+import { isBlank, isString } from "./string";
+import { RemoteInfo } from "./types/remote_info";
+&nbsp;
+/**
+ * Checks if a string is formatted as a valid UNC path.
+ * A valid UNC path starts with double backslashes or slashes,
+ * followed by a server/host name, and then a share name.
+ * The path must use consistent slashes (all forward or all backward).
+ *
+ * @param path - The string to check
+ * @returns boolean - True if the string is a valid UNC path, false otherwise
+ */
+export function parseUNCPath(
+  path: string | null | undefined,
+): RemoteInfo | undefined {
+  if (path == null || isBlank(path) || !isString(path)) {
+    return;
+  }
+&nbsp;
+  // Check for two forward slashes or two backslashes at start
+  if (!path.startsWith("\\\\") &amp;&amp; !path.startsWith("//")) {
+    return;
+  }
+&nbsp;
+  // Determine slash type from the start of the path
+  const isForwardSlash = path.startsWith("//");
+  const slashChar = isForwardSlash ? "/" : "\\";
+&nbsp;
+  // Split path using the correct slash type
+  const parts = path.slice(2).split(slashChar);
+&nbsp;
+  // Check minimum required parts (server and share)
+  if (parts.length &lt; 2) {
+    return;
+  }
+&nbsp;
+  // Validate server and share names exist and aren't empty
+  const [remoteHost, remoteShare] = parts;
+  if (
+    remoteHost == null ||
+    isBlank(remoteHost) ||
+    remoteShare == null ||
+    isBlank(remoteShare)
+  ) {
+    return;
+  }
+&nbsp;
+  // Check for invalid characters in server and share names
+  const invalidChars = /[&lt;&gt;:"|?*]/;
+  if (invalidChars.test(remoteHost) || invalidChars.test(remoteShare)) {
+    return;
+  }
+&nbsp;
+  // Check for mixed slash usage
+  const wrongSlash = isForwardSlash ? "\\" : "/";
+  if (path.includes(wrongSlash)) <span class="branch-0 cbranch-no" title="branch not covered" >{</span>
+<span class="cstat-no" title="statement not covered" >    return;</span>
+<span class="cstat-no" title="statement not covered" >  }</span>
+&nbsp;
+  return { remoteHost, remoteShare, remote: true };
+}
+&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>