@t8/react-pending 1.0.22 → 1.0.23

package/dist/index.d.ts

@@ -0,0 +1,4 @@
+export * from "./src/PendingState.ts";
+export * from "./src/PendingStateContext.ts";
+export * from "./src/PendingStateProvider.tsx";
+export * from "./src/usePendingState.ts";

package/dist/src/PendingState.d.ts

@@ -0,0 +1,6 @@
+export type PendingState = {
+    initialized?: boolean | undefined;
+    complete?: boolean | undefined;
+    time?: number | undefined;
+    error?: unknown;
+};

package/dist/src/PendingStateContext.d.ts

@@ -0,0 +1,3 @@
+import type { Store } from "@t8/react-store";
+import type { PendingState } from "./PendingState.ts";
+export declare const PendingStateContext: import("react").Context<Map<string, Store<PendingState>>>;

package/dist/src/PendingStateProvider.d.ts

@@ -0,0 +1,8 @@
+import { Store } from "@t8/react-store";
+import { type ReactNode } from "react";
+import type { PendingState } from "./PendingState.ts";
+export type PendingStateProviderProps = {
+    value?: Record<string, PendingState> | Map<string, Store<PendingState>> | null | undefined;
+    children?: ReactNode;
+};
+export declare const PendingStateProvider: ({ value, children, }: PendingStateProviderProps) => import("react/jsx-runtime").JSX.Element;

package/dist/src/usePendingState.d.ts

@@ -0,0 +1,23 @@
+import { type SetStoreState, Store } from "@t8/react-store";
+import type { PendingState } from "./PendingState.ts";
+export type WithStateOptions = {
+    silent?: boolean;
+    throws?: boolean;
+    delay?: number;
+};
+/**
+ * Returns an array containing `[state, withState, setState]`:
+ * - `state` reflects the state of a value passed to `withState()`;
+ * - `withState(value, [options])` enables the tracking of the state
+ * of `value`; setting the options to `{silent: true}` prevents
+ * `withState()` from updating the state while `value` is pending
+ * (e.g. for background or optimistic updates);
+ * - `setState()` to directly update the state.
+ */
+export declare function usePendingState(
+/**
+ * A unique store key or a store. Providing a store key or a
+ * shared store allows to share the state across multiple
+ * components.
+ */
+store?: string | Store<PendingState> | null): [PendingState, <T>(value: T) => T, SetStoreState<PendingState>];

package/package.json

@@ -1,11 +1,12 @@
 {
   "name": "@t8/react-pending",
-  "version": "1.0.22",
+  "version": "1.0.23",
   "description": "Concise async action state tracking for React apps",
   "main": "dist/index.js",
+  "types": "dist/index.d.ts",
   "type": "module",
   "scripts": {
-    "build": "npx npm-run-all clean compile",
+    "build": "npx npm-run-all clean compile types",
     "clean": "node -e \"require('node:fs').rmSync('dist', { force: true, recursive: true });\"",
     "compile": "npx esbuild index.ts --bundle --outdir=dist --platform=neutral --external:react",
     "demo": "npx @t8/serve 3000 * tests/async_status -b src/index.tsx",
@@ -13,7 +14,8 @@
     "preversion": "npx npm-run-all typecheck shape build test",
     "shape": "npx codeshape",
     "test": "npx playwright test --project=chromium",
-    "typecheck": "tsc --noEmit"
+    "typecheck": "tsc --noEmit",
+    "types": "tsc -p tsconfig.build.json"
   },
   "author": "axtk",
   "license": "MIT",
@@ -32,7 +34,7 @@
   },
   "devDependencies": {
     "@playwright/test": "^1.56.0",
-    "@t8/serve": "^0.1.34",
+    "@t8/serve": "^0.1.35",
     "@types/node": "^24.5.2",
     "@types/react": "^19.1.10",
     "@types/react-dom": "^19.1.9",
@@ -40,6 +42,6 @@
     "typescript": "^5.9.3"
   },
   "dependencies": {
-    "@t8/react-store": "^1.0.33"
+    "@t8/react-store": "^1.0.34"
   }
 }

package/tsconfig.build.json

@@ -0,0 +1,4 @@
+{
+  "extends": "./tsconfig.json",
+  "include": ["./index.ts", "./src"]
+}

package/tsconfig.json

@@ -1,7 +1,8 @@
 {
   "include": ["./index.ts", "./playwright.config.ts", "./src", "./tests"],
   "compilerOptions": {
-    "noEmit": true,
+    "declaration": true,
+    "emitDeclarationOnly": true,
     "lib": ["ESNext", "DOM"],
     "target": "esnext",
     "outDir": "dist",