npm - atomirx - Versions diffs - 0.0.1 - Mend

atomirx 0.0.1

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 (121) hide show

package/README.md +1666 -0
package/coverage/base.css +224 -0
package/coverage/block-navigation.js +87 -0
package/coverage/clover.xml +1440 -0
package/coverage/coverage-final.json +14 -0
package/coverage/favicon.png +0 -0
package/coverage/index.html +131 -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 +210 -0
package/coverage/src/core/atom.ts.html +889 -0
package/coverage/src/core/batch.ts.html +223 -0
package/coverage/src/core/define.ts.html +805 -0
package/coverage/src/core/emitter.ts.html +919 -0
package/coverage/src/core/equality.ts.html +631 -0
package/coverage/src/core/hook.ts.html +460 -0
package/coverage/src/core/index.html +281 -0
package/coverage/src/core/isAtom.ts.html +100 -0
package/coverage/src/core/isPromiseLike.ts.html +133 -0
package/coverage/src/core/onCreateHook.ts.html +136 -0
package/coverage/src/core/scheduleNotifyHook.ts.html +94 -0
package/coverage/src/core/types.ts.html +523 -0
package/coverage/src/core/withUse.ts.html +253 -0
package/coverage/src/index.html +116 -0
package/coverage/src/index.ts.html +106 -0
package/dist/core/atom.d.ts +63 -0
package/dist/core/atom.test.d.ts +1 -0
package/dist/core/atomState.d.ts +104 -0
package/dist/core/atomState.test.d.ts +1 -0
package/dist/core/batch.d.ts +126 -0
package/dist/core/batch.test.d.ts +1 -0
package/dist/core/define.d.ts +173 -0
package/dist/core/define.test.d.ts +1 -0
package/dist/core/derived.d.ts +102 -0
package/dist/core/derived.test.d.ts +1 -0
package/dist/core/effect.d.ts +120 -0
package/dist/core/effect.test.d.ts +1 -0
package/dist/core/emitter.d.ts +237 -0
package/dist/core/emitter.test.d.ts +1 -0
package/dist/core/equality.d.ts +62 -0
package/dist/core/equality.test.d.ts +1 -0
package/dist/core/hook.d.ts +134 -0
package/dist/core/hook.test.d.ts +1 -0
package/dist/core/isAtom.d.ts +9 -0
package/dist/core/isPromiseLike.d.ts +9 -0
package/dist/core/isPromiseLike.test.d.ts +1 -0
package/dist/core/onCreateHook.d.ts +79 -0
package/dist/core/promiseCache.d.ts +134 -0
package/dist/core/promiseCache.test.d.ts +1 -0
package/dist/core/scheduleNotifyHook.d.ts +51 -0
package/dist/core/select.d.ts +151 -0
package/dist/core/selector.test.d.ts +1 -0
package/dist/core/types.d.ts +279 -0
package/dist/core/withUse.d.ts +38 -0
package/dist/core/withUse.test.d.ts +1 -0
package/dist/index-2ok7ilik.js +1217 -0
package/dist/index-B_5SFzfl.cjs +1 -0
package/dist/index.cjs +1 -0
package/dist/index.d.ts +14 -0
package/dist/index.js +20 -0
package/dist/index.test.d.ts +1 -0
package/dist/react/index.cjs +30 -0
package/dist/react/index.d.ts +7 -0
package/dist/react/index.js +823 -0
package/dist/react/rx.d.ts +250 -0
package/dist/react/rx.test.d.ts +1 -0
package/dist/react/strictModeTest.d.ts +10 -0
package/dist/react/useAction.d.ts +381 -0
package/dist/react/useAction.test.d.ts +1 -0
package/dist/react/useStable.d.ts +183 -0
package/dist/react/useStable.test.d.ts +1 -0
package/dist/react/useValue.d.ts +134 -0
package/dist/react/useValue.test.d.ts +1 -0
package/package.json +57 -0
package/scripts/publish.js +198 -0
package/src/core/atom.test.ts +369 -0
package/src/core/atom.ts +189 -0
package/src/core/atomState.test.ts +342 -0
package/src/core/atomState.ts +256 -0
package/src/core/batch.test.ts +257 -0
package/src/core/batch.ts +172 -0
package/src/core/define.test.ts +342 -0
package/src/core/define.ts +243 -0
package/src/core/derived.test.ts +381 -0
package/src/core/derived.ts +339 -0
package/src/core/effect.test.ts +196 -0
package/src/core/effect.ts +184 -0
package/src/core/emitter.test.ts +364 -0
package/src/core/emitter.ts +392 -0
package/src/core/equality.test.ts +392 -0
package/src/core/equality.ts +182 -0
package/src/core/hook.test.ts +227 -0
package/src/core/hook.ts +177 -0
package/src/core/isAtom.ts +27 -0
package/src/core/isPromiseLike.test.ts +72 -0
package/src/core/isPromiseLike.ts +16 -0
package/src/core/onCreateHook.ts +92 -0
package/src/core/promiseCache.test.ts +239 -0
package/src/core/promiseCache.ts +279 -0
package/src/core/scheduleNotifyHook.ts +53 -0
package/src/core/select.ts +454 -0
package/src/core/selector.test.ts +257 -0
package/src/core/types.ts +311 -0
package/src/core/withUse.test.ts +249 -0
package/src/core/withUse.ts +56 -0
package/src/index.test.ts +80 -0
package/src/index.ts +51 -0
package/src/react/index.ts +20 -0
package/src/react/rx.test.tsx +416 -0
package/src/react/rx.tsx +300 -0
package/src/react/strictModeTest.tsx +71 -0
package/src/react/useAction.test.ts +989 -0
package/src/react/useAction.ts +605 -0
package/src/react/useStable.test.ts +553 -0
package/src/react/useStable.ts +288 -0
package/src/react/useValue.test.ts +182 -0
package/src/react/useValue.ts +261 -0
package/tsconfig.json +9 -0
package/v2.md +725 -0
package/vite.config.ts +39 -0

package/coverage/src/core/withUse.ts.html ADDED Viewed

@@ -0,0 +1,253 @@
+<!doctype html>
+<html lang="en">
+<head>
+    <title>Code coverage report for src/core/withUse.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/core</a> withUse.ts</h1>
+        <div class='clearfix'>
+            <div class='fl pad1y space-right2'>
+                <span class="strong">100% </span>
+                <span class="quiet">Statements</span>
+                <span class='fraction'>56/56</span>
+            </div>
+            <div class='fl pad1y space-right2'>
+                <span class="strong">100% </span>
+                <span class="quiet">Branches</span>
+                <span class='fraction'>9/9</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">100% </span>
+                <span class="quiet">Lines</span>
+                <span class='fraction'>56/56</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></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">1x</span>
+<span class="cline-any cline-yes">82x</span>
+<span class="cline-any cline-yes">82x</span>
+<span class="cline-any cline-yes">25x</span>
+<span class="cline-any cline-yes">25x</span>
+<span class="cline-any cline-yes">25x</span>
+<span class="cline-any cline-yes">18x</span>
+<span class="cline-any cline-yes">25x</span>
+<span class="cline-any cline-yes">15x</span>
+<span class="cline-any cline-yes">11x</span>
+<span class="cline-any cline-yes">11x</span>
+<span class="cline-any cline-yes">4x</span>
+<span class="cline-any cline-yes">4x</span>
+<span class="cline-any cline-yes">3x</span>
+<span class="cline-any cline-yes">3x</span>
+<span class="cline-any cline-yes">25x</span>
+<span class="cline-any cline-yes">82x</span>
+<span class="cline-any cline-yes">82x</span>
+<span class="cline-any cline-neutral">&nbsp;</span></td><td class="text"><pre class="prettyprint lang-js">import type { Pipeable } from "./types";
+&nbsp;
+/**
+ * Adds a chainable `.use()` method to any object, enabling plugin-based transformations.
+ *
+ * The `.use()` method accepts a plugin function that receives the source object
+ * and can return a transformed version. Supports several return patterns:
+ *
+ * - **Void/falsy**: Returns the original source unchanged (side-effect only plugins)
+ * - **Object/function with `.use`**: Returns as-is (already chainable)
+ * - **Object/function without `.use`**: Wraps with `withUse()` for continued chaining
+ * - **Primitive**: Returns the value directly
+ *
+ * @template TSource - The type of the source object being enhanced
+ * @param source - The object to add `.use()` method to
+ * @returns The source object with `.use()` method attached
+ *
+ * @example
+ * // Basic usage with atom tuple
+ * const mappable = withUse([signal, setter]);
+ * const transformed = mappable.use(([sig, set]) =&gt; ({
+ *   sig,
+ *   set: (v: string) =&gt; set(Number(v))
+ * }));
+ *
+ * @example
+ * // Chaining multiple transformations
+ * atom(0)
+ *   .use(([sig, set]) =&gt; [sig, (v: number) =&gt; set(v * 2)])
+ *   .use(([sig, set]) =&gt; [sig, (v: number) =&gt; set(v + 1)]);
+ *
+ * @example
+ * // Side-effect only plugin (returns void)
+ * mappable.use((source) =&gt; {
+ *   console.log('Source:', source);
+ *   // returns undefined - original source is returned
+ * });
+ */
+export function withUse&lt;TSource extends object&gt;(source: TSource) {
+  return Object.assign(source, {
+    use&lt;TNew = void&gt;(plugin: (source: TSource) =&gt; TNew): any {
+      const result = plugin(source);
+      // Void/falsy: return original source (side-effect only plugins)
+      if (!result) return source;
+      // Object or function: check if already has .use(), otherwise wrap
+      if (typeof result === "object" || typeof result === "function") {
+        if ("use" in result) {
+          return result;
+        }
+        return withUse(result);
+      }
+      // Primitive values: return directly (not chainable)
+      return result;
+    },
+  }) as TSource &amp; Pipeable;
+}
+&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 2026-01-16T14:35:38.788Z
+            </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/src/index.html ADDED Viewed

@@ -0,0 +1,116 @@
+<!doctype html>
+<html lang="en">
+<head>
+    <title>Code coverage report for src</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> src</h1>
+        <div class='clearfix'>
+            <div class='fl pad1y space-right2'>
+                <span class="strong">0% </span>
+                <span class="quiet">Statements</span>
+                <span class='fraction'>0/7</span>
+            </div>
+            <div class='fl pad1y space-right2'>
+                <span class="strong">0% </span>
+                <span class="quiet">Branches</span>
+                <span class='fraction'>0/1</span>
+            </div>
+            <div class='fl pad1y space-right2'>
+                <span class="strong">0% </span>
+                <span class="quiet">Functions</span>
+                <span class='fraction'>0/1</span>
+            </div>
+            <div class='fl pad1y space-right2'>
+                <span class="strong">0% </span>
+                <span class="quiet">Lines</span>
+                <span class='fraction'>0/7</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 low'></div>
+    <div class="pad1">
+<table class="coverage-summary">
+<thead>
+<tr>
+   <th data-col="file" data-fmt="html" data-html="true" class="file">File</th>
+   <th data-col="pic" data-type="number" data-fmt="html" data-html="true" class="pic"></th>
+   <th data-col="statements" data-type="number" data-fmt="pct" class="pct">Statements</th>
+   <th data-col="statements_raw" data-type="number" data-fmt="html" class="abs"></th>
+   <th data-col="branches" data-type="number" data-fmt="pct" class="pct">Branches</th>
+   <th data-col="branches_raw" data-type="number" data-fmt="html" class="abs"></th>
+   <th data-col="functions" data-type="number" data-fmt="pct" class="pct">Functions</th>
+   <th data-col="functions_raw" data-type="number" data-fmt="html" class="abs"></th>
+   <th data-col="lines" data-type="number" data-fmt="pct" class="pct">Lines</th>
+   <th data-col="lines_raw" data-type="number" data-fmt="html" class="abs"></th>
+</tr>
+</thead>
+<tbody><tr>
+	<td class="file low" data-value="index.ts"><a href="index.ts.html">index.ts</a></td>
+	<td data-value="0" class="pic low">
+	<div class="chart"><div class="cover-fill" style="width: 0%"></div><div class="cover-empty" style="width: 100%"></div></div>
+	</td>
+	<td data-value="0" class="pct low">0%</td>
+	<td data-value="7" class="abs low">0/7</td>
+	<td data-value="0" class="pct low">0%</td>
+	<td data-value="1" class="abs low">0/1</td>
+	<td data-value="0" class="pct low">0%</td>
+	<td data-value="1" class="abs low">0/1</td>
+	<td data-value="0" class="pct low">0%</td>
+	<td data-value="7" class="abs low">0/7</td>
+	</tr>
+</tbody>
+</table>
+</div>
+                <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-01-16T14:35:38.788Z
+            </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/src/index.ts.html ADDED Viewed

@@ -0,0 +1,106 @@
+<!doctype html>
+<html lang="en">
+<head>
+    <title>Code coverage report for src/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> / <a href="index.html">src</a> index.ts</h1>
+        <div class='clearfix'>
+            <div class='fl pad1y space-right2'>
+                <span class="strong">0% </span>
+                <span class="quiet">Statements</span>
+                <span class='fraction'>0/7</span>
+            </div>
+            <div class='fl pad1y space-right2'>
+                <span class="strong">0% </span>
+                <span class="quiet">Branches</span>
+                <span class='fraction'>0/1</span>
+            </div>
+            <div class='fl pad1y space-right2'>
+                <span class="strong">0% </span>
+                <span class="quiet">Functions</span>
+                <span class='fraction'>0/1</span>
+            </div>
+            <div class='fl pad1y space-right2'>
+                <span class="strong">0% </span>
+                <span class="quiet">Lines</span>
+                <span class='fraction'>0/7</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 low'></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></td><td class="line-coverage quiet"><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"><span class="cstat-no" title="statement not covered" >export const sum = (a: number, b: number) =&gt; {<span class="fstat-no" title="function not covered" ><span class="branch-0 cbranch-no" title="branch not covered" ></span></span></span>
+<span class="cstat-no" title="statement not covered" >  return a + b;</span>
+<span class="cstat-no" title="statement not covered" >};</span>
+<span class="cstat-no" title="statement not covered" ></span>
+<span class="cstat-no" title="statement not covered" >export const atomirx = () =&gt; {</span>
+<span class="cstat-no" title="statement not covered" >  console.log("Atomirx initialized");</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 2026-01-16T14:35:38.788Z
+            </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/dist/core/atom.d.ts ADDED Viewed

@@ -0,0 +1,63 @@
+import { AtomOptions, MutableAtom } from './types';
+/**
+ * Creates a mutable atom - a reactive state container that holds a single value.
+ *
+ * MutableAtom is a raw storage container. It stores values as-is, including Promises.
+ * If you store a Promise, `.value` returns the Promise object itself.
+ *
+ * Features:
+ * - Raw storage: stores any value including Promises
+ * - Lazy initialization: pass a function to defer computation
+ * - Equality checking: configurable equality for reducer-based updates
+ * - Plugin system: chainable `.use()` method for extensions
+ * - Subscriptions: `.on()` for change notifications
+ *
+ * @template T - The type of value stored in the atom
+ * @param valueOrInit - Initial value or lazy initializer function `() => T`
+ * @param options - Configuration options
+ * @param options.meta - Optional metadata for debugging/devtools
+ * @param options.equals - Equality strategy for change detection (default: strict)
+ * @returns A mutable atom with value, set/reset methods
+ *
+ * @example Synchronous value
+ * ```ts
+ * const count = atom(0);
+ * count.set(1);
+ * count.set(prev => prev + 1);
+ * console.log(count.value); // 2
+ * ```
+ *
+ * @example Lazy initialization
+ * ```ts
+ * // Initial value computed at creation
+ * const config = atom(() => parseExpensiveConfig());
+ *
+ * // reset() re-runs the initializer for fresh values
+ * const timestamp = atom(() => Date.now());
+ * timestamp.reset(); // Gets new timestamp
+ *
+ * // To store a function as value, wrap it:
+ * const callback = atom(() => () => console.log('hello'));
+ * ```
+ *
+ * @example Async value (stores Promise as-is)
+ * ```ts
+ * const posts = atom(fetchPosts());
+ * posts.value; // Promise<Post[]>
+ *
+ * // Refetch - set a new Promise
+ * posts.set(fetchPosts());
+ *
+ * // Reset with direct value - restores original Promise (does NOT refetch)
+ * // Reset with lazy init - re-runs initializer (DOES refetch)
+ * const lazyPosts = atom(() => fetchPosts());
+ * lazyPosts.reset(); // Refetches!
+ * ```
+ *
+ * @example With equals option
+ * ```ts
+ * const state = atom({ count: 0 }, { equals: "shallow" });
+ * state.set(prev => ({ ...prev })); // No notification (shallow equal)
+ * ```
+ */
+export declare function atom<T>(valueOrInit: T | (() => T), options?: AtomOptions<T>): MutableAtom<T>;

package/dist/core/atom.test.d.ts ADDED Viewed

	@@ -0,0 +1 @@
1	+ export {};

package/dist/core/atomState.d.ts ADDED Viewed

@@ -0,0 +1,104 @@
+import { Emitter } from './emitter';
+import { Equality } from './types';
+/**
+ * Options for creating an atomState.
+ */
+export interface AtomStateOptions<T, TFallback = undefined> {
+    /** Equality strategy for change detection (default: "strict") */
+    equals?: Equality<T>;
+    /**
+     * Fallback value to use during loading or error states.
+     * When set, enables "stale" mode where value is never undefined.
+     */
+    fallback?: TFallback;
+    /**
+     * Whether fallback mode is enabled.
+     * When true, getValue() returns fallback/lastResolved during loading/error.
+     */
+    hasFallback?: boolean;
+}
+/**
+ * API for managing atom state with async support.
+ */
+export interface AtomStateAPI<T, TFallback = undefined> {
+    /** Get the current value (undefined if loading or error, unless fallback mode) */
+    getValue(): TFallback extends undefined ? T | undefined : T | TFallback;
+    /** Get the loading state */
+    getLoading(): boolean;
+    /** Get the error (undefined if no error) */
+    getError(): any;
+    /** Get the current promise */
+    getPromise(): PromiseLike<T>;
+    /** Set the value (clears loading and error, notifies if changed) */
+    setValue(value: T, silent?: boolean): void;
+    /** Set loading state with a promise (clears value and error, notifies) */
+    setLoading(promise: PromiseLike<T>, silent?: boolean): void;
+    /** Set error state (clears value and loading, notifies if changed) */
+    setError(error: any, silent?: boolean): void;
+    /** Reset to initial state (notifies if was not already initial) */
+    reset(): void;
+    /** Get current version (for race condition handling) */
+    getVersion(): number;
+    /** Check if a version is stale (older than current) */
+    isVersionStale(version: number): boolean;
+    /**
+     * Returns true if fallback mode is enabled AND (loading OR error).
+     * When true, getValue() returns fallback or last resolved value.
+     */
+    stale(): boolean;
+    /**
+     * Returns true if value has been changed by setValue() (not during init).
+     */
+    isDirty(): boolean;
+    /**
+     * Marks the state as dirty (called when set() is used).
+     */
+    markDirty(): void;
+    /**
+     * Clears the dirty flag (called on reset).
+     */
+    clearDirty(): void;
+    /** Subscribe to state changes */
+    on: Emitter["on"];
+}
+/**
+ * Creates a state container for atoms with async support.
+ *
+ * Handles:
+ * - Value, loading, and error states
+ * - Version tracking for race condition handling
+ * - Equality checking for change detection
+ * - Notification scheduling
+ * - Fallback mode for stale-while-revalidate pattern
+ *
+ * @template T - The type of value stored
+ * @template TFallback - The type of fallback value (default: undefined)
+ * @param options - Configuration options
+ * @returns AtomStateAPI for managing the state
+ *
+ * @example
+ * ```ts
+ * const state = atomState<number>();
+ *
+ * state.setValue(42);
+ * console.log(state.getValue()); // 42
+ *
+ * state.setLoading(fetchData());
+ * console.log(state.getLoading()); // true
+ *
+ * state.on(() => console.log('State changed!'));
+ * ```
+ *
+ * @example With fallback
+ * ```ts
+ * const state = atomState<User, User>({
+ *   fallback: { name: 'Guest' },
+ *   hasFallback: true
+ * });
+ *
+ * state.setLoading(fetchUser());
+ * console.log(state.getValue()); // { name: 'Guest' }
+ * console.log(state.isStale()); // true
+ * ```
+ */
+export declare function atomState<T, TFallback = undefined>(options?: AtomStateOptions<T, TFallback>): AtomStateAPI<T, TFallback>;

package/dist/core/atomState.test.d.ts ADDED Viewed

	@@ -0,0 +1 @@
1	+ export {};