@ubean/islands 0.2.1 → 0.3.0

package/dist/runtime.d.ts

@@ -25,6 +25,25 @@ interface IslandRecord {
   mediaQuery?: string;
   props: Record<string, unknown>;
 }
+/**
+ * True when the tree still has islands that have not been hydrated.
+ * Used by the client entry to skip the second rAF on SPA navigations
+ * that did not introduce new islands.
+ */
+declare function hasPendingIslands(root?: DomParentNode | null): boolean;
+interface IslandHydrationScheduler {
+  requestAnimationFrame: (cb: () => void) => unknown;
+  hasPending: () => boolean;
+  hydrate: () => void;
+  /**
+   * First mount: always wait two frames so Vue's patch (and async resolve)
+   * finishes. SPA `afterEach`: after the first frame, skip the second when
+   * nothing is pending — nested Suspense islands that appear only on the
+   * second frame are a documented miss; first mount still forces two frames.
+   */
+  forceDoubleFrame?: boolean;
+}
+declare function scheduleIslandHydration(options: IslandHydrationScheduler): void;
 declare function collectIslands(root?: DomParentNode): IslandRecord[];
 declare function hydrateIsland(record: IslandRecord, component: Component, options?: IslandHydrateOptions): void;
 interface HydrateIslandsOptions extends IslandHydrateOptions {
@@ -335,4 +354,4 @@ declare function defineClientComponent(component: Component): Component;
  */
 declare function definePairedComponent(ServerComp: Component, ClientComp: Component): Component;
 //#endregion
-export { ClientComponentPlaceholder, HydrateIslandsOptions, IslandHydrateOptions, IslandOptions, IslandRecord, IslandStrategy, SERVER_COMPONENT_ENDPOINT, ServerComponentStub, ServerIslandOptions, _clearServerComponentRegistry, collectIslands, defineClientComponent, defineIsland, definePairedComponent, defineServerIsland, getServerComponent, hydrateIsland, hydrateIslands, registerServerComponent };
+export { ClientComponentPlaceholder, HydrateIslandsOptions, IslandHydrateOptions, IslandHydrationScheduler, IslandOptions, IslandRecord, IslandStrategy, SERVER_COMPONENT_ENDPOINT, ServerComponentStub, ServerIslandOptions, _clearServerComponentRegistry, collectIslands, defineClientComponent, defineIsland, definePairedComponent, defineServerIsland, getServerComponent, hasPendingIslands, hydrateIsland, hydrateIslands, registerServerComponent, scheduleIslandHydration };

package/dist/runtime.js

@@ -9,6 +9,24 @@ function decodeProps(raw) {
 		return {};
 	}
 }
+/**
+* True when the tree still has islands that have not been hydrated.
+* Used by the client entry to skip the second rAF on SPA navigations
+* that did not introduce new islands.
+*/
+function hasPendingIslands(root) {
+	return collectIslands(root ?? void 0).some((record) => !record.el.hasAttribute("data-hydrated"));
+}
+function scheduleIslandHydration(options) {
+	const raf = options.requestAnimationFrame;
+	raf(() => {
+		if (!options.forceDoubleFrame && !options.hasPending()) return;
+		raf(() => {
+			if (!options.hasPending()) return;
+			options.hydrate();
+		});
+	});
+}
 function collectIslands(root) {
 	const doc = root ?? _global.document;
 	if (!doc) return [];
@@ -55,6 +73,7 @@ function hydrateIslands(options = {}) {
 	const islands = collectIslands(root);
 	if (islands.length === 0) return;
 	for (const record of islands) {
+		if (record.el.hasAttribute("data-hydrated")) continue;
 		if (record.directive === "client:only") {
 			const comp = resolveComponent(record.componentName, components, getComponent);
 			if (comp) Promise.resolve(comp).then((c) => hydrateIsland(record, c, rest));
@@ -504,4 +523,4 @@ function definePairedComponent(ServerComp, ClientComp) {
 	});
 }
 //#endregion
-export { ClientComponentPlaceholder, SERVER_COMPONENT_ENDPOINT, ServerComponentStub, _clearServerComponentRegistry, collectIslands, defineClientComponent, defineIsland, definePairedComponent, defineServerIsland, getServerComponent, hydrateIsland, hydrateIslands, registerServerComponent };
+export { ClientComponentPlaceholder, SERVER_COMPONENT_ENDPOINT, ServerComponentStub, _clearServerComponentRegistry, collectIslands, defineClientComponent, defineIsland, definePairedComponent, defineServerIsland, getServerComponent, hasPendingIslands, hydrateIsland, hydrateIslands, registerServerComponent, scheduleIslandHydration };

package/dist/vite.js

@@ -133,7 +133,7 @@ const DEFINE_SERVER_ISLAND_RE = /\bdefineServerIsland\s*\(/g;
 * 预扫描代码,返回所有"非代码"区间 `[start, end)`:注释(块/行)和字符串字面量。
 *
 * 用于跳过注释/字符串内的 `defineServerIsland(` 匹配(如 JSDoc 示例或说明性字符串)。
-* 复用 `@ubean/actions` Vite 插件的成熟模式 (见 lessons #P-lessons)。
+* 复用 `@ubean/build/actions` Vite 插件的成熟模式 (见 lessons #P-lessons)。
 */
 function findNonCodeRanges(code) {
 	const ranges = [];

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ubean/islands",
-  "version": "0.2.1",
+  "version": "0.3.0",
   "description": "Islands architecture for ubean (Vite plugin for client:load/idle/visible/media/only directives, bootstrap script, client hydrate runtime)",
   "files": [
     "dist"
@@ -38,7 +38,7 @@
   "dependencies": {
     "hono": "4.13.3",
     "vue": "^3.5.41",
-    "@ubean/shared": "0.2.1"
+    "@ubean/shared": "0.3.0"
   },
   "devDependencies": {
     "@types/node": "^26.2.0",