fontdue-js 3.0.0-alpha1 → 3.0.0-alpha3

package/dist/__generated__/FontdueProviderQuery.graphql.d.ts

@@ -0,0 +1,19 @@
+/**
+ * @generated SignedSource<<8a1ab76133c869f1e7c33e1e38525560>>
+ * @lightSyntaxTransform
+ * @nogrep
+ */
+import { ConcreteRequest } from 'relay-runtime';
+import { FragmentRefs } from "relay-runtime";
+export type FontdueProviderQuery$variables = Record<PropertyKey, never>;
+export type FontdueProviderQuery$data = {
+    readonly viewer: {
+        readonly " $fragmentSpreads": FragmentRefs<"ServerConfigProvider_viewer" | "TestModeBanner_viewer" | "ThemeConfig_viewer">;
+    };
+};
+export type FontdueProviderQuery = {
+    response: FontdueProviderQuery$data;
+    variables: FontdueProviderQuery$variables;
+};
+declare const node: ConcreteRequest;
+export default node;

package/dist/__generated__/FontdueProviderQuery.graphql.js

@@ -0,0 +1,140 @@
+/**
+ * @generated SignedSource<<8a1ab76133c869f1e7c33e1e38525560>>
+ * @lightSyntaxTransform
+ * @nogrep
+ */
+
+/* tslint:disable */
+/* eslint-disable */
+// @ts-nocheck
+
+const node = {
+  "fragment": {
+    "argumentDefinitions": [],
+    "kind": "Fragment",
+    "metadata": null,
+    "name": "FontdueProviderQuery",
+    "selections": [{
+      "alias": null,
+      "args": null,
+      "concreteType": "Viewer",
+      "kind": "LinkedField",
+      "name": "viewer",
+      "plural": false,
+      "selections": [{
+        "args": null,
+        "kind": "FragmentSpread",
+        "name": "ThemeConfig_viewer"
+      }, {
+        "args": null,
+        "kind": "FragmentSpread",
+        "name": "TestModeBanner_viewer"
+      }, {
+        "args": null,
+        "kind": "FragmentSpread",
+        "name": "ServerConfigProvider_viewer"
+      }],
+      "storageKey": null
+    }],
+    "type": "RootQueryType",
+    "abstractKey": null
+  },
+  "kind": "Request",
+  "operation": {
+    "argumentDefinitions": [],
+    "kind": "Operation",
+    "name": "FontdueProviderQuery",
+    "selections": [{
+      "alias": null,
+      "args": null,
+      "concreteType": "Viewer",
+      "kind": "LinkedField",
+      "name": "viewer",
+      "plural": false,
+      "selections": [{
+        "alias": null,
+        "args": null,
+        "concreteType": "ThemeConfig",
+        "kind": "LinkedField",
+        "name": "themeConfig",
+        "plural": false,
+        "selections": [{
+          "alias": null,
+          "args": null,
+          "kind": "ScalarField",
+          "name": "customProperties",
+          "storageKey": null
+        }],
+        "storageKey": null
+      }, {
+        "alias": null,
+        "args": null,
+        "concreteType": "TestMode",
+        "kind": "LinkedField",
+        "name": "testMode",
+        "plural": false,
+        "selections": [{
+          "alias": null,
+          "args": null,
+          "kind": "ScalarField",
+          "name": "isActive",
+          "storageKey": null
+        }],
+        "storageKey": null
+      }, {
+        "alias": null,
+        "args": null,
+        "concreteType": "FontdueConfig",
+        "kind": "LinkedField",
+        "name": "fontdueConfig",
+        "plural": false,
+        "selections": [{
+          "alias": null,
+          "args": null,
+          "concreteType": "FontdueTrackingConfig",
+          "kind": "LinkedField",
+          "name": "tracking",
+          "plural": false,
+          "selections": [{
+            "alias": null,
+            "args": null,
+            "kind": "ScalarField",
+            "name": "enabled",
+            "storageKey": null
+          }, {
+            "alias": null,
+            "args": null,
+            "kind": "ScalarField",
+            "name": "consentRequired",
+            "storageKey": null
+          }, {
+            "alias": null,
+            "args": null,
+            "kind": "ScalarField",
+            "name": "consentMessage",
+            "storageKey": null
+          }],
+          "storageKey": null
+        }],
+        "storageKey": null
+      }, {
+        "alias": null,
+        "args": null,
+        "kind": "ScalarField",
+        "name": "id",
+        "storageKey": null
+      }],
+      "storageKey": null
+    }]
+  },
+  "params": {
+    "cacheID": "8d7caa322aacca72f5aa7fcbef53fd77",
+    "id": null,
+    "metadata": {},
+    "name": "FontdueProviderQuery",
+    "operationKind": "query",
+    "text": "query FontdueProviderQuery {\n  viewer {\n    ...ThemeConfig_viewer\n    ...TestModeBanner_viewer\n    ...ServerConfigProvider_viewer\n    id\n  }\n}\n\nfragment ServerConfigProvider_viewer on Viewer {\n  fontdueConfig {\n    tracking {\n      enabled\n      consentRequired\n      consentMessage\n    }\n  }\n}\n\nfragment TestModeBanner_viewer on Viewer {\n  testMode {\n    isActive\n  }\n}\n\nfragment ThemeConfig_viewer on Viewer {\n  themeConfig {\n    customProperties\n  }\n}\n"
+  }
+};
+node.hash = "5cbd582990daa28a99839c20abbc8bda";
+export default node;

package/dist/__generated__/ServerConfigProvider_viewer.graphql.d.ts

@@ -0,0 +1,23 @@
+/**
+ * @generated SignedSource<<a83ac66ca93de8f6c51ac4c192aec8b4>>
+ * @lightSyntaxTransform
+ * @nogrep
+ */
+import { ReaderFragment } from 'relay-runtime';
+import { FragmentRefs } from "relay-runtime";
+export type ServerConfigProvider_viewer$data = {
+    readonly fontdueConfig: {
+        readonly tracking: {
+            readonly consentMessage: string | null;
+            readonly consentRequired: boolean;
+            readonly enabled: boolean;
+        } | null;
+    } | null;
+    readonly " $fragmentType": "ServerConfigProvider_viewer";
+};
+export type ServerConfigProvider_viewer$key = {
+    readonly " $data"?: ServerConfigProvider_viewer$data;
+    readonly " $fragmentSpreads": FragmentRefs<"ServerConfigProvider_viewer">;
+};
+declare const node: ReaderFragment;
+export default node;

package/dist/__generated__/ServerConfigProvider_viewer.graphql.js

@@ -0,0 +1,57 @@
+/**
+ * @generated SignedSource<<a83ac66ca93de8f6c51ac4c192aec8b4>>
+ * @lightSyntaxTransform
+ * @nogrep
+ */
+
+/* tslint:disable */
+/* eslint-disable */
+// @ts-nocheck
+
+const node = {
+  "argumentDefinitions": [],
+  "kind": "Fragment",
+  "metadata": null,
+  "name": "ServerConfigProvider_viewer",
+  "selections": [{
+    "alias": null,
+    "args": null,
+    "concreteType": "FontdueConfig",
+    "kind": "LinkedField",
+    "name": "fontdueConfig",
+    "plural": false,
+    "selections": [{
+      "alias": null,
+      "args": null,
+      "concreteType": "FontdueTrackingConfig",
+      "kind": "LinkedField",
+      "name": "tracking",
+      "plural": false,
+      "selections": [{
+        "alias": null,
+        "args": null,
+        "kind": "ScalarField",
+        "name": "enabled",
+        "storageKey": null
+      }, {
+        "alias": null,
+        "args": null,
+        "kind": "ScalarField",
+        "name": "consentRequired",
+        "storageKey": null
+      }, {
+        "alias": null,
+        "args": null,
+        "kind": "ScalarField",
+        "name": "consentMessage",
+        "storageKey": null
+      }],
+      "storageKey": null
+    }],
+    "storageKey": null
+  }],
+  "type": "Viewer",
+  "abstractKey": null
+};
+node.hash = "6afcb0c3813a418a470e48415f963064";
+export default node;

package/dist/__generated__/TestModeBanner_viewer.graphql.d.ts

@@ -0,0 +1,19 @@
+/**
+ * @generated SignedSource<<e9ace1097ef31e2ed34190d2a31634be>>
+ * @lightSyntaxTransform
+ * @nogrep
+ */
+import { ReaderFragment } from 'relay-runtime';
+import { FragmentRefs } from "relay-runtime";
+export type TestModeBanner_viewer$data = {
+    readonly testMode: {
+        readonly isActive: boolean;
+    };
+    readonly " $fragmentType": "TestModeBanner_viewer";
+};
+export type TestModeBanner_viewer$key = {
+    readonly " $data"?: TestModeBanner_viewer$data;
+    readonly " $fragmentSpreads": FragmentRefs<"TestModeBanner_viewer">;
+};
+declare const node: ReaderFragment;
+export default node;

package/dist/__generated__/TestModeBanner_viewer.graphql.js

@@ -0,0 +1,36 @@
+/**
+ * @generated SignedSource<<e9ace1097ef31e2ed34190d2a31634be>>
+ * @lightSyntaxTransform
+ * @nogrep
+ */
+
+/* tslint:disable */
+/* eslint-disable */
+// @ts-nocheck
+
+const node = {
+  "argumentDefinitions": [],
+  "kind": "Fragment",
+  "metadata": null,
+  "name": "TestModeBanner_viewer",
+  "selections": [{
+    "alias": null,
+    "args": null,
+    "concreteType": "TestMode",
+    "kind": "LinkedField",
+    "name": "testMode",
+    "plural": false,
+    "selections": [{
+      "alias": null,
+      "args": null,
+      "kind": "ScalarField",
+      "name": "isActive",
+      "storageKey": null
+    }],
+    "storageKey": null
+  }],
+  "type": "Viewer",
+  "abstractKey": null
+};
+node.hash = "f6b2f851466be9599d63ebf8f39e1a96";
+export default node;

package/dist/__generated__/ThemeConfig_viewer.graphql.d.ts

@@ -0,0 +1,19 @@
+/**
+ * @generated SignedSource<<9eff3b1fe04abdb52e7380c1158bdb71>>
+ * @lightSyntaxTransform
+ * @nogrep
+ */
+import { ReaderFragment } from 'relay-runtime';
+import { FragmentRefs } from "relay-runtime";
+export type ThemeConfig_viewer$data = {
+    readonly themeConfig: {
+        readonly customProperties: ReadonlyArray<string> | null;
+    } | null;
+    readonly " $fragmentType": "ThemeConfig_viewer";
+};
+export type ThemeConfig_viewer$key = {
+    readonly " $data"?: ThemeConfig_viewer$data;
+    readonly " $fragmentSpreads": FragmentRefs<"ThemeConfig_viewer">;
+};
+declare const node: ReaderFragment;
+export default node;

package/dist/__generated__/ThemeConfig_viewer.graphql.js

@@ -0,0 +1,36 @@
+/**
+ * @generated SignedSource<<9eff3b1fe04abdb52e7380c1158bdb71>>
+ * @lightSyntaxTransform
+ * @nogrep
+ */
+
+/* tslint:disable */
+/* eslint-disable */
+// @ts-nocheck
+
+const node = {
+  "argumentDefinitions": [],
+  "kind": "Fragment",
+  "metadata": null,
+  "name": "ThemeConfig_viewer",
+  "selections": [{
+    "alias": null,
+    "args": null,
+    "concreteType": "ThemeConfig",
+    "kind": "LinkedField",
+    "name": "themeConfig",
+    "plural": false,
+    "selections": [{
+      "alias": null,
+      "args": null,
+      "kind": "ScalarField",
+      "name": "customProperties",
+      "storageKey": null
+    }],
+    "storageKey": null
+  }],
+  "type": "Viewer",
+  "abstractKey": null
+};
+node.hash = "191db4fda0651cd596efa7f91699f895";
+export default node;

package/dist/components/BuyButton/index.d.ts

@@ -1,17 +1,37 @@
 import React from 'react';
 import { BuyButtonIDQuery } from '../../__generated__/BuyButtonIDQuery.graphql.js';
 import { BuyButtonSlugQuery } from '../../__generated__/BuyButtonSlugQuery.graphql.js';
-import { SerializablePreloadedQuery } from '../../relay/loadSerializableQuery.js';
+import { LoadSerializableQueryOptions, SerializablePreloadedQuery } from '../../relay/loadSerializableQuery.js';
 export interface BuyButton_props {
-    collectionId?: string | null;
-    collectionSlug?: string | null;
     collectionName?: string;
     label?: string;
 }
+export type BuyButtonPreloadedQuery = SerializablePreloadedQuery<BuyButtonIDQuery> | SerializablePreloadedQuery<BuyButtonSlugQuery>;
+export type LoadBuyButtonQueryVariables = {
+    collectionId: string;
+    collectionSlug?: never;
+} | {
+    collectionId?: never;
+    collectionSlug: string;
+};
+export declare function loadBuyButtonQuery(variables: LoadBuyButtonQueryVariables, options?: LoadSerializableQueryOptions): Promise<BuyButtonPreloadedQuery>;
 export declare function BuyButtonPreloadedIDQueryRenderer({ preloadedQuery, ...rest }: BuyButton_props & {
     preloadedQuery: SerializablePreloadedQuery<BuyButtonIDQuery>;
 }): React.JSX.Element;
 export declare function BuyButtonPreloadedSlugQueryRenderer({ preloadedQuery, ...rest }: BuyButton_props & {
     preloadedQuery: SerializablePreloadedQuery<BuyButtonSlugQuery>;
 }): React.JSX.Element;
-export default function BuyButton({ collectionId, collectionSlug, ...rest }: BuyButton_props): React.JSX.Element;
+export type BuyButton_unifiedProps = BuyButton_props & ({
+    preloadedQuery: BuyButtonPreloadedQuery;
+    collectionId?: never;
+    collectionSlug?: never;
+} | {
+    preloadedQuery?: never;
+    collectionId: string;
+    collectionSlug?: never;
+} | {
+    preloadedQuery?: never;
+    collectionId?: never;
+    collectionSlug: string;
+});
+export default function BuyButton(props: BuyButton_unifiedProps): React.JSX.Element;

package/dist/components/BuyButton/index.js

@@ -9,7 +9,11 @@ import { graphql, useRelayEnvironment, useLazyLoadQuery, useFragment, usePreload
 import { useDispatch, useStore } from 'react-redux';
 import ComponentsContext from '../ComponentsContext.js';
 import { populateProductState } from '../Root/productState.js';
+import BuyButtonIDQueryNode from '../../__generated__/BuyButtonIDQuery.graphql.js';
+import BuyButtonSlugQueryNode from '../../__generated__/BuyButtonSlugQuery.graphql.js';
+import loadSerializableQuery from '../../relay/loadSerializableQuery.js';
 import useSerializablePreloadedQuery from '../../relay/useSerializablePreloadedQuery.js';
+import { EnsureFontdueContext } from '../FontdueContextProvider/index.js';
 function BuyButtonComponent(_ref) {
   let {
     collection: collectionKey,
@@ -36,9 +40,6 @@ function BuyButtonComponent(_ref) {
   }, [dispatch, collection]);
   useEffect(() => {
     if (!collection) return;
-    // populate as soon as BuyButton mounts. this prepares the StoreModal
-    // to be able to apply discounts as soon as the user clicks "BUY" on
-    // a style. (this is necessary if the bundle price is <= single style price)
     populateProductState(store, environment, collection.id);
   }, [collection === null || collection === void 0 ? void 0 : collection.id]);
   if (components.BuyButton) {
@@ -55,6 +56,20 @@ function BuyButtonComponent(_ref) {
   }, label ? label : `Buy ${collectionName ?? ''}`);
 }
 const idQuery = (_BuyButtonIDQuery.hash && _BuyButtonIDQuery.hash !== "4fbf1dbf9e6c530a5d38c697b174d8b0" && console.error("The definition of 'BuyButtonIDQuery' appears to have changed. Run `relay-compiler` to update the generated files to receive the expected data."), _BuyButtonIDQuery);
+const slugQuery = (_BuyButtonSlugQuery.hash && _BuyButtonSlugQuery.hash !== "6e750adea09698f7cb61f435cd88fd26" && console.error("The definition of 'BuyButtonSlugQuery' appears to have changed. Run `relay-compiler` to update the generated files to receive the expected data."), _BuyButtonSlugQuery);
+export async function loadBuyButtonQuery(variables, options) {
+  if (variables.collectionId) {
+    return loadSerializableQuery(BuyButtonIDQueryNode, {
+      collectionId: variables.collectionId
+    }, options);
+  }
+  if (variables.collectionSlug) {
+    return loadSerializableQuery(BuyButtonSlugQueryNode, {
+      collectionSlug: variables.collectionSlug
+    }, options);
+  }
+  throw new Error('loadBuyButtonQuery expected either a collectionId or collectionSlug');
+}
 function BuyButtonIDQueryRenderer(_ref2) {
   let {
     collectionId,
@@ -74,7 +89,6 @@ export function BuyButtonPreloadedIDQueryRenderer(_ref3) {
   const data = usePreloadedQuery(idQuery, queryRef);
   return /*#__PURE__*/React.createElement(BuyButtonComponent, _extends({}, rest, data));
 }
-const slugQuery = (_BuyButtonSlugQuery.hash && _BuyButtonSlugQuery.hash !== "6e750adea09698f7cb61f435cd88fd26" && console.error("The definition of 'BuyButtonSlugQuery' appears to have changed. Run `relay-compiler` to update the generated files to receive the expected data."), _BuyButtonSlugQuery);
 function BuyButtonSlugQueryRenderer(_ref4) {
   var _data$viewer, _data$viewer$slug;
   let {
@@ -100,23 +114,52 @@ export function BuyButtonPreloadedSlugQueryRenderer(_ref5) {
     collection: ((_data$viewer2 = data.viewer) === null || _data$viewer2 === void 0 ? void 0 : (_data$viewer2$slug = _data$viewer2.slug) === null || _data$viewer2$slug === void 0 ? void 0 : _data$viewer2$slug.collection) ?? null
   }));
 }
-
-// default client export
-export default function BuyButton(_ref6) {
+function BuyButtonPreloadedRenderer(_ref6) {
   let {
-    collectionId,
-    collectionSlug,
+    preloadedQuery,
     ...rest
   } = _ref6;
-  if (collectionId) {
-    return /*#__PURE__*/React.createElement(BuyButtonIDQueryRenderer, _extends({
-      collectionId: collectionId
+  if (preloadedQuery.params.name === 'BuyButtonIDQuery') {
+    return /*#__PURE__*/React.createElement(BuyButtonPreloadedIDQueryRenderer, _extends({
+      preloadedQuery: preloadedQuery
     }, rest));
   }
-  if (collectionSlug) {
-    return /*#__PURE__*/React.createElement(BuyButtonSlugQueryRenderer, _extends({
+  return /*#__PURE__*/React.createElement(BuyButtonPreloadedSlugQueryRenderer, _extends({
+    preloadedQuery: preloadedQuery
+  }, rest));
+}
+// Unified BuyButton entry. Accepts a preloaded query (server-side preload
+// path) or `{collectionId}`/`{collectionSlug}` for lazy fetch.
+// `EnsureFontdueContext` only self-wraps with `FontdueContextProvider` when
+// no parent Fontdue context is present.
+export default function BuyButton(props) {
+  let inner;
+  if ('preloadedQuery' in props && props.preloadedQuery) {
+    const {
+      preloadedQuery,
+      ...rest
+    } = props;
+    inner = /*#__PURE__*/React.createElement(BuyButtonPreloadedRenderer, _extends({
+      preloadedQuery: preloadedQuery
+    }, rest));
+  } else if ('collectionId' in props && props.collectionId) {
+    const {
+      collectionId,
+      ...rest
+    } = props;
+    inner = /*#__PURE__*/React.createElement(BuyButtonIDQueryRenderer, _extends({
+      collectionId: collectionId
+    }, rest));
+  } else if ('collectionSlug' in props && props.collectionSlug) {
+    const {
+      collectionSlug,
+      ...rest
+    } = props;
+    inner = /*#__PURE__*/React.createElement(BuyButtonSlugQueryRenderer, _extends({
       collectionSlug: collectionSlug
     }, rest));
+  } else {
+    throw new Error('BuyButton expected one of preloadedQuery, collectionId, or collectionSlug');
   }
-  throw new Error('BuyButton expected either a collectionId or collectionSlug prop');
+  return /*#__PURE__*/React.createElement(EnsureFontdueContext, null, inner);
 }

package/dist/components/BuyButton/index.server.d.ts

@@ -1,3 +1,6 @@
 import React from 'react';
 import { BuyButton_props } from './index.js';
-export default function BuyButton({ collectionId, collectionSlug, ...rest }: BuyButton_props): Promise<React.JSX.Element | null>;
+export default function BuyButton({ collectionId, collectionSlug, ...rest }: BuyButton_props & {
+    collectionId?: string | null;
+    collectionSlug?: string | null;
+}): Promise<React.JSX.Element | null>;

package/dist/components/BuyButton/index.server.js

@@ -4,6 +4,11 @@ import loadSerializableQuery from '../../relay/loadSerializableQuery.js';
 import { BuyButtonPreloadedIDQueryRenderer, BuyButtonPreloadedSlugQueryRenderer } from './index.js';
 import BuyButtonIDQueryNode from '../../__generated__/BuyButtonIDQuery.graphql.js';
 import BuyButtonSlugQueryNode from '../../__generated__/BuyButtonSlugQuery.graphql.js';
+
+// Next RSC variant: awaits the query on the server and hands the response to
+// the client `*PreloadedQueryRenderer`. Lets pages just write
+// `<BuyButton collectionId={id} />` in an RSC without manually invoking
+// `loadBuyButtonQuery` + threading `preloadedQuery` through props.
 export default async function BuyButton(_ref) {
   let {
     collectionId,

package/dist/components/CartButton/index.d.ts

@@ -1,15 +1,18 @@
 import React from 'react';
-import { CartButtonQuery } from '__generated__/CartButtonQuery.graphql.js';
-import { SerializablePreloadedQuery } from '../../relay/loadSerializableQuery.js';
+import { CartButtonQuery } from '../../__generated__/CartButtonQuery.graphql.js';
+import { LoadSerializableQueryOptions, SerializablePreloadedQuery } from '../../relay/loadSerializableQuery.js';
 export interface CartButton_props {
     label?: string;
     buttonStyle?: string;
     children?: React.ReactNode;
     suffix?: string;
 }
-type PreloadedQuery = SerializablePreloadedQuery<CartButtonQuery>;
+export type CartButtonPreloadedQuery = SerializablePreloadedQuery<CartButtonQuery>;
+export declare function loadCartButtonQuery(options?: LoadSerializableQueryOptions): Promise<CartButtonPreloadedQuery>;
 export declare function CartButtonPreloadedQueryRenderer({ preloadedQuery, ...rest }: CartButton_props & {
-    preloadedQuery: PreloadedQuery;
+    preloadedQuery: CartButtonPreloadedQuery;
 }): React.JSX.Element;
-export default function CartButton(props: CartButton_props): React.JSX.Element;
-export {};
+export type CartButton_unifiedProps = CartButton_props & {
+    preloadedQuery?: CartButtonPreloadedQuery;
+};
+export default function CartButton(props: CartButton_unifiedProps): React.JSX.Element;

package/dist/components/CartButton/index.js

@@ -6,10 +6,13 @@ import _CartButton_order from "../../__generated__/CartButton_order.graphql.js";
 import React, { useEffect, useCallback, useState } from 'react';
 import { useDispatch } from 'react-redux';
 import { graphql, useFragment, useLazyLoadQuery, usePreloadedQuery } from 'react-relay';
+import CartButtonQueryNode from '../../__generated__/CartButtonQuery.graphql.js';
 import ComponentsContext from '../ComponentsContext.js';
 import { CartNew } from '../Icons/index.js';
+import loadSerializableQuery from '../../relay/loadSerializableQuery.js';
 import useSerializablePreloadedQuery from '../../relay/useSerializablePreloadedQuery.js';
 import Price, { PriceFormat } from '../Price/index.js';
+import { EnsureFontdueContext } from '../FontdueContextProvider/index.js';
 function getOrderCount(order) {
   return order.orderItems ? order.orderItems.length : 0;
 }
@@ -33,22 +36,12 @@ function CartButtonComponent(_ref) {
   const dispatch = useDispatch();
   const formatSuffix = useCallback(() => {
     if (!suffix) return null;
-
-    // Check if the suffix contains any substitutions
     const hasSubstitutions = /\{(count|subtotal)\}/.test(suffix);
-
-    // Hide if there are substitutions and cart is empty
     if (hasSubstitutions && count === 0) return null;
-
-    // Split into parts: ['text', '{placeholder}', 'text', '{placeholder}', 'text']
     const parts = suffix.split(/(\{[^}]+\})/);
-
-    // Transform each part based on whether it's a placeholder or text
     const nodes = parts.map((part, index) => {
       const match = part.match(/^\{([^}]+)\}$/);
-      if (!match) return part || null; // Regular text
-
-      // Handle placeholder
+      if (!match) return part || null;
       const placeholder = match[1];
       switch (placeholder) {
         case 'count':
@@ -61,10 +54,8 @@ function CartButtonComponent(_ref) {
           }) : null;
         default:
           return part;
-        // Keep unknown placeholders as-is
       }
-    }).filter(Boolean); // Remove null/empty parts
-
+    }).filter(Boolean);
     return nodes.length > 0 ? nodes : null;
   }, [suffix, count, orderData === null || orderData === void 0 ? void 0 : orderData.subtotal]);
   const handleClick = useCallback(() => {
@@ -77,7 +68,6 @@ function CartButtonComponent(_ref) {
     dispatch(openCart());
   }, [count, dispatch]);
   useEffect(() => {
-    // set count only on the client, because on the server it's always gonna be zero
     setCount(cartButtonCount(orderData));
   }, [orderData, setCount]);
   if (!orderData) return null;
@@ -101,6 +91,9 @@ function CartButtonComponent(_ref) {
   }, suffixNodes))));
 }
 const query = (_CartButtonQuery.hash && _CartButtonQuery.hash !== "5c0da5849bf1215a9d1f264831830f71" && console.error("The definition of 'CartButtonQuery' appears to have changed. Run `relay-compiler` to update the generated files to receive the expected data."), _CartButtonQuery);
+export async function loadCartButtonQuery(options) {
+  return loadSerializableQuery(CartButtonQueryNode, {}, options);
+}
 export function CartButtonPreloadedQueryRenderer(_ref2) {
   var _data$viewer;
   let {
@@ -113,10 +106,20 @@ export function CartButtonPreloadedQueryRenderer(_ref2) {
     order: ((_data$viewer = data.viewer) === null || _data$viewer === void 0 ? void 0 : _data$viewer.currentOrder) ?? null
   }));
 }
-export default function CartButton(props) {
+function CartButtonLazyQueryRenderer(props) {
   var _data$viewer2;
   const data = useLazyLoadQuery(query, {});
   return /*#__PURE__*/React.createElement(CartButtonComponent, _extends({}, props, {
     order: ((_data$viewer2 = data.viewer) === null || _data$viewer2 === void 0 ? void 0 : _data$viewer2.currentOrder) ?? null
   }));
+}
+// Unified CartButton entry. Accepts an optional preloaded query (server-side
+// preload path) or fetches lazily on mount. `EnsureFontdueContext` self-wraps
+// with `FontdueContextProvider` only when no parent Fontdue context is
+// present, so the same component works as a standalone island or inside an
+// outer `<FontdueProvider>` tree.
+export default function CartButton(props) {
+  return /*#__PURE__*/React.createElement(EnsureFontdueContext, null, props.preloadedQuery ? /*#__PURE__*/React.createElement(CartButtonPreloadedQueryRenderer, _extends({}, props, {
+    preloadedQuery: props.preloadedQuery
+  })) : /*#__PURE__*/React.createElement(CartButtonLazyQueryRenderer, props));
 }

package/dist/components/CartButton/index.server.js

@@ -3,6 +3,11 @@ import React from 'react';
 import loadSerializableQuery from '../../relay/loadSerializableQuery.js';
 import { CartButtonPreloadedQueryRenderer } from './index.js';
 import CartButtonQueryNode from '../../__generated__/CartButtonQuery.graphql.js';
+
+// Next RSC variant: awaits the query on the server and hands the response to
+// the client `CartButtonPreloadedQueryRenderer`. Lets pages just write
+// `<CartButton />` in an RSC without manually invoking
+// `loadCartButtonQuery` + threading `preloadedQuery` through props.
 export default async function CartButton(props) {
   const preloadedQuery = await loadSerializableQuery(CartButtonQueryNode, {});
   return /*#__PURE__*/React.createElement(CartButtonPreloadedQueryRenderer, _extends({