@jogak/core 0.1.0-alpha.0

package/dist/meta/extractor-child.mjs

@@ -0,0 +1,305 @@
+import { Node as n, Project as m } from "ts-morph";
+function y(t = {}) {
+  function e() {
+    return t.tsConfigFilePath !== void 0 ? new m({ tsConfigFilePath: t.tsConfigFilePath }) : new m({ skipAddingFilesFromTsConfig: !0 });
+  }
+  let r;
+  function i() {
+    return r === void 0 && (r = e()), r;
+  }
+  function o(s) {
+    const a = i();
+    let c = a.getSourceFile(s);
+    return c === void 0 ? c = a.addSourceFileAtPathIfExists(s) : c.refreshFromFileSystemSync(), c;
+  }
+  return {
+    extract(s) {
+      const a = o(s);
+      return a === void 0 ? {} : j(a);
+    },
+    extractMeta(s) {
+      const a = o(s);
+      if (a !== void 0)
+        return O(a);
+    },
+    dispose() {
+      r = void 0;
+    }
+  };
+}
+function j(t) {
+  const e = t.getDefaultExportSymbol();
+  if (e === void 0) return {};
+  const r = e.getAliasedSymbol() ?? e, i = r.getDeclarations()[0] ?? e.getDeclarations()[0];
+  if (i === void 0) return {};
+  const s = r.getTypeAtLocation(i).getProperty("component");
+  if (s === void 0) return {};
+  const a = s.getTypeAtLocation(i), c = N(a, i);
+  if (c === void 0) return {};
+  const p = {};
+  for (const v of c.getProperties()) {
+    const S = v.getName(), T = v.getTypeAtLocation(i), u = E(T);
+    if (u === null) continue;
+    const A = !D(v), h = {
+      type: u.type,
+      required: A,
+      ...u.control !== void 0 ? { control: u.control } : {},
+      ...u.options !== void 0 ? { options: u.options } : {},
+      ...u.action === !0 ? { action: !0 } : {}
+    };
+    p[S] = h;
+  }
+  return p;
+}
+function N(t, e) {
+  const i = t.getCallSignatures()[0];
+  if (i === void 0) return;
+  const s = i.getParameters()[0];
+  if (s === void 0) return;
+  const a = s.getValueDeclaration() ?? e;
+  return s.getTypeAtLocation(a);
+}
+function D(t) {
+  for (const e of t.getDeclarations())
+    if ((n.isPropertySignature(e) || n.isPropertyDeclaration(e) || n.isParameterDeclaration(e)) && e.hasQuestionToken())
+      return !0;
+  return !1;
+}
+function E(t) {
+  if (t.isUnion()) {
+    const e = t.getUnionTypes().filter((r) => !r.isUndefined() && !r.isNull());
+    if (e.length === 0) return null;
+    if (e.length === 1) {
+      const r = e[0];
+      return r !== void 0 ? E(r) : null;
+    }
+    return e.every((r) => r.isStringLiteral()) ? {
+      type: "enum",
+      control: "select",
+      options: e.map((r) => F(r))
+    } : e.length === 2 && e.every((r) => r.isBooleanLiteral()) ? { type: "boolean", control: "boolean" } : null;
+  }
+  return t.isString() || t.isStringLiteral() ? { type: "string", control: "text" } : t.isNumber() || t.isNumberLiteral() ? { type: "number", control: "number" } : t.isBoolean() ? { type: "boolean", control: "boolean" } : t.getCallSignatures().length > 0 ? { type: "function", action: !0 } : null;
+}
+function F(t) {
+  const e = t.getLiteralValue();
+  return typeof e == "string" ? e : t.getText().replace(/^["']|["']$/g, "");
+}
+function O(t) {
+  const e = I(t);
+  if (e === void 0) return;
+  const r = P(e, "title");
+  if (r === void 0) return;
+  const i = k(e), o = z(e, "tags"), s = V(e, "parameters"), a = w(t), c = {
+    ...o !== void 0 ? { tags: o } : {},
+    ...s !== void 0 ? { parameters: s } : {}
+  };
+  return {
+    title: r,
+    jogakNames: a,
+    userArgTypes: i,
+    metaExtras: c
+  };
+}
+function I(t) {
+  for (const r of t.getExportAssignments()) {
+    if (r.isExportEquals()) continue;
+    const i = r.getExpression();
+    if (n.isObjectLiteralExpression(i)) return i;
+    if (n.isAsExpression(i)) {
+      const o = i.getExpression();
+      if (n.isObjectLiteralExpression(o)) return o;
+    }
+    if (n.isSatisfiesExpression(i)) {
+      const o = i.getExpression();
+      if (n.isObjectLiteralExpression(o)) return o;
+    }
+    if (n.isIdentifier(i)) {
+      const o = i.getSymbol();
+      if (o !== void 0) {
+        for (const s of o.getDeclarations())
+          if (n.isVariableDeclaration(s)) {
+            const a = s.getInitializer();
+            if (a !== void 0) {
+              const c = f(a);
+              if (c !== void 0) return c;
+            }
+          }
+      }
+    }
+  }
+  const e = t.getDefaultExportSymbol();
+  if (e !== void 0) {
+    const r = e.getAliasedSymbol() ?? e;
+    for (const i of r.getDeclarations())
+      if (n.isVariableDeclaration(i)) {
+        const o = i.getInitializer();
+        if (o !== void 0) {
+          const s = f(o);
+          if (s !== void 0) return s;
+        }
+      }
+  }
+}
+function f(t) {
+  if (n.isObjectLiteralExpression(t)) return t;
+  if (n.isAsExpression(t) || n.isSatisfiesExpression(t) || n.isParenthesizedExpression(t))
+    return f(t.getExpression());
+}
+function P(t, e) {
+  const r = t.getProperty(e);
+  if (r === void 0 || !n.isPropertyAssignment(r)) return;
+  const i = r.getInitializer();
+  if (i !== void 0 && (n.isStringLiteral(i) || n.isNoSubstitutionTemplateLiteral(i)))
+    return i.getLiteralText();
+}
+function z(t, e) {
+  const r = t.getProperty(e);
+  if (r === void 0 || !n.isPropertyAssignment(r)) return;
+  const i = r.getInitializer();
+  if (i === void 0 || !n.isArrayLiteralExpression(i)) return;
+  const o = [];
+  for (const s of i.getElements())
+    (n.isStringLiteral(s) || n.isNoSubstitutionTemplateLiteral(s)) && o.push(s.getLiteralText());
+  return o;
+}
+function k(t) {
+  const e = t.getProperty("argTypes");
+  if (e === void 0 || !n.isPropertyAssignment(e)) return {};
+  const r = e.getInitializer();
+  if (r === void 0 || !n.isObjectLiteralExpression(r)) return {};
+  const i = {};
+  for (const o of r.getProperties()) {
+    if (!n.isPropertyAssignment(o)) continue;
+    const s = d(o);
+    if (s === void 0) continue;
+    const a = o.getInitializer();
+    if (a === void 0 || !n.isObjectLiteralExpression(a)) continue;
+    const c = C(a);
+    c !== void 0 && (i[s] = c);
+  }
+  return i;
+}
+function d(t) {
+  const e = t.getNameNode();
+  if (n.isIdentifier(e)) return e.getText();
+  if (n.isStringLiteral(e) || n.isNoSubstitutionTemplateLiteral(e))
+    return e.getLiteralText();
+}
+function C(t) {
+  const e = {};
+  for (const r of t.getProperties()) {
+    if (!n.isPropertyAssignment(r)) continue;
+    const i = d(r);
+    if (i === void 0) continue;
+    const o = r.getInitializer();
+    if (o === void 0) continue;
+    const s = l(o);
+    s !== void 0 && (e[i] = s);
+  }
+  return e;
+}
+function V(t, e) {
+  const r = t.getProperty(e);
+  if (r === void 0 || !n.isPropertyAssignment(r)) return;
+  const i = r.getInitializer();
+  if (i === void 0 || !n.isObjectLiteralExpression(i)) return;
+  const o = {};
+  for (const s of i.getProperties()) {
+    if (!n.isPropertyAssignment(s)) continue;
+    const a = d(s);
+    if (a === void 0) continue;
+    const c = s.getInitializer();
+    if (c === void 0) continue;
+    const p = l(c);
+    p !== void 0 && (o[a] = p);
+  }
+  return o;
+}
+function l(t) {
+  if (n.isStringLiteral(t) || n.isNoSubstitutionTemplateLiteral(t))
+    return t.getLiteralText();
+  if (n.isNumericLiteral(t))
+    return Number(t.getText());
+  if (n.isTrueLiteral(t)) return !0;
+  if (n.isFalseLiteral(t)) return !1;
+  if (n.isNullLiteral(t)) return null;
+  if (n.isPrefixUnaryExpression(t)) {
+    const e = t.getOperand();
+    if (n.isNumericLiteral(e)) {
+      const r = t.getOperatorToken(), i = Number(e.getText());
+      return r === 41 ? -i : i;
+    }
+    return;
+  }
+  if (n.isArrayLiteralExpression(t)) {
+    const e = [];
+    for (const r of t.getElements()) {
+      const i = l(r);
+      if (i === void 0) return;
+      e.push(i);
+    }
+    return e;
+  }
+  if (n.isObjectLiteralExpression(t)) {
+    const e = {};
+    for (const r of t.getProperties()) {
+      if (!n.isPropertyAssignment(r)) return;
+      const i = d(r);
+      if (i === void 0) return;
+      const o = r.getInitializer();
+      if (o === void 0) return;
+      const s = l(o);
+      if (s === void 0) return;
+      e[i] = s;
+    }
+    return e;
+  }
+  if (n.isAsExpression(t) || n.isSatisfiesExpression(t) || n.isParenthesizedExpression(t))
+    return l(t.getExpression());
+}
+function w(t) {
+  const e = [];
+  for (const r of t.getVariableStatements())
+    if (r.isExported() && !r.hasDefaultKeyword())
+      for (const i of r.getDeclarations()) {
+        const o = i.getInitializer();
+        if (o === void 0) continue;
+        const s = f(o);
+        if (s === void 0) continue;
+        const a = P(s, "name");
+        a !== void 0 && e.push(a);
+      }
+  return e;
+}
+const x = process.argv[2] ?? "", L = x.length > 0 ? x : void 0, b = L !== void 0 ? y({ tsConfigFilePath: L }) : y();
+function g(t) {
+  typeof process.send == "function" && process.send(t);
+}
+process.on("message", (t) => {
+  if (t.type === "extract") {
+    const { id: e, filePath: r } = t;
+    try {
+      const i = b.extract(r);
+      g({ type: "result", id: e, argTypes: i });
+    } catch (i) {
+      const o = i instanceof Error ? i.message : String(i);
+      g({ type: "error", id: e, message: o });
+    }
+    return;
+  }
+  if (t.type === "extractMeta") {
+    const { id: e, filePath: r } = t;
+    try {
+      const i = b.extractMeta(r);
+      g({ type: "metaResult", id: e, meta: i ?? null });
+    } catch (i) {
+      const o = i instanceof Error ? i.message : String(i);
+      g({ type: "error", id: e, message: o });
+    }
+    return;
+  }
+});
+process.on("disconnect", () => {
+  process.exit(0);
+});

package/dist/meta/extractor-client.d.ts

@@ -0,0 +1,2 @@
+import { PropsExtractor, PropsExtractorOptions } from './extract-props.js';
+export declare function createPropsExtractor(options?: PropsExtractorOptions): PropsExtractor;

package/dist/registry.d.ts

@@ -0,0 +1,86 @@
+import { CategoryTree, CategoryMetaTree, Jogak, RegistryEntry, RegistryEntryMeta } from './types.js';
+/** 미등록 entry 요청 시 throw. */
+export declare class UnknownEntryError extends Error {
+    readonly id: string;
+    constructor(id: string);
+}
+export declare class ComponentRegistry {
+    #private;
+    /**
+     * 즉시 hydrated 상태로 entry를 등록한다.
+     * 정적 빌드(`generateRegistryFile` 결과) / 테스트 / 기존 호출자 호환 경로.
+     *
+     * 내부 구현은 `registerMeta` + `hydrateEntry`의 compatibility shim.
+     * 두 mutation은 batch로 묶여 단일 notify만 발생한다.
+     */
+    register(entry: RegistryEntry): void;
+    unregister(id: string): void;
+    /** hydrated일 때만 RegistryEntry를 반환한다. meta-only/pending이면 undefined. */
+    get(id: string): RegistryEntry | undefined;
+    /** hydrated 항목만 반환. meta-only는 `getAllMeta()` 사용. */
+    getAll(): readonly RegistryEntry[];
+    search(query: string): readonly RegistryEntry[];
+    /**
+     * title의 '/' 구분자로 hydrated entry만의 계층 트리를 구성한다.
+     */
+    getTree(): CategoryTree;
+    clear(): void;
+    /** hydrated 개수. */
+    get size(): number;
+    /**
+     * 인덱스 가상모듈이 호출. 기존 hydrated 항목이 있으면 meta만 갱신(HMR) — entry는 보존.
+     * meta 등록만으로는 `getAll()` 결과에 안 들어간다.
+     */
+    registerMeta(meta: RegistryEntryMeta): void;
+    /**
+     * entry 가상모듈이 호출. pending Promise들을 resolve.
+     * meta가 없는 상태에서 호출되면(=직접 import) 임시 meta를 합성한다 (defensive).
+     */
+    hydrateEntry(id: string, jogaks: readonly Jogak[], component: unknown): void;
+    /**
+     * 어댑터가 호출. hydrated였던 entry를 meta 상태로 되돌린다.
+     * HMR meta-update 이벤트에서 args/component 변경을 강제 re-hydrate 시키기 위함.
+     * unknown / meta / pending 상태에는 영향 없음.
+     */
+    invalidateEntry(id: string): void;
+    /**
+     * UI/어댑터가 호출. entry id로 완전한 RegistryEntry를 비동기 획득.
+     *
+     *  - hydrated → 즉시 resolve된 Promise
+     *  - pending  → 기존 Promise 반환 (멱등)
+     *  - meta     → loader 트리거 후 새 Promise 반환, 상태를 pending으로
+     *  - unknown  → 즉시 reject (UnknownEntryError)
+     */
+    requestEntry(id: string): Promise<RegistryEntry>;
+    /**
+     * 사이드바 메타 전용 — meta-only / pending / hydrated 모두 포함.
+     *
+     * F2: 내부 캐시. mutation 시점에 invalidate되며 재계산 전까지 동일 reference를 반환한다.
+     * useSyncExternalStore의 referential identity 요구를 만족시키기 위함.
+     */
+    getAllMeta(): readonly RegistryEntryMeta[];
+    /**
+     * 사이드바 트리 전용 — 모든 상태의 meta를 트리화.
+     * F2: getAllMeta와 동일한 캐시 정책.
+     */
+    getMetaTree(): CategoryMetaTree;
+    /** 진단 — 상태 머신 노출. */
+    getEntryState(id: string): 'unknown' | 'meta' | 'pending' | 'hydrated';
+    /**
+     * dynamic import 함수를 외부에서 주입. plugin이 인덱스 모듈에서 호출한다.
+     * 빌드/SSR에서 정적 import 매핑으로 교체할 때도 사용.
+     */
+    setEntryLoader(loader: (id: string) => Promise<unknown>): void;
+    /**
+     * 등록/해제/메타 갱신/hydrate/clear 시 호출되는 listener를 등록한다.
+     *
+     * - listener는 무인자, 동기 호출. 어떤 변화가 있었는지는 listener가
+     *   `getAllMeta()`/`getMetaTree()`로 직접 확인.
+     * - mutation 도중 listener에서 `subscribe`/`unsubscribe`를 호출하는 재진입은
+     *   안전 (내부적으로 listener Set을 한 번 복사한 뒤 순회).
+     * - listener 예외는 catch + console.error 후 계속 (다른 listener 보장).
+     * - 반환값은 unsubscribe 함수 (멱등 — 두 번 호출해도 안전).
+     */
+    subscribe(listener: () => void): () => void;
+}
+export declare const defaultRegistry: ComponentRegistry;

package/dist/types.d.ts

@@ -0,0 +1,142 @@
+/**
+ * Props 메타데이터 — TypeScript AST에서 빌드 타임에 추출되거나 수동으로 정의된다.
+ */
+export interface ArgType {
+    readonly type?: string;
+    readonly description?: string;
+    readonly defaultValue?: unknown;
+    readonly control?: 'text' | 'number' | 'boolean' | 'select' | 'radio' | 'color' | 'range';
+    readonly options?: readonly unknown[];
+    readonly required?: boolean;
+    /**
+     * 함수 prop을 자동으로 Action으로 처리한다.
+     * - `true`: 어댑터가 prop 이름으로 spy를 주입
+     * - `string`: 지정한 이름으로 spy를 주입
+     */
+    readonly action?: boolean | string;
+}
+/**
+ * *.jogak.(ts|tsx) 파일의 default export — 컴포넌트 수준 메타데이터
+ */
+export interface JogakMeta {
+    readonly title: string;
+    readonly component?: unknown;
+    readonly argTypes?: Readonly<Record<string, ArgType>>;
+    readonly tags?: readonly string[];
+    readonly parameters?: Readonly<Record<string, unknown>>;
+}
+/**
+ * *.jogak.(ts|tsx) 파일의 named export — 컴포넌트의 개별 사용 예시
+ */
+export interface Jogak {
+    readonly name: string;
+    readonly args?: Readonly<Record<string, unknown>>;
+    readonly argTypes?: Readonly<Record<string, ArgType>>;
+    readonly parameters?: Readonly<Record<string, unknown>>;
+}
+/**
+ * 컴포넌트 레지스트리에 등록된 엔트리
+ */
+export interface RegistryEntry {
+    readonly id: string;
+    readonly title: string;
+    readonly jogaks: readonly Jogak[];
+    readonly meta: JogakMeta;
+    readonly filePath?: string;
+    readonly source?: string;
+}
+/**
+ * 인덱스 가상모듈에 들어가는 "껍데기" 메타.
+ *
+ * - user 컴포넌트(`meta.component`)와 jogak 객체(`render`/`args`/...)를 포함하지 않는다.
+ * - 사이드바 렌더링·검색·트리 구성에 필요한 최소 정보만 담는다.
+ * - hydrate 시점에 이 meta로부터 완전한 RegistryEntry를 합성한다.
+ */
+export interface RegistryEntryMeta {
+    readonly id: string;
+    readonly title: string;
+    /** 이 entry의 jogak 객체 이름 목록 — 사이드바에서 sub-item 표시용. */
+    readonly jogakNames: readonly string[];
+    /** ts-morph로 추출한 자동 argTypes (소스 변경 없으면 정적). */
+    readonly autoArgTypes: Readonly<Record<string, ArgType>>;
+    /** *.jogak 파일에서 사용자가 직접 작성한 argTypes (meta.argTypes). */
+    readonly userArgTypes: Readonly<Record<string, ArgType>>;
+    /** *.jogak 파일의 원본 텍스트 — Source 패널이 즉시 표시 가능해야 하므로 인덱스에 포함. */
+    readonly source: string;
+    /** 절대경로 — HMR/디버깅용. */
+    readonly filePath: string;
+    /**
+     * 사용자 meta의 직렬화 가능한 잔여 필드만 보관 (tags, parameters).
+     * `component`는 함수라 직렬화 불가 → 제외. `argTypes`는 위에서 분리.
+     */
+    readonly metaExtras: {
+        readonly tags?: readonly string[];
+        readonly parameters?: Readonly<Record<string, unknown>>;
+    };
+}
+/**
+ * 사이드바 렌더링용 카테고리 트리.
+ * title의 '/' 구분자로 계층 구성 (예: "Form/Button" → { Form: { Button: RegistryEntry } })
+ *
+ * interface로 선언해야 한다 — type alias는 자기 참조 순환 타입을 지원하지 않는다.
+ */
+export interface CategoryTree {
+    [key: string]: RegistryEntry | CategoryTree;
+}
+/**
+ * Sidebar용 메타 트리 — `RegistryEntry` 자리에 `RegistryEntryMeta`.
+ * lazy 모드에서 hydrate 전에도 사이드바를 그릴 수 있도록 별도 트리 구조.
+ */
+export interface CategoryMetaTree {
+    [key: string]: RegistryEntryMeta | CategoryMetaTree;
+}
+/**
+ * 각 어댑터(React, Next.js, Web Components)가 구현해야 하는 공통 인터페이스
+ */
+export interface JogakAdapter {
+    readonly framework: 'react' | 'next' | 'web-components';
+    render(entry: RegistryEntry, args: Readonly<Record<string, unknown>>, container: HTMLElement): void | Promise<void>;
+    unmount(container: HTMLElement): void;
+}
+/**
+ * Vite 플러그인 설정
+ */
+export interface JogakPluginOptions {
+    readonly patterns?: readonly string[];
+    readonly framework?: 'react' | 'next' | 'web-components';
+    /**
+     * prism-react-renderer 테마 이름.
+     * 사용 가능한 값: dracula | duotoneDark | duotoneLight | github | jettwaveDark |
+     * jettwaveLight | nightOwl | nightOwlLight | oceanicNext | okaidia | oneDark |
+     * oneLight | palenight | shadesOfPurple | solarizedlight | synthwave84 |
+     * ultramin | vsDark (기본값) | vsLight
+     */
+    readonly codeTheme?: string;
+    /**
+     * glob의 cwd. 미지정 시 Vite `config.root`를 사용한다.
+     *
+     * `runHost` 같은 외부 호스트가 Vite root를 다른 패키지 디렉토리로 잡고
+     * 사용자 프로젝트의 jogak 파일을 가상 모듈로 주입하고 싶을 때 사용.
+     * 미지정 시 기존 동작과 동일하다 (back-compat).
+     */
+    readonly cwd?: string;
+    /**
+     * ts-morph용 tsconfig 절대 경로.
+     * 미지정 시 `<resolvedCwd>/tsconfig.json`을 자동 감지하며,
+     * 파일이 없으면 tsconfig 없이 PropsExtractor를 생성한다.
+     */
+    readonly tsConfigFilePath?: string;
+    /**
+     * F1: dev 부팅 시 jogak 의존 패키지(`@jogak/core`, `@jogak/react`, ...)의
+     * dist 변경을 감지해 Vite optimizeDeps cache(`node_modules/.vite/deps`)를
+     * 자동 삭제한다. 기본값 false (검증 활성화).
+     *
+     * workspace로 링크된 어댑터를 자주 빌드하는 환경에서는 그대로 두면
+     * `SyntaxError: ... does not provide an export named ...` 류의
+     * stale prebundle 에러를 자동으로 회피한다.
+     *
+     * true로 설정하면 검증을 끈다 — 사용자가 직접 `rm -rf node_modules/.vite/deps`
+     * 또는 `--force`를 관리해야 한다.
+     */
+    readonly disableCacheValidation?: boolean;
+}

package/dist/vite/cache-validate.d.ts

@@ -0,0 +1,17 @@
+export interface CacheValidateOptions {
+    readonly root: string;
+    readonly logger: {
+        info(msg: string): void;
+        warn(msg: string): void;
+    };
+    /**
+     * 검사 대상 패키지 (override). 기본: jogak workspace 패키지 4종.
+     * 테스트에서 대체 경로를 주입하기 위해 노출.
+     */
+    readonly packages?: readonly string[];
+}
+export interface CacheValidateResult {
+    readonly purged: boolean;
+    readonly reason?: string;
+}
+export declare function validateAndPurgeViteCache(opts: CacheValidateOptions): Promise<CacheValidateResult>;

package/dist/vite/index.js

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