@useavalon/avalon 0.1.11 → 0.1.13
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.
- package/README.md +54 -54
- package/mod.ts +302 -302
- package/package.json +49 -26
- package/src/build/integration-bundler-plugin.ts +116 -116
- package/src/build/integration-config.ts +168 -168
- package/src/build/integration-detection-plugin.ts +117 -117
- package/src/build/integration-resolver-plugin.ts +90 -90
- package/src/build/island-manifest.ts +269 -269
- package/src/build/island-types-generator.ts +476 -476
- package/src/build/mdx-island-transform.ts +464 -464
- package/src/build/mdx-plugin.ts +98 -98
- package/src/build/page-island-transform.ts +598 -598
- package/src/build/prop-extractors/index.ts +21 -21
- package/src/build/prop-extractors/lit.ts +140 -140
- package/src/build/prop-extractors/qwik.ts +16 -16
- package/src/build/prop-extractors/solid.ts +125 -125
- package/src/build/prop-extractors/svelte.ts +194 -194
- package/src/build/prop-extractors/vue.ts +111 -111
- package/src/build/sidecar-file-manager.ts +104 -104
- package/src/build/sidecar-renderer.ts +30 -30
- package/src/client/adapters/index.ts +21 -13
- package/src/client/components.ts +35 -35
- package/src/client/css-hmr-handler.ts +344 -344
- package/src/client/framework-adapter.ts +462 -462
- package/src/client/hmr-coordinator.ts +396 -396
- package/src/client/hmr-error-overlay.js +533 -533
- package/src/client/main.js +824 -816
- package/src/client/types/framework-runtime.d.ts +68 -68
- package/src/client/types/vite-hmr.d.ts +46 -46
- package/src/client/types/vite-virtual-modules.d.ts +70 -60
- package/src/components/Image.tsx +123 -123
- package/src/components/IslandErrorBoundary.tsx +145 -145
- package/src/components/LayoutDataErrorBoundary.tsx +141 -141
- package/src/components/LayoutErrorBoundary.tsx +127 -127
- package/src/components/PersistentIsland.tsx +52 -52
- package/src/components/StreamingErrorBoundary.tsx +233 -233
- package/src/components/StreamingLayout.tsx +538 -538
- package/src/core/components/component-analyzer.ts +192 -192
- package/src/core/components/component-detection.ts +508 -508
- package/src/core/components/enhanced-framework-detector.ts +500 -500
- package/src/core/components/framework-registry.ts +563 -563
- package/src/core/content/mdx-processor.ts +46 -46
- package/src/core/integrations/index.ts +19 -19
- package/src/core/integrations/loader.ts +125 -125
- package/src/core/integrations/registry.ts +175 -175
- package/src/core/islands/island-persistence.ts +325 -325
- package/src/core/islands/island-state-serializer.ts +258 -258
- package/src/core/islands/persistent-island-context.tsx +80 -80
- package/src/core/islands/use-persistent-state.ts +68 -68
- package/src/core/layout/enhanced-layout-resolver.ts +322 -322
- package/src/core/layout/layout-cache-manager.ts +485 -485
- package/src/core/layout/layout-composer.ts +357 -357
- package/src/core/layout/layout-data-loader.ts +516 -516
- package/src/core/layout/layout-discovery.ts +243 -243
- package/src/core/layout/layout-matcher.ts +299 -299
- package/src/core/layout/layout-types.ts +110 -110
- package/src/core/modules/framework-module-resolver.ts +273 -273
- package/src/islands/component-analysis.ts +213 -213
- package/src/islands/css-utils.ts +565 -565
- package/src/islands/discovery/index.ts +80 -80
- package/src/islands/discovery/registry.ts +340 -340
- package/src/islands/discovery/resolver.ts +477 -477
- package/src/islands/discovery/scanner.ts +386 -386
- package/src/islands/discovery/types.ts +117 -117
- package/src/islands/discovery/validator.ts +544 -544
- package/src/islands/discovery/watcher.ts +368 -368
- package/src/islands/framework-detection.ts +428 -428
- package/src/islands/integration-loader.ts +490 -490
- package/src/islands/island.tsx +565 -565
- package/src/islands/render-cache.ts +550 -550
- package/src/islands/types.ts +80 -80
- package/src/islands/universal-css-collector.ts +157 -157
- package/src/islands/universal-head-collector.ts +137 -137
- package/src/layout-system.d.ts +592 -592
- package/src/layout-system.ts +218 -218
- package/src/middleware/discovery.ts +268 -268
- package/src/middleware/executor.ts +315 -315
- package/src/middleware/index.ts +76 -76
- package/src/middleware/types.ts +99 -99
- package/src/nitro/build-config.ts +575 -575
- package/src/nitro/config.ts +483 -483
- package/src/nitro/error-handler.ts +636 -636
- package/src/nitro/index.ts +173 -173
- package/src/nitro/island-manifest.ts +584 -584
- package/src/nitro/middleware-adapter.ts +260 -260
- package/src/nitro/renderer.ts +1471 -1471
- package/src/nitro/route-discovery.ts +439 -439
- package/src/nitro/types.ts +321 -321
- package/src/render/collect-css.ts +198 -198
- package/src/render/error-pages.ts +79 -79
- package/src/render/isolated-ssr-renderer.ts +654 -654
- package/src/render/ssr.ts +1030 -1030
- package/src/schemas/api.ts +30 -30
- package/src/schemas/core.ts +64 -64
- package/src/schemas/index.ts +212 -212
- package/src/schemas/layout.ts +279 -279
- package/src/schemas/routing/index.ts +38 -38
- package/src/schemas/routing.ts +376 -376
- package/src/types/as-island.ts +20 -20
- package/src/types/image.d.ts +106 -106
- package/src/types/index.d.ts +22 -22
- package/src/types/island-jsx.d.ts +33 -33
- package/src/types/island-prop.d.ts +20 -20
- package/src/types/layout.ts +285 -285
- package/src/types/mdx.d.ts +6 -6
- package/src/types/routing.ts +555 -555
- package/src/types/types.ts +5 -5
- package/src/types/urlpattern.d.ts +49 -49
- package/src/types/vite-env.d.ts +11 -11
- package/src/utils/dev-logger.ts +299 -299
- package/src/utils/fs.ts +151 -151
- package/src/vite-plugin/auto-discover.ts +551 -551
- package/src/vite-plugin/config.ts +266 -266
- package/src/vite-plugin/errors.ts +127 -127
- package/src/vite-plugin/image-optimization.ts +156 -156
- package/src/vite-plugin/integration-activator.ts +126 -126
- package/src/vite-plugin/island-sidecar-plugin.ts +176 -176
- package/src/vite-plugin/module-discovery.ts +189 -189
- package/src/vite-plugin/nitro-integration.ts +1354 -1354
- package/src/vite-plugin/plugin.ts +403 -409
- package/src/vite-plugin/types.ts +327 -327
- package/src/vite-plugin/validation.ts +228 -228
- package/src/client/adapters/index.js +0 -12
- package/src/client/adapters/lit-adapter.js +0 -467
- package/src/client/adapters/lit-adapter.ts +0 -654
- package/src/client/adapters/preact-adapter.js +0 -223
- package/src/client/adapters/preact-adapter.ts +0 -331
- package/src/client/adapters/qwik-adapter.js +0 -259
- package/src/client/adapters/qwik-adapter.ts +0 -345
- package/src/client/adapters/react-adapter.js +0 -220
- package/src/client/adapters/react-adapter.ts +0 -353
- package/src/client/adapters/solid-adapter.js +0 -295
- package/src/client/adapters/solid-adapter.ts +0 -451
- package/src/client/adapters/svelte-adapter.js +0 -368
- package/src/client/adapters/svelte-adapter.ts +0 -524
- package/src/client/adapters/vue-adapter.js +0 -278
- package/src/client/adapters/vue-adapter.ts +0 -467
- package/src/client/components.js +0 -23
- package/src/client/css-hmr-handler.js +0 -263
- package/src/client/framework-adapter.js +0 -283
- package/src/client/hmr-coordinator.js +0 -274
|
@@ -1,145 +1,145 @@
|
|
|
1
|
-
import { Component, ComponentChildren, ComponentType } from 'preact';
|
|
2
|
-
import type { LayoutErrorInfo } from '../types/layout.ts';
|
|
3
|
-
|
|
4
|
-
export interface IslandErrorBoundaryProps {
|
|
5
|
-
children: ComponentChildren;
|
|
6
|
-
islandId: string;
|
|
7
|
-
onError?: (error: Error, errorInfo: LayoutErrorInfo) => void;
|
|
8
|
-
fallback?: (error: Error, islandId: string) => ComponentChildren;
|
|
9
|
-
isolateError?: boolean;
|
|
10
|
-
}
|
|
11
|
-
|
|
12
|
-
export interface IslandErrorBoundaryState {
|
|
13
|
-
hasError: boolean;
|
|
14
|
-
error: Error | null;
|
|
15
|
-
errorInfo: LayoutErrorInfo | null;
|
|
16
|
-
}
|
|
17
|
-
|
|
18
|
-
/**
|
|
19
|
-
* Specialized error boundary for island components
|
|
20
|
-
* Provides error isolation to prevent island errors from affecting the main layout
|
|
21
|
-
*/
|
|
22
|
-
export class IslandErrorBoundary extends Component<IslandErrorBoundaryProps, IslandErrorBoundaryState> {
|
|
23
|
-
constructor(props: IslandErrorBoundaryProps) {
|
|
24
|
-
super(props);
|
|
25
|
-
this.state = { hasError: false, error: null, errorInfo: null };
|
|
26
|
-
}
|
|
27
|
-
|
|
28
|
-
static override getDerivedStateFromError(error: Error): Partial<IslandErrorBoundaryState> {
|
|
29
|
-
return { hasError: true, error };
|
|
30
|
-
}
|
|
31
|
-
|
|
32
|
-
override componentDidCatch(error: Error, errorInfo: { componentStack?: string }): void {
|
|
33
|
-
const layoutErrorInfo: LayoutErrorInfo = {
|
|
34
|
-
layoutPath: `island:${this.props.islandId}`,
|
|
35
|
-
errorType: 'island',
|
|
36
|
-
timestamp: Date.now(),
|
|
37
|
-
componentStack: errorInfo.componentStack,
|
|
38
|
-
errorBoundary: 'IslandErrorBoundary',
|
|
39
|
-
};
|
|
40
|
-
|
|
41
|
-
this.setState({ errorInfo: layoutErrorInfo });
|
|
42
|
-
|
|
43
|
-
if (this.props.onError) {
|
|
44
|
-
this.props.onError(error, layoutErrorInfo);
|
|
45
|
-
}
|
|
46
|
-
|
|
47
|
-
const isDevelopment = typeof Deno !== 'undefined' && Deno.env.get('NODE_ENV') === 'development';
|
|
48
|
-
if (isDevelopment) {
|
|
49
|
-
console.error(`Island Error [${this.props.islandId}]:`, error);
|
|
50
|
-
}
|
|
51
|
-
|
|
52
|
-
if (!this.props.isolateError) {
|
|
53
|
-
throw error;
|
|
54
|
-
}
|
|
55
|
-
}
|
|
56
|
-
|
|
57
|
-
private handleRemoveIsland = (): void => {
|
|
58
|
-
const islandElement = document.querySelector(`[data-island-id="${this.props.islandId}"]`);
|
|
59
|
-
if (islandElement) {
|
|
60
|
-
islandElement.remove();
|
|
61
|
-
}
|
|
62
|
-
};
|
|
63
|
-
|
|
64
|
-
private handleReloadIsland = (): void => {
|
|
65
|
-
this.setState({ hasError: false, error: null, errorInfo: null });
|
|
66
|
-
};
|
|
67
|
-
|
|
68
|
-
private renderFallback(): ComponentChildren {
|
|
69
|
-
const { error } = this.state;
|
|
70
|
-
const { fallback, islandId } = this.props;
|
|
71
|
-
|
|
72
|
-
if (fallback && error) {
|
|
73
|
-
return fallback(error, islandId);
|
|
74
|
-
}
|
|
75
|
-
|
|
76
|
-
const isDevelopment = typeof Deno !== 'undefined' && Deno.env.get('NODE_ENV') === 'development';
|
|
77
|
-
|
|
78
|
-
return (
|
|
79
|
-
<div class="island-error-boundary" data-island-error={islandId}>
|
|
80
|
-
<div class="island-error-container">
|
|
81
|
-
<div class="island-error-header">
|
|
82
|
-
<span class="island-error-icon">⚠️</span>
|
|
83
|
-
<span class="island-error-title">Island Error</span>
|
|
84
|
-
</div>
|
|
85
|
-
|
|
86
|
-
<p class="island-error-message">
|
|
87
|
-
An error occurred in island "{islandId}". The rest of the page should work normally.
|
|
88
|
-
</p>
|
|
89
|
-
|
|
90
|
-
<div class="island-error-actions">
|
|
91
|
-
<button onClick={this.handleReloadIsland} class="island-reload-button">
|
|
92
|
-
Reload Island
|
|
93
|
-
</button>
|
|
94
|
-
<button onClick={this.handleRemoveIsland} class="island-remove-button">
|
|
95
|
-
Remove Island
|
|
96
|
-
</button>
|
|
97
|
-
</div>
|
|
98
|
-
|
|
99
|
-
{isDevelopment && error && (
|
|
100
|
-
<details class="island-error-details">
|
|
101
|
-
<summary>Error Details (Development)</summary>
|
|
102
|
-
<div class="island-error-info">
|
|
103
|
-
<p><strong>Island ID:</strong> {islandId}</p>
|
|
104
|
-
<p><strong>Error:</strong> {error.message}</p>
|
|
105
|
-
</div>
|
|
106
|
-
<pre class="island-error-stack">{error.stack}</pre>
|
|
107
|
-
</details>
|
|
108
|
-
)}
|
|
109
|
-
</div>
|
|
110
|
-
</div>
|
|
111
|
-
);
|
|
112
|
-
}
|
|
113
|
-
|
|
114
|
-
render() {
|
|
115
|
-
if (this.state.hasError) {
|
|
116
|
-
return this.renderFallback();
|
|
117
|
-
}
|
|
118
|
-
return this.props.children;
|
|
119
|
-
}
|
|
120
|
-
}
|
|
121
|
-
|
|
122
|
-
/**
|
|
123
|
-
* Higher-order component to wrap islands with error boundaries
|
|
124
|
-
*/
|
|
125
|
-
export function withIslandErrorBoundary<P extends object>(
|
|
126
|
-
WrappedComponent: ComponentType<P>,
|
|
127
|
-
islandId: string,
|
|
128
|
-
options?: {
|
|
129
|
-
fallback?: (error: Error, islandId: string) => ComponentChildren;
|
|
130
|
-
isolateError?: boolean;
|
|
131
|
-
onError?: (error: Error, errorInfo: LayoutErrorInfo) => void;
|
|
132
|
-
}
|
|
133
|
-
) {
|
|
134
|
-
return function IslandWithErrorBoundary(props: P) {
|
|
135
|
-
return (
|
|
136
|
-
<IslandErrorBoundary
|
|
137
|
-
islandId={islandId}
|
|
138
|
-
fallback={options?.fallback}
|
|
139
|
-
isolateError={options?.isolateError ?? true}
|
|
140
|
-
onError={options?.onError}>
|
|
141
|
-
<WrappedComponent {...props} />
|
|
142
|
-
</IslandErrorBoundary>
|
|
143
|
-
);
|
|
144
|
-
};
|
|
145
|
-
}
|
|
1
|
+
import { Component, ComponentChildren, ComponentType } from 'preact';
|
|
2
|
+
import type { LayoutErrorInfo } from '../types/layout.ts';
|
|
3
|
+
|
|
4
|
+
export interface IslandErrorBoundaryProps {
|
|
5
|
+
children: ComponentChildren;
|
|
6
|
+
islandId: string;
|
|
7
|
+
onError?: (error: Error, errorInfo: LayoutErrorInfo) => void;
|
|
8
|
+
fallback?: (error: Error, islandId: string) => ComponentChildren;
|
|
9
|
+
isolateError?: boolean;
|
|
10
|
+
}
|
|
11
|
+
|
|
12
|
+
export interface IslandErrorBoundaryState {
|
|
13
|
+
hasError: boolean;
|
|
14
|
+
error: Error | null;
|
|
15
|
+
errorInfo: LayoutErrorInfo | null;
|
|
16
|
+
}
|
|
17
|
+
|
|
18
|
+
/**
|
|
19
|
+
* Specialized error boundary for island components
|
|
20
|
+
* Provides error isolation to prevent island errors from affecting the main layout
|
|
21
|
+
*/
|
|
22
|
+
export class IslandErrorBoundary extends Component<IslandErrorBoundaryProps, IslandErrorBoundaryState> {
|
|
23
|
+
constructor(props: IslandErrorBoundaryProps) {
|
|
24
|
+
super(props);
|
|
25
|
+
this.state = { hasError: false, error: null, errorInfo: null };
|
|
26
|
+
}
|
|
27
|
+
|
|
28
|
+
static override getDerivedStateFromError(error: Error): Partial<IslandErrorBoundaryState> {
|
|
29
|
+
return { hasError: true, error };
|
|
30
|
+
}
|
|
31
|
+
|
|
32
|
+
override componentDidCatch(error: Error, errorInfo: { componentStack?: string }): void {
|
|
33
|
+
const layoutErrorInfo: LayoutErrorInfo = {
|
|
34
|
+
layoutPath: `island:${this.props.islandId}`,
|
|
35
|
+
errorType: 'island',
|
|
36
|
+
timestamp: Date.now(),
|
|
37
|
+
componentStack: errorInfo.componentStack,
|
|
38
|
+
errorBoundary: 'IslandErrorBoundary',
|
|
39
|
+
};
|
|
40
|
+
|
|
41
|
+
this.setState({ errorInfo: layoutErrorInfo });
|
|
42
|
+
|
|
43
|
+
if (this.props.onError) {
|
|
44
|
+
this.props.onError(error, layoutErrorInfo);
|
|
45
|
+
}
|
|
46
|
+
|
|
47
|
+
const isDevelopment = typeof Deno !== 'undefined' && Deno.env.get('NODE_ENV') === 'development';
|
|
48
|
+
if (isDevelopment) {
|
|
49
|
+
console.error(`Island Error [${this.props.islandId}]:`, error);
|
|
50
|
+
}
|
|
51
|
+
|
|
52
|
+
if (!this.props.isolateError) {
|
|
53
|
+
throw error;
|
|
54
|
+
}
|
|
55
|
+
}
|
|
56
|
+
|
|
57
|
+
private handleRemoveIsland = (): void => {
|
|
58
|
+
const islandElement = document.querySelector(`[data-island-id="${this.props.islandId}"]`);
|
|
59
|
+
if (islandElement) {
|
|
60
|
+
islandElement.remove();
|
|
61
|
+
}
|
|
62
|
+
};
|
|
63
|
+
|
|
64
|
+
private handleReloadIsland = (): void => {
|
|
65
|
+
this.setState({ hasError: false, error: null, errorInfo: null });
|
|
66
|
+
};
|
|
67
|
+
|
|
68
|
+
private renderFallback(): ComponentChildren {
|
|
69
|
+
const { error } = this.state;
|
|
70
|
+
const { fallback, islandId } = this.props;
|
|
71
|
+
|
|
72
|
+
if (fallback && error) {
|
|
73
|
+
return fallback(error, islandId);
|
|
74
|
+
}
|
|
75
|
+
|
|
76
|
+
const isDevelopment = typeof Deno !== 'undefined' && Deno.env.get('NODE_ENV') === 'development';
|
|
77
|
+
|
|
78
|
+
return (
|
|
79
|
+
<div class="island-error-boundary" data-island-error={islandId}>
|
|
80
|
+
<div class="island-error-container">
|
|
81
|
+
<div class="island-error-header">
|
|
82
|
+
<span class="island-error-icon">⚠️</span>
|
|
83
|
+
<span class="island-error-title">Island Error</span>
|
|
84
|
+
</div>
|
|
85
|
+
|
|
86
|
+
<p class="island-error-message">
|
|
87
|
+
An error occurred in island "{islandId}". The rest of the page should work normally.
|
|
88
|
+
</p>
|
|
89
|
+
|
|
90
|
+
<div class="island-error-actions">
|
|
91
|
+
<button onClick={this.handleReloadIsland} class="island-reload-button">
|
|
92
|
+
Reload Island
|
|
93
|
+
</button>
|
|
94
|
+
<button onClick={this.handleRemoveIsland} class="island-remove-button">
|
|
95
|
+
Remove Island
|
|
96
|
+
</button>
|
|
97
|
+
</div>
|
|
98
|
+
|
|
99
|
+
{isDevelopment && error && (
|
|
100
|
+
<details class="island-error-details">
|
|
101
|
+
<summary>Error Details (Development)</summary>
|
|
102
|
+
<div class="island-error-info">
|
|
103
|
+
<p><strong>Island ID:</strong> {islandId}</p>
|
|
104
|
+
<p><strong>Error:</strong> {error.message}</p>
|
|
105
|
+
</div>
|
|
106
|
+
<pre class="island-error-stack">{error.stack}</pre>
|
|
107
|
+
</details>
|
|
108
|
+
)}
|
|
109
|
+
</div>
|
|
110
|
+
</div>
|
|
111
|
+
);
|
|
112
|
+
}
|
|
113
|
+
|
|
114
|
+
render() {
|
|
115
|
+
if (this.state.hasError) {
|
|
116
|
+
return this.renderFallback();
|
|
117
|
+
}
|
|
118
|
+
return this.props.children;
|
|
119
|
+
}
|
|
120
|
+
}
|
|
121
|
+
|
|
122
|
+
/**
|
|
123
|
+
* Higher-order component to wrap islands with error boundaries
|
|
124
|
+
*/
|
|
125
|
+
export function withIslandErrorBoundary<P extends object>(
|
|
126
|
+
WrappedComponent: ComponentType<P>,
|
|
127
|
+
islandId: string,
|
|
128
|
+
options?: {
|
|
129
|
+
fallback?: (error: Error, islandId: string) => ComponentChildren;
|
|
130
|
+
isolateError?: boolean;
|
|
131
|
+
onError?: (error: Error, errorInfo: LayoutErrorInfo) => void;
|
|
132
|
+
}
|
|
133
|
+
) {
|
|
134
|
+
return function IslandWithErrorBoundary(props: P) {
|
|
135
|
+
return (
|
|
136
|
+
<IslandErrorBoundary
|
|
137
|
+
islandId={islandId}
|
|
138
|
+
fallback={options?.fallback}
|
|
139
|
+
isolateError={options?.isolateError ?? true}
|
|
140
|
+
onError={options?.onError}>
|
|
141
|
+
<WrappedComponent {...props} />
|
|
142
|
+
</IslandErrorBoundary>
|
|
143
|
+
);
|
|
144
|
+
};
|
|
145
|
+
}
|
|
@@ -1,141 +1,141 @@
|
|
|
1
|
-
import { Component, ComponentChildren } from 'preact';
|
|
2
|
-
import type { LayoutErrorInfo, LayoutContext, LayoutData } from '../types/layout.ts';
|
|
3
|
-
|
|
4
|
-
export interface LayoutDataErrorBoundaryProps {
|
|
5
|
-
children: ComponentChildren;
|
|
6
|
-
layoutPath: string;
|
|
7
|
-
context: LayoutContext;
|
|
8
|
-
onError?: (error: Error, errorInfo: LayoutErrorInfo) => void;
|
|
9
|
-
fallbackData?: LayoutData;
|
|
10
|
-
retryLoader?: () => Promise<LayoutData>;
|
|
11
|
-
}
|
|
12
|
-
|
|
13
|
-
export interface LayoutDataErrorBoundaryState {
|
|
14
|
-
hasError: boolean;
|
|
15
|
-
error: Error | null;
|
|
16
|
-
errorInfo: LayoutErrorInfo | null;
|
|
17
|
-
retryCount: number;
|
|
18
|
-
isRetrying: boolean;
|
|
19
|
-
fallbackData: LayoutData | null;
|
|
20
|
-
}
|
|
21
|
-
|
|
22
|
-
/**
|
|
23
|
-
* Specialized error boundary for layout data loading errors
|
|
24
|
-
* Provides specific handling for data loader failures with retry and fallback mechanisms
|
|
25
|
-
*/
|
|
26
|
-
export class LayoutDataErrorBoundary extends Component<LayoutDataErrorBoundaryProps, LayoutDataErrorBoundaryState> {
|
|
27
|
-
private maxRetries = 3;
|
|
28
|
-
|
|
29
|
-
constructor(props: LayoutDataErrorBoundaryProps) {
|
|
30
|
-
super(props);
|
|
31
|
-
this.state = {
|
|
32
|
-
hasError: false,
|
|
33
|
-
error: null,
|
|
34
|
-
errorInfo: null,
|
|
35
|
-
retryCount: 0,
|
|
36
|
-
isRetrying: false,
|
|
37
|
-
fallbackData: props.fallbackData || null,
|
|
38
|
-
};
|
|
39
|
-
}
|
|
40
|
-
|
|
41
|
-
static override getDerivedStateFromError(error: Error): Partial<LayoutDataErrorBoundaryState> {
|
|
42
|
-
return { hasError: true, error };
|
|
43
|
-
}
|
|
44
|
-
|
|
45
|
-
override componentDidCatch(error: Error, errorInfo: { componentStack?: string }): void {
|
|
46
|
-
const layoutErrorInfo: LayoutErrorInfo = {
|
|
47
|
-
layoutPath: this.props.layoutPath,
|
|
48
|
-
errorType: 'loader',
|
|
49
|
-
timestamp: Date.now(),
|
|
50
|
-
componentStack: errorInfo.componentStack,
|
|
51
|
-
errorBoundary: 'LayoutDataErrorBoundary',
|
|
52
|
-
};
|
|
53
|
-
|
|
54
|
-
this.setState({ errorInfo: layoutErrorInfo });
|
|
55
|
-
|
|
56
|
-
if (this.props.onError) {
|
|
57
|
-
this.props.onError(error, layoutErrorInfo);
|
|
58
|
-
}
|
|
59
|
-
}
|
|
60
|
-
|
|
61
|
-
private handleRetry = async (): Promise<void> => {
|
|
62
|
-
if (this.state.retryCount >= this.maxRetries || !this.props.retryLoader) {
|
|
63
|
-
return;
|
|
64
|
-
}
|
|
65
|
-
|
|
66
|
-
this.setState({ isRetrying: true });
|
|
67
|
-
|
|
68
|
-
try {
|
|
69
|
-
const data = await this.props.retryLoader();
|
|
70
|
-
this.setState({
|
|
71
|
-
hasError: false,
|
|
72
|
-
error: null,
|
|
73
|
-
errorInfo: null,
|
|
74
|
-
retryCount: this.state.retryCount + 1,
|
|
75
|
-
isRetrying: false,
|
|
76
|
-
fallbackData: data,
|
|
77
|
-
});
|
|
78
|
-
} catch (retryError) {
|
|
79
|
-
this.setState({
|
|
80
|
-
retryCount: this.state.retryCount + 1,
|
|
81
|
-
isRetrying: false,
|
|
82
|
-
error: retryError instanceof Error ? retryError : new Error(String(retryError)),
|
|
83
|
-
});
|
|
84
|
-
}
|
|
85
|
-
};
|
|
86
|
-
|
|
87
|
-
private handleUseFallback = (): void => {
|
|
88
|
-
if (this.state.fallbackData) {
|
|
89
|
-
this.setState({ hasError: false, error: null, errorInfo: null });
|
|
90
|
-
}
|
|
91
|
-
};
|
|
92
|
-
|
|
93
|
-
private renderErrorUI(): ComponentChildren {
|
|
94
|
-
const { error, retryCount, isRetrying, fallbackData } = this.state;
|
|
95
|
-
const canRetry = retryCount < this.maxRetries && this.props.retryLoader;
|
|
96
|
-
const hasFallback = fallbackData !== null;
|
|
97
|
-
const isDevelopment = typeof Deno !== 'undefined' && Deno.env.get('NODE_ENV') === 'development';
|
|
98
|
-
|
|
99
|
-
return (
|
|
100
|
-
<div class="layout-data-error-boundary">
|
|
101
|
-
<div class="error-container">
|
|
102
|
-
<h3>Data Loading Error</h3>
|
|
103
|
-
<p>Failed to load data for layout: {this.props.layoutPath}</p>
|
|
104
|
-
|
|
105
|
-
<div class="error-actions">
|
|
106
|
-
{canRetry && (
|
|
107
|
-
<button onClick={this.handleRetry} disabled={isRetrying} class="retry-button">
|
|
108
|
-
{isRetrying ? 'Retrying...' : `Retry (${this.maxRetries - retryCount} left)`}
|
|
109
|
-
</button>
|
|
110
|
-
)}
|
|
111
|
-
|
|
112
|
-
{hasFallback && (
|
|
113
|
-
<button onClick={this.handleUseFallback} class="fallback-button">
|
|
114
|
-
Use Cached Data
|
|
115
|
-
</button>
|
|
116
|
-
)}
|
|
117
|
-
</div>
|
|
118
|
-
|
|
119
|
-
{isDevelopment && error && (
|
|
120
|
-
<details class="error-details">
|
|
121
|
-
<summary>Error Details (Development)</summary>
|
|
122
|
-
<div class="error-info">
|
|
123
|
-
<p><strong>Error:</strong> {error.message}</p>
|
|
124
|
-
<p><strong>Layout:</strong> {this.props.layoutPath}</p>
|
|
125
|
-
<p><strong>Retry Count:</strong> {retryCount}</p>
|
|
126
|
-
</div>
|
|
127
|
-
<pre class="error-stack">{error.stack}</pre>
|
|
128
|
-
</details>
|
|
129
|
-
)}
|
|
130
|
-
</div>
|
|
131
|
-
</div>
|
|
132
|
-
);
|
|
133
|
-
}
|
|
134
|
-
|
|
135
|
-
render() {
|
|
136
|
-
if (this.state.hasError) {
|
|
137
|
-
return this.renderErrorUI();
|
|
138
|
-
}
|
|
139
|
-
return this.props.children;
|
|
140
|
-
}
|
|
141
|
-
}
|
|
1
|
+
import { Component, ComponentChildren } from 'preact';
|
|
2
|
+
import type { LayoutErrorInfo, LayoutContext, LayoutData } from '../types/layout.ts';
|
|
3
|
+
|
|
4
|
+
export interface LayoutDataErrorBoundaryProps {
|
|
5
|
+
children: ComponentChildren;
|
|
6
|
+
layoutPath: string;
|
|
7
|
+
context: LayoutContext;
|
|
8
|
+
onError?: (error: Error, errorInfo: LayoutErrorInfo) => void;
|
|
9
|
+
fallbackData?: LayoutData;
|
|
10
|
+
retryLoader?: () => Promise<LayoutData>;
|
|
11
|
+
}
|
|
12
|
+
|
|
13
|
+
export interface LayoutDataErrorBoundaryState {
|
|
14
|
+
hasError: boolean;
|
|
15
|
+
error: Error | null;
|
|
16
|
+
errorInfo: LayoutErrorInfo | null;
|
|
17
|
+
retryCount: number;
|
|
18
|
+
isRetrying: boolean;
|
|
19
|
+
fallbackData: LayoutData | null;
|
|
20
|
+
}
|
|
21
|
+
|
|
22
|
+
/**
|
|
23
|
+
* Specialized error boundary for layout data loading errors
|
|
24
|
+
* Provides specific handling for data loader failures with retry and fallback mechanisms
|
|
25
|
+
*/
|
|
26
|
+
export class LayoutDataErrorBoundary extends Component<LayoutDataErrorBoundaryProps, LayoutDataErrorBoundaryState> {
|
|
27
|
+
private maxRetries = 3;
|
|
28
|
+
|
|
29
|
+
constructor(props: LayoutDataErrorBoundaryProps) {
|
|
30
|
+
super(props);
|
|
31
|
+
this.state = {
|
|
32
|
+
hasError: false,
|
|
33
|
+
error: null,
|
|
34
|
+
errorInfo: null,
|
|
35
|
+
retryCount: 0,
|
|
36
|
+
isRetrying: false,
|
|
37
|
+
fallbackData: props.fallbackData || null,
|
|
38
|
+
};
|
|
39
|
+
}
|
|
40
|
+
|
|
41
|
+
static override getDerivedStateFromError(error: Error): Partial<LayoutDataErrorBoundaryState> {
|
|
42
|
+
return { hasError: true, error };
|
|
43
|
+
}
|
|
44
|
+
|
|
45
|
+
override componentDidCatch(error: Error, errorInfo: { componentStack?: string }): void {
|
|
46
|
+
const layoutErrorInfo: LayoutErrorInfo = {
|
|
47
|
+
layoutPath: this.props.layoutPath,
|
|
48
|
+
errorType: 'loader',
|
|
49
|
+
timestamp: Date.now(),
|
|
50
|
+
componentStack: errorInfo.componentStack,
|
|
51
|
+
errorBoundary: 'LayoutDataErrorBoundary',
|
|
52
|
+
};
|
|
53
|
+
|
|
54
|
+
this.setState({ errorInfo: layoutErrorInfo });
|
|
55
|
+
|
|
56
|
+
if (this.props.onError) {
|
|
57
|
+
this.props.onError(error, layoutErrorInfo);
|
|
58
|
+
}
|
|
59
|
+
}
|
|
60
|
+
|
|
61
|
+
private handleRetry = async (): Promise<void> => {
|
|
62
|
+
if (this.state.retryCount >= this.maxRetries || !this.props.retryLoader) {
|
|
63
|
+
return;
|
|
64
|
+
}
|
|
65
|
+
|
|
66
|
+
this.setState({ isRetrying: true });
|
|
67
|
+
|
|
68
|
+
try {
|
|
69
|
+
const data = await this.props.retryLoader();
|
|
70
|
+
this.setState({
|
|
71
|
+
hasError: false,
|
|
72
|
+
error: null,
|
|
73
|
+
errorInfo: null,
|
|
74
|
+
retryCount: this.state.retryCount + 1,
|
|
75
|
+
isRetrying: false,
|
|
76
|
+
fallbackData: data,
|
|
77
|
+
});
|
|
78
|
+
} catch (retryError) {
|
|
79
|
+
this.setState({
|
|
80
|
+
retryCount: this.state.retryCount + 1,
|
|
81
|
+
isRetrying: false,
|
|
82
|
+
error: retryError instanceof Error ? retryError : new Error(String(retryError)),
|
|
83
|
+
});
|
|
84
|
+
}
|
|
85
|
+
};
|
|
86
|
+
|
|
87
|
+
private handleUseFallback = (): void => {
|
|
88
|
+
if (this.state.fallbackData) {
|
|
89
|
+
this.setState({ hasError: false, error: null, errorInfo: null });
|
|
90
|
+
}
|
|
91
|
+
};
|
|
92
|
+
|
|
93
|
+
private renderErrorUI(): ComponentChildren {
|
|
94
|
+
const { error, retryCount, isRetrying, fallbackData } = this.state;
|
|
95
|
+
const canRetry = retryCount < this.maxRetries && this.props.retryLoader;
|
|
96
|
+
const hasFallback = fallbackData !== null;
|
|
97
|
+
const isDevelopment = typeof Deno !== 'undefined' && Deno.env.get('NODE_ENV') === 'development';
|
|
98
|
+
|
|
99
|
+
return (
|
|
100
|
+
<div class="layout-data-error-boundary">
|
|
101
|
+
<div class="error-container">
|
|
102
|
+
<h3>Data Loading Error</h3>
|
|
103
|
+
<p>Failed to load data for layout: {this.props.layoutPath}</p>
|
|
104
|
+
|
|
105
|
+
<div class="error-actions">
|
|
106
|
+
{canRetry && (
|
|
107
|
+
<button onClick={this.handleRetry} disabled={isRetrying} class="retry-button">
|
|
108
|
+
{isRetrying ? 'Retrying...' : `Retry (${this.maxRetries - retryCount} left)`}
|
|
109
|
+
</button>
|
|
110
|
+
)}
|
|
111
|
+
|
|
112
|
+
{hasFallback && (
|
|
113
|
+
<button onClick={this.handleUseFallback} class="fallback-button">
|
|
114
|
+
Use Cached Data
|
|
115
|
+
</button>
|
|
116
|
+
)}
|
|
117
|
+
</div>
|
|
118
|
+
|
|
119
|
+
{isDevelopment && error && (
|
|
120
|
+
<details class="error-details">
|
|
121
|
+
<summary>Error Details (Development)</summary>
|
|
122
|
+
<div class="error-info">
|
|
123
|
+
<p><strong>Error:</strong> {error.message}</p>
|
|
124
|
+
<p><strong>Layout:</strong> {this.props.layoutPath}</p>
|
|
125
|
+
<p><strong>Retry Count:</strong> {retryCount}</p>
|
|
126
|
+
</div>
|
|
127
|
+
<pre class="error-stack">{error.stack}</pre>
|
|
128
|
+
</details>
|
|
129
|
+
)}
|
|
130
|
+
</div>
|
|
131
|
+
</div>
|
|
132
|
+
);
|
|
133
|
+
}
|
|
134
|
+
|
|
135
|
+
render() {
|
|
136
|
+
if (this.state.hasError) {
|
|
137
|
+
return this.renderErrorUI();
|
|
138
|
+
}
|
|
139
|
+
return this.props.children;
|
|
140
|
+
}
|
|
141
|
+
}
|