fontdue-js 2.20.1 → 2.22.0

package/dist-bundle/TypeTester.preload.js

@@ -0,0 +1,75 @@
+import React__default from 'react';
+import { c as createNetworkFetch } from './chunks/ComponentsContext-CmkN9J4X.js';
+import { T as TypeTesterStandalonePreloadedQueryRenderer, n as node } from './chunks/TypeTesterStandalone-BMWuv8Ca.js';
+import { F as FontdueProvider } from './chunks/index-C4ak9qTL.js';
+import './index.js';
+import 'react-dom';
+
+/**
+ * RELAY CACHE KEY NORMALIZATION
+ *
+ * This type transformation is required to fix a cache key inconsistency issue in Relay.
+ *
+ * THE PROBLEM:
+ * Relay's `getOperationVariables()` function always includes ALL argumentDefinitions
+ * from the GraphQL operation, even optional ones, setting them to their defaultValue
+ * (typically null). This means when Relay generates cache keys, it creates entries like:
+ *
+ * Cache Key A: { collectionId: "123", tags: null, excludeTags: null, selectable: true }
+ * Cache Key B: { collectionId: "123", selectable: true }  // when optional vars omitted
+ *
+ * Even though these represent the same logical query, they produce different cache keys
+ * because `JSON.stringify(stableCopy(variables))` serializes them differently.
+ *
+ *  (This is possibly caused by NextJS RSC data serialization and hydration)
+ *
+ * THE ROOT CAUSE:
+ * - GraphQL schema defines: `$tags: [String!], $excludeTags: [String!]` (optional)
+ * - TypeScript generates: `tags?: ReadonlyArray<string> | null`
+ * - Relay's argumentDefinitions include: `{ name: "tags", defaultValue: null }`
+ * - getOperationVariables() always sets: `operationVariables[def.name] = def.defaultValue`
+ *
+ * THE SOLUTION:
+ * RequireAllWithNull<T> transforms optional properties to required properties with
+ * explicit null values, forcing callers to be consistent. This ensures server-side
+ * preloaded queries and client-side cache lookups use identical variable structures.
+ *
+ * USAGE:
+ * Instead of: { tags, excludeTags } // undefined values
+ * Use:        { tags: tags ?? null, excludeTags: excludeTags ?? null } // explicit nulls
+ *
+ * This eliminates cache misses caused by variable structure inconsistencies between
+ * server-side rendering and client-side Relay operations.
+ */
+
+// Call into raw network fetch to get serializable GraphQL query response
+// This response will be sent to the client to "warm" the QueryResponseCache
+// to avoid the client fetches.
+async function loadSerializableQuery(query, variables, options) {
+  if (!('params' in query)) throw new Error('Params not found in query, is it a fragment instead of a query?');
+  const fetcher = createNetworkFetch(options);
+  const response = await fetcher(query.params, variables);
+  return {
+    params: query.params,
+    variables,
+    response
+  };
+}
+
+async function loadTypeTesterQuery(variables, options) {
+  return loadSerializableQuery(node, {
+    familyName: variables.familyName,
+    styleName: variables.styleName,
+    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.
+function TypeTesterPreloaded(props) {
+  return /*#__PURE__*/React__default.createElement(FontdueProvider, null, /*#__PURE__*/React__default.createElement(TypeTesterStandalonePreloadedQueryRenderer, props));
+}
+
+export { TypeTesterPreloaded, loadTypeTesterQuery };
+//# sourceMappingURL=TypeTester.preload.js.map

package/dist-bundle/TypeTester.preload.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"TypeTester.preload.js","sources":["../src/relay/loadSerializableQuery.ts","../src/components/TypeTester/TypeTesterStandalone.preload.tsx"],"sourcesContent":["import {\n  GraphQLResponse,\n  GraphQLTaggedNode,\n  OperationType,\n  RequestParameters,\n  VariablesOf,\n} from 'relay-runtime';\nimport { createNetworkFetch } from './environment';\n\nexport interface SerializablePreloadedQuery<TQuery extends OperationType> {\n  params: RequestParameters;\n  variables: VariablesOf<TQuery>;\n  response: GraphQLResponse;\n}\n\n/**\n * RELAY CACHE KEY NORMALIZATION\n *\n * This type transformation is required to fix a cache key inconsistency issue in Relay.\n *\n * THE PROBLEM:\n * Relay's `getOperationVariables()` function always includes ALL argumentDefinitions\n * from the GraphQL operation, even optional ones, setting them to their defaultValue\n * (typically null). This means when Relay generates cache keys, it creates entries like:\n *\n * Cache Key A: { collectionId: \"123\", tags: null, excludeTags: null, selectable: true }\n * Cache Key B: { collectionId: \"123\", selectable: true }  // when optional vars omitted\n *\n * Even though these represent the same logical query, they produce different cache keys\n * because `JSON.stringify(stableCopy(variables))` serializes them differently.\n *\n *  (This is possibly caused by NextJS RSC data serialization and hydration)\n *\n * THE ROOT CAUSE:\n * - GraphQL schema defines: `$tags: [String!], $excludeTags: [String!]` (optional)\n * - TypeScript generates: `tags?: ReadonlyArray<string> | null`\n * - Relay's argumentDefinitions include: `{ name: \"tags\", defaultValue: null }`\n * - getOperationVariables() always sets: `operationVariables[def.name] = def.defaultValue`\n *\n * THE SOLUTION:\n * RequireAllWithNull<T> transforms optional properties to required properties with\n * explicit null values, forcing callers to be consistent. This ensures server-side\n * preloaded queries and client-side cache lookups use identical variable structures.\n *\n * USAGE:\n * Instead of: { tags, excludeTags } // undefined values\n * Use:        { tags: tags ?? null, excludeTags: excludeTags ?? null } // explicit nulls\n *\n * This eliminates cache misses caused by variable structure inconsistencies between\n * server-side rendering and client-side Relay operations.\n */\ntype RequireAllWithNull<T> = {\n  [K in keyof T]-?: T[K] | null;\n};\n\nexport interface LoadSerializableQueryOptions {\n  url?: string;\n  stripeIntegration?: 'card-element' | 'dynamic';\n}\n\n// Call into raw network fetch to get serializable GraphQL query response\n// This response will be sent to the client to \"warm\" the QueryResponseCache\n// to avoid the client fetches.\nexport default async function loadSerializableQuery<TQuery extends OperationType>(\n  query: GraphQLTaggedNode,\n  variables: RequireAllWithNull<VariablesOf<TQuery>>,\n  options?: LoadSerializableQueryOptions,\n): Promise<SerializablePreloadedQuery<TQuery>> {\n  if (!('params' in query))\n    throw new Error('Params not found in query, is it a fragment instead of a query?');\n  const fetcher = createNetworkFetch(options);\n  const response = await fetcher(query.params, variables);\n\n  return {\n    params: query.params,\n    variables,\n    response,\n  };\n}\n","import React from 'react';\nimport loadSerializableQuery, {\n  LoadSerializableQueryOptions,\n  SerializablePreloadedQuery,\n} from '../../relay/loadSerializableQuery';\nimport TypeTesterStandaloneQueryNode, {\n  TypeTesterStandaloneQuery,\n} from '../../__generated__/TypeTesterStandaloneQuery.graphql';\nimport FontdueProvider from '../FontdueProvider';\nimport { TypeTesterStandalonePreloadedQueryRenderer } from './TypeTesterStandalone';\n\nexport type TypeTesterPreloadedQuery =\n  SerializablePreloadedQuery<TypeTesterStandaloneQuery>;\n\nexport interface LoadTypeTesterQueryVariables {\n  familyName: string;\n  styleName: string;\n  selectable?: boolean;\n}\n\nexport async function loadTypeTesterQuery(\n  variables: LoadTypeTesterQueryVariables,\n  options?: LoadSerializableQueryOptions,\n): Promise<TypeTesterPreloadedQuery> {\n  return loadSerializableQuery<TypeTesterStandaloneQuery>(\n    TypeTesterStandaloneQueryNode,\n    {\n      familyName: variables.familyName,\n      styleName: variables.styleName,\n      selectable: variables.selectable ?? true,\n    },\n    options,\n  );\n}\n\ntype RendererProps = React.ComponentProps<typeof TypeTesterStandalonePreloadedQueryRenderer>;\n\n// Self-wraps with FontdueProvider so consumers don't need to. The provider\n// state is a module-level singleton under the hood, so multiple\n// TypeTesterPreloaded (or other *Preloaded) components on a page all share\n// one Relay env + Redux store + auxiliary UI.\nexport function TypeTesterPreloaded(props: RendererProps) {\n  return (\n    <FontdueProvider>\n      <TypeTesterStandalonePreloadedQueryRenderer {...props} />\n    </FontdueProvider>\n  );\n}\n"],"names":["loadSerializableQuery","query","variables","options","Error","fetcher","createNetworkFetch","response","params","loadTypeTesterQuery","TypeTesterStandaloneQueryNode","familyName","styleName","selectable","TypeTesterPreloaded","props","React","createElement","FontdueProvider","TypeTesterStandalonePreloadedQueryRenderer"],"mappings":";;;;;;;AAeA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;;AAUA;AACA;AACA;AACe,eAAeA,qBAAqBA,CACjDC,KAAwB,EACxBC,SAAkD,EAClDC,OAAsC,EACO;EAC7C,IAAI,EAAE,QAAQ,IAAIF,KAAK,CAAC,EACtB,MAAM,IAAIG,KAAK,CAAC,iEAAiE,CAAC;AACpF,EAAA,MAAMC,OAAO,GAAGC,kBAAkB,CAACH,OAAO,CAAC;EAC3C,MAAMI,QAAQ,GAAG,MAAMF,OAAO,CAACJ,KAAK,CAACO,MAAM,EAAEN,SAAS,CAAC;EAEvD,OAAO;IACLM,MAAM,EAAEP,KAAK,CAACO,MAAM;IACpBN,SAAS;AACTK,IAAAA;GACD;AACH;;AC1DO,eAAeE,mBAAmBA,CACvCP,SAAuC,EACvCC,OAAsC,EACH;EACnC,OAAOH,qBAAqB,CAC1BU,IAA6B,EAC7B;IACEC,UAAU,EAAET,SAAS,CAACS,UAAU;IAChCC,SAAS,EAAEV,SAAS,CAACU,SAAS;AAC9BC,IAAAA,UAAU,EAAEX,SAAS,CAACW,UAAU,IAAI;GACrC,EACDV,OACF,CAAC;AACH;AAIA;AACA;AACA;AACA;AACO,SAASW,mBAAmBA,CAACC,KAAoB,EAAE;AACxD,EAAA,oBACEC,cAAA,CAAAC,aAAA,CAACC,eAAe,EAAA,IAAA,eACdF,cAAA,CAAAC,aAAA,CAACE,0CAA0C,EAAKJ,KAAQ,CACzC,CAAC;AAEtB;;;;"}