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

package/CHANGELOG.md

@@ -5,6 +5,118 @@ All notable changes to Jogak packages are documented here. The repository follow
 
 Version numbers apply to all packages in the workspace (synchronized release).
 
+## [0.1.0-alpha.10.2] — 2026-05-09
+
+### Fixed
+
+- **vitest.workspace.ts**: 알파.10에서 7개 패키지 디렉토리를 삭제했지만 `vitest.workspace.ts`가 여전히 `packages/react`, `packages/next`, `packages/web-components`를 참조해 `pnpm test` 시 startup error. core/ui/cli 3개로 정리.
+
+기타 패키지: source 변경 없음, synchronized release 유지를 위해 버전만 bump.
+
+## [0.1.0-alpha.10.1] — 2026-05-09
+
+### Fixed
+
+- **CI typecheck**: 알파.10에서 root `tsconfig.json` references에 `packages/cli`를 추가했으나, `tsc -b`가 cli typecheck 시점에 ui의 `dist/host/index.d.ts` (실제 파일은 없음 — ui는 `noEmit: true`)를 찾으려 해 `Cannot find module '@jogak/ui/host'` 에러 발생. 알파.9 이전처럼 cli는 root references에서 제외 — cli는 자기 `pnpm build` 단계의 `tsc -p tsconfig.json`에서 typecheck됨 (그 시점엔 ui dist가 이미 빌드돼 있음).
+
+기타 패키지: source 변경 없음, synchronized release 유지를 위해 버전만 bump.
+
+## [0.1.0-alpha.10] — 2026-05-09
+
+### Architectural unification — 10 packages → 3 packages
+
+알파.9.x에서 분리됐던 4개 빌더 어댑터(`@jogak/vite-adapter`, `@jogak/next-adapter`, `@jogak/webpack-adapter`, `@jogak/standalone-adapter`)와 3개 프레임워크 렌더러(`@jogak/react`, `@jogak/next`, `@jogak/web-components`)를 모두 `@jogak/core`로 통합. 이들의 본질은 build-tool / runtime 통합 코드이며 별도 패키지로 격리할 만한 런타임 substance가 없다는 판단.
+
+이제 publish되는 패키지는 `@jogak/core`, `@jogak/ui`, `@jogak/cli` 3개로 축소. 기능은 모두 유지되며 사용자 install도 단순화 (vite/next/webpack peer deps는 모두 `peerDependenciesMeta.optional` 처리 — 사용자가 실제로 쓰는 빌더만 install).
+
+### Added
+
+- **`@jogak/core/adapters/{vite,next,webpack,standalone}`**: 4개 builder adapter subpath. `@jogak/${name}-adapter` 패키지를 흡수.
+- **`@jogak/core/renderers/{react,next,web-components}`**: 3개 framework renderer subpath. 동명 별도 패키지를 흡수.
+- **`@jogak/core/vite-plugin`**: 알파.9.x의 `@jogak/core/vite`를 정식 명명. 기존 `@jogak/core/vite`는 backward-compat alias로 유지.
+- **CLI `loadAdapter`**: 사용자 cwd의 `@jogak/core` exports를 직접 lookup해서 adapter dynamic import. 별도 어댑터 패키지 install 불필요.
+
+### Changed
+
+- **import 경로 마이그레이션** (사용자 영향):
+  - `import ... from '@jogak/react'` → `import ... from '@jogak/core/renderers/react'`
+  - `import ... from '@jogak/next'` → `import ... from '@jogak/core/renderers/next'`
+  - `import ... from '@jogak/web-components'` → `import ... from '@jogak/core/renderers/web-components'`
+  - `import { jogak } from '@jogak/core/vite'` → `import { jogak } from '@jogak/core/vite-plugin'` (구 경로도 동작하지만 deprecated)
+- **`@jogak/core` peer deps 확장**: react/react-dom/next/webpack/webpack-dev-server/webpack-merge/html-webpack-plugin 추가 (모두 optional). 사용자가 쓰는 빌더만 설치.
+- **iframe scaffold 코드** (next-adapter, webpack-adapter): 생성되는 page.tsx/preview-entry.tsx가 `@jogak/core/renderers/react`를 import (이전 `@jogak/react`).
+
+### Removed
+
+- 7개 패키지 디렉토리 + npm registry deprecate notice:
+  - `@jogak/react`, `@jogak/next`, `@jogak/web-components`
+  - `@jogak/vite-adapter`, `@jogak/next-adapter`, `@jogak/webpack-adapter`, `@jogak/standalone-adapter`
+- 알파.9.x 사용자는 `npm view @jogak/<pkg> deprecated` 메시지로 마이그레이션 안내 받음.
+
+### CI
+
+- `release.yml`: pack/publish 목록을 `core/ui/cli` 3개로 축소. Trusted Publisher 신규 등록 zero (3개 모두 알파.9 시점 등록 완료).
+
+## [0.1.0-alpha.9.2] — 2026-05-09
+
+### Fixed
+
+- **CI**: `release.yml`의 publish 단계가 `jogak-next-*.tgz` 글로브 패턴을 사용해 `next` 패키지 publish 시 `next-adapter` tarball까지 매치되어 npm publish가 EUSAGE(다중 tarball)으로 실패. 이로 인해 알파.9.1에서 `core/react/ui/web-components`만 publish되고 `next/cli` 및 4개 어댑터는 publish 안 됨. 정확한 파일명(`jogak-${pkg}-${VERSION}.tgz`)으로 변경.
+
+기타 패키지: source 변경 없음, synchronized release 유지를 위해 버전만 bump.
+
+## [0.1.0-alpha.9.1] — 2026-05-09
+
+### Fixed
+
+- **CI**: `release.yml`의 pack 단계가 `core/react/ui/web-components/next/cli`만 포함했고 알파.9에서 신규 추가된 4개 어댑터(`vite-adapter` / `next-adapter` / `webpack-adapter` / `standalone-adapter`)를 누락. v0.1.0-alpha.9 태그로 부분 publish됐으나 어댑터들이 npm에 올라가지 않아 사용자가 import 불가. 4개 어댑터를 pack 목록에 추가 후 alpha.9.1로 재발행.
+
+기타 패키지: source 변경 없음, synchronized release 유지를 위해 버전만 bump.
+
+## [0.1.0-alpha.9] — 2026-05-09
+
+### Added
+
+- **`@jogak/vite-adapter`**, **`@jogak/next-adapter`**, **`@jogak/webpack-adapter`**, **`@jogak/standalone-adapter`**: 새 builder-agnostic adapter 패키지군. CLI가 사용자 cwd의 빌더(`next.config`, `vite.config`, `webpack.config`)를 감지하여 해당 adapter를 dynamic import한다. 사용자 컴포넌트는 사용자의 정상 빌더 client에서 평가되므로 utility class compiler(Tailwind v4 등)이 자연스럽게 동작한다.
+- **`@jogak/core`**: `BuilderAdapter` ABI(`adapter.ts`), 빌더 자동 감지(`detectBuilder`, `@jogak/core/server`), preview entry 공통 source(`renderPreviewEntrySource`), postMessage 프로토콜(`@jogak/core/preview-entry/protocol`).
+- **`JogakPluginOptions.userPreviewUrl` / `previewEntryPath`**: adapter dispatch 결과를 host UI iframe src로 주입하는 통로. (`userViteUrl`은 alpha.8 호환을 위해 alias로 유지)
+- **`@jogak/next-adapter`**: Next 14+ App Router에 `<userRoot>/app/jogak-preview/page.tsx` scaffold(`.gitignore` 자동, shutdown cleanup). `next dev` child process spawn + HTTP poll ready 감지. CLI가 사전 생성한 `.jogak/registry.ts`의 entries를 import하여 모듈 평가 시점에 등록.
+- **`@jogak/webpack-adapter`**: `<userRoot>/.jogak/webpack-preview/preview-entry.tsx` scaffold + `webpack-dev-server` programmatic API + `webpack-merge`로 사용자 webpack.config 통합.
+
+### Changed
+
+- **`@jogak/core`**: `fs`/`path`를 사용하는 server-only utility(`detectBuilder`, `resolveGlobalCssPaths`, `detectUserGlobalCss`)를 `@jogak/core/server` subpath로 분리. client bundle에 Node 모듈이 leak되는 문제를 차단.
+- **`@jogak/core`**, **`@jogak/ui`**, all adapters: CJS 산출물 확장자를 `.js` → `.cjs`로 변경. `"type": "module"` 환경에서 `.js`가 ESM으로 해석되어 발생하던 `exports is not defined in ES module scope` 오류를 해소.
+- **`previewIsolation`** default: `'shadow'` → `'iframe'`. shadow DOM 모드는 일부 portal 라이브러리(Radix 등)와 호환성 이슈가 있어 iframe 격리를 표준으로.
+- **`@jogak/ui`** preview-frame: 기존 `__jogak_setProps__` 직접 호출 프로토콜 → postMessage(`jogak:setProps` / `jogak:rendered` / `jogak:error`)로 통일. 모든 어댑터의 iframe entry가 동일 프로토콜을 따른다.
+- **`@jogak/cli`**: `jogak dev`가 registry 생성 완료를 대기한 뒤 어댑터를 spawn (이전: fire-and-forget). non-vite 어댑터의 scaffold가 비어있는 registry를 import하던 race condition 해소.
+
+### Fixed
+
+- **`@jogak/cli`**: 어댑터 dynamic import 시 `import.meta.resolve`/`createRequire`가 cli/dist 기준으로 해석돼 사용자 cwd의 어댑터 패키지를 찾지 못하던 문제. `<cwd>/node_modules/@jogak/${name}-adapter/package.json`을 직접 읽어 `exports['.'].import` 경로로 해석하도록 변경.
+- **`@jogak/next-adapter`**: 이전 시도의 `__jogak_preview__` 경로는 Next App Router의 private folder convention(`_`로 시작하는 폴더는 라우팅 제외)과 충돌해 404. `jogak-preview`로 변경.
+
+## [0.1.0-alpha.3] — 2026-05-07
+
+### Added
+
+- **`@jogak/core`**: Vite plugin now auto-detects user `tsconfig.json` (and `tsconfig.app.json` for the Vite scaffold-default split-references layout) and converts `compilerOptions.paths` into `vite resolve.alias`. This makes `runHost`-driven dev/build work zero-config for projects that use path aliases (shadcn/ui's `@/lib/utils` etc.). Without this, `runHost` ignored the user's `vite.config.ts` (`configFile: false`) and any `@/...` import inside a user component failed to resolve.
+- **`JogakPluginOptions.resolveAlias`**: explicit user-provided alias map for cases the auto-extraction can't handle (extends chains, complex glob patterns). Explicit entries override auto-extracted ones. Relative paths are resolved against the user root.
+
+### Fixed
+
+- Path aliases declared in user `tsconfig` are now respected during `jogak dev` and `jogak build`. Previously, every `*.jogak.tsx` that imported a component using `@/`-style imports would fail with `Failed to resolve import "@/..."` in the browser dev overlay.
+
+Other packages: no source changes; version bumped to keep the workspace synchronized.
+
+## [0.1.0-alpha.2] — 2026-05-07
+
+### Fixed
+
+- **`@jogak/ui`**: Published package was missing `src/app/main.tsx` (referenced by `index.html` as the SPA entry), causing `jogak dev` to 404 on the entry script and `jogak build` to fail with `Failed to resolve /src/app/main.tsx`. The `files` field in `package.json` only included `dist/`, but `runHost` uses the package's `index.html` as the Vite root and resolves `/src/app/main.tsx` from source. Added `src/app`, `src/components`, `src/hooks`, `src/index.ts`, `src/vite-env.d.ts` to `files`. Internal `src/host` and `src/examples` remain excluded (host is consumed via the published `dist/host` build; examples are repository-only demos).
+
+Other packages: no source changes; version bumped to keep the workspace synchronized.
+
 ## [0.1.0-alpha.1] — 2026-05-07
 
 ### Changed

package/dist/actions-BvvUNlgo.js

@@ -0,0 +1,69 @@
+var m = (n) => {
+  throw TypeError(n);
+};
+var l = (n, t, i) => t.has(n) || m("Cannot " + i);
+var e = (n, t, i) => (l(n, t, "read from private field"), i ? i.call(n) : t.get(n)), r = (n, t, i) => t.has(n) ? m("Cannot add the same private member more than once") : t instanceof WeakSet ? t.add(n) : t.set(n, i), u = (n, t, i, o) => (l(n, t, "write to private field"), o ? o.call(n, i) : t.set(n, i), i), g = (n, t, i) => (l(n, t, "access private method"), i);
+var p = (n, t, i, o) => ({
+  set _(c) {
+    u(n, t, c, i);
+  },
+  get _() {
+    return e(n, t, o);
+  }
+});
+var s, f, d, h, y;
+class k {
+  constructor() {
+    r(this, h);
+    r(this, s, []);
+    r(this, f, /* @__PURE__ */ new Set());
+    r(this, d, 1);
+  }
+  emit(t, i) {
+    const o = {
+      id: p(this, d)._++,
+      name: t,
+      args: i,
+      timestamp: Date.now()
+    };
+    u(this, s, [...e(this, s), o]), g(this, h, y).call(this);
+  }
+  subscribe(t) {
+    return e(this, f).add(t), t(e(this, s)), () => {
+      e(this, f).delete(t);
+    };
+  }
+  clear() {
+    e(this, s).length !== 0 && (u(this, s, []), g(this, h, y).call(this));
+  }
+  getLogs() {
+    return e(this, s);
+  }
+}
+s = new WeakMap(), f = new WeakMap(), d = new WeakMap(), h = new WeakSet(), y = function() {
+  for (const t of e(this, f)) t(e(this, s));
+};
+const A = new k();
+function v(n, t = A) {
+  return (...i) => {
+    t.emit(n, i);
+  };
+}
+function C(n, t, i = A) {
+  const o = { ...n };
+  for (const c of Object.keys(t)) {
+    const a = t[c];
+    if (a === void 0) continue;
+    const b = a.action !== void 0 && a.action !== !1, w = a.type === "function";
+    if (!b && !w || typeof o[c] == "function") continue;
+    const j = typeof a.action == "string" ? a.action : c;
+    o[c] = v(j, i);
+  }
+  return o;
+}
+export {
+  k as A,
+  v as a,
+  A as d,
+  C as i
+};

package/dist/actions-D9bnuJ1b.cjs

@@ -0,0 +1 @@
+"use strict";var m=n=>{throw TypeError(n)};var d=(n,t,i)=>t.has(n)||m("Cannot "+i);var o=(n,t,i)=>(d(n,t,"read from private field"),i?i.call(n):t.get(n)),h=(n,t,i)=>t.has(n)?m("Cannot add the same private member more than once"):t instanceof WeakSet?t.add(n):t.set(n,i),u=(n,t,i,e)=>(d(n,t,"write to private field"),e?e.call(n,i):t.set(n,i),i),g=(n,t,i)=>(d(n,t,"access private method"),i);var p=(n,t,i,e)=>({set _(c){u(n,t,c,i)},get _(){return o(n,t,e)}});var s,f,l,r,y;class C{constructor(){h(this,r);h(this,s,[]);h(this,f,new Set);h(this,l,1)}emit(t,i){const e={id:p(this,l)._++,name:t,args:i,timestamp:Date.now()};u(this,s,[...o(this,s),e]),g(this,r,y).call(this)}subscribe(t){return o(this,f).add(t),t(o(this,s)),()=>{o(this,f).delete(t)}}clear(){o(this,s).length!==0&&(u(this,s,[]),g(this,r,y).call(this))}getLogs(){return o(this,s)}}s=new WeakMap,f=new WeakMap,l=new WeakMap,r=new WeakSet,y=function(){for(const t of o(this,f))t(o(this,s))};const A=new C;function b(n,t=A){return(...i)=>{t.emit(n,i)}}function v(n,t,i=A){const e={...n};for(const c of Object.keys(t)){const a=t[c];if(a===void 0)continue;const j=a.action!==void 0&&a.action!==!1,w=a.type==="function";if(!j&&!w||typeof e[c]=="function")continue;const k=typeof a.action=="string"?a.action:c;e[c]=b(k,i)}return e}exports.ActionChannel=C;exports.action=b;exports.defaultActionChannel=A;exports.injectActions=v;

package/dist/adapter.d.ts

@@ -0,0 +1,80 @@
+/**
+ * 알파.9: 빌더-agnostic 어댑터 ABI.
+ *
+ * jogak이 사용자 빌더(Vite / Next.js / Webpack / Vanilla)에 무관하게 사용자 컴포넌트를
+ * 사용자 빌더의 정상 client에서 평가하도록 하는 공통 인터페이스. core는 어떤 빌더도
+ * 직접 import하지 않고 어댑터 dispatch만 책임진다.
+ *
+ * 어댑터 구현체는 별도 패키지로 분리:
+ * - `@jogak/vite-adapter`
+ * - `@jogak/next-adapter`
+ * - `@jogak/webpack-adapter`
+ * - `@jogak/standalone-adapter`
+ *
+ * `@jogak/cli`가 사용자 cwd 시그널로 builder를 자동 감지하고 해당 adapter를 dynamic import.
+ */
+export type BuilderName = 'vite' | 'next' | 'webpack' | 'standalone' | 'custom';
+export type GlobalCssSpec = boolean | string | readonly string[];
+/**
+ * 모든 빌더 어댑터가 구현해야 하는 공통 ABI.
+ */
+export interface BuilderAdapter {
+    readonly name: BuilderName;
+    /** dev server를 spawn. 사용자 빌더의 정상 client + jogak preview entry 주입. */
+    spawnDev(opts: SpawnDevOptions): Promise<DevHandle>;
+    /** 정적 산출물 빌드. iframe entry를 사용자 빌더로 빌드 + jogak SPA outDir에 통합. */
+    build(opts: BuildOptions): Promise<BuildResult>;
+    /** preview entry 통신/주입에 필요한 metadata. */
+    readonly previewEntryMeta: PreviewEntryMeta;
+}
+export interface SpawnDevOptions {
+    readonly cwd: string;
+    readonly globalCss?: GlobalCssSpec;
+    readonly port?: number;
+    readonly host?: string | boolean;
+    /** 로그 출력 — 미지정 시 console 사용. */
+    readonly logger?: HostLogger;
+    /** adapter별 추가 옵션 (vite: configFile, next: appDir 등). */
+    readonly extra?: Readonly<Record<string, unknown>>;
+}
+export interface DevHandle {
+    /** dev server URL (jogak SPA가 iframe src base로 사용). */
+    readonly url: string;
+    readonly port: number;
+    /** SIGINT/SIGTERM 시 jogak CLI가 호출. 멱등 보장. */
+    close(): Promise<void>;
+}
+export interface BuildOptions {
+    readonly cwd: string;
+    readonly globalCss?: GlobalCssSpec;
+    /** 사용자 빌더 산출물의 출력 디렉토리. jogak이 outDir/preview/로 복사. */
+    readonly previewOutDir: string;
+    readonly logger?: HostLogger;
+    readonly extra?: Readonly<Record<string, unknown>>;
+}
+export interface BuildResult {
+    /** 사용자 빌더가 생성한 산출물 절대 경로 디렉토리 (= previewOutDir). */
+    readonly outDir: string;
+    /** 사용자 빌더가 emit한 entry HTML의 path-relative URL (예: 'index.html'). */
+    readonly entryHtml: string;
+    readonly assetCount: number;
+    readonly totalBytes: number;
+    readonly elapsedMs: number;
+}
+export interface PreviewEntryMeta {
+    /** dev URL의 entry path (예: '/__jogak_preview__/index.html'). adapter별 routing. */
+    readonly devEntryPath: string;
+    /** build 산출물의 entry HTML basename (예: 'index.html'). */
+    readonly buildEntryName: string;
+    /** preview entry 가상 모듈 ID (모든 adapter 공통: 'virtual:jogak/preview-entry'). */
+    readonly previewEntryVirtualId: string;
+}
+/**
+ * 어댑터에 전달하는 logger 인터페이스. core가 ui/host에 의존하지 않도록 별도 정의.
+ * 미지정 시 console fallback.
+ */
+export interface HostLogger {
+    info(message: string): void;
+    warn(message: string): void;
+    error(message: string): void;
+}

package/dist/adapters/next/index.cjs

@@ -0,0 +1,73 @@
+"use strict";Object.defineProperties(exports,{__esModule:{value:!0},[Symbol.toStringTag]:{value:"Module"}});const y=require("node:child_process"),c=require("node:fs"),u=require("node:path"),w=require("../../detect-global-css-CDcuUAYE.cjs"),p="jogak-preview",m=`/${p}`;function g(e){const o=v(e.cwd);if(o===void 0)throw new Error(`[jogak/next-adapter] App Router 디렉토리를 찾지 못했습니다 (${e.cwd}/app 또는 ${e.cwd}/src/app).
+Pages Router는 알파.10에서 지원 예정. 임시 우회: \`app/\` 디렉토리 생성 후 재시도.`);const r=u.resolve(o,p);c.mkdirSync(r,{recursive:!0});const n=w.resolveGlobalCssPaths(e.globalCss,e.cwd).map(a=>`import ${JSON.stringify(a)}`).join(`
+`),i=u.resolve(e.cwd,".jogak/registry"),t=k(u.relative(r,i)),s=t.startsWith(".")?t:`./${t}`;return c.writeFileSync(u.resolve(r,"page.tsx"),j(n,s),"utf8"),c.writeFileSync(u.resolve(r,"layout.tsx"),E(),"utf8"),h(e.cwd,`${p}/`),{route:m,cleanup:()=>{try{c.rmSync(r,{recursive:!0,force:!0})}catch{}}}}function v(e){const o=u.resolve(e,"src/app");if(c.existsSync(o))return o;const r=u.resolve(e,"app");if(c.existsSync(r))return r}function h(e,o){const r=u.resolve(e,".gitignore");let n="";if(c.existsSync(r))try{n=c.readFileSync(r,"utf-8")}catch{return}const i=`**/${o}`;if(n.split(`
+`).some(l=>l.trim()===i))return;const s="# jogak (auto-generated, do not commit preview scaffolding)",a=n.endsWith(`
+`)||n===""?`${n}${s}
+${i}
+`:`${n}
+${s}
+${i}
+`;try{c.writeFileSync(r,a,"utf-8")}catch{}}function E(){return`import type { ReactNode } from 'react'
+
+// jogak preview layout — RootLayout이 사용자 globalCss를 import하므로 여기서 추가 import 불필요.
+export default function JogakPreviewLayout({ children }: { children: ReactNode }) {
+  return children
+}
+`}function k(e){return e.split(/[\\/]/u).join("/")}function j(e,o){return`'use client'
+import { useEffect, useRef } from 'react'
+import { reactAdapter } from '@jogak/core/renderers/react'
+import { defaultRegistry } from '@jogak/core'
+import { entries as _jogakEntries } from ${JSON.stringify(o)}
+${e}
+
+// 모듈 평가 시점 1회 등록 — HMR 재평가 대비 멱등 처리.
+for (const entry of _jogakEntries) {
+  if (defaultRegistry.get(entry.id) === undefined) {
+    defaultRegistry.register(entry)
+  }
+}
+
+export default function JogakPreviewPage() {
+  const ref = useRef<HTMLDivElement>(null)
+
+  useEffect(() => {
+    let currentContainer: HTMLDivElement | null = null
+
+    const renderEntry = async (entryId: string, args: Record<string, unknown>) => {
+      const entry = await defaultRegistry.requestEntry(entryId)
+      if (currentContainer === null) {
+        currentContainer = document.createElement('div')
+        ref.current?.replaceChildren(currentContainer)
+      }
+      reactAdapter.render(entry, args, currentContainer)
+    }
+
+    const unmount = () => {
+      if (currentContainer !== null) {
+        reactAdapter.unmount(currentContainer)
+        currentContainer = null
+      }
+    }
+
+    const handler = (event: MessageEvent) => {
+      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.addEventListener('message', handler)
+    window.parent.postMessage({ type: 'jogak:ready' }, '*')
+    return () => { window.removeEventListener('message', handler) }
+  }, [])
+
+  return <div id="jogak-preview-root" ref={ref} />
+}
+`}async function S(e){var a,l;const o=e.extra??{},r=g({cwd:e.cwd,...e.globalCss!==void 0?{globalCss:e.globalCss}:{}}),n=e.port??5174,i=o.cmd??"next",t=y.spawn(i,["dev","-p",String(n),"-H",String(e.host??"localhost")],{cwd:e.cwd,stdio:["ignore","pipe","pipe"],env:{...process.env,JOGAK_PREVIEW:"1"}});(a=t.stdout)==null||a.on("data",d=>{process.stdout.write(`[next] ${d.toString()}`)}),(l=t.stderr)==null||l.on("data",d=>{process.stderr.write(`[next] ${d.toString()}`)});const s=`http://localhost:${String(n)}`;try{await R(`${s}${r.route}`,6e4)}catch(d){if(t.pid!==void 0)try{process.kill(t.pid,"SIGTERM")}catch{}throw r.cleanup(),d}return{url:s,port:n,close:async()=>{if(t.pid!==void 0)try{process.kill(t.pid,"SIGTERM"),await new Promise(d=>{const f=setTimeout(()=>{try{t.pid!==void 0&&process.kill(t.pid,"SIGKILL")}catch{}d()},5e3);t.on("exit",()=>{clearTimeout(f),d()})})}catch{}r.cleanup()}}}async function R(e,o){const r=Date.now();let n;for(;Date.now()-r<o;){try{const t=new AbortController,s=setTimeout(()=>{t.abort()},2e3),a=await fetch(e,{signal:t.signal});if(clearTimeout(s),(a.ok||a.status===404)&&a.ok)return}catch(t){n=t}await new Promise(t=>setTimeout(t,500))}const i=n instanceof Error?n.message:String(n??"timeout");throw new Error(`[jogak/next-adapter] next dev ready timeout (${o}ms): ${i}`)}const x={devEntryPath:"/jogak-preview",buildEntryName:"jogak-preview/index.html",previewEntryVirtualId:"virtual:jogak/preview-entry"},P={name:"next",spawnDev:S,async build(e){throw new Error("[jogak/next-adapter] build is not implemented yet (alpha.9 v1). Use `jogak dev` for now.")},previewEntryMeta:x};exports.default=P;exports.scaffoldPreviewPage=g;

package/dist/adapters/next/index.d.ts

@@ -0,0 +1,5 @@
+import { BuilderAdapter } from '../../index.js';
+declare const nextAdapter: BuilderAdapter;
+export default nextAdapter;
+export { scaffoldPreviewPage } from './scaffold.js';
+export type { ScaffoldOptions, ScaffoldHandle } from './scaffold.js';

package/dist/adapters/next/index.mjs

@@ -0,0 +1,222 @@
+import { spawn as y } from "node:child_process";
+import { mkdirSync as m, writeFileSync as l, rmSync as w, existsSync as p, readFileSync as v } from "node:fs";
+import { resolve as d, relative as h } from "node:path";
+import { r as E } from "../../detect-global-css-CIVMmgzy.js";
+const g = "jogak-preview", k = `/${g}`;
+function j(e) {
+  const o = R(e.cwd);
+  if (o === void 0)
+    throw new Error(
+      `[jogak/next-adapter] App Router 디렉토리를 찾지 못했습니다 (${e.cwd}/app 또는 ${e.cwd}/src/app).
+Pages Router는 알파.10에서 지원 예정. 임시 우회: \`app/\` 디렉토리 생성 후 재시도.`
+    );
+  const r = d(o, g);
+  m(r, { recursive: !0 });
+  const n = E(e.globalCss, e.cwd).map((a) => `import ${JSON.stringify(a)}`).join(`
+`), i = d(e.cwd, ".jogak/registry"), t = P(h(r, i)), s = t.startsWith(".") ? t : `./${t}`;
+  return l(
+    d(r, "page.tsx"),
+    S(n, s),
+    "utf8"
+  ), l(d(r, "layout.tsx"), x(), "utf8"), $(e.cwd, `${g}/`), {
+    route: k,
+    cleanup: () => {
+      try {
+        w(r, { recursive: !0, force: !0 });
+      } catch {
+      }
+    }
+  };
+}
+function R(e) {
+  const o = d(e, "src/app");
+  if (p(o)) return o;
+  const r = d(e, "app");
+  if (p(r)) return r;
+}
+function $(e, o) {
+  const r = d(e, ".gitignore");
+  let n = "";
+  if (p(r))
+    try {
+      n = v(r, "utf-8");
+    } catch {
+      return;
+    }
+  const i = `**/${o}`;
+  if (n.split(`
+`).some((u) => u.trim() === i)) return;
+  const s = "# jogak (auto-generated, do not commit preview scaffolding)", a = n.endsWith(`
+`) || n === "" ? `${n}${s}
+${i}
+` : `${n}
+${s}
+${i}
+`;
+  try {
+    l(r, a, "utf-8");
+  } catch {
+  }
+}
+function x() {
+  return `import type { ReactNode } from 'react'
+
+// jogak preview layout — RootLayout이 사용자 globalCss를 import하므로 여기서 추가 import 불필요.
+export default function JogakPreviewLayout({ children }: { children: ReactNode }) {
+  return children
+}
+`;
+}
+function P(e) {
+  return e.split(/[\\/]/u).join("/");
+}
+function S(e, o) {
+  return `'use client'
+import { useEffect, useRef } from 'react'
+import { reactAdapter } from '@jogak/core/renderers/react'
+import { defaultRegistry } from '@jogak/core'
+import { entries as _jogakEntries } from ${JSON.stringify(o)}
+${e}
+
+// 모듈 평가 시점 1회 등록 — HMR 재평가 대비 멱등 처리.
+for (const entry of _jogakEntries) {
+  if (defaultRegistry.get(entry.id) === undefined) {
+    defaultRegistry.register(entry)
+  }
+}
+
+export default function JogakPreviewPage() {
+  const ref = useRef<HTMLDivElement>(null)
+
+  useEffect(() => {
+    let currentContainer: HTMLDivElement | null = null
+
+    const renderEntry = async (entryId: string, args: Record<string, unknown>) => {
+      const entry = await defaultRegistry.requestEntry(entryId)
+      if (currentContainer === null) {
+        currentContainer = document.createElement('div')
+        ref.current?.replaceChildren(currentContainer)
+      }
+      reactAdapter.render(entry, args, currentContainer)
+    }
+
+    const unmount = () => {
+      if (currentContainer !== null) {
+        reactAdapter.unmount(currentContainer)
+        currentContainer = null
+      }
+    }
+
+    const handler = (event: MessageEvent) => {
+      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.addEventListener('message', handler)
+    window.parent.postMessage({ type: 'jogak:ready' }, '*')
+    return () => { window.removeEventListener('message', handler) }
+  }, [])
+
+  return <div id="jogak-preview-root" ref={ref} />
+}
+`;
+}
+async function C(e) {
+  var a, u;
+  const o = e.extra ?? {}, r = j({
+    cwd: e.cwd,
+    ...e.globalCss !== void 0 ? { globalCss: e.globalCss } : {}
+  }), n = e.port ?? 5174, i = o.cmd ?? "next", t = y(
+    i,
+    ["dev", "-p", String(n), "-H", String(e.host ?? "localhost")],
+    {
+      cwd: e.cwd,
+      stdio: ["ignore", "pipe", "pipe"],
+      env: { ...process.env, JOGAK_PREVIEW: "1" }
+    }
+  );
+  (a = t.stdout) == null || a.on("data", (c) => {
+    process.stdout.write(`[next] ${c.toString()}`);
+  }), (u = t.stderr) == null || u.on("data", (c) => {
+    process.stderr.write(`[next] ${c.toString()}`);
+  });
+  const s = `http://localhost:${String(n)}`;
+  try {
+    await I(`${s}${r.route}`, 6e4);
+  } catch (c) {
+    if (t.pid !== void 0)
+      try {
+        process.kill(t.pid, "SIGTERM");
+      } catch {
+      }
+    throw r.cleanup(), c;
+  }
+  return {
+    url: s,
+    port: n,
+    close: async () => {
+      if (t.pid !== void 0)
+        try {
+          process.kill(t.pid, "SIGTERM"), await new Promise((c) => {
+            const f = setTimeout(() => {
+              try {
+                t.pid !== void 0 && process.kill(t.pid, "SIGKILL");
+              } catch {
+              }
+              c();
+            }, 5e3);
+            t.on("exit", () => {
+              clearTimeout(f), c();
+            });
+          });
+        } catch {
+        }
+      r.cleanup();
+    }
+  };
+}
+async function I(e, o) {
+  const r = Date.now();
+  let n;
+  for (; Date.now() - r < o; ) {
+    try {
+      const t = new AbortController(), s = setTimeout(() => {
+        t.abort();
+      }, 2e3), a = await fetch(e, { signal: t.signal });
+      if (clearTimeout(s), (a.ok || a.status === 404) && a.ok)
+        return;
+    } catch (t) {
+      n = t;
+    }
+    await new Promise((t) => setTimeout(t, 500));
+  }
+  const i = n instanceof Error ? n.message : String(n ?? "timeout");
+  throw new Error(`[jogak/next-adapter] next dev ready timeout (${o}ms): ${i}`);
+}
+const b = {
+  devEntryPath: "/jogak-preview",
+  buildEntryName: "jogak-preview/index.html",
+  previewEntryVirtualId: "virtual:jogak/preview-entry"
+}, L = {
+  name: "next",
+  spawnDev: C,
+  async build(e) {
+    throw new Error(
+      "[jogak/next-adapter] build is not implemented yet (alpha.9 v1). Use `jogak dev` for now."
+    );
+  },
+  previewEntryMeta: b
+};
+export {
+  L as default,
+  j as scaffoldPreviewPage
+};

package/dist/adapters/next/scaffold.d.ts

@@ -0,0 +1,23 @@
+/**
+ * 알파.9: next-adapter — `<userRoot>/app/jogak-preview/page.tsx` scaffold.
+ *
+ * Next.js webpack은 vite처럼 가상 모듈을 지원하지 않으므로 사용자 cwd의 app 디렉토리에
+ * 직접 page.tsx를 generate한다. `.gitignore`에 자동 추가하고 shutdown 시 cleanup.
+ *
+ * App Router 우선:
+ * - `<cwd>/src/app/` 우선 (사용자가 src/ 사용 시)
+ * - 없으면 `<cwd>/app/`
+ *
+ * Pages Router는 알파.10 검토.
+ */
+export interface ScaffoldOptions {
+    readonly cwd: string;
+    readonly globalCss?: boolean | string | readonly string[];
+}
+export interface ScaffoldHandle {
+    /** Cleanup — shutdown 시 호출. scaffolded 디렉토리 제거. */
+    cleanup(): void;
+    /** scaffolded preview path (route, e.g. `/jogak-preview`). */
+    readonly route: string;
+}
+export declare function scaffoldPreviewPage(opts: ScaffoldOptions): ScaffoldHandle;

package/dist/adapters/next/spawn-dev.d.ts

@@ -0,0 +1,2 @@
+import { DevHandle, SpawnDevOptions } from '../../index.js';
+export declare function spawnNextDev(opts: SpawnDevOptions): Promise<DevHandle>;

package/dist/adapters/standalone/index.cjs

@@ -0,0 +1 @@
+"use strict";const a={devEntryPath:"/preview-frame.html",buildEntryName:"preview-frame.html",previewEntryVirtualId:"virtual:jogak/preview-entry"},r={name:"standalone",async spawnDev(e){throw new Error("[jogak/standalone-adapter] no separate dev server. CLI dispatch should detect this adapter and skip user vite spawn — use fallback (jogak SPA scope) for preview iframe.")},async build(e){throw new Error("[jogak/standalone-adapter] build is not supported in alpha.9 v1.")},previewEntryMeta:a};module.exports=r;

package/dist/adapters/standalone/index.d.ts

@@ -0,0 +1,3 @@
+import { BuilderAdapter } from '../../index.js';
+declare const standaloneAdapter: BuilderAdapter;
+export default standaloneAdapter;

package/dist/adapters/standalone/index.mjs

@@ -0,0 +1,21 @@
+const a = {
+  devEntryPath: "/preview-frame.html",
+  buildEntryName: "preview-frame.html",
+  previewEntryVirtualId: "virtual:jogak/preview-entry"
+}, r = {
+  name: "standalone",
+  async spawnDev(e) {
+    throw new Error(
+      "[jogak/standalone-adapter] no separate dev server. CLI dispatch should detect this adapter and skip user vite spawn — use fallback (jogak SPA scope) for preview iframe."
+    );
+  },
+  async build(e) {
+    throw new Error(
+      "[jogak/standalone-adapter] build is not supported in alpha.9 v1."
+    );
+  },
+  previewEntryMeta: a
+};
+export {
+  r as default
+};

package/dist/adapters/vite/build.d.ts

@@ -0,0 +1,2 @@
+import { BuildOptions, BuildResult } from '../../index.js';
+export declare function buildVite(opts: BuildOptions): Promise<BuildResult>;