@ecopages/react 0.2.0-beta.30 → 0.2.0-beta.32

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 (57) hide show
  1. package/README.md +5 -1
  2. package/package.json +4 -4
  3. package/src/app/client-only.js +13 -17
  4. package/src/app/dynamic.js +7 -10
  5. package/src/app/dynamic.test.browser.js +27 -29
  6. package/src/bundling/bootstrap-package-paths.js +5 -6
  7. package/src/bundling/bundle.js +115 -114
  8. package/src/bundling/discover-layout-runtime-modules.js +166 -155
  9. package/src/bundling/runtime-alias-map.d.ts +4 -1
  10. package/src/bundling/runtime-alias-map.js +107 -95
  11. package/src/bundling/runtime-bundle.js +250 -274
  12. package/src/bundling/runtime-interop-plugin.js +31 -35
  13. package/src/bundling/runtime-mode.js +10 -5
  14. package/src/bundling/runtime-modules.js +46 -35
  15. package/src/client-graph/ast-transform.js +415 -305
  16. package/src/client-graph/boundary-cache.js +146 -104
  17. package/src/client-graph/boundary-plugin.js +122 -104
  18. package/src/client-graph/component-config-traversal.js +70 -49
  19. package/src/client-graph/declared-modules.js +63 -41
  20. package/src/client-graph/reachability-analyzer.js +506 -313
  21. package/src/client-graph/specifier-classification.js +209 -141
  22. package/src/contracts/router-adapter.js +6 -0
  23. package/src/dev-transform/react-dev-transform-contributor.d.ts +17 -0
  24. package/src/dev-transform/react-dev-transform-contributor.js +22 -0
  25. package/src/hmr/hmr-scripts.js +22 -9
  26. package/src/hmr/hmr-strategy.d.ts +12 -181
  27. package/src/hmr/hmr-strategy.js +321 -650
  28. package/src/hmr/page-metadata-cache.js +43 -40
  29. package/src/hmr/react-hmr-dev-transform-plugins.d.ts +23 -0
  30. package/src/hmr/react-hmr-dev-transform-plugins.js +20 -0
  31. package/src/hydration/assert-no-bare-ecopages-imports.js +6 -6
  32. package/src/hydration/bootstrap-imports.js +30 -20
  33. package/src/hydration/hydration-asset.js +216 -213
  34. package/src/hydration/hydration-scripts.d.ts +4 -0
  35. package/src/hydration/hydration-scripts.js +199 -66
  36. package/src/hydration/hydration-scripts.test.browser.js +163 -168
  37. package/src/hydration/page-data-manifest.js +89 -45
  38. package/src/hydration/page-data-reader.js +45 -32
  39. package/src/hydration/page-payload.js +101 -99
  40. package/src/hydration/serialize-page-data-script.js +27 -28
  41. package/src/mdx/mdx-config-dependency.js +108 -112
  42. package/src/mdx/mdx-loader-plugin.js +7 -10
  43. package/src/page/page-module.js +72 -66
  44. package/src/plugin/react.constants.js +1 -4
  45. package/src/plugin/react.plugin.d.ts +1 -0
  46. package/src/plugin/react.plugin.js +227 -216
  47. package/src/plugin/react.types.js +1 -0
  48. package/src/render/component-ownership.js +42 -18
  49. package/src/render/component-ssr.js +168 -190
  50. package/src/render/eco-embed.js +8 -10
  51. package/src/render/errors.js +21 -16
  52. package/src/render/html-boundary.js +55 -51
  53. package/src/render/layout-compose.js +122 -94
  54. package/src/render/react-renderer.js +433 -468
  55. package/src/render/react-runtime.js +25 -20
  56. package/src/render/unified-layout-composition.js +74 -85
  57. package/src/runtime/use-sync-external-store-with-selector.js +52 -54
@@ -1,106 +1,134 @@
1
- import * as bundledReact from "react";
1
+ import * as bundledReact from 'react';
2
2
  function resolveReact(options) {
3
- return options?.react ?? bundledReact;
3
+ return options?.react ?? bundledReact;
4
4
  }
5
+ /**
6
+ * @remarks
7
+ * Eco components are wider than React's `createElement` input; runtime checks narrow callables.
8
+ */
5
9
  function toReactComponent(component) {
6
- if (typeof component !== "function") {
7
- throw new TypeError("[ecopages] Expected a function component for layout composition.");
8
- }
9
- return component;
10
+ if (typeof component !== 'function') {
11
+ throw new TypeError('[ecopages] Expected a function component for layout composition.');
12
+ }
13
+ return component;
10
14
  }
11
- function resolveLayoutContext(pageProps) {
12
- const context = {};
13
- if (pageProps.params !== void 0) {
14
- context.params = pageProps.params;
15
- }
16
- if (pageProps.query !== void 0) {
17
- context.query = pageProps.query;
18
- }
19
- if (pageProps.locals !== void 0) {
20
- context.locals = pageProps.locals;
21
- }
22
- return context;
15
+ /**
16
+ * Reads request-scoped layout context from serialized page props.
17
+ */
18
+ export function resolveLayoutContext(pageProps) {
19
+ const context = {};
20
+ if (pageProps.params !== undefined) {
21
+ context.params = pageProps.params;
22
+ }
23
+ if (pageProps.query !== undefined) {
24
+ context.query = pageProps.query;
25
+ }
26
+ if (pageProps.locals !== undefined) {
27
+ context.locals = pageProps.locals;
28
+ }
29
+ return context;
30
+ }
31
+ /**
32
+ * Builds layout prop factory context from document-shell layout entries.
33
+ *
34
+ * @remarks
35
+ * Route-scoped `locals` come from shell layout props, not `pageProps.locals` (pageLocals).
36
+ */
37
+ export function resolveLayoutContextFromShell(pageProps, shellLayouts) {
38
+ const context = {};
39
+ if (pageProps.params !== undefined) {
40
+ context.params = pageProps.params;
41
+ }
42
+ if (pageProps.query !== undefined) {
43
+ context.query = pageProps.query;
44
+ }
45
+ for (const entry of shellLayouts) {
46
+ if (entry.props !== undefined && Object.prototype.hasOwnProperty.call(entry.props, 'locals')) {
47
+ context.locals = entry.props.locals;
48
+ break;
49
+ }
50
+ }
51
+ return context;
23
52
  }
24
- function resolveLayoutContextFromShell(pageProps, shellLayouts) {
25
- const context = {};
26
- if (pageProps.params !== void 0) {
27
- context.params = pageProps.params;
28
- }
29
- if (pageProps.query !== void 0) {
30
- context.query = pageProps.query;
31
- }
32
- for (const entry of shellLayouts) {
33
- if (entry.props !== void 0 && Object.prototype.hasOwnProperty.call(entry.props, "locals")) {
34
- context.locals = entry.props.locals;
35
- break;
53
+ /**
54
+ * Resolves props for one layout entry, merging shell locals with an optional factory.
55
+ */
56
+ export function resolveLayoutEntryProps(entry, context) {
57
+ const shellProps = context.locals ? { locals: context.locals } : {};
58
+ if (!entry.props) {
59
+ return shellProps;
36
60
  }
37
- }
38
- return context;
61
+ return {
62
+ ...shellProps,
63
+ ...entry.props(context),
64
+ };
39
65
  }
40
- function resolveLayoutEntryProps(entry, context) {
41
- const shellProps = context.locals ? { locals: context.locals } : {};
42
- if (!entry.props) {
43
- return shellProps;
44
- }
45
- return {
46
- ...shellProps,
47
- ...entry.props(context)
48
- };
66
+ /**
67
+ * @remarks
68
+ * Eco page components are wider than React layout composition input; runtime checks narrow callables.
69
+ */
70
+ export function assertComposablePage(Page) {
71
+ if (typeof Page !== 'function') {
72
+ throw new TypeError('[ecopages] Expected a function page component for layout composition.');
73
+ }
74
+ return Page;
49
75
  }
50
- function assertComposablePage(Page) {
51
- if (typeof Page !== "function") {
52
- throw new TypeError("[ecopages] Expected a function page component for layout composition.");
53
- }
54
- return Page;
76
+ /**
77
+ * Builds the client or SSR React tree for a page and its outer→inner layout stack.
78
+ *
79
+ * @remarks
80
+ * Layout prop factories receive `LayoutPropsContext`. For SSR, pass `options.react` from the
81
+ * app-resolved runtime. Client code can omit it and use the bundled React import.
82
+ */
83
+ export function composeLayoutPageTree(Page, pageProps, options) {
84
+ const { createElement } = resolveReact(options);
85
+ const context = options?.context ?? resolveLayoutContext(pageProps);
86
+ const pageElement = createElement(Page, pageProps);
87
+ const layoutEntries = Page.config?.layoutEntries;
88
+ const resolvePersistedTier = options?.resolvePersistedTier;
89
+ if (layoutEntries && layoutEntries.length > 0) {
90
+ return [...layoutEntries].reverse().reduce((children, entry, reverseIndex) => {
91
+ const index = layoutEntries.length - 1 - reverseIndex;
92
+ const layoutProps = resolveLayoutEntryProps(entry, context);
93
+ const tier = resolvePersistedTier?.(entry.component, index);
94
+ const Layout = toReactComponent(tier?.layout ?? entry.component);
95
+ const elementProps = tier?.key ? { key: tier.key, ...layoutProps } : layoutProps;
96
+ return createElement(Layout, elementProps, children);
97
+ }, pageElement);
98
+ }
99
+ const layouts = Page.config?.layouts;
100
+ if (layouts && layouts.length > 0) {
101
+ const layoutProps = context.locals ? { locals: context.locals } : {};
102
+ return [...layouts].reverse().reduce((children, Layout, reverseIndex) => {
103
+ const index = layouts.length - 1 - reverseIndex;
104
+ const tier = resolvePersistedTier?.(Layout, index);
105
+ const ResolvedLayout = toReactComponent(tier?.layout ?? Layout);
106
+ const elementProps = tier?.key ? { key: tier.key, ...layoutProps } : layoutProps;
107
+ return createElement(ResolvedLayout, elementProps, children);
108
+ }, pageElement);
109
+ }
110
+ return pageElement;
55
111
  }
56
- function composeLayoutPageTree(Page, pageProps, options) {
57
- const { createElement } = resolveReact(options);
58
- const context = options?.context ?? resolveLayoutContext(pageProps);
59
- const pageElement = createElement(Page, pageProps);
60
- const layoutEntries = Page.config?.layoutEntries;
61
- const resolvePersistedTier = options?.resolvePersistedTier;
62
- if (layoutEntries && layoutEntries.length > 0) {
63
- return [...layoutEntries].reverse().reduce((children, entry, reverseIndex) => {
64
- const index = layoutEntries.length - 1 - reverseIndex;
65
- const layoutProps = resolveLayoutEntryProps(entry, context);
66
- const tier = resolvePersistedTier?.(entry.component, index);
67
- const Layout = toReactComponent(tier?.layout ?? entry.component);
68
- const elementProps = tier?.key ? { key: tier.key, ...layoutProps } : layoutProps;
69
- return createElement(Layout, elementProps, children);
70
- }, pageElement);
71
- }
72
- const layouts = Page.config?.layouts;
73
- if (layouts && layouts.length > 0) {
74
- const layoutProps = context.locals ? { locals: context.locals } : {};
75
- return [...layouts].reverse().reduce((children, Layout, reverseIndex) => {
76
- const index = layouts.length - 1 - reverseIndex;
77
- const tier = resolvePersistedTier?.(Layout, index);
78
- const ResolvedLayout = toReactComponent(tier?.layout ?? Layout);
79
- const elementProps = tier?.key ? { key: tier.key, ...layoutProps } : layoutProps;
80
- return createElement(ResolvedLayout, elementProps, children);
112
+ /**
113
+ * Builds a layout tree from explicit document-shell layout entries.
114
+ *
115
+ * @remarks
116
+ * Use when the route renderer passes per-tier props (e.g. route `locals` on the layout tier).
117
+ * Shell `entry.props` are authoritative; page config normalization is not required.
118
+ */
119
+ export function composeLayoutPageTreeFromShell(Page, pageProps, shellLayouts, options) {
120
+ const { createElement } = resolveReact(options);
121
+ if (shellLayouts.length === 0) {
122
+ return composeLayoutPageTree(Page, pageProps, options);
123
+ }
124
+ const pageElement = createElement(Page, pageProps);
125
+ return [...shellLayouts].reverse().reduce((children, entry) => {
126
+ return createElement(toReactComponent(entry.component), entry.props ?? {}, children);
81
127
  }, pageElement);
82
- }
83
- return pageElement;
84
- }
85
- function composeLayoutPageTreeFromShell(Page, pageProps, shellLayouts, options) {
86
- const { createElement } = resolveReact(options);
87
- if (shellLayouts.length === 0) {
88
- return composeLayoutPageTree(Page, pageProps, options);
89
- }
90
- const pageElement = createElement(Page, pageProps);
91
- return [...shellLayouts].reverse().reduce((children, entry) => {
92
- return createElement(toReactComponent(entry.component), entry.props ?? {}, children);
93
- }, pageElement);
94
128
  }
95
- function normalizePageLayoutComponents(layouts) {
96
- return layouts && layouts.length > 0 ? layouts : [];
129
+ /**
130
+ * Normalizes page config layout metadata to an outer→inner component list.
131
+ */
132
+ export function normalizePageLayoutComponents(layouts) {
133
+ return layouts && layouts.length > 0 ? layouts : [];
97
134
  }
98
- export {
99
- assertComposablePage,
100
- composeLayoutPageTree,
101
- composeLayoutPageTreeFromShell,
102
- normalizePageLayoutComponents,
103
- resolveLayoutContext,
104
- resolveLayoutContextFromShell,
105
- resolveLayoutEntryProps
106
- };