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

@@ -0,0 +1,187 @@
+<!doctype html>
+<html lang="en">
+<head>
+    <title>Code coverage report for src/debuglog.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> debuglog.ts</h1>
+        <div class='clearfix'>
+            <div class='fl pad1y space-right2'>
+                <span class="strong">67.64% </span>
+                <span class="quiet">Statements</span>
+                <span class='fraction'>23/34</span>
+            </div>
+            <div class='fl pad1y space-right2'>
+                <span class="strong">60% </span>
+                <span class="quiet">Branches</span>
+                <span class='fraction'>6/10</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">67.64% </span>
+                <span class="quiet">Lines</span>
+                <span class='fraction'>23/34</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 medium'></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></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">20x</span>
+<span class="cline-any cline-yes">20x</span>
+<span class="cline-any cline-yes">20x</span>
+<span class="cline-any cline-yes">20x</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">14x</span>
+<span class="cline-any cline-no">&nbsp;</span>
+<span class="cline-any cline-no">&nbsp;</span>
+<span class="cline-any cline-yes">14x</span>
+<span class="cline-any cline-no">&nbsp;</span>
+<span class="cline-any cline-no">&nbsp;</span>
+<span class="cline-any cline-yes">14x</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">7x</span>
+<span class="cline-any cline-yes">1x</span>
+<span class="cline-any cline-yes">1x</span>
+<span class="cline-any cline-yes">2410x</span>
+<span class="cline-any cline-yes">2410x</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-no">&nbsp;</span>
+<span class="cline-any cline-neutral">&nbsp;</span></td><td class="text"><pre class="prettyprint lang-js">import { debuglog, format } from "node:util";
+&nbsp;
+// inlined as a hack to get around relative imports broken in ts-node (used by
+// the debuglog tests):
+function defer&lt;T&gt;(thunk: () =&gt; T) {
+  let t: T;
+  return () =&gt; (t ??= thunk());
+}
+&nbsp;
+export const debugLogContext = defer(() =&gt; {
+  for (const ea of ["fs-metadata", "fs-meta"]) {
+    if (debuglog(ea).enabled) <span class="branch-0 cbranch-no" title="branch not covered" >{</span>
+<span class="cstat-no" title="statement not covered" >      return ea;</span>
+<span class="cstat-no" title="statement not covered" >    }</span>
+    if (debuglog(ea.toUpperCase()).enabled) <span class="branch-0 cbranch-no" title="branch not covered" >{</span>
+<span class="cstat-no" title="statement not covered" >      return ea;</span>
+<span class="cstat-no" title="statement not covered" >    }</span>
+  }
+  return "photostructure:fs-metadata";
+});
+&nbsp;
+export const isDebugEnabled = defer(() =&gt; {
+  return debuglog(debugLogContext()).enabled<span class="branch-0 cbranch-no" title="branch not covered" > ?? false;</span>
+});
+&nbsp;
+export function debug(msg: string, ...args: unknown[]) {
+  if (!isDebugEnabled()) return;
+<span class="cstat-no" title="statement not covered" ><span class="branch-0 cbranch-no" title="branch not covered" >  const now = new Date();</span></span>
+<span class="cstat-no" title="statement not covered" ></span>
+<span class="cstat-no" title="statement not covered" >  // Format: [HH:MM:SS.mmm] prefix: message</span>
+<span class="cstat-no" title="statement not covered" >  const timestamp = `[${now.getHours().toString().padStart(2, "0")}:${now.getMinutes().toString().padStart(2, "0")}:${now.getSeconds().toString().padStart(2, "0")}.${now.getMilliseconds().toString().padStart(3, "0")}] ${debugLogContext()} `;</span>
+<span class="cstat-no" title="statement not covered" ></span>
+<span class="cstat-no" title="statement not covered" >  process.stderr.write(timestamp + format(msg, ...args) + "\n");</span>
+<span class="cstat-no" title="statement not covered" >}</span>
+&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/defer.ts.html ADDED Viewed

@@ -0,0 +1,175 @@
+<!doctype html>
+<html lang="en">
+<head>
+    <title>Code coverage report for src/defer.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> defer.ts</h1>
+        <div class='clearfix'>
+            <div class='fl pad1y space-right2'>
+                <span class="strong">100% </span>
+                <span class="quiet">Statements</span>
+                <span class='fraction'>30/30</span>
+            </div>
+            <div class='fl pad1y space-right2'>
+                <span class="strong">100% </span>
+                <span class="quiet">Branches</span>
+                <span class='fraction'>5/5</span>
+            </div>
+            <div class='fl pad1y space-right2'>
+                <span class="strong">100% </span>
+                <span class="quiet">Functions</span>
+                <span class='fraction'>3/3</span>
+            </div>
+            <div class='fl pad1y space-right2'>
+                <span class="strong">100% </span>
+                <span class="quiet">Lines</span>
+                <span class='fraction'>30/30</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></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">14x</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">14x</span>
+<span class="cline-any cline-yes">54x</span>
+<span class="cline-any cline-yes">13x</span>
+<span class="cline-any cline-yes">13x</span>
+<span class="cline-any cline-yes">13x</span>
+<span class="cline-any cline-yes">53x</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">2x</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">14x</span>
+<span class="cline-any cline-neutral">&nbsp;</span></td><td class="text"><pre class="prettyprint lang-js">// src/defer.ts
+&nbsp;
+export type Defer&lt;T&gt; = (() =&gt; T) &amp; {
+  reset: () =&gt; void;
+};
+&nbsp;
+/**
+ * Creates a deferred value that is computed once on first access and cached for
+ * subsequent accesses.
+ * @param thunk A function that takes no arguments and returns a value
+ * @returns A function that returns the computed value
+ */
+export function defer&lt;T&gt;(thunk: () =&gt; T): Defer&lt;T&gt; {
+  let computed = false;
+  let value: T;
+&nbsp;
+  const fn = () =&gt; {
+    if (!computed) {
+      computed = true;
+      value = thunk();
+    }
+    return value;
+  };
+&nbsp;
+  fn.reset = () =&gt; {
+    computed = false;
+  };
+&nbsp;
+  return fn;
+}
+&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/dirname.ts.html ADDED Viewed

@@ -0,0 +1,124 @@
+<!doctype html>
+<html lang="en">
+<head>
+    <title>Code coverage report for src/dirname.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> dirname.ts</h1>
+        <div class='clearfix'>
+            <div class='fl pad1y space-right2'>
+                <span class="strong">61.53% </span>
+                <span class="quiet">Statements</span>
+                <span class='fraction'>8/13</span>
+            </div>
+            <div class='fl pad1y space-right2'>
+                <span class="strong">50% </span>
+                <span class="quiet">Branches</span>
+                <span class='fraction'>1/2</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">61.53% </span>
+                <span class="quiet">Lines</span>
+                <span class='fraction'>8/13</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 medium'></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></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">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-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-neutral">&nbsp;</span></td><td class="text"><pre class="prettyprint lang-js">import { getCallerDirname } from "./stack_path";
+&nbsp;
+// Thanks to tsup shims, __dirname should always be defined except when run by
+// jest (which will use the stack_path shim)
+export function _dirname() {
+  try {
+    if (typeof __dirname !== "undefined") return __dirname;
+  } <span class="branch-0 cbranch-no" title="branch not covered" >catch {</span>
+<span class="cstat-no" title="statement not covered" >    // ignore</span>
+<span class="cstat-no" title="statement not covered" >  }</span>
+<span class="cstat-no" title="statement not covered" >  // we must be in jest. Use the stack_path ~~hack~~ shim:</span>
+<span class="cstat-no" title="statement not covered" >  return getCallerDirname();</span>
+<span class="cstat-no" title="statement not covered" >}</span>
+&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>