@mandujs/core 0.7.6 → 0.7.7

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mandujs/core",
-  "version": "0.7.6",
+  "version": "0.7.7",
   "description": "Mandu Framework Core - Spec, Generator, Guard, Runtime",
   "type": "module",
   "main": "./src/index.ts",

package/src/bundler/build.ts

@@ -198,12 +198,15 @@ export async function hydrateIslands() {
 
 /**
  * 자동 초기화
+ * queueMicrotask로 지연: Island 등록 코드가 먼저 실행되도록 함
  */
-if (document.readyState === 'loading') {
-  document.addEventListener('DOMContentLoaded', hydrateIslands);
-} else {
-  hydrateIslands();
-}
+queueMicrotask(() => {
+  if (document.readyState === 'loading') {
+    document.addEventListener('DOMContentLoaded', hydrateIslands);
+  } else {
+    hydrateIslands();
+  }
+});
 
 // 글로벌 레지스트리 접근용 getter
 export const getIslandRegistry = () => window.__MANDU_ISLANDS__;

package/src/client/runtime.ts

@@ -338,6 +338,7 @@ export function initializeRuntime(): void {
 }
 
 // 자동 초기화 여부 (번들 시 설정)
+// queueMicrotask로 지연: 번들 내 Island 등록 코드가 먼저 실행되도록 함
 if (typeof window !== "undefined" && (window as any).__MANDU_AUTO_INIT__ !== false) {
-  initializeRuntime();
+  queueMicrotask(() => initializeRuntime());
 }

package/src/filling/filling.ts

@@ -141,6 +141,9 @@ export class ManduFilling<TLoaderData = unknown> {
     return this;
   }
 
+  /**
+   * 요청 시작 훅
+   */
   onRequest(fn: OnRequestHandler): this {
     this.config.lifecycle.onRequest.push({ fn, scope: "local" });
     return this;
@@ -159,6 +162,10 @@ export class ManduFilling<TLoaderData = unknown> {
     return this;
   }
 
+  /**
+   * 바디 파싱 훅
+   * body를 읽을 때는 req.clone() 사용 권장
+   */
   onParse(fn: OnParseHandler): this {
     this.config.lifecycle.onParse.push({ fn, scope: "local" });
     return this;
@@ -184,21 +191,33 @@ export class ManduFilling<TLoaderData = unknown> {
     return this.guard(fn);
   }
 
+  /**
+   * 핸들러 후 훅
+   */
   afterHandle(fn: AfterHandleHandler): this {
     this.config.lifecycle.afterHandle.push({ fn, scope: "local" });
     return this;
   }
 
+  /**
+   * 최종 응답 매핑 훅
+   */
   mapResponse(fn: MapResponseHandler): this {
     this.config.lifecycle.mapResponse.push({ fn, scope: "local" });
     return this;
   }
 
+  /**
+   * 에러 핸들링 훅
+   */
   onError(fn: OnErrorHandler): this {
     this.config.lifecycle.onError.push({ fn, scope: "local" });
     return this;
   }
 
+  /**
+   * 응답 후 훅 (비동기)
+   */
   afterResponse(fn: AfterResponseHandler): this {
     this.config.lifecycle.afterResponse.push({ fn, scope: "local" });
     return this;