@flightdev/core 0.6.7

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 (187) hide show
  1. package/LICENSE +21 -0
  2. package/README.md +541 -0
  3. package/dist/actions/index.d.ts +743 -0
  4. package/dist/actions/index.js +3 -0
  5. package/dist/actions/index.js.map +1 -0
  6. package/dist/adapters/index.d.ts +502 -0
  7. package/dist/adapters/index.js +3 -0
  8. package/dist/adapters/index.js.map +1 -0
  9. package/dist/cache/index.d.ts +191 -0
  10. package/dist/cache/index.js +3 -0
  11. package/dist/cache/index.js.map +1 -0
  12. package/dist/chunk-62HISNA3.js +354 -0
  13. package/dist/chunk-62HISNA3.js.map +1 -0
  14. package/dist/chunk-63LWTEDQ.js +341 -0
  15. package/dist/chunk-63LWTEDQ.js.map +1 -0
  16. package/dist/chunk-63SCEXD7.js +3 -0
  17. package/dist/chunk-63SCEXD7.js.map +1 -0
  18. package/dist/chunk-72MYOTUB.js +667 -0
  19. package/dist/chunk-72MYOTUB.js.map +1 -0
  20. package/dist/chunk-7CNW24MQ.js +257 -0
  21. package/dist/chunk-7CNW24MQ.js.map +1 -0
  22. package/dist/chunk-7WIEAUJT.js +300 -0
  23. package/dist/chunk-7WIEAUJT.js.map +1 -0
  24. package/dist/chunk-7ZZF4ULK.js +259 -0
  25. package/dist/chunk-7ZZF4ULK.js.map +1 -0
  26. package/dist/chunk-AE3JTS73.js +222 -0
  27. package/dist/chunk-AE3JTS73.js.map +1 -0
  28. package/dist/chunk-AP5NLUSB.js +258 -0
  29. package/dist/chunk-AP5NLUSB.js.map +1 -0
  30. package/dist/chunk-C37YQQI7.js +221 -0
  31. package/dist/chunk-C37YQQI7.js.map +1 -0
  32. package/dist/chunk-DCLVXFVH.js +225 -0
  33. package/dist/chunk-DCLVXFVH.js.map +1 -0
  34. package/dist/chunk-DZMWWDFD.js +223 -0
  35. package/dist/chunk-DZMWWDFD.js.map +1 -0
  36. package/dist/chunk-GCQZ4FHI.js +245 -0
  37. package/dist/chunk-GCQZ4FHI.js.map +1 -0
  38. package/dist/chunk-IPP44XY6.js +47 -0
  39. package/dist/chunk-IPP44XY6.js.map +1 -0
  40. package/dist/chunk-IW7FTQQX.js +267 -0
  41. package/dist/chunk-IW7FTQQX.js.map +1 -0
  42. package/dist/chunk-JX4YSCBH.js +428 -0
  43. package/dist/chunk-JX4YSCBH.js.map +1 -0
  44. package/dist/chunk-KX6UYWWR.js +229 -0
  45. package/dist/chunk-KX6UYWWR.js.map +1 -0
  46. package/dist/chunk-LWVETFJV.js +46 -0
  47. package/dist/chunk-LWVETFJV.js.map +1 -0
  48. package/dist/chunk-MCL2MCA2.js +285 -0
  49. package/dist/chunk-MCL2MCA2.js.map +1 -0
  50. package/dist/chunk-MZXCF35B.js +205 -0
  51. package/dist/chunk-MZXCF35B.js.map +1 -0
  52. package/dist/chunk-NCGPUFWV.js +96 -0
  53. package/dist/chunk-NCGPUFWV.js.map +1 -0
  54. package/dist/chunk-OEJMIE2Q.js +351 -0
  55. package/dist/chunk-OEJMIE2Q.js.map +1 -0
  56. package/dist/chunk-OYF2OAKS.js +394 -0
  57. package/dist/chunk-OYF2OAKS.js.map +1 -0
  58. package/dist/chunk-P6S43FYZ.js +316 -0
  59. package/dist/chunk-P6S43FYZ.js.map +1 -0
  60. package/dist/chunk-PL37KFRJ.js +3 -0
  61. package/dist/chunk-PL37KFRJ.js.map +1 -0
  62. package/dist/chunk-Q7BS5QC5.js +197 -0
  63. package/dist/chunk-Q7BS5QC5.js.map +1 -0
  64. package/dist/chunk-SDYPG3JD.js +288 -0
  65. package/dist/chunk-SDYPG3JD.js.map +1 -0
  66. package/dist/chunk-SUG56SZO.js +256 -0
  67. package/dist/chunk-SUG56SZO.js.map +1 -0
  68. package/dist/chunk-UVH5XJRP.js +164 -0
  69. package/dist/chunk-UVH5XJRP.js.map +1 -0
  70. package/dist/chunk-WZIJKCL3.js +282 -0
  71. package/dist/chunk-WZIJKCL3.js.map +1 -0
  72. package/dist/chunk-Y22AMGTM.js +3 -0
  73. package/dist/chunk-Y22AMGTM.js.map +1 -0
  74. package/dist/chunk-Z7G23XWU.js +200 -0
  75. package/dist/chunk-Z7G23XWU.js.map +1 -0
  76. package/dist/chunk-ZJU5M4IB.js +125 -0
  77. package/dist/chunk-ZJU5M4IB.js.map +1 -0
  78. package/dist/chunk-ZVC3ZWLM.js +52 -0
  79. package/dist/chunk-ZVC3ZWLM.js.map +1 -0
  80. package/dist/chunk-ZZZML7Y3.js +310 -0
  81. package/dist/chunk-ZZZML7Y3.js.map +1 -0
  82. package/dist/client.d.ts +25 -0
  83. package/dist/client.js +16 -0
  84. package/dist/client.js.map +1 -0
  85. package/dist/config/index.d.ts +170 -0
  86. package/dist/config/index.js +3 -0
  87. package/dist/config/index.js.map +1 -0
  88. package/dist/errors/index.d.ts +267 -0
  89. package/dist/errors/index.js +4 -0
  90. package/dist/errors/index.js.map +1 -0
  91. package/dist/file-router/index.d.ts +184 -0
  92. package/dist/file-router/index.js +3 -0
  93. package/dist/file-router/index.js.map +1 -0
  94. package/dist/file-router/streaming-hints.d.ts +129 -0
  95. package/dist/file-router/streaming-hints.js +3 -0
  96. package/dist/file-router/streaming-hints.js.map +1 -0
  97. package/dist/handlers/index.d.ts +59 -0
  98. package/dist/handlers/index.js +3 -0
  99. package/dist/handlers/index.js.map +1 -0
  100. package/dist/index.d.ts +588 -0
  101. package/dist/index.js +886 -0
  102. package/dist/index.js.map +1 -0
  103. package/dist/islands/index.d.ts +234 -0
  104. package/dist/islands/index.js +3 -0
  105. package/dist/islands/index.js.map +1 -0
  106. package/dist/middleware/index.d.ts +305 -0
  107. package/dist/middleware/index.js +3 -0
  108. package/dist/middleware/index.js.map +1 -0
  109. package/dist/react/index.d.ts +73 -0
  110. package/dist/react/index.js +52 -0
  111. package/dist/react/index.js.map +1 -0
  112. package/dist/render/index.d.ts +131 -0
  113. package/dist/render/index.js +3 -0
  114. package/dist/render/index.js.map +1 -0
  115. package/dist/router/index.d.ts +65 -0
  116. package/dist/router/index.js +3 -0
  117. package/dist/router/index.js.map +1 -0
  118. package/dist/rsc/adapters/index.d.ts +8 -0
  119. package/dist/rsc/adapters/index.js +7 -0
  120. package/dist/rsc/adapters/index.js.map +1 -0
  121. package/dist/rsc/adapters/preact.d.ts +97 -0
  122. package/dist/rsc/adapters/preact.js +3 -0
  123. package/dist/rsc/adapters/preact.js.map +1 -0
  124. package/dist/rsc/adapters/react.d.ts +82 -0
  125. package/dist/rsc/adapters/react.js +3 -0
  126. package/dist/rsc/adapters/react.js.map +1 -0
  127. package/dist/rsc/adapters/solid.d.ts +84 -0
  128. package/dist/rsc/adapters/solid.js +3 -0
  129. package/dist/rsc/adapters/solid.js.map +1 -0
  130. package/dist/rsc/adapters/vue.d.ts +80 -0
  131. package/dist/rsc/adapters/vue.js +3 -0
  132. package/dist/rsc/adapters/vue.js.map +1 -0
  133. package/dist/rsc/boundaries.d.ts +182 -0
  134. package/dist/rsc/boundaries.js +3 -0
  135. package/dist/rsc/boundaries.js.map +1 -0
  136. package/dist/rsc/context.d.ts +201 -0
  137. package/dist/rsc/context.js +3 -0
  138. package/dist/rsc/context.js.map +1 -0
  139. package/dist/rsc/index.d.ts +232 -0
  140. package/dist/rsc/index.js +15 -0
  141. package/dist/rsc/index.js.map +1 -0
  142. package/dist/rsc/legacy.d.ts +155 -0
  143. package/dist/rsc/legacy.js +3 -0
  144. package/dist/rsc/legacy.js.map +1 -0
  145. package/dist/rsc/payload.d.ts +262 -0
  146. package/dist/rsc/payload.js +3 -0
  147. package/dist/rsc/payload.js.map +1 -0
  148. package/dist/rsc/plugins/esbuild.d.ts +124 -0
  149. package/dist/rsc/plugins/esbuild.js +4 -0
  150. package/dist/rsc/plugins/esbuild.js.map +1 -0
  151. package/dist/rsc/plugins/index.d.ts +4 -0
  152. package/dist/rsc/plugins/index.js +6 -0
  153. package/dist/rsc/plugins/index.js.map +1 -0
  154. package/dist/rsc/plugins/rollup.d.ts +103 -0
  155. package/dist/rsc/plugins/rollup.js +4 -0
  156. package/dist/rsc/plugins/rollup.js.map +1 -0
  157. package/dist/rsc/renderer.d.ts +162 -0
  158. package/dist/rsc/renderer.js +5 -0
  159. package/dist/rsc/renderer.js.map +1 -0
  160. package/dist/rsc/stream.d.ts +129 -0
  161. package/dist/rsc/stream.js +3 -0
  162. package/dist/rsc/stream.js.map +1 -0
  163. package/dist/rsc/vite-plugin.d.ts +78 -0
  164. package/dist/rsc/vite-plugin.js +4 -0
  165. package/dist/rsc/vite-plugin.js.map +1 -0
  166. package/dist/server/index.d.ts +135 -0
  167. package/dist/server/index.js +6 -0
  168. package/dist/server/index.js.map +1 -0
  169. package/dist/streaming/adapters/index.d.ts +223 -0
  170. package/dist/streaming/adapters/index.js +3 -0
  171. package/dist/streaming/adapters/index.js.map +1 -0
  172. package/dist/streaming/conditional.d.ts +130 -0
  173. package/dist/streaming/conditional.js +3 -0
  174. package/dist/streaming/conditional.js.map +1 -0
  175. package/dist/streaming/index.d.ts +177 -0
  176. package/dist/streaming/index.js +3 -0
  177. package/dist/streaming/index.js.map +1 -0
  178. package/dist/streaming/observability.d.ts +201 -0
  179. package/dist/streaming/observability.js +4 -0
  180. package/dist/streaming/observability.js.map +1 -0
  181. package/dist/streaming/priority.d.ts +103 -0
  182. package/dist/streaming/priority.js +3 -0
  183. package/dist/streaming/priority.js.map +1 -0
  184. package/dist/utils/index.d.ts +42 -0
  185. package/dist/utils/index.js +4 -0
  186. package/dist/utils/index.js.map +1 -0
  187. package/package.json +228 -0
@@ -0,0 +1,267 @@
1
+ // src/islands/index.ts
2
+ var instanceCounter = 0;
3
+ function generateInstanceId(islandId) {
4
+ return `${islandId}:${++instanceCounter}:${Math.random().toString(36).slice(2, 7)}`;
5
+ }
6
+ function defineIsland(config) {
7
+ return (props) => ({
8
+ config,
9
+ props: { ...config.defaultProps, ...props },
10
+ instanceId: generateInstanceId(config.id)
11
+ });
12
+ }
13
+ function serializeProps(props) {
14
+ try {
15
+ return JSON.stringify(props);
16
+ } catch {
17
+ console.warn("[Flight Islands] Props are not serializable, using empty object");
18
+ return "{}";
19
+ }
20
+ }
21
+ function getHydrateAttr(trigger) {
22
+ if (typeof trigger === "object" && trigger.type === "custom") {
23
+ return `custom:${trigger.name}`;
24
+ }
25
+ return trigger;
26
+ }
27
+ var globalAdapter = null;
28
+ function setIslandAdapter(adapter) {
29
+ globalAdapter = adapter;
30
+ }
31
+ async function renderIsland(island, adapter) {
32
+ const renderAdapter = adapter || globalAdapter;
33
+ if (!renderAdapter) {
34
+ throw new Error(
35
+ "[Flight Islands] No render adapter set. Call setIslandAdapter() or pass adapter to renderIsland()."
36
+ );
37
+ }
38
+ const { config, props, instanceId } = island;
39
+ const componentHtml = await renderAdapter.renderToString(config.component, props);
40
+ const css = renderAdapter.getCSS?.(config.component);
41
+ const hydrateAttr = getHydrateAttr(config.hydrate);
42
+ const propsJson = serializeProps(props);
43
+ const html = `
44
+ <flight-island
45
+ data-island="${config.id}"
46
+ data-instance="${instanceId}"
47
+ data-hydrate="${hydrateAttr}"
48
+ ${config.mediaQuery ? `data-media="${config.mediaQuery}"` : ""}
49
+ ${config.clientEntry ? `data-entry="${config.clientEntry}"` : ""}
50
+ ${config.priority ? `data-priority="${config.priority}"` : ""}
51
+ >
52
+ ${componentHtml}
53
+ </flight-island>`;
54
+ const propsScript = `<script type="application/json" data-island-props="${instanceId}">${propsJson}</script>`;
55
+ return {
56
+ html,
57
+ id: config.id,
58
+ instanceId,
59
+ propsScript,
60
+ css
61
+ };
62
+ }
63
+ async function renderIslands(islands, adapter) {
64
+ const rendered = await Promise.all(
65
+ islands.map((island) => renderIsland(island, adapter))
66
+ );
67
+ return {
68
+ html: rendered.map((r) => r.html).join("\n"),
69
+ propsScripts: rendered.map((r) => r.propsScript).join("\n"),
70
+ css: rendered.filter((r) => r.css).map((r) => r.css).join("\n")
71
+ };
72
+ }
73
+ function createIslandRegistry() {
74
+ const loaders = /* @__PURE__ */ new Map();
75
+ return {
76
+ register(id, loader) {
77
+ loaders.set(id, loader);
78
+ },
79
+ get(id) {
80
+ return loaders.get(id);
81
+ },
82
+ has(id) {
83
+ return loaders.has(id);
84
+ }
85
+ };
86
+ }
87
+ var globalRegistry = createIslandRegistry();
88
+ function registerIsland(id, loader) {
89
+ globalRegistry.register(id, loader);
90
+ }
91
+ function hydrateIslands(options) {
92
+ const {
93
+ root = typeof document !== "undefined" ? document.body : null,
94
+ registry = globalRegistry,
95
+ onHydrate,
96
+ onError
97
+ } = options || {};
98
+ if (!root || typeof document === "undefined") {
99
+ console.warn("[Flight Islands] hydrateIslands called in non-browser environment");
100
+ return;
101
+ }
102
+ const islands = root.querySelectorAll("flight-island[data-island]");
103
+ islands.forEach((element) => {
104
+ const islandId = element.dataset.island;
105
+ const instanceId = element.dataset.instance;
106
+ const hydrateTrigger = element.dataset.hydrate;
107
+ const mediaQuery = element.dataset.media;
108
+ if (!registry.has(islandId)) {
109
+ console.warn(`[Flight Islands] No component registered for island: ${islandId}`);
110
+ return;
111
+ }
112
+ setupHydration(
113
+ element,
114
+ islandId,
115
+ instanceId,
116
+ hydrateTrigger,
117
+ mediaQuery,
118
+ registry,
119
+ onHydrate,
120
+ onError
121
+ );
122
+ });
123
+ }
124
+ function setupHydration(element, islandId, instanceId, trigger, mediaQuery, registry, onHydrate, onError) {
125
+ const hydrate = async () => {
126
+ const startTime = performance.now();
127
+ try {
128
+ const loader = registry.get(islandId);
129
+ const module = await loader();
130
+ const Component = module.default || module;
131
+ const propsScript = document.querySelector(`[data-island-props="${instanceId}"]`);
132
+ const props = propsScript ? JSON.parse(propsScript.textContent || "{}") : {};
133
+ element.dispatchEvent(new CustomEvent("flight:hydrate", {
134
+ detail: { Component, props, islandId, instanceId },
135
+ bubbles: true
136
+ }));
137
+ element.setAttribute("data-hydrated", "true");
138
+ const duration = performance.now() - startTime;
139
+ onHydrate?.(islandId, instanceId, duration);
140
+ } catch (error) {
141
+ console.error(`[Flight Islands] Failed to hydrate ${islandId}:`, error);
142
+ element.setAttribute("data-hydrate-error", "true");
143
+ onError?.(islandId, error);
144
+ }
145
+ };
146
+ if (element.hasAttribute("data-hydrated")) return;
147
+ switch (trigger) {
148
+ case "load":
149
+ hydrate();
150
+ break;
151
+ case "idle":
152
+ if ("requestIdleCallback" in window) {
153
+ window.requestIdleCallback(() => hydrate(), { timeout: 2e3 });
154
+ } else {
155
+ setTimeout(hydrate, 200);
156
+ }
157
+ break;
158
+ case "visible": {
159
+ const observer = new IntersectionObserver(
160
+ (entries) => {
161
+ entries.forEach((entry) => {
162
+ if (entry.isIntersecting) {
163
+ observer.disconnect();
164
+ hydrate();
165
+ }
166
+ });
167
+ },
168
+ { rootMargin: "50px" }
169
+ );
170
+ observer.observe(element);
171
+ break;
172
+ }
173
+ case "interaction": {
174
+ const events = ["click", "focus", "touchstart", "mouseenter"];
175
+ const onInteraction = () => {
176
+ events.forEach((e) => element.removeEventListener(e, onInteraction));
177
+ hydrate();
178
+ };
179
+ events.forEach((e) => element.addEventListener(e, onInteraction, { once: true, passive: true }));
180
+ break;
181
+ }
182
+ case "media":
183
+ if (mediaQuery) {
184
+ const mql = window.matchMedia(mediaQuery);
185
+ const check = () => {
186
+ if (mql.matches) {
187
+ mql.removeEventListener("change", check);
188
+ hydrate();
189
+ }
190
+ };
191
+ if (mql.matches) {
192
+ hydrate();
193
+ } else {
194
+ mql.addEventListener("change", check);
195
+ }
196
+ }
197
+ break;
198
+ case "never":
199
+ break;
200
+ default:
201
+ if (trigger.startsWith("custom:")) {
202
+ element.dispatchEvent(new CustomEvent("flight:custom-hydrate", {
203
+ detail: { hydrate, trigger: trigger.replace("custom:", "") },
204
+ bubbles: true
205
+ }));
206
+ }
207
+ }
208
+ }
209
+ function createReactIslandAdapter(deps) {
210
+ return {
211
+ name: "react",
212
+ async renderToString(component, props) {
213
+ const element = deps.createElement(component, props);
214
+ return deps.renderToString(element);
215
+ }
216
+ };
217
+ }
218
+ function createPreactIslandAdapter(deps) {
219
+ return {
220
+ name: "preact",
221
+ async renderToString(component, props) {
222
+ const element = deps.h(component, props);
223
+ return deps.renderToString(element);
224
+ }
225
+ };
226
+ }
227
+ function createVueIslandAdapter(deps) {
228
+ return {
229
+ name: "vue",
230
+ async renderToString(component, props) {
231
+ const app = deps.createSSRApp(component, props);
232
+ return deps.renderToString(app);
233
+ }
234
+ };
235
+ }
236
+ function createSolidIslandAdapter(deps) {
237
+ return {
238
+ name: "solid",
239
+ async renderToString(component, props) {
240
+ return deps.renderToString(() => component(props));
241
+ }
242
+ };
243
+ }
244
+ function registerFlightIslandElement() {
245
+ if (typeof customElements === "undefined") return;
246
+ if (customElements.get("flight-island")) return;
247
+ class FlightIsland extends HTMLElement {
248
+ static get observedAttributes() {
249
+ return ["data-hydrated", "data-hydrate-error"];
250
+ }
251
+ connectedCallback() {
252
+ }
253
+ attributeChangedCallback(name, _oldValue, newValue) {
254
+ if (name === "data-hydrated" && newValue === "true") {
255
+ this.classList.add("hydrated");
256
+ }
257
+ if (name === "data-hydrate-error" && newValue === "true") {
258
+ this.classList.add("hydrate-error");
259
+ }
260
+ }
261
+ }
262
+ customElements.define("flight-island", FlightIsland);
263
+ }
264
+
265
+ export { createIslandRegistry, createPreactIslandAdapter, createReactIslandAdapter, createSolidIslandAdapter, createVueIslandAdapter, defineIsland, hydrateIslands, registerFlightIslandElement, registerIsland, renderIsland, renderIslands, setIslandAdapter };
266
+ //# sourceMappingURL=chunk-IW7FTQQX.js.map
267
+ //# sourceMappingURL=chunk-IW7FTQQX.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"sources":["../src/islands/index.ts"],"names":[],"mappings":"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","file":"chunk-IW7FTQQX.js","sourcesContent":["/**\r\n * @flightdev/core - Islands Architecture\r\n * \r\n * Selective hydration with fine-grained control over when and how\r\n * components become interactive. Framework-agnostic islands primitives.\r\n * \r\n * Best Practices 2026:\r\n * - Minimal JavaScript: Only hydrate what needs interactivity\r\n * - Lazy hydration: Load JS when actually needed\r\n * - Progressive enhancement: Works without JS\r\n * - Performance: Reduce main thread work\r\n * \r\n * @example\r\n * ```typescript\r\n * import { defineIsland, renderIsland, hydrateIslands } from '@flightdev/core/islands';\r\n * \r\n * // Server: Define an interactive island\r\n * const Counter = defineIsland({\r\n * id: 'counter',\r\n * component: CounterComponent,\r\n * hydrate: 'visible', // Only hydrate when scrolled into view\r\n * });\r\n * \r\n * // Server: Render to HTML with island markers\r\n * const html = await renderIsland(Counter, { initial: 0 });\r\n * \r\n * // Client: Hydrate all islands on the page\r\n * hydrateIslands();\r\n * ```\r\n */\r\n\r\n// ============================================================================\r\n// Types\r\n// ============================================================================\r\n\r\n/**\r\n * When to hydrate the island\r\n */\r\nexport type HydrationTrigger =\r\n | 'load' // Immediate: hydrate as soon as JS loads\r\n | 'idle' // When browser is idle (requestIdleCallback)\r\n | 'visible' // When island enters viewport (IntersectionObserver)\r\n | 'interaction' // On first user interaction (click, focus, hover)\r\n | 'media' // When media query matches\r\n | 'never' // Never hydrate (static HTML only)\r\n | CustomHydrationTrigger;\r\n\r\n/**\r\n * Custom hydration trigger function\r\n */\r\nexport interface CustomHydrationTrigger {\r\n type: 'custom';\r\n /** Name for debugging */\r\n name: string;\r\n /** Function that returns a promise resolving when hydration should occur */\r\n when: (element: HTMLElement) => Promise<void>;\r\n}\r\n\r\n/**\r\n * Island configuration\r\n */\r\nexport interface IslandConfig<P = Record<string, unknown>> {\r\n /** Unique identifier for this island type */\r\n id: string;\r\n /** The component to render (framework-specific) */\r\n component: unknown;\r\n /** When to hydrate on client */\r\n hydrate: HydrationTrigger;\r\n /** Default props */\r\n defaultProps?: P;\r\n /** Media query for 'media' trigger */\r\n mediaQuery?: string;\r\n /** Path to client-side component bundle */\r\n clientEntry?: string;\r\n /** Fallback HTML while not hydrated (optional override) */\r\n fallback?: string;\r\n /** Loading priority hint */\r\n priority?: 'high' | 'low';\r\n}\r\n\r\n/**\r\n * Island instance with props\r\n */\r\nexport interface Island<P = Record<string, unknown>> {\r\n /** Island configuration */\r\n config: IslandConfig<P>;\r\n /** Instance props */\r\n props: P;\r\n /** Unique instance ID (for multiple instances of same island type) */\r\n instanceId: string;\r\n}\r\n\r\n/**\r\n * Rendered island HTML with metadata\r\n */\r\nexport interface RenderedIsland {\r\n /** The HTML string */\r\n html: string;\r\n /** Island ID */\r\n id: string;\r\n /** Instance ID */\r\n instanceId: string;\r\n /** Serialized props for hydration */\r\n propsScript: string;\r\n /** CSS if any */\r\n css?: string;\r\n}\r\n\r\n/**\r\n * Island registry for client-side hydration\r\n */\r\nexport interface IslandRegistry {\r\n /** Register a component for an island ID */\r\n register(id: string, loader: () => Promise<unknown>): void;\r\n /** Get registered loader */\r\n get(id: string): (() => Promise<unknown>) | undefined;\r\n /** Check if island is registered */\r\n has(id: string): boolean;\r\n}\r\n\r\n/**\r\n * Client-side hydration options\r\n */\r\nexport interface HydrateOptions {\r\n /** Root element to scan for islands */\r\n root?: HTMLElement;\r\n /** Custom island registry */\r\n registry?: IslandRegistry;\r\n /** Callback when an island is hydrated */\r\n onHydrate?: (id: string, instanceId: string, duration: number) => void;\r\n /** Callback on hydration error */\r\n onError?: (id: string, error: Error) => void;\r\n}\r\n\r\n// ============================================================================\r\n// Server-Side: Island Definition\r\n// ============================================================================\r\n\r\nlet instanceCounter = 0;\r\n\r\n/**\r\n * Generate a unique instance ID\r\n */\r\nfunction generateInstanceId(islandId: string): string {\r\n return `${islandId}:${++instanceCounter}:${Math.random().toString(36).slice(2, 7)}`;\r\n}\r\n\r\n/**\r\n * Define an island component\r\n */\r\nexport function defineIsland<P = Record<string, unknown>>(\r\n config: IslandConfig<P>\r\n): (props?: P) => Island<P> {\r\n return (props?: P) => ({\r\n config,\r\n props: { ...config.defaultProps, ...props } as P,\r\n instanceId: generateInstanceId(config.id),\r\n });\r\n}\r\n\r\n/**\r\n * Serialize props for client-side hydration\r\n */\r\nfunction serializeProps(props: Record<string, unknown>): string {\r\n try {\r\n return JSON.stringify(props);\r\n } catch {\r\n console.warn('[Flight Islands] Props are not serializable, using empty object');\r\n return '{}';\r\n }\r\n}\r\n\r\n/**\r\n * Get hydration trigger attribute value\r\n */\r\nfunction getHydrateAttr(trigger: HydrationTrigger): string {\r\n if (typeof trigger === 'object' && trigger.type === 'custom') {\r\n return `custom:${trigger.name}`;\r\n }\r\n return trigger as string;\r\n}\r\n\r\n// ============================================================================\r\n// Server-Side: Island Rendering\r\n// ============================================================================\r\n\r\n/**\r\n * UI framework adapter for island rendering\r\n */\r\nexport interface IslandRenderAdapter {\r\n /** Framework name */\r\n name: string;\r\n /** Render component to HTML */\r\n renderToString(component: unknown, props: Record<string, unknown>): Promise<string>;\r\n /** Get CSS if any */\r\n getCSS?(component: unknown): string;\r\n}\r\n\r\nlet globalAdapter: IslandRenderAdapter | null = null;\r\n\r\n/**\r\n * Set the global island render adapter\r\n */\r\nexport function setIslandAdapter(adapter: IslandRenderAdapter): void {\r\n globalAdapter = adapter;\r\n}\r\n\r\n/**\r\n * Render an island to HTML with hydration markers\r\n */\r\nexport async function renderIsland<P extends Record<string, unknown>>(\r\n island: Island<P>,\r\n adapter?: IslandRenderAdapter\r\n): Promise<RenderedIsland> {\r\n const renderAdapter = adapter || globalAdapter;\r\n\r\n if (!renderAdapter) {\r\n throw new Error(\r\n '[Flight Islands] No render adapter set. Call setIslandAdapter() or pass adapter to renderIsland().'\r\n );\r\n }\r\n\r\n const { config, props, instanceId } = island;\r\n\r\n // Render component to HTML\r\n const componentHtml = await renderAdapter.renderToString(config.component, props);\r\n const css = renderAdapter.getCSS?.(config.component);\r\n\r\n // Build island wrapper with data attributes\r\n const hydrateAttr = getHydrateAttr(config.hydrate);\r\n const propsJson = serializeProps(props);\r\n\r\n const html = `\r\n<flight-island \r\n data-island=\"${config.id}\"\r\n data-instance=\"${instanceId}\"\r\n data-hydrate=\"${hydrateAttr}\"\r\n ${config.mediaQuery ? `data-media=\"${config.mediaQuery}\"` : ''}\r\n ${config.clientEntry ? `data-entry=\"${config.clientEntry}\"` : ''}\r\n ${config.priority ? `data-priority=\"${config.priority}\"` : ''}\r\n>\r\n ${componentHtml}\r\n</flight-island>`;\r\n\r\n // Props script (inline for hydration)\r\n const propsScript = `<script type=\"application/json\" data-island-props=\"${instanceId}\">${propsJson}</script>`;\r\n\r\n return {\r\n html,\r\n id: config.id,\r\n instanceId,\r\n propsScript,\r\n css,\r\n };\r\n}\r\n\r\n/**\r\n * Render multiple islands and collect their outputs\r\n */\r\nexport async function renderIslands<P extends Record<string, unknown>>(\r\n islands: Island<P>[],\r\n adapter?: IslandRenderAdapter\r\n): Promise<{\r\n html: string;\r\n propsScripts: string;\r\n css: string;\r\n}> {\r\n const rendered = await Promise.all(\r\n islands.map(island => renderIsland(island, adapter))\r\n );\r\n\r\n return {\r\n html: rendered.map(r => r.html).join('\\n'),\r\n propsScripts: rendered.map(r => r.propsScript).join('\\n'),\r\n css: rendered.filter(r => r.css).map(r => r.css).join('\\n'),\r\n };\r\n}\r\n\r\n// ============================================================================\r\n// Client-Side: Island Hydration\r\n// ============================================================================\r\n\r\n/**\r\n * Create an island registry for client-side hydration\r\n */\r\nexport function createIslandRegistry(): IslandRegistry {\r\n const loaders = new Map<string, () => Promise<unknown>>();\r\n\r\n return {\r\n register(id: string, loader: () => Promise<unknown>) {\r\n loaders.set(id, loader);\r\n },\r\n get(id: string) {\r\n return loaders.get(id);\r\n },\r\n has(id: string) {\r\n return loaders.has(id);\r\n },\r\n };\r\n}\r\n\r\n// Global registry for convenience\r\nconst globalRegistry = createIslandRegistry();\r\n\r\n/**\r\n * Register an island component for client-side hydration\r\n */\r\nexport function registerIsland(id: string, loader: () => Promise<unknown>): void {\r\n globalRegistry.register(id, loader);\r\n}\r\n\r\n/**\r\n * Client-side hydration bootstrapper\r\n * Call this in your client entry point\r\n */\r\nexport function hydrateIslands(options?: HydrateOptions): void {\r\n const {\r\n root = typeof document !== 'undefined' ? document.body : null,\r\n registry = globalRegistry,\r\n onHydrate,\r\n onError,\r\n } = options || {};\r\n\r\n if (!root || typeof document === 'undefined') {\r\n console.warn('[Flight Islands] hydrateIslands called in non-browser environment');\r\n return;\r\n }\r\n\r\n // Find all island elements\r\n const islands = root.querySelectorAll<HTMLElement>('flight-island[data-island]');\r\n\r\n islands.forEach((element) => {\r\n const islandId = element.dataset.island!;\r\n const instanceId = element.dataset.instance!;\r\n const hydrateTrigger = element.dataset.hydrate as string;\r\n const mediaQuery = element.dataset.media;\r\n\r\n // Check if component is registered\r\n if (!registry.has(islandId)) {\r\n console.warn(`[Flight Islands] No component registered for island: ${islandId}`);\r\n return;\r\n }\r\n\r\n // Setup hydration based on trigger\r\n setupHydration(\r\n element,\r\n islandId,\r\n instanceId,\r\n hydrateTrigger,\r\n mediaQuery,\r\n registry,\r\n onHydrate,\r\n onError\r\n );\r\n });\r\n}\r\n\r\n/**\r\n * Setup hydration trigger for an island element\r\n */\r\nfunction setupHydration(\r\n element: HTMLElement,\r\n islandId: string,\r\n instanceId: string,\r\n trigger: string,\r\n mediaQuery: string | undefined,\r\n registry: IslandRegistry,\r\n onHydrate?: (id: string, instanceId: string, duration: number) => void,\r\n onError?: (id: string, error: Error) => void\r\n): void {\r\n const hydrate = async () => {\r\n const startTime = performance.now();\r\n\r\n try {\r\n // Load component\r\n const loader = registry.get(islandId)!;\r\n const module = await loader() as { default?: unknown };\r\n const Component = module.default || module;\r\n\r\n // Get props\r\n const propsScript = document.querySelector(`[data-island-props=\"${instanceId}\"]`);\r\n const props = propsScript ? JSON.parse(propsScript.textContent || '{}') : {};\r\n\r\n // Hydrate (framework-specific, emit event for now)\r\n element.dispatchEvent(new CustomEvent('flight:hydrate', {\r\n detail: { Component, props, islandId, instanceId },\r\n bubbles: true,\r\n }));\r\n\r\n // Mark as hydrated\r\n element.setAttribute('data-hydrated', 'true');\r\n\r\n const duration = performance.now() - startTime;\r\n onHydrate?.(islandId, instanceId, duration);\r\n\r\n } catch (error) {\r\n console.error(`[Flight Islands] Failed to hydrate ${islandId}:`, error);\r\n element.setAttribute('data-hydrate-error', 'true');\r\n onError?.(islandId, error as Error);\r\n }\r\n };\r\n\r\n // Skip if already hydrated\r\n if (element.hasAttribute('data-hydrated')) return;\r\n\r\n switch (trigger) {\r\n case 'load':\r\n // Immediate hydration\r\n hydrate();\r\n break;\r\n\r\n case 'idle':\r\n // When browser is idle\r\n if ('requestIdleCallback' in window) {\r\n (window as unknown as { requestIdleCallback: (cb: () => void, opts?: { timeout: number }) => void })\r\n .requestIdleCallback(() => hydrate(), { timeout: 2000 });\r\n } else {\r\n setTimeout(hydrate, 200);\r\n }\r\n break;\r\n\r\n case 'visible': {\r\n // When element enters viewport\r\n const observer = new IntersectionObserver(\r\n (entries) => {\r\n entries.forEach((entry) => {\r\n if (entry.isIntersecting) {\r\n observer.disconnect();\r\n hydrate();\r\n }\r\n });\r\n },\r\n { rootMargin: '50px' }\r\n );\r\n observer.observe(element);\r\n break;\r\n }\r\n\r\n case 'interaction': {\r\n // On first user interaction\r\n const events = ['click', 'focus', 'touchstart', 'mouseenter'];\r\n const onInteraction = () => {\r\n events.forEach(e => element.removeEventListener(e, onInteraction));\r\n hydrate();\r\n };\r\n events.forEach(e => element.addEventListener(e, onInteraction, { once: true, passive: true }));\r\n break;\r\n }\r\n\r\n case 'media':\r\n // When media query matches\r\n if (mediaQuery) {\r\n const mql = window.matchMedia(mediaQuery);\r\n const check = () => {\r\n if (mql.matches) {\r\n mql.removeEventListener('change', check);\r\n hydrate();\r\n }\r\n };\r\n if (mql.matches) {\r\n hydrate();\r\n } else {\r\n mql.addEventListener('change', check);\r\n }\r\n }\r\n break;\r\n\r\n case 'never':\r\n // Never hydrate\r\n break;\r\n\r\n default:\r\n // Custom trigger\r\n if (trigger.startsWith('custom:')) {\r\n // Custom triggers need manual setup\r\n element.dispatchEvent(new CustomEvent('flight:custom-hydrate', {\r\n detail: { hydrate, trigger: trigger.replace('custom:', '') },\r\n bubbles: true,\r\n }));\r\n }\r\n }\r\n}\r\n\r\n// ============================================================================\r\n// Utility: Framework-Specific Adapter Factories\r\n// These return adapters that users configure with their own framework imports\r\n// ============================================================================\r\n\r\n/**\r\n * Create a React island render adapter\r\n * \r\n * @example\r\n * ```typescript\r\n * import { renderToString } from 'react-dom/server';\r\n * import { createElement } from 'react';\r\n * \r\n * const reactAdapter = createReactIslandAdapter({\r\n * renderToString,\r\n * createElement,\r\n * });\r\n * ```\r\n */\r\nexport function createReactIslandAdapter(deps: {\r\n renderToString: (element: unknown) => string;\r\n createElement: (type: unknown, props?: unknown) => unknown;\r\n}): IslandRenderAdapter {\r\n return {\r\n name: 'react',\r\n async renderToString(component, props) {\r\n const element = deps.createElement(component, props);\r\n return deps.renderToString(element);\r\n },\r\n };\r\n}\r\n\r\n/**\r\n * Create a Preact island render adapter\r\n * \r\n * @example\r\n * ```typescript\r\n * import { renderToString } from 'preact-render-to-string';\r\n * import { h } from 'preact';\r\n * \r\n * const preactAdapter = createPreactIslandAdapter({\r\n * renderToString,\r\n * h,\r\n * });\r\n * ```\r\n */\r\nexport function createPreactIslandAdapter(deps: {\r\n renderToString: (element: unknown) => string;\r\n h: (type: unknown, props?: unknown) => unknown;\r\n}): IslandRenderAdapter {\r\n return {\r\n name: 'preact',\r\n async renderToString(component, props) {\r\n const element = deps.h(component, props);\r\n return deps.renderToString(element);\r\n },\r\n };\r\n}\r\n\r\n/**\r\n * Create a Vue island render adapter\r\n * \r\n * @example\r\n * ```typescript\r\n * import { renderToString, createSSRApp } from 'vue/server-renderer';\r\n * \r\n * const vueAdapter = createVueIslandAdapter({\r\n * renderToString,\r\n * createSSRApp,\r\n * });\r\n * ```\r\n */\r\nexport function createVueIslandAdapter(deps: {\r\n renderToString: (app: unknown) => Promise<string>;\r\n createSSRApp: (component: unknown, props?: unknown) => unknown;\r\n}): IslandRenderAdapter {\r\n return {\r\n name: 'vue',\r\n async renderToString(component, props) {\r\n const app = deps.createSSRApp(component, props);\r\n return deps.renderToString(app);\r\n },\r\n };\r\n}\r\n\r\n/**\r\n * Create a Solid island render adapter\r\n * \r\n * @example\r\n * ```typescript\r\n * import { renderToString } from 'solid-js/web';\r\n * \r\n * const solidAdapter = createSolidIslandAdapter({\r\n * renderToString,\r\n * });\r\n * ```\r\n */\r\nexport function createSolidIslandAdapter(deps: {\r\n renderToString: (fn: () => unknown) => string;\r\n}): IslandRenderAdapter {\r\n return {\r\n name: 'solid',\r\n async renderToString(component, props) {\r\n // Solid uses a function component pattern\r\n return deps.renderToString(() => (component as (p: unknown) => unknown)(props));\r\n },\r\n };\r\n}\r\n\r\n// ============================================================================\r\n// Custom Element Registration (optional)\r\n// ============================================================================\r\n\r\n/**\r\n * Register the flight-island custom element\r\n * This provides additional functionality like slot support\r\n */\r\nexport function registerFlightIslandElement(): void {\r\n if (typeof customElements === 'undefined') return;\r\n if (customElements.get('flight-island')) return;\r\n\r\n class FlightIsland extends HTMLElement {\r\n static get observedAttributes() {\r\n return ['data-hydrated', 'data-hydrate-error'];\r\n }\r\n\r\n connectedCallback() {\r\n // Could add loading indicator logic here\r\n }\r\n\r\n attributeChangedCallback(name: string, _oldValue: string, newValue: string) {\r\n if (name === 'data-hydrated' && newValue === 'true') {\r\n this.classList.add('hydrated');\r\n }\r\n if (name === 'data-hydrate-error' && newValue === 'true') {\r\n this.classList.add('hydrate-error');\r\n }\r\n }\r\n }\r\n\r\n customElements.define('flight-island', FlightIsland);\r\n}\r\n"]}