@mandujs/core 0.18.22 → 0.19.2

package/README.ko.md

@@ -55,19 +55,6 @@ if (result.success && result.data) {
 }
 ```
 
-### Lock 파일
-
-```typescript
-import { writeLock, readLock } from "@mandujs/core";
-
-// lock 파일 쓰기
-const lock = await writeLock(".mandu/spec.lock.json", manifest);
-console.log(lock.routesHash);
-
-// lock 파일 읽기
-const existing = await readLock(".mandu/spec.lock.json");
-```
-
 ## Generator 모듈
 
 Spec 기반 코드 생성.
@@ -132,7 +119,6 @@ if (!result.passed) {
 
 | 규칙 ID | 설명 | 자동 수정 |
 |---------|------|----------|
-| `SPEC_HASH_MISMATCH` | spec과 lock 해시 불일치 | ✅ |
 | `GENERATED_MANUAL_EDIT` | generated 파일 수동 수정 | ✅ |
 | `HANDLER_NOT_FOUND` | 핸들러 파일 없음 | ❌ |
 | `COMPONENT_NOT_FOUND` | 컴포넌트 파일 없음 | ❌ |

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mandujs/core",
-  "version": "0.18.22",
+  "version": "0.19.2",
   "description": "Mandu Framework Core - Spec, Generator, Guard, Runtime",
   "type": "module",
   "main": "./src/index.ts",
@@ -8,8 +8,11 @@
   "exports": {
     ".": "./src/index.ts",
     "./client": "./src/client/index.ts",
+    "./middleware": "./src/middleware/index.ts",
+    "./testing": "./src/testing/index.ts",
     "./plugins": "./src/plugins/index.ts",
     "./error": "./src/error/index.ts",
+    "./bundler/prerender": "./src/bundler/prerender.ts",
     "./*": "./src/*"
   },
   "files": [

package/src/brain/architecture/analyzer.ts

@@ -34,7 +34,7 @@ export const DEFAULT_ARCHITECTURE_CONFIG: ArchitectureConfig = {
     "spec/slots/": {
       pattern: "spec/slots/**",
       description: "Slot 파일 전용",
-      allowedFiles: ["*.slot.ts", "*.client.ts"],
+      allowedFiles: ["*.slot.ts", "*.slot.tsx", "*.client.ts", "*.client.tsx"],
     },
     "spec/contracts/": {
       pattern: "spec/contracts/**",
@@ -96,9 +96,9 @@ export const DEFAULT_ARCHITECTURE_CONFIG: ArchitectureConfig = {
   naming: [
     {
       folder: "spec/slots/",
-      filePattern: "^[a-z][a-z0-9-]*\\.(slot|client)\\.ts$",
-      description: "Slot 파일은 kebab-case.slot.ts 또는 kebab-case.client.ts",
-      examples: ["users-list.slot.ts", "counter.client.ts"],
+      filePattern: "^[a-z][a-z0-9-]*\\.(slot|client)\\.tsx?$",
+      description: "Slot 파일은 kebab-case.slot.ts(x) 또는 kebab-case.client.ts(x)",
+      examples: ["users-list.slot.ts", "counter.client.tsx"],
     },
     {
       folder: "spec/contracts/",

package/src/brain/doctor/analyzer.ts

@@ -25,7 +25,7 @@ export type ViolationCategory =
  * Categorize a violation by its rule ID
  */
 export function categorizeViolation(ruleId: string): ViolationCategory {
-  if (ruleId.includes("SPEC") || ruleId === "SPEC_HASH_MISMATCH") {
+  if (ruleId.includes("SPEC")) {
     return "spec";
   }
   if (ruleId.includes("GENERATED") || ruleId.includes("FORBIDDEN_IMPORT")) {
@@ -138,16 +138,6 @@ export function generateTemplatePatches(
 
   for (const violation of violations) {
     switch (violation.ruleId) {
-      case GUARD_RULES.SPEC_HASH_MISMATCH?.id:
-        patches.push({
-          file: ".mandu/spec.lock.json",
-          description: "Spec lock 파일 갱신",
-          type: "command",
-          command: "bunx mandu spec-upsert",
-          confidence: 0.9,
-        });
-        break;
-
       case GUARD_RULES.GENERATED_MANUAL_EDIT?.id:
         patches.push({
           file: violation.file,
@@ -208,6 +198,23 @@ export function generateTemplatePatches(
         });
         break;
 
+      case GUARD_RULES.ISLAND_FIRST_INTEGRITY?.id:
+        patches.push({
+          file: violation.file,
+          description:
+            "Create a .island.tsx file in the same app/ directory as page.tsx. " +
+            "Do NOT import or re-export the island in page.tsx — island() returns " +
+            "a config object, not a React component. Use data-island attributes instead.",
+          type: "modify",
+          content:
+            `// Example: app/my-feature.island.tsx\n` +
+            `import { island } from "@mandujs/core/client";\n\n` +
+            `export default island("visible", MyComponent);\n\n` +
+            `// In page.tsx, reference via: <div data-island="my-feature">...</div>`,
+          confidence: 0.9,
+        });
+        break;
+
       default:
         // Generic suggestion based on violation.suggestion
         if (violation.suggestion) {
@@ -307,9 +314,6 @@ export async function analyzeViolations(
 
   // Determine recommended next command
   let nextCommand = "bunx mandu generate";
-  if (violations.some((v) => v.ruleId === GUARD_RULES.SPEC_HASH_MISMATCH?.id)) {
-    nextCommand = "bunx mandu spec-upsert";
-  }
 
   // If LLM is not requested or not available, return template analysis
   if (!useLLM) {

package/src/bundler/build.test.ts

@@ -0,0 +1,127 @@
+import { afterAll, beforeAll, describe, expect, test } from "bun:test";
+import { mkdtemp, mkdir, readFile, rm, writeFile } from "fs/promises";
+import path from "path";
+import { pathToFileURL } from "url";
+import type { RoutesManifest } from "../spec/schema";
+import type { BundleResult } from "./types";
+import { buildClientBundles } from "./build";
+
+// 모든 테스트가 하나의 빌드 결과를 공유 — 병렬 Bun.build 충돌 방지
+let rootDir: string;
+let result: BundleResult;
+
+async function importBuiltModule(relativePath: string): Promise<Record<string, unknown>> {
+  const fileUrl = pathToFileURL(path.join(rootDir, relativePath)).href;
+  return import(`${fileUrl}?t=${Date.now()}`);
+}
+
+beforeAll(async () => {
+  rootDir = await mkdtemp(path.join(import.meta.dir, ".tmp-bundler-"));
+
+  await mkdir(path.join(rootDir, "app"), { recursive: true });
+  await writeFile(
+    path.join(rootDir, "package.json"),
+    JSON.stringify({ name: "mandu-build-test", type: "module" }, null, 2),
+    "utf-8",
+  );
+  await writeFile(
+    path.join(rootDir, "app", "demo.client.tsx"),
+    "export default function DemoIsland() { return null; }\n",
+    "utf-8",
+  );
+
+  const manifest: RoutesManifest = {
+    version: 1,
+    routes: [
+      {
+        id: "demo",
+        kind: "page",
+        pattern: "/",
+        module: "app/page.tsx",
+        componentModule: "app/page.tsx",
+        clientModule: "app/demo.client.tsx",
+        hydration: {
+          strategy: "island",
+          priority: "visible",
+          preload: false,
+        },
+      },
+    ],
+  };
+
+  result = await buildClientBundles(manifest, rootDir, {
+    minify: false,
+    sourcemap: false,
+    splitting: false,
+  });
+});
+
+afterAll(async () => {
+  if (rootDir) {
+    await rm(rootDir, { recursive: true, force: true });
+  }
+});
+
+describe("buildClientBundles vendor shims", () => {
+  test("build succeeds", () => {
+    if (!result.success) {
+      console.error("[build.test] errors:", result.errors);
+    }
+    expect(result.success).toBe(true);
+  });
+
+  test("re-exports modern React 19 APIs used by islands", async () => {
+    const reactShim = await importBuiltModule(".mandu/client/_react.js");
+    const requiredExports = [
+      "Activity",
+      "__COMPILER_RUNTIME",
+      "cache",
+      "cacheSignal",
+      "startTransition",
+      "use",
+      "useActionState",
+      "useEffectEvent",
+      "useOptimistic",
+      "unstable_useCacheRefresh",
+    ];
+
+    for (const exportName of requiredExports) {
+      expect(exportName in reactShim).toBe(true);
+    }
+  });
+
+  test("re-exports modern react-dom and react-dom/client APIs", async () => {
+    const reactDomShim = await importBuiltModule(".mandu/client/_react-dom.js");
+    for (const exportName of [
+      "preconnect",
+      "prefetchDNS",
+      "preinit",
+      "preinitModule",
+      "preload",
+      "preloadModule",
+      "requestFormReset",
+      "unstable_batchedUpdates",
+      "useFormState",
+      "useFormStatus",
+    ]) {
+      expect(exportName in reactDomShim).toBe(true);
+    }
+
+    const reactDomClientShim = await importBuiltModule(".mandu/client/_react-dom-client.js");
+    for (const exportName of ["createRoot", "hydrateRoot", "version"]) {
+      expect(exportName in reactDomClientShim).toBe(true);
+    }
+  });
+
+  test("embeds hydration guards for deferred trigger strategies", async () => {
+    const runtimeSource = await readFile(path.join(rootDir, ".mandu", "client", "_runtime.js"), "utf-8");
+    expect(runtimeSource).toContain("function resolveHydrationTarget");
+    expect(runtimeSource).toContain("function hasHydratableMarkup");
+    expect(runtimeSource).toContain("function shouldHydrateCompiledIsland");
+    expect(runtimeSource).toContain("onRecoverableError");
+    expect(runtimeSource).toContain("data-mandu-hydrating");
+    expect(runtimeSource).toContain("data-mandu-render-mode");
+    expect(runtimeSource).toContain("data-mandu-recoverable-error");
+    expect(runtimeSource).toContain("pointerdown");
+  });
+});