shelving 1.111.0 → 1.112.0

package/package.json

@@ -11,7 +11,7 @@
 		"state-management",
 		"query-builder"
 	],
-	"version": "1.111.0",
+	"version": "1.112.0",
 	"repository": "https://github.com/dhoulb/shelving",
 	"author": "Dave Houlbrooke <dave@shax.com>",
 	"license": "0BSD",

package/react/useMount.d.ts

@@ -1,8 +1,4 @@
 /// <reference types="react" />
+import type { Arguments } from "../util/function.js";
 import { type Start } from "../util/start.js";
-/**
- * Call a `StartCallback` when an element is mounted, and the returned `StopCallback` when it's unmounted again.
- * - Takes care of state so `start()` won't be called twice for the same element.
- * - Returns a `RefCallback` which should be set as `ref={ref}` on the target element.
- */
-export declare function useMount<T extends Element>(start: Start<[T]>): React.RefCallback<T>;
+export declare function useMount<T extends Element, A extends Arguments = []>(start: Start<[T, ...A]>, ...args: A): React.RefCallback<T>;

package/react/useMount.js

@@ -1,23 +1,25 @@
 import { useRef } from "react";
+import { isArrayEqual } from "../util/equal.js";
 import { Starter } from "../util/start.js";
-/**
- * Call a `StartCallback` when an element is mounted, and the returned `StopCallback` when it's unmounted again.
- * - Takes care of state so `start()` won't be called twice for the same element.
- * - Returns a `RefCallback` which should be set as `ref={ref}` on the target element.
- */
-export function useMount(start) {
-    const ref = useRef();
-    if (!ref.current) {
-        let current;
-        const starter = new Starter(start);
-        ref.current = (next) => {
-            if (current !== next) {
-                starter.stop();
-                current = next;
-                if (current)
-                    starter.start(current);
+export function useMount(start, ...args) {
+    const internals = (useRef().current ||= {
+        args,
+        current: null,
+        starter: new Starter(start),
+        ref(next) {
+            if (internals.current !== next) {
+                internals.starter.stop();
+                internals.current = next;
+                if (internals.current)
+                    internals.starter.start(internals.current, ...internals.args);
             }
-        };
+        },
+    });
+    if (!isArrayEqual(args, internals.args)) {
+        internals.args = args;
+        internals.starter.stop();
+        if (internals.current)
+            internals.starter.start(internals.current, ...internals.args);
     }
-    return ref.current;
+    return internals.ref;
 }

package/util/start.d.ts

@@ -1,7 +1,7 @@
 import type { Disposable } from "./dispose.js";
 import type { Arguments } from "./function.js";
 /** Callback function that starts something with multiple values and returns an optional stop callback. */
-export type Start<T extends Arguments = []> = (...values: T) => Stop | undefined;
+export type Start<T extends Arguments = []> = (...values: T) => Stop | void;
 /** Callback function that stops something. */
 export type Stop = () => void;
 /**