@jogak/core 0.1.0-alpha.0 → 0.1.0-alpha.10.2

package/dist/plugin-DhT-PH1R.js

@@ -0,0 +1,354 @@
+import { resolve as j, join as V, dirname as q } from "node:path";
+import { existsSync as E, readFileSync as H } from "node:fs";
+import { stat as P, rm as z, readdir as Q, readFile as L } from "node:fs/promises";
+import { r as Z } from "./detect-global-css-CIVMmgzy.js";
+import { c as U } from "./extractor-client-CReBed7x.js";
+const tt = [
+  "@jogak/core",
+  "@jogak/react",
+  "@jogak/web-components",
+  "@jogak/next"
+];
+async function J(t) {
+  try {
+    const c = await P(t);
+    if (!c.isDirectory())
+      return c.mtimeMs;
+  } catch {
+    return 0;
+  }
+  let r = 0, u;
+  try {
+    u = await Q(t);
+  } catch {
+    return 0;
+  }
+  for (const c of u) {
+    const m = V(t, c);
+    try {
+      const s = await P(m);
+      if (s.isDirectory()) {
+        const p = await J(m);
+        p > r && (r = p);
+      } else s.mtimeMs > r && (r = s.mtimeMs);
+    } catch {
+      continue;
+    }
+  }
+  return r;
+}
+async function et(t) {
+  const r = j(t.root, "node_modules/.vite/deps");
+  if (!E(r))
+    return { purged: !1 };
+  const u = V(r, "_metadata.json");
+  if (!E(u))
+    return { purged: !1 };
+  let c;
+  try {
+    c = (await P(u)).mtimeMs;
+  } catch (s) {
+    return t.logger.warn(
+      `[jogak] cache validation: failed to stat _metadata.json (${s.message})`
+    ), { purged: !1 };
+  }
+  const m = t.packages ?? tt;
+  for (const s of m) {
+    const p = j(t.root, "node_modules", s, "dist");
+    if (!E(p)) continue;
+    let y;
+    try {
+      y = await J(p);
+    } catch (h) {
+      t.logger.warn(
+        `[jogak] cache validation: failed to walk ${s}/dist (${h.message})`
+      );
+      continue;
+    }
+    if (y > c + 1e3)
+      try {
+        return await z(r, { recursive: !0, force: !0 }), t.logger.info(
+          `[jogak] vite deps cache invalidated (stale): ${s} dist newer than cache`
+        ), { purged: !0, reason: s };
+      } catch (h) {
+        return t.logger.warn(
+          `[jogak] cache validation: failed to purge ${r} (${h.message})`
+        ), { purged: !1 };
+      }
+  }
+  return { purged: !1 };
+}
+function rt(t) {
+  return t.replace(/\/\*[\s\S]*?\*\//g, "").replace(/^\s*\/\/.*$/gm, "");
+}
+function ot(t) {
+  if (E(t))
+    try {
+      const r = H(t, "utf8");
+      return JSON.parse(rt(r));
+    } catch {
+      return;
+    }
+}
+function at(t, r, u) {
+  if (!t.endsWith("/*") || !r.endsWith("/*")) return;
+  const c = t.slice(0, -2), m = j(u, r.slice(0, -2));
+  return [c, m];
+}
+function nt(t, r) {
+  var m, s;
+  const u = {}, c = /* @__PURE__ */ new Set([
+    t,
+    j(r, "tsconfig.app.json")
+  ]);
+  for (const p of c) {
+    const y = ot(p);
+    if (y === void 0) continue;
+    const h = (m = y.compilerOptions) == null ? void 0 : m.paths;
+    if (h === void 0) continue;
+    const b = ((s = y.compilerOptions) == null ? void 0 : s.baseUrl) ?? ".", T = j(q(p), b);
+    for (const [C, l] of Object.entries(h)) {
+      const d = l[0];
+      if (d === void 0) continue;
+      const _ = at(C, d, T);
+      if (_ === void 0) continue;
+      const [k, x] = _;
+      u[k] === void 0 && (u[k] = x);
+    }
+  }
+  return u;
+}
+const G = "virtual:jogak", M = "\0" + G, B = "virtual:jogak/entry/", N = "\0" + B, K = "virtual:jogak/global-css", D = "\0" + K;
+function st(t) {
+  return Buffer.from(t, "utf8").toString("base64url");
+}
+function it(t) {
+  return Buffer.from(t, "base64url").toString("utf8");
+}
+function F(t) {
+  return {
+    title: t.title,
+    jogakNamesKey: [...t.jogakNames].sort().join("|")
+  };
+}
+function ct(t, r) {
+  return t !== void 0 && t.title === r.title && t.jogakNamesKey === r.jogakNamesKey;
+}
+function pt(t = {}) {
+  const {
+    patterns: r = ["src/**/*.jogak.ts", "src/**/*.jogak.tsx"],
+    codeTheme: u = "vsDark"
+  } = t, c = t.cwd, m = t.tsConfigFilePath, s = t.disableCacheValidation === !0, p = t.resolveAlias, y = t.globalCss, h = t.previewIsolation ?? "iframe", b = t.previewFrame === !0, T = t.userPreviewUrl ?? t.userViteUrl ?? "", C = t.previewEntryPath ?? "/__jogak_preview__/index.html";
+  let l, d, _;
+  const k = /* @__PURE__ */ new Map(), x = /* @__PURE__ */ new Map(), I = /* @__PURE__ */ new Map();
+  async function R() {
+    const { glob: e } = await import("glob"), f = _ ?? process.cwd(), o = (await e(r, { cwd: f, absolute: !0 })).sort(), i = [];
+    k.clear(), x.clear();
+    for (const a of o) {
+      let v = "";
+      try {
+        v = await L(a, "utf8");
+      } catch {
+        continue;
+      }
+      let w = {}, n = null;
+      if (d !== void 0) {
+        try {
+          w = await d.extract(a);
+        } catch {
+          w = {};
+        }
+        try {
+          n = await d.extractMeta(a);
+        } catch {
+          n = null;
+        }
+      }
+      if (n === null) continue;
+      const g = n.title;
+      k.set(g, a), x.set(a, g);
+      const S = {
+        id: g,
+        title: n.title,
+        jogakNames: n.jogakNames,
+        autoArgTypes: w,
+        userArgTypes: n.userArgTypes,
+        source: v,
+        filePath: a,
+        metaExtras: n.metaExtras
+      };
+      I.set(a, F(S)), i.push({ id: g, filePath: a, meta: S });
+    }
+    return i;
+  }
+  return {
+    name: "vite-plugin-jogak",
+    /**
+     * 사용자 path alias 주입.
+     *
+     * `runHost`는 vite root를 `@jogak/ui` 패키지로 두고 사용자 `vite.config.ts`를
+     * 무시하므로(`configFile: false`), 사용자가 컴포넌트 안에서 쓰는 `@/lib/utils`
+     * 같은 alias가 그냥은 적용되지 않는다. 본 hook이 사용자 tsconfig의
+     * `compilerOptions.paths`를 vite `resolve.alias`로 자동 변환해 주입한다.
+     *
+     * 우선순위: `options.resolveAlias` (명시) > tsconfig 자동 추출.
+     */
+    config() {
+      const e = c ?? process.cwd(), f = m ?? j(e, "tsconfig.json"), o = nt(f, e), i = {};
+      if (p !== void 0)
+        for (const [v, w] of Object.entries(p))
+          i[v] = j(e, w);
+      const a = { ...o, ...i };
+      if (Object.keys(a).length !== 0)
+        return {
+          resolve: { alias: a }
+        };
+    },
+    async configResolved(e) {
+      _ = c ?? e.root, e.command === "serve" && !s && await et({
+        root: e.root,
+        logger: {
+          info: (o) => e.logger.info(o),
+          warn: (o) => e.logger.warn(o)
+        }
+      });
+      const f = m ?? j(_, "tsconfig.json");
+      d = E(f) ? U({ tsConfigFilePath: f }) : U();
+    },
+    configureServer(e) {
+      l = e;
+    },
+    buildEnd() {
+      d == null || d.releaseCache();
+    },
+    resolveId(e) {
+      if (e === G)
+        return M;
+      if (e === K)
+        return D;
+      if (e.startsWith(B))
+        return "\0" + e;
+    },
+    async load(e) {
+      if (e === D) {
+        const f = _ ?? process.cwd(), o = Z(y, f);
+        return o.length === 0 ? `// [jogak] globalCss not configured or no candidates found.
+export {}
+` : `${o.map((a) => `import ${JSON.stringify(a)}`).join(`
+`)}
+export {}
+`;
+      }
+      if (e === M) {
+        const o = (await R()).map((a) => a.meta), i = b ? "" : `
+export const _jogakCodeTheme = ${JSON.stringify(u)}
+export const _jogakPreviewIsolation = ${JSON.stringify(h)}
+export const _jogakUserPreviewUrl = ${JSON.stringify(T)}
+export const _jogakPreviewEntryPath = ${JSON.stringify(C)}
+export const _jogakUserViteUrl = ${JSON.stringify(T)}
+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 = ${lt()}
+  return _entryLoader(slug(id))
+})
+
+const _metas = ${JSON.stringify(o)}
+
+for (const m of _metas) defaultRegistry.registerMeta(m)
+${i}`;
+      }
+      if (e.startsWith(N)) {
+        const f = e.slice(N.length), o = it(f);
+        let i = k.get(o);
+        return i === void 0 && (await R(), i = k.get(o)), i === void 0 ? `// [jogak] unknown entry id: ${JSON.stringify(o)}
+export {}
+` : `import * as _user from ${JSON.stringify(i)}
+import { defaultRegistry } from '@jogak/core'
+
+const _meta = _user.default
+const _named = { ..._user }
+delete _named.default
+const _jogaks = Object.values(_named).filter(
+  (v) => v !== null && typeof v === 'object' && typeof v.name === 'string'
+)
+defaultRegistry.hydrateEntry(${JSON.stringify(o)}, _jogaks, _meta?.component)
+
+if (import.meta.hot) {
+  import.meta.hot.accept()
+}
+
+export {}
+`;
+      }
+    },
+    async handleHotUpdate({ file: e, modules: f }) {
+      const o = /\.jogak\.(tsx?|jsx?)$/.test(e), i = /\.(tsx?|jsx?)$/.test(e) && !o;
+      if (!o && !i || l === void 0 || !o) return;
+      const a = l.moduleGraph.getModuleById(
+        M
+      ), v = x.get(e), w = v !== void 0 ? N + st(v) : void 0, n = w !== void 0 ? l.moduleGraph.getModuleById(w) : void 0;
+      let g = null, S = {}, O = "";
+      if (d !== void 0) {
+        try {
+          g = await d.extractMeta(e);
+        } catch {
+          g = null;
+        }
+        try {
+          S = await d.extract(e);
+        } catch {
+          S = {};
+        }
+        try {
+          O = await L(e, "utf8");
+        } catch {
+          O = "";
+        }
+      }
+      if (g === null) {
+        a !== void 0 && l.moduleGraph.invalidateModule(a), n !== void 0 && l.moduleGraph.invalidateModule(n), l.ws.send({ type: "full-reload" });
+        return;
+      }
+      const $ = F(g), W = I.get(e), X = ct(W, $);
+      if (I.set(e, $), !X || v === void 0) {
+        a !== void 0 && l.moduleGraph.invalidateModule(a), n !== void 0 && l.moduleGraph.invalidateModule(n), l.ws.send({ type: "full-reload" });
+        return;
+      }
+      const Y = {
+        id: v,
+        title: g.title,
+        jogakNames: g.jogakNames,
+        autoArgTypes: S,
+        userArgTypes: g.userArgTypes,
+        source: O,
+        filePath: e,
+        metaExtras: g.metaExtras
+      };
+      n !== void 0 && l.moduleGraph.invalidateModule(n), l.ws.send({
+        type: "custom",
+        event: "jogak:meta-update",
+        data: { id: v, meta: Y }
+      });
+      const A = [...f];
+      return n !== void 0 && !A.includes(n) && A.push(n), A;
+    }
+  };
+}
+function lt() {
+  return `(rawId) => {
+    if (typeof Buffer !== 'undefined') return Buffer.from(rawId, 'utf8').toString('base64url')
+    // 브라우저 폴백: btoa는 binary string 기준이라 UTF-8을 한번 인코딩해야 한다.
+    const enc = new TextEncoder().encode(rawId)
+    let bin = ''
+    for (let i = 0; i < enc.length; i++) bin += String.fromCharCode(enc[i])
+    return btoa(bin).replace(/\\+/g, '-').replace(/\\//g, '_').replace(/=+$/, '')
+  }`;
+}
+export {
+  pt as j
+};

package/dist/plugin-Wtlz0hae.cjs

@@ -0,0 +1,50 @@
+"use strict";var X=Object.create;var L=Object.defineProperty;var Y=Object.getOwnPropertyDescriptor;var H=Object.getOwnPropertyNames;var z=Object.getPrototypeOf,Q=Object.prototype.hasOwnProperty;var Z=(e,r,s,c)=>{if(r&&typeof r=="object"||typeof r=="function")for(let n of H(r))!Q.call(e,n)&&n!==s&&L(e,n,{get:()=>r[n],enumerable:!(c=Y(r,n))||c.enumerable});return e};var ee=(e,r,s)=>(s=e!=null?X(z(e)):{},Z(r||!e||!e.__esModule?L(s,"default",{value:e,enumerable:!0}):s,e));const v=require("node:path"),E=require("node:fs"),S=require("node:fs/promises"),te=require("./detect-global-css-CDcuUAYE.cjs"),U=require("./extractor-client-CiWszHel.cjs"),re=["@jogak/core","@jogak/react","@jogak/web-components","@jogak/next"];async function V(e){try{const c=await S.stat(e);if(!c.isDirectory())return c.mtimeMs}catch{return 0}let r=0,s;try{s=await S.readdir(e)}catch{return 0}for(const c of s){const n=v.join(e,c);try{const l=await S.stat(n);if(l.isDirectory()){const p=await V(n);p>r&&(r=p)}else l.mtimeMs>r&&(r=l.mtimeMs)}catch{continue}}return r}async function oe(e){const r=v.resolve(e.root,"node_modules/.vite/deps");if(!E.existsSync(r))return{purged:!1};const s=v.join(r,"_metadata.json");if(!E.existsSync(s))return{purged:!1};let c;try{c=(await S.stat(s)).mtimeMs}catch(l){return e.logger.warn(`[jogak] cache validation: failed to stat _metadata.json (${l.message})`),{purged:!1}}const n=e.packages??re;for(const l of n){const p=v.resolve(e.root,"node_modules",l,"dist");if(!E.existsSync(p))continue;let h;try{h=await V(p)}catch(w){e.logger.warn(`[jogak] cache validation: failed to walk ${l}/dist (${w.message})`);continue}if(h>c+1e3)try{return await S.rm(r,{recursive:!0,force:!0}),e.logger.info(`[jogak] vite deps cache invalidated (stale): ${l} dist newer than cache`),{purged:!0,reason:l}}catch(w){return e.logger.warn(`[jogak] cache validation: failed to purge ${r} (${w.message})`),{purged:!1}}}return{purged:!1}}function ae(e){return e.replace(/\/\*[\s\S]*?\*\//g,"").replace(/^\s*\/\/.*$/gm,"")}function se(e){if(E.existsSync(e))try{const r=E.readFileSync(e,"utf8");return JSON.parse(ae(r))}catch{return}}function ne(e,r,s){if(!e.endsWith("/*")||!r.endsWith("/*"))return;const c=e.slice(0,-2),n=v.resolve(s,r.slice(0,-2));return[c,n]}function ie(e,r){var n,l;const s={},c=new Set([e,v.resolve(r,"tsconfig.app.json")]);for(const p of c){const h=se(p);if(h===void 0)continue;const w=(n=h.compilerOptions)==null?void 0:n.paths;if(w===void 0)continue;const T=((l=h.compilerOptions)==null?void 0:l.baseUrl)??".",b=v.resolve(v.dirname(p),T);for(const[I,d]of Object.entries(w)){const f=d[0];if(f===void 0)continue;const _=ne(I,f,b);if(_===void 0)continue;const[k,C]=_;s[k]===void 0&&(s[k]=C)}}return s}const J="virtual:jogak",N="\0"+J,G="virtual:jogak/entry/",P="\0"+G,B="virtual:jogak/global-css",D="\0"+B;function ce(e){return Buffer.from(e,"utf8").toString("base64url")}function le(e){return Buffer.from(e,"base64url").toString("utf8")}function F(e){return{title:e.title,jogakNamesKey:[...e.jogakNames].sort().join("|")}}function ue(e,r){return e!==void 0&&e.title===r.title&&e.jogakNamesKey===r.jogakNamesKey}function de(e={}){const{patterns:r=["src/**/*.jogak.ts","src/**/*.jogak.tsx"],codeTheme:s="vsDark"}=e,c=e.cwd,n=e.tsConfigFilePath,l=e.disableCacheValidation===!0,p=e.resolveAlias,h=e.globalCss,w=e.previewIsolation??"iframe",T=e.previewFrame===!0,b=e.userPreviewUrl??e.userViteUrl??"",I=e.previewEntryPath??"/__jogak_preview__/index.html";let d,f,_;const k=new Map,C=new Map,O=new Map;async function R(){const{glob:t}=await import("glob"),g=_??process.cwd(),o=(await t(r,{cwd:g,absolute:!0})).sort(),u=[];k.clear(),C.clear();for(const a of o){let y="";try{y=await S.readFile(a,"utf8")}catch{continue}let j={},i=null;if(f!==void 0){try{j=await f.extract(a)}catch{j={}}try{i=await f.extractMeta(a)}catch{i=null}}if(i===null)continue;const m=i.title;k.set(m,a),C.set(a,m);const x={id:m,title:i.title,jogakNames:i.jogakNames,autoArgTypes:j,userArgTypes:i.userArgTypes,source:y,filePath:a,metaExtras:i.metaExtras};O.set(a,F(x)),u.push({id:m,filePath:a,meta:x})}return u}return{name:"vite-plugin-jogak",config(){const t=c??process.cwd(),g=n??v.resolve(t,"tsconfig.json"),o=ie(g,t),u={};if(p!==void 0)for(const[y,j]of Object.entries(p))u[y]=v.resolve(t,j);const a={...o,...u};if(Object.keys(a).length!==0)return{resolve:{alias:a}}},async configResolved(t){_=c??t.root,t.command==="serve"&&!l&&await oe({root:t.root,logger:{info:o=>t.logger.info(o),warn:o=>t.logger.warn(o)}});const g=n??v.resolve(_,"tsconfig.json");f=E.existsSync(g)?U.createPropsExtractor({tsConfigFilePath:g}):U.createPropsExtractor()},configureServer(t){d=t},buildEnd(){f==null||f.releaseCache()},resolveId(t){if(t===J)return N;if(t===B)return D;if(t.startsWith(G))return"\0"+t},async load(t){if(t===D){const g=_??process.cwd(),o=te.resolveGlobalCssPaths(h,g);return o.length===0?`// [jogak] globalCss not configured or no candidates found.
+export {}
+`:`${o.map(a=>`import ${JSON.stringify(a)}`).join(`
+`)}
+export {}
+`}if(t===N){const o=(await R()).map(a=>a.meta),u=T?"":`
+export const _jogakCodeTheme = ${JSON.stringify(s)}
+export const _jogakPreviewIsolation = ${JSON.stringify(w)}
+export const _jogakUserPreviewUrl = ${JSON.stringify(b)}
+export const _jogakPreviewEntryPath = ${JSON.stringify(I)}
+export const _jogakUserViteUrl = ${JSON.stringify(b)}
+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 = ${fe()}
+  return _entryLoader(slug(id))
+})
+
+const _metas = ${JSON.stringify(o)}
+
+for (const m of _metas) defaultRegistry.registerMeta(m)
+${u}`}if(t.startsWith(P)){const g=t.slice(P.length),o=le(g);let u=k.get(o);return u===void 0&&(await R(),u=k.get(o)),u===void 0?`// [jogak] unknown entry id: ${JSON.stringify(o)}
+export {}
+`:`import * as _user from ${JSON.stringify(u)}
+import { defaultRegistry } from '@jogak/core'
+
+const _meta = _user.default
+const _named = { ..._user }
+delete _named.default
+const _jogaks = Object.values(_named).filter(
+  (v) => v !== null && typeof v === 'object' && typeof v.name === 'string'
+)
+defaultRegistry.hydrateEntry(${JSON.stringify(o)}, _jogaks, _meta?.component)
+
+if (import.meta.hot) {
+  import.meta.hot.accept()
+}
+
+export {}
+`}},async handleHotUpdate({file:t,modules:g}){const o=/\.jogak\.(tsx?|jsx?)$/.test(t),u=/\.(tsx?|jsx?)$/.test(t)&&!o;if(!o&&!u||d===void 0||!o)return;const a=d.moduleGraph.getModuleById(N),y=C.get(t),j=y!==void 0?P+ce(y):void 0,i=j!==void 0?d.moduleGraph.getModuleById(j):void 0;let m=null,x={},A="";if(f!==void 0){try{m=await f.extractMeta(t)}catch{m=null}try{x=await f.extract(t)}catch{x={}}try{A=await S.readFile(t,"utf8")}catch{A=""}}if(m===null){a!==void 0&&d.moduleGraph.invalidateModule(a),i!==void 0&&d.moduleGraph.invalidateModule(i),d.ws.send({type:"full-reload"});return}const $=F(m),q=O.get(t),K=ue(q,$);if(O.set(t,$),!K||y===void 0){a!==void 0&&d.moduleGraph.invalidateModule(a),i!==void 0&&d.moduleGraph.invalidateModule(i),d.ws.send({type:"full-reload"});return}const W={id:y,title:m.title,jogakNames:m.jogakNames,autoArgTypes:x,userArgTypes:m.userArgTypes,source:A,filePath:t,metaExtras:m.metaExtras};i!==void 0&&d.moduleGraph.invalidateModule(i),d.ws.send({type:"custom",event:"jogak:meta-update",data:{id:y,meta:W}});const M=[...g];return i!==void 0&&!M.includes(i)&&M.push(i),M}}}function fe(){return`(rawId) => {
+    if (typeof Buffer !== 'undefined') return Buffer.from(rawId, 'utf8').toString('base64url')
+    // 브라우저 폴백: btoa는 binary string 기준이라 UTF-8을 한번 인코딩해야 한다.
+    const enc = new TextEncoder().encode(rawId)
+    let bin = ''
+    for (let i = 0; i < enc.length; i++) bin += String.fromCharCode(enc[i])
+    return btoa(bin).replace(/\\+/g, '-').replace(/\\//g, '_').replace(/=+$/, '')
+  }`}exports.jogak=de;

package/dist/preview-entry/protocol.d.ts

@@ -0,0 +1,29 @@
+/**
+ * 알파.9: jogak chrome ↔ preview iframe 간 postMessage 통신 프로토콜.
+ *
+ * 모든 어댑터(vite/next/webpack/standalone)가 동일 프로토콜 사용. iframe 안 entry source는
+ * cross-origin 환경에서도 작동하도록 `targetOrigin: '*'`. preview는 사용자 본인 컴포넌트만
+ * mount하는 신뢰 환경이므로 origin 검증은 README 명시 후 생략.
+ */
+/**
+ * 부모(jogak SPA) → iframe (preview entry).
+ */
+export type JogakMessageToFrame = {
+    readonly type: 'jogak:setProps';
+    readonly entryId: string;
+    readonly args: Readonly<Record<string, unknown>>;
+} | {
+    readonly type: 'jogak:unmount';
+};
+/**
+ * iframe (preview entry) → 부모(jogak SPA).
+ */
+export type JogakMessageFromFrame = {
+    readonly type: 'jogak:ready';
+} | {
+    readonly type: 'jogak:rendered';
+    readonly entryId: string;
+} | {
+    readonly type: 'jogak:error';
+    readonly message: string;
+};

package/dist/preview-entry/source.d.ts

@@ -0,0 +1,30 @@
+/**
+ * 알파.9: 모든 빌더 어댑터가 공통으로 사용하는 preview entry source.
+ *
+ * 빌더에 무관하게 다음 책임:
+ * 1. `defaultRegistry.requestEntry(entryId)`로 사용자 컴포넌트 dynamic import
+ * 2. `reactAdapter.render`로 mount
+ * 3. postMessage 프로토콜 (`@jogak/core/preview-entry/protocol`)로 부모와 통신
+ *
+ * 어댑터별 차이는 `extraImports` 배열뿐:
+ * - vite-adapter: `['virtual:jogak/preview-global-css']`
+ * - next-adapter: 사용자 globalCss 절대 경로 직접 inject
+ * - webpack-adapter: 사용자 globalCss 절대 경로
+ * - standalone-adapter: 사용자 사전 빌드 css 절대 경로
+ */
+export interface RenderPreviewEntryOptions {
+    /**
+     * 어댑터별 추가 import 라인. 라인 순서대로 emit되어 cascade order 결정.
+     *
+     * @example vite-adapter
+     * ['virtual:jogak/preview-global-css']
+     *
+     * @example next-adapter
+     * ['/abs/path/src/index.css']
+     */
+    readonly extraImports?: readonly string[];
+}
+/**
+ * 어댑터가 호출 — 자기 scope에 맞는 추가 import 라인 주입.
+ */
+export declare function renderPreviewEntrySource(opts?: RenderPreviewEntryOptions): string;