fontdue-js 3.0.0-alpha1 → 3.0.0-alpha2

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

@@ -1,12 +1,17 @@
 import React from 'react';
 import { TestFontsForm_Query } from '../../__generated__/TestFontsForm_Query.graphql.js';
-import { SerializablePreloadedQuery } from '../../relay/loadSerializableQuery.js';
+import { LoadSerializableQueryOptions, SerializablePreloadedQuery } from '../../relay/loadSerializableQuery.js';
 export interface TestFontsForm_props {
     agreementLabel?: string;
     downloadLabel?: string;
     newsletterCheckboxChecked?: boolean;
 }
+export type TestFontsFormPreloadedQuery = SerializablePreloadedQuery<TestFontsForm_Query>;
+export declare function loadTestFontsFormQuery(options?: LoadSerializableQueryOptions): Promise<TestFontsFormPreloadedQuery>;
 export declare function TestFontsFormPreloadedQueryRenderer({ preloadedQuery, ...rest }: TestFontsForm_props & {
-    preloadedQuery: SerializablePreloadedQuery<TestFontsForm_Query>;
+    preloadedQuery: TestFontsFormPreloadedQuery;
 }): React.JSX.Element;
-export default function TestFontsForm(props: TestFontsForm_props): React.JSX.Element;
+export type TestFontsForm_unifiedProps = TestFontsForm_props & {
+    preloadedQuery?: TestFontsFormPreloadedQuery;
+};
+export default function TestFontsForm(props: TestFontsForm_unifiedProps): React.JSX.Element;

package/dist/components/TestFontsForm/index.js

@@ -8,8 +8,11 @@ import { commitMutation, graphql, useRelayEnvironment, useLazyLoadQuery, usePrel
 import { ReCAPTCHA } from 'react-google-recaptcha';
 import TextField from '../TextField/index.js';
 import { DownloadFonts } from '../Icons/index.js';
+import TestFontsFormQueryNode from '../../__generated__/TestFontsForm_Query.graphql.js';
 import Checkbox from '../Checkbox/index.js';
+import loadSerializableQuery from '../../relay/loadSerializableQuery.js';
 import useSerializablePreloadedQuery from '../../relay/useSerializablePreloadedQuery.js';
+import { EnsureFontdueContext } from '../FontdueContextProvider/index.js';
 const updateCustomerMutation = (_TestFontsFormUpdateCustomerMutation.hash && _TestFontsFormUpdateCustomerMutation.hash !== "ba56958399f0893bd667ff02c33a6975" && console.error("The definition of 'TestFontsFormUpdateCustomerMutation' appears to have changed. Run `relay-compiler` to update the generated files to receive the expected data."), _TestFontsFormUpdateCustomerMutation);
 const TestFontsDownloading = _ref => {
   let {
@@ -191,6 +194,9 @@ const TestFontsFormComponent = _ref2 => {
   }));
 };
 const query = (_TestFontsForm_Query.hash && _TestFontsForm_Query.hash !== "cd43f0cacc4dcf01cf94fb1ff97197ca" && console.error("The definition of 'TestFontsForm_Query' appears to have changed. Run `relay-compiler` to update the generated files to receive the expected data."), _TestFontsForm_Query);
+export async function loadTestFontsFormQuery(options) {
+  return loadSerializableQuery(TestFontsFormQueryNode, {}, options);
+}
 export function TestFontsFormPreloadedQueryRenderer(_ref4) {
   let {
     preloadedQuery,
@@ -202,9 +208,18 @@ export function TestFontsFormPreloadedQueryRenderer(_ref4) {
     data: data
   }, rest));
 }
-export default function TestFontsForm(props) {
+function TestFontsFormLazyQueryRenderer(props) {
   const data = useLazyLoadQuery(query, {});
   return /*#__PURE__*/React.createElement(TestFontsFormComponent, _extends({
     data: data
   }, props));
+}
+// Unified TestFontsForm entry. Accepts an optional preloaded query
+// (server-side preload path) or fetches lazily on mount. `EnsureFontdueContext`
+// only self-wraps with `FontdueContextProvider` when no parent Fontdue
+// context is present.
+export default function TestFontsForm(props) {
+  return /*#__PURE__*/React.createElement(EnsureFontdueContext, null, props.preloadedQuery ? /*#__PURE__*/React.createElement(TestFontsFormPreloadedQueryRenderer, _extends({}, props, {
+    preloadedQuery: props.preloadedQuery
+  })) : /*#__PURE__*/React.createElement(TestFontsFormLazyQueryRenderer, props));
 }

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

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

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

@@ -1,2 +1,5 @@
 import React from 'react';
-export default function TestModeBanner(): React.JSX.Element;
+import type { TestModeBanner_viewer$key } from '../../__generated__/TestModeBanner_viewer.graphql.js';
+export default function TestModeBanner({ viewer }: {
+    viewer: TestModeBanner_viewer$key;
+}): React.JSX.Element | null;

package/dist/components/TestModeBanner/index.js

@@ -1,30 +1,22 @@
 'use client';
 
-import _TestModeBannerQuery from "../../__generated__/TestModeBannerQuery.graphql.js";
+import _TestModeBanner_viewer from "../../__generated__/TestModeBanner_viewer.graphql.js";
 import React from 'react';
-import { graphql, useLazyLoadQuery } from 'react-relay';
-function TestModeBannerComponent(_ref) {
-  var _data$viewer, _data$viewer$testMode;
+import { graphql, useFragment } from 'react-relay';
+const fragment = (_TestModeBanner_viewer.hash && _TestModeBanner_viewer.hash !== "f6b2f851466be9599d63ebf8f39e1a96" && console.error("The definition of 'TestModeBanner_viewer' appears to have changed. Run `relay-compiler` to update the generated files to receive the expected data."), _TestModeBanner_viewer);
+export default function TestModeBanner(_ref) {
+  var _data$testMode;
   let {
-    data
+    viewer
   } = _ref;
-  const isActive = data === null || data === void 0 ? void 0 : (_data$viewer = data.viewer) === null || _data$viewer === void 0 ? void 0 : (_data$viewer$testMode = _data$viewer.testMode) === null || _data$viewer$testMode === void 0 ? void 0 : _data$viewer$testMode.isActive;
-
-  // hide the banner completely if we're in live mode
-  if (!isActive) return null;
+  const data = useFragment(fragment, viewer);
+  if (!((_data$testMode = data.testMode) !== null && _data$testMode !== void 0 && _data$testMode.isActive)) return null;
   return /*#__PURE__*/React.createElement("div", {
     className: "test-mode-banner__banner",
-    "data-test-mode": isActive
+    "data-test-mode": true
   }, /*#__PURE__*/React.createElement("div", {
     className: "test-mode-banner__content"
   }, /*#__PURE__*/React.createElement("div", {
     className: "test-mode-banner__title"
   }, "Viewing test data")));
-}
-const query = (_TestModeBannerQuery.hash && _TestModeBannerQuery.hash !== "60ad67ee88ec6b74dd04bdf5572e7faf" && console.error("The definition of 'TestModeBannerQuery' appears to have changed. Run `relay-compiler` to update the generated files to receive the expected data."), _TestModeBannerQuery);
-export default function TestModeBanner() {
-  const data = useLazyLoadQuery(query, {});
-  return /*#__PURE__*/React.createElement(TestModeBannerComponent, {
-    data: data
-  });
 }

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

@@ -1,7 +1,5 @@
 import React from 'react';
-import { ThemeConfigQuery } from '../../__generated__/ThemeConfigQuery.graphql.js';
-import { SerializablePreloadedQuery } from '../../relay/loadSerializableQuery.js';
-export declare function ThemeConfigPreloadedQueryRenderer({ preloadedQuery, }: {
-    preloadedQuery: SerializablePreloadedQuery<ThemeConfigQuery>;
+import type { ThemeConfig_viewer$key } from '../../__generated__/ThemeConfig_viewer.graphql.js';
+export default function ThemeConfig({ viewer }: {
+    viewer: ThemeConfig_viewer$key;
 }): React.JSX.Element;
-export default function ThemeConfig(): React.JSX.Element;

package/dist/components/ThemeConfig/index.js

@@ -1,38 +1,20 @@
 'use client';
 
-import _ThemeConfigQuery from "../../__generated__/ThemeConfigQuery.graphql.js";
+import _ThemeConfig_viewer from "../../__generated__/ThemeConfig_viewer.graphql.js";
 import React from 'react';
-import { graphql, useLazyLoadQuery, usePreloadedQuery } from 'react-relay';
-import useSerializablePreloadedQuery from '../../relay/useSerializablePreloadedQuery.js';
+import { graphql, useFragment } from 'react-relay';
+const fragment = (_ThemeConfig_viewer.hash && _ThemeConfig_viewer.hash !== "191db4fda0651cd596efa7f91699f895" && console.error("The definition of 'ThemeConfig_viewer' appears to have changed. Run `relay-compiler` to update the generated files to receive the expected data."), _ThemeConfig_viewer);
 
-// gets the custom properties entered by users in the admin panel,
-// which also includes default values. we put the defaults there instead of
-// every call to var() so that we have defaults all in one place
-
-function ThemeConfigComponent(_ref) {
-  var _data$viewer$themeCon;
+// Renders custom properties entered by tenant admins (with library defaults)
+// as a single :root style block so var(...) lookups resolve everywhere.
+export default function ThemeConfig(_ref) {
+  var _data$themeConfig;
   let {
-    data
+    viewer
   } = _ref;
-  const props = ((_data$viewer$themeCon = data.viewer.themeConfig) === null || _data$viewer$themeCon === void 0 ? void 0 : _data$viewer$themeCon.customProperties) ?? [];
+  const data = useFragment(fragment, viewer);
+  const props = ((_data$themeConfig = data.themeConfig) === null || _data$themeConfig === void 0 ? void 0 : _data$themeConfig.customProperties) ?? [];
   return /*#__PURE__*/React.createElement("style", {
     type: "text/css"
   }, `:root { ${props.join(';')} }`);
-}
-const query = (_ThemeConfigQuery.hash && _ThemeConfigQuery.hash !== "c259bee038c4d2ea14c758fba3381f57" && console.error("The definition of 'ThemeConfigQuery' appears to have changed. Run `relay-compiler` to update the generated files to receive the expected data."), _ThemeConfigQuery);
-export function ThemeConfigPreloadedQueryRenderer(_ref2) {
-  let {
-    preloadedQuery
-  } = _ref2;
-  const queryRef = useSerializablePreloadedQuery(preloadedQuery);
-  const data = usePreloadedQuery(query, queryRef);
-  return /*#__PURE__*/React.createElement(ThemeConfigComponent, {
-    data: data
-  });
-}
-export default function ThemeConfig() {
-  const data = useLazyLoadQuery(query, {});
-  return /*#__PURE__*/React.createElement(ThemeConfigComponent, {
-    data: data
-  });
 }

package/dist/components/TypeTester/TypeTesterStandalone.d.ts

@@ -1,7 +1,7 @@
 import React from 'react';
 import { Alignment, Direction, FeaturesProp } from './types.js';
-import { SerializablePreloadedQuery } from '../../relay/loadSerializableQuery.js';
-import { TypeTesterStandaloneQuery } from '__generated__/TypeTesterStandaloneQuery.graphql.js';
+import { LoadSerializableQueryOptions, SerializablePreloadedQuery } from '../../relay/loadSerializableQuery.js';
+import { TypeTesterStandaloneQuery } from '../../__generated__/TypeTesterStandaloneQuery.graphql.js';
 interface TypeTesterStandaloneComponent_props {
     lineHeight?: number | null;
     letterSpacing?: number | null;
@@ -24,12 +24,26 @@ interface TypeTesterStandaloneComponent_props {
     onFocus?: () => void;
     onBlur?: () => void;
 }
-export interface TypeTesterStandalone_props extends TypeTesterStandaloneComponent_props {
+export type TypeTesterPreloadedQuery = SerializablePreloadedQuery<TypeTesterStandaloneQuery>;
+export interface LoadTypeTesterQueryVariables {
     familyName: string;
     styleName: string;
+    selectable?: boolean;
 }
+export declare function loadTypeTesterQuery(variables: LoadTypeTesterQueryVariables, options?: LoadSerializableQueryOptions): Promise<TypeTesterPreloadedQuery>;
 export declare function TypeTesterStandalonePreloadedQueryRenderer({ preloadedQuery, ...rest }: TypeTesterStandaloneComponent_props & {
-    preloadedQuery: SerializablePreloadedQuery<TypeTesterStandaloneQuery>;
+    preloadedQuery: TypeTesterPreloadedQuery;
 }): React.JSX.Element;
-export default function TypeTesterStandalone({ familyName, styleName, ...rest }: TypeTesterStandalone_props): React.JSX.Element;
+export type TypeTesterStandalone_props = TypeTesterStandaloneComponent_props & ({
+    preloadedQuery: TypeTesterPreloadedQuery;
+    familyName?: never;
+    styleName?: never;
+    selectable?: never;
+} | {
+    preloadedQuery?: never;
+    familyName: string;
+    styleName: string;
+    selectable?: boolean;
+});
+export default function TypeTesterStandalone(props: TypeTesterStandalone_props): React.JSX.Element;
 export {};

package/dist/components/TypeTester/TypeTesterStandalone.js

@@ -8,8 +8,11 @@ import { fetchQuery, graphql, useLazyLoadQuery, usePreloadedQuery, useRelayEnvir
 import TypeTester from './index.js';
 import TypeTesterContextComponent from './TypeTesterContext.js';
 import { normalizeFeaturesProp } from './types.js';
+import loadSerializableQuery from '../../relay/loadSerializableQuery.js';
 import useSerializablePreloadedQuery from '../../relay/useSerializablePreloadedQuery.js';
+import TypeTesterStandaloneQueryNode from '../../__generated__/TypeTesterStandaloneQuery.graphql.js';
 import ConfigContext from '../ConfigContext.js';
+import { EnsureFontdueContext } from '../FontdueContextProvider/index.js';
 import { useLicenseAndOrderVariables } from '../../hooks/useLicenseAndOrderVariables.js';
 const changedStylesQuery = (_TypeTesterStandaloneChangedStylesQuery.hash && _TypeTesterStandaloneChangedStylesQuery.hash !== "98374227c6b2c3eceab5b48138e1a662" && console.error("The definition of 'TypeTesterStandaloneChangedStylesQuery' appears to have changed. Run `relay-compiler` to update the generated files to receive the expected data."), _TypeTesterStandaloneChangedStylesQuery);
 function TypeTesterStandaloneComponent(_ref) {
@@ -98,6 +101,13 @@ function TypeTesterStandaloneComponent(_ref) {
   }));
 }
 const query = (_TypeTesterStandaloneQuery.hash && _TypeTesterStandaloneQuery.hash !== "57916b8e26a166271a80c5df1b3f68ec" && console.error("The definition of 'TypeTesterStandaloneQuery' appears to have changed. Run `relay-compiler` to update the generated files to receive the expected data."), _TypeTesterStandaloneQuery);
+export async function loadTypeTesterQuery(variables, options) {
+  return loadSerializableQuery(TypeTesterStandaloneQueryNode, {
+    familyName: variables.familyName,
+    styleName: variables.styleName,
+    selectable: variables.selectable ?? true
+  }, options);
+}
 export function TypeTesterStandalonePreloadedQueryRenderer(_ref3) {
   let {
     preloadedQuery,
@@ -109,11 +119,12 @@ export function TypeTesterStandalonePreloadedQueryRenderer(_ref3) {
     data: data
   }, rest));
 }
-export default function TypeTesterStandalone(_ref4) {
+function TypeTesterStandaloneLazyQueryRenderer(_ref4) {
   var _data$viewer4;
   let {
     familyName,
     styleName,
+    selectable,
     ...rest
   } = _ref4;
   const {
@@ -122,7 +133,7 @@ export default function TypeTesterStandalone(_ref4) {
   const data = useLazyLoadQuery(query, {
     familyName,
     styleName,
-    selectable: config.selectable
+    selectable: selectable ?? config.selectable
   });
   const fontStyle = (_data$viewer4 = data.viewer) === null || _data$viewer4 === void 0 ? void 0 : _data$viewer4.fontStyle;
   if (!fontStyle) {
@@ -131,4 +142,12 @@ export default function TypeTesterStandalone(_ref4) {
   return /*#__PURE__*/React.createElement(TypeTesterStandaloneComponent, _extends({
     data: data
   }, rest));
+}
+// Unified TypeTester entry point. Accepts either a preloaded query (server-side
+// preload path, used by Astro/Vike/etc.) or `{familyName, styleName}` (lazy
+// path, used inside an existing `<FontdueProvider>` tree like Next layouts).
+// `EnsureFontdueContext` only self-wraps with `FontdueContextProvider` when
+// no parent Fontdue context is present.
+export default function TypeTesterStandalone(props) {
+  return /*#__PURE__*/React.createElement(EnsureFontdueContext, null, 'preloadedQuery' in props && props.preloadedQuery ? /*#__PURE__*/React.createElement(TypeTesterStandalonePreloadedQueryRenderer, props) : /*#__PURE__*/React.createElement(TypeTesterStandaloneLazyQueryRenderer, props));
 }

package/dist/components/TypeTester/TypeTesterStandalone.preload.js

@@ -1,7 +1,7 @@
 import React from 'react';
 import loadSerializableQuery from '../../relay/loadSerializableQuery.js';
 import TypeTesterStandaloneQueryNode from '../../__generated__/TypeTesterStandaloneQuery.graphql.js';
-import FontdueProvider from '../FontdueProvider/index.js';
+import FontdueContextProvider from '../FontdueContextProvider/index.js';
 import { TypeTesterStandalonePreloadedQueryRenderer } from './TypeTesterStandalone.js';
 export async function loadTypeTesterQuery(variables, options) {
   return loadSerializableQuery(TypeTesterStandaloneQueryNode, {
@@ -10,10 +10,11 @@ export async function loadTypeTesterQuery(variables, options) {
     selectable: variables.selectable ?? true
   }, options);
 }
-// Self-wraps with FontdueProvider so consumers don't need to. The provider
-// state is a module-level singleton under the hood, so multiple
-// TypeTesterPreloaded (or other *Preloaded) components on a page all share
-// one Relay env + Redux store + auxiliary UI.
+// Self-wraps with FontdueContextProvider so consumers don't need to wire up
+// Relay env / Redux store / contexts at the call site. Aux UI (theme,
+// test-mode banner, consent, tracking) is NOT rendered here — that belongs
+// to a single layout-level `<FontdueProvider>` per page. State is shared
+// across multiple preloaded components on a page via module-level singletons.
 export function TypeTesterPreloaded(props) {
-  return /*#__PURE__*/React.createElement(FontdueProvider, null, /*#__PURE__*/React.createElement(TypeTesterStandalonePreloadedQueryRenderer, props));
+  return /*#__PURE__*/React.createElement(FontdueContextProvider, null, /*#__PURE__*/React.createElement(TypeTesterStandalonePreloadedQueryRenderer, props));
 }

package/dist/components/TypeTester/TypeTesterStandalone.server.d.ts

@@ -1,3 +1,5 @@
 import React from 'react';
-import { TypeTesterStandalone_props } from './TypeTesterStandalone.js';
-export default function TypeTesterStandalone({ familyName, styleName, ...rest }: TypeTesterStandalone_props): Promise<React.JSX.Element>;
+import type { TypeTesterStandalone_props } from './TypeTesterStandalone.js';
+export default function TypeTesterStandalone(props: Extract<TypeTesterStandalone_props, {
+    familyName: string;
+}>): Promise<React.JSX.Element>;

package/dist/components/TypeTester/TypeTesterStandalone.server.js

@@ -3,16 +3,23 @@ import React from 'react';
 import loadSerializableQuery from '../../relay/loadSerializableQuery.js';
 import { TypeTesterStandalonePreloadedQueryRenderer } from './TypeTesterStandalone.js';
 import TypeTesterStandaloneQueryNode from '../../__generated__/TypeTesterStandaloneQuery.graphql.js';
-export default async function TypeTesterStandalone(_ref) {
-  let {
+
+// Next RSC variant: awaits the query on the server and hands the response to
+// the client `TypeTesterStandalonePreloadedQueryRenderer`. Lets pages just
+// write `<TypeTester familyName="..." styleName="..." />` in an RSC without
+// manually invoking `loadTypeTesterQuery` + threading `preloadedQuery`
+// through props.
+export default async function TypeTesterStandalone(props) {
+  const {
     familyName,
     styleName,
+    selectable,
     ...rest
-  } = _ref;
+  } = props;
   const preloadedQuery = await loadSerializableQuery(TypeTesterStandaloneQueryNode, {
     familyName,
     styleName,
-    selectable: true
+    selectable: selectable ?? true
   });
   return /*#__PURE__*/React.createElement(TypeTesterStandalonePreloadedQueryRenderer, _extends({
     preloadedQuery: preloadedQuery

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

@@ -2,7 +2,7 @@ import React from 'react';
 import { TypeTestersIDQuery } from '../../__generated__/TypeTestersIDQuery.graphql.js';
 import { TypeTestersSlugQuery } from '../../__generated__/TypeTestersSlugQuery.graphql.js';
 import { FeaturesProp } from '../TypeTester/types.js';
-import { SerializablePreloadedQuery } from '../../relay/loadSerializableQuery.js';
+import { LoadSerializableQueryOptions, SerializablePreloadedQuery } from '../../relay/loadSerializableQuery.js';
 export interface TypeTesters_props {
     collectionId?: string;
     collectionSlug?: string;
@@ -21,4 +21,20 @@ export declare function TypeTestersPreloadedIDQueryRenderer({ preloadedQuery, ..
 export declare function TypeTestersPreloadedSlugQueryRenderer({ preloadedQuery, ...rest }: TypeTesters_props & {
     preloadedQuery: SerializablePreloadedQuery<TypeTestersSlugQuery>;
 }): React.JSX.Element;
-export default function TypeTesters({ collectionId, collectionSlug, ...rest }: TypeTesters_props): React.JSX.Element | null;
+export type TypeTestersPreloadedQuery = SerializablePreloadedQuery<TypeTestersIDQuery> | SerializablePreloadedQuery<TypeTestersSlugQuery>;
+export type LoadTypeTestersQueryVariables = ({
+    collectionId: string;
+    collectionSlug?: never;
+} | {
+    collectionId?: never;
+    collectionSlug: string;
+}) & {
+    tags?: string[] | null;
+    excludeTags?: string[] | null;
+    selectable?: boolean;
+};
+export declare function loadTypeTestersQuery(variables: LoadTypeTestersQueryVariables, options?: LoadSerializableQueryOptions): Promise<TypeTestersPreloadedQuery>;
+export type TypeTesters_unifiedProps = TypeTesters_props & {
+    preloadedQuery?: TypeTestersPreloadedQuery;
+};
+export default function TypeTesters({ collectionId, collectionSlug, preloadedQuery, ...rest }: TypeTesters_unifiedProps): React.JSX.Element | null;

package/dist/components/TypeTesters/index.js

@@ -10,6 +10,8 @@ import React, { useContext, useState, useCallback, useMemo } from 'react';
 import { graphql, useFragment, useLazyLoadQuery, usePreloadedQuery, useRefetchableFragment, useRelayEnvironment, fetchQuery } from 'react-relay';
 import { useSelector } from 'react-redux';
 import PriceBar from '../PriceBar/index.js';
+import TypeTestersIDQueryNode from '../../__generated__/TypeTestersIDQuery.graphql.js';
+import TypeTestersSlugQueryNode from '../../__generated__/TypeTestersSlugQuery.graphql.js';
 import { notEmpty } from '../../utils.js';
 import TypeTesterContext from '../TypeTester/TypeTesterContext.js';
 import ConfigContext from '../ConfigContext.js';
@@ -19,8 +21,10 @@ import TypeTestersChangedStylesQuery from '../../__generated__/TypeTestersChange
 import TypeTester from '../TypeTester/index.js';
 import TypeTesterFloatingToolbar from '../TypeTester/TypeTesterFloatingToolbar.js';
 import { normalizeFeaturesProp } from '../TypeTester/types.js';
+import loadSerializableQuery from '../../relay/loadSerializableQuery.js';
 import useSerializablePreloadedQuery from '../../relay/useSerializablePreloadedQuery.js';
 import { useLicenseAndOrderVariables } from '../../hooks/useLicenseAndOrderVariables.js';
+import { EnsureFontdueContext } from '../FontdueContextProvider/index.js';
 const findPriceBarCollection = (collection, familyId) => {
   if (collection.id === familyId) return collection;
   if (!collection.families) return null;
@@ -255,21 +259,67 @@ function TypeTestersSlugQueryRenderer(_ref6) {
     excludeTags: excludeTags
   }));
 }
-export default function TypeTesters(_ref7) {
+export async function loadTypeTestersQuery(variables, options) {
+  const tags = variables.tags ?? null;
+  const excludeTags = variables.excludeTags ?? null;
+  const selectable = variables.selectable ?? true;
+  if (variables.collectionId) {
+    return loadSerializableQuery(TypeTestersIDQueryNode, {
+      collectionId: variables.collectionId,
+      tags,
+      excludeTags,
+      selectable
+    }, options);
+  }
+  if (variables.collectionSlug) {
+    return loadSerializableQuery(TypeTestersSlugQueryNode, {
+      collectionSlug: variables.collectionSlug,
+      tags,
+      excludeTags,
+      selectable
+    }, options);
+  }
+  throw new Error('loadTypeTestersQuery expected either collectionId or collectionSlug');
+}
+function TypeTestersPreloadedRenderer(_ref7) {
+  let {
+    preloadedQuery,
+    ...rest
+  } = _ref7;
+  if (preloadedQuery.params.name === 'TypeTestersIDQuery') {
+    return /*#__PURE__*/React.createElement(TypeTestersPreloadedIDQueryRenderer, _extends({
+      preloadedQuery: preloadedQuery
+    }, rest));
+  }
+  return /*#__PURE__*/React.createElement(TypeTestersPreloadedSlugQueryRenderer, _extends({
+    preloadedQuery: preloadedQuery
+  }, rest));
+}
+// Unified TypeTesters entry. Accepts an optional 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 TypeTesters(_ref8) {
   let {
     collectionId,
     collectionSlug,
+    preloadedQuery,
     ...rest
-  } = _ref7;
-  if (collectionId) {
-    return /*#__PURE__*/React.createElement(TypeTestersIDQueryRenderer, _extends({
+  } = _ref8;
+  let inner = null;
+  if (preloadedQuery) {
+    inner = /*#__PURE__*/React.createElement(TypeTestersPreloadedRenderer, _extends({
+      preloadedQuery: preloadedQuery
+    }, rest));
+  } else if (collectionId) {
+    inner = /*#__PURE__*/React.createElement(TypeTestersIDQueryRenderer, _extends({
       collectionId: collectionId
     }, rest));
-  }
-  if (collectionSlug) {
-    return /*#__PURE__*/React.createElement(TypeTestersSlugQueryRenderer, _extends({
+  } else if (collectionSlug) {
+    inner = /*#__PURE__*/React.createElement(TypeTestersSlugQueryRenderer, _extends({
       collectionSlug: collectionSlug
     }, rest));
   }
-  return null;
+  if (!inner) return null;
+  return /*#__PURE__*/React.createElement(EnsureFontdueContext, null, inner);
 }

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

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

package/dist/config.d.ts

@@ -1,4 +1,5 @@
-export interface FontdueConfig {
+import type { Config } from './components/ConfigContext.js';
+export interface FontdueConfig extends Config {
     url?: string;
     stripeIntegration?: 'card-element' | 'dynamic';
 }

package/dist/config.js

@@ -1,14 +1,25 @@
 // Module-level global configuration. Consumers call `configure()` once at
-// app startup (e.g. Astro middleware, Next layout, Vite entry) and every
-// fontdue-js entry point reads defaults from here. Explicit options passed
-// to loadSerializableQuery / FontdueProvider still override.
+// app startup (Astro layout, Next layout, Vite entry) and every fontdue-js
+// entry point reads defaults from here.
+//
+// Precedence (low to high):
+//   1. Server admin config (from the tenant dashboard, fetched via Relay)
+//   2. configure({...})  — module-level code defaults
+//   3. <FontdueProvider config={...}>  — per-instance prop override
 //
 // Per-request isolation note: `configure` sets module-level state. That's
-// fine for single-tenant apps (one URL for the whole site). Multi-tenant
-// servers that switch URL per request should pass `url` explicitly to
-// loadSerializableQuery rather than rely on configure().
+// fine for single-tenant apps. Multi-tenant servers that switch URL per
+// request should pass `url` explicitly to loadSerializableQuery rather than
+// rely on configure().
+
+// Network-layer + UI config in one bag. UI fields come from `Config` (the
+// shape passed to ConfigContext); URL + stripeIntegration are network-layer.
 
 let current = {};
+
+// Shallow-merges with prior values. Calling `configure({tracking: {...}})`
+// replaces the whole `tracking` subtree; pass nested fields fully populated
+// when partial-updating.
 export function configure(opts) {
   current = {
     ...current,

package/dist/index.d.ts

@@ -1,2 +1,2 @@
-export { configure, getConfig } from './config.js';
-export type { FontdueConfig } from './config.js';
+export { default as loadFontdueProviderQuery } from './loadFontdueProviderQuery.js';
+export type { FontdueProviderPreloadedQuery } from './loadFontdueProviderQuery.js';

package/dist/index.js

@@ -1 +1 @@
-export { configure, getConfig } from './config.js';
+export { default as loadFontdueProviderQuery } from './loadFontdueProviderQuery.js';

package/dist/loadFontdueProviderQuery.d.ts

@@ -0,0 +1,4 @@
+import { LoadSerializableQueryOptions } from './relay/loadSerializableQuery.js';
+import type { FontdueProviderPreloadedQuery } from './components/FontdueProvider/index.js';
+export type { FontdueProviderPreloadedQuery };
+export default function loadFontdueProviderQuery(options?: LoadSerializableQueryOptions): Promise<FontdueProviderPreloadedQuery>;

package/dist/loadFontdueProviderQuery.js

@@ -0,0 +1,10 @@
+import loadSerializableQuery from './relay/loadSerializableQuery.js';
+import FontdueProviderQueryNode from './__generated__/FontdueProviderQuery.graphql.js';
+// Fetches the data aux UI (theme custom properties, test-mode flag) needs to
+// render synchronously on the server and on hydration. Pass the result to
+// `<FontdueProvider preloadedQuery={…}>` in your layout. Without it, aux UI
+// falls back to lazy-fetching on first client render — which causes a visible
+// theming flash because `ThemeConfig` injects CSS variables.
+export default async function loadFontdueProviderQuery(options) {
+  return loadSerializableQuery(FontdueProviderQueryNode, {}, options);
+}

package/dist/relay/environment.js

@@ -1,10 +1,9 @@
 import { Environment, Network, RecordSource, Store, QueryResponseCache } from 'relay-runtime';
 import { handlePossibleCorsError } from '../corsError.js';
-import { getConfig } from '../config.js';
 
 // `__FONTDUE_JS_VERSION__` is replaced by an inline babel plugin
 // (defineVersionPlugin in .babelrc.cjs) with the literal package.json#version.
-const version = "3.0.0-alpha1";
+const version = "3.0.0-alpha2";
 const IS_SERVER = typeof window === typeof undefined;
 
 // Read env from either process.env (Node/Next.js) or import.meta.env (Vite/Astro).
@@ -38,9 +37,9 @@ const CACHE_TTL = 10 * 1000; // 10 seconds, to resolve preloaded results
 
 export function createNetworkFetch(options) {
   return async function networkFetch(request, variables) {
-    const base = (options === null || options === void 0 ? void 0 : options.url) ?? getConfig().url ?? FONTDUE_URL;
+    const base = (options === null || options === void 0 ? void 0 : options.url) ?? FONTDUE_URL;
     if (IS_SERVER && (base == null || base === '')) {
-      throw new Error('fontdue-js: no Fontdue URL configured for server-side fetch. ' + 'Call configure({ url }) at app startup, set FONTDUE_URL in your environment, ' + 'or pass `url` explicitly to loadSerializableQuery / createEnvironment.');
+      throw new Error('fontdue-js: no Fontdue URL configured for server-side fetch. ' + 'Set FONTDUE_URL / PUBLIC_FONTDUE_URL / VITE_FONTDUE_URL in your environment, ' + 'or pass `url` explicitly to loadSerializableQuery (or its component-level wrappers).');
     }
     const url = `${base ?? ''}/graphql`;
     for (let attempt = 0; attempt <= 2; attempt++) {
@@ -51,7 +50,7 @@ export function createNetworkFetch(options) {
           headers: {
             Accept: 'application/json',
             'Content-Type': 'application/json',
-            'fontdue-stripe-integration': (options === null || options === void 0 ? void 0 : options.stripeIntegration) ?? getConfig().stripeIntegration ?? STRIPE_INTEGRATION ?? 'dynamic',
+            'fontdue-stripe-integration': (options === null || options === void 0 ? void 0 : options.stripeIntegration) ?? STRIPE_INTEGRATION ?? 'dynamic',
             'fontdue-client-version': version
           },
           body: JSON.stringify({

package/dist/vite.d.ts

@@ -1 +1,2 @@
-export default function fontdueJs(): unknown[];
+import type { PluginOption } from 'vite';
+export default function fontdueJs(): PluginOption[];