@isograph/react 0.0.0-main-5c3c47b2 → 0.0.0-main-79f9cbbb

package/dist/index.d.ts

@@ -17,3 +17,4 @@ export { useLazyReference } from './react/useLazyReference';
 export { useRerenderOnChange } from './react/useRerenderOnChange';
 export { useClientSideDefer } from './loadable-hooks/useClientSideDefer';
 export { useSkipLimitPagination } from './loadable-hooks/useSkipLimitPagination';
+export { useImperativeLoadableField } from './loadable-hooks/useImperativeLoadableField';

package/dist/index.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.useSkipLimitPagination = exports.useClientSideDefer = exports.useRerenderOnChange = exports.useLazyReference = exports.useSubscribeToMultiple = exports.useReadAndSubscribe = exports.useResult = exports.FragmentReader = exports.useImperativeReference = exports.useIsographEnvironment = exports.IsographEnvironmentProvider = exports.stableIdForFragmentReference = exports.readButDoNotEvaluate = exports.assertIsEntrypoint = exports.defaultMissingFieldHandler = exports.createIsographStore = exports.createIsographEnvironment = exports.ROOT_ID = exports.makeNetworkRequest = exports.normalizeData = exports.subscribe = exports.wrapPromise = exports.wrapResolvedValue = exports.getPromiseState = exports.readPromise = exports.garbageCollectEnvironment = exports.unretainQuery = exports.retainQuery = void 0;
+exports.useImperativeLoadableField = exports.useSkipLimitPagination = exports.useClientSideDefer = exports.useRerenderOnChange = exports.useLazyReference = exports.useSubscribeToMultiple = exports.useReadAndSubscribe = exports.useResult = exports.FragmentReader = exports.useImperativeReference = exports.useIsographEnvironment = exports.IsographEnvironmentProvider = exports.stableIdForFragmentReference = exports.readButDoNotEvaluate = exports.assertIsEntrypoint = exports.defaultMissingFieldHandler = exports.createIsographStore = exports.createIsographEnvironment = exports.ROOT_ID = exports.makeNetworkRequest = exports.normalizeData = exports.subscribe = exports.wrapPromise = exports.wrapResolvedValue = exports.getPromiseState = exports.readPromise = exports.garbageCollectEnvironment = exports.unretainQuery = exports.retainQuery = void 0;
 var garbageCollection_1 = require("./core/garbageCollection");
 Object.defineProperty(exports, "retainQuery", { enumerable: true, get: function () { return garbageCollection_1.retainQuery; } });
 Object.defineProperty(exports, "unretainQuery", { enumerable: true, get: function () { return garbageCollection_1.unretainQuery; } });
@@ -46,3 +46,5 @@ var useClientSideDefer_1 = require("./loadable-hooks/useClientSideDefer");
 Object.defineProperty(exports, "useClientSideDefer", { enumerable: true, get: function () { return useClientSideDefer_1.useClientSideDefer; } });
 var useSkipLimitPagination_1 = require("./loadable-hooks/useSkipLimitPagination");
 Object.defineProperty(exports, "useSkipLimitPagination", { enumerable: true, get: function () { return useSkipLimitPagination_1.useSkipLimitPagination; } });
+var useImperativeLoadableField_1 = require("./loadable-hooks/useImperativeLoadableField");
+Object.defineProperty(exports, "useImperativeLoadableField", { enumerable: true, get: function () { return useImperativeLoadableField_1.useImperativeLoadableField; } });

package/dist/loadable-hooks/useImperativeLoadableField.d.ts

@@ -0,0 +1,9 @@
+import { FragmentReference } from '../core/FragmentReference';
+import { UnassignedState } from '@isograph/react-disposable-state';
+import { LoadableField } from '../core/reader';
+type UseImperativeLoadableFieldReturn<TArgs, TResult> = {
+    fragmentReference: FragmentReference<any, TResult> | UnassignedState;
+    loadField: (args: TArgs) => void;
+};
+export declare function useImperativeLoadableField<TArgs, TResult>(loadableField: LoadableField<TArgs, TResult>): UseImperativeLoadableFieldReturn<TArgs, TResult>;
+export {};

package/dist/loadable-hooks/useImperativeLoadableField.js

@@ -0,0 +1,15 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.useImperativeLoadableField = void 0;
+const react_disposable_state_1 = require("@isograph/react-disposable-state");
+function useImperativeLoadableField(loadableField) {
+    const { state, setState } = (0, react_disposable_state_1.useUpdatableDisposableState)();
+    return {
+        loadField: (args) => {
+            const [_id, loader] = loadableField(args);
+            setState(loader());
+        },
+        fragmentReference: state,
+    };
+}
+exports.useImperativeLoadableField = useImperativeLoadableField;

package/dist/loadable-hooks/useSkipLimitPagination.d.ts

@@ -21,6 +21,8 @@ type UseSkipLimitReturnValue<TArgs, TItem> = {
  * This hook will suspend if any network request is in flight.
  *
  * Calling fetchMore before the hook mounts is a no-op.
+ *
+ * TODO subscribe to changes
  */
 export declare function useSkipLimitPagination<TArgs extends {
     skip: number | void | null;

package/dist/loadable-hooks/useSkipLimitPagination.js

@@ -26,6 +26,8 @@ function flatten(arr) {
  * This hook will suspend if any network request is in flight.
  *
  * Calling fetchMore before the hook mounts is a no-op.
+ *
+ * TODO subscribe to changes
  */
 function useSkipLimitPagination(loadableField) {
     const networkRequestOptions = {

package/dist/react/useImperativeReference.js

@@ -6,6 +6,7 @@ const IsographEnvironmentProvider_1 = require("./IsographEnvironmentProvider");
 const IsographEnvironment_1 = require("../core/IsographEnvironment");
 const makeNetworkRequest_1 = require("../core/makeNetworkRequest");
 const PromiseWrapper_1 = require("../core/PromiseWrapper");
+// TODO rename this to useImperativelyLoadedEntrypoint
 function useImperativeReference(entrypoint) {
     const { state, setState } = (0, react_disposable_state_1.useUpdatableDisposableState)();
     const environment = (0, IsographEnvironmentProvider_1.useIsographEnvironment)();

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@isograph/react",
-  "version": "0.0.0-main-5c3c47b2",
+  "version": "0.0.0-main-79f9cbbb",
   "description": "Use Isograph with React",
   "homepage": "https://isograph.dev",
   "main": "dist/index.js",
@@ -17,9 +17,9 @@
     "tsc": "tsc"
   },
   "dependencies": {
-    "@isograph/disposable-types": "0.0.0-main-5c3c47b2",
-    "@isograph/react-disposable-state": "0.0.0-main-5c3c47b2",
-    "@isograph/reference-counted-pointer": "0.0.0-main-5c3c47b2"
+    "@isograph/disposable-types": "0.0.0-main-79f9cbbb",
+    "@isograph/react-disposable-state": "0.0.0-main-79f9cbbb",
+    "@isograph/reference-counted-pointer": "0.0.0-main-79f9cbbb"
   },
   "peerDependencies": {
     "react": "18.2.0"

package/src/index.ts

@@ -82,3 +82,4 @@ export { useRerenderOnChange } from './react/useRerenderOnChange';
 
 export { useClientSideDefer } from './loadable-hooks/useClientSideDefer';
 export { useSkipLimitPagination } from './loadable-hooks/useSkipLimitPagination';
+export { useImperativeLoadableField } from './loadable-hooks/useImperativeLoadableField';

package/src/loadable-hooks/useImperativeLoadableField.ts

@@ -0,0 +1,26 @@
+import { FragmentReference } from '../core/FragmentReference';
+import {
+  UnassignedState,
+  useUpdatableDisposableState,
+} from '@isograph/react-disposable-state';
+import { LoadableField } from '../core/reader';
+
+type UseImperativeLoadableFieldReturn<TArgs, TResult> = {
+  fragmentReference: FragmentReference<any, TResult> | UnassignedState;
+  loadField: (args: TArgs) => void;
+};
+
+export function useImperativeLoadableField<TArgs, TResult>(
+  loadableField: LoadableField<TArgs, TResult>,
+): UseImperativeLoadableFieldReturn<TArgs, TResult> {
+  const { state, setState } =
+    useUpdatableDisposableState<FragmentReference<any, TResult>>();
+
+  return {
+    loadField: (args: TArgs) => {
+      const [_id, loader] = loadableField(args);
+      setState(loader());
+    },
+    fragmentReference: state,
+  };
+}

package/src/loadable-hooks/useSkipLimitPagination.ts

@@ -60,6 +60,8 @@ function flatten<T>(arr: ReadonlyArray<ReadonlyArray<T>>): ReadonlyArray<T> {
  * This hook will suspend if any network request is in flight.
  *
  * Calling fetchMore before the hook mounts is a no-op.
+ *
+ * TODO subscribe to changes
  */
 export function useSkipLimitPagination<
   TArgs extends {

package/src/react/useImperativeReference.ts

@@ -9,6 +9,8 @@ import { ROOT_ID } from '../core/IsographEnvironment';
 import { makeNetworkRequest } from '../core/makeNetworkRequest';
 import { wrapResolvedValue } from '../core/PromiseWrapper';
 
+// TODO rename this to useImperativelyLoadedEntrypoint
+
 export function useImperativeReference<
   TReadFromStore extends Object,
   TClientFieldValue,