pubuilder 0.4.0 → 0.6.0

package/CHANGELOG.md

@@ -0,0 +1,73 @@
+# Changelog
+
+이 프로젝트의 주요 변경 사항을 기록합니다.
+형식은 [Keep a Changelog](https://keepachangelog.com/ko/1.1.0/)를 따르며,
+버전은 [Semantic Versioning](https://semver.org/lang/ko/)을 따릅니다.
+(0.x 단계이므로 breaking change는 minor 버전으로 올립니다.)
+
+## [0.6.0] - 2026-07-15
+
+### Added
+
+- **퍼블리싱 완료 후 AI 후속 답변(이어가기)** — 퍼블리싱이 끝난 뒤 AI에게 후속 지시를
+  보내 중단·확인 대기 중인 작업을 현재 작업 트리에서 이어서 완료하도록 함
+  (완료 상태의 답변 textarea, ⌘/Ctrl+Enter 전송).
+
+### Changed
+
+- **스킬함 진입점을 퍼블리싱 패널로 이동** — 미니맵/뷰어 헤더의 🧰 스킬함 버튼을
+  제거하고 퍼블리싱 패널 상단으로 옮김.
+- 스킬함 드로어 UI 개편 — 안내문, 섹션 헤더(Figma 연결 / AI 작업 스킬),
+  상태 배지, 스킬 소스 설명 추가.
+
+## [0.5.0] - 2026-07-15
+
+### ⚠️ Breaking Changes
+
+- `defineIA` 헬퍼의 import 경로가 `pubuilder`에서 **`pubuilder/config`**로 바뀌었습니다.
+  `"use client"` React 번들 없이 config만 로드할 수 있도록 별도 서브패스 export로 분리했습니다.
+
+  ```diff
+  - import { defineIA } from 'pubuilder'
+  + import { defineIA } from 'pubuilder/config'
+  ```
+
+  `pubuilder scan`이 생성하는 `ia.config.ts` 템플릿도 새 경로를 사용합니다.
+
+### Fixed
+
+- 에이전트 spawn 시 `--setting-sources`를 격리해 스킬 화이트리스트가 실효성을 갖도록 수정.
+- 컴패니언 서버: 종료 잡 상한 유지, publish 요청 바디 검증, 캐시 파일명 정규화.
+
+### Changed
+
+- 상대경로 import에 `.js` 확장자를 명시(NodeNext ESM 해석).
+- 데모(playground)를 음악 플랫폼(wavbor)에서 AI 에이전트 플랫폼(NIMBUS)으로 교체.
+
+## [0.4.0] - 2026-07-14
+
+### Added
+
+- **AI 퍼블리싱 기능** — 미니맵에서 Figma 시안을 코드로 퍼블리싱하는 워크플로우.
+  - 컴패니언 HTTP 서버: 스킬 레지스트리(스캔/토글/업로드/삭제), Figma 토큰 로드·저장,
+    Figma 노드 JSON·PNG fetch, 퍼블리싱 잡 매니저, SSE 로그 스트리밍.
+  - 퍼블리싱 패널 UI: Figma URL 입력·실행·SSE 로그·중단.
+  - 스킬함 드로어: 스킬 목록/토글/업로드/삭제, 토큰 설정.
+  - CLI `serve`/`dev` 서브커맨드 — 컴패니언 서버 기동 및 dev 래퍼.
+
+### Changed
+
+- 패키지명을 `pubmap`에서 **`pubuilder`**로 전면 개명(npm이 `pubmap`을 거부).
+
+## [0.3.0] - 2026-07-13
+
+### Added
+
+- 최초 npm 공개 배포.
+- `pubuilder scan` CLI — Next.js 라우트를 스캔해 `ia.config.ts` 생성/병합.
+- `PageMap` 미니맵 컴포넌트 — 화면설계서(IA) 기반 페이지 트리를 iframe 썸네일로 렌더링.
+
+[0.6.0]: https://www.npmjs.com/package/pubuilder/v/0.6.0
+[0.5.0]: https://www.npmjs.com/package/pubuilder/v/0.5.0
+[0.4.0]: https://www.npmjs.com/package/pubuilder/v/0.4.0
+[0.3.0]: https://www.npmjs.com/package/pubuilder/v/0.3.0

package/README.md

@@ -42,7 +42,7 @@ npx pubuilder scan --dry-run  # preview without writing
 
 ```ts
 // ia.config.ts
-import { defineIA } from 'pubuilder'
+import { defineIA } from 'pubuilder/config'
 
 export default defineIA({
   pages: [
@@ -57,7 +57,7 @@ export default defineIA({
           // screens that differ by query string become child nodes
           variants: [
             { title: 'All', query: { category: 'all' } },
-            { title: 'Art', query: { category: 'art', tab: 1 } },
+            { title: 'Coding', query: { category: 'coding', tab: 1 } },
           ],
         },
         { path: 'https://example.com/brand', title: 'Brand', external: true },

package/dist/api.d.ts

@@ -36,6 +36,7 @@ export declare class PubuilderApi {
         selection: BlockSelection;
         outerHTML: string;
         figmaUrl: string;
+        instruction?: string;
     }): Promise<{
         jobId: string;
     }>;

package/dist/cli.js

@@ -1,5 +1,5 @@
 #!/usr/bin/env node
-import { readFileSync as O, existsSync as v, readdirSync as D, mkdirSync as j, writeFileSync as R, rmSync as W, realpathSync as nt } from "node:fs";
+import { readFileSync as R, existsSync as P, readdirSync as D, mkdirSync as j, writeFileSync as N, rmSync as W, realpathSync as nt } from "node:fs";
 import { join as f } from "node:path";
 import { fileURLToPath as ot } from "node:url";
 import { createJiti as rt } from "jiti";
@@ -15,7 +15,7 @@ function ut(n, t) {
   const e = n.indexOf("#"), o = e >= 0 ? n.slice(e) : "", r = e >= 0 ? n.slice(0, e) : n, s = r.indexOf("?"), a = s >= 0 ? r.slice(0, s) : r, i = new URLSearchParams(s >= 0 ? r.slice(s + 1) : "");
   for (const [p, g] of Object.entries(t.query))
     if (i.delete(p), Array.isArray(g))
-      for (const w of g) L(i, p, w);
+      for (const $ of g) L(i, p, $);
     else
       L(i, p, g);
   const h = i.toString();
@@ -57,46 +57,46 @@ function M(n) {
   if (o(n.pages, null, 0), t.length === 0) throw new Error("[pubuilder] pages가 비어 있습니다");
   return { nodes: t, viewport: n.viewport ?? lt };
 }
-const P = "  ";
+const v = "  ";
 function pt(n) {
   return n.split("/").map((t) => /^\[{1,2}\.{0,3}.*\]{1,2}$/.test(t) && t.startsWith("[") ? "1" : t).join("/");
 }
-function A(n) {
+function O(n) {
   return JSON.stringify(n);
 }
 function Z(n, t, e) {
-  const o = P.repeat(t), r = [];
+  const o = v.repeat(t), r = [];
   n.path.includes("[") && r.push(`${o}// TODO: 샘플 경로로 교체 (예: ${pt(n.path)})`);
   const s = e.has(n.path) ? " // TODO: title 확인" : "";
   if (!n.children?.length && !n.variants?.length && !n.external)
-    return r.push(`${o}{ path: ${A(n.path)}, title: ${A(n.title)} },${s}`), r;
-  if (r.push(`${o}{`), r.push(`${o}${P}path: ${A(n.path)},`), r.push(`${o}${P}title: ${A(n.title)},${s}`), n.external && r.push(`${o}${P}external: true,`), n.variants?.length) {
-    r.push(`${o}${P}variants: [`);
+    return r.push(`${o}{ path: ${O(n.path)}, title: ${O(n.title)} },${s}`), r;
+  if (r.push(`${o}{`), r.push(`${o}${v}path: ${O(n.path)},`), r.push(`${o}${v}title: ${O(n.title)},${s}`), n.external && r.push(`${o}${v}external: true,`), n.variants?.length) {
+    r.push(`${o}${v}variants: [`);
     for (const i of n.variants)
       r.push(
-        `${o}${P}${P}{ title: ${A(i.title)}, query: ${A(i.query)} },`
+        `${o}${v}${v}{ title: ${O(i.title)}, query: ${O(i.query)} },`
       );
-    r.push(`${o}${P}],`);
+    r.push(`${o}${v}],`);
   }
   if (n.children?.length) {
-    r.push(`${o}${P}children: [`);
+    r.push(`${o}${v}children: [`);
     for (const i of n.children) r.push(...Z(i, t + 2, e));
-    r.push(`${o}${P}],`);
+    r.push(`${o}${v}],`);
   }
   return r.push(`${o}},`), r;
 }
 function G(n, t = {}) {
   const e = t.newPaths ?? /* @__PURE__ */ new Set(), o = [
-    'import { defineIA } from "pubuilder"',
+    'import { defineIA } from "pubuilder/config"',
     "",
     "export default defineIA({"
   ];
-  n.viewport && o.push(`${P}viewport: ${A(n.viewport)},`), o.push(`${P}pages: [`);
+  n.viewport && o.push(`${v}viewport: ${O(n.viewport)},`), o.push(`${v}pages: [`);
   for (const r of n.pages) o.push(...Z(r, 2, e));
-  return o.push(`${P}],`), o.push("})"), o.push(""), o.join(`
+  return o.push(`${v}],`), o.push("})"), o.push(""), o.join(`
 `);
 }
-function E(n) {
+function T(n) {
   return n === "/" ? [] : n.replace(/^\//, "").split("/");
 }
 function ht(n, t) {
@@ -104,11 +104,11 @@ function ht(n, t) {
 }
 function dt(n) {
   const t = [...n].sort((r, s) => {
-    const a = E(r.routePath).length - E(s.routePath).length;
+    const a = T(r.routePath).length - T(s.routePath).length;
     return a !== 0 ? a : r.routePath.localeCompare(s.routePath);
   }), e = [], o = [];
   for (const r of t) {
-    const s = E(r.routePath), a = {
+    const s = T(r.routePath), a = {
       path: r.routePath,
       title: r.title ?? s.at(-1) ?? "/"
     };
@@ -120,7 +120,7 @@ function dt(n) {
   return e;
 }
 function U(n, t) {
-  const e = E(n), o = E(t);
+  const e = T(n), o = T(t);
   for (let r = 0; r < o.length; r++) {
     const s = o[r];
     if (/^\[\[\.\.\..+\]\]$/.test(s))
@@ -135,7 +135,7 @@ function U(n, t) {
 }
 function Y(n, t = []) {
   for (const e of n)
-    t.push({ page: e, segments: E(e.path) }), e.children && Y(e.children, t);
+    t.push({ page: e, segments: T(e.path) }), e.children && Y(e.children, t);
   return t;
 }
 function C(n) {
@@ -146,16 +146,16 @@ function ft(n, t) {
     (c) => c.page.path === d.routePath || U(c.page.path, d.routePath)
   ), a = t.filter((d) => !s(d)), i = (d) => t.some(
     (c) => c.routePath === d.page.path || U(d.page.path, c.routePath)
-  ), h = r.filter((d) => !i(d)).map((d) => d.page.path), p = [], g = [...o], w = [...a].sort(
-    (d, c) => E(d.routePath).length - E(c.routePath).length
+  ), h = r.filter((d) => !i(d)).map((d) => d.page.path), p = [], g = [...o], $ = [...a].sort(
+    (d, c) => T(d.routePath).length - T(c.routePath).length
   );
-  for (const d of w) {
-    const c = E(d.routePath), l = { path: d.routePath, title: d.title ?? c.at(-1) ?? "/" };
+  for (const d of $) {
+    const c = T(d.routePath), l = { path: d.routePath, title: d.title ?? c.at(-1) ?? "/" };
     let u;
     for (const S of g) {
       if (C(S.page)) continue;
-      const $ = S.segments;
-      $.length >= c.length || $.every((y, I) => y === c[I]) && (!u || $.length > u.segments.length) && (u = S);
+      const y = S.segments;
+      y.length >= c.length || y.every((w, E) => w === c[E]) && (!u || y.length > u.segments.length) && (u = S);
     }
     u ? (u.page.children ??= []).push(l) : e.pages.push(l), g.push({ page: l, segments: c }), p.push(d.routePath);
   }
@@ -164,7 +164,7 @@ function ft(n, t) {
 const mt = /^page\.(tsx|jsx|ts|js)$/, gt = /^\(.+\)$/, wt = /^\(\.{1,3}\)/;
 function J(n) {
   for (const t of ["app", "src/app"])
-    if (v(f(n, t))) return f(n, t);
+    if (P(f(n, t))) return f(n, t);
   return null;
 }
 function $t(n) {
@@ -201,7 +201,7 @@ const bt = {
       a !== null && o.push({
         routePath: a,
         isDynamic: /\[.+\]/.test(a),
-        title: yt(O(r, "utf8"))
+        title: yt(R(r, "utf8"))
       });
     }
     return o;
@@ -209,7 +209,7 @@ const bt = {
 }, H = /\.(tsx|jsx|ts|js)$/, St = /* @__PURE__ */ new Set(["_app", "_document", "_error", "404", "500"]);
 function B(n) {
   for (const t of ["pages", "src/pages"])
-    if (v(f(n, t))) return f(n, t);
+    if (P(f(n, t))) return f(n, t);
   return null;
 }
 function q(n, t, e) {
@@ -226,7 +226,7 @@ function q(n, t, e) {
     e.push({ routePath: a, isDynamic: /\[.+\]/.test(a) });
   }
 }
-const Pt = {
+const vt = {
   name: "next-pages",
   detect(n) {
     return B(n) !== null;
@@ -237,7 +237,7 @@ const Pt = {
     const e = [];
     return q(t, [], e), e;
   }
-}, vt = `import { defineIA } from "pubuilder"
+}, Pt = `import { defineIA } from "pubuilder/config"
 
 // pubuilder scan은 아직 이 프로젝트의 라우팅 방식을 지원하지 않아요 (v1은 Next.js 전용).
 // 아래 예시를 참고해 앱의 화면 구조를 직접 작성해주세요.
@@ -283,16 +283,16 @@ function F(n) {
 }
 function K(n) {
   const t = F(n.homeDir);
-  if (v(t))
+  if (P(t))
     try {
-      const o = JSON.parse(O(t, "utf8"));
+      const o = JSON.parse(R(t, "utf8"));
       if (o.figmaToken) return o.figmaToken;
     } catch {
     }
   if (n.env.FIGMA_TOKEN) return n.env.FIGMA_TOKEN;
   const e = f(n.projectRoot, ".env");
-  if (v(e)) {
-    const o = O(e, "utf8").split(`
+  if (P(e)) {
+    const o = R(e, "utf8").split(`
 `).find((r) => r.trim().startsWith("FIGMA_TOKEN="));
     if (o) {
       const r = o.slice(o.indexOf("=") + 1).trim().replace(/^["']|["']$/g, "");
@@ -302,7 +302,7 @@ function K(n) {
   return null;
 }
 function Tt(n, t) {
-  j(f(n, ".pubuilder"), { recursive: !0 }), R(F(n), JSON.stringify({ figmaToken: t }, null, 2), { mode: 384 });
+  j(f(n, ".pubuilder"), { recursive: !0 }), N(F(n), JSON.stringify({ figmaToken: t }, null, 2), { mode: 384 });
 }
 function Et(n) {
   W(F(n), { force: !0 });
@@ -326,10 +326,10 @@ async function Ot(n, t, e, o = fetch) {
   if (!h.ok) throw new m("FIGMA_API_ERROR", `이미지 export 실패 (${h.status})`, 502);
   const g = (await h.json()).images[n.nodeId];
   if (!g) throw new m("FIGMA_API_ERROR", "이미지 export URL이 비어 있어요", 502);
-  const w = await (await o(g)).arrayBuffer();
+  const $ = await (await o(g)).arrayBuffer();
   j(e, { recursive: !0 });
   const d = n.nodeId.replace(/[^A-Za-z0-9_-]/g, "-"), c = f(e, `${n.fileKey}-${d}.png`);
-  return R(c, Buffer.from(w)), { nodeJson: i, imagePath: c };
+  return N(c, Buffer.from($)), { nodeJson: i, imagePath: c };
 }
 function V(n) {
   const t = n.match(/^---\n([\s\S]*?)\n---/);
@@ -347,24 +347,24 @@ class Rt {
     return f(this.projectRoot, ".pubuilder", "settings.json");
   }
   loadSettings() {
-    if (!v(this.settingsPath())) return { skills: {} };
+    if (!P(this.settingsPath())) return { skills: {} };
     try {
-      return JSON.parse(O(this.settingsPath(), "utf8"));
+      return JSON.parse(R(this.settingsPath(), "utf8"));
     } catch {
       return { skills: {} };
     }
   }
   saveSettings(t) {
-    j(f(this.projectRoot, ".pubuilder"), { recursive: !0 }), R(this.settingsPath(), JSON.stringify(t, null, 2));
+    j(f(this.projectRoot, ".pubuilder"), { recursive: !0 }), N(this.settingsPath(), JSON.stringify(t, null, 2));
   }
   scanDir(t, e) {
-    if (!v(t)) return [];
+    if (!P(t)) return [];
     const o = [];
     for (const r of D(t, { withFileTypes: !0 })) {
       if (!r.isDirectory()) continue;
       const s = f(t, r.name, "SKILL.md");
-      if (!v(s)) continue;
-      const a = V(O(s, "utf8"));
+      if (!P(s)) continue;
+      const a = V(R(s, "utf8"));
       o.push({
         id: `${e}:${r.name}`,
         name: a.name ?? r.name,
@@ -400,7 +400,7 @@ class Rt {
     if (!/^[A-Za-z0-9][A-Za-z0-9_-]*$/.test(r))
       throw new m("INVALID_NAME", `스킬 이름이 유효하지 않아요: ${r}`, 400);
     const s = f(this.projectRoot, ".pubuilder", "skills", r);
-    return j(s, { recursive: !0 }), R(f(s, "SKILL.md"), e), { id: `uploaded:${r}`, name: r, description: o.description ?? "", source: "uploaded", enabled: !0 };
+    return j(s, { recursive: !0 }), N(f(s, "SKILL.md"), e), { id: `uploaded:${r}`, name: r, description: o.description ?? "", source: "uploaded", enabled: !0 };
   }
   /** 삭제는 uploaded만 — 유저의 .claude/skills를 지우는 사고 방지 (스펙) */
   remove(t) {
@@ -413,7 +413,7 @@ class Rt {
   }
   enabledSkillContents() {
     const t = this.loadSettings();
-    return this.scanAll().filter((e) => t.skills[e.id] ?? e.source !== "global").map((e) => ({ name: e.name, content: O(e.path, "utf8") }));
+    return this.scanAll().filter((e) => t.skills[e.id] ?? e.source !== "global").map((e) => ({ name: e.name, content: R(e.path, "utf8") }));
   }
 }
 function Nt(n) {
@@ -422,16 +422,22 @@ function Nt(n) {
 
 다른 스킬은 사용하지 말고, 아래에 명시된 스킬 지침만 따르세요.
 
-${n.skills.map((r) => `## 스킬: ${r.name}
+${n.skills.map((s) => `## 스킬: ${s.name}
 
-${r.content}`).join(`
+${s.content}`).join(`
 
 ---
 
 `)}
 ` : `
 다른 스킬은 스스로 판단해 사용하지 마세요. 아래에 명시된 스킬 지침만 따르세요 (이번 요청에는 없음).
-`;
+`, r = n.instruction ? `
+# 사용자의 후속 답변
+
+${n.instruction}
+
+이전 실행에서 이미 변경된 현재 작업 트리를 확인하고, 위 답변에 따라 중단된 작업을 이어서 완료하세요. 같은 선택지를 다시 질문하지 마세요.
+` : "";
   return `이 프로젝트의 특정 UI 블록을 Figma 시안대로 수정하는 퍼블리싱 작업입니다.
 
 # 대상 블록
@@ -451,6 +457,7 @@ ${n.outerHTML}
 ${JSON.stringify(e.nodeJson, null, 2)}
 \`\`\`
 ${o}
+${r}
 # 작업 순서
 1. 위 라우트와 outerHTML 스냅샷을 단서로, 이 블록을 렌더링하는 소스 컴포넌트 파일을 찾으세요.
 2. Figma 렌더 이미지를 Read 도구로 열어 시안을 육안으로 확인하세요. 노드 JSON의 수치(색상/간격/타이포)를 우선 근거로 쓰되, JSON에만 있고 이미지에 보이지 않는 요소는 구현하지 마세요.
@@ -516,8 +523,8 @@ const z = 600 * 1e3, kt = {
           text: c.code === "ENOENT" ? "claude CLI를 찾지 못했어요. https://claude.com/claude-code 에서 설치 후 claude login 해주세요" : `claude 실행 실패: ${c.message}`
         });
       });
-      const w = [];
-      s.stderr.on("data", (c) => w.push(String(c)));
+      const $ = [];
+      s.stderr.on("data", (c) => $.push(String(c)));
       let d = !1;
       ct({ input: s.stdout }).on("line", (c) => {
         g();
@@ -526,7 +533,7 @@ const z = 600 * 1e3, kt = {
           e(u), (u.type === "done" || u.type === "error") && (d = !0);
       }), s.on("close", (c) => {
         if (c !== 0 && !d) {
-          const l = w.join("").trim();
+          const l = $.join("").trim();
           i({ type: "error", text: l || `claude가 코드 ${c}로 종료됐어요. claude login 상태를 확인해주세요` });
         } else
           i();
@@ -605,25 +612,26 @@ function _(n) {
     }), n.on("error", e);
   });
 }
-function T(n, t, e) {
+function I(n, t, e) {
   const o = JSON.stringify(e);
   n.writeHead(t, { "content-type": "application/json" }), n.end(o);
 }
 async function Mt(n) {
   const t = n.projectRoot, e = n.homeDir ?? it(), o = n.adapter ?? kt, r = n.figmaFetch ?? fetch, s = new Rt({ projectRoot: t, homeDir: e }), a = new jt(o);
   async function i(c) {
-    const l = await _(c), { selection: u, outerHTML: S, figmaUrl: $ } = l ?? {}, y = It(String($ ?? ""));
+    const l = await _(c), { selection: u, outerHTML: S, figmaUrl: y, instruction: w } = l ?? {}, E = It(String(y ?? ""));
     if (typeof u != "object" || u === null || typeof u.pagePath != "string" || typeof u.selector != "string" || typeof S != "string")
       throw new m("INVALID_JSON", "selection/outerHTML 형식이 올바르지 않아요", 400);
-    const I = K({ projectRoot: t, homeDir: e, env: process.env });
-    if (!I) throw new m("NO_FIGMA_TOKEN", "Figma 토큰이 설정되지 않았어요. 스킬함 설정에서 등록해주세요", 401);
-    const { nodeJson: x, imagePath: k } = await Ot(y, I, f(t, ".pubuilder/cache"), r), b = Nt({
+    const x = K({ projectRoot: t, homeDir: e, env: process.env });
+    if (!x) throw new m("NO_FIGMA_TOKEN", "Figma 토큰이 설정되지 않았어요. 스킬함 설정에서 등록해주세요", 401);
+    const { nodeJson: k, imagePath: b } = await Ot(E, x, f(t, ".pubuilder/cache"), r), A = Nt({
       selection: u,
       outerHTML: S ?? "",
-      figma: { url: String($), nodeJson: x, imagePath: k },
-      skills: s.enabledSkillContents()
+      figma: { url: String(y), nodeJson: k, imagePath: b },
+      skills: s.enabledSkillContents(),
+      instruction: typeof w == "string" ? w.trim() : void 0
     });
-    return { status: 202, body: { jobId: a.start({ prompt: b, cwd: t }) } };
+    return { status: 202, body: { jobId: a.start({ prompt: A, cwd: t }) } };
   }
   function h(c, l, u) {
     if (!a.has(u)) throw new m("NOT_FOUND", `job 없음: ${u}`, 404);
@@ -634,94 +642,94 @@ async function Mt(n) {
     });
     let S = () => {
     };
-    const $ = (y) => {
-      l.write(`data: ${JSON.stringify(y)}
+    const y = (w) => {
+      l.write(`data: ${JSON.stringify(w)}
 
-`), (y.type === "done" || y.type === "error") && (S(), l.end());
+`), (w.type === "done" || w.type === "error") && (S(), l.end());
     };
-    S = a.subscribe(u, $), c.on("close", S);
+    S = a.subscribe(u, y), c.on("close", S);
   }
   const p = st((c, l) => {
     (async () => {
       try {
         const u = c.headers.origin;
         if (u && !Lt.test(u)) {
-          T(l, 403, { code: "FORBIDDEN", message: "허용되지 않은 origin이에요" });
+          I(l, 403, { code: "FORBIDDEN", message: "허용되지 않은 origin이에요" });
           return;
         }
         if (u && (l.setHeader("Access-Control-Allow-Origin", u), l.setHeader("Access-Control-Allow-Methods", "GET,POST,PUT,PATCH,DELETE"), l.setHeader("Access-Control-Allow-Headers", "content-type")), c.method === "OPTIONS") {
           l.writeHead(204), l.end();
           return;
         }
-        const $ = new URL(c.url ?? "/", "http://localhost").pathname, y = c.method ?? "GET";
-        if (y === "GET" && $ === "/api/health") {
-          T(l, 200, { ok: !0 });
+        const y = new URL(c.url ?? "/", "http://localhost").pathname, w = c.method ?? "GET";
+        if (w === "GET" && y === "/api/health") {
+          I(l, 200, { ok: !0 });
           return;
         }
-        if (y === "GET" && $ === "/api/skills") {
-          T(l, 200, s.list());
+        if (w === "GET" && y === "/api/skills") {
+          I(l, 200, s.list());
           return;
         }
-        if (y === "POST" && $ === "/api/skills") {
-          const b = await _(c), N = s.upload(b.filename, b.content);
-          T(l, 201, N);
+        if (w === "POST" && y === "/api/skills") {
+          const b = await _(c), A = s.upload(b.filename, b.content);
+          I(l, 201, A);
           return;
         }
-        const I = $.match(/^\/api\/skills\/([^/]+)$/);
-        if (I && y === "PATCH") {
-          const b = decodeURIComponent(I[1]), N = await _(c);
-          s.setEnabled(b, N.enabled), l.writeHead(204), l.end();
+        const E = y.match(/^\/api\/skills\/([^/]+)$/);
+        if (E && w === "PATCH") {
+          const b = decodeURIComponent(E[1]), A = await _(c);
+          s.setEnabled(b, A.enabled), l.writeHead(204), l.end();
           return;
         }
-        if (I && y === "DELETE") {
-          const b = decodeURIComponent(I[1]);
+        if (E && w === "DELETE") {
+          const b = decodeURIComponent(E[1]);
           s.remove(b), l.writeHead(204), l.end();
           return;
         }
-        if (y === "GET" && $ === "/api/settings/figma-token") {
+        if (w === "GET" && y === "/api/settings/figma-token") {
           const b = K({ projectRoot: t, homeDir: e, env: process.env });
-          T(l, 200, { configured: b != null, masked: b ? At(b) : null });
+          I(l, 200, { configured: b != null, masked: b ? At(b) : null });
           return;
         }
-        if (y === "PUT" && $ === "/api/settings/figma-token") {
+        if (w === "PUT" && y === "/api/settings/figma-token") {
           const b = await _(c);
           Tt(e, b.token), l.writeHead(204), l.end();
           return;
         }
-        if (y === "DELETE" && $ === "/api/settings/figma-token") {
+        if (w === "DELETE" && y === "/api/settings/figma-token") {
           Et(e), l.writeHead(204), l.end();
           return;
         }
-        if (y === "POST" && $ === "/api/publish") {
-          const { status: b, body: N } = await i(c);
-          T(l, b, N);
+        if (w === "POST" && y === "/api/publish") {
+          const { status: b, body: A } = await i(c);
+          I(l, b, A);
           return;
         }
-        const x = $.match(/^\/api\/publish\/([^/]+)\/events$/);
-        if (x && y === "GET") {
+        const x = y.match(/^\/api\/publish\/([^/]+)\/events$/);
+        if (x && w === "GET") {
           h(c, l, x[1]);
           return;
         }
-        const k = $.match(/^\/api\/publish\/([^/]+)$/);
-        if (k && y === "DELETE") {
+        const k = y.match(/^\/api\/publish\/([^/]+)$/);
+        if (k && w === "DELETE") {
           a.cancel(k[1]), l.writeHead(204), l.end();
           return;
         }
-        T(l, 404, { code: "NOT_FOUND", message: "해당 경로를 찾을 수 없어요" });
+        I(l, 404, { code: "NOT_FOUND", message: "해당 경로를 찾을 수 없어요" });
       } catch (u) {
         if (u instanceof m) {
-          T(l, u.status, { code: u.code, message: u.message });
+          I(l, u.status, { code: u.code, message: u.message });
           return;
         }
         const S = u instanceof Error ? u.message : String(u);
-        T(l, 500, { code: "INTERNAL", message: S });
+        I(l, 500, { code: "INTERNAL", message: S });
       }
     })();
   }), g = n.port ?? Dt;
   await new Promise((c) => p.listen(g, "127.0.0.1", c));
-  const w = p.address();
+  const $ = p.address();
   return {
-    port: typeof w == "object" && w ? w.port : g,
+    port: typeof $ == "object" && $ ? $.port : g,
     close() {
       p.close();
     }
@@ -752,17 +760,17 @@ async function Gt(n, t) {
     };
     a.on("error", (g) => {
       console.error(`[pubuilder] 명령 실행 실패: ${g.message}`), p(), s(1);
-    }), a.on("close", (g, w) => {
-      p(), s(w ? 128 + (at.signals[w] ?? 0) : g ?? 0);
+    }), a.on("close", (g, $) => {
+      p(), s($ ? 128 + (at.signals[$] ?? 0) : g ?? 0);
     });
   });
 }
-const Ut = [bt, Pt];
+const Ut = [bt, vt];
 function Ct(n) {
   const t = f(n, "package.json");
-  if (!v(t)) return !1;
+  if (!P(t)) return !1;
   try {
-    const e = JSON.parse(O(t, "utf8"));
+    const e = JSON.parse(R(t, "utf8"));
     return !!(e.dependencies?.next ?? e.devDependencies?.next);
   } catch {
     return console.warn("[pubuilder] package.json 파싱 실패 — JSON 문법을 확인해주세요"), !1;
@@ -793,18 +801,18 @@ async function Ht(n) {
 async function Bt(n, t) {
   const e = Jt(n), o = f(n, "ia.config.ts");
   if (e === null)
-    return console.error("[pubuilder] 지원하지 않는 라우팅 방식이에요. v1은 Next.js(App/Pages Router) 전용입니다."), !v(o) && !t.dryRun && (R(o, vt), console.log(`[pubuilder] 작성법 안내가 담긴 예시 템플릿을 생성했어요: ${o}`)), { kind: "unsupported" };
-  if (v(o)) {
+    return console.error("[pubuilder] 지원하지 않는 라우팅 방식이에요. v1은 Next.js(App/Pages Router) 전용입니다."), !P(o) && !t.dryRun && (N(o, Pt), console.log(`[pubuilder] 작성법 안내가 담긴 예시 템플릿을 생성했어요: ${o}`)), { kind: "unsupported" };
+  if (P(o)) {
     const i = await Ht(o), { config: h, added: p, removed: g } = ft(i, e);
-    M(h), t.dryRun || R(o, G(h, { newPaths: new Set(p) }));
-    for (const w of p) console.log(`[pubuilder] + 추가됨: ${w}`);
-    for (const w of g) console.log(`[pubuilder] - 라우트에서 사라짐 (config엔 유지): ${w}`);
+    M(h), t.dryRun || N(o, G(h, { newPaths: new Set(p) }));
+    for (const $ of p) console.log(`[pubuilder] + 추가됨: ${$}`);
+    for (const $ of g) console.log(`[pubuilder] - 라우트에서 사라짐 (config엔 유지): ${$}`);
     return p.length === 0 && g.length === 0 && console.log("[pubuilder] 변경 없음"), t.dryRun && console.log("[pubuilder] (dry-run) 파일은 수정하지 않았어요"), { kind: "merged", added: p, removed: g };
   }
   const s = { pages: dt(e) };
   M(s);
   const a = e.map((i) => i.routePath);
-  return t.dryRun ? console.log(`[pubuilder] (dry-run) 생성 예정: ${a.length}개 라우트. 파일은 수정하지 않았어요.`) : (R(o, G(s, { newPaths: new Set(a) })), console.log(`[pubuilder] ia.config.ts 초안을 생성했어요 (${a.length}개 라우트). title과 [param] 샘플 경로를 다듬어주세요.`)), { kind: "created", paths: a };
+  return t.dryRun ? console.log(`[pubuilder] (dry-run) 생성 예정: ${a.length}개 라우트. 파일은 수정하지 않았어요.`) : (N(o, G(s, { newPaths: new Set(a) })), console.log(`[pubuilder] ia.config.ts 초안을 생성했어요 (${a.length}개 라우트). title과 [param] 샘플 경로를 다듬어주세요.`)), { kind: "created", paths: a };
 }
 async function Kt(n) {
   const [t, ...e] = n;

package/dist/components/PageMap.d.ts

@@ -1,4 +1,4 @@
-import type { IAConfig } from '../types';
+import type { IAConfig } from '../types.js';
 export interface PageMapProps {
     config: IAConfig;
     /**

package/dist/config.d.ts

@@ -1,4 +1,4 @@
-import type { IAConfig, IANode } from './types';
+import type { IAConfig, IANode } from './types.js';
 /** ia.config.ts 작성용 헬퍼 — 타입 추론만 제공 */
 export declare function defineIA(config: IAConfig): IAConfig;
 export interface NormalizedIA {