@virentia/net-react 0.1.0

package/README.md

@@ -0,0 +1,32 @@
+# @virentia/net-react
+
+React bindings for [`@virentia/net-core`](https://movpushmov.dev/net/). A net query is a
+Virentia effect, so these hooks are thin sugar over `@virentia/react`'s `useUnit`.
+
+## Install
+
+```sh
+pnpm add @virentia/net-react @virentia/net-core @virentia/react @virentia/core react
+```
+
+## Usage
+
+```tsx
+import { ScopeProvider, useQuery, useMutation } from "@virentia/net-react";
+
+function User({ id }: { id: string }) {
+  const { data, error, pending, run } = useQuery(userQuery);
+  useEffect(() => { run({ id }); }, [id]);
+  if (pending) return <Spinner />;
+  if (error) return <ErrorView />;
+  return <Profile user={data} />;
+}
+```
+
+`useQuery(query)` → `{ data, error, pending, stale, run, refetch, reset }`.
+`useMutation(mutation)` → `{ data, error, pending, mutate, reset }`.
+Wrap the tree in `ScopeProvider` (re-exported) so state is per-scope.
+
+## License
+
+MIT © 2026 movpushmov

package/dist/index.cjs

@@ -0,0 +1,46 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+let _virentia_react = require("@virentia/react");
+//#region lib/use-query.ts
+function useQuery(query) {
+	return (0, _virentia_react.useUnit)({
+		data: query.data,
+		error: query.error,
+		pending: query.pending,
+		stale: query.stale,
+		run: query,
+		refetch: query.refresh,
+		reset: query.reset
+	});
+}
+//#endregion
+//#region lib/use-mutation.ts
+function useMutation(mutation) {
+	return (0, _virentia_react.useUnit)({
+		data: mutation.data,
+		error: mutation.error,
+		pending: mutation.pending,
+		mutate: mutation,
+		reset: mutation.reset
+	});
+}
+//#endregion
+Object.defineProperty(exports, "ScopeProvider", {
+	enumerable: true,
+	get: function() {
+		return _virentia_react.ScopeProvider;
+	}
+});
+exports.useMutation = useMutation;
+Object.defineProperty(exports, "useProvidedScope", {
+	enumerable: true,
+	get: function() {
+		return _virentia_react.useProvidedScope;
+	}
+});
+exports.useQuery = useQuery;
+Object.defineProperty(exports, "useUnit", {
+	enumerable: true,
+	get: function() {
+		return _virentia_react.useUnit;
+	}
+});

package/dist/index.d.cts

@@ -0,0 +1,26 @@
+import { Mutation, Query } from "@virentia/net-core";
+import { ScopeProvider, useProvidedScope, useUnit } from "@virentia/react";
+
+//#region lib/use-query.d.ts
+interface UseQueryResult<Raw, Data, Err> {
+  data: Data | null;
+  error: Err | null;
+  pending: boolean;
+  stale: boolean;
+  run: (params: Raw) => Promise<Data>;
+  refetch: () => Promise<void>;
+  reset: () => Promise<void>;
+}
+declare function useQuery<Raw, Data, Err>(query: Query<Raw, Data, Err>): UseQueryResult<Raw, Data, Err>;
+//#endregion
+//#region lib/use-mutation.d.ts
+interface UseMutationResult<Raw, Data, Err> {
+  data: Data | null;
+  error: Err | null;
+  pending: boolean;
+  mutate: (params: Raw) => Promise<Data>;
+  reset: () => Promise<void>;
+}
+declare function useMutation<Raw, Data, Err>(mutation: Mutation<Raw, Data, Err>): UseMutationResult<Raw, Data, Err>;
+//#endregion
+export { ScopeProvider, type UseMutationResult, type UseQueryResult, useMutation, useProvidedScope, useQuery, useUnit };

package/dist/index.d.mts

@@ -0,0 +1,26 @@
+import { ScopeProvider, useProvidedScope, useUnit } from "@virentia/react";
+import { Mutation, Query } from "@virentia/net-core";
+
+//#region lib/use-query.d.ts
+interface UseQueryResult<Raw, Data, Err> {
+  data: Data | null;
+  error: Err | null;
+  pending: boolean;
+  stale: boolean;
+  run: (params: Raw) => Promise<Data>;
+  refetch: () => Promise<void>;
+  reset: () => Promise<void>;
+}
+declare function useQuery<Raw, Data, Err>(query: Query<Raw, Data, Err>): UseQueryResult<Raw, Data, Err>;
+//#endregion
+//#region lib/use-mutation.d.ts
+interface UseMutationResult<Raw, Data, Err> {
+  data: Data | null;
+  error: Err | null;
+  pending: boolean;
+  mutate: (params: Raw) => Promise<Data>;
+  reset: () => Promise<void>;
+}
+declare function useMutation<Raw, Data, Err>(mutation: Mutation<Raw, Data, Err>): UseMutationResult<Raw, Data, Err>;
+//#endregion
+export { ScopeProvider, type UseMutationResult, type UseQueryResult, useMutation, useProvidedScope, useQuery, useUnit };

package/dist/index.mjs

@@ -0,0 +1,26 @@
+import { ScopeProvider, useProvidedScope, useUnit, useUnit as useUnit$1 } from "@virentia/react";
+//#region lib/use-query.ts
+function useQuery(query) {
+	return useUnit$1({
+		data: query.data,
+		error: query.error,
+		pending: query.pending,
+		stale: query.stale,
+		run: query,
+		refetch: query.refresh,
+		reset: query.reset
+	});
+}
+//#endregion
+//#region lib/use-mutation.ts
+function useMutation(mutation) {
+	return useUnit$1({
+		data: mutation.data,
+		error: mutation.error,
+		pending: mutation.pending,
+		mutate: mutation,
+		reset: mutation.reset
+	});
+}
+//#endregion
+export { ScopeProvider, useMutation, useProvidedScope, useQuery, useUnit };

package/package.json

@@ -0,0 +1,55 @@
+{
+  "name": "@virentia/net-react",
+  "version": "0.1.0",
+  "description": "",
+  "keywords": [],
+  "homepage": "https://movpushmov.dev/net/react/",
+  "bugs": {
+    "url": "https://github.com/virentia-labs/net/issues"
+  },
+  "license": "MIT",
+  "author": "movpushmov",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/virentia-labs/net.git",
+    "directory": "packages/react"
+  },
+  "files": [
+    "dist"
+  ],
+  "type": "module",
+  "main": "./dist/index.cjs",
+  "module": "./dist/index.mjs",
+  "types": "./dist/index.d.mts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.mts",
+      "import": "./dist/index.mjs",
+      "require": "./dist/index.cjs"
+    }
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "dependencies": {
+    "@virentia/react": "^0.2.11",
+    "@virentia/net-core": "0.1.0"
+  },
+  "devDependencies": {
+    "@testing-library/react": "^16.3.0",
+    "@types/react": "^19.2.7",
+    "@virentia/core": "0.6.3",
+    "happy-dom": "^20.0.10",
+    "react": "^19.2.1",
+    "react-dom": "^19.2.1"
+  },
+  "peerDependencies": {
+    "@virentia/core": ">=0.4",
+    "react": ">=18"
+  },
+  "scripts": {
+    "build": "tsdown",
+    "test": "vitest run",
+    "test:watch": "vitest"
+  }
+}