@mandujs/core 0.8.0 → 0.8.2

package/README.md

@@ -1,200 +1,200 @@
-<p align="center">
-  <img src="https://raw.githubusercontent.com/konamgil/mandu/main/mandu_only_simbol.png" alt="Mandu" width="200" />
-</p>
-
-<h1 align="center">@mandujs/core</h1>
-
-<p align="center">
-  <strong>Mandu Framework Core</strong><br/>
-  Spec, Generator, Guard, Runtime, Filling
-</p>
-
-<p align="center">
-  English | <a href="./README.ko.md"><strong>한국어</strong></a>
-</p>
-
-## Installation
-
-```bash
-bun add @mandujs/core
-```
-
-> Typically used through `@mandujs/cli`. Direct usage is for advanced use cases.
-
-## Module Structure
-
-```
-@mandujs/core
-├── spec/      # Spec schema and loading
-├── generator/ # Code generation
-├── guard/     # Architecture checking and auto-correction
-├── runtime/   # Server and router
-└── report/    # Guard report generation
-```
-
-## Spec Module
-
-Route manifest schema definition and loading.
-
-```typescript
-import { loadManifest, RoutesManifest, RouteSpec } from "@mandujs/core";
-
-// Load and validate manifest
-const result = await loadManifest("spec/routes.manifest.json");
-
-if (result.success && result.data) {
-  const manifest: RoutesManifest = result.data;
-  manifest.routes.forEach((route: RouteSpec) => {
-    console.log(route.id, route.pattern, route.kind);
-  });
-}
-```
-
-### Lock File
-
-```typescript
-import { writeLock, readLock } from "@mandujs/core";
-
-// Write lock file
-const lock = await writeLock("spec/spec.lock.json", manifest);
-console.log(lock.routesHash);
-
-// Read lock file
-const existing = await readLock("spec/spec.lock.json");
-```
-
-## Generator Module
-
-Spec-based code generation.
-
-```typescript
-import { generateRoutes, GenerateResult } from "@mandujs/core";
-
-const result: GenerateResult = await generateRoutes(manifest, "./");
-
-console.log("Created:", result.created);
-console.log("Skipped:", result.skipped);  // Existing slot files
-```
-
-### Template Functions
-
-```typescript
-import {
-  generateApiHandler,
-  generateApiHandlerWithSlot,
-  generateSlotLogic,
-  generatePageComponent
-} from "@mandujs/core";
-
-// Generate API handler
-const code = generateApiHandler(route);
-
-// API handler with slot
-const codeWithSlot = generateApiHandlerWithSlot(route);
-
-// Slot logic file
-const slotCode = generateSlotLogic(route);
-```
-
-## Guard Module
-
-Architecture rule checking and auto-correction.
-
-```typescript
-import {
-  runGuardCheck,
-  runAutoCorrect,
-  GuardResult,
-  GuardViolation
-} from "@mandujs/core";
-
-// Run check
-const result: GuardResult = await runGuardCheck(manifest, "./");
-
-if (!result.passed) {
-  result.violations.forEach((v: GuardViolation) => {
-    console.log(`${v.rule}: ${v.message}`);
-  });
-
-  // Run auto-correction
-  const corrected = await runAutoCorrect(result.violations, manifest, "./");
-  console.log("Fixed:", corrected.steps);
-  console.log("Remaining violations:", corrected.remainingViolations);
-}
-```
-
-### Guard Rules
-
-| Rule ID | Description | Auto-correctable |
-|---------|-------------|------------------|
-| `SPEC_HASH_MISMATCH` | Spec and lock hash mismatch | ✅ |
-| `GENERATED_MANUAL_EDIT` | Manual edit to generated file | ✅ |
-| `HANDLER_NOT_FOUND` | Handler file not found | ❌ |
-| `COMPONENT_NOT_FOUND` | Component file not found | ❌ |
-| `SLOT_NOT_FOUND` | Slot file not found | ✅ |
-
-## Runtime Module
-
-Server startup and routing.
-
-```typescript
-import {
-  startServer,
-  registerApiHandler,
-  registerPageLoader
-} from "@mandujs/core";
-
-// Register API handler
-registerApiHandler("getUsers", async (req) => {
-  return { users: [] };
-});
-
-// Register page loader
-registerPageLoader("homePage", () => import("./pages/Home"));
-
-// Start server
-const server = startServer(manifest, { port: 3000 });
-
-// Stop
-server.stop();
-```
-
-## Report Module
-
-Guard result report generation.
-
-```typescript
-import { buildGuardReport } from "@mandujs/core";
-
-const report = buildGuardReport(guardResult, lockPath);
-console.log(report);  // Formatted text report
-```
-
-## Types
-
-```typescript
-import type {
-  RoutesManifest,
-  RouteSpec,
-  RouteKind,
-  SpecLock,
-  GuardResult,
-  GuardViolation,
-  GenerateResult,
-  AutoCorrectResult,
-} from "@mandujs/core";
-```
-
-## Requirements
-
-- Bun >= 1.0.0
-- React >= 18.0.0
-- Zod >= 3.0.0
-
-## Related Packages
-
-- [@mandujs/cli](https://www.npmjs.com/package/@mandujs/cli) - CLI tool
-
-## License
-
-MIT
+<p align="center">
+  <img src="https://raw.githubusercontent.com/konamgil/mandu/main/mandu_only_simbol.png" alt="Mandu" width="200" />
+</p>
+
+<h1 align="center">@mandujs/core</h1>
+
+<p align="center">
+  <strong>Mandu Framework Core</strong><br/>
+  Spec, Generator, Guard, Runtime, Filling
+</p>
+
+<p align="center">
+  English | <a href="./README.ko.md"><strong>한국어</strong></a>
+</p>
+
+## Installation
+
+```bash
+bun add @mandujs/core
+```
+
+> Typically used through `@mandujs/cli`. Direct usage is for advanced use cases.
+
+## Module Structure
+
+```
+@mandujs/core
+├── spec/      # Spec schema and loading
+├── generator/ # Code generation
+├── guard/     # Architecture checking and auto-correction
+├── runtime/   # Server and router
+└── report/    # Guard report generation
+```
+
+## Spec Module
+
+Route manifest schema definition and loading.
+
+```typescript
+import { loadManifest, RoutesManifest, RouteSpec } from "@mandujs/core";
+
+// Load and validate manifest
+const result = await loadManifest("spec/routes.manifest.json");
+
+if (result.success && result.data) {
+  const manifest: RoutesManifest = result.data;
+  manifest.routes.forEach((route: RouteSpec) => {
+    console.log(route.id, route.pattern, route.kind);
+  });
+}
+```
+
+### Lock File
+
+```typescript
+import { writeLock, readLock } from "@mandujs/core";
+
+// Write lock file
+const lock = await writeLock("spec/spec.lock.json", manifest);
+console.log(lock.routesHash);
+
+// Read lock file
+const existing = await readLock("spec/spec.lock.json");
+```
+
+## Generator Module
+
+Spec-based code generation.
+
+```typescript
+import { generateRoutes, GenerateResult } from "@mandujs/core";
+
+const result: GenerateResult = await generateRoutes(manifest, "./");
+
+console.log("Created:", result.created);
+console.log("Skipped:", result.skipped);  // Existing slot files
+```
+
+### Template Functions
+
+```typescript
+import {
+  generateApiHandler,
+  generateApiHandlerWithSlot,
+  generateSlotLogic,
+  generatePageComponent
+} from "@mandujs/core";
+
+// Generate API handler
+const code = generateApiHandler(route);
+
+// API handler with slot
+const codeWithSlot = generateApiHandlerWithSlot(route);
+
+// Slot logic file
+const slotCode = generateSlotLogic(route);
+```
+
+## Guard Module
+
+Architecture rule checking and auto-correction.
+
+```typescript
+import {
+  runGuardCheck,
+  runAutoCorrect,
+  GuardResult,
+  GuardViolation
+} from "@mandujs/core";
+
+// Run check
+const result: GuardResult = await runGuardCheck(manifest, "./");
+
+if (!result.passed) {
+  result.violations.forEach((v: GuardViolation) => {
+    console.log(`${v.rule}: ${v.message}`);
+  });
+
+  // Run auto-correction
+  const corrected = await runAutoCorrect(result.violations, manifest, "./");
+  console.log("Fixed:", corrected.steps);
+  console.log("Remaining violations:", corrected.remainingViolations);
+}
+```
+
+### Guard Rules
+
+| Rule ID | Description | Auto-correctable |
+|---------|-------------|------------------|
+| `SPEC_HASH_MISMATCH` | Spec and lock hash mismatch | ✅ |
+| `GENERATED_MANUAL_EDIT` | Manual edit to generated file | ✅ |
+| `HANDLER_NOT_FOUND` | Handler file not found | ❌ |
+| `COMPONENT_NOT_FOUND` | Component file not found | ❌ |
+| `SLOT_NOT_FOUND` | Slot file not found | ✅ |
+
+## Runtime Module
+
+Server startup and routing.
+
+```typescript
+import {
+  startServer,
+  registerApiHandler,
+  registerPageLoader
+} from "@mandujs/core";
+
+// Register API handler
+registerApiHandler("getUsers", async (req) => {
+  return { users: [] };
+});
+
+// Register page loader
+registerPageLoader("homePage", () => import("./pages/Home"));
+
+// Start server
+const server = startServer(manifest, { port: 3000 });
+
+// Stop
+server.stop();
+```
+
+## Report Module
+
+Guard result report generation.
+
+```typescript
+import { buildGuardReport } from "@mandujs/core";
+
+const report = buildGuardReport(guardResult, lockPath);
+console.log(report);  // Formatted text report
+```
+
+## Types
+
+```typescript
+import type {
+  RoutesManifest,
+  RouteSpec,
+  RouteKind,
+  SpecLock,
+  GuardResult,
+  GuardViolation,
+  GenerateResult,
+  AutoCorrectResult,
+} from "@mandujs/core";
+```
+
+## Requirements
+
+- Bun >= 1.0.0
+- React >= 18.0.0
+- Zod >= 3.0.0
+
+## Related Packages
+
+- [@mandujs/cli](https://www.npmjs.com/package/@mandujs/cli) - CLI tool
+
+## License
+
+MIT

package/package.json

@@ -1,41 +1,41 @@
-{
-  "name": "@mandujs/core",
-  "version": "0.8.0",
-  "description": "Mandu Framework Core - Spec, Generator, Guard, Runtime",
-  "type": "module",
-  "main": "./src/index.ts",
-  "types": "./src/index.ts",
-  "exports": {
-    ".": "./src/index.ts",
-    "./client": "./src/client/index.ts",
-    "./*": "./src/*"
-  },
-  "files": [
-    "src/**/*"
-  ],
-  "keywords": [
-    "mandu",
-    "framework",
-    "agent",
-    "ai",
-    "code-generation"
-  ],
-  "repository": {
-    "type": "git",
-    "url": "git+https://github.com/konamgil/mandu.git",
-    "directory": "packages/core"
-  },
-  "author": "konamgil",
-  "license": "MIT",
-  "publishConfig": {
-    "access": "public"
-  },
-  "engines": {
-    "bun": ">=1.0.0"
-  },
-  "peerDependencies": {
-    "react": ">=18.0.0",
-    "react-dom": ">=18.0.0",
-    "zod": ">=3.0.0"
-  }
-}
+{
+  "name": "@mandujs/core",
+  "version": "0.8.2",
+  "description": "Mandu Framework Core - Spec, Generator, Guard, Runtime",
+  "type": "module",
+  "main": "./src/index.ts",
+  "types": "./src/index.ts",
+  "exports": {
+    ".": "./src/index.ts",
+    "./client": "./src/client/index.ts",
+    "./*": "./src/*"
+  },
+  "files": [
+    "src/**/*"
+  ],
+  "keywords": [
+    "mandu",
+    "framework",
+    "agent",
+    "ai",
+    "code-generation"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/konamgil/mandu.git",
+    "directory": "packages/core"
+  },
+  "author": "konamgil",
+  "license": "MIT",
+  "publishConfig": {
+    "access": "public"
+  },
+  "engines": {
+    "bun": ">=1.0.0"
+  },
+  "peerDependencies": {
+    "react": ">=18.0.0",
+    "react-dom": ">=18.0.0",
+    "zod": ">=3.0.0"
+  }
+}

package/src/bundler/build.ts

@@ -62,6 +62,10 @@ function generateRuntimeSource(): string {
  * Fresh-style dynamic import architecture
  */
 
+// React 정적 import (Island와 같은 인스턴스 공유)
+import React from 'react';
+import { createRoot } from 'react-dom/client';
+
 // Hydrated roots 추적 (unmount용)
 const hydratedRoots = new Map();
 
@@ -134,17 +138,13 @@ async function loadAndHydrate(element, src) {
     const { definition } = island;
     const data = getServerData(id);
 
-    // React 동적 로드
-    const { createRoot } = await import('react-dom/client');
-    const React = await import('react');
-
-    // Island 컴포넌트
+    // Island 컴포넌트 (정적 import된 React 사용)
     function IslandComponent() {
       const setupResult = definition.setup(data);
       return definition.render(setupResult);
     }
 
-    // Mount
+    // Mount (상단에서 import한 createRoot 사용)
     const root = createRoot(element);
     root.render(React.createElement(IslandComponent));
     hydratedRoots.set(id, root);
@@ -262,6 +262,13 @@ import React, {
   Children,
 } from 'react';
 
+// JSX Runtime functions (JSX 변환에 필요)
+import { jsx, jsxs } from 'react/jsx-runtime';
+import { jsxDEV } from 'react/jsx-dev-runtime';
+
+// React internals (ReactDOM이 내부적으로 접근 필요)
+const __SECRET_INTERNALS_DO_NOT_USE_OR_YOU_WILL_BE_FIRED = React.__SECRET_INTERNALS_DO_NOT_USE_OR_YOU_WILL_BE_FIRED;
+
 // Named exports
 export {
   createElement,
@@ -294,6 +301,11 @@ export {
   Component,
   PureComponent,
   Children,
+  __SECRET_INTERNALS_DO_NOT_USE_OR_YOU_WILL_BE_FIRED,
+  // JSX Runtime exports
+  jsx,
+  jsxs,
+  jsxDEV,
 };
 
 // Default export
@@ -364,8 +376,9 @@ function generateJsxRuntimeShimSource(): string {
 /**
  * Mandu JSX Runtime Shim (Generated)
  * Production JSX 변환용
+ * 순환 참조 방지: 'react'에서 import (import map이 _react.js로 매핑)
  */
-import { jsx, jsxs, Fragment } from 'react/jsx-runtime';
+import { jsx, jsxs, Fragment } from 'react';
 
 // Named exports
 export { jsx, jsxs, Fragment };
@@ -384,8 +397,9 @@ function generateJsxDevRuntimeShimSource(): string {
 /**
  * Mandu JSX Dev Runtime Shim (Generated)
  * Development JSX 변환용
+ * 순환 참조 방지: 'react'에서 import (import map이 _react.js로 매핑)
  */
-import { jsxDEV, Fragment } from 'react/jsx-dev-runtime';
+import { jsxDEV, Fragment } from 'react';
 
 // Named exports
 export { jsxDEV, Fragment };
@@ -733,6 +747,19 @@ async function buildVendorShims(
     try {
       await Bun.write(srcPath, shim.source);
 
+      // _react.js와 jsx-runtime들은 완전히 번들링 (external 없음)
+      // _react-dom*, jsx-runtime은 react를 external로 처리하여 동일한 React 인스턴스 공유
+      // jsx-runtime은 Fragment를 react에서 가져오므로 react만 external
+      let shimExternal: string[] = [];
+      if (shim.name === "_react-dom" || shim.name === "_react-dom-client") {
+        shimExternal = ["react"];
+      } else if (shim.name === "_jsx-runtime" || shim.name === "_jsx-dev-runtime") {
+        // jsx-runtime은 react를 external로 (Fragment 때문에),
+        // 하지만 react/jsx-runtime은 번들링되어야 함
+        shimExternal = ["react"];
+      }
+      // _react.js는 external 없이 React 전체를 번들링
+
       const result = await Bun.build({
         entrypoints: [srcPath],
         outdir: outDir,
@@ -740,6 +767,7 @@ async function buildVendorShims(
         minify: options.minify ?? process.env.NODE_ENV === "production",
         sourcemap: options.sourcemap ? "external" : "none",
         target: "browser",
+        external: shimExternal,
         define: {
           "process.env.NODE_ENV": JSON.stringify(process.env.NODE_ENV || "development"),
           ...options.define,