@gjsify/timers 0.4.35 → 0.4.36

package/globals.mjs

@@ -1,13 +1,68 @@
 /**
- * Re-exports native `node:timers` for use in Node.js builds.
+ * Cross-runtime re-export of the native timer globals for use in Node.js
+ * AND browser builds.
  *
- * On Node, `node:timers` is built into the runtime — so a Node-target
- * bundle that imports `@gjsify/timers` is routed here by the
- * resolver's `gjsify.runtimes.node === "native"` rule. This avoids dragging
- * the GJS polyfill into Node bundles entirely.
+ * `setTimeout`/`setInterval`/`setImmediate`/`queueMicrotask` and their
+ * `clear*` counterparts exist on both Node 18+ and every modern browser.
+ * The browser does NOT have native `setImmediate` — we polyfill it via
+ * `Promise.resolve().then(...)` (a turn boundary, the closest browser
+ * equivalent to Node's "I/O phase callback"; the MessageChannel-based
+ * shim is heavier and only buys ~µs of priority over Promise — not worth
+ * the complexity for a polyfill no real browser code targets directly).
  *
- * GJS bundles do NOT consult this file; they route to `@gjsify/timers`'s
- * own `lib/esm/index.js` (the polyfill).
+ * IMPORTANT: this file MUST NOT reference `node:timers` (or any other
+ * `node:` specifier) — the audit-runtimes `--strict` probe rejects re-exports
+ * from `node:*` for a slot declared cross-runtime, and `node:timers`
+ * fails to resolve in a browser bundle.
+ *
+ * GJS bundles do NOT consult this file; the GJS-target alias layer routes
+ * `@gjsify/timers` to the polyfill at `lib/esm/index.js` (which provides
+ * the GLib-source-safe Timeout class — see CLAUDE.md "GLib MainLoop").
  */
-export * from 'node:timers';
-export { default } from 'node:timers';
+
+// Standard timers — bind to globalThis so callers can detach them and the
+// `this` context still resolves to the runtime's timer host. Node's
+// `setTimeout` is callable without rebinding, but `setTimeout.bind(undefined)`
+// matches the lib.dom `(handler, timeout?, ...args) => number` signature.
+export const setTimeout = globalThis.setTimeout.bind(globalThis);
+export const clearTimeout = globalThis.clearTimeout.bind(globalThis);
+export const setInterval = globalThis.setInterval.bind(globalThis);
+export const clearInterval = globalThis.clearInterval.bind(globalThis);
+
+// queueMicrotask is native on both Node 12+ and every browser.
+export const queueMicrotask = globalThis.queueMicrotask.bind(globalThis);
+
+// setImmediate / clearImmediate — Node-only natively. In the browser we
+// polyfill via Promise.resolve().then so the callback fires on the very next
+// microtask turn. We hand out a Symbol token so `clearImmediate` can
+// no-op (a real cancellation isn't possible once `.then` has scheduled);
+// every npm consumer treats clearImmediate as best-effort already.
+const _hasNativeImmediate = typeof globalThis.setImmediate === 'function';
+
+export const setImmediate = _hasNativeImmediate
+    ? globalThis.setImmediate.bind(globalThis)
+    : ((cb, ...args) => {
+          const handle = { __cancelled: false };
+          Promise.resolve().then(() => {
+              if (!handle.__cancelled) cb(...args);
+          });
+          return handle;
+      });
+
+export const clearImmediate = _hasNativeImmediate
+    ? globalThis.clearImmediate.bind(globalThis)
+    : ((handle) => {
+          if (handle && typeof handle === 'object') handle.__cancelled = true;
+      });
+
+// Default-export shape — every named timer exported as a property so
+// `import timers from '@gjsify/timers'; timers.setTimeout(...)` resolves.
+export default {
+    setTimeout,
+    clearTimeout,
+    setInterval,
+    clearInterval,
+    setImmediate,
+    clearImmediate,
+    queueMicrotask,
+};

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@gjsify/timers",
-    "version": "0.4.35",
+    "version": "0.4.36",
     "description": "Node.js timers module for Gjs",
     "type": "module",
     "module": "lib/esm/index.js",
@@ -39,16 +39,26 @@
         "timers"
     ],
     "devDependencies": {
-        "@gjsify/cli": "^0.4.35",
-        "@gjsify/unit": "^0.4.35",
+        "@gjsify/cli": "^0.4.36",
+        "@gjsify/unit": "^0.4.36",
         "@types/node": "^25.9.1",
-        "typescript": "^6.0.3"
+        "typescript": "^5.9.3"
     },
     "gjsify": {
         "runtimes": {
             "gjs": "polyfill",
             "node": "native",
-            "browser": "polyfill"
+            "browser": "native"
         }
-    }
+    },
+    "license": "MIT",
+    "repository": {
+        "type": "git",
+        "url": "git+https://github.com/gjsify/gjsify.git",
+        "directory": "packages/node/timers"
+    },
+    "bugs": {
+        "url": "https://github.com/gjsify/gjsify/issues"
+    },
+    "homepage": "https://github.com/gjsify/gjsify/tree/main/packages/node/timers#readme"
 }