@cedarjs/web 9.0.0-canary.1784 → 9.0.0-canary.3124

package/dist/components/{RedwoodProvider.d.ts → CedarProvider.d.ts}

@@ -3,7 +3,9 @@ interface RedwoodProviderProps {
     children: React.ReactNode;
     titleTemplate?: string;
 }
+export declare const CedarProvider: ({ children, titleTemplate, }: RedwoodProviderProps) => React.JSX.Element;
+/** @deprecated Please use CedarProvider instead */
 export declare const RedwoodProvider: ({ children, titleTemplate, }: RedwoodProviderProps) => React.JSX.Element;
 declare global { }
 export {};
-//# sourceMappingURL=RedwoodProvider.d.ts.map
+//# sourceMappingURL=CedarProvider.d.ts.map

package/dist/components/CedarProvider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"CedarProvider.d.ts","sourceRoot":"","sources":["../../src/components/CedarProvider.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAA;AAKzB,UAAU,oBAAoB;IAC5B,QAAQ,EAAE,KAAK,CAAC,SAAS,CAAA;IACzB,aAAa,CAAC,EAAE,MAAM,CAAA;CACvB;AAED,eAAO,MAAM,aAAa,GAAI,8BAG3B,oBAAoB,sBAuBtB,CAAA;AAED,mDAAmD;AACnD,eAAO,MAAM,eAAe,iCA1BzB,oBAAoB,sBA0BqB,CAAA;AAE5C,OAAO,CAAC,MAAM,CAAC,GAAE"}

package/dist/components/{RedwoodProvider.js → CedarProvider.js}

@@ -1,7 +1,6 @@
 import React from "react";
-import * as helmetPkg from "@dr.pogodin/react-helmet";
-const { Helmet, HelmetProvider } = helmetPkg;
-const RedwoodProvider = ({
+import { Helmet, HelmetProvider } from "@dr.pogodin/react-helmet";
+const CedarProvider = ({
   children,
   titleTemplate
 }) => {
@@ -19,6 +18,8 @@ const RedwoodProvider = ({
   }
   return /* @__PURE__ */ React.createElement(HelmetProvider, { context: globalThis.__REDWOOD__HELMET_CONTEXT }, /* @__PURE__ */ React.createElement(Helmet, { titleTemplate: template(), defaultTitle: appTitle }, /* @__PURE__ */ React.createElement("title", null, appTitle)), children);
 };
+const RedwoodProvider = CedarProvider;
 export {
+  CedarProvider,
   RedwoodProvider
 };

package/dist/components/DevFatalErrorPage.d.ts

@@ -1,17 +1,17 @@
 import React from 'react';
-import type { GraphQLError } from 'graphql';
+import type { GraphQLFormattedError } from 'graphql';
 type RequestDetails = {
     query: string;
     operationName: string;
     operationKind: string;
     variables: any;
 };
-interface EnhancedGqlError extends GraphQLError {
+interface EnhancedGqlError extends GraphQLFormattedError {
     __RedwoodEnhancedError: RequestDetails;
 }
 type ErrorWithRequestMeta = Error & {
     mostRecentRequest?: RequestDetails;
-    graphQLErrors?: EnhancedGqlError[];
+    errors?: EnhancedGqlError[];
     mostRecentResponse?: any;
 };
 export declare const DevFatalErrorPage: (props: {

package/dist/components/DevFatalErrorPage.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"DevFatalErrorPage.d.ts","sourceRoot":"","sources":["../../src/components/DevFatalErrorPage.tsx"],"names":[],"mappings":"AAKA,OAAO,KAAsC,MAAM,OAAO,CAAA;AAE1D,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,SAAS,CAAA;AAmB3C,KAAK,cAAc,GAAG;IACpB,KAAK,EAAE,MAAM,CAAA;IACb,aAAa,EAAE,MAAM,CAAA;IACrB,aAAa,EAAE,MAAM,CAAA;IACrB,SAAS,EAAE,GAAG,CAAA;CACf,CAAA;AAED,UAAU,gBAAiB,SAAQ,YAAY;IAC7C,sBAAsB,EAAE,cAAc,CAAA;CACvC;AAGD,KAAK,oBAAoB,GAAG,KAAK,GAAG;IAClC,iBAAiB,CAAC,EAAE,cAAc,CAAA;IAClC,aAAa,CAAC,EAAE,gBAAgB,EAAE,CAAA;IAClC,kBAAkB,CAAC,EAAE,GAAG,CAAA;CACzB,CAAA;AAiGD,eAAO,MAAM,iBAAiB,GAAI,OAAO;IAAE,KAAK,CAAC,EAAE,oBAAoB,CAAA;CAAE,sBA4FxE,CAAA"}
+{"version":3,"file":"DevFatalErrorPage.d.ts","sourceRoot":"","sources":["../../src/components/DevFatalErrorPage.tsx"],"names":[],"mappings":"AAKA,OAAO,KAAsC,MAAM,OAAO,CAAA;AAE1D,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,SAAS,CAAA;AAmBpD,KAAK,cAAc,GAAG;IACpB,KAAK,EAAE,MAAM,CAAA;IACb,aAAa,EAAE,MAAM,CAAA;IACrB,aAAa,EAAE,MAAM,CAAA;IACrB,SAAS,EAAE,GAAG,CAAA;CACf,CAAA;AAED,UAAU,gBAAiB,SAAQ,qBAAqB;IACtD,sBAAsB,EAAE,cAAc,CAAA;CACvC;AAID,KAAK,oBAAoB,GAAG,KAAK,GAAG;IAClC,iBAAiB,CAAC,EAAE,cAAc,CAAA;IAClC,MAAM,CAAC,EAAE,gBAAgB,EAAE,CAAA;IAC3B,kBAAkB,CAAC,EAAE,GAAG,CAAA;CACzB,CAAA;AAiGD,eAAO,MAAM,iBAAiB,GAAI,OAAO;IAAE,KAAK,CAAC,EAAE,oBAAoB,CAAA;CAAE,sBA4FxE,CAAA"}

package/dist/components/DevFatalErrorPage.js

@@ -19,7 +19,7 @@ function formatErrorForClipboard(err, stack, typeName, msg, errorWithMeta) {
   lines.push(`ERROR TYPE: ${typeName}`);
   lines.push(`ERROR MESSAGE: ${msg}`);
   lines.push("");
-  const mostRecentRequest = errorWithMeta.mostRecentRequest || errorWithMeta.graphQLErrors?.find((gqlErr) => gqlErr.__RedwoodEnhancedError)?.__RedwoodEnhancedError;
+  const mostRecentRequest = errorWithMeta.mostRecentRequest || errorWithMeta.errors?.find((gqlErr) => gqlErr.__RedwoodEnhancedError)?.__RedwoodEnhancedError;
   if (mostRecentRequest) {
     lines.push("-".repeat(80));
     lines.push("REQUEST CONTEXT");
@@ -96,7 +96,7 @@ const DevFatalErrorPage = (props) => {
   const typeName = String(
     err["type"] || err.constructor?.name || typeof err
   );
-  const msg = String(err && err.message);
+  const msg = String(err?.message);
   const FileRef = stack.items[0] ? /* @__PURE__ */ React.createElement("a", { href: toVSCodeURL(stack.items[0]) }, stack.items[0].fileName) : null;
   const handleCopyAll = async () => {
     const errorText = formatErrorForClipboard(err, stack, typeName, msg, err);
@@ -194,7 +194,7 @@ function ResponseRequest(props) {
   if (!props.error) {
     return null;
   }
-  const mostRecentRequest = props.error.mostRecentRequest || props.error.graphQLErrors?.find((gqlErr) => gqlErr.__RedwoodEnhancedError)?.__RedwoodEnhancedError;
+  const mostRecentRequest = props.error.mostRecentRequest || props.error.errors?.find((gqlErr) => gqlErr.__RedwoodEnhancedError)?.__RedwoodEnhancedError;
   const mostRecentResponse = props.error.mostRecentResponse;
   return /* @__PURE__ */ React.createElement("div", { className: "request-response" }, mostRecentRequest ? /* @__PURE__ */ React.createElement("div", null, /* @__PURE__ */ React.createElement("h4", null, "Request: ", mostRecentRequest.operationName), /* @__PURE__ */ React.createElement("div", null, /* @__PURE__ */ React.createElement("h5", null, "Variables:"), /* @__PURE__ */ React.createElement("code", null, /* @__PURE__ */ React.createElement("pre", null, JSON.stringify(mostRecentRequest.variables, null, "  ")))), /* @__PURE__ */ React.createElement("div", null, /* @__PURE__ */ React.createElement("h5", null, "Query:"), /* @__PURE__ */ React.createElement("code", null, /* @__PURE__ */ React.createElement(
     "pre",

package/dist/components/FatalErrorBoundary.d.ts

@@ -18,7 +18,7 @@ declare class FatalErrorBoundary extends React.Component<PropsFatalErrorBoundary
         hasError: boolean;
         error: Error;
     };
-    render(): string | number | boolean | Iterable<React.ReactNode> | React.PromiseLikeOfReactNode | React.JSX.Element | null | undefined;
+    render(): string | number | bigint | boolean | Iterable<React.ReactNode> | Promise<string | number | bigint | boolean | React.ReactPortal | React.ReactElement<unknown, string | React.JSXElementConstructor<any>> | Iterable<React.ReactNode> | null | undefined> | React.JSX.Element | null | undefined;
 }
 export { FatalErrorBoundary };
 //# sourceMappingURL=FatalErrorBoundary.d.ts.map

package/dist/components/FetchConfigProvider.d.ts

@@ -16,8 +16,9 @@ interface Props {
 /**
  * The `FetchConfigProvider` understands Redwood's Auth and determines the
  * correct request-headers based on a user's authentication state.
- * Note that the auth bearer token is now passed in packages/web/src/apollo/index.tsx
- * as the token is retrieved async
+ * Note that the auth bearer token is now passed in
+ * packages/web/src/apollo/ApolloProviderWithFetchConfig.tsx as the token is
+ * retrieved async
  */
 export declare const FetchConfigProvider: React.FC<Props>;
 export declare const useFetchConfig: () => FetchConfig;

package/dist/components/FetchConfigProvider.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"FetchConfigProvider.d.ts","sourceRoot":"","sources":["../../src/components/FetchConfigProvider.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAA;AAEzB,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,eAAe,CAAA;AAG5C,eAAO,MAAM,gBAAgB,cAE5B,CAAA;AAED,MAAM,WAAW,WAAW;IAC1B,GAAG,EAAE,MAAM,CAAA;IACX,OAAO,CAAC,EAAE;QAAE,eAAe,CAAC,EAAE,MAAM,CAAC;QAAC,aAAa,CAAC,EAAE,MAAM,CAAA;KAAE,CAAA;CAC/D;AAED,eAAO,MAAM,kBAAkB,4BAE7B,CAAA;AAEF,UAAU,KAAK;IACb,OAAO,CAAC,EAAE,OAAO,CAAA;IACjB,QAAQ,EAAE,KAAK,CAAC,SAAS,CAAA;CAC1B;AAED;;;;;GAKG;AACH,eAAO,MAAM,mBAAmB,EAAE,KAAK,CAAC,EAAE,CAAC,KAAK,CA+B/C,CAAA;AAED,eAAO,MAAM,cAAc,mBAA6C,CAAA"}
+{"version":3,"file":"FetchConfigProvider.d.ts","sourceRoot":"","sources":["../../src/components/FetchConfigProvider.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAA;AAEzB,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,eAAe,CAAA;AAG5C,eAAO,MAAM,gBAAgB,cAE5B,CAAA;AAED,MAAM,WAAW,WAAW;IAC1B,GAAG,EAAE,MAAM,CAAA;IACX,OAAO,CAAC,EAAE;QAAE,eAAe,CAAC,EAAE,MAAM,CAAC;QAAC,aAAa,CAAC,EAAE,MAAM,CAAA;KAAE,CAAA;CAC/D;AAED,eAAO,MAAM,kBAAkB,4BAE7B,CAAA;AAEF,UAAU,KAAK;IACb,OAAO,CAAC,EAAE,OAAO,CAAA;IACjB,QAAQ,EAAE,KAAK,CAAC,SAAS,CAAA;CAC1B;AAED;;;;;;GAMG;AACH,eAAO,MAAM,mBAAmB,EAAE,KAAK,CAAC,EAAE,CAAC,KAAK,CA+B/C,CAAA;AAED,eAAO,MAAM,cAAc,mBAA6C,CAAA"}

package/dist/components/MetaTags.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"MetaTags.d.ts","sourceRoot":"","sources":["../../src/components/MetaTags.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAA;AASzB,KAAK,YAAY,GACb,SAAS,GACT,OAAO,GACP,QAAQ,GACR,UAAU,GACV,MAAM,GACN,WAAW,GACX,SAAS,GACT,WAAW,CAAA;AACf,UAAU,aAAa;IACrB;;;OAGG;IACH,GAAG,CAAC,EAAE,MAAM,MAAM,EAAE,CAAA;IAEpB;;;OAGG;IACH,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAA;IAEjB,MAAM,CAAC,EAAE,MAAM,CAAA;IAEf;;;QAGI;IACJ,YAAY,CAAC,EAAE,MAAM,CAAA;IAErB;;;;QAII;IACJ,KAAK,CAAC,EAAE,GAAG,SAAS,GAAG,UAAU,GAAG,MAAM,EAAE,CAAA;IAC5C,WAAW,CAAC,EAAE,MAAM,CAAA;IAEpB;;;QAGI;IACJ,MAAM,CAAC,EAAE,YAAY,GAAG,YAAY,EAAE,CAAA;IACtC,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,MAAM,CAAC,EAAE,MAAM,CAAA;IAEf;;;OAGG;IACH,QAAQ,CAAC,EAAE,KAAK,CAAC,SAAS,CAAA;CAC3B;AAED;;;;;;GAMG;AACH,eAAO,MAAM,QAAQ,GAAI,OAAO,aAAa,sBAoG5C,CAAA"}
+{"version":3,"file":"MetaTags.d.ts","sourceRoot":"","sources":["../../src/components/MetaTags.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAA;AAQzB,KAAK,YAAY,GACb,SAAS,GACT,OAAO,GACP,QAAQ,GACR,UAAU,GACV,MAAM,GACN,WAAW,GACX,SAAS,GACT,WAAW,CAAA;AACf,UAAU,aAAa;IACrB;;;OAGG;IACH,GAAG,CAAC,EAAE,MAAM,MAAM,EAAE,CAAA;IAEpB;;;OAGG;IACH,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAA;IAEjB,MAAM,CAAC,EAAE,MAAM,CAAA;IAEf;;;QAGI;IACJ,YAAY,CAAC,EAAE,MAAM,CAAA;IAErB;;;;QAII;IACJ,KAAK,CAAC,EAAE,GAAG,SAAS,GAAG,UAAU,GAAG,MAAM,EAAE,CAAA;IAC5C,WAAW,CAAC,EAAE,MAAM,CAAA;IAEpB;;;QAGI;IACJ,MAAM,CAAC,EAAE,YAAY,GAAG,YAAY,EAAE,CAAA;IACtC,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,MAAM,CAAC,EAAE,MAAM,CAAA;IAEf;;;OAGG;IACH,QAAQ,CAAC,EAAE,KAAK,CAAC,SAAS,CAAA;CAC3B;AAED;;;;;;GAMG;AACH,eAAO,MAAM,QAAQ,GAAI,OAAO,aAAa,sBAoG5C,CAAA"}

package/dist/components/MetaTags.js

@@ -1,6 +1,5 @@
 import React from "react";
-import * as helmetPkg from "@dr.pogodin/react-helmet";
-const { Helmet: HelmetHead } = helmetPkg;
+import { Helmet as HelmetHead } from "@dr.pogodin/react-helmet";
 import PortalHead from "./PortalHead.js";
 const MetaTags = (props) => {
   const {

package/dist/components/Metadata.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Metadata.d.ts","sourceRoot":"","sources":["../../src/components/Metadata.tsx"],"names":[],"mappings":"AAEA,OAAO,KAAK,MAAM,OAAO,CAAA;AA0CzB;;;;;GAKG;AACH,eAAO,MAAM,QAAQ,GAAI,OAAO,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,sBAgElD,CAAA"}
+{"version":3,"file":"Metadata.d.ts","sourceRoot":"","sources":["../../src/components/Metadata.tsx"],"names":[],"mappings":"AAEA,OAAO,KAAK,MAAM,OAAO,CAAA;AAwCzB;;;;;GAKG;AACH,eAAO,MAAM,QAAQ,GAAI,OAAO,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,sBAgElD,CAAA"}

package/dist/components/Metadata.js

@@ -1,7 +1,6 @@
 "use client";
 import React from "react";
-import * as helmetPkg from "@dr.pogodin/react-helmet";
-const { Helmet: HelmetHead } = helmetPkg;
+import { Helmet as HelmetHead } from "@dr.pogodin/react-helmet";
 import PortalHead from "./PortalHead.js";
 const EXCLUDE_PROPS = ["charSet"];
 const propToMetaTag = (parentKey, parentValue, options) => {

package/dist/components/cell/CellErrorBoundary.d.ts

@@ -1,7 +1,8 @@
 import React from 'react';
+import type { useQuery } from '@apollo/client/react';
 import type { CellFailureProps } from './cellTypes.js';
 export type FallbackProps = {
-    error: QueryOperationResult['error'];
+    error: useQuery.Result['error'];
     resetErrorBoundary: () => void;
 };
 export type CellErrorBoundaryProps = {
@@ -10,7 +11,7 @@ export type CellErrorBoundaryProps = {
 };
 interface ErrState {
     hasError: boolean;
-    error?: QueryOperationResult['error'];
+    error?: useQuery.Result['error'];
 }
 export declare class CellErrorBoundary extends React.Component<CellErrorBoundaryProps, ErrState> {
     constructor(props: CellErrorBoundaryProps);

package/dist/components/cell/CellErrorBoundary.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"CellErrorBoundary.d.ts","sourceRoot":"","sources":["../../../src/components/cell/CellErrorBoundary.tsx"],"names":[],"mappings":"AAEA,OAAO,KAAK,MAAM,OAAO,CAAA;AAEzB,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAA;AAEtD,MAAM,MAAM,aAAa,GAAG;IAC1B,KAAK,EAAE,oBAAoB,CAAC,OAAO,CAAC,CAAA;IACpC,kBAAkB,EAAE,MAAM,IAAI,CAAA;CAC/B,CAAA;AAED,MAAM,MAAM,sBAAsB,GAAG;IAGnC,cAAc,EAAE,CACd,OAAO,EAAE,aAAa,KACnB,KAAK,CAAC,YAAY,CAAC,gBAAgB,CAAC,CAAA;IACzC,QAAQ,EAAE,KAAK,CAAC,SAAS,CAAA;CAC1B,CAAA;AAED,UAAU,QAAQ;IAChB,QAAQ,EAAE,OAAO,CAAA;IACjB,KAAK,CAAC,EAAE,oBAAoB,CAAC,OAAO,CAAC,CAAA;CACtC;AAED,qBAAa,iBAAkB,SAAQ,KAAK,CAAC,SAAS,CACpD,sBAAsB,EACtB,QAAQ,CACT;gBACa,KAAK,EAAE,sBAAsB;IAKzC,MAAM,CAAC,wBAAwB,CAAC,KAAK,EAAE,KAAK;;;;IAI5C,iBAAiB,CAAC,KAAK,EAAE,KAAK,EAAE,SAAS,EAAE,KAAK,CAAC,SAAS;IAQ1D,MAAM;CAgBP"}
+{"version":3,"file":"CellErrorBoundary.d.ts","sourceRoot":"","sources":["../../../src/components/cell/CellErrorBoundary.tsx"],"names":[],"mappings":"AAEA,OAAO,KAAK,MAAM,OAAO,CAAA;AAEzB,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,sBAAsB,CAAA;AAEpD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAA;AAEtD,MAAM,MAAM,aAAa,GAAG;IAC1B,KAAK,EAAE,QAAQ,CAAC,MAAM,CAAC,OAAO,CAAC,CAAA;IAC/B,kBAAkB,EAAE,MAAM,IAAI,CAAA;CAC/B,CAAA;AAED,MAAM,MAAM,sBAAsB,GAAG;IAGnC,cAAc,EAAE,CACd,OAAO,EAAE,aAAa,KACnB,KAAK,CAAC,YAAY,CAAC,gBAAgB,CAAC,CAAA;IACzC,QAAQ,EAAE,KAAK,CAAC,SAAS,CAAA;CAC1B,CAAA;AAED,UAAU,QAAQ;IAChB,QAAQ,EAAE,OAAO,CAAA;IACjB,KAAK,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,OAAO,CAAC,CAAA;CACjC;AAED,qBAAa,iBAAkB,SAAQ,KAAK,CAAC,SAAS,CACpD,sBAAsB,EACtB,QAAQ,CACT;gBACa,KAAK,EAAE,sBAAsB;IAKzC,MAAM,CAAC,wBAAwB,CAAC,KAAK,EAAE,KAAK;;;;IAI5C,iBAAiB,CAAC,KAAK,EAAE,KAAK,EAAE,SAAS,EAAE,KAAK,CAAC,SAAS;IAQ1D,MAAM;CAgBP"}

package/dist/components/cell/cellTypes.d.ts

@@ -1,10 +1,13 @@
-import type { ComponentProps, JSXElementConstructor } from 'react';
-import type { ApolloClient, NetworkStatus, OperationVariables, QueryRef, UseBackgroundQueryResult } from '@apollo/client';
+import type { ComponentProps, JSX, JSXElementConstructor } from 'react';
+import type { ApolloClient, NetworkStatus, OperationVariables, TypedDocumentNode } from '@apollo/client';
+import type { QueryRef, SkipToken, useBackgroundQuery, useQuery } from '@apollo/client/react';
 import type { DocumentNode } from 'graphql';
 import type { A, L, O, U } from 'ts-toolbelt';
 /**
  * If the Cell has a `beforeQuery` function, then the variables are not required,
- * but instead the arguments of the `beforeQuery` function are required.
+ * but instead the arguments of the `beforeQuery` function are required. If
+ * `beforeQuery` takes no arguments, or its first argument is untyped, any
+ * props are accepted.
  *
  * If the Cell does not have a `beforeQuery` function, then the variables are required.
  *
@@ -14,12 +17,12 @@ import type { A, L, O, U } from 'ts-toolbelt';
  */
 type CellPropsVariables<Cell, GQLVariables> = Cell extends {
     beforeQuery: (...args: any[]) => any;
-} ? Parameters<Cell['beforeQuery']>[0] extends unknown ? Record<string, unknown> : Parameters<Cell['beforeQuery']>[0] : GQLVariables extends Record<string, never> ? unknown : GQLVariables;
+} ? Parameters<Cell['beforeQuery']> extends [infer FirstArg, ...any[]] ? unknown extends FirstArg ? Record<string, unknown> : FirstArg : Record<string, unknown> : GQLVariables extends Record<string, never> ? unknown : GQLVariables;
 /**
  * Cell component props which is the combination of query variables and Success props.
  */
-export type CellProps<CellSuccess extends keyof JSX.IntrinsicElements | JSXElementConstructor<any>, GQLResult, CellType, GQLVariables> = A.Compute<Omit<ComponentProps<CellSuccess>, keyof CellPropsVariables<CellType, GQLVariables> | keyof GQLResult | 'updating' | 'queryResult'> & CellPropsVariables<CellType, GQLVariables>>;
-type InputVarProps<T> = T extends {
+export type CellProps<CellSuccess extends keyof JSX.IntrinsicElements | JSXElementConstructor<any>, GQLResult, CellType, GQLVariables> = A.Compute<Omit<ComponentProps<CellSuccess>, keyof CellPropsVariables<CellType, GQLVariables> | keyof (GQLVariables extends Record<string, never> ? unknown : GQLVariables) | keyof GQLResult | 'updating' | 'queryResult'> & CellPropsVariables<CellType, GQLVariables>>;
+type InputVarProps<T> = unknown extends T ? unknown : T extends {
     [key: string]: never;
 } ? unknown : T;
 export type CellLoadingProps<TVariables extends OperationVariables = any> = {
@@ -27,7 +30,7 @@ export type CellLoadingProps<TVariables extends OperationVariables = any> = {
 } & InputVarProps<TVariables>;
 export type CellFailureProps<TVariables extends OperationVariables = any> = {
     queryResult?: NonSuspenseCellQueryResult<TVariables, any> | SuspenseCellQueryResult;
-    error?: QueryOperationResult['error'] | Error;
+    error?: useQuery.Result['error'] | Error;
     /**
      * @see {@link https://www.apollographql.com/docs/apollo-server/data/errors/#error-codes}
      */
@@ -73,23 +76,68 @@ export type CellSuccessProps<TData = any, TVariables extends OperationVariables
 export type DataObject = {
     [key: string]: unknown;
 };
+/**
+ * What `beforeQuery` returns is handed straight to the GraphQL client's query
+ * hook, so any of that hook's options can be set here.
+ */
+export type CellBeforeQueryOptions<CellVariables> = {
+    variables: CellVariables;
+} & Omit<useQuery.Options<DataObject, OperationVariables>, 'variables'>;
+/**
+ * `beforeQuery` can return `skipToken` instead of an options object to keep the
+ * query from being executed at all. A skipped Cell renders nothing -- none of
+ * `Loading`, `Empty`, `Failure` or `Success` are rendered.
+ *
+ * @see {@link https://www.apollographql.com/docs/react/api/react/hooks#skiptoken}
+ *
+ * @example
+ * ```ts
+ * import { skipToken } from '@apollo/client/react'
+ *
+ * export const beforeQuery = ({ id }) => {
+ *   const otherId = useStore((state) => state.getOther(id))
+ *
+ *   return otherId ? { variables: { id, otherId } } : skipToken
+ * }
+ * ```
+ */
+export type CellBeforeQueryResult<CellVariables> = CellBeforeQueryOptions<CellVariables> | SkipToken;
 /**
  * The main interface.
+ *
+ * @param GQLResult - The shape of the data returned by `QUERY` (or, for
+ * fragment Cells, the shape of the fragment's data). This is what
+ * `Success`/`Empty` receive their data as. Defaults to `any` so Cells that
+ * don't -- or can't -- type their `QUERY` with `TypedDocumentNode` (e.g. in
+ * tests, or Cells built from a plain string) keep the pre-existing loose
+ * behavior instead of erroring.
  */
-export interface CreateCellProps<CellProps, CellVariables> {
+export interface CreateCellProps<CellProps, CellVariables extends OperationVariables = OperationVariables, GQLResult = any> {
     /**
      * The GraphQL syntax tree to execute or function to call that returns it.
      * If `QUERY` is a function, it's called with the result of `beforeQuery`.
+     *
+     * Either `QUERY` or `FRAGMENT` must be provided.
      */
-    QUERY: DocumentNode | ((variables: Record<string, unknown>) => DocumentNode);
+    QUERY?: TypedDocumentNode<GQLResult, CellVariables> | DocumentNode | ((variables: Record<string, unknown>) => DocumentNode);
+    /**
+     * A GraphQL fragment that declares this Cell's data requirements. Fragment
+     * Cells don't fire their own query. Instead a parent Cell spreads the
+     * fragment in its `QUERY` and passes the fetched data object down via a
+     * prop named after the fragment (`AuthorCell_author` -> `author`). The
+     * fragment is automatically registered with the GraphQL client's fragment
+     * registry, so parent queries can spread it by name.
+     *
+     * Either `QUERY` or `FRAGMENT` must be provided.
+     */
+    FRAGMENT?: DocumentNode;
     /**
      * Parse `props` into query variables. Most of the time `props` are appropriate variables as is.
+     *
+     * Any other option the GraphQL client's query hook accepts can be returned
+     * here as well. Return `skipToken` to not execute the query at all.
      */
-    beforeQuery?: ((props: CellProps) => {
-        variables: CellVariables;
-    }) | (() => {
-        variables: CellVariables;
-    });
+    beforeQuery?: ((props: CellProps) => CellBeforeQueryResult<CellVariables>) | (() => CellBeforeQueryResult<CellVariables>);
     /**
      * Sanitize the data returned from the query.
      */
@@ -119,19 +167,19 @@ export interface CreateCellProps<CellProps, CellVariables> {
     /**
      * If the query's in flight and there's no stale data, render this.
      */
-    Loading?: React.FC<CellLoadingProps & Partial<CellProps>>;
+    Loading?: React.FC<CellLoadingProps<CellVariables> & Partial<CellProps>>;
     /**
      * If something went wrong, render this.
      */
-    Failure?: React.FC<CellFailureProps & Partial<CellProps>>;
+    Failure?: React.FC<CellFailureProps<CellVariables> & Partial<CellProps>>;
     /**
      * If no data was returned, render this.
      */
-    Empty?: React.FC<CellSuccessProps & Partial<CellProps>>;
+    Empty?: React.FC<CellSuccessProps<GQLResult, CellVariables> & Partial<CellProps>>;
     /**
      * If data was returned, render this.
      */
-    Success: React.FC<CellSuccessProps & Partial<CellProps>>;
+    Success: React.FC<CellSuccessProps<GQLResult, CellVariables> & Partial<CellProps>>;
     /**
      * What to call the Cell. Defaults to the filename.
      */
@@ -142,9 +190,9 @@ export type SuspendingSuccessProps = React.PropsWithChildren<Record<string, unkn
     suspenseQueryResult: SuspenseCellQueryResult<DataObject, any>;
     userProps: Record<string, any>;
 };
-export type NonSuspenseCellQueryResult<TVariables extends OperationVariables = any, TData = any> = Partial<Omit<QueryOperationResult<TData, TVariables>, 'loading' | 'error' | 'data'>>;
-export interface SuspenseCellQueryResult<_TData = any, _TVariables extends OperationVariables = any> extends UseBackgroundQueryResult {
-    client: ApolloClient<any>;
+export type NonSuspenseCellQueryResult<TVariables extends OperationVariables = any, TData = any> = Partial<Omit<useQuery.Result<TData, TVariables>, 'loading' | 'error' | 'data'>>;
+export interface SuspenseCellQueryResult<_TData = any, _TVariables extends OperationVariables = any> extends useBackgroundQuery.Result<DataObject> {
+    client: ApolloClient;
     networkStatus?: NetworkStatus;
     called: boolean;
 }

package/dist/components/cell/cellTypes.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"cellTypes.d.ts","sourceRoot":"","sources":["../../../src/components/cell/cellTypes.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"cellTypes.d.ts","sourceRoot":"","sources":["../../../src/components/cell/cellTypes.ts"],"names":[],"mappings":"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"}

package/dist/components/cell/createCell.d.ts

@@ -1,10 +1,5 @@
 import React from 'react';
+import type { OperationVariables } from '@apollo/client';
 import type { CreateCellProps } from './cellTypes.js';
-import { createSuspendingCell } from './createSuspendingCell.js';
-export declare const createCell: typeof createSuspendingCell | typeof createNonSuspendingCell;
-/**
- * Creates a Cell out of a GraphQL query and components that track to its lifecycle.
- */
-declare function createNonSuspendingCell<CellProps extends Record<string, unknown>, CellVariables extends Record<string, unknown>>({ QUERY, beforeQuery, afterQuery, isEmpty, Loading, Failure, Empty, Success, displayName, }: CreateCellProps<CellProps, CellVariables>): React.FC<CellProps>;
-export {};
+export declare function createCell<CellProps extends Record<string, unknown>, CellVariables extends OperationVariables = OperationVariables, GQLResult = any>(createCellProps: CreateCellProps<CellProps, CellVariables, GQLResult>): React.FC<CellProps>;
 //# sourceMappingURL=createCell.d.ts.map

package/dist/components/cell/createCell.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"createCell.d.ts","sourceRoot":"","sources":["../../../src/components/cell/createCell.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAA;AAUzB,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAA;AACrD,OAAO,EAAE,oBAAoB,EAAE,MAAM,2BAA2B,CAAA;AAIhE,eAAO,MAAM,UAAU,8DAEI,CAAA;AAE3B;;GAEG;AACH,iBAAS,uBAAuB,CAC9B,SAAS,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACzC,aAAa,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC7C,EACA,KAAK,EACL,WAWE,EACF,UAA2B,EAC3B,OAAqB,EACrB,OAA+B,EAC/B,OAAO,EACP,KAAK,EACL,OAAO,EACP,WAAoB,GACrB,EAAE,eAAe,CAAC,SAAS,EAAE,aAAa,CAAC,GAAG,KAAK,CAAC,EAAE,CAAC,SAAS,CAAC,CAuIjE"}
+{"version":3,"file":"createCell.d.ts","sourceRoot":"","sources":["../../../src/components/cell/createCell.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAA;AAEzB,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,gBAAgB,CAAA;AAQxD,OAAO,KAAK,EAAE,eAAe,EAAc,MAAM,gBAAgB,CAAA;AAKjE,wBAAgB,UAAU,CACxB,SAAS,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACzC,aAAa,SAAS,kBAAkB,GAAG,kBAAkB,EAC7D,SAAS,GAAG,GAAG,EAEf,eAAe,EAAE,eAAe,CAAC,SAAS,EAAE,aAAa,EAAE,SAAS,CAAC,GACpE,KAAK,CAAC,EAAE,CAAC,SAAS,CAAC,CAoCrB"}

package/dist/components/cell/createCell.js

@@ -1,11 +1,27 @@
 import React from "react";
+import { CombinedGraphQLErrors } from "@apollo/client";
+import { useQuery } from "@apollo/client/react";
 import { fragmentRegistry } from "../../apollo/fragmentRegistry.js";
 import { getOperationName } from "../../graphql.js";
-import { useQuery } from "../GraphQLHooksProvider.js";
 import { useCellCacheContext } from "./CellCacheContext.js";
+import { createFragmentCell } from "./createFragmentCell.js";
 import { createSuspendingCell } from "./createSuspendingCell.js";
 import { isDataEmpty } from "./isCellEmpty.js";
-const createCell = RWJS_ENV.RWJS_EXP_STREAMING_SSR ? createSuspendingCell : createNonSuspendingCell;
+function createCell(createCellProps) {
+  if (createCellProps.FRAGMENT) {
+    if (!createCellProps.QUERY) {
+      return createFragmentCell(createCellProps);
+    }
+    fragmentRegistry.register(createCellProps.FRAGMENT);
+  }
+  if (RWJS_ENV.RWJS_EXP_STREAMING_SSR) {
+    const suspendingCellProps = createCellProps;
+    return createSuspendingCell(
+      suspendingCellProps
+    );
+  }
+  return createNonSuspendingCell(createCellProps);
+}
 function createNonSuspendingCell({
   QUERY,
   beforeQuery = (props) => ({
@@ -28,10 +44,18 @@ function createNonSuspendingCell({
   Success,
   displayName = "Cell"
 }) {
+  if (!QUERY) {
+    throw new Error(
+      `Can't create a Cell (${displayName}) without a QUERY or FRAGMENT export`
+    );
+  }
+  const cellQuery = QUERY;
   function NamedCell(props) {
     const { children: _, ...variables } = props;
     const options = beforeQuery(variables);
-    const query = typeof QUERY === "function" ? QUERY(options) : QUERY;
+    const queryOptions = typeof options === "symbol" ? void 0 : options;
+    const skipped = !queryOptions || queryOptions.skip === true;
+    const query = typeof cellQuery === "function" ? cellQuery(queryOptions ?? {}) : cellQuery;
     let {
       // eslint-disable-next-line prefer-const
       error,
@@ -41,77 +65,77 @@ function createNonSuspendingCell({
     } = useQuery(query, options);
     if (globalThis.__REDWOOD__PRERENDERING) {
       const { queryCache } = useCellCacheContext();
-      const operationName = getOperationName(query);
-      const transformedQuery = fragmentRegistry.transform(query);
-      let cacheKey;
-      if (operationName) {
-        cacheKey = operationName + "_" + JSON.stringify(variables);
-      } else {
-        const cellName = displayName === "Cell" ? "the cell" : displayName;
-        throw new Error(
-          `The gql query in ${cellName} is missing an operation name. Something like FindBlogPostQuery in \`query FindBlogPostQuery($id: Int!)\``
-        );
-      }
-      const queryInfo = queryCache[cacheKey];
-      if (queryInfo?.renderLoading) {
-        loading = true;
-      } else {
-        if (queryInfo?.hasProcessed) {
-          loading = false;
-          data = queryInfo.data;
-          queryResult = { variables };
+      if (!skipped) {
+        const operationName = getOperationName(query);
+        const transformedQuery = fragmentRegistry.transform(query);
+        let cacheKey;
+        if (operationName) {
+          cacheKey = operationName + "_" + JSON.stringify(variables);
         } else {
-          queryCache[cacheKey] ||= {
-            query: transformedQuery,
-            variables: options.variables,
-            hasProcessed: false
-          };
+          const cellName = displayName === "Cell" ? "the cell" : displayName;
+          throw new Error(
+            `The gql query in ${cellName} is missing an operation name. Something like FindBlogPostQuery in \`query FindBlogPostQuery($id: Int!)\``
+          );
+        }
+        const queryInfo = queryCache[cacheKey];
+        if (queryInfo?.renderLoading) {
+          loading = true;
+        } else {
+          if (queryInfo?.hasProcessed) {
+            loading = false;
+            data = queryInfo.data;
+            queryResult = { variables };
+          } else {
+            queryCache[cacheKey] ||= {
+              query: transformedQuery,
+              variables: queryOptions.variables,
+              hasProcessed: false
+            };
+          }
         }
       }
     }
+    if (skipped) {
+      return null;
+    }
     if (error) {
       if (Failure) {
-        return /* @__PURE__ */ React.createElement(
-          Failure,
-          {
-            error,
-            errorCode: (
-              // Use the ad-hoc QueryResultWithErrorCode type to access the errorCode
-              queryResult.errorCode ?? error.graphQLErrors?.[0]?.extensions?.["code"]
-            ),
-            ...props,
-            updating: loading,
-            queryResult
-          }
-        );
+        const failureProps = {
+          error,
+          errorCode: (
+            // Use the ad-hoc QueryResultWithErrorCode type to access the errorCode
+            queryResult.errorCode ?? (CombinedGraphQLErrors.is(error) ? error.errors[0]?.extensions?.["code"] : void 0)
+          ),
+          ...props,
+          updating: loading,
+          queryResult
+        };
+        return /* @__PURE__ */ React.createElement(Failure, { ...failureProps });
       } else {
-        throw error;
+        throw error instanceof Error ? error : new Error(error.message);
       }
     } else if (data) {
       const afterQueryData = afterQuery(data);
       if (isEmpty(data, { isDataEmpty }) && Empty) {
-        return /* @__PURE__ */ React.createElement(
-          Empty,
-          {
-            ...props,
-            ...afterQueryData,
-            updating: loading,
-            queryResult
-          }
-        );
+        const emptyProps = {
+          ...props,
+          ...afterQueryData,
+          updating: loading,
+          queryResult
+        };
+        return /* @__PURE__ */ React.createElement(Empty, { ...emptyProps });
       } else {
-        return /* @__PURE__ */ React.createElement(
-          Success,
-          {
-            ...props,
-            ...afterQueryData,
-            updating: loading,
-            queryResult
-          }
-        );
+        const successProps = {
+          ...props,
+          ...afterQueryData,
+          updating: loading,
+          queryResult
+        };
+        return /* @__PURE__ */ React.createElement(Success, { ...successProps });
       }
     } else if (loading) {
-      return /* @__PURE__ */ React.createElement(Loading, { ...props, queryResult });
+      const loadingProps = { ...props, queryResult };
+      return /* @__PURE__ */ React.createElement(Loading, { ...loadingProps });
     } else {
       console.warn(
         `If you're using Apollo Client, check for its debug logs here in the console, which may help explain the error.`

package/dist/components/cell/createFragmentCell.d.ts

@@ -0,0 +1,20 @@
+import React from 'react';
+import type { OperationVariables } from '@apollo/client';
+import type { CreateCellProps } from './cellTypes.js';
+/**
+ * Creates a Cell out of a GraphQL fragment and components that render its
+ * data.
+ *
+ * Fragment Cells don't fire queries of their own. A parent Cell spreads the
+ * fragment in its QUERY and passes the matching slice of the query result
+ * down via a prop named after the fragment (`AuthorCell_author` -> `author`).
+ * `Success` receives the data as that same prop. The data is read
+ * synchronously, so fragment Cells never render `Loading`.
+ *
+ * When the GraphQL client supports it (Apollo does), the fragment data is
+ * read from the client's cache, so the Cell re-renders when other queries or
+ * mutations update the underlying entity. If the cache read is incomplete,
+ * the passed-in object itself is used as the data snapshot.
+ */
+export declare function createFragmentCell<CellProps extends Record<string, unknown>, CellVariables extends OperationVariables = OperationVariables, GQLResult = any>({ FRAGMENT, afterQuery, isEmpty, Empty, Success, displayName, }: CreateCellProps<CellProps, CellVariables, GQLResult>): React.FC<CellProps>;
+//# sourceMappingURL=createFragmentCell.d.ts.map

package/dist/components/cell/createFragmentCell.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"createFragmentCell.d.ts","sourceRoot":"","sources":["../../../src/components/cell/createFragmentCell.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAA;AAEzB,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,gBAAgB,CAAA;AAMxD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAA;AAqDrD;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,kBAAkB,CAChC,SAAS,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACzC,aAAa,SAAS,kBAAkB,GAAG,kBAAkB,EAC7D,SAAS,GAAG,GAAG,EACf,EACA,QAAQ,EACR,UAA2B,EAC3B,OAAqB,EACrB,KAAK,EACL,OAAO,EACP,WAAoB,GACrB,EAAE,eAAe,CAAC,SAAS,EAAE,aAAa,EAAE,SAAS,CAAC,GAAG,KAAK,CAAC,EAAE,CAAC,SAAS,CAAC,CAiF5E"}