@indietabletop/appkit 0.2.1 → 0.2.3

package/dist/use-async-op.d.ts

@@ -0,0 +1,6 @@
+import { AsyncOp } from "./async-op.js";
+export declare function useAsyncOp<T, E>(): {
+    op: AsyncOp<T, E>;
+    setSuccess: (value: T) => void;
+    setFailure: (failure: E) => void;
+};

package/dist/use-async-op.js

@@ -0,0 +1,12 @@
+import { useCallback, useState } from "react";
+import { Failure, Pending, Success } from "./async-op.js";
+export function useAsyncOp() {
+    const [op, setOp] = useState(new Pending());
+    const setSuccess = useCallback((value) => {
+        setOp(new Success(value));
+    }, []);
+    const setFailure = useCallback((failure) => {
+        setOp(new Failure(failure));
+    }, []);
+    return { op, setSuccess, setFailure };
+}

package/dist/use-document-color.d.ts

@@ -0,0 +1,4 @@
+/**
+ * Sets document background color, reverting it to previous color on unmount.
+ */
+export declare function useDocumentBackgroundColor(bodyColor: string): void;

package/dist/use-document-color.js

@@ -0,0 +1,14 @@
+import { useEffect } from "react";
+/**
+ * Sets document background color, reverting it to previous color on unmount.
+ */
+export function useDocumentBackgroundColor(bodyColor) {
+    useEffect(() => {
+        const style = window.document.documentElement.style;
+        const originalColor = style.backgroundColor;
+        style.backgroundColor = bodyColor;
+        return () => {
+            style.backgroundColor = originalColor;
+        };
+    });
+}

package/dist/use-is-installed.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Checks whether the app is installed.
+ *
+ * Note that this doesn't check whether the app is installed on the device at
+ * all, only whether the currently running process is within an installed window
+ * or running within a browser.
+ */
+export declare function useIsInstalled(): boolean;

package/dist/use-is-installed.js

@@ -0,0 +1,13 @@
+import { useMemo } from "react";
+/**
+ * Checks whether the app is installed.
+ *
+ * Note that this doesn't check whether the app is installed on the device at
+ * all, only whether the currently running process is within an installed window
+ * or running within a browser.
+ */
+export function useIsInstalled() {
+    // The only way to get into the Standalone display mode is to install
+    // the app, so this is a good way to check installation status.
+    return useMemo(() => window.matchMedia("(display-mode: standalone)").matches, []);
+}

package/dist/use-reverting-state.d.ts

@@ -0,0 +1,5 @@
+/**
+ * Sets a state that will automatically revert to null after specified number
+ * of milliseconds.
+ */
+export declare function useRevertingState<T>(initialState: T, revertAfterMs: number): readonly [T | null, import("react").Dispatch<import("react").SetStateAction<T | null>>];

package/dist/use-reverting-state.js

@@ -0,0 +1,26 @@
+import { useEffect, useRef, useState } from "react";
+/**
+ * Sets a state that will automatically revert to null after specified number
+ * of milliseconds.
+ */
+export function useRevertingState(initialState, revertAfterMs) {
+    const [state, setState] = useState(initialState);
+    const timeoutRef = useRef(null);
+    useEffect(() => {
+        const timeoutId = timeoutRef.current;
+        if (timeoutId) {
+            clearInterval(timeoutId);
+        }
+        if (state) {
+            timeoutRef.current = setTimeout(() => {
+                setState(null);
+            }, revertAfterMs);
+        }
+        return () => {
+            if (timeoutId) {
+                clearTimeout(timeoutId);
+            }
+        };
+    }, [revertAfterMs, state]);
+    return [state, setState];
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@indietabletop/appkit",
-  "version": "0.2.1",
+  "version": "0.2.3",
   "description": "A collection of modules used in apps built by Indie Tabletop Club",
   "private": false,
   "type": "module",