@jogak/core 0.1.0-alpha.5 → 0.1.0-alpha.7

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

@@ -154,4 +154,89 @@ export interface JogakPluginOptions {
      * jogak({ resolveAlias: { '@': './src', '@components': './src/components' } })
      */
     readonly resolveAlias?: Readonly<Record<string, string>>;
+    /**
+     * 사용자 globalCss를 jogak SPA에 import한다 (알파.6 opt-in).
+     *
+     * 동기:
+     * - `runHost`는 vite root를 `@jogak/ui` 패키지로 두고 사용자 `vite.config.ts`/
+     *   `main.tsx`를 무시하므로(`configFile: false`), 사용자 `index.css`(Tailwind/
+     *   shadcn 디자인 토큰)가 jogak SPA에 자동 적용되지 않는다.
+     * - 본 옵션이 `true`이거나 명시 경로면 plugin이 사용자 css를 가상 모듈로
+     *   주입해 jogak SPA가 import한다.
+     *
+     * 의미:
+     * - `false` (default): 미주입. jogak chrome 기본 스타일만 사용 (알파.4~5 동작 그대로).
+     * - `true`: `<userRoot>/src/{index,main,styles,global,app,globals}.css` 후보를
+     *   순차 검사해 **첫 발견 1개**만 import. 미발견 시 빈 모듈 (no-op).
+     * - `string`: 사용자 root 기준 상대 경로 또는 절대 경로 1개. 자동 감지 비활성화.
+     * - `string[]`: 명시 경로 N개를 배열 순서대로 모두 import. 자동 감지 비활성화.
+     *
+     * 자동 감지 후보 (우선순위 순):
+     * 1. `src/index.css` (shadcn/ui Vite)
+     * 2. `src/main.css`
+     * 3. `src/styles.css`
+     * 4. `src/styles/globals.css` (Next.js shadcn)
+     * 5. `src/styles/index.css`
+     * 6. `src/app/globals.css` (Next.js App Router shadcn)
+     * 7. `src/global.css`
+     * 8. `src/app.css`
+     *
+     * 격리:
+     * - jogak UI는 알파.4~5에서 Tailwind v4 + `prefix=jogak`로 마이그레이션되어
+     *   사용자 utility class와 충돌 zero (예: 사용자 `.bg-primary` ≠ jogak `.jogak\:bg-...`).
+     * - jogak CSS variable은 `--jogak-*` prefix → 사용자 `:root { --primary }` 같은
+     *   토큰과 namespace 충돌 zero.
+     * - 단, 사용자 css의 `*` selector / `body` selector / reset 류는 jogak chrome에
+     *   영향 가능. README의 "scope 가이드" 패턴 참조.
+     *
+     * 한계 (알파.7+ 로드맵):
+     * - 사용자 css를 preview 영역으로만 한정하는 Shadow DOM/iframe 격리는 미지원.
+     * - `previewIsolation` 옵션은 알파.7+에서 별도 도입.
+     * - `globalCss: true` 자동 감지는 dev 시작 시점에 한 번만 수행 — 후보 css 파일이
+     *   dev 시작 후에 새로 추가되면 dev 서버 재시작이 필요하다. 명시 경로
+     *   (`globalCss: './src/index.css'`)는 파일이 나중에 생성되어도 정상 hot reload된다.
+     *
+     * @default false
+     *
+     * @example 자동 감지
+     * jogak({ globalCss: true })
+     *
+     * @example 명시 경로
+     * jogak({ globalCss: './src/index.css' })
+     *
+     * @example 다중 import (디자인 토큰 + reset 분리)
+     * jogak({ globalCss: ['./src/tokens.css', './src/index.css'] })
+     */
+    readonly globalCss?: boolean | string | readonly string[];
+    /**
+     * Preview 영역의 격리 모드 (알파.7 도입, opt-in).
+     *
+     * 사용자 globalCss(알파.6의 `globalCss` 옵션)가 jogak chrome에까지 전역 영향을
+     * 주는 것을 막고 싶을 때 사용한다. default `'none'`은 알파.6 동작 그대로.
+     *
+     * 모드:
+     * - `'none'` (default): Preview는 jogak SPA와 동일 document에 마운트.
+     *   알파.6 chrome 보호 rule(`[data-jogak-shell] :where(button,...)`)만으로
+     *   격리. 사용자 globalCss는 chrome + preview 모두 영향.
+     * - `'shadow'`: Preview의 `[data-jogak-content]` 영역만 ShadowRoot에 마운트.
+     *   사용자 globalCss를 `adoptedStyleSheets`로 ShadowRoot에 주입해 preview에서
+     *   디자인 토큰이 작동. **한계**: Radix UI(shadcn dialog/popover/tooltip 등)는
+     *   `Portal`을 `document.body`로 띄우므로 포털 내용은 ShadowRoot 외부로 빠져
+     *   utility class가 적용되지 않을 수 있다 (사용자 컴포넌트가 Portal `container`
+     *   prop으로 ShadowRoot 내부 element를 지정하면 회피 가능). 자세한 한계는
+     *   README 참조.
+     * - `'iframe'`: Preview를 별도 `<iframe>`에 로드. 완벽 격리. **한계**: jogak의
+     *   "single Vite, no iframe" 차별점과 상충하므로 명시적 opt-in 한정. HMR은
+     *   iframe도 Vite dev server module이라 작동하지만, args/이벤트 전달이
+     *   postMessage 또는 `contentWindow` 직접 접근 한 단계 추가됨.
+     *
+     * @default 'none'
+     *
+     * @example shadcn/ui dialog가 preview에서 사용자 토큰을 받게 하려면
+     * jogak({ globalCss: true, previewIsolation: 'none' })  // 기본 — 충분
+     *
+     * @example chrome 까지 사용자 reset이 침범하는 게 싫다면
+     * jogak({ globalCss: true, previewIsolation: 'shadow' })
+     */
+    readonly previewIsolation?: 'none' | 'shadow' | 'iframe';
 }

package/dist/vite/detect-global-css.d.ts

@@ -0,0 +1,33 @@
+/**
+ * 사용자 globalCss 자동 감지 + 옵션 정규화 (알파.6, opt-in).
+ *
+ * 본 모듈은 `JogakPluginOptions.globalCss` 옵션 값을 절대 경로 배열로 변환한다.
+ * 자동 감지(`true`)는 첫 발견 1개만 반환 — 다중 import는 명시 배열로 사용자가 선언.
+ *
+ * 자동 감지 후보(우선순위 순)는 spec `_workspace/01_arch/api-contracts.md` §4.1을 따른다.
+ */
+/**
+ * 사용자 globalCss 자동 감지.
+ *
+ * `<userRoot>/src/...` 후보를 우선순위 순으로 검사해 **첫 발견 1개**만 반환.
+ * 미발견 시 빈 배열.
+ *
+ * 첫 발견 stop 정책:
+ * - 사용자가 다중 import를 원하면 명시 배열(`globalCss: ['...', '...']`)을 쓰게 한다.
+ * - 자동 감지에서 모든 후보를 import하면 의도치 않은 css 중복(예: index.css와
+ *   styles.css 둘 다 존재 시)이 발생할 수 있다.
+ */
+export declare function detectUserGlobalCss(userRoot: string): readonly string[];
+/**
+ * 옵션 값 → 절대 경로 배열로 정규화.
+ *
+ * - `false`/`undefined`: `[]`
+ * - `true`: `detectUserGlobalCss(userRoot)`
+ * - `string`: `[resolve(userRoot, string)]`. 빈 문자열은 `[]`.
+ * - `string[]`: 각 요소 resolve, 빈 요소 무시 (배열 순서 보존)
+ *
+ * `existsSync` 검증은 명시 경로(string/string[])에서는 하지 않는다 — 사용자가
+ * 의도적으로 빈 파일 또는 동적 css generator를 쓸 수 있고, 미존재 시 Vite가
+ * 자체 에러로 알려주는 게 더 명확하다 (silent skip은 디버깅 어려움).
+ */
+export declare function resolveGlobalCssPaths(option: boolean | string | readonly string[] | undefined, userRoot: string): readonly string[];

package/dist/vite/index.js

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

package/dist/vite/index.mjs

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

package/dist/vite/virtual-ids.d.ts

@@ -15,5 +15,8 @@ export declare const RESOLVED_VIRTUAL_INDEX_ID: string;
 /** Entry 모듈 prefix — 뒤에 base64url(id)이 붙는다. */
 export declare const VIRTUAL_ENTRY_PREFIX = "virtual:jogak/entry/";
 export declare const RESOLVED_VIRTUAL_ENTRY_PREFIX: string;
+/** Global css 모듈 — 사용자 globalCss를 import한다 (알파.6, opt-in). */
+export declare const VIRTUAL_GLOBAL_CSS_ID = "virtual:jogak/global-css";
+export declare const RESOLVED_VIRTUAL_GLOBAL_CSS_ID: string;
 export declare function idToSlug(id: string): string;
 export declare function slugToId(slug: string): string;

package/package.json

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