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

package/dist/config.d.ts

@@ -0,0 +1,45 @@
+import { JogakPluginOptions } from './types.js';
+/**
+ * `jogak.config.{ts,mts,mjs,js,json}`의 default export 타입.
+ *
+ * `JogakPluginOptions`의 모든 필드 + 사용자가 자주 변경하는 dev/build 옵션을
+ * 통합한다. 모든 필드 optional — 미지정 시 jogak 기본값 또는 CLI 플래그가 적용.
+ *
+ * **CLI 플래그 우선순위**: CLI 플래그가 본 config의 값을 override한다 (Vite 패턴).
+ * 예: `jogak.config.ts`에 `port: 3000`, CLI에 `--port 4000` → 4000 적용.
+ *
+ * 미노출 필드(예: `cwd`, `framework`, `disableCacheValidation`, `noGenerate`,
+ * `emitRegistry`)는 CLI 플래그 전용 또는 자동 감지로만 처리 — 사용자가 config
+ * 파일에서 자주 만지지 않는 옵션이라 표면을 줄였다.
+ */
+export interface JogakConfig extends JogakPluginOptions {
+    /** dev server 포트. 기본 5173. CLI `--port`로 override. */
+    readonly port?: number;
+    /** dev server bind host. 기본 'localhost'. CLI `--host`로 override. */
+    readonly host?: string | boolean;
+    /** dev 시작 시 브라우저 자동 오픈. 기본 false. CLI `--open`로 override. */
+    readonly open?: boolean | string;
+    /** 정적 빌드 출력 디렉토리. 기본 'jogak-static'. CLI `--out-dir`로 override. */
+    readonly outDir?: string;
+    /** 정적 빌드 base public path. 기본 './'. CLI `--base`로 override. */
+    readonly base?: string;
+    /** 빌드 minify 모드. 기본 'esbuild'. CLI `--minify`로 override. */
+    readonly minify?: boolean | 'esbuild' | 'terser';
+    /** 빌드 소스맵. 기본 false. CLI `--sourcemap`로 override. */
+    readonly sourcemap?: boolean;
+}
+/**
+ * `jogak.config.ts`에서 사용자가 호출하는 identity helper.
+ *
+ * TypeScript 타입 추론을 위해서만 존재 — 런타임에는 입력 그대로 반환.
+ *
+ * @example
+ * import { defineJogakConfig } from '@jogak/core'
+ *
+ * export default defineJogakConfig({
+ *   globalCss: true,
+ *   previewIsolation: 'none',
+ *   port: 3000,
+ * })
+ */
+export declare function defineJogakConfig<T extends JogakConfig>(config: T): T;

package/dist/index.d.ts

@@ -1,3 +1,4 @@
 export type { ArgType, JogakMeta, Jogak, RegistryEntry, RegistryEntryMeta, CategoryTree, CategoryMetaTree, JogakAdapter, JogakPluginOptions, } from './types.js';
 export { ComponentRegistry, defaultRegistry, UnknownEntryError } from './registry.js';
 export { ActionChannel, defaultActionChannel, action, injectActions, type ActionLog, type ActionListener, } from './actions.js';
+export { defineJogakConfig, type JogakConfig } from './config.js';

package/dist/index.js

@@ -1 +1 @@
-"use strict";var V=Object.defineProperty;var U=i=>{throw TypeError(i)};var G=(i,t,e)=>t in i?V(i,t,{enumerable:!0,configurable:!0,writable:!0,value:e}):i[t]=e;var I=(i,t,e)=>G(i,typeof t!="symbol"?t+"":t,e),z=(i,t,e)=>t.has(i)||U("Cannot "+e);var s=(i,t,e)=>(z(i,t,"read from private field"),e?e.call(i):t.get(i)),f=(i,t,e)=>t.has(i)?U("Cannot add the same private member more than once"):t instanceof WeakSet?t.add(i):t.set(i,e),d=(i,t,e,n)=>(z(i,t,"write to private field"),n?n.call(i,e):t.set(i,e),e),u=(i,t,e)=>(z(i,t,"access private method"),e);var N=(i,t,e,n)=>({set _(r){d(i,t,r,e)},get _(){return s(i,t,n)}});Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});class F extends Error{constructor(e){super(`[jogak] Unknown entry id: ${e}`);I(this,"id");this.name="UnknownEntryError",this.id=e}}var a,x,b,v,k,E,w,j,A,T,l,m,C,D;class q{constructor(){f(this,l);f(this,a,new Map);f(this,x);f(this,b,new Set);f(this,v);f(this,k);f(this,E);f(this,w);f(this,j);f(this,A,!1);f(this,T,!1)}register(t){const e=H(t);u(this,l,D).call(this,()=>{this.registerMeta(e),this.hydrateEntry(t.id,t.jogaks,t.meta.component)})}unregister(t){const e=s(this,a).get(t);e!==void 0&&(e.kind==="pending"&&e.reject(new F(t)),s(this,a).delete(t),u(this,l,m).call(this))}get(t){const e=s(this,a).get(t);return(e==null?void 0:e.kind)==="hydrated"?e.entry:void 0}getAll(){if(s(this,E)!==void 0)return s(this,E);const t=[];for(const n of u(this,l,C).call(this)){const r=s(this,a).get(n);(r==null?void 0:r.kind)==="hydrated"&&t.push(r.entry)}const e=t;return d(this,E,e),e}search(t){const e=t.toLowerCase();return this.getAll().filter(n=>n.title.toLowerCase().includes(e))}getTree(){if(s(this,w)!==void 0)return s(this,w);const t={};for(const e of this.getAll()){const n=e.title.split("/");let r=t;for(let h=0;h<n.length-1;h++){const c=n[h];if(c===void 0)continue;const g=r[c];(g===void 0||"id"in g)&&(r[c]={}),r=r[c]}const o=n[n.length-1];o!==void 0&&(r[o]=e)}return d(this,w,t),t}clear(){if(s(this,a).size!==0){for(const t of s(this,a).values())t.kind==="pending"&&t.reject(new Error("[jogak] registry cleared"));s(this,a).clear(),u(this,l,m).call(this)}}get size(){let t=0;for(const e of s(this,a).values())e.kind==="hydrated"&&t++;return t}registerMeta(t){const e=s(this,a).get(t.id);if(e===void 0){s(this,a).set(t.id,{kind:"meta",meta:t}),u(this,l,m).call(this);return}if(e.kind==="meta"){s(this,a).set(t.id,{kind:"meta",meta:t}),u(this,l,m).call(this);return}if(e.kind==="pending"){s(this,a).set(t.id,{kind:"pending",meta:t,promise:e.promise,resolve:e.resolve,reject:e.reject}),u(this,l,m).call(this);return}const n={...e.entry,title:t.title,filePath:t.filePath,source:t.source,meta:$(t,e.entry.meta.component)};s(this,a).set(t.id,{kind:"hydrated",meta:t,entry:n}),u(this,l,m).call(this)}hydrateEntry(t,e,n){const r=s(this,a).get(t);let o;r===void 0?(console.warn(`[jogak] hydrateEntry called for unknown id "${t}" — synthesizing minimal meta`),o={id:t,title:t,jogakNames:e.map(c=>c.name),autoArgTypes:{},userArgTypes:{},source:"",filePath:"",metaExtras:{}}):o=r.meta;const h={id:o.id,title:o.title,jogaks:e,meta:$(o,n),...o.filePath?{filePath:o.filePath}:{},...o.source?{source:o.source}:{}};if((r==null?void 0:r.kind)==="pending"){s(this,a).set(t,{kind:"hydrated",meta:o,entry:h}),u(this,l,m).call(this),r.resolve(h);return}s(this,a).set(t,{kind:"hydrated",meta:o,entry:h}),u(this,l,m).call(this)}invalidateEntry(t){const e=s(this,a).get(t);e===void 0||e.kind!=="hydrated"||(s(this,a).set(t,{kind:"meta",meta:e.meta}),u(this,l,m).call(this))}requestEntry(t){const e=s(this,a).get(t);if(e===void 0)return Promise.reject(new F(t));if(e.kind==="hydrated")return Promise.resolve(e.entry);if(e.kind==="pending")return e.promise;const n=s(this,x);if(n===void 0)return Promise.reject(new Error("[jogak] entry loader not set — virtual:jogak index module did not load"));let r,o;const h=new Promise((c,g)=>{r=c,o=g});return s(this,a).set(t,{kind:"pending",meta:e.meta,promise:h,resolve:r,reject:o}),n(t).then(()=>{const c=s(this,a).get(t);(c==null?void 0:c.kind)!=="hydrated"&&o(new Error(`[jogak] entry module loaded but did not hydrate: ${t}`))},c=>{const g=c instanceof Error?c:new Error(String(c)),p=s(this,a).get(t);(p==null?void 0:p.kind)==="pending"&&p.promise===h&&s(this,a).set(t,{kind:"meta",meta:e.meta}),o(g)}),h}getAllMeta(){if(s(this,v)!==void 0)return s(this,v);const t=[];for(const n of u(this,l,C).call(this)){const r=s(this,a).get(n);r!==void 0&&t.push(r.meta)}const e=t;return d(this,v,e),e}getMetaTree(){if(s(this,k)!==void 0)return s(this,k);const t={};for(const e of u(this,l,C).call(this)){const n=s(this,a).get(e);if(n===void 0)continue;const r=n.meta,o=r.title.split("/");let h=t;for(let g=0;g<o.length-1;g++){const p=o[g];if(p===void 0)continue;const R=h[p];(R===void 0||"id"in R)&&(h[p]={}),h=h[p]}const c=o[o.length-1];c!==void 0&&(h[c]=r)}return d(this,k,t),t}getEntryState(t){const e=s(this,a).get(t);return e===void 0?"unknown":e.kind}setEntryLoader(t){d(this,x,t)}subscribe(t){s(this,b).add(t);let e=!0;return()=>{e&&(e=!1,s(this,b).delete(t))}}}a=new WeakMap,x=new WeakMap,b=new WeakMap,v=new WeakMap,k=new WeakMap,E=new WeakMap,w=new WeakMap,j=new WeakMap,A=new WeakMap,T=new WeakMap,l=new WeakSet,m=function(){if(d(this,v,void 0),d(this,k,void 0),d(this,E,void 0),d(this,w,void 0),d(this,j,void 0),s(this,A)){d(this,T,!0);return}const t=Array.from(s(this,b));for(const e of t)try{e()}catch(n){console.error("[jogak] subscribe listener threw:",n)}},C=function(){if(s(this,j)!==void 0)return s(this,j);const t=[];for(const[n,r]of s(this,a))t.push({id:n,title:r.meta.title});t.sort(K);const e=t.map(n=>n.id);return d(this,j,e),e},D=function(t){if(s(this,A)){t();return}d(this,A,!0),d(this,T,!1);try{t()}finally{d(this,A,!1),s(this,T)&&(d(this,T,!1),u(this,l,m).call(this))}};function H(i){const t=i.meta.argTypes??{};return{id:i.id,title:i.title,jogakNames:i.jogaks.map(e=>e.name),autoArgTypes:{},userArgTypes:t,source:i.source??"",filePath:i.filePath??"",metaExtras:{...i.meta.tags!==void 0?{tags:i.meta.tags}:{},...i.meta.parameters!==void 0?{parameters:i.meta.parameters}:{}}}}function $(i,t){const e={...i.autoArgTypes};for(const n of Object.keys(i.userArgTypes)){const r=i.userArgTypes[n];r!==void 0&&(e[n]={...e[n],...r})}return{title:i.title,component:t,argTypes:e,...i.metaExtras.tags!==void 0?{tags:i.metaExtras.tags}:{},...i.metaExtras.parameters!==void 0?{parameters:i.metaExtras.parameters}:{}}}function K(i,t){const e=i.title.localeCompare(t.title,"en",{sensitivity:"base",numeric:!0});return e!==0?e:i.id.localeCompare(t.id,"en",{sensitivity:"base",numeric:!0})}const Q=new q;var y,P,S,M,L;class B{constructor(){f(this,M);f(this,y,[]);f(this,P,new Set);f(this,S,1)}emit(t,e){const n={id:N(this,S)._++,name:t,args:e,timestamp:Date.now()};d(this,y,[...s(this,y),n]),u(this,M,L).call(this)}subscribe(t){return s(this,P).add(t),t(s(this,y)),()=>{s(this,P).delete(t)}}clear(){s(this,y).length!==0&&(d(this,y,[]),u(this,M,L).call(this))}getLogs(){return s(this,y)}}y=new WeakMap,P=new WeakMap,S=new WeakMap,M=new WeakSet,L=function(){for(const t of s(this,P))t(s(this,y))};const O=new B;function J(i,t=O){return(...e)=>{t.emit(i,e)}}function W(i,t,e=O){const n={...i};for(const r of Object.keys(t)){const o=t[r];if(o===void 0)continue;const h=o.action!==void 0&&o.action!==!1,c=o.type==="function";if(!h&&!c||typeof n[r]=="function")continue;const g=typeof o.action=="string"?o.action:r;n[r]=J(g,e)}return n}exports.ActionChannel=B;exports.ComponentRegistry=q;exports.UnknownEntryError=F;exports.action=J;exports.defaultActionChannel=O;exports.defaultRegistry=Q;exports.injectActions=W;
+"use strict";var V=Object.defineProperty;var U=i=>{throw TypeError(i)};var G=(i,t,e)=>t in i?V(i,t,{enumerable:!0,configurable:!0,writable:!0,value:e}):i[t]=e;var I=(i,t,e)=>G(i,typeof t!="symbol"?t+"":t,e),z=(i,t,e)=>t.has(i)||U("Cannot "+e);var s=(i,t,e)=>(z(i,t,"read from private field"),e?e.call(i):t.get(i)),u=(i,t,e)=>t.has(i)?U("Cannot add the same private member more than once"):t instanceof WeakSet?t.add(i):t.set(i,e),d=(i,t,e,n)=>(z(i,t,"write to private field"),n?n.call(i,e):t.set(i,e),e),f=(i,t,e)=>(z(i,t,"access private method"),e);var J=(i,t,e,n)=>({set _(r){d(i,t,r,e)},get _(){return s(i,t,n)}});Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});class F extends Error{constructor(e){super(`[jogak] Unknown entry id: ${e}`);I(this,"id");this.name="UnknownEntryError",this.id=e}}var a,C,b,v,k,E,w,j,A,T,l,m,M,q;class ${constructor(){u(this,l);u(this,a,new Map);u(this,C);u(this,b,new Set);u(this,v);u(this,k);u(this,E);u(this,w);u(this,j);u(this,A,!1);u(this,T,!1)}register(t){const e=H(t);f(this,l,q).call(this,()=>{this.registerMeta(e),this.hydrateEntry(t.id,t.jogaks,t.meta.component)})}unregister(t){const e=s(this,a).get(t);e!==void 0&&(e.kind==="pending"&&e.reject(new F(t)),s(this,a).delete(t),f(this,l,m).call(this))}get(t){const e=s(this,a).get(t);return(e==null?void 0:e.kind)==="hydrated"?e.entry:void 0}getAll(){if(s(this,E)!==void 0)return s(this,E);const t=[];for(const n of f(this,l,M).call(this)){const r=s(this,a).get(n);(r==null?void 0:r.kind)==="hydrated"&&t.push(r.entry)}const e=t;return d(this,E,e),e}search(t){const e=t.toLowerCase();return this.getAll().filter(n=>n.title.toLowerCase().includes(e))}getTree(){if(s(this,w)!==void 0)return s(this,w);const t={};for(const e of this.getAll()){const n=e.title.split("/");let r=t;for(let h=0;h<n.length-1;h++){const c=n[h];if(c===void 0)continue;const g=r[c];(g===void 0||"id"in g)&&(r[c]={}),r=r[c]}const o=n[n.length-1];o!==void 0&&(r[o]=e)}return d(this,w,t),t}clear(){if(s(this,a).size!==0){for(const t of s(this,a).values())t.kind==="pending"&&t.reject(new Error("[jogak] registry cleared"));s(this,a).clear(),f(this,l,m).call(this)}}get size(){let t=0;for(const e of s(this,a).values())e.kind==="hydrated"&&t++;return t}registerMeta(t){const e=s(this,a).get(t.id);if(e===void 0){s(this,a).set(t.id,{kind:"meta",meta:t}),f(this,l,m).call(this);return}if(e.kind==="meta"){s(this,a).set(t.id,{kind:"meta",meta:t}),f(this,l,m).call(this);return}if(e.kind==="pending"){s(this,a).set(t.id,{kind:"pending",meta:t,promise:e.promise,resolve:e.resolve,reject:e.reject}),f(this,l,m).call(this);return}const n={...e.entry,title:t.title,filePath:t.filePath,source:t.source,meta:N(t,e.entry.meta.component)};s(this,a).set(t.id,{kind:"hydrated",meta:t,entry:n}),f(this,l,m).call(this)}hydrateEntry(t,e,n){const r=s(this,a).get(t);let o;r===void 0?(console.warn(`[jogak] hydrateEntry called for unknown id "${t}" — synthesizing minimal meta`),o={id:t,title:t,jogakNames:e.map(c=>c.name),autoArgTypes:{},userArgTypes:{},source:"",filePath:"",metaExtras:{}}):o=r.meta;const h={id:o.id,title:o.title,jogaks:e,meta:N(o,n),...o.filePath?{filePath:o.filePath}:{},...o.source?{source:o.source}:{}};if((r==null?void 0:r.kind)==="pending"){s(this,a).set(t,{kind:"hydrated",meta:o,entry:h}),f(this,l,m).call(this),r.resolve(h);return}s(this,a).set(t,{kind:"hydrated",meta:o,entry:h}),f(this,l,m).call(this)}invalidateEntry(t){const e=s(this,a).get(t);e===void 0||e.kind!=="hydrated"||(s(this,a).set(t,{kind:"meta",meta:e.meta}),f(this,l,m).call(this))}requestEntry(t){const e=s(this,a).get(t);if(e===void 0)return Promise.reject(new F(t));if(e.kind==="hydrated")return Promise.resolve(e.entry);if(e.kind==="pending")return e.promise;const n=s(this,C);if(n===void 0)return Promise.reject(new Error("[jogak] entry loader not set — virtual:jogak index module did not load"));let r,o;const h=new Promise((c,g)=>{r=c,o=g});return s(this,a).set(t,{kind:"pending",meta:e.meta,promise:h,resolve:r,reject:o}),n(t).then(()=>{const c=s(this,a).get(t);(c==null?void 0:c.kind)!=="hydrated"&&o(new Error(`[jogak] entry module loaded but did not hydrate: ${t}`))},c=>{const g=c instanceof Error?c:new Error(String(c)),p=s(this,a).get(t);(p==null?void 0:p.kind)==="pending"&&p.promise===h&&s(this,a).set(t,{kind:"meta",meta:e.meta}),o(g)}),h}getAllMeta(){if(s(this,v)!==void 0)return s(this,v);const t=[];for(const n of f(this,l,M).call(this)){const r=s(this,a).get(n);r!==void 0&&t.push(r.meta)}const e=t;return d(this,v,e),e}getMetaTree(){if(s(this,k)!==void 0)return s(this,k);const t={};for(const e of f(this,l,M).call(this)){const n=s(this,a).get(e);if(n===void 0)continue;const r=n.meta,o=r.title.split("/");let h=t;for(let g=0;g<o.length-1;g++){const p=o[g];if(p===void 0)continue;const R=h[p];(R===void 0||"id"in R)&&(h[p]={}),h=h[p]}const c=o[o.length-1];c!==void 0&&(h[c]=r)}return d(this,k,t),t}getEntryState(t){const e=s(this,a).get(t);return e===void 0?"unknown":e.kind}setEntryLoader(t){d(this,C,t)}subscribe(t){s(this,b).add(t);let e=!0;return()=>{e&&(e=!1,s(this,b).delete(t))}}}a=new WeakMap,C=new WeakMap,b=new WeakMap,v=new WeakMap,k=new WeakMap,E=new WeakMap,w=new WeakMap,j=new WeakMap,A=new WeakMap,T=new WeakMap,l=new WeakSet,m=function(){if(d(this,v,void 0),d(this,k,void 0),d(this,E,void 0),d(this,w,void 0),d(this,j,void 0),s(this,A)){d(this,T,!0);return}const t=Array.from(s(this,b));for(const e of t)try{e()}catch(n){console.error("[jogak] subscribe listener threw:",n)}},M=function(){if(s(this,j)!==void 0)return s(this,j);const t=[];for(const[n,r]of s(this,a))t.push({id:n,title:r.meta.title});t.sort(K);const e=t.map(n=>n.id);return d(this,j,e),e},q=function(t){if(s(this,A)){t();return}d(this,A,!0),d(this,T,!1);try{t()}finally{d(this,A,!1),s(this,T)&&(d(this,T,!1),f(this,l,m).call(this))}};function H(i){const t=i.meta.argTypes??{};return{id:i.id,title:i.title,jogakNames:i.jogaks.map(e=>e.name),autoArgTypes:{},userArgTypes:t,source:i.source??"",filePath:i.filePath??"",metaExtras:{...i.meta.tags!==void 0?{tags:i.meta.tags}:{},...i.meta.parameters!==void 0?{parameters:i.meta.parameters}:{}}}}function N(i,t){const e={...i.autoArgTypes};for(const n of Object.keys(i.userArgTypes)){const r=i.userArgTypes[n];r!==void 0&&(e[n]={...e[n],...r})}return{title:i.title,component:t,argTypes:e,...i.metaExtras.tags!==void 0?{tags:i.metaExtras.tags}:{},...i.metaExtras.parameters!==void 0?{parameters:i.metaExtras.parameters}:{}}}function K(i,t){const e=i.title.localeCompare(t.title,"en",{sensitivity:"base",numeric:!0});return e!==0?e:i.id.localeCompare(t.id,"en",{sensitivity:"base",numeric:!0})}const Q=new $;var y,P,S,x,L;class D{constructor(){u(this,x);u(this,y,[]);u(this,P,new Set);u(this,S,1)}emit(t,e){const n={id:J(this,S)._++,name:t,args:e,timestamp:Date.now()};d(this,y,[...s(this,y),n]),f(this,x,L).call(this)}subscribe(t){return s(this,P).add(t),t(s(this,y)),()=>{s(this,P).delete(t)}}clear(){s(this,y).length!==0&&(d(this,y,[]),f(this,x,L).call(this))}getLogs(){return s(this,y)}}y=new WeakMap,P=new WeakMap,S=new WeakMap,x=new WeakSet,L=function(){for(const t of s(this,P))t(s(this,y))};const O=new D;function B(i,t=O){return(...e)=>{t.emit(i,e)}}function W(i,t,e=O){const n={...i};for(const r of Object.keys(t)){const o=t[r];if(o===void 0)continue;const h=o.action!==void 0&&o.action!==!1,c=o.type==="function";if(!h&&!c||typeof n[r]=="function")continue;const g=typeof o.action=="string"?o.action:r;n[r]=B(g,e)}return n}function X(i){return i}exports.ActionChannel=D;exports.ComponentRegistry=$;exports.UnknownEntryError=F;exports.action=B;exports.defaultActionChannel=O;exports.defaultRegistry=Q;exports.defineJogakConfig=X;exports.injectActions=W;

package/dist/index.mjs

@@ -1,10 +1,10 @@
-var R = Object.defineProperty;
+var J = Object.defineProperty;
 var I = (i) => {
   throw TypeError(i);
 };
-var B = (i, t, e) => t in i ? R(i, t, { enumerable: !0, configurable: !0, writable: !0, value: e }) : i[t] = e;
-var N = (i, t, e) => B(i, typeof t != "symbol" ? t + "" : t, e), z = (i, t, e) => t.has(i) || I("Cannot " + e);
-var s = (i, t, e) => (z(i, t, "read from private field"), e ? e.call(i) : t.get(i)), f = (i, t, e) => t.has(i) ? I("Cannot add the same private member more than once") : t instanceof WeakSet ? t.add(i) : t.set(i, e), c = (i, t, e, n) => (z(i, t, "write to private field"), n ? n.call(i, e) : t.set(i, e), e), u = (i, t, e) => (z(i, t, "access private method"), e);
+var R = (i, t, e) => t in i ? J(i, t, { enumerable: !0, configurable: !0, writable: !0, value: e }) : i[t] = e;
+var N = (i, t, e) => R(i, typeof t != "symbol" ? t + "" : t, e), z = (i, t, e) => t.has(i) || I("Cannot " + e);
+var s = (i, t, e) => (z(i, t, "read from private field"), e ? e.call(i) : t.get(i)), u = (i, t, e) => t.has(i) ? I("Cannot add the same private member more than once") : t instanceof WeakSet ? t.add(i) : t.set(i, e), c = (i, t, e, n) => (z(i, t, "write to private field"), n ? n.call(i, e) : t.set(i, e), e), f = (i, t, e) => (z(i, t, "access private method"), e);
 var O = (i, t, e, n) => ({
   set _(r) {
     c(i, t, r, e);
@@ -21,28 +21,28 @@ class U extends Error {
   }
 }
 var a, P, b, v, k, E, w, j, A, T, l, m, C, q;
-class J {
+class B {
   constructor() {
-    f(this, l);
-    f(this, a, /* @__PURE__ */ new Map());
-    f(this, P);
+    u(this, l);
+    u(this, a, /* @__PURE__ */ new Map());
+    u(this, P);
     // ── F2: subscribe + 내부 캐시 ────────────────────────────────────────
-    f(this, b, /* @__PURE__ */ new Set());
-    f(this, v);
-    f(this, k);
+    u(this, b, /* @__PURE__ */ new Set());
+    u(this, v);
+    u(this, k);
     // 결정성 fix: hydrated entry list / tree 도 캐시. mutation 시 invalidate.
-    f(this, E);
-    f(this, w);
+    u(this, E);
+    u(this, w);
     /**
      * 정렬된 id 순서. mutation 시 invalidate, 다음 호출에서 한 번만 재계산.
      * getAll / getTree / getAllMeta / getMetaTree 모두 이 순서를 따른다.
      * 결과: 모든 외부 노출 collection 이 동일 ordering 을 가진다.
      */
-    f(this, j);
+    u(this, j);
     /** register()가 registerMeta + hydrateEntry를 합쳐 호출할 때 중간 notify를 억제한다. */
-    f(this, A, !1);
+    u(this, A, !1);
     /** batch 도중에 mutation이 한 번이라도 일어났는지 — false면 batch 종료 시 notify 안 한다. */
-    f(this, T, !1);
+    u(this, T, !1);
   }
   // ── 기존 외부 API: 시그니처 변경 없음. 시맨틱은 hydrated만 표면. ───────────
   /**
@@ -54,13 +54,13 @@ class J {
    */
   register(t) {
     const e = V(t);
-    u(this, l, q).call(this, () => {
+    f(this, l, q).call(this, () => {
       this.registerMeta(e), this.hydrateEntry(t.id, t.jogaks, t.meta.component);
     });
   }
   unregister(t) {
     const e = s(this, a).get(t);
-    e !== void 0 && (e.kind === "pending" && e.reject(new U(t)), s(this, a).delete(t), u(this, l, m).call(this));
+    e !== void 0 && (e.kind === "pending" && e.reject(new U(t)), s(this, a).delete(t), f(this, l, m).call(this));
   }
   /** hydrated일 때만 RegistryEntry를 반환한다. meta-only/pending이면 undefined. */
   get(t) {
@@ -71,7 +71,7 @@ class J {
   getAll() {
     if (s(this, E) !== void 0) return s(this, E);
     const t = [];
-    for (const n of u(this, l, C).call(this)) {
+    for (const n of f(this, l, C).call(this)) {
       const r = s(this, a).get(n);
       (r == null ? void 0 : r.kind) === "hydrated" && t.push(r.entry);
     }
@@ -109,7 +109,7 @@ class J {
     if (s(this, a).size !== 0) {
       for (const t of s(this, a).values())
         t.kind === "pending" && t.reject(new Error("[jogak] registry cleared"));
-      s(this, a).clear(), u(this, l, m).call(this);
+      s(this, a).clear(), f(this, l, m).call(this);
     }
   }
   /** hydrated 개수. */
@@ -127,11 +127,11 @@ class J {
   registerMeta(t) {
     const e = s(this, a).get(t.id);
     if (e === void 0) {
-      s(this, a).set(t.id, { kind: "meta", meta: t }), u(this, l, m).call(this);
+      s(this, a).set(t.id, { kind: "meta", meta: t }), f(this, l, m).call(this);
       return;
     }
     if (e.kind === "meta") {
-      s(this, a).set(t.id, { kind: "meta", meta: t }), u(this, l, m).call(this);
+      s(this, a).set(t.id, { kind: "meta", meta: t }), f(this, l, m).call(this);
       return;
     }
     if (e.kind === "pending") {
@@ -141,7 +141,7 @@ class J {
         promise: e.promise,
         resolve: e.resolve,
         reject: e.reject
-      }), u(this, l, m).call(this);
+      }), f(this, l, m).call(this);
       return;
     }
     const n = {
@@ -151,7 +151,7 @@ class J {
       source: t.source,
       meta: $(t, e.entry.meta.component)
     };
-    s(this, a).set(t.id, { kind: "hydrated", meta: t, entry: n }), u(this, l, m).call(this);
+    s(this, a).set(t.id, { kind: "hydrated", meta: t, entry: n }), f(this, l, m).call(this);
   }
   /**
    * entry 가상모듈이 호출. pending Promise들을 resolve.
@@ -181,10 +181,10 @@ class J {
       ...o.source ? { source: o.source } : {}
     };
     if ((r == null ? void 0 : r.kind) === "pending") {
-      s(this, a).set(t, { kind: "hydrated", meta: o, entry: h }), u(this, l, m).call(this), r.resolve(h);
+      s(this, a).set(t, { kind: "hydrated", meta: o, entry: h }), f(this, l, m).call(this), r.resolve(h);
       return;
     }
-    s(this, a).set(t, { kind: "hydrated", meta: o, entry: h }), u(this, l, m).call(this);
+    s(this, a).set(t, { kind: "hydrated", meta: o, entry: h }), f(this, l, m).call(this);
   }
   /**
    * 어댑터가 호출. hydrated였던 entry를 meta 상태로 되돌린다.
@@ -193,7 +193,7 @@ class J {
    */
   invalidateEntry(t) {
     const e = s(this, a).get(t);
-    e === void 0 || e.kind !== "hydrated" || (s(this, a).set(t, { kind: "meta", meta: e.meta }), u(this, l, m).call(this));
+    e === void 0 || e.kind !== "hydrated" || (s(this, a).set(t, { kind: "meta", meta: e.meta }), f(this, l, m).call(this));
   }
   /**
    * UI/어댑터가 호출. entry id로 완전한 RegistryEntry를 비동기 획득.
@@ -250,7 +250,7 @@ class J {
   getAllMeta() {
     if (s(this, v) !== void 0) return s(this, v);
     const t = [];
-    for (const n of u(this, l, C).call(this)) {
+    for (const n of f(this, l, C).call(this)) {
       const r = s(this, a).get(n);
       r !== void 0 && t.push(r.meta);
     }
@@ -264,7 +264,7 @@ class J {
   getMetaTree() {
     if (s(this, k) !== void 0) return s(this, k);
     const t = {};
-    for (const e of u(this, l, C).call(this)) {
+    for (const e of f(this, l, C).call(this)) {
       const n = s(this, a).get(e);
       if (n === void 0) continue;
       const r = n.meta, o = r.title.split("/");
@@ -355,7 +355,7 @@ q = function(t) {
   try {
     t();
   } finally {
-    c(this, A, !1), s(this, T) && (c(this, T, !1), u(this, l, m).call(this));
+    c(this, A, !1), s(this, T) && (c(this, T, !1), f(this, l, m).call(this));
   }
 };
 function V(i) {
@@ -397,14 +397,14 @@ function G(i, t) {
   });
   return e !== 0 ? e : i.id.localeCompare(t.id, "en", { sensitivity: "base", numeric: !0 });
 }
-const W = new J();
+const W = new B();
 var p, x, S, M, F;
 class H {
   constructor() {
-    f(this, M);
-    f(this, p, []);
-    f(this, x, /* @__PURE__ */ new Set());
-    f(this, S, 1);
+    u(this, M);
+    u(this, p, []);
+    u(this, x, /* @__PURE__ */ new Set());
+    u(this, S, 1);
   }
   emit(t, e) {
     const n = {
@@ -413,7 +413,7 @@ class H {
       args: e,
       timestamp: Date.now()
     };
-    c(this, p, [...s(this, p), n]), u(this, M, F).call(this);
+    c(this, p, [...s(this, p), n]), f(this, M, F).call(this);
   }
   subscribe(t) {
     return s(this, x).add(t), t(s(this, p)), () => {
@@ -421,7 +421,7 @@ class H {
     };
   }
   clear() {
-    s(this, p).length !== 0 && (c(this, p, []), u(this, M, F).call(this));
+    s(this, p).length !== 0 && (c(this, p, []), f(this, M, F).call(this));
   }
   getLogs() {
     return s(this, p);
@@ -448,12 +448,16 @@ function X(i, t, e = D) {
   }
   return n;
 }
+function Y(i) {
+  return i;
+}
 export {
   H as ActionChannel,
-  J as ComponentRegistry,
+  B as ComponentRegistry,
   U as UnknownEntryError,
   K as action,
   D as defaultActionChannel,
   W as defaultRegistry,
+  Y as defineJogakConfig,
   X as injectActions
 };

package/dist/types.d.ts

@@ -208,4 +208,39 @@ export interface JogakPluginOptions {
      * jogak({ globalCss: ['./src/tokens.css', './src/index.css'] })
      */
     readonly globalCss?: boolean | string | readonly string[];
+    /**
+     * Preview 영역의 격리 모드 (알파.7 도입, 알파.7.1에서 default 변경).
+     *
+     * 사용자 globalCss와 jogak chrome의 양방향 격리를 제공한다. 알파.7까지는
+     * 사용자 globalCss를 outer document에 inject하면서 jogak chrome utility를
+     * 무력화하는 결함이 있었으나 알파.7.1에서 main.tsx + ShadowMount가 모드별
+     * scope을 분리하도록 정정됨.
+     *
+     * 모드:
+     * - `'shadow'` (default, 알파.7.1): Preview의 `[data-jogak-content]` 영역만
+     *   ShadowRoot에 마운트하고 사용자 globalCss를 ShadowRoot scope에만 inject.
+     *   outer document의 jogak chrome은 사용자 reset/preflight 침범을 받지 않는다.
+     *   **한계**: Radix UI(shadcn dialog/popover/tooltip 등)는 default Portal target이
+     *   `document.body` (shadow 외부) — portal 내용은 사용자 css 미적용. 회피:
+     *   사용자가 명시적으로 `<Portal container={shadowRootEl}>` 전달.
+     * - `'iframe'`: Preview를 별도 `<iframe>`에 로드. 완벽 격리. **한계**: jogak의
+     *   "single Vite, no iframe" 차별점과 상충하므로 명시적 opt-in 한정. HMR은
+     *   iframe도 Vite dev server module이라 작동하지만, args/이벤트 전달이
+     *   `contentWindow` 직접 접근 한 단계 추가됨.
+     * - `'none'` (back-compat opt-in): Preview는 jogak SPA와 동일 document에 마운트하고
+     *   사용자 globalCss를 outer document에 inject. 사용자 reset/preflight가 jogak
+     *   chrome에 침범 가능. 사용자가 침범을 의도적으로 허용하는 경우만 사용.
+     *
+     * @default 'shadow'
+     *
+     * @example 양방향 격리 (default — 미지정 시 적용)
+     * jogak({ globalCss: true })  // previewIsolation 'shadow' 자동 적용
+     *
+     * @example 사용자 reset이 chrome에도 영향을 주길 원하는 경우
+     * jogak({ globalCss: true, previewIsolation: 'none' })
+     *
+     * @example Radix portal까지 완벽 격리
+     * jogak({ globalCss: true, previewIsolation: 'iframe' })
+     */
+    readonly previewIsolation?: 'none' | 'shadow' | 'iframe';
 }

package/dist/vite/index.js

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

package/dist/vite/index.mjs

@@ -1,83 +1,83 @@
-import { resolve as y, join as $, dirname as K } from "node:path";
-import { existsSync as b, readFileSync as W } from "node:fs";
-import { stat as M, rm as X, readdir as Y, readFile as L } from "node:fs/promises";
-import { c as N } from "../extractor-client-CReBed7x.js";
-const q = [
+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 = [
   "@jogak/core",
   "@jogak/react",
   "@jogak/web-components",
   "@jogak/next"
 ];
-async function P(t) {
+async function F(t) {
   try {
-    const n = await M(t);
-    if (!n.isDirectory())
-      return n.mtimeMs;
+    const a = await O(t);
+    if (!a.isDirectory())
+      return a.mtimeMs;
   } catch {
     return 0;
   }
-  let r = 0, s;
+  let o = 0, s;
   try {
-    s = await Y(t);
+    s = await q(t);
   } catch {
     return 0;
   }
-  for (const n of s) {
-    const g = $(t, n);
+  for (const a of s) {
+    const g = P(t, a);
     try {
-      const l = await M(g);
-      if (l.isDirectory()) {
-        const p = await P(g);
-        p > r && (r = p);
-      } else l.mtimeMs > r && (r = l.mtimeMs);
+      const c = await O(g);
+      if (c.isDirectory()) {
+        const p = await F(g);
+        p > o && (o = p);
+      } else c.mtimeMs > o && (o = c.mtimeMs);
     } catch {
       continue;
     }
   }
-  return r;
+  return o;
 }
-async function H(t) {
-  const r = y(t.root, "node_modules/.vite/deps");
-  if (!b(r))
+async function z(t) {
+  const o = y(t.root, "node_modules/.vite/deps");
+  if (!T(o))
     return { purged: !1 };
-  const s = $(r, "_metadata.json");
-  if (!b(s))
+  const s = P(o, "_metadata.json");
+  if (!T(s))
     return { purged: !1 };
-  let n;
+  let a;
   try {
-    n = (await M(s)).mtimeMs;
-  } catch (l) {
+    a = (await O(s)).mtimeMs;
+  } catch (c) {
     return t.logger.warn(
-      `[jogak] cache validation: failed to stat _metadata.json (${l.message})`
+      `[jogak] cache validation: failed to stat _metadata.json (${c.message})`
     ), { purged: !1 };
   }
-  const g = t.packages ?? q;
-  for (const l of g) {
-    const p = y(t.root, "node_modules", l, "dist");
-    if (!b(p)) continue;
+  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;
     try {
-      h = await P(p);
-    } catch (a) {
+      h = await F(p);
+    } catch (w) {
       t.logger.warn(
-        `[jogak] cache validation: failed to walk ${l}/dist (${a.message})`
+        `[jogak] cache validation: failed to walk ${c}/dist (${w.message})`
       );
       continue;
     }
-    if (h > n + 1e3)
+    if (h > a + 1e3)
       try {
-        return await X(r, { recursive: !0, force: !0 }), t.logger.info(
-          `[jogak] vite deps cache invalidated (stale): ${l} dist newer than cache`
-        ), { purged: !0, reason: l };
-      } catch (a) {
+        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 };
+      } catch (w) {
         return t.logger.warn(
-          `[jogak] cache validation: failed to purge ${r} (${a.message})`
+          `[jogak] cache validation: failed to purge ${o} (${w.message})`
         ), { purged: !1 };
       }
   }
   return { purged: !1 };
 }
-const z = [
+const Q = [
   "src/index.css",
   "src/main.css",
   "src/styles.css",
@@ -87,68 +87,68 @@ const z = [
   "src/global.css",
   "src/app.css"
 ];
-function Q(t) {
-  for (const r of z) {
-    const s = y(t, r);
-    if (b(s)) return [s];
+function Z(t) {
+  for (const o of Q) {
+    const s = y(t, o);
+    if (T(s)) return [s];
   }
   return [];
 }
-function Z(t, r) {
+function tt(t, o) {
   if (t === void 0 || t === !1) return [];
-  if (t === !0) return Q(r);
+  if (t === !0) return Z(o);
   if (typeof t == "string")
-    return t.length > 0 ? [y(r, t)] : [];
+    return t.length > 0 ? [y(o, t)] : [];
   const s = [];
-  for (const n of t)
-    typeof n == "string" && n.length > 0 && s.push(y(r, n));
+  for (const a of t)
+    typeof a == "string" && a.length > 0 && s.push(y(o, a));
   return s;
 }
-function tt(t) {
+function et(t) {
   return t.replace(/\/\*[\s\S]*?\*\//g, "").replace(/^\s*\/\/.*$/gm, "");
 }
-function et(t) {
-  if (b(t))
+function ot(t) {
+  if (T(t))
     try {
-      const r = W(t, "utf8");
-      return JSON.parse(tt(r));
+      const o = X(t, "utf8");
+      return JSON.parse(et(o));
     } catch {
       return;
     }
 }
-function rt(t, r, s) {
-  if (!t.endsWith("/*") || !r.endsWith("/*")) return;
-  const n = t.slice(0, -2), g = y(s, r.slice(0, -2));
-  return [n, g];
+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 ot(t, r) {
-  var g, l;
-  const s = {}, n = /* @__PURE__ */ new Set([
+function st(t, o) {
+  var g, c;
+  const s = {}, a = /* @__PURE__ */ new Set([
     t,
-    y(r, "tsconfig.app.json")
+    y(o, "tsconfig.app.json")
   ]);
-  for (const p of n) {
-    const h = et(p);
+  for (const p of a) {
+    const h = ot(p);
     if (h === void 0) continue;
-    const a = (g = h.compilerOptions) == null ? void 0 : g.paths;
-    if (a === void 0) continue;
-    const m = ((l = h.compilerOptions) == null ? void 0 : l.baseUrl) ?? ".", j = y(K(p), m);
-    for (const [_, C] of Object.entries(a)) {
-      const k = C[0];
-      if (k === void 0) continue;
-      const T = rt(_, k, j);
-      if (T === void 0) continue;
-      const [e, u] = T;
-      s[e] === void 0 && (s[e] = u);
+    const w = (g = h.compilerOptions) == null ? void 0 : g.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);
     }
   }
   return s;
 }
-const F = "virtual:jogak", x = "\0" + F, G = "virtual:jogak/entry/", I = "\0" + G, U = "virtual:jogak/global-css", R = "\0" + U;
-function st(t) {
+const G = "virtual:jogak", E = "\0" + G, U = "virtual:jogak/entry/", M = "\0" + U, V = "virtual:jogak/global-css", $ = "\0" + V;
+function at(t) {
   return Buffer.from(t, "utf8").toString("base64url");
 }
-function at(t) {
+function nt(t) {
   return Buffer.from(t, "base64url").toString("utf8");
 }
 function D(t) {
@@ -157,55 +157,55 @@ function D(t) {
     jogakNamesKey: [...t.jogakNames].sort().join("|")
   };
 }
-function nt(t, r) {
-  return t !== void 0 && t.title === r.title && t.jogakNamesKey === r.jogakNamesKey;
+function it(t, o) {
+  return t !== void 0 && t.title === o.title && t.jogakNamesKey === o.jogakNamesKey;
 }
-function ft(t = {}) {
+function gt(t = {}) {
   const {
-    patterns: r = ["src/**/*.jogak.ts", "src/**/*.jogak.tsx"],
+    patterns: o = ["src/**/*.jogak.ts", "src/**/*.jogak.tsx"],
     codeTheme: s = "vsDark"
-  } = t, n = t.cwd, g = t.tsConfigFilePath, l = t.disableCacheValidation === !0, p = t.resolveAlias, h = t.globalCss;
-  let a, m, j;
-  const _ = /* @__PURE__ */ new Map(), C = /* @__PURE__ */ new Map(), k = /* @__PURE__ */ new Map();
-  async function T() {
-    const { glob: e } = await import("glob"), u = j ?? process.cwd(), o = (await e(r, { cwd: u, absolute: !0 })).sort(), d = [];
-    _.clear(), C.clear();
-    for (const i of o) {
+  } = 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) {
       let v = "";
       try {
-        v = await L(i, "utf8");
+        v = await L(n, "utf8");
       } catch {
         continue;
       }
-      let w = {}, c = null;
+      let j = {}, i = null;
       if (m !== void 0) {
         try {
-          w = await m.extract(i);
+          j = await m.extract(n);
         } catch {
-          w = {};
+          j = {};
         }
         try {
-          c = await m.extractMeta(i);
+          i = await m.extractMeta(n);
         } catch {
-          c = null;
+          i = null;
         }
       }
-      if (c === null) continue;
-      const f = c.title;
-      _.set(f, i), C.set(i, f);
-      const S = {
+      if (i === null) continue;
+      const f = i.title;
+      k.set(f, n), S.set(n, f);
+      const C = {
         id: f,
-        title: c.title,
-        jogakNames: c.jogakNames,
-        autoArgTypes: w,
-        userArgTypes: c.userArgTypes,
+        title: i.title,
+        jogakNames: i.jogakNames,
+        autoArgTypes: j,
+        userArgTypes: i.userArgTypes,
         source: v,
-        filePath: i,
-        metaExtras: c.metaExtras
+        filePath: n,
+        metaExtras: i.metaExtras
       };
-      k.set(i, D(S)), d.push({ id: f, filePath: i, meta: S });
+      b.set(n, D(C)), l.push({ id: f, filePath: n, meta: C });
     }
-    return d;
+    return l;
   }
   return {
     name: "vite-plugin-jogak",
@@ -220,76 +220,77 @@ function ft(t = {}) {
      * 우선순위: `options.resolveAlias` (명시) > tsconfig 자동 추출.
      */
     config() {
-      const e = n ?? process.cwd(), u = g ?? y(e, "tsconfig.json"), o = ot(u, e), d = {};
+      const e = a ?? process.cwd(), d = g ?? y(e, "tsconfig.json"), r = st(d, e), l = {};
       if (p !== void 0)
-        for (const [v, w] of Object.entries(p))
-          d[v] = y(e, w);
-      const i = { ...o, ...d };
-      if (Object.keys(i).length !== 0)
+        for (const [v, j] of Object.entries(p))
+          l[v] = y(e, j);
+      const n = { ...r, ...l };
+      if (Object.keys(n).length !== 0)
         return {
-          resolve: { alias: i }
+          resolve: { alias: n }
         };
     },
     async configResolved(e) {
-      j = n ?? e.root, e.command === "serve" && !l && await H({
+      _ = a ?? e.root, e.command === "serve" && !c && await z({
         root: e.root,
         logger: {
-          info: (o) => e.logger.info(o),
-          warn: (o) => e.logger.warn(o)
+          info: (r) => e.logger.info(r),
+          warn: (r) => e.logger.warn(r)
         }
       });
-      const u = g ?? y(j, "tsconfig.json");
-      m = b(u) ? N({ tsConfigFilePath: u }) : N();
+      const d = g ?? y(_, "tsconfig.json");
+      m = T(d) ? R({ tsConfigFilePath: d }) : R();
     },
     configureServer(e) {
-      a = e;
+      u = e;
     },
     buildEnd() {
       m == null || m.releaseCache();
     },
     resolveId(e) {
-      if (e === F)
-        return x;
-      if (e === U)
-        return R;
-      if (e.startsWith(G))
+      if (e === G)
+        return E;
+      if (e === V)
+        return $;
+      if (e.startsWith(U))
         return "\0" + e;
     },
     async load(e) {
-      if (e === R) {
-        const u = j ?? process.cwd(), o = Z(h, u);
-        return o.length === 0 ? `// [jogak] globalCss not configured or no candidates found.
+      if (e === $) {
+        const d = _ ?? process.cwd(), r = tt(h, d);
+        return r.length === 0 ? `// [jogak] globalCss not configured or no candidates found.
 export {}
-` : `${o.map((i) => `import ${JSON.stringify(i)}`).join(`
+` : `${r.map((n) => `import ${JSON.stringify(n)}`).join(`
 `)}
 export {}
 `;
       }
-      if (e === x) {
-        const o = (await T()).map((d) => d.meta);
+      if (e === E) {
+        const r = (await A()).map((l) => l.meta);
         return `import { defaultRegistry } from '@jogak/core'
 
 const _entryLoader = (slug) =>
   import(/* @vite-ignore */ '/@id/__x00__virtual:jogak/entry/' + slug)
 defaultRegistry.setEntryLoader((id) => {
-  const slug = ${it()}
+  const slug = ${ct()}
   return _entryLoader(slug(id))
 })
 
-const _metas = ${JSON.stringify(o)}
+const _metas = ${JSON.stringify(r)}
 
 for (const m of _metas) defaultRegistry.registerMeta(m)
 
 export const _jogakCodeTheme = ${JSON.stringify(s)}
+export const _jogakPreviewIsolation = ${JSON.stringify(w)}
 export const _jogakMetas = _metas
 `;
       }
-      if (e.startsWith(I)) {
-        const u = e.slice(I.length), o = at(u);
-        let d = _.get(o);
-        return d === void 0 && (await T(), d = _.get(o)), d === void 0 ? `// [jogak] unknown entry id: ${JSON.stringify(o)}
+      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)}
 export {}
-` : `import * as _user from ${JSON.stringify(d)}
+` : `import * as _user from ${JSON.stringify(l)}
 import { defaultRegistry } from '@jogak/core'
 
 const _meta = _user.default
@@ -298,7 +299,7 @@ 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)
+defaultRegistry.hydrateEntry(${JSON.stringify(r)}, _jogaks, _meta?.component)
 
 if (import.meta.hot) {
   import.meta.hot.accept()
@@ -308,13 +309,13 @@ export {}
 `;
       }
     },
-    async handleHotUpdate({ file: e, modules: u }) {
-      const o = /\.jogak\.(tsx?|jsx?)$/.test(e), d = /\.(tsx?|jsx?)$/.test(e) && !o;
-      if (!o && !d || a === void 0 || !o) return;
-      const i = a.moduleGraph.getModuleById(
-        x
-      ), v = C.get(e), w = v !== void 0 ? I + st(v) : void 0, c = w !== void 0 ? a.moduleGraph.getModuleById(w) : void 0;
-      let f = null, S = {}, A = "";
+    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) {
         try {
           f = await m.extractMeta(e);
@@ -322,46 +323,46 @@ export {}
           f = null;
         }
         try {
-          S = await m.extract(e);
+          C = await m.extract(e);
         } catch {
-          S = {};
+          C = {};
         }
         try {
-          A = await L(e, "utf8");
+          I = await L(e, "utf8");
         } catch {
-          A = "";
+          I = "";
         }
       }
       if (f === null) {
-        i !== void 0 && a.moduleGraph.invalidateModule(i), c !== void 0 && a.moduleGraph.invalidateModule(c), a.ws.send({ type: "full-reload" });
+        n !== void 0 && u.moduleGraph.invalidateModule(n), i !== void 0 && u.moduleGraph.invalidateModule(i), u.ws.send({ type: "full-reload" });
         return;
       }
-      const O = D(f), V = k.get(e), B = nt(V, O);
-      if (k.set(e, O), !B || v === void 0) {
-        i !== void 0 && a.moduleGraph.invalidateModule(i), c !== void 0 && a.moduleGraph.invalidateModule(c), a.ws.send({ type: "full-reload" });
+      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" });
         return;
       }
-      const J = {
+      const K = {
         id: v,
         title: f.title,
         jogakNames: f.jogakNames,
-        autoArgTypes: S,
+        autoArgTypes: C,
         userArgTypes: f.userArgTypes,
-        source: A,
+        source: I,
         filePath: e,
         metaExtras: f.metaExtras
       };
-      c !== void 0 && a.moduleGraph.invalidateModule(c), a.ws.send({
+      i !== void 0 && u.moduleGraph.invalidateModule(i), u.ws.send({
         type: "custom",
         event: "jogak:meta-update",
-        data: { id: v, meta: J }
+        data: { id: v, meta: K }
       });
-      const E = [...u];
-      return c !== void 0 && !E.includes(c) && E.push(c), E;
+      const x = [...d];
+      return i !== void 0 && !x.includes(i) && x.push(i), x;
     }
   };
 }
-function it() {
+function ct() {
   return `(rawId) => {
     if (typeof Buffer !== 'undefined') return Buffer.from(rawId, 'utf8').toString('base64url')
     // 브라우저 폴백: btoa는 binary string 기준이라 UTF-8을 한번 인코딩해야 한다.
@@ -372,5 +373,5 @@ function it() {
   }`;
 }
 export {
-  ft as jogak
+  gt as jogak
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@jogak/core",
-  "version": "0.1.0-alpha.6",
+  "version": "0.1.0-alpha.7.1",
   "description": "Core types, registry, and Vite plugin for Jogak — a lightweight Storybook alternative.",
   "keywords": [
     "jogak",