@mandujs/core 0.7.5 → 0.7.7

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mandujs/core",
-  "version": "0.7.5",
+  "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;

package/src/runtime/ssr.ts

@@ -72,19 +72,19 @@ function generateHydrationScripts(
     scripts.push(importMap);
   }
 
-  // Runtime 로드
-  if (manifest.shared.runtime) {
-    scripts.push(`<script type="module" src="${manifest.shared.runtime}"></script>`);
-  }
-
-  // Island 번들 로드
+  // Island 번들 먼저 로드 (등록)
+  // 주의: ES Module 병렬 로드로 인해 Island가 먼저 등록되어야 함
   const bundle = manifest.bundles[routeId];
   if (bundle) {
-    // Preload (선택적)
     scripts.push(`<link rel="modulepreload" href="${bundle.js}">`);
     scripts.push(`<script type="module" src="${bundle.js}"></script>`);
   }
 
+  // Runtime 나중에 로드 (hydrateIslands 실행)
+  if (manifest.shared.runtime) {
+    scripts.push(`<script type="module" src="${manifest.shared.runtime}"></script>`);
+  }
+
   return scripts.join("\n");
 }
 

package/src/runtime/trace.ts

@@ -30,6 +30,19 @@ export interface TraceCollector {
   records: TraceEntry[];
 }
 
+export interface TraceReportEntry {
+  event: TraceEvent;
+  name?: string;
+  start: number;
+  end: number;
+  duration: number;
+}
+
+export interface TraceReport {
+  entries: TraceReportEntry[];
+  errors: TraceEntry[];
+}
+
 export const TRACE_KEY = "__mandu_trace";
 
 const now = (): number => {
@@ -51,6 +64,52 @@ export function getTrace(ctx: ManduContext): TraceCollector | undefined {
   return ctx.get<TraceCollector>(TRACE_KEY);
 }
 
+/**
+ * Build a normalized trace report with durations
+ */
+export function buildTraceReport(collector: TraceCollector): TraceReport {
+  const entries: TraceReportEntry[] = [];
+  const errors: TraceEntry[] = [];
+  const stacks = new Map<string, TraceEntry[]>();
+
+  for (const record of collector.records) {
+    if (record.phase === "error") {
+      errors.push(record);
+      continue;
+    }
+
+    const key = `${record.event}:${record.name ?? ""}`;
+    if (record.phase === "begin") {
+      const stack = stacks.get(key) ?? [];
+      stack.push(record);
+      stacks.set(key, stack);
+      continue;
+    }
+
+    if (record.phase === "end") {
+      const stack = stacks.get(key);
+      const begin = stack?.pop();
+      if (!begin) continue;
+      entries.push({
+        event: record.event,
+        name: record.name,
+        start: begin.time,
+        end: record.time,
+        duration: record.time - begin.time,
+      });
+    }
+  }
+
+  return { entries, errors };
+}
+
+/**
+ * Convert trace report to JSON string
+ */
+export function formatTraceReport(report: TraceReport): string {
+  return JSON.stringify(report, null, 2);
+}
+
 export interface Tracer {
   enabled: boolean;
   begin: (event: TraceEvent, name?: string) => () => void;

package/src/filling/tmpclaude-2f8d-cwd

@@ -1 +0,0 @@
-/c/Users/LamySolution/workspace/mandu/packages/core/src/filling

package/src/filling/tmpclaude-2fc1-cwd

@@ -1 +0,0 @@
-/c/Users/LamySolution/workspace/mandu/packages/core/src/filling

package/src/filling/tmpclaude-59ee-cwd

@@ -1 +0,0 @@
-/c/Users/LamySolution/workspace/mandu/packages/core/src/filling

package/src/filling/tmpclaude-7608-cwd

@@ -1 +0,0 @@
-/c/Users/LamySolution/workspace/mandu/packages/core/src/filling

package/src/filling/tmpclaude-a102-cwd

@@ -1 +0,0 @@
-/c/Users/LamySolution/workspace/mandu/packages/core/src/filling

package/src/filling/tmpclaude-bf2c-cwd

@@ -1 +0,0 @@
-/c/Users/LamySolution/workspace/mandu/packages/core/src/filling

package/src/filling/tmpclaude-fb5a-cwd

@@ -1 +0,0 @@
-/c/Users/LamySolution/workspace/mandu/packages/core/src/filling

package/src/runtime/tmpclaude-1f31-cwd

@@ -1 +0,0 @@
-/c/Users/LamySolution/workspace/mandu/packages/core/src/runtime

package/src/runtime/tmpclaude-8527-cwd

@@ -1 +0,0 @@
-/c/Users/LamySolution/workspace/mandu/packages/core/src/runtime

package/src/runtime/tmpclaude-e62c-cwd

@@ -1 +0,0 @@
-/c/Users/LamySolution/workspace/mandu/packages/core/src/runtime