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

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;

package/dist/server.cjs

@@ -0,0 +1 @@
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const o=require("node:fs"),l=require("node:path"),u=require("./detect-global-css-CDcuUAYE.cjs"),d=["ts","js","mjs","cjs"],b=["ts","js","mjs","cjs"],j=["ts","mts","js","mjs","cjs"];function h(s){const e=C(s),n={...(e==null?void 0:e.dependencies)??{},...(e==null?void 0:e.devDependencies)??{}},t=a(s,d,"next.config"),f="next"in n,p="react-scripts"in n,i=a(s,b,"webpack.config"),g="webpack"in n,r=a(s,j,"vite.config");if(t||f){const c=[];return r&&c.push("vite.config.* (마이그레이션 중?)"),{name:"next",signal:t?"next.config.*":"package.json: next dep",...c.length>0?{ambiguous:c}:{}}}return p?{name:"webpack",signal:"package.json: react-scripts dep (CRA)"}:i||g?{name:"webpack",signal:i?"webpack.config.*":"package.json: webpack dep"}:r?{name:"vite",signal:"vite.config.*"}:{name:"standalone",signal:"(no builder signals)"}}function a(s,e,n){for(const t of e)if(o.existsSync(l.resolve(s,`${n}.${t}`)))return!0;return!1}function C(s){const e=l.resolve(s,"package.json");if(o.existsSync(e))try{const n=o.readFileSync(e,"utf-8");return JSON.parse(n)}catch{return}}exports.detectUserGlobalCss=u.detectUserGlobalCss;exports.resolveGlobalCssPaths=u.resolveGlobalCssPaths;exports.detectBuilder=h;

package/dist/server.d.ts

@@ -0,0 +1,12 @@
+/**
+ * 알파.9: server-only 유틸리티 (Node.js only).
+ *
+ * 본 subpath의 함수들은 `node:fs`/`node:path`를 사용하므로 브라우저 client 번들에
+ * 포함되어서는 안 된다. CLI / 어댑터 / Vite plugin 등 Node 환경에서만 import.
+ *
+ * 사용처:
+ * - `@jogak/cli`: detectBuilder
+ * - `@jogak/vite-adapter` / `@jogak/next-adapter` / `@jogak/webpack-adapter`: resolveGlobalCssPaths
+ */
+export { detectBuilder, type DetectBuilderResult, } from './builder-detect.js';
+export { detectUserGlobalCss, resolveGlobalCssPaths, } from './vite/detect-global-css.js';

package/dist/server.mjs

@@ -0,0 +1,45 @@
+import { existsSync as r, readFileSync as u } from "node:fs";
+import { resolve as f } from "node:path";
+import { d as N, r as S } from "./detect-global-css-CIVMmgzy.js";
+const m = ["ts", "js", "mjs", "cjs"], d = ["ts", "js", "mjs", "cjs"], j = ["ts", "mts", "js", "mjs", "cjs"];
+function k(n) {
+  const e = b(n), s = {
+    ...(e == null ? void 0 : e.dependencies) ?? {},
+    ...(e == null ? void 0 : e.devDependencies) ?? {}
+  }, t = c(n, m, "next.config"), p = "next" in s, g = "react-scripts" in s, o = c(n, d, "webpack.config"), l = "webpack" in s, i = c(n, j, "vite.config");
+  if (t || p) {
+    const a = [];
+    return i && a.push("vite.config.* (마이그레이션 중?)"), {
+      name: "next",
+      signal: t ? "next.config.*" : "package.json: next dep",
+      ...a.length > 0 ? { ambiguous: a } : {}
+    };
+  }
+  return g ? {
+    name: "webpack",
+    signal: "package.json: react-scripts dep (CRA)"
+  } : o || l ? {
+    name: "webpack",
+    signal: o ? "webpack.config.*" : "package.json: webpack dep"
+  } : i ? { name: "vite", signal: "vite.config.*" } : { name: "standalone", signal: "(no builder signals)" };
+}
+function c(n, e, s) {
+  for (const t of e)
+    if (r(f(n, `${s}.${t}`))) return !0;
+  return !1;
+}
+function b(n) {
+  const e = f(n, "package.json");
+  if (r(e))
+    try {
+      const s = u(e, "utf-8");
+      return JSON.parse(s);
+    } catch {
+      return;
+    }
+}
+export {
+  k as detectBuilder,
+  N as detectUserGlobalCss,
+  S as resolveGlobalCssPaths
+};

package/dist/types.d.ts

@@ -251,15 +251,27 @@ export interface JogakPluginOptions {
      */
     readonly previewFrame?: boolean;
     /**
-     * 알파.8 internal: jogak SPA가 iframe src로 사용할 사용자 vite의 base URL
-     * (예: `http://localhost:5174`). CLI가 spawnUserVite 결과를 `runHost` 통해
-     * jogak() plugin에 전달한다.
+     * @deprecated 알파.10 제거 예정. `userPreviewUrl` 사용.
      *
-     * 빈 문자열 또는 미지정 시 기존 fallback (jogak SPA Vite scope의 preview-frame.tsx).
+     * 알파.8 internal: jogak SPA가 iframe src로 사용할 사용자 vite의 base URL.
+     */
+    readonly userViteUrl?: string;
+    /**
+     * 알파.9 internal: jogak SPA가 iframe src로 사용할 어댑터 dev URL
+     * (예: `http://localhost:5174`). CLI의 어댑터 dispatch 결과가 host 통해 plugin에 전달.
+     *
+     * 빈 문자열 시 fallback (jogak SPA Vite scope의 preview-frame).
      *
      * 사용자가 직접 설정하는 옵션이 아니다.
      */
-    readonly userViteUrl?: string;
+    readonly userPreviewUrl?: string;
+    /**
+     * 알파.9 internal: iframe src의 path (예: `/__jogak_preview__/index.html`).
+     * `BuilderAdapter.previewEntryMeta.devEntryPath` 값. 어댑터별 routing.
+     *
+     * 사용자가 직접 설정하는 옵션이 아니다.
+     */
+    readonly previewEntryPath?: string;
 }
 /**
  * 알파.8: 사용자 vite 인스턴스 spawn 옵션.

package/dist/vite/index.cjs

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