@jogak/core 0.1.0-alpha.7.1 → 0.1.0-alpha.9

package/dist/vite/index.mjs

@@ -1,211 +1,285 @@
-import { resolve as y, join as P, dirname as W } from "node:path";
-import { existsSync as T, readFileSync as X } from "node:fs";
-import { stat as O, rm as Y, readdir as q, readFile as L } from "node:fs/promises";
-import { c as R } from "../extractor-client-CReBed7x.js";
-const H = [
+import { resolve as _, join as B, dirname as tt } from "node:path";
+import { existsSync as S, readFileSync as et } from "node:fs";
+import { stat as L, rm as rt, readdir as ot, readFile as U } from "node:fs/promises";
+import { r as W } from "../detect-global-css-CIVMmgzy.js";
+import { c as $ } from "../extractor-client-CReBed7x.js";
+const nt = [
   "@jogak/core",
   "@jogak/react",
   "@jogak/web-components",
   "@jogak/next"
 ];
-async function F(t) {
+async function K(t) {
   try {
-    const a = await O(t);
+    const a = await L(t);
     if (!a.isDirectory())
       return a.mtimeMs;
   } catch {
     return 0;
   }
-  let o = 0, s;
+  let r = 0, o;
   try {
-    s = await q(t);
+    o = await ot(t);
   } catch {
     return 0;
   }
-  for (const a of s) {
-    const g = P(t, a);
+  for (const a of o) {
+    const c = B(t, a);
     try {
-      const c = await O(g);
-      if (c.isDirectory()) {
-        const p = await F(g);
-        p > o && (o = p);
-      } else c.mtimeMs > o && (o = c.mtimeMs);
+      const l = await L(c);
+      if (l.isDirectory()) {
+        const g = await K(c);
+        g > r && (r = g);
+      } else l.mtimeMs > r && (r = l.mtimeMs);
     } catch {
       continue;
     }
   }
-  return o;
+  return r;
 }
-async function z(t) {
-  const o = y(t.root, "node_modules/.vite/deps");
-  if (!T(o))
+async function at(t) {
+  const r = _(t.root, "node_modules/.vite/deps");
+  if (!S(r))
     return { purged: !1 };
-  const s = P(o, "_metadata.json");
-  if (!T(s))
+  const o = B(r, "_metadata.json");
+  if (!S(o))
     return { purged: !1 };
   let a;
   try {
-    a = (await O(s)).mtimeMs;
-  } catch (c) {
+    a = (await L(o)).mtimeMs;
+  } catch (l) {
     return t.logger.warn(
-      `[jogak] cache validation: failed to stat _metadata.json (${c.message})`
+      `[jogak] cache validation: failed to stat _metadata.json (${l.message})`
     ), { purged: !1 };
   }
-  const g = t.packages ?? H;
-  for (const c of g) {
-    const p = y(t.root, "node_modules", c, "dist");
-    if (!T(p)) continue;
-    let h;
+  const c = t.packages ?? nt;
+  for (const l of c) {
+    const g = _(t.root, "node_modules", l, "dist");
+    if (!S(g)) continue;
+    let y;
     try {
-      h = await F(p);
+      y = await K(g);
     } catch (w) {
       t.logger.warn(
-        `[jogak] cache validation: failed to walk ${c}/dist (${w.message})`
+        `[jogak] cache validation: failed to walk ${l}/dist (${w.message})`
       );
       continue;
     }
-    if (h > a + 1e3)
+    if (y > a + 1e3)
       try {
-        return await Y(o, { recursive: !0, force: !0 }), t.logger.info(
-          `[jogak] vite deps cache invalidated (stale): ${c} dist newer than cache`
-        ), { purged: !0, reason: c };
+        return await rt(r, { recursive: !0, force: !0 }), t.logger.info(
+          `[jogak] vite deps cache invalidated (stale): ${l} dist newer than cache`
+        ), { purged: !0, reason: l };
       } catch (w) {
         return t.logger.warn(
-          `[jogak] cache validation: failed to purge ${o} (${w.message})`
+          `[jogak] cache validation: failed to purge ${r} (${w.message})`
         ), { purged: !1 };
       }
   }
   return { purged: !1 };
 }
-const Q = [
-  "src/index.css",
-  "src/main.css",
-  "src/styles.css",
-  "src/styles/globals.css",
-  "src/styles/index.css",
-  "src/app/globals.css",
-  "src/global.css",
-  "src/app.css"
-];
-function Z(t) {
-  for (const o of Q) {
-    const s = y(t, o);
-    if (T(s)) return [s];
-  }
-  return [];
-}
-function tt(t, o) {
-  if (t === void 0 || t === !1) return [];
-  if (t === !0) return Z(o);
-  if (typeof t == "string")
-    return t.length > 0 ? [y(o, t)] : [];
-  const s = [];
-  for (const a of t)
-    typeof a == "string" && a.length > 0 && s.push(y(o, a));
-  return s;
-}
-function et(t) {
+function it(t) {
   return t.replace(/\/\*[\s\S]*?\*\//g, "").replace(/^\s*\/\/.*$/gm, "");
 }
-function ot(t) {
-  if (T(t))
+function st(t) {
+  if (S(t))
     try {
-      const o = X(t, "utf8");
-      return JSON.parse(et(o));
+      const r = et(t, "utf8");
+      return JSON.parse(it(r));
     } catch {
       return;
     }
 }
-function rt(t, o, s) {
-  if (!t.endsWith("/*") || !o.endsWith("/*")) return;
-  const a = t.slice(0, -2), g = y(s, o.slice(0, -2));
-  return [a, g];
+function ct(t, r, o) {
+  if (!t.endsWith("/*") || !r.endsWith("/*")) return;
+  const a = t.slice(0, -2), c = _(o, r.slice(0, -2));
+  return [a, c];
 }
-function st(t, o) {
-  var g, c;
-  const s = {}, a = /* @__PURE__ */ new Set([
+function lt(t, r) {
+  var c, l;
+  const o = {}, a = /* @__PURE__ */ new Set([
     t,
-    y(o, "tsconfig.app.json")
+    _(r, "tsconfig.app.json")
   ]);
-  for (const p of a) {
-    const h = ot(p);
-    if (h === void 0) continue;
-    const w = (g = h.compilerOptions) == null ? void 0 : g.paths;
+  for (const g of a) {
+    const y = st(g);
+    if (y === void 0) continue;
+    const w = (c = y.compilerOptions) == null ? void 0 : c.paths;
     if (w === void 0) continue;
-    const u = ((c = h.compilerOptions) == null ? void 0 : c.baseUrl) ?? ".", m = y(W(p), u);
-    for (const [_, k] of Object.entries(w)) {
-      const S = k[0];
-      if (S === void 0) continue;
-      const b = rt(_, S, m);
-      if (b === void 0) continue;
-      const [A, e] = b;
-      s[A] === void 0 && (s[A] = e);
+    const R = ((l = y.compilerOptions) == null ? void 0 : l.baseUrl) ?? ".", C = _(tt(g), R);
+    for (const [T, d] of Object.entries(w)) {
+      const f = d[0];
+      if (f === void 0) continue;
+      const j = ct(T, f, C);
+      if (j === void 0) continue;
+      const [k, I] = j;
+      o[k] === void 0 && (o[k] = I);
     }
   }
-  return s;
+  return o;
 }
-const G = "virtual:jogak", E = "\0" + G, U = "virtual:jogak/entry/", M = "\0" + U, V = "virtual:jogak/global-css", $ = "\0" + V;
-function at(t) {
+const H = "virtual:jogak", x = "\0" + H, Y = "virtual:jogak/entry/", P = "\0" + Y, X = "virtual:jogak/global-css", D = "\0" + X, M = "virtual:jogak/preview-entry", F = "\0" + M, z = "virtual:jogak/preview-global-css", G = "\0" + z;
+function ut(t) {
   return Buffer.from(t, "utf8").toString("base64url");
 }
-function nt(t) {
+function dt(t) {
   return Buffer.from(t, "base64url").toString("utf8");
 }
-function D(t) {
+const gt = "/__jogak_preview__/index.html";
+function kt(t) {
+  return {
+    name: "vite-plugin-jogak-preview-frame",
+    enforce: "pre",
+    configureServer(r) {
+      r.middlewares.use((o, a, c) => {
+        if (o.url === void 0 || o.url.split("?")[0] !== gt || o.method !== "GET") return c();
+        const g = ft();
+        r.transformIndexHtml(o.url, g).then((y) => {
+          a.statusCode = 200, a.setHeader("Content-Type", "text/html; charset=utf-8"), a.end(y);
+        }).catch(c);
+      });
+    },
+    resolveId(r) {
+      if (r === M) return F;
+      if (r === z) return G;
+    },
+    load(r) {
+      if (r === G) {
+        const o = W(t.globalCss, t.userRoot);
+        return o.length === 0 ? `// [jogak] preview-global-css: no candidates
+export {}
+` : o.map((a) => `import ${JSON.stringify(a)}`).join(`
+`) + `
+export {}
+`;
+      }
+      if (r === F)
+        return mt;
+    }
+  };
+}
+function ft() {
+  return `<!doctype html>
+<html lang="en">
+  <head>
+    <meta charset="UTF-8" />
+    <meta name="viewport" content="width=device-width, initial-scale=1.0" />
+    <title>jogak preview</title>
+    <style>
+      html, body { margin: 0; padding: 0; }
+      #jogak-preview-root { display: block; }
+    </style>
+  </head>
+  <body>
+    <div id="jogak-preview-root"></div>
+    <script type="module" src="/@id/${M}"><\/script>
+  </body>
+</html>
+`;
+}
+const mt = `
+import { reactAdapter } from '@jogak/react'
+import { defaultRegistry } from '@jogak/core'
+import 'virtual:jogak'
+import 'virtual:jogak/preview-global-css'
+
+const rootEl = document.getElementById('jogak-preview-root')
+if (rootEl === null) throw new Error('[jogak] #jogak-preview-root not found')
+
+let currentContainer = null
+let currentArgs = {}
+let currentEntryId = null
+
+async function renderEntry(entryId, args) {
+  currentEntryId = entryId
+  currentArgs = args
+  const entry = await defaultRegistry.requestEntry(entryId)
+  if (currentContainer === null) {
+    currentContainer = document.createElement('div')
+    rootEl.replaceChildren(currentContainer)
+  }
+  reactAdapter.render(entry, args, currentContainer)
+}
+
+function unmount() {
+  if (currentContainer !== null) {
+    reactAdapter.unmount(currentContainer)
+    currentContainer = null
+    currentEntryId = null
+  }
+}
+
+window.addEventListener('message', (event) => {
+  const data = event.data
+  if (data == null || typeof data !== 'object') return
+  if (data.type === 'jogak:setProps') {
+    void renderEntry(data.entryId, data.args ?? {}).then(() => {
+      window.parent.postMessage({ type: 'jogak:rendered', entryId: data.entryId }, '*')
+    }).catch((err) => {
+      window.parent.postMessage({ type: 'jogak:error', message: String(err?.message ?? err) }, '*')
+    })
+  } else if (data.type === 'jogak:unmount') {
+    unmount()
+  }
+})
+
+window.parent.postMessage({ type: 'jogak:ready' }, '*')
+`;
+function J(t) {
   return {
     title: t.title,
     jogakNamesKey: [...t.jogakNames].sort().join("|")
   };
 }
-function it(t, o) {
-  return t !== void 0 && t.title === o.title && t.jogakNamesKey === o.jogakNamesKey;
+function pt(t, r) {
+  return t !== void 0 && t.title === r.title && t.jogakNamesKey === r.jogakNamesKey;
 }
-function gt(t = {}) {
+function Et(t = {}) {
   const {
-    patterns: o = ["src/**/*.jogak.ts", "src/**/*.jogak.tsx"],
-    codeTheme: s = "vsDark"
-  } = t, a = t.cwd, g = t.tsConfigFilePath, c = t.disableCacheValidation === !0, p = t.resolveAlias, h = t.globalCss, w = t.previewIsolation ?? "shadow";
-  let u, m, _;
-  const k = /* @__PURE__ */ new Map(), S = /* @__PURE__ */ new Map(), b = /* @__PURE__ */ new Map();
-  async function A() {
-    const { glob: e } = await import("glob"), d = _ ?? process.cwd(), r = (await e(o, { cwd: d, absolute: !0 })).sort(), l = [];
-    k.clear(), S.clear();
-    for (const n of r) {
+    patterns: r = ["src/**/*.jogak.ts", "src/**/*.jogak.tsx"],
+    codeTheme: o = "vsDark"
+  } = t, a = t.cwd, c = t.tsConfigFilePath, l = t.disableCacheValidation === !0, g = t.resolveAlias, y = t.globalCss, w = t.previewIsolation ?? "iframe", R = t.previewFrame === !0, C = t.userPreviewUrl ?? t.userViteUrl ?? "", T = t.previewEntryPath ?? "/__jogak_preview__/index.html";
+  let d, f, j;
+  const k = /* @__PURE__ */ new Map(), I = /* @__PURE__ */ new Map(), b = /* @__PURE__ */ new Map();
+  async function N() {
+    const { glob: e } = await import("glob"), m = j ?? process.cwd(), n = (await e(r, { cwd: m, absolute: !0 })).sort(), u = [];
+    k.clear(), I.clear();
+    for (const i of n) {
       let v = "";
       try {
-        v = await L(n, "utf8");
+        v = await U(i, "utf8");
       } catch {
         continue;
       }
-      let j = {}, i = null;
-      if (m !== void 0) {
+      let h = {}, s = null;
+      if (f !== void 0) {
         try {
-          j = await m.extract(n);
+          h = await f.extract(i);
         } catch {
-          j = {};
+          h = {};
         }
         try {
-          i = await m.extractMeta(n);
+          s = await f.extractMeta(i);
         } catch {
-          i = null;
+          s = null;
         }
       }
-      if (i === null) continue;
-      const f = i.title;
-      k.set(f, n), S.set(n, f);
-      const C = {
-        id: f,
-        title: i.title,
-        jogakNames: i.jogakNames,
-        autoArgTypes: j,
-        userArgTypes: i.userArgTypes,
+      if (s === null) continue;
+      const p = s.title;
+      k.set(p, i), I.set(i, p);
+      const E = {
+        id: p,
+        title: s.title,
+        jogakNames: s.jogakNames,
+        autoArgTypes: h,
+        userArgTypes: s.userArgTypes,
         source: v,
-        filePath: n,
-        metaExtras: i.metaExtras
+        filePath: i,
+        metaExtras: s.metaExtras
       };
-      b.set(n, D(C)), l.push({ id: f, filePath: n, meta: C });
+      b.set(i, J(E)), u.push({ id: p, filePath: i, meta: E });
     }
-    return l;
+    return u;
   }
   return {
     name: "vite-plugin-jogak",
@@ -220,77 +294,80 @@ function gt(t = {}) {
      * 우선순위: `options.resolveAlias` (명시) > tsconfig 자동 추출.
      */
     config() {
-      const e = a ?? process.cwd(), d = g ?? y(e, "tsconfig.json"), r = st(d, e), l = {};
-      if (p !== void 0)
-        for (const [v, j] of Object.entries(p))
-          l[v] = y(e, j);
-      const n = { ...r, ...l };
-      if (Object.keys(n).length !== 0)
+      const e = a ?? process.cwd(), m = c ?? _(e, "tsconfig.json"), n = lt(m, e), u = {};
+      if (g !== void 0)
+        for (const [v, h] of Object.entries(g))
+          u[v] = _(e, h);
+      const i = { ...n, ...u };
+      if (Object.keys(i).length !== 0)
         return {
-          resolve: { alias: n }
+          resolve: { alias: i }
         };
     },
     async configResolved(e) {
-      _ = a ?? e.root, e.command === "serve" && !c && await z({
+      j = a ?? e.root, e.command === "serve" && !l && await at({
         root: e.root,
         logger: {
-          info: (r) => e.logger.info(r),
-          warn: (r) => e.logger.warn(r)
+          info: (n) => e.logger.info(n),
+          warn: (n) => e.logger.warn(n)
         }
       });
-      const d = g ?? y(_, "tsconfig.json");
-      m = T(d) ? R({ tsConfigFilePath: d }) : R();
+      const m = c ?? _(j, "tsconfig.json");
+      f = S(m) ? $({ tsConfigFilePath: m }) : $();
     },
     configureServer(e) {
-      u = e;
+      d = e;
     },
     buildEnd() {
-      m == null || m.releaseCache();
+      f == null || f.releaseCache();
     },
     resolveId(e) {
-      if (e === G)
-        return E;
-      if (e === V)
-        return $;
-      if (e.startsWith(U))
+      if (e === H)
+        return x;
+      if (e === X)
+        return D;
+      if (e.startsWith(Y))
         return "\0" + e;
     },
     async load(e) {
-      if (e === $) {
-        const d = _ ?? process.cwd(), r = tt(h, d);
-        return r.length === 0 ? `// [jogak] globalCss not configured or no candidates found.
+      if (e === D) {
+        const m = j ?? process.cwd(), n = W(y, m);
+        return n.length === 0 ? `// [jogak] globalCss not configured or no candidates found.
 export {}
-` : `${r.map((n) => `import ${JSON.stringify(n)}`).join(`
+` : `${n.map((i) => `import ${JSON.stringify(i)}`).join(`
 `)}
 export {}
 `;
       }
-      if (e === E) {
-        const r = (await A()).map((l) => l.meta);
+      if (e === x) {
+        const n = (await N()).map((i) => i.meta), u = R ? "" : `
+export const _jogakCodeTheme = ${JSON.stringify(o)}
+export const _jogakPreviewIsolation = ${JSON.stringify(w)}
+export const _jogakUserPreviewUrl = ${JSON.stringify(C)}
+export const _jogakPreviewEntryPath = ${JSON.stringify(T)}
+export const _jogakUserViteUrl = ${JSON.stringify(C)}
+export const _jogakMetas = _metas
+`;
         return `import { defaultRegistry } from '@jogak/core'
 
 const _entryLoader = (slug) =>
   import(/* @vite-ignore */ '/@id/__x00__virtual:jogak/entry/' + slug)
 defaultRegistry.setEntryLoader((id) => {
-  const slug = ${ct()}
+  const slug = ${yt()}
   return _entryLoader(slug(id))
 })
 
-const _metas = ${JSON.stringify(r)}
+const _metas = ${JSON.stringify(n)}
 
 for (const m of _metas) defaultRegistry.registerMeta(m)
-
-export const _jogakCodeTheme = ${JSON.stringify(s)}
-export const _jogakPreviewIsolation = ${JSON.stringify(w)}
-export const _jogakMetas = _metas
-`;
+${u}`;
       }
-      if (e.startsWith(M)) {
-        const d = e.slice(M.length), r = nt(d);
-        let l = k.get(r);
-        return l === void 0 && (await A(), l = k.get(r)), l === void 0 ? `// [jogak] unknown entry id: ${JSON.stringify(r)}
+      if (e.startsWith(P)) {
+        const m = e.slice(P.length), n = dt(m);
+        let u = k.get(n);
+        return u === void 0 && (await N(), u = k.get(n)), u === void 0 ? `// [jogak] unknown entry id: ${JSON.stringify(n)}
 export {}
-` : `import * as _user from ${JSON.stringify(l)}
+` : `import * as _user from ${JSON.stringify(u)}
 import { defaultRegistry } from '@jogak/core'
 
 const _meta = _user.default
@@ -299,7 +376,7 @@ delete _named.default
 const _jogaks = Object.values(_named).filter(
   (v) => v !== null && typeof v === 'object' && typeof v.name === 'string'
 )
-defaultRegistry.hydrateEntry(${JSON.stringify(r)}, _jogaks, _meta?.component)
+defaultRegistry.hydrateEntry(${JSON.stringify(n)}, _jogaks, _meta?.component)
 
 if (import.meta.hot) {
   import.meta.hot.accept()
@@ -309,60 +386,60 @@ export {}
 `;
       }
     },
-    async handleHotUpdate({ file: e, modules: d }) {
-      const r = /\.jogak\.(tsx?|jsx?)$/.test(e), l = /\.(tsx?|jsx?)$/.test(e) && !r;
-      if (!r && !l || u === void 0 || !r) return;
-      const n = u.moduleGraph.getModuleById(
-        E
-      ), v = S.get(e), j = v !== void 0 ? M + at(v) : void 0, i = j !== void 0 ? u.moduleGraph.getModuleById(j) : void 0;
-      let f = null, C = {}, I = "";
-      if (m !== void 0) {
+    async handleHotUpdate({ file: e, modules: m }) {
+      const n = /\.jogak\.(tsx?|jsx?)$/.test(e), u = /\.(tsx?|jsx?)$/.test(e) && !n;
+      if (!n && !u || d === void 0 || !n) return;
+      const i = d.moduleGraph.getModuleById(
+        x
+      ), v = I.get(e), h = v !== void 0 ? P + ut(v) : void 0, s = h !== void 0 ? d.moduleGraph.getModuleById(h) : void 0;
+      let p = null, E = {}, A = "";
+      if (f !== void 0) {
         try {
-          f = await m.extractMeta(e);
+          p = await f.extractMeta(e);
         } catch {
-          f = null;
+          p = null;
         }
         try {
-          C = await m.extract(e);
+          E = await f.extract(e);
         } catch {
-          C = {};
+          E = {};
         }
         try {
-          I = await L(e, "utf8");
+          A = await U(e, "utf8");
         } catch {
-          I = "";
+          A = "";
         }
       }
-      if (f === null) {
-        n !== void 0 && u.moduleGraph.invalidateModule(n), i !== void 0 && u.moduleGraph.invalidateModule(i), u.ws.send({ type: "full-reload" });
+      if (p === null) {
+        i !== void 0 && d.moduleGraph.invalidateModule(i), s !== void 0 && d.moduleGraph.invalidateModule(s), d.ws.send({ type: "full-reload" });
         return;
       }
-      const N = D(f), J = b.get(e), B = it(J, N);
-      if (b.set(e, N), !B || v === void 0) {
-        n !== void 0 && u.moduleGraph.invalidateModule(n), i !== void 0 && u.moduleGraph.invalidateModule(i), u.ws.send({ type: "full-reload" });
+      const V = J(p), Q = b.get(e), Z = pt(Q, V);
+      if (b.set(e, V), !Z || v === void 0) {
+        i !== void 0 && d.moduleGraph.invalidateModule(i), s !== void 0 && d.moduleGraph.invalidateModule(s), d.ws.send({ type: "full-reload" });
         return;
       }
-      const K = {
+      const q = {
         id: v,
-        title: f.title,
-        jogakNames: f.jogakNames,
-        autoArgTypes: C,
-        userArgTypes: f.userArgTypes,
-        source: I,
+        title: p.title,
+        jogakNames: p.jogakNames,
+        autoArgTypes: E,
+        userArgTypes: p.userArgTypes,
+        source: A,
         filePath: e,
-        metaExtras: f.metaExtras
+        metaExtras: p.metaExtras
       };
-      i !== void 0 && u.moduleGraph.invalidateModule(i), u.ws.send({
+      s !== void 0 && d.moduleGraph.invalidateModule(s), d.ws.send({
         type: "custom",
         event: "jogak:meta-update",
-        data: { id: v, meta: K }
+        data: { id: v, meta: q }
       });
-      const x = [...d];
-      return i !== void 0 && !x.includes(i) && x.push(i), x;
+      const O = [...m];
+      return s !== void 0 && !O.includes(s) && O.push(s), O;
     }
   };
 }
-function ct() {
+function yt() {
   return `(rawId) => {
     if (typeof Buffer !== 'undefined') return Buffer.from(rawId, 'utf8').toString('base64url')
     // 브라우저 폴백: btoa는 binary string 기준이라 UTF-8을 한번 인코딩해야 한다.
@@ -373,5 +450,6 @@ function ct() {
   }`;
 }
 export {
-  gt as jogak
+  Et as jogak,
+  kt as jogakPreviewFramePlugin
 };

package/dist/vite/plugin.d.ts

@@ -1,3 +1,4 @@
 import { Plugin } from 'vite';
 import { JogakPluginOptions } from '../types.js';
 export declare function jogak(options?: JogakPluginOptions): Plugin;
+export { jogakPreviewFramePlugin, type JogakPreviewFramePluginOptions, } from './preview-frame-plugin.js';

package/dist/vite/preview-frame-plugin.d.ts

@@ -0,0 +1,21 @@
+import { Plugin } from 'vite';
+import { JogakPluginOptions } from '../types.js';
+/**
+ * 알파.8: 사용자 vite scope에서 preview-frame iframe entry를 emit하는 plugin.
+ *
+ * jogak CLI의 `spawnUserVite`가 사용자 vite.config.ts에 `mergeConfig`로 자동 inject
+ * — 사용자가 직접 등록할 필요 없음.
+ *
+ * 책임:
+ * 1. `/__jogak_preview__/index.html` middleware: jogak preview-entry를 로드하는 HTML 응답
+ * 2. `virtual:jogak/preview-entry` 가상 모듈: postMessage 리스너 + reactAdapter.render
+ * 3. `virtual:jogak/preview-global-css` 가상 모듈: 사용자 globalCss를 사용자 vite의
+ *    `@tailwindcss/vite` 등 정상 css 파이프라인을 통해 컴파일
+ */
+export interface JogakPreviewFramePluginOptions {
+    /** 사용자 프로젝트 root (cwd). globalCss 자동 탐지 base. */
+    readonly userRoot: string;
+    /** 사용자 globalCss (jogak.config.ts의 globalCss와 동일 의미). */
+    readonly globalCss?: JogakPluginOptions['globalCss'];
+}
+export declare function jogakPreviewFramePlugin(options: JogakPreviewFramePluginOptions): Plugin;