@decocms/tanstack 8.0.0 → 8.4.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (150) hide show
  1. package/README.md +79 -0
  2. package/dist/draft.d.ts +33 -0
  3. package/dist/draft.d.ts.map +1 -0
  4. package/dist/draft.js +41 -0
  5. package/dist/draft.js.map +1 -0
  6. package/dist/index.d.ts +9 -0
  7. package/dist/index.d.ts.map +1 -0
  8. package/dist/index.js +9 -0
  9. package/dist/index.js.map +1 -0
  10. package/dist/react/DecoDocument.d.ts +61 -0
  11. package/dist/react/DecoDocument.d.ts.map +1 -0
  12. package/dist/react/DecoDocument.js +96 -0
  13. package/dist/react/DecoDocument.js.map +1 -0
  14. package/dist/react/Image.d.ts +96 -0
  15. package/dist/react/Image.d.ts.map +1 -0
  16. package/dist/react/Image.js +79 -0
  17. package/dist/react/Image.js.map +1 -0
  18. package/dist/react/index.d.ts +7 -0
  19. package/dist/react/index.d.ts.map +1 -0
  20. package/dist/react/index.js +7 -0
  21. package/dist/react/index.js.map +1 -0
  22. package/dist/react/pageValues.d.ts +10 -0
  23. package/dist/react/pageValues.d.ts.map +1 -0
  24. package/dist/react/pageValues.js +29 -0
  25. package/dist/react/pageValues.js.map +1 -0
  26. package/dist/react/scripts.d.ts +14 -0
  27. package/dist/react/scripts.d.ts.map +1 -0
  28. package/dist/react/scripts.js +96 -0
  29. package/dist/react/scripts.js.map +1 -0
  30. package/dist/router/index.d.ts +38 -0
  31. package/dist/router/index.d.ts.map +1 -0
  32. package/dist/router/index.js +60 -0
  33. package/dist/router/index.js.map +1 -0
  34. package/dist/scope/browser.d.ts +11 -0
  35. package/dist/scope/browser.d.ts.map +1 -0
  36. package/dist/scope/browser.js +8 -0
  37. package/dist/scope/browser.js.map +1 -0
  38. package/dist/scope/server.d.ts +13 -0
  39. package/dist/scope/server.d.ts.map +1 -0
  40. package/dist/scope/server.js +26 -0
  41. package/dist/scope/server.js.map +1 -0
  42. package/dist/server/index.d.ts +27 -0
  43. package/dist/server/index.d.ts.map +1 -0
  44. package/dist/server/index.js +31 -0
  45. package/dist/server/index.js.map +1 -0
  46. package/dist/shared.d.ts +26 -0
  47. package/dist/shared.d.ts.map +1 -0
  48. package/dist/shared.js +26 -0
  49. package/dist/shared.js.map +1 -0
  50. package/dist/start/index.d.ts +9 -0
  51. package/dist/start/index.d.ts.map +1 -0
  52. package/dist/start/index.js +33 -0
  53. package/dist/start/index.js.map +1 -0
  54. package/dist/studio.d.ts +28 -0
  55. package/dist/studio.d.ts.map +1 -0
  56. package/dist/studio.js +53 -0
  57. package/dist/studio.js.map +1 -0
  58. package/dist/vite/index.d.ts +15 -0
  59. package/dist/vite/index.d.ts.map +1 -0
  60. package/dist/vite/index.js +95 -0
  61. package/dist/vite/index.js.map +1 -0
  62. package/dist/worker/cacheProfiles.d.ts +43 -0
  63. package/dist/worker/cacheProfiles.d.ts.map +1 -0
  64. package/dist/worker/cacheProfiles.js +162 -0
  65. package/dist/worker/cacheProfiles.js.map +1 -0
  66. package/dist/worker/cookies.d.ts +20 -0
  67. package/dist/worker/cookies.d.ts.map +1 -0
  68. package/dist/worker/cookies.js +69 -0
  69. package/dist/worker/cookies.js.map +1 -0
  70. package/dist/worker/drafts.d.ts +59 -0
  71. package/dist/worker/drafts.d.ts.map +1 -0
  72. package/dist/worker/drafts.js +140 -0
  73. package/dist/worker/drafts.js.map +1 -0
  74. package/dist/worker/index.d.ts +107 -0
  75. package/dist/worker/index.d.ts.map +1 -0
  76. package/dist/worker/index.js +511 -0
  77. package/dist/worker/index.js.map +1 -0
  78. package/dist/worker/security.d.ts +14 -0
  79. package/dist/worker/security.d.ts.map +1 -0
  80. package/dist/worker/security.js +48 -0
  81. package/dist/worker/security.js.map +1 -0
  82. package/dist/worker/segment.d.ts +21 -0
  83. package/dist/worker/segment.d.ts.map +1 -0
  84. package/dist/worker/segment.js +43 -0
  85. package/dist/worker/segment.js.map +1 -0
  86. package/package.json +86 -31
  87. package/src/draft.ts +43 -0
  88. package/src/index.ts +8 -44
  89. package/src/react/DecoDocument.tsx +234 -0
  90. package/src/react/Image.tsx +213 -0
  91. package/src/react/index.ts +24 -0
  92. package/src/react/pageValues.ts +35 -0
  93. package/src/react/scripts.ts +98 -0
  94. package/src/router/index.ts +80 -0
  95. package/src/scope/browser.ts +18 -0
  96. package/src/scope/server.ts +37 -0
  97. package/src/server/index.ts +43 -0
  98. package/src/shared.ts +29 -0
  99. package/src/start/index.ts +31 -0
  100. package/src/studio.ts +52 -0
  101. package/src/vite/index.ts +105 -0
  102. package/src/worker/cacheProfiles.ts +180 -0
  103. package/src/worker/cookies.ts +65 -0
  104. package/src/worker/drafts.ts +157 -0
  105. package/src/worker/index.ts +648 -0
  106. package/src/worker/security.ts +63 -0
  107. package/src/worker/segment.ts +49 -0
  108. package/src/cms/kvBlockSource.test.ts +0 -82
  109. package/src/cms/kvBlockSource.ts +0 -68
  110. package/src/daemon/auth.ts +0 -204
  111. package/src/daemon/fs.ts +0 -238
  112. package/src/daemon/index.ts +0 -8
  113. package/src/daemon/middleware.ts +0 -156
  114. package/src/daemon/tunnel.ts +0 -129
  115. package/src/daemon/volumes.ts +0 -366
  116. package/src/daemon/watch.ts +0 -272
  117. package/src/hooks/DecoPageRenderer.tsx +0 -688
  118. package/src/hooks/DecoRootLayout.tsx +0 -111
  119. package/src/hooks/NavigationProgress.tsx +0 -21
  120. package/src/hooks/PreviewProviders.tsx +0 -26
  121. package/src/hooks/StableOutlet.tsx +0 -30
  122. package/src/hooks/index.ts +0 -9
  123. package/src/routes/adminRoutes.test.ts +0 -99
  124. package/src/routes/adminRoutes.ts +0 -153
  125. package/src/routes/cmsRoute.test.ts +0 -100
  126. package/src/routes/cmsRoute.ts +0 -944
  127. package/src/routes/components.tsx +0 -57
  128. package/src/routes/index.ts +0 -24
  129. package/src/routes/pageUrl.test.ts +0 -70
  130. package/src/routes/pageUrl.ts +0 -54
  131. package/src/routes/withSiteGlobals.test.ts +0 -206
  132. package/src/routes/withSiteGlobals.ts +0 -222
  133. package/src/sdk/cookiePassthrough.ts +0 -58
  134. package/src/sdk/createInvoke.ts +0 -77
  135. package/src/sdk/deferredSectionLoader.test.ts +0 -94
  136. package/src/sdk/deferredSectionLoader.ts +0 -46
  137. package/src/sdk/kvHydration.test.ts +0 -215
  138. package/src/sdk/kvHydration.ts +0 -193
  139. package/src/sdk/outboundHeaders.test.ts +0 -113
  140. package/src/sdk/outboundHeaders.ts +0 -81
  141. package/src/sdk/router.ts +0 -92
  142. package/src/sdk/useHydrated.ts +0 -19
  143. package/src/sdk/workerEntry.test.ts +0 -495
  144. package/src/sdk/workerEntry.ts +0 -2307
  145. package/src/setupFastDeploy.ts +0 -13
  146. package/src/vite/plugin-scaffold-gen.test.js +0 -106
  147. package/src/vite/plugin.js +0 -850
  148. package/src/vite/plugin.test.js +0 -113
  149. package/src/vite/plugin.test.ts +0 -52
  150. package/tsconfig.json +0 -7
@@ -1,688 +0,0 @@
1
- import {
2
- type ComponentType,
3
- createElement,
4
- lazy,
5
- type ReactNode,
6
- Suspense,
7
- useEffect,
8
- useRef,
9
- useState,
10
- } from "react";
11
- import { Await, ClientOnly } from "@tanstack/react-router";
12
- import type { SectionOptions } from "@decocms/blocks/cms/client";
13
- import {
14
- getResolvedComponent,
15
- getSectionOptions,
16
- getSectionRegistry,
17
- getSyncComponent,
18
- preloadSectionModule,
19
- setResolvedComponent,
20
- } from "@decocms/blocks/cms/client";
21
- // Type-only: erased at compile time, so importing from the full barrel here
22
- // doesn't drag resolve.ts's runtime code (and its node:async_hooks chain)
23
- // into this component's client bundle.
24
- import type { DeferredSection, ResolvedSection } from "@decocms/blocks/cms";
25
- import { type Device, DeviceProvider } from "@decocms/blocks/sdk/useDevice";
26
-
27
- import { SectionErrorBoundary } from "@decocms/blocks/hooks";
28
-
29
- type LazyComponent = ReturnType<typeof lazy>;
30
-
31
- const lazyCache = new Map<string, LazyComponent>();
32
-
33
- /**
34
- * Create a React.lazy-compatible thenable that is already fulfilled.
35
- * React internally checks `thenable.status === "fulfilled"` and reads
36
- * `thenable.value` synchronously — no Suspense activation, no microtask.
37
- */
38
- function syncThenable(mod: {
39
- default: ComponentType<any>;
40
- }): Promise<{ default: ComponentType<any> }> {
41
- const t = Promise.resolve(mod);
42
- // React uses these internal properties to detect sync-resolved thenables
43
- (t as any).status = "fulfilled";
44
- (t as any).value = mod;
45
- return t;
46
- }
47
-
48
- function getLazyComponent(key: string) {
49
- if (!lazyCache.has(key)) {
50
- // If sync-registered, wrap in a pre-fulfilled lazy so React.lazy
51
- // resolves synchronously — same tree structure as lazy-only path.
52
- const sync = getSyncComponent(key);
53
- if (sync) {
54
- lazyCache.set(key, lazy(() => syncThenable({ default: sync })));
55
- return lazyCache.get(key)!;
56
- }
57
-
58
- const registry = getSectionRegistry();
59
- const loader = registry[key];
60
- if (!loader) return null;
61
- lazyCache.set(
62
- key,
63
- lazy(() => {
64
- const resolved = getResolvedComponent(key);
65
- if (resolved) {
66
- return syncThenable({ default: resolved });
67
- }
68
-
69
- return (loader as () => Promise<{ default: ComponentType<any> }>)().then((mod) => {
70
- if (!mod?.default) {
71
- console.error(`[DecoSection] "${key}" has no default export`, Object.keys(mod ?? {}));
72
- return { default: () => null } as { default: ComponentType<any> };
73
- }
74
- setResolvedComponent(key, mod.default);
75
- return mod as { default: ComponentType<any> };
76
- });
77
- }),
78
- );
79
- }
80
- return lazyCache.get(key)!;
81
- }
82
-
83
- function DefaultSectionFallback() {
84
- return <div className="w-full h-48 bg-base-200 animate-pulse rounded" />;
85
- }
86
-
87
- function NestedSectionFallback() {
88
- return <div className="w-full h-24 bg-base-200 animate-pulse rounded" />;
89
- }
90
-
91
- import { isDevMode } from "@decocms/blocks/sdk/env";
92
-
93
- const isDev = isDevMode();
94
-
95
- // ---------------------------------------------------------------------------
96
- // Deferred section data cache — persists resolved section props across SPA
97
- // navigations so navigating back to a page doesn't re-fetch already-loaded
98
- // sections. TTL is aligned with cmsRouteConfig staleTime (5 min prod / 5s dev).
99
- // ---------------------------------------------------------------------------
100
-
101
- const DEFERRED_CACHE_TTL = isDev ? 5_000 : 5 * 60 * 1000;
102
-
103
- interface DeferredCacheEntry {
104
- section: ResolvedSection;
105
- ts: number;
106
- }
107
-
108
- const deferredSectionCache = new Map<string, DeferredCacheEntry>();
109
-
110
- function getCachedDeferredSection(stableKey: string): ResolvedSection | null {
111
- const entry = deferredSectionCache.get(stableKey);
112
- if (!entry) return null;
113
- if (Date.now() - entry.ts > DEFERRED_CACHE_TTL) {
114
- deferredSectionCache.delete(stableKey);
115
- return null;
116
- }
117
- return entry.section;
118
- }
119
-
120
-
121
- const DEFERRED_FADE_CSS = `@keyframes decoFadeIn{from{opacity:0}to{opacity:1}}`;
122
-
123
- function FadeInStyle() {
124
- return <style dangerouslySetInnerHTML={{ __html: DEFERRED_FADE_CSS }} />;
125
- }
126
-
127
- function DevMissingFallbackWarning({ component }: { component: string }) {
128
- if (!isDev) return null;
129
- return (
130
- <div
131
- style={{
132
- position: "relative",
133
- border: "2px dashed #e53e3e",
134
- borderRadius: 8,
135
- padding: 8,
136
- margin: "4px 0",
137
- }}
138
- >
139
- <div
140
- style={{
141
- fontSize: 11,
142
- color: "#e53e3e",
143
- fontFamily: "monospace",
144
- marginBottom: 4,
145
- }}
146
- >
147
- [AsyncRender] Missing LoadingFallback for &quot;{component}&quot;.
148
- <br />
149
- Export a LoadingFallback from your section for better UX.
150
- <br />
151
- See: https://deco.cx/docs/async-rendering
152
- </div>
153
- <DefaultSectionFallback />
154
- </div>
155
- );
156
- }
157
-
158
- // ---------------------------------------------------------------------------
159
- // Section type — same shape as deco-cx/deco (Fresh): { Component, props }
160
- // ---------------------------------------------------------------------------
161
-
162
- interface Section {
163
- Component: string | ComponentType<any>;
164
- props: Record<string, unknown>;
165
- }
166
-
167
- // ---------------------------------------------------------------------------
168
- // SectionRenderer — renders a single nested section
169
- // ---------------------------------------------------------------------------
170
-
171
- export function SectionRenderer({ section }: { section: Section | null | undefined }) {
172
- if (!section?.Component) return null;
173
-
174
- if (typeof section.Component === "function") {
175
- const Comp = section.Component;
176
- return <Comp {...(section.props ?? {})} />;
177
- }
178
-
179
- // Sync path: render directly if available — avoids React.lazy SSR streaming issue
180
- const options = getSectionOptions(section.Component);
181
- const isClientOnly = options?.clientOnly === true;
182
- const SyncComp = getSyncComponent(section.Component);
183
- if (SyncComp && !isClientOnly) {
184
- return createElement(SyncComp, section.props ?? {});
185
- }
186
-
187
- const Lazy = getLazyComponent(section.Component);
188
- if (!Lazy) {
189
- console.warn(`[SectionRenderer] No component registered for: ${section.Component}`);
190
- return null;
191
- }
192
-
193
- const fallback = options?.loadingFallback
194
- ? createElement(options.loadingFallback, section.props ?? {})
195
- : <NestedSectionFallback />;
196
-
197
- if (isClientOnly) {
198
- return (
199
- <ClientOnly fallback={fallback}>
200
- <Suspense fallback={null}>
201
- <Lazy {...(section.props ?? {})} />
202
- </Suspense>
203
- </ClientOnly>
204
- );
205
- }
206
-
207
- return (
208
- <Suspense fallback={fallback}>
209
- <Lazy {...(section.props ?? {})} />
210
- </Suspense>
211
- );
212
- }
213
-
214
- // ---------------------------------------------------------------------------
215
- // SectionList — renders an array of nested sections
216
- // ---------------------------------------------------------------------------
217
-
218
- export function SectionList({ sections }: { sections: Section[] | null | undefined }) {
219
- if (!sections?.length) return null;
220
- return (
221
- <>
222
- {sections.map((section, i) => {
223
- const key = typeof section.Component === "string" ? section.Component : `nested-${i}`;
224
- return <SectionRenderer key={key} section={section} />;
225
- })}
226
- </>
227
- );
228
- }
229
-
230
- // ---------------------------------------------------------------------------
231
- // DeferredSectionWrapper — loads a section when it scrolls into view
232
- // ---------------------------------------------------------------------------
233
-
234
- interface DeferredSectionWrapperProps {
235
- deferred: DeferredSection;
236
- pagePath: string;
237
- pageUrl?: string;
238
- loadingFallback?: ReactNode;
239
- errorFallback?: ReactNode;
240
- loadFn: (data: {
241
- component: string;
242
- rawProps?: Record<string, unknown>;
243
- pagePath: string;
244
- pageUrl?: string;
245
- index?: number;
246
- }) => Promise<ResolvedSection | null>;
247
- }
248
-
249
- function DeferredSectionWrapper({
250
- deferred,
251
- pagePath,
252
- pageUrl,
253
- loadingFallback,
254
- errorFallback,
255
- loadFn,
256
- }: DeferredSectionWrapperProps) {
257
- const stableKey = `${pagePath}::${deferred.component}::${deferred.index}::${deferred.propsHash ?? ""}`;
258
- const [section, setSection] = useState<ResolvedSection | null>(() =>
259
- typeof document === "undefined" ? null : getCachedDeferredSection(stableKey),
260
- );
261
- const [error, setError] = useState<Error | null>(null);
262
- const [loadedOptions, setLoadedOptions] = useState<SectionOptions | undefined>(() =>
263
- getSectionOptions(deferred.component),
264
- );
265
- const isSSR = typeof document === "undefined";
266
- // Allow SSR to render the loadingFallback when registered sync via
267
- // registerSection(). Previous `isSSR ? false` always returned null,
268
- // hiding the skeleton from the HTML stream.
269
- const [optionsReady, setOptionsReady] = useState(() =>
270
- !!getSectionOptions(deferred.component),
271
- );
272
- const ref = useRef<HTMLDivElement>(null);
273
- const triggered = useRef(false);
274
- const prevKeyRef = useRef(stableKey);
275
-
276
- if (prevKeyRef.current !== stableKey) {
277
- prevKeyRef.current = stableKey;
278
- triggered.current = false;
279
- const cached = getCachedDeferredSection(stableKey);
280
- if (section !== cached) setSection(cached);
281
- if (error) setError(null);
282
- }
283
-
284
- useEffect(() => {
285
- if (optionsReady) return;
286
- preloadSectionModule(deferred.component).then((opts) => {
287
- if (opts) setLoadedOptions(opts);
288
- setOptionsReady(true);
289
- });
290
- }, [deferred.component, optionsReady]);
291
-
292
- const hasCustomFallback = !!loadedOptions?.loadingFallback;
293
- const skeleton = !optionsReady
294
- ? null
295
- : hasCustomFallback
296
- ? createElement(loadedOptions!.loadingFallback!, deferred.rawProps)
297
- : (loadingFallback ??
298
- (isDev ? (
299
- <DevMissingFallbackWarning component={deferred.component} />
300
- ) : (
301
- <DefaultSectionFallback />
302
- )));
303
-
304
- useEffect(() => {
305
- if (triggered.current || section) return;
306
-
307
- const el = ref.current;
308
- if (!el) return;
309
-
310
- if (typeof IntersectionObserver === "undefined") {
311
- triggered.current = true;
312
- const key0 = stableKey;
313
- loadFn({
314
- component: deferred.component,
315
- pagePath,
316
- pageUrl,
317
- index: deferred.index,
318
- })
319
- .then((result) => {
320
- if (result) deferredSectionCache.set(key0, { section: result, ts: Date.now() });
321
- setSection(result);
322
- })
323
- .catch((e) => setError(e));
324
- return;
325
- }
326
-
327
- const observer = new IntersectionObserver(
328
- ([entry]) => {
329
- if (entry?.isIntersecting && !triggered.current) {
330
- triggered.current = true;
331
- observer.disconnect();
332
- const key1 = stableKey;
333
- loadFn({
334
- component: deferred.component,
335
- pagePath,
336
- pageUrl,
337
- index: deferred.index,
338
- })
339
- .then((result) => {
340
- if (result) deferredSectionCache.set(key1, { section: result, ts: Date.now() });
341
- setSection(result);
342
- })
343
- .catch((e) => setError(e));
344
- }
345
- },
346
- { rootMargin: "300px" },
347
- );
348
-
349
- observer.observe(el);
350
- return () => observer.disconnect();
351
- }, [deferred.component, deferred.index, deferred.propsHash, pagePath, pageUrl, section, loadFn]);
352
-
353
- if (error) {
354
- const errFallback = loadedOptions?.errorFallback
355
- ? createElement(loadedOptions.errorFallback, { error })
356
- : errorFallback;
357
- return <>{errFallback ?? null}</>;
358
- }
359
-
360
- if (section) {
361
- const sectionId = section.key
362
- .replace(/\//g, "-")
363
- .replace(/\.tsx$/, "")
364
- .replace(/^site-sections-/, "");
365
-
366
- // Sync path: render directly without Suspense. React 19 SSR streaming
367
- // omits the <!--$--> markers when a Suspense boundary resolves sync,
368
- // which then triggers a hydration mismatch (minified error #418).
369
- // See also the matching bifurcation in the main render path and the
370
- // Await-resolved path elsewhere in this file.
371
- const SyncComp = getSyncComponent(section.component);
372
- if (SyncComp) {
373
- return (
374
- <section
375
- id={sectionId}
376
- data-manifest-key={section.key}
377
- style={{ animation: "decoFadeIn 0.3s ease-out" }}
378
- >
379
- <SectionErrorBoundary sectionKey={section.key} fallback={errorFallback}>
380
- {createElement(SyncComp, section.props)}
381
- </SectionErrorBoundary>
382
- </section>
383
- );
384
- }
385
-
386
- const LazyComponent = getLazyComponent(section.component);
387
- if (!LazyComponent) return null;
388
-
389
- return (
390
- <section
391
- id={sectionId}
392
- data-manifest-key={section.key}
393
- style={{ animation: "decoFadeIn 0.3s ease-out" }}
394
- >
395
- <SectionErrorBoundary sectionKey={section.key} fallback={errorFallback}>
396
- <Suspense fallback={skeleton}>
397
- <LazyComponent {...section.props} />
398
- </Suspense>
399
- </SectionErrorBoundary>
400
- </section>
401
- );
402
- }
403
-
404
- const sectionId = deferred.key
405
- .replace(/\//g, "-")
406
- .replace(/\.tsx$/, "")
407
- .replace(/^site-sections-/, "");
408
-
409
- return (
410
- <section ref={ref} id={sectionId} data-manifest-key={deferred.key} data-deferred="true">
411
- {skeleton}
412
- </section>
413
- );
414
- }
415
-
416
- // ---------------------------------------------------------------------------
417
- // DeferredSectionSkeleton — resolves the best fallback for a deferred section
418
- // ---------------------------------------------------------------------------
419
-
420
- function DeferredSectionSkeleton({
421
- deferred,
422
- fallback,
423
- }: {
424
- deferred: DeferredSection;
425
- fallback?: ReactNode;
426
- }) {
427
- const options = getSectionOptions(deferred.component);
428
- if (options?.loadingFallback) {
429
- // rawProps are no longer serialized to the client — pass empty object.
430
- // LoadingFallback components should be pure layout skeletons.
431
- return createElement(options.loadingFallback, deferred.rawProps ?? {});
432
- }
433
- if (fallback) return <>{fallback}</>;
434
- if (isDev) return <DevMissingFallbackWarning component={deferred.component} />;
435
- return <DefaultSectionFallback />;
436
- }
437
-
438
- // ---------------------------------------------------------------------------
439
- // Merge helper — combines eager and deferred sections in original order
440
- // ---------------------------------------------------------------------------
441
-
442
- type PageItem =
443
- | { type: "eager"; section: ResolvedSection; originalIndex: number }
444
- | { type: "deferred"; deferred: DeferredSection };
445
-
446
- function mergeSections(resolved: ResolvedSection[], deferred: DeferredSection[]): PageItem[] {
447
- if (!resolved?.length && !deferred?.length) return [];
448
- const safeResolved = resolved ?? [];
449
- const safeDeferred = deferred ?? [];
450
-
451
- if (!safeDeferred.length) {
452
- return safeResolved.map((s, i) => ({ type: "eager", section: s, originalIndex: i }));
453
- }
454
-
455
- // Use the `index` property stamped by resolveDecoPage to sort all
456
- // sections (eager + deferred) back into their original CMS order.
457
- const items: (PageItem & { _sort: number })[] = [];
458
-
459
- for (let i = 0; i < safeResolved.length; i++) {
460
- const s = safeResolved[i];
461
- items.push({ type: "eager", section: s, originalIndex: i, _sort: s.index ?? i });
462
- }
463
-
464
- for (const d of safeDeferred) {
465
- items.push({ type: "deferred", deferred: d, _sort: d.index } as PageItem & { _sort: number });
466
- }
467
-
468
- items.sort((a, b) => a._sort - b._sort);
469
-
470
- return items;
471
- }
472
-
473
- // ---------------------------------------------------------------------------
474
- // DecoPageRenderer — renders top-level resolved sections from a CMS page
475
- // ---------------------------------------------------------------------------
476
-
477
-
478
- interface Props {
479
- sections: ResolvedSection[];
480
- deferredSections?: DeferredSection[];
481
- /**
482
- * Unawaited promises for deferred sections, keyed by `d_<index>`.
483
- * Created by the route loader for TanStack native SSR streaming.
484
- * When provided, takes precedence over `loadDeferredSectionFn`.
485
- */
486
- deferredPromises?: Record<string, Promise<ResolvedSection | null>>;
487
- pagePath?: string;
488
- /** Original page URL (with query params) — forwarded to deferred section loaders. */
489
- pageUrl?: string;
490
- /**
491
- * Server-resolved device, serialized into the page loader data. When set, it
492
- * seeds `DeviceProvider` so client hydration reads the exact value the server
493
- * used — making `useDevice()` hydration-stable. Omit to fall back to runtime
494
- * resolution (backward compatible).
495
- */
496
- device?: Device;
497
- loadingFallback?: ReactNode;
498
- errorFallback?: ReactNode;
499
- /** @deprecated Use deferredPromises instead (TanStack native streaming). */
500
- loadDeferredSectionFn?: (data: {
501
- component: string;
502
- rawProps?: Record<string, unknown>;
503
- pagePath: string;
504
- pageUrl?: string;
505
- index?: number;
506
- }) => Promise<ResolvedSection | null>;
507
- }
508
-
509
- export function DecoPageRenderer({
510
- sections,
511
- deferredSections,
512
- deferredPromises,
513
- pagePath = "/",
514
- pageUrl,
515
- device,
516
- loadingFallback,
517
- errorFallback,
518
- loadDeferredSectionFn,
519
- }: Props) {
520
- const items = mergeSections(sections ?? [], deferredSections ?? []);
521
- const hasDeferred = deferredSections && deferredSections.length > 0;
522
-
523
- // Seed DeviceProvider with the server-resolved `device` from the page loader
524
- // (serialized into the hydration payload). Both the SSR render and client
525
- // hydration then read the SAME value, instead of the client re-resolving via
526
- // navigator.userAgent and descendants re-reading AsyncLocalStorage — which is
527
- // lost across streaming-SSR Suspense boundaries and silently falls back to
528
- // "desktop", causing React #418 hydration mismatches (#278, #231). When
529
- // `device` is absent (custom roots), DeviceProvider falls back to runtime
530
- // resolution.
531
- return (
532
- <DeviceProvider value={device}>
533
- {hasDeferred && <FadeInStyle />}
534
- {items.map((item, index) => {
535
- if (item.type === "deferred") {
536
- const promiseKey = `d_${item.deferred.index}`;
537
- const promise = deferredPromises?.[promiseKey];
538
-
539
- // TanStack native streaming path — uses <Await> for SSR-streamed data
540
- if (promise) {
541
- const deferredSectionId = item.deferred.key
542
- .replace(/\//g, "-")
543
- .replace(/\.tsx$/, "")
544
- .replace(/^site-sections-/, "");
545
-
546
- return (
547
- <SectionErrorBoundary
548
- key={`deferred-${pagePath}-${item.deferred.key}-${item.deferred.index}`}
549
- sectionKey={item.deferred.key}
550
- fallback={errorFallback}
551
- >
552
- <Suspense fallback={
553
- <section id={deferredSectionId} data-manifest-key={item.deferred.key} data-deferred="true">
554
- <DeferredSectionSkeleton deferred={item.deferred} fallback={loadingFallback} />
555
- </section>
556
- }>
557
- <Await promise={promise}>
558
- {(resolved) => {
559
- if (!resolved) return null;
560
- const resolvedOptions = getSectionOptions(resolved.component);
561
- const isClientOnly = resolvedOptions?.clientOnly === true;
562
- const SyncComp = getSyncComponent(resolved.component);
563
- const sectionId = resolved.key
564
- .replace(/\//g, "-")
565
- .replace(/\.tsx$/, "")
566
- .replace(/^site-sections-/, "");
567
-
568
- let inner: ReactNode;
569
-
570
- if (SyncComp && !isClientOnly) {
571
- // Sync path: direct render, no lazy/Suspense.
572
- inner = createElement(SyncComp, resolved.props);
573
- } else {
574
- const LazyComponent = getLazyComponent(resolved.component);
575
- if (!LazyComponent) return null;
576
-
577
- const fallbackEl = resolvedOptions?.loadingFallback
578
- ? createElement(resolvedOptions.loadingFallback, resolved.props)
579
- : null;
580
-
581
- inner = isClientOnly ? (
582
- <ClientOnly fallback={fallbackEl}>
583
- <Suspense fallback={null}>
584
- <LazyComponent {...resolved.props} />
585
- </Suspense>
586
- </ClientOnly>
587
- ) : (
588
- <Suspense fallback={null}>
589
- <LazyComponent {...resolved.props} />
590
- </Suspense>
591
- );
592
- }
593
-
594
- return (
595
- <section
596
- id={sectionId}
597
- data-manifest-key={resolved.key}
598
- style={{ animation: "decoFadeIn 0.3s ease-out" }}
599
- >
600
- {inner}
601
- </section>
602
- );
603
- }}
604
- </Await>
605
- </Suspense>
606
- </SectionErrorBoundary>
607
- );
608
- }
609
-
610
- // Fallback: legacy POST-based IntersectionObserver path
611
- if (loadDeferredSectionFn) {
612
- return (
613
- <DeferredSectionWrapper
614
- key={`deferred-${pagePath}-${item.deferred.key}-${item.deferred.index}`}
615
- deferred={item.deferred}
616
- pagePath={pagePath}
617
- pageUrl={pageUrl}
618
- loadingFallback={loadingFallback}
619
- errorFallback={errorFallback}
620
- loadFn={loadDeferredSectionFn}
621
- />
622
- );
623
- }
624
- return null;
625
- }
626
-
627
- const { section } = item;
628
-
629
- const options = getSectionOptions(section.component);
630
- const errFallback = options?.errorFallback
631
- ? createElement(options.errorFallback, { error: new Error("") })
632
- : errorFallback;
633
-
634
- const sectionId = section.key
635
- .replace(/\//g, "-")
636
- .replace(/\.tsx$/, "")
637
- .replace(/^site-sections-/, "");
638
-
639
- const isClientOnly = options?.clientOnly === true;
640
- const SyncComponent = getSyncComponent(section.component);
641
-
642
- let content: ReactNode;
643
-
644
- if (SyncComponent && !isClientOnly) {
645
- // Sync path: render directly — no Suspense, no lazy.
646
- // React SSR streaming ignores syncThenable's pre-fulfilled status
647
- // and creates empty <template> placeholders. Direct createElement avoids this.
648
- content = createElement(SyncComponent, section.props);
649
- } else {
650
- const LazyComponent = getLazyComponent(section.component);
651
- if (!LazyComponent) return null;
652
-
653
- const fallbackEl = options?.loadingFallback
654
- ? createElement(options.loadingFallback, section.props)
655
- : null;
656
-
657
- content = isClientOnly ? (
658
- <ClientOnly fallback={fallbackEl}>
659
- <Suspense fallback={null}>
660
- <LazyComponent {...section.props} />
661
- </Suspense>
662
- </ClientOnly>
663
- ) : (
664
- <Suspense fallback={null}>
665
- <LazyComponent {...section.props} />
666
- </Suspense>
667
- );
668
- }
669
-
670
- // Dev warning: eager section not sync-registered may blank during hydration
671
- if (isDev && !isClientOnly && !getSyncComponent(section.component)) {
672
- console.warn(
673
- `[DecoPageRenderer] Eager section "${section.component}" is not in registerSectionsSync(). ` +
674
- `This may cause blank content during hydration. Add it to registerSectionsSync() in setup.ts.`,
675
- );
676
- }
677
-
678
- return (
679
- <section key={`${section.key}-${index}`} id={sectionId} data-manifest-key={section.key}>
680
- <SectionErrorBoundary sectionKey={section.key} fallback={errFallback}>
681
- {content}
682
- </SectionErrorBoundary>
683
- </section>
684
- );
685
- })}
686
- </DeviceProvider>
687
- );
688
- }