@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,127 +1,127 @@
|
|
|
1
|
-
import { Component, ComponentChildren } from 'preact';
|
|
2
|
-
import type { LayoutErrorInfo, ErrorRecoveryStrategy } from '../types/layout.ts';
|
|
3
|
-
|
|
4
|
-
export interface LayoutErrorBoundaryProps {
|
|
5
|
-
children: ComponentChildren;
|
|
6
|
-
fallback?: (error: Error, retry: () => void) => ComponentChildren;
|
|
7
|
-
onError?: (error: Error, errorInfo: LayoutErrorInfo) => void;
|
|
8
|
-
recoveryStrategy?: ErrorRecoveryStrategy;
|
|
9
|
-
layoutPath?: string;
|
|
10
|
-
errorType?: 'component' | 'loader' | 'rendering' | 'island';
|
|
11
|
-
}
|
|
12
|
-
|
|
13
|
-
export interface LayoutErrorBoundaryState {
|
|
14
|
-
hasError: boolean;
|
|
15
|
-
error: Error | null;
|
|
16
|
-
errorInfo: LayoutErrorInfo | null;
|
|
17
|
-
retryCount: number;
|
|
18
|
-
}
|
|
19
|
-
|
|
20
|
-
export class LayoutErrorBoundary extends Component<LayoutErrorBoundaryProps, LayoutErrorBoundaryState> {
|
|
21
|
-
private maxRetries = 3;
|
|
22
|
-
|
|
23
|
-
constructor(props: LayoutErrorBoundaryProps) {
|
|
24
|
-
super(props);
|
|
25
|
-
this.state = {
|
|
26
|
-
hasError: false,
|
|
27
|
-
error: null,
|
|
28
|
-
errorInfo: null,
|
|
29
|
-
retryCount: 0,
|
|
30
|
-
};
|
|
31
|
-
}
|
|
32
|
-
|
|
33
|
-
static override getDerivedStateFromError(error: Error): Partial<LayoutErrorBoundaryState> {
|
|
34
|
-
return {
|
|
35
|
-
hasError: true,
|
|
36
|
-
error,
|
|
37
|
-
};
|
|
38
|
-
}
|
|
39
|
-
|
|
40
|
-
override componentDidCatch(error: Error, errorInfo: any): void {
|
|
41
|
-
const layoutErrorInfo: LayoutErrorInfo = {
|
|
42
|
-
layoutPath: this.props.layoutPath || 'unknown',
|
|
43
|
-
errorType: this.props.errorType || 'component',
|
|
44
|
-
timestamp: Date.now(),
|
|
45
|
-
componentStack: errorInfo.componentStack,
|
|
46
|
-
errorBoundary: this.constructor.name,
|
|
47
|
-
};
|
|
48
|
-
|
|
49
|
-
this.setState({
|
|
50
|
-
errorInfo: layoutErrorInfo,
|
|
51
|
-
});
|
|
52
|
-
|
|
53
|
-
// Call onError callback if provided
|
|
54
|
-
if (this.props.onError) {
|
|
55
|
-
this.props.onError(error, layoutErrorInfo);
|
|
56
|
-
}
|
|
57
|
-
|
|
58
|
-
// Log error in development mode
|
|
59
|
-
if (typeof Deno !== 'undefined' && Deno.env.get('NODE_ENV') === 'development') {
|
|
60
|
-
console.error('Layout Error Boundary caught an error:', error);
|
|
61
|
-
console.error('Error Info:', layoutErrorInfo);
|
|
62
|
-
console.error('Component Stack:', errorInfo.componentStack);
|
|
63
|
-
}
|
|
64
|
-
}
|
|
65
|
-
|
|
66
|
-
private handleRetry = (): void => {
|
|
67
|
-
if (this.state.retryCount < this.maxRetries) {
|
|
68
|
-
this.setState({
|
|
69
|
-
hasError: false,
|
|
70
|
-
error: null,
|
|
71
|
-
errorInfo: null,
|
|
72
|
-
retryCount: this.state.retryCount + 1,
|
|
73
|
-
});
|
|
74
|
-
}
|
|
75
|
-
};
|
|
76
|
-
|
|
77
|
-
private renderFallback(): ComponentChildren {
|
|
78
|
-
const { error } = this.state;
|
|
79
|
-
const { fallback } = this.props;
|
|
80
|
-
|
|
81
|
-
if (fallback && error) {
|
|
82
|
-
return fallback(error, this.handleRetry);
|
|
83
|
-
}
|
|
84
|
-
|
|
85
|
-
// Default fallback UI
|
|
86
|
-
return (
|
|
87
|
-
<div class="layout-error-boundary">
|
|
88
|
-
<div class="error-container">
|
|
89
|
-
<h2>Something went wrong</h2>
|
|
90
|
-
<p>An error occurred while rendering this layout.</p>
|
|
91
|
-
{this.state.retryCount < this.maxRetries && (
|
|
92
|
-
<button onClick={this.handleRetry} class="retry-button">
|
|
93
|
-
Try Again ({this.maxRetries - this.state.retryCount} attempts left)
|
|
94
|
-
</button>
|
|
95
|
-
)}
|
|
96
|
-
{typeof Deno !== 'undefined' && Deno.env.get('NODE_ENV') === 'development' && (
|
|
97
|
-
<details class="error-details">
|
|
98
|
-
<summary>Error Details (Development)</summary>
|
|
99
|
-
<pre>{error?.stack}</pre>
|
|
100
|
-
{this.state.errorInfo && (
|
|
101
|
-
<div>
|
|
102
|
-
<p>
|
|
103
|
-
<strong>Layout Path:</strong> {this.state.errorInfo.layoutPath}
|
|
104
|
-
</p>
|
|
105
|
-
<p>
|
|
106
|
-
<strong>Error Type:</strong> {this.state.errorInfo.errorType}
|
|
107
|
-
</p>
|
|
108
|
-
<p>
|
|
109
|
-
<strong>Timestamp:</strong> {new Date(this.state.errorInfo.timestamp).toISOString()}
|
|
110
|
-
</p>
|
|
111
|
-
</div>
|
|
112
|
-
)}
|
|
113
|
-
</details>
|
|
114
|
-
)}
|
|
115
|
-
</div>
|
|
116
|
-
</div>
|
|
117
|
-
);
|
|
118
|
-
}
|
|
119
|
-
|
|
120
|
-
render() {
|
|
121
|
-
if (this.state.hasError) {
|
|
122
|
-
return this.renderFallback();
|
|
123
|
-
}
|
|
124
|
-
|
|
125
|
-
return this.props.children;
|
|
126
|
-
}
|
|
127
|
-
}
|
|
1
|
+
import { Component, ComponentChildren } from 'preact';
|
|
2
|
+
import type { LayoutErrorInfo, ErrorRecoveryStrategy } from '../types/layout.ts';
|
|
3
|
+
|
|
4
|
+
export interface LayoutErrorBoundaryProps {
|
|
5
|
+
children: ComponentChildren;
|
|
6
|
+
fallback?: (error: Error, retry: () => void) => ComponentChildren;
|
|
7
|
+
onError?: (error: Error, errorInfo: LayoutErrorInfo) => void;
|
|
8
|
+
recoveryStrategy?: ErrorRecoveryStrategy;
|
|
9
|
+
layoutPath?: string;
|
|
10
|
+
errorType?: 'component' | 'loader' | 'rendering' | 'island';
|
|
11
|
+
}
|
|
12
|
+
|
|
13
|
+
export interface LayoutErrorBoundaryState {
|
|
14
|
+
hasError: boolean;
|
|
15
|
+
error: Error | null;
|
|
16
|
+
errorInfo: LayoutErrorInfo | null;
|
|
17
|
+
retryCount: number;
|
|
18
|
+
}
|
|
19
|
+
|
|
20
|
+
export class LayoutErrorBoundary extends Component<LayoutErrorBoundaryProps, LayoutErrorBoundaryState> {
|
|
21
|
+
private maxRetries = 3;
|
|
22
|
+
|
|
23
|
+
constructor(props: LayoutErrorBoundaryProps) {
|
|
24
|
+
super(props);
|
|
25
|
+
this.state = {
|
|
26
|
+
hasError: false,
|
|
27
|
+
error: null,
|
|
28
|
+
errorInfo: null,
|
|
29
|
+
retryCount: 0,
|
|
30
|
+
};
|
|
31
|
+
}
|
|
32
|
+
|
|
33
|
+
static override getDerivedStateFromError(error: Error): Partial<LayoutErrorBoundaryState> {
|
|
34
|
+
return {
|
|
35
|
+
hasError: true,
|
|
36
|
+
error,
|
|
37
|
+
};
|
|
38
|
+
}
|
|
39
|
+
|
|
40
|
+
override componentDidCatch(error: Error, errorInfo: any): void {
|
|
41
|
+
const layoutErrorInfo: LayoutErrorInfo = {
|
|
42
|
+
layoutPath: this.props.layoutPath || 'unknown',
|
|
43
|
+
errorType: this.props.errorType || 'component',
|
|
44
|
+
timestamp: Date.now(),
|
|
45
|
+
componentStack: errorInfo.componentStack,
|
|
46
|
+
errorBoundary: this.constructor.name,
|
|
47
|
+
};
|
|
48
|
+
|
|
49
|
+
this.setState({
|
|
50
|
+
errorInfo: layoutErrorInfo,
|
|
51
|
+
});
|
|
52
|
+
|
|
53
|
+
// Call onError callback if provided
|
|
54
|
+
if (this.props.onError) {
|
|
55
|
+
this.props.onError(error, layoutErrorInfo);
|
|
56
|
+
}
|
|
57
|
+
|
|
58
|
+
// Log error in development mode
|
|
59
|
+
if (typeof Deno !== 'undefined' && Deno.env.get('NODE_ENV') === 'development') {
|
|
60
|
+
console.error('Layout Error Boundary caught an error:', error);
|
|
61
|
+
console.error('Error Info:', layoutErrorInfo);
|
|
62
|
+
console.error('Component Stack:', errorInfo.componentStack);
|
|
63
|
+
}
|
|
64
|
+
}
|
|
65
|
+
|
|
66
|
+
private handleRetry = (): void => {
|
|
67
|
+
if (this.state.retryCount < this.maxRetries) {
|
|
68
|
+
this.setState({
|
|
69
|
+
hasError: false,
|
|
70
|
+
error: null,
|
|
71
|
+
errorInfo: null,
|
|
72
|
+
retryCount: this.state.retryCount + 1,
|
|
73
|
+
});
|
|
74
|
+
}
|
|
75
|
+
};
|
|
76
|
+
|
|
77
|
+
private renderFallback(): ComponentChildren {
|
|
78
|
+
const { error } = this.state;
|
|
79
|
+
const { fallback } = this.props;
|
|
80
|
+
|
|
81
|
+
if (fallback && error) {
|
|
82
|
+
return fallback(error, this.handleRetry);
|
|
83
|
+
}
|
|
84
|
+
|
|
85
|
+
// Default fallback UI
|
|
86
|
+
return (
|
|
87
|
+
<div class="layout-error-boundary">
|
|
88
|
+
<div class="error-container">
|
|
89
|
+
<h2>Something went wrong</h2>
|
|
90
|
+
<p>An error occurred while rendering this layout.</p>
|
|
91
|
+
{this.state.retryCount < this.maxRetries && (
|
|
92
|
+
<button onClick={this.handleRetry} class="retry-button">
|
|
93
|
+
Try Again ({this.maxRetries - this.state.retryCount} attempts left)
|
|
94
|
+
</button>
|
|
95
|
+
)}
|
|
96
|
+
{typeof Deno !== 'undefined' && Deno.env.get('NODE_ENV') === 'development' && (
|
|
97
|
+
<details class="error-details">
|
|
98
|
+
<summary>Error Details (Development)</summary>
|
|
99
|
+
<pre>{error?.stack}</pre>
|
|
100
|
+
{this.state.errorInfo && (
|
|
101
|
+
<div>
|
|
102
|
+
<p>
|
|
103
|
+
<strong>Layout Path:</strong> {this.state.errorInfo.layoutPath}
|
|
104
|
+
</p>
|
|
105
|
+
<p>
|
|
106
|
+
<strong>Error Type:</strong> {this.state.errorInfo.errorType}
|
|
107
|
+
</p>
|
|
108
|
+
<p>
|
|
109
|
+
<strong>Timestamp:</strong> {new Date(this.state.errorInfo.timestamp).toISOString()}
|
|
110
|
+
</p>
|
|
111
|
+
</div>
|
|
112
|
+
)}
|
|
113
|
+
</details>
|
|
114
|
+
)}
|
|
115
|
+
</div>
|
|
116
|
+
</div>
|
|
117
|
+
);
|
|
118
|
+
}
|
|
119
|
+
|
|
120
|
+
render() {
|
|
121
|
+
if (this.state.hasError) {
|
|
122
|
+
return this.renderFallback();
|
|
123
|
+
}
|
|
124
|
+
|
|
125
|
+
return this.props.children;
|
|
126
|
+
}
|
|
127
|
+
}
|
|
@@ -1,52 +1,52 @@
|
|
|
1
|
-
/** @jsxImportSource preact */
|
|
2
|
-
import type { ComponentChildren } from 'preact';
|
|
3
|
-
import { PersistentIslandProvider } from '../core/islands/persistent-island-context.tsx';
|
|
4
|
-
import { defaultIslandPersistence, type IslandPersistence } from '../core/islands/island-persistence.ts';
|
|
5
|
-
|
|
6
|
-
interface PersistentIslandProps {
|
|
7
|
-
/** Unique ID used as the storage key for this island's state */
|
|
8
|
-
persistentId: string;
|
|
9
|
-
/** The island component(s) to wrap with persistence context */
|
|
10
|
-
children: ComponentChildren;
|
|
11
|
-
/** Custom persistence instance (defaults to sessionStorage-backed) */
|
|
12
|
-
persistence?: IslandPersistence;
|
|
13
|
-
}
|
|
14
|
-
|
|
15
|
-
/**
|
|
16
|
-
* PersistentIsland — provides automatic state persistence context to child islands.
|
|
17
|
-
*
|
|
18
|
-
* Wrap any island with this component and use `usePersistentIslandContext()` inside
|
|
19
|
-
* the island to get `saveState`, `loadState`, and `clearState` functions.
|
|
20
|
-
*
|
|
21
|
-
* Usage in a page:
|
|
22
|
-
* ```tsx
|
|
23
|
-
* <PersistentIsland persistentId="my-counter" island={{ condition: 'on:client' }}>
|
|
24
|
-
* <MyCounter />
|
|
25
|
-
* </PersistentIsland>
|
|
26
|
-
* ```
|
|
27
|
-
*
|
|
28
|
-
* Usage inside the island:
|
|
29
|
-
* ```tsx
|
|
30
|
-
* import { usePersistentIslandContext } from '@useavalon/avalon';
|
|
31
|
-
*
|
|
32
|
-
* function MyCounter() {
|
|
33
|
-
* const { saveState, loadState, clearState } = usePersistentIslandContext();
|
|
34
|
-
* // ...
|
|
35
|
-
* }
|
|
36
|
-
* ```
|
|
37
|
-
*/
|
|
38
|
-
export function PersistentIsland({
|
|
39
|
-
persistentId,
|
|
40
|
-
children,
|
|
41
|
-
persistence = defaultIslandPersistence,
|
|
42
|
-
}: Readonly<PersistentIslandProps>) {
|
|
43
|
-
return (
|
|
44
|
-
<PersistentIslandProvider persistentId={persistentId} persistence={persistence}>
|
|
45
|
-
<div data-persistent-id={persistentId}>
|
|
46
|
-
{children}
|
|
47
|
-
</div>
|
|
48
|
-
</PersistentIslandProvider>
|
|
49
|
-
);
|
|
50
|
-
}
|
|
51
|
-
|
|
52
|
-
export default PersistentIsland;
|
|
1
|
+
/** @jsxImportSource preact */
|
|
2
|
+
import type { ComponentChildren } from 'preact';
|
|
3
|
+
import { PersistentIslandProvider } from '../core/islands/persistent-island-context.tsx';
|
|
4
|
+
import { defaultIslandPersistence, type IslandPersistence } from '../core/islands/island-persistence.ts';
|
|
5
|
+
|
|
6
|
+
interface PersistentIslandProps {
|
|
7
|
+
/** Unique ID used as the storage key for this island's state */
|
|
8
|
+
persistentId: string;
|
|
9
|
+
/** The island component(s) to wrap with persistence context */
|
|
10
|
+
children: ComponentChildren;
|
|
11
|
+
/** Custom persistence instance (defaults to sessionStorage-backed) */
|
|
12
|
+
persistence?: IslandPersistence;
|
|
13
|
+
}
|
|
14
|
+
|
|
15
|
+
/**
|
|
16
|
+
* PersistentIsland — provides automatic state persistence context to child islands.
|
|
17
|
+
*
|
|
18
|
+
* Wrap any island with this component and use `usePersistentIslandContext()` inside
|
|
19
|
+
* the island to get `saveState`, `loadState`, and `clearState` functions.
|
|
20
|
+
*
|
|
21
|
+
* Usage in a page:
|
|
22
|
+
* ```tsx
|
|
23
|
+
* <PersistentIsland persistentId="my-counter" island={{ condition: 'on:client' }}>
|
|
24
|
+
* <MyCounter />
|
|
25
|
+
* </PersistentIsland>
|
|
26
|
+
* ```
|
|
27
|
+
*
|
|
28
|
+
* Usage inside the island:
|
|
29
|
+
* ```tsx
|
|
30
|
+
* import { usePersistentIslandContext } from '@useavalon/avalon';
|
|
31
|
+
*
|
|
32
|
+
* function MyCounter() {
|
|
33
|
+
* const { saveState, loadState, clearState } = usePersistentIslandContext();
|
|
34
|
+
* // ...
|
|
35
|
+
* }
|
|
36
|
+
* ```
|
|
37
|
+
*/
|
|
38
|
+
export function PersistentIsland({
|
|
39
|
+
persistentId,
|
|
40
|
+
children,
|
|
41
|
+
persistence = defaultIslandPersistence,
|
|
42
|
+
}: Readonly<PersistentIslandProps>) {
|
|
43
|
+
return (
|
|
44
|
+
<PersistentIslandProvider persistentId={persistentId} persistence={persistence}>
|
|
45
|
+
<div data-persistent-id={persistentId}>
|
|
46
|
+
{children}
|
|
47
|
+
</div>
|
|
48
|
+
</PersistentIslandProvider>
|
|
49
|
+
);
|
|
50
|
+
}
|
|
51
|
+
|
|
52
|
+
export default PersistentIsland;
|