@mythicalos/react-ui 0.1.0 → 0.1.2

package/dist/hooks.js

@@ -63,10 +63,22 @@ export function usePoll(fn, ms, opts = {}) {
         let timer;
         let stopped = false;
         let failures = 0; // consecutive failed reads — drives the ×2 backoff ladder (reset on success)
+        // true from the moment a tick fires its fetch until that fetch settles — the ONE in-flight
+        // read this call site is allowed to have. The visibility handler below must never start a
+        // second tick while this is true; it lets the in-flight tick's own onSettled → schedule()
+        // continue the single chain instead (a prior version fired an immediate tick on visibility
+        // return unconditionally, which could open a second concurrent chain).
+        let pending = false;
         const isHidden = () => typeof document !== "undefined" && document.hidden === true;
         const schedule = () => {
             if (!alive || stopped)
                 return;
+            // Clear any already-armed timer before arming a new one — defense in depth so a stray
+            // double-settle can never leave an earlier timer orphaned (never cleared, still firing).
+            if (timer) {
+                clearTimeout(timer);
+                timer = undefined;
+            }
             // U7 pause: while the document is hidden no timer is armed — the
             // visibilitychange handler below refreshes immediately on return.
             if (isHidden())
@@ -76,26 +88,31 @@ export function usePoll(fn, ms, opts = {}) {
         // diff r3-F1: every response routes through runPollTick — stamped with the epoch at fire
         // time, applied only while that epoch is still live. A stale settle leaves loading alone
         // (the reset already set it for the new epoch) but still rearms via schedule()'s own guards.
-        const tick = () => runPollTick({
-            fetch: () => fnRef.current(),
-            guard,
-            isAlive: () => alive && !stopped,
-            isHidden,
-            onSuccess: (v) => {
-                failures = 0;
-                setData(v);
-                setError(undefined);
-            },
-            onFailure: (message) => {
-                failures += 1;
-                setError(message);
-            },
-            onSettled: (applied) => {
-                if (applied)
-                    setLoading(false);
-                schedule();
-            },
-        });
+        const tick = () => {
+            pending = true;
+            return runPollTick({
+                fetch: () => fnRef.current(),
+                guard,
+                isAlive: () => alive && !stopped,
+                isHidden,
+                onSuccess: (v) => {
+                    failures = 0;
+                    setData(v);
+                    setError(undefined);
+                },
+                onFailure: (message) => {
+                    failures += 1;
+                    setError(message);
+                },
+                onSettled: (applied) => {
+                    if (applied)
+                        setLoading(false);
+                    schedule();
+                },
+            }).finally(() => {
+                pending = false;
+            });
+        };
         const onVisibility = () => {
             if (!alive || stopped)
                 return;
@@ -103,8 +120,10 @@ export function usePoll(fn, ms, opts = {}) {
                 clearTimeout(timer);
                 timer = undefined;
             }
-            if (!isHidden())
-                void tick(); // immediate refresh on visibility return
+            // Immediate refresh on visibility return — but only when idle. A tick already in flight
+            // keeps its place as the single chain: its own onSettled → schedule() picks up from here.
+            if (!isHidden() && !pending)
+                void tick();
         };
         if (typeof document !== "undefined")
             document.addEventListener("visibilitychange", onVisibility);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mythicalos/react-ui",
-  "version": "0.1.0",
+  "version": "0.1.2",
   "description": "mythicalOS thin React bindings over @mythicalos/ui-core — Button, Input/Toggle/Checkbox, MaskedSecretInput, EmptyState, ConfirmDialog/Scrim, Toast/ToastProvider, Chip, Card, Avatar, StatusLine, SearchInput, Banner, Gauge, and the usePoll/useInterval hooks. Render + framework wiring only — every class string, poll-scheduling math, glyph map, and text composition is derived by @mythicalos/ui-core so this binding and its Preact sibling can never drift. Apache-2.0.",
   "license": "Apache-2.0",
   "type": "module",
@@ -20,7 +20,11 @@
       "default": "./dist/index.js"
     }
   },
-  "files": ["dist", "README.md", "NOTICE"],
+  "files": [
+    "dist",
+    "README.md",
+    "NOTICE"
+  ],
   "peerDependencies": {
     "react": "^18.2.0 || ^19",
     "react-dom": "^18.2.0 || ^19",
@@ -28,23 +32,23 @@
   },
   "peerDependenciesMeta": {
     "@mythicalos/tokens": {
-    "optional": true
+      "optional": true
+    }
+  },
+  "dependencies": {
+    "@mythicalos/ui-core": "^0.1.1"
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.build.json",
+    "typecheck": "tsc --noEmit",
+    "test": "bun test",
+    "prepublishOnly": "bun run build && bun test && bun run typecheck"
+  },
+  "devDependencies": {
+    "react": "^19.2.8",
+    "react-dom": "^19.2.8",
+    "@types/react": "^19",
+    "@types/react-dom": "^19",
+    "typescript": "^5"
   }
-},
-"dependencies": {
-  "@mythicalos/ui-core": "^0.1.0"
-},
-"scripts": {
-  "build": "tsc -p tsconfig.build.json",
-  "typecheck": "tsc --noEmit",
-  "test": "bun test",
-  "prepublishOnly": "bun run build && bun test && bun run typecheck"
-},
-"devDependencies": {
-  "react": "^19.2.8",
-  "react-dom": "^19.2.8",
-  "@types/react": "^19",
-  "@types/react-dom": "^19",
-  "typescript": "^5"
-}
 }