@isograph/react 0.0.0-main-15990be5 → 0.0.0-main-cd7d2fe9

package/dist/react/useLazyReference.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"useLazyReference.d.ts","sourceRoot":"","sources":["../../src/react/useLazyReference.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAC7C,OAAO,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAC;AACxD,OAAO,EACL,iBAAiB,EACjB,iBAAiB,EAClB,MAAM,2BAA2B,CAAC;AAInC,wBAAgB,gBAAgB,CAC9B,cAAc,SAAS;IAAE,UAAU,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,EAC3D,iBAAiB,EAEjB,UAAU,EAAE,kBAAkB,CAAC,cAAc,EAAE,iBAAiB,CAAC,EACjE,SAAS,EAAE,iBAAiB,CAAC,cAAc,CAAC,EAC5C,YAAY,CAAC,EAAE,YAAY,CAAC,iBAAiB,CAAC,GAC7C;IACD,iBAAiB,EAAE,iBAAiB,CAAC,cAAc,EAAE,iBAAiB,CAAC,CAAC;CACzE,CAqBA"}
+{"version":3,"file":"useLazyReference.d.ts","sourceRoot":"","sources":["../../src/react/useLazyReference.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAC7C,OAAO,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAC;AACxD,OAAO,EACL,iBAAiB,EACjB,iBAAiB,EAClB,MAAM,2BAA2B,CAAC;AAEnC,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAGlD,wBAAgB,gBAAgB,CAC9B,cAAc,SAAS;IACrB,UAAU,EAAE,MAAM,CAAC;IACnB,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,CAAC,EAAE,WAAW,CAAC,MAAM,CAAC,CAAC;CACnC,EACD,iBAAiB,EAEjB,UAAU,EAAE,kBAAkB,CAAC,cAAc,EAAE,iBAAiB,CAAC,EACjE,SAAS,EAAE,iBAAiB,CAAC,cAAc,CAAC,EAC5C,YAAY,CAAC,EAAE,YAAY,CAAC,iBAAiB,CAAC,GAC7C;IACD,iBAAiB,EAAE,iBAAiB,CAAC,cAAc,EAAE,iBAAiB,CAAC,CAAC;CACzE,CAqBA"}

package/dist/react/useReadAndSubscribe.d.ts

@@ -1,16 +1,18 @@
 import { ExtractData, FragmentReference } from '../core/FragmentReference';
 import { NetworkRequestReaderOptions, WithEncounteredRecords } from '../core/read';
-import type { ReaderAst } from '../core/reader';
+import type { ReaderAst, StartUpdate } from '../core/reader';
 /**
  * Read the data from a fragment reference and subscribe to updates.
  */
 export declare function useReadAndSubscribe<TReadFromStore extends {
     parameters: object;
     data: object;
+    startUpdate?: StartUpdate<object>;
 }>(fragmentReference: FragmentReference<TReadFromStore, any>, networkRequestOptions: NetworkRequestReaderOptions, readerAst: ReaderAst<TReadFromStore>): ExtractData<TReadFromStore>;
 export declare function useSubscribeToMultiple<TReadFromStore extends {
     parameters: object;
     data: object;
+    startUpdate?: StartUpdate<object>;
 }>(items: ReadonlyArray<{
     records: WithEncounteredRecords<TReadFromStore>;
     callback: (updatedRecords: WithEncounteredRecords<TReadFromStore>) => void;

package/dist/react/useReadAndSubscribe.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"useReadAndSubscribe.d.ts","sourceRoot":"","sources":["../../src/react/useReadAndSubscribe.ts"],"names":[],"mappings":"AAEA,OAAO,EACL,WAAW,EACX,iBAAiB,EAElB,MAAM,2BAA2B,CAAC;AACnC,OAAO,EACL,2BAA2B,EAE3B,sBAAsB,EACvB,MAAM,cAAc,CAAC;AACtB,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAIhD;;GAEG;AACH,wBAAgB,mBAAmB,CACjC,cAAc,SAAS;IAAE,UAAU,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,EAE3D,iBAAiB,EAAE,iBAAiB,CAAC,cAAc,EAAE,GAAG,CAAC,EACzD,qBAAqB,EAAE,2BAA2B,EAClD,SAAS,EAAE,SAAS,CAAC,cAAc,CAAC,GACnC,WAAW,CAAC,cAAc,CAAC,CAY7B;AAED,wBAAgB,sBAAsB,CACpC,cAAc,SAAS;IAAE,UAAU,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,EAE3D,KAAK,EAAE,aAAa,CAAC;IACnB,OAAO,EAAE,sBAAsB,CAAC,cAAc,CAAC,CAAC;IAChD,QAAQ,EAAE,CAAC,cAAc,EAAE,sBAAsB,CAAC,cAAc,CAAC,KAAK,IAAI,CAAC;IAC3E,iBAAiB,EAAE,iBAAiB,CAAC,cAAc,EAAE,GAAG,CAAC,CAAC;IAC1D,SAAS,EAAE,SAAS,CAAC,cAAc,CAAC,CAAC;CACtC,CAAC,QAiCH"}
+{"version":3,"file":"useReadAndSubscribe.d.ts","sourceRoot":"","sources":["../../src/react/useReadAndSubscribe.ts"],"names":[],"mappings":"AAEA,OAAO,EACL,WAAW,EACX,iBAAiB,EAElB,MAAM,2BAA2B,CAAC;AACnC,OAAO,EACL,2BAA2B,EAE3B,sBAAsB,EACvB,MAAM,cAAc,CAAC;AACtB,OAAO,KAAK,EAAE,SAAS,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAI7D;;GAEG;AACH,wBAAgB,mBAAmB,CACjC,cAAc,SAAS;IACrB,UAAU,EAAE,MAAM,CAAC;IACnB,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,CAAC,EAAE,WAAW,CAAC,MAAM,CAAC,CAAC;CACnC,EAED,iBAAiB,EAAE,iBAAiB,CAAC,cAAc,EAAE,GAAG,CAAC,EACzD,qBAAqB,EAAE,2BAA2B,EAClD,SAAS,EAAE,SAAS,CAAC,cAAc,CAAC,GACnC,WAAW,CAAC,cAAc,CAAC,CAY7B;AAED,wBAAgB,sBAAsB,CACpC,cAAc,SAAS;IACrB,UAAU,EAAE,MAAM,CAAC;IACnB,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,CAAC,EAAE,WAAW,CAAC,MAAM,CAAC,CAAC;CACnC,EAED,KAAK,EAAE,aAAa,CAAC;IACnB,OAAO,EAAE,sBAAsB,CAAC,cAAc,CAAC,CAAC;IAChD,QAAQ,EAAE,CAAC,cAAc,EAAE,sBAAsB,CAAC,cAAc,CAAC,KAAK,IAAI,CAAC;IAC3E,iBAAiB,EAAE,iBAAiB,CAAC,cAAc,EAAE,GAAG,CAAC,CAAC;IAC1D,SAAS,EAAE,SAAS,CAAC,cAAc,CAAC,CAAC;CACtC,CAAC,QAiCH"}

package/dist/react/useResult.d.ts

@@ -1,9 +1,11 @@
 import { FragmentReference } from '../core/FragmentReference';
 import { PromiseWrapper } from '../core/PromiseWrapper';
 import { NetworkRequestReaderOptions } from '../core/read';
+import type { StartUpdate } from '../core/reader';
 export declare function useResult<TReadFromStore extends {
     parameters: object;
     data: object;
+    startUpdate?: StartUpdate<object>;
 }, TClientFieldValue>(fragmentReference: FragmentReference<TReadFromStore, TClientFieldValue>, partialNetworkRequestOptions?: Partial<NetworkRequestReaderOptions> | void): TClientFieldValue;
 export declare function maybeUnwrapNetworkRequest(networkRequest: PromiseWrapper<void, any>, networkRequestOptions: NetworkRequestReaderOptions): void;
 //# sourceMappingURL=useResult.d.ts.map

package/dist/react/useResult.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"useResult.d.ts","sourceRoot":"","sources":["../../src/react/useResult.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,iBAAiB,EAAE,MAAM,2BAA2B,CAAC;AAC9D,OAAO,EAEL,cAAc,EAEf,MAAM,wBAAwB,CAAC;AAChC,OAAO,EAEL,2BAA2B,EAC5B,MAAM,cAAc,CAAC;AAItB,wBAAgB,SAAS,CACvB,cAAc,SAAS;IAAE,UAAU,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,EAC3D,iBAAiB,EAEjB,iBAAiB,EAAE,iBAAiB,CAAC,cAAc,EAAE,iBAAiB,CAAC,EACvE,4BAA4B,CAAC,EAAE,OAAO,CAAC,2BAA2B,CAAC,GAAG,IAAI,GACzE,iBAAiB,CAqCnB;AAED,wBAAgB,yBAAyB,CACvC,cAAc,EAAE,cAAc,CAAC,IAAI,EAAE,GAAG,CAAC,EACzC,qBAAqB,EAAE,2BAA2B,QAWnD"}
+{"version":3,"file":"useResult.d.ts","sourceRoot":"","sources":["../../src/react/useResult.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,iBAAiB,EAAE,MAAM,2BAA2B,CAAC;AAC9D,OAAO,EAEL,cAAc,EAEf,MAAM,wBAAwB,CAAC;AAChC,OAAO,EAEL,2BAA2B,EAC5B,MAAM,cAAc,CAAC;AACtB,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAKlD,wBAAgB,SAAS,CACvB,cAAc,SAAS;IACrB,UAAU,EAAE,MAAM,CAAC;IACnB,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,CAAC,EAAE,WAAW,CAAC,MAAM,CAAC,CAAC;CACnC,EACD,iBAAiB,EAEjB,iBAAiB,EAAE,iBAAiB,CAAC,cAAc,EAAE,iBAAiB,CAAC,EACvE,4BAA4B,CAAC,EAAE,OAAO,CAAC,2BAA2B,CAAC,GAAG,IAAI,GACzE,iBAAiB,CAwCnB;AAED,wBAAgB,yBAAyB,CACvC,cAAc,EAAE,cAAc,CAAC,IAAI,EAAE,GAAG,CAAC,EACzC,qBAAqB,EAAE,2BAA2B,QAWnD"}

package/dist/react/useResult.js

@@ -5,6 +5,7 @@ exports.maybeUnwrapNetworkRequest = maybeUnwrapNetworkRequest;
 const componentCache_1 = require("../core/componentCache");
 const PromiseWrapper_1 = require("../core/PromiseWrapper");
 const read_1 = require("../core/read");
+const startUpdate_1 = require("../core/startUpdate");
 const IsographEnvironmentProvider_1 = require("../react/IsographEnvironmentProvider");
 const useReadAndSubscribe_1 = require("./useReadAndSubscribe");
 function useResult(fragmentReference, partialNetworkRequestOptions) {
@@ -22,6 +23,9 @@ function useResult(fragmentReference, partialNetworkRequestOptions) {
             const param = {
                 data: data,
                 parameters: fragmentReference.variables,
+                startUpdate: readerWithRefetchQueries.readerArtifact.hasUpdatable
+                    ? (0, startUpdate_1.startUpdate)(environment, data)
+                    : undefined,
             };
             return readerWithRefetchQueries.readerArtifact.resolver(param);
         }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@isograph/react",
-  "version": "0.0.0-main-15990be5",
+  "version": "0.0.0-main-cd7d2fe9",
   "description": "Use Isograph with React",
   "homepage": "https://isograph.dev",
   "main": "dist/index.js",
@@ -19,9 +19,9 @@
     "iso-watch": "cross-env ../../target/debug/isograph_cli --config ./isograph.config.json --watch"
   },
   "dependencies": {
-    "@isograph/disposable-types": "0.0.0-main-15990be5",
-    "@isograph/react-disposable-state": "0.0.0-main-15990be5",
-    "@isograph/reference-counted-pointer": "0.0.0-main-15990be5"
+    "@isograph/disposable-types": "0.0.0-main-cd7d2fe9",
+    "@isograph/react-disposable-state": "0.0.0-main-cd7d2fe9",
+    "@isograph/reference-counted-pointer": "0.0.0-main-cd7d2fe9"
   },
   "peerDependencies": {
     "react": "^18.0.0 || ^19.0.0"

package/src/core/FragmentReference.ts

@@ -1,6 +1,7 @@
 import { ReaderWithRefetchQueries } from '../core/entrypoint';
 import { type Link } from './IsographEnvironment';
 import { PromiseWrapper } from './PromiseWrapper';
+import type { StartUpdate } from './reader';
 
 // TODO type this better
 export type VariableValue = string | number | boolean | null | object;
@@ -19,8 +20,18 @@ export type ExtractParameters<T> = T extends {
   ? P
   : Variables;
 
+export type ExtractStartUpdate<
+  T extends {
+    startUpdate?: StartUpdate<object>;
+  },
+> = T['startUpdate'];
+
 export type FragmentReference<
-  TReadFromStore extends { parameters: object; data: object },
+  TReadFromStore extends {
+    parameters: object;
+    data: object;
+    startUpdate?: StartUpdate<object>;
+  },
   TClientFieldValue,
 > = {
   readonly kind: 'FragmentReference';

package/src/core/IsographEnvironment.ts

@@ -5,7 +5,7 @@ import { RetainedQuery } from './garbageCollection';
 import { LogFunction, WrappedLogFunction } from './logging';
 import { PromiseWrapper, wrapPromise } from './PromiseWrapper';
 import { WithEncounteredRecords } from './read';
-import type { ReaderAst } from './reader';
+import type { ReaderAst, StartUpdate } from './reader';
 
 export type ComponentOrFieldName = string;
 export type StringifiedArgs = string;
@@ -16,7 +16,11 @@ type ComponentCache = {
 };
 
 export type FragmentSubscription<
-  TReadFromStore extends { parameters: object; data: object },
+  TReadFromStore extends {
+    parameters: object;
+    data: object;
+    startUpdate?: StartUpdate<object>;
+  },
 > = {
   readonly kind: 'FragmentSubscription';
   readonly callback: (
@@ -40,7 +44,7 @@ type AnyRecordSubscription = {
 };
 
 type Subscription =
-  | FragmentSubscription<{ parameters: object; data: object }>
+  | FragmentSubscription<any>
   | AnyChangesToRecordSubscription
   | AnyRecordSubscription;
 type Subscriptions = Set<Subscription>;

package/src/core/cache.ts

@@ -33,13 +33,22 @@ import { logMessage } from './logging';
 import { maybeMakeNetworkRequest } from './makeNetworkRequest';
 import { wrapResolvedValue } from './PromiseWrapper';
 import { readButDoNotEvaluate, WithEncounteredRecords } from './read';
-import { ReaderLinkedField, ReaderScalarField, type ReaderAst } from './reader';
+import {
+  ReaderLinkedField,
+  ReaderScalarField,
+  type ReaderAst,
+  type StartUpdate,
+} from './reader';
 import { Argument, ArgumentValue } from './util';
 
 export const TYPENAME_FIELD_NAME = '__typename';
 
 export function getOrCreateItemInSuspenseCache<
-  TReadFromStore extends { parameters: object; data: object },
+  TReadFromStore extends {
+    parameters: object;
+    data: object;
+    startUpdate?: StartUpdate<object>;
+  },
   TClientFieldValue,
 >(
   environment: IsographEnvironment,
@@ -83,7 +92,11 @@ export function stableCopy<T>(value: T): T {
 }
 
 export function getOrCreateCacheForArtifact<
-  TReadFromStore extends { parameters: object; data: object },
+  TReadFromStore extends {
+    parameters: object;
+    data: object;
+    startUpdate?: StartUpdate<object>;
+  },
   TClientFieldValue,
 >(
   environment: IsographEnvironment,
@@ -209,7 +222,11 @@ export function subscribeToAnyChangesToRecord(
 
 // TODO we should re-read and call callback if the value has changed
 export function subscribe<
-  TReadFromStore extends { parameters: object; data: object },
+  TReadFromStore extends {
+    parameters: object;
+    data: object;
+    startUpdate?: StartUpdate<object>;
+  },
 >(
   environment: IsographEnvironment,
   encounteredDataAndRecords: WithEncounteredRecords<TReadFromStore>,

package/src/core/componentCache.ts

@@ -5,6 +5,7 @@ import { IsographEnvironment } from './IsographEnvironment';
 import { logMessage } from './logging';
 import { readPromise } from './PromiseWrapper';
 import { NetworkRequestReaderOptions } from './read';
+import { startUpdate } from './startUpdate';
 
 export function getOrCreateCachedComponent(
   environment: IsographEnvironment,
@@ -51,6 +52,9 @@ export function getOrCreateCachedComponent(
           {
             data,
             parameters: fragmentReference.variables,
+            startUpdate: readerWithRefetchQueries.readerArtifact.hasUpdatable
+              ? startUpdate(environment, data)
+              : undefined,
           },
           additionalRuntimeProps,
         );

package/src/core/entrypoint.ts

@@ -1,9 +1,13 @@
 import type { TypeName } from './IsographEnvironment';
-import { TopLevelReaderArtifact } from './reader';
+import { TopLevelReaderArtifact, type StartUpdate } from './reader';
 import { Arguments } from './util';
 
 export type ReaderWithRefetchQueries<
-  TReadFromStore extends { parameters: object; data: object },
+  TReadFromStore extends {
+    parameters: object;
+    data: object;
+    startUpdate?: StartUpdate<object>;
+  },
   TClientFieldValue,
 > = {
   readonly kind: 'ReaderWithRefetchQueries';
@@ -23,7 +27,11 @@ export type NetworkRequestInfo<TNormalizationAst> = {
 };
 // This type should be treated as an opaque type.
 export type IsographEntrypoint<
-  TReadFromStore extends { parameters: object; data: object },
+  TReadFromStore extends {
+    parameters: object;
+    data: object;
+    startUpdate?: StartUpdate<object>;
+  },
   TClientFieldValue,
   TNormalizationAst = NormalizationAst,
 > = {
@@ -37,7 +45,11 @@ export type IsographEntrypoint<
 };
 
 export type IsographEntrypointLoader<
-  TReadFromStore extends { parameters: object; data: object },
+  TReadFromStore extends {
+    parameters: object;
+    data: object;
+    startUpdate?: StartUpdate<object>;
+  },
   TClientFieldValue,
 > = {
   readonly kind: 'EntrypointLoader';
@@ -93,7 +105,11 @@ export type RefetchQueryNormalizationArtifactWrapper = {
 };
 
 export function assertIsEntrypoint<
-  TReadFromStore extends { parameters: object; data: object },
+  TReadFromStore extends {
+    parameters: object;
+    data: object;
+    startUpdate?: StartUpdate<object>;
+  },
   TClientFieldValue,
 >(
   value:

package/src/core/makeNetworkRequest.ts

@@ -6,7 +6,7 @@ import {
   IsographEntrypoint,
   RefetchQueryNormalizationArtifact,
 } from './entrypoint';
-import { ExtractParameters } from './FragmentReference';
+import { ExtractParameters, type FragmentReference } from './FragmentReference';
 import {
   garbageCollectEnvironment,
   RetainedQuery,
@@ -22,11 +22,17 @@ import {
   wrapResolvedValue,
 } from './PromiseWrapper';
 import { readButDoNotEvaluate } from './read';
+import type { StartUpdate } from './reader';
+import { startUpdate } from './startUpdate';
 
 let networkRequestId = 0;
 
 export function maybeMakeNetworkRequest<
-  TReadFromStore extends { parameters: object; data: object },
+  TReadFromStore extends {
+    parameters: object;
+    data: object;
+    startUpdate?: StartUpdate<object>;
+  },
   TClientFieldValue,
 >(
   environment: IsographEnvironment,
@@ -68,7 +74,11 @@ export function maybeMakeNetworkRequest<
 }
 
 export function makeNetworkRequest<
-  TReadFromStore extends { parameters: object; data: object },
+  TReadFromStore extends {
+    parameters: object;
+    data: object;
+    startUpdate?: StartUpdate<object>;
+  },
   TClientFieldValue,
 >(
   environment: IsographEnvironment,
@@ -201,7 +211,11 @@ type NetworkRequestStatus =
     };
 
 function readDataForOnComplete<
-  TReadFromStore extends { parameters: object; data: object },
+  TReadFromStore extends {
+    parameters: object;
+    data: object;
+    startUpdate?: StartUpdate<object>;
+  },
   TClientFieldValue,
 >(
   artifact:
@@ -227,18 +241,19 @@ function readDataForOnComplete<
       throwOnNetworkError: false,
     };
 
+    const fragment: FragmentReference<TReadFromStore, TClientFieldValue> = {
+      kind: 'FragmentReference',
+      // TODO this smells.
+      readerWithRefetchQueries: wrapResolvedValue(
+        artifact.readerWithRefetchQueries,
+      ),
+      root,
+      variables,
+      networkRequest: fakeNetworkRequest,
+    };
     const fragmentResult = readButDoNotEvaluate(
       environment,
-      {
-        kind: 'FragmentReference',
-        // TODO this smells.
-        readerWithRefetchQueries: wrapResolvedValue(
-          artifact.readerWithRefetchQueries,
-        ),
-        root,
-        variables,
-        networkRequest: fakeNetworkRequest,
-      },
+      fragment,
       fakeNetworkRequestOptions,
     ).item;
     const readerArtifact = artifact.readerWithRefetchQueries.readerArtifact;
@@ -269,6 +284,9 @@ function readDataForOnComplete<
         return readerArtifact.resolver({
           data: fragmentResult,
           parameters: variables,
+          startUpdate: readerArtifact.hasUpdatable
+            ? startUpdate(environment, fragmentResult)
+            : undefined,
         });
       }
       default: {

package/src/core/read.ts

@@ -33,7 +33,8 @@ import {
   wrapPromise,
   wrapResolvedValue,
 } from './PromiseWrapper';
-import { ReaderAst } from './reader';
+import { ReaderAst, type StartUpdate } from './reader';
+import { startUpdate } from './startUpdate';
 import { Arguments } from './util';
 
 export type WithEncounteredRecords<T> = {
@@ -42,7 +43,11 @@ export type WithEncounteredRecords<T> = {
 };
 
 export function readButDoNotEvaluate<
-  TReadFromStore extends { parameters: object; data: object },
+  TReadFromStore extends {
+    parameters: object;
+    data: object;
+    startUpdate?: StartUpdate<object>;
+  },
 >(
   environment: IsographEnvironment,
   fragmentReference: FragmentReference<TReadFromStore, unknown>,
@@ -264,6 +269,9 @@ function readData<TReadFromStore>(
           const condition = field.condition.resolver({
             data: data.data,
             parameters: {},
+            startUpdate: field.condition.hasUpdatable
+              ? startUpdate(environment, data)
+              : undefined,
           });
           if (condition === true) {
             link = root;
@@ -427,6 +435,7 @@ function readData<TReadFromStore>(
               const firstParameter = {
                 data: data.data,
                 parameters: variables,
+                startUpdate: () => {},
               };
               target[field.alias] =
                 field.readerArtifact.resolver(firstParameter);

package/src/core/reader.ts

@@ -10,6 +10,7 @@ import {
   ExtractData,
   ExtractParameters,
   FragmentReference,
+  type ExtractStartUpdate,
 } from './FragmentReference';
 import {
   ComponentOrFieldName,
@@ -19,7 +20,11 @@ import {
 import { Arguments } from './util';
 
 export type TopLevelReaderArtifact<
-  TReadFromStore extends { parameters: object; data: object },
+  TReadFromStore extends {
+    parameters: object;
+    data: object;
+    startUpdate?: StartUpdate<object>;
+  },
   TClientFieldValue,
   TComponentProps extends Record<PropertyKey, never>,
 > =
@@ -27,7 +32,11 @@ export type TopLevelReaderArtifact<
   | ComponentReaderArtifact<TReadFromStore, TComponentProps>;
 
 export type EagerReaderArtifact<
-  TReadFromStore extends { parameters: object; data: object },
+  TReadFromStore extends {
+    parameters: object;
+    data: object;
+    startUpdate?: StartUpdate<object>;
+  },
   TClientFieldValue,
 > = {
   readonly kind: 'EagerReaderArtifact';
@@ -35,10 +44,15 @@ export type EagerReaderArtifact<
   readonly resolver: (
     data: ResolverFirstParameter<TReadFromStore>,
   ) => TClientFieldValue;
+  readonly hasUpdatable: boolean;
 };
 
 export type ComponentReaderArtifact<
-  TReadFromStore extends { parameters: object; data: object },
+  TReadFromStore extends {
+    parameters: object;
+    data: object;
+    startUpdate?: StartUpdate<object>;
+  },
   TComponentProps extends Record<string, unknown> = Record<PropertyKey, never>,
 > = {
   readonly kind: 'ComponentReaderArtifact';
@@ -48,15 +62,25 @@ export type ComponentReaderArtifact<
     data: ResolverFirstParameter<TReadFromStore>,
     runtimeProps: TComponentProps,
   ) => React.ReactNode;
+  readonly hasUpdatable: boolean;
 };
 
 export type ResolverFirstParameter<
-  TReadFromStore extends { data: object; parameters: object },
+  TReadFromStore extends {
+    data: object;
+    parameters: object;
+    startUpdate?: StartUpdate<object>;
+  },
 > = {
   data: ExtractData<TReadFromStore>;
   parameters: ExtractParameters<TReadFromStore>;
+  startUpdate: undefined | ExtractStartUpdate<TReadFromStore>;
 };
 
+export type StartUpdate<UpdatableData> = (
+  updater: (updatableData: UpdatableData) => void,
+) => void;
+
 export type RefetchReaderArtifact = {
   readonly kind: 'RefetchReaderArtifact';
   readonly readerAst: ReaderAst<unknown>;
@@ -104,7 +128,7 @@ export type ReaderLinkedField = {
   readonly selections: ReaderAst<unknown>;
   readonly arguments: Arguments | null;
   readonly condition: EagerReaderArtifact<
-    { data: object; parameters: object },
+    { data: object; parameters: any; startUpdate?: StartUpdate<object> },
     boolean | Link | null
   > | null;
 };
@@ -154,7 +178,11 @@ type StableId = string;
 /// except to stringify the args or whatnot. Calling the factory can be
 /// expensive. For example, doing so will probably trigger a network request.
 export type LoadableField<
-  TReadFromStore extends { data: object; parameters: object },
+  TReadFromStore extends {
+    data: object;
+    parameters: object;
+    startUpdate?: StartUpdate<object>;
+  },
   TResult,
   TArgs = ExtractParameters<TReadFromStore>,
 > = (

package/src/core/startUpdate.ts

@@ -0,0 +1,16 @@
+import type { ExtractData, ExtractStartUpdate } from './FragmentReference';
+import type { IsographEnvironment } from './IsographEnvironment';
+import type { StartUpdate } from './reader';
+
+export function startUpdate<
+  TReadFromStore extends {
+    parameters: object;
+    data: object;
+    startUpdate?: StartUpdate<object>;
+  },
+>(
+  _environment: IsographEnvironment,
+  _data: ExtractData<TReadFromStore>,
+): ExtractStartUpdate<TReadFromStore> {
+  return (_updater) => {};
+}

package/src/loadable-hooks/useClientSideDefer.ts

@@ -5,11 +5,15 @@ import {
   ExtractParameters,
   FragmentReference,
 } from '../core/FragmentReference';
-import { LoadableField } from '../core/reader';
+import { LoadableField, type StartUpdate } from '../core/reader';
 import { useIsographEnvironment } from '../react/IsographEnvironmentProvider';
 
 export function useClientSideDefer<
-  TReadFromStore extends { data: object; parameters: object },
+  TReadFromStore extends {
+    data: object;
+    parameters: object;
+    startUpdate?: StartUpdate<object>;
+  },
   TResult,
 >(
   loadableField: LoadableField<
@@ -22,7 +26,11 @@ export function useClientSideDefer<
 ): { fragmentReference: FragmentReference<TReadFromStore, TResult> };
 
 export function useClientSideDefer<
-  TReadFromStore extends { data: object; parameters: object },
+  TReadFromStore extends {
+    data: object;
+    parameters: object;
+    startUpdate?: StartUpdate<object>;
+  },
   TResult,
   TProvidedArgs extends object,
 >(
@@ -36,7 +44,11 @@ export function useClientSideDefer<
 ): { fragmentReference: FragmentReference<TReadFromStore, TResult> };
 
 export function useClientSideDefer<
-  TReadFromStore extends { data: object; parameters: object },
+  TReadFromStore extends {
+    data: object;
+    parameters: object;
+    startUpdate?: StartUpdate<object>;
+  },
   TResult,
   TProvidedArgs extends object,
 >(

package/src/loadable-hooks/useConnectionSpecPagination.ts

@@ -16,13 +16,22 @@ import {
   readButDoNotEvaluate,
   type WithEncounteredRecords,
 } from '../core/read';
-import { LoadableField, type ReaderAst } from '../core/reader';
+import {
+  LoadableField,
+  type ReaderAst,
+  type StartUpdate,
+} from '../core/reader';
+import { startUpdate } from '../core/startUpdate';
 import { useIsographEnvironment } from '../react/IsographEnvironmentProvider';
 import { useSubscribeToMultiple } from '../react/useReadAndSubscribe';
 import { maybeUnwrapNetworkRequest } from '../react/useResult';
 
 type UsePaginationReturnValue<
-  TReadFromStore extends { parameters: object; data: object },
+  TReadFromStore extends {
+    parameters: object;
+    data: object;
+    startUpdate?: StartUpdate<object>;
+  },
   TItem,
 > =
   | {
@@ -86,6 +95,7 @@ export function useConnectionSpecPagination<
   TReadFromStore extends {
     parameters: object;
     data: object;
+    startUpdate?: StartUpdate<object>;
   },
   TItem,
 >(
@@ -128,6 +138,9 @@ export function useConnectionSpecPagination<
       const firstParameter = {
         data,
         parameters: fragmentReference.variables,
+        startUpdate: readerWithRefetchQueries.readerArtifact.hasUpdatable
+          ? startUpdate(environment, data)
+          : undefined,
       };
 
       if (

package/src/loadable-hooks/useSkipLimitPagination.ts

@@ -16,13 +16,22 @@ import {
   readButDoNotEvaluate,
   type WithEncounteredRecords,
 } from '../core/read';
-import { LoadableField, type ReaderAst } from '../core/reader';
+import {
+  LoadableField,
+  type ReaderAst,
+  type StartUpdate,
+} from '../core/reader';
+import { startUpdate } from '../core/startUpdate';
 import { useIsographEnvironment } from '../react/IsographEnvironmentProvider';
 import { useSubscribeToMultiple } from '../react/useReadAndSubscribe';
 import { maybeUnwrapNetworkRequest } from '../react/useResult';
 
 type UseSkipLimitReturnValue<
-  TReadFromStore extends { data: object; parameters: object },
+  TReadFromStore extends {
+    data: object;
+    parameters: object;
+    startUpdate?: StartUpdate<object>;
+  },
   TItem,
 > =
   | {
@@ -43,7 +52,11 @@ type UseSkipLimitReturnValue<
     };
 
 type ArrayFragmentReference<
-  TReadFromStore extends { parameters: object; data: object },
+  TReadFromStore extends {
+    parameters: object;
+    data: object;
+    startUpdate?: StartUpdate<object>;
+  },
   TItem,
 > = FragmentReference<TReadFromStore, ReadonlyArray<TItem>>;
 
@@ -79,6 +92,7 @@ export function useSkipLimitPagination<
   TReadFromStore extends {
     parameters: object;
     data: object;
+    startUpdate?: StartUpdate<object>;
   },
 >(
   loadableField: LoadableField<
@@ -122,6 +136,9 @@ export function useSkipLimitPagination<
       const firstParameter = {
         data,
         parameters: fragmentReference.variables,
+        startUpdate: readerWithRefetchQueries.readerArtifact.hasUpdatable
+          ? startUpdate(environment, data)
+          : undefined,
       };
 
       if (