@mandujs/core 0.54.31 → 0.55.0-beta.1

package/src/client/hydrate.ts

@@ -16,8 +16,8 @@
  *   2. Unit tests can import it under happy-dom/JSDOM without triggering
  *      global mutation (no `document.querySelectorAll` on module eval).
  *
- * The bundled runtime entry (`client/runtime-entry.ts`)
- * delegates strategy selection to `scheduleHydration()` here — SSR emits the
+ * The bundled runtime entry (`client/runtime-entry.ts`)
+ * delegates strategy selection to `scheduleHydration()` here — SSR emits the
  * `data-hydrate` attribute, the runtime reads it and dispatches.
  *
  * Design contract:

package/src/client/index.ts

@@ -168,7 +168,7 @@ import { Link, NavLink } from "./Link";
 
 /**
  * Mandu Client namespace
- * v0.8.0: Hydration is handled automatically (runtime-entry)
+ * v0.8.0: Hydration is handled automatically (runtime-entry)
  * Note: Use `ManduClient` to avoid conflict with other Mandu exports
  */
 export const ManduClient = {

package/src/client/island.ts

@@ -3,9 +3,9 @@
  * Hydration을 위한 클라이언트 사이드 컴포넌트 정의
  */
 
-import type { ReactNode } from "react";
-import { serializeProps } from "./serialize";
-import { getServerData as getGlobalServerData } from "./window-state";
+import type { ReactNode } from "react";
+import { serializeProps } from "./serialize";
+import { getServerData as getGlobalServerData } from "./window-state";
 
 /**
  * Island 정의 타입
@@ -336,45 +336,45 @@ export interface PartialConfig {
 /**
  * Partial Island 정의 타입
  */
-export interface PartialDefinition<TProps> {
-  /** Partial 고유 ID. 기본값은 component displayName/name 입니다. */
-  id?: string;
-  /** Partial 컴포넌트 */
-  component: React.ComponentType<TProps>;
-  /** 초기 props (SSR에서 전달) */
-  initialProps?: TProps;
-  /** 하이드레이션 우선순위 */
-  priority?: "immediate" | "visible" | "idle" | "interaction";
-  /** 명시적 번들 URL. 기본값은 `/.mandu/client/{id}.partial.js` 입니다. */
-  src?: string;
-  /** 에러 시 표시할 UI */
-  errorBoundary?: (error: Error, reset: () => void) => ReactNode;
-  /** 로딩 중 표시할 UI */
-  loading?: () => ReactNode;
-}
+export interface PartialDefinition<TProps> {
+  /** Partial 고유 ID. 기본값은 component displayName/name 입니다. */
+  id?: string;
+  /** Partial 컴포넌트 */
+  component: React.ComponentType<TProps>;
+  /** 초기 props (SSR에서 전달) */
+  initialProps?: TProps;
+  /** 하이드레이션 우선순위 */
+  priority?: "immediate" | "visible" | "idle" | "interaction";
+  /** 명시적 번들 URL. 기본값은 `/.mandu/client/{id}.partial.js` 입니다. */
+  src?: string;
+  /** 에러 시 표시할 UI */
+  errorBoundary?: (error: Error, reset: () => void) => ReactNode;
+  /** 로딩 중 표시할 UI */
+  loading?: () => ReactNode;
+}
 
 /**
  * 컴파일된 Partial
  */
-export interface CompiledPartial<TProps> {
+export interface CompiledPartial<TProps> {
   /** Partial 정의 */
   definition: PartialDefinition<TProps>;
   /** Mandu Partial 마커 */
   __mandu_partial: true;
   /** Partial ID */
-  __mandu_partial_id?: string;
-}
-
-function normalizePartialId(id: string): string {
-  return id
-    .trim()
-    .replace(/[^A-Za-z0-9_-]/g, "-")
-    .replace(/^-+|-+$/g, "") || "partial";
-}
-
-function priorityToHydrate(priority: NonNullable<PartialDefinition<unknown>["priority"]>): string {
-  return priority === "immediate" ? "load" : priority;
-}
+  __mandu_partial_id?: string;
+}
+
+function normalizePartialId(id: string): string {
+  return id
+    .trim()
+    .replace(/[^A-Za-z0-9_-]/g, "-")
+    .replace(/^-+|-+$/g, "") || "partial";
+}
+
+function priorityToHydrate(priority: NonNullable<PartialDefinition<unknown>["priority"]>): string {
+  return priority === "immediate" ? "load" : priority;
+}
 
 /**
  * Partial Island 생성
@@ -399,56 +399,56 @@ function priorityToHydrate(priority: NonNullable<PartialDefinition<unknown>["pri
  * }
  * ```
  */
-export function partial<TProps extends Record<string, unknown>>(
-  definition: PartialDefinition<TProps>
-): CompiledPartial<TProps> & {
-  Render: React.ComponentType<TProps>;
-} {
+export function partial<TProps extends Record<string, unknown>>(
+  definition: PartialDefinition<TProps>
+): CompiledPartial<TProps> & {
+  Render: React.ComponentType<TProps>;
+} {
   if (!definition.component) {
     throw new Error("[Mandu Partial] component is required");
   }
 
-  const partialId = normalizePartialId(
-    definition.id ||
-    definition.component.displayName ||
-    definition.component.name ||
-    "partial",
-  );
-  const normalizedDefinition: PartialDefinition<TProps> = {
-    ...definition,
-    id: partialId,
-  };
-
-  const compiled: CompiledPartial<TProps> = {
-    definition: normalizedDefinition,
-    __mandu_partial: true,
-    __mandu_partial_id: partialId,
-  };
-
-  // Render 컴포넌트 생성
-  const React = require("react");
-
-  const RenderComponent: React.FC<TProps> = (props) => {
-    const renderProps = Object.keys(props).length > 0
-      ? props
-      : (normalizedDefinition.initialProps ?? props);
-    const priority = normalizedDefinition.priority ?? "visible";
-    const bundleSrc = normalizedDefinition.src ?? `/.mandu/client/${partialId}.partial.js`;
-
-    return React.createElement(
-      "div",
-      {
-        "data-mandu-island": partialId,
-        "data-mandu-partial": partialId,
-        "data-mandu-src": bundleSrc,
-        "data-mandu-priority": priority,
-        "data-hydrate": priorityToHydrate(priority),
-        "data-props": serializeProps(renderProps),
-        style: { display: "contents" },
-      },
-      React.createElement(normalizedDefinition.component, renderProps),
-    );
-  };
+  const partialId = normalizePartialId(
+    definition.id ||
+    definition.component.displayName ||
+    definition.component.name ||
+    "partial",
+  );
+  const normalizedDefinition: PartialDefinition<TProps> = {
+    ...definition,
+    id: partialId,
+  };
+
+  const compiled: CompiledPartial<TProps> = {
+    definition: normalizedDefinition,
+    __mandu_partial: true,
+    __mandu_partial_id: partialId,
+  };
+
+  // Render 컴포넌트 생성
+  const React = require("react");
+
+  const RenderComponent: React.FC<TProps> = (props) => {
+    const renderProps = Object.keys(props).length > 0
+      ? props
+      : (normalizedDefinition.initialProps ?? props);
+    const priority = normalizedDefinition.priority ?? "visible";
+    const bundleSrc = normalizedDefinition.src ?? `/.mandu/client/${partialId}.partial.js`;
+
+    return React.createElement(
+      "div",
+      {
+        "data-mandu-island": partialId,
+        "data-mandu-partial": partialId,
+        "data-mandu-src": bundleSrc,
+        "data-mandu-priority": priority,
+        "data-hydrate": priorityToHydrate(priority),
+        "data-props": serializeProps(renderProps),
+        style: { display: "contents" },
+      },
+      React.createElement(normalizedDefinition.component, renderProps),
+    );
+  };
 
   return Object.assign(compiled, { Render: RenderComponent });
 }

package/src/client/prefetch-helper.ts

@@ -1,55 +1,55 @@
-/**
- * Issue #192 — Hover prefetch helper
- *
- * Self-contained IIFE that watches `mouseover` events bubbling from
- * internal `<a href="/...">` anchors and issues a one-shot
- * `<link rel="prefetch" as="document">` per unique anchor. The browser
- * cache services the subsequent full-reload navigation, so most
- * above-the-fold links feel instantaneous without requiring a SPA
- * runtime.
- *
- * Design choices (locked to keep the payload tiny — target ≤500 bytes
- * minified + gzipped):
- *
- *   1. **WeakSet-based dedup**: we never attach per-anchor listeners;
- *      we use a single `document`-level capture listener and stamp
- *      each anchor we've seen into a `WeakSet`. Anchors removed from
- *      the DOM collect automatically.
- *
- *   2. **Scope: same-origin `/...` paths only**: we deliberately skip
- *      absolute URLs, `mailto:`, `tel:`, `javascript:`, hash-only
- *      fragments, and `#`-on-same-page links. The `a[href^="/"]`
- *      selector implicitly covers this and avoids a surprise
- *      cross-origin DNS lookup.
- *
- *   3. **Opt-out per-link via `data-no-prefetch`**: mirrors Next.js'
- *      `prefetch={false}` ergonomics while being framework-agnostic —
- *      works with plain `<a>` and with Mandu's `<Link>` component.
- *
- *   4. **`as="document"` hint**: the correct token for HTML documents
- *      that will be navigated to via a subsequent click. Without it
- *      Chrome 121+ logs a `rel=prefetch as=missing` warning.
- *
- *   5. **Capture phase + `passive: true`**: listening in the capture
- *      phase catches the event before any app-level bubble handlers
- *      can cancel it (defensive against apps that `stopPropagation`
- *      on `<a>`). `passive` ensures we can never accidentally block
- *      scroll.
- *
- *   6. **Inline, not external bundle**: the helper is under 1KB and
- *      emitting it as a `<script>` child (rather than
- *      `<script src=".../_prefetch.js">`) avoids one HTTP round-trip
- *      on every SSR response and keeps the module graph unchanged.
- *
- * The exported `PREFETCH_HELPER_SCRIPT` wraps the IIFE in a
- * `<script>` tag, ready to paste into `<head>`. Callers MUST keep it
- * nonce-aware if they plan to enable CSP (future work — right now the
- * Fast Refresh preamble is the only inline script covered by Mandu's
- * CSP header).
- */
-
-/** Inner IIFE — exposed for unit tests that want to parse the source. */
-export const PREFETCH_HELPER_BODY = `(function(){var s=new WeakSet();document.addEventListener("mouseover",function(e){var t=e.target;if(!t||typeof t.closest!=="function")return;var a=t.closest("a[href^='/']");if(!a||s.has(a))return;if(a.dataset&&a.dataset.noPrefetch!==undefined)return;if(a.hasAttribute&&a.hasAttribute("download"))return;if(a.target&&a.target!=="_self")return;s.add(a);try{var l=document.createElement("link");l.rel="prefetch";l.href=a.href;l.as="document";document.head.appendChild(l);}catch(_){}},{passive:true,capture:true});})();`;
-
-/** Ready-to-inject `<script>` tag for SSR `<head>` injection. */
-export const PREFETCH_HELPER_SCRIPT = `<script>${PREFETCH_HELPER_BODY}</script>`;
+/**
+ * Issue #192 — Hover prefetch helper
+ *
+ * Self-contained IIFE that watches `mouseover` events bubbling from
+ * internal `<a href="/...">` anchors and issues a one-shot
+ * `<link rel="prefetch" as="document">` per unique anchor. The browser
+ * cache services the subsequent full-reload navigation, so most
+ * above-the-fold links feel instantaneous without requiring a SPA
+ * runtime.
+ *
+ * Design choices (locked to keep the payload tiny — target ≤500 bytes
+ * minified + gzipped):
+ *
+ *   1. **WeakSet-based dedup**: we never attach per-anchor listeners;
+ *      we use a single `document`-level capture listener and stamp
+ *      each anchor we've seen into a `WeakSet`. Anchors removed from
+ *      the DOM collect automatically.
+ *
+ *   2. **Scope: same-origin `/...` paths only**: we deliberately skip
+ *      absolute URLs, `mailto:`, `tel:`, `javascript:`, hash-only
+ *      fragments, and `#`-on-same-page links. The `a[href^="/"]`
+ *      selector implicitly covers this and avoids a surprise
+ *      cross-origin DNS lookup.
+ *
+ *   3. **Opt-out per-link via `data-no-prefetch`**: mirrors Next.js'
+ *      `prefetch={false}` ergonomics while being framework-agnostic —
+ *      works with plain `<a>` and with Mandu's `<Link>` component.
+ *
+ *   4. **`as="document"` hint**: the correct token for HTML documents
+ *      that will be navigated to via a subsequent click. Without it
+ *      Chrome 121+ logs a `rel=prefetch as=missing` warning.
+ *
+ *   5. **Capture phase + `passive: true`**: listening in the capture
+ *      phase catches the event before any app-level bubble handlers
+ *      can cancel it (defensive against apps that `stopPropagation`
+ *      on `<a>`). `passive` ensures we can never accidentally block
+ *      scroll.
+ *
+ *   6. **Inline, not external bundle**: the helper is under 1KB and
+ *      emitting it as a `<script>` child (rather than
+ *      `<script src=".../_prefetch.js">`) avoids one HTTP round-trip
+ *      on every SSR response and keeps the module graph unchanged.
+ *
+ * The exported `PREFETCH_HELPER_SCRIPT` wraps the IIFE in a
+ * `<script>` tag, ready to paste into `<head>`. Callers MUST keep it
+ * nonce-aware if they plan to enable CSP (future work — right now the
+ * Fast Refresh preamble is the only inline script covered by Mandu's
+ * CSP header).
+ */
+
+/** Inner IIFE — exposed for unit tests that want to parse the source. */
+export const PREFETCH_HELPER_BODY = `(function(){var s=new WeakSet();document.addEventListener("mouseover",function(e){var t=e.target;if(!t||typeof t.closest!=="function")return;var a=t.closest("a[href^='/']");if(!a||s.has(a))return;if(a.dataset&&a.dataset.noPrefetch!==undefined)return;if(a.hasAttribute&&a.hasAttribute("download"))return;if(a.target&&a.target!=="_self")return;s.add(a);try{var l=document.createElement("link");l.rel="prefetch";l.href=a.href;l.as="document";document.head.appendChild(l);}catch(_){}},{passive:true,capture:true});})();`;
+
+/** Ready-to-inject `<script>` tag for SSR `<head>` injection. */
+export const PREFETCH_HELPER_SCRIPT = `<script>${PREFETCH_HELPER_BODY}</script>`;