@jogak/core 0.1.0-alpha.0

package/CHANGELOG.md

@@ -0,0 +1,86 @@
+# Changelog
+
+All notable changes to Jogak packages are documented here. The repository follows
+[Keep a Changelog](https://keepachangelog.com/en/1.1.0/) and [Semantic Versioning](https://semver.org/).
+
+Version numbers apply to all packages in the workspace (synchronized release).
+
+## [0.1.0-alpha.0] — 2026-05-07
+
+First public preview release. API is not yet stable.
+
+### Added
+
+- **Lazy virtual modules** (`@jogak/core`)
+  - `virtual:jogak` index module exposes only entry metadata; no user component imports.
+  - `virtual:jogak/entry/<slug>` per-entry virtual module dynamically imported on demand.
+  - `defaultRegistry` hydration state machine: `unknown → meta → pending → hydrated`.
+  - New API: `registerMeta`, `hydrateEntry`, `requestEntry`, `invalidateEntry`,
+    `getAllMeta`, `getMetaTree`, `getEntryState`, `setEntryLoader`, `subscribe`.
+  - `RegistryEntryMeta` type for sidebar metadata without component identity.
+
+- **In-place HMR** (`@jogak/core` + `@jogak/react`)
+  - `*.jogak.tsx` edits trigger entry virtual module self-accept → automatic
+    rehydration. Sidebar metadata patched via `jogak:meta-update` ws custom event.
+  - `useEntry(id)` subscribes to registry mutations and re-renders on hydrate.
+  - meta-only vs structural change classification by `(title, jogakNamesKey)` signature.
+
+- **child_process-isolated ts-morph extractor** (`@jogak/core`)
+  - Props extraction runs in a separate child process via IPC.
+  - Idle 5 s SIGTERM → OS reclaims memory immediately; no V8 isolate growth.
+  - Lazy spawn on first `extract()` call; pending requests rejected on child exit.
+
+- **Vite cache auto-invalidation** (`@jogak/core/vite`)
+  - On dev boot, plugin compares jogak dist mtime vs `.vite/deps/_metadata.json`.
+  - Stale cache is purged automatically with an info log.
+  - Opt-out: `JogakPluginOptions.disableCacheValidation`.
+
+- **`@jogak/react` hooks**
+  - `useEntry(id): UseEntryState` — `loading | ready | error | unknown` discriminated union.
+  - `useRegistryMeta(): UseRegistryMetaReturn` — backed by `useSyncExternalStore`,
+    referential identity guaranteed.
+  - `useRegistry()`, `JogakProvider`, `reactAdapter` (preserved signatures).
+
+- **`@jogak/ui` library mode**
+  - `JogakApp`, `Sidebar`, `Preview`, `Controls`, `Actions` published as
+    pre-built ESM/CJS — no `transpilePackages` needed for Next.js.
+  - `JogakAppProps`: `entries` (eager) | `metas` (lazy) | both unset (defaultRegistry).
+
+- **CLI** (`@jogak/cli`)
+  - `jogak dev` / `jogak build` / `jogak generate` commands.
+  - Auto-detects `<cwd>/tsconfig.json` for ts-morph; falls back to manual
+    `meta.argTypes` if absent.
+
+- **Storybook benchmark suite** (`benchmarks/`)
+  - `bench:scale:full` — cold-start / build / bundle vs Storybook 8 (Vite builder).
+  - `bench:rss` — idle dev tree RSS vs Storybook.
+  - `bench:hmr` — Playwright-driven HMR latency.
+
+### Numbers vs. Storybook 8 (Vite builder)
+
+| Metric | size 100 | size 500 |
+|---|---|---|
+| dev cold start | **1.7 s** vs 3.3 s | **2.9 s** vs 3.6 s |
+| build time | **2.0 s** vs 2.9 s | **4.1 s** vs 7.6 s |
+| bundle (gzip) | **108 KB** vs 716 KB | **156 KB** vs 1.09 MB |
+| idle RSS (dev) | **321 MB** vs 403 MB | **345 MB** vs 489 MB |
+| HMR (warm median) | **153 ms** | **199 ms** |
+
+### Known Limitations
+
+- HMR `jogak:meta-update` event only patches `defaultRegistry`. Custom registry
+  injections via `<JogakProvider registry={custom}>` fall back to full reload.
+- Boot-time RSS spike (~700 MB) before settling at idle RSS — esbuild prebundle
+  + ts-morph child spawn. Settles within 5 s.
+- `@jogak/core` install pulls ts-morph (~17 MB); only `core/build` and the Vite
+  plugin actually use it. Splitting into `@jogak/extractor` is planned for 0.2.0.
+
+### Compatibility
+
+- Node ≥ 20.18 (`fetch` / `AbortSignal.timeout` stable)
+- React ≥ 18 (peer)
+- Vite ≥ 6 (peer, optional in `@jogak/core`)
+- Next.js ≥ 14 (peer in `@jogak/next`)
+- TypeScript ≥ 5.5 (build-time props extraction)
+
+[0.1.0-alpha.0]: https://github.com/devclib/jogak/releases/tag/v0.1.0-alpha.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 devclib
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OF OR DEALING IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,48 @@
+# @jogak/core
+
+Core types, registry, and Vite plugin for [Jogak](https://github.com/devclib/jogak) — a lightweight Storybook alternative.
+
+## Install
+
+```bash
+pnpm add @jogak/core
+# or: npm i @jogak/core / yarn add @jogak/core
+```
+
+## Usage
+
+### Vite plugin (dev/build)
+
+```ts
+// vite.config.ts
+import { jogak } from '@jogak/core/vite'
+
+export default defineConfig({
+  plugins: [react(), jogak()],
+})
+```
+
+### Build-time codegen (host bundler embedding)
+
+```ts
+import { generateRegistryFile } from '@jogak/core/build'
+
+await generateRegistryFile({
+  patterns: ['src/**/*.jogak.tsx'],
+  cwd: process.cwd(),
+  outFile: '.jogak/registry.ts',
+})
+```
+
+### Registry / types
+
+```ts
+import { defaultRegistry } from '@jogak/core'
+import type { JogakMeta, Jogak, RegistryEntry, ArgType } from '@jogak/core'
+```
+
+See the [main README](https://github.com/devclib/jogak#readme) for architecture, CLI, host embedding, and Storybook benchmarks.
+
+- Repository: https://github.com/devclib/jogak
+- Issues: https://github.com/devclib/jogak/issues
+- License: [MIT](./LICENSE)

package/dist/actions.d.ts

@@ -0,0 +1,22 @@
+import { ArgType } from './types.js';
+export interface ActionLog {
+    readonly id: number;
+    readonly name: string;
+    readonly args: readonly unknown[];
+    readonly timestamp: number;
+}
+export type ActionListener = (logs: readonly ActionLog[]) => void;
+export declare class ActionChannel {
+    #private;
+    emit(name: string, args: readonly unknown[]): void;
+    subscribe(listener: ActionListener): () => void;
+    clear(): void;
+    getLogs(): readonly ActionLog[];
+}
+export declare const defaultActionChannel: ActionChannel;
+export declare function action(name: string, channel?: ActionChannel): (...args: unknown[]) => void;
+/**
+ * argTypes를 보고 함수/action prop 자리에 args에 정의된 값이 없으면 자동으로 spy를 주입한다.
+ * 어댑터(react, web-components 등)가 render 직전에 호출한다.
+ */
+export declare function injectActions(args: Readonly<Record<string, unknown>>, argTypes: Readonly<Record<string, ArgType>>, channel?: ActionChannel): Record<string, unknown>;

package/dist/build/generate.d.ts

@@ -0,0 +1,22 @@
+export interface GenerateOptions {
+    readonly patterns: readonly string[];
+    readonly cwd: string;
+    /** outFile은 cwd에 대한 상대 경로 또는 절대 경로 */
+    readonly outFile: string;
+    readonly tsConfigFilePath?: string;
+}
+export interface GenerateResult {
+    readonly fileCount: number;
+    readonly outFile: string;
+}
+/**
+ * `*.jogak.tsx` 파일들을 스캔해 `entries`를 export하는 일반 TS 파일을 생성한다.
+ *
+ * Vite의 가상 모듈(`virtual:jogak`)과 동일한 형태의 데이터를 일반 import 가능한
+ * TS 파일로 출력하여 Next.js·Webpack·Turbopack·Rspack 등 어떤 호스트 번들러에서도
+ * 별도 플러그인 없이 마운트할 수 있게 한다.
+ *
+ * - props 자동 추출(ts-morph)은 빌드 타임에 1회 수행
+ * - source는 문자열로 inline (Vite의 `?raw` 같은 번들러별 문법 회피)
+ */
+export declare function generateRegistryFile(options: GenerateOptions): Promise<GenerateResult>;

package/dist/build/index.d.ts

@@ -0,0 +1,2 @@
+export { createPropsExtractor, type PropsExtractor, type PropsExtractorOptions } from '../meta/extract-props.js';
+export { generateRegistryFile, type GenerateOptions, type GenerateResult } from './generate.js';

package/dist/build/index.js

@@ -0,0 +1,72 @@
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const j=require("glob"),g=require("node:fs/promises"),n=require("node:path"),y=require("../extractor-client-CiWszHel.cjs");async function E(r){const c=n.resolve(r.cwd),a=n.resolve(c,r.outFile),u=n.dirname(a),s=(await j.glob(r.patterns,{cwd:c,absolute:!0})).sort(),l=r.tsConfigFilePath!==void 0?y.createPropsExtractor({tsConfigFilePath:r.tsConfigFilePath}):y.createPropsExtractor(),p=[],o=[];try{for(const e of s){p.push(await g.readFile(e,"utf8"));try{o.push(await l.extract(e))}catch{o.push({})}}}finally{l.releaseCache()}const d=s.map((e,t)=>{const i=n.relative(u,e).replace(/\\/g,"/").replace(/\.(tsx?|jsx?)$/u,""),m=i.startsWith(".")?i:`./${i}`;return`import _meta${t.toString()} from ${JSON.stringify(m)}
+import * as _named${t.toString()} from ${JSON.stringify(m)}`}).join(`
+`),f=p.map(e=>JSON.stringify(e)).join(`,
+  `),A=o.map(e=>JSON.stringify(e)).join(`,
+  `),T=s.map((e,t)=>`_buildEntry(_meta${t.toString()}, _named${t.toString()}, _sources[${t.toString()}], _autoArgTypes[${t.toString()}])`).join(`,
+  `),R=`// AUTO-GENERATED by @jogak/core/build — do not edit.
+/* eslint-disable */
+import type { RegistryEntry, RegistryEntryMeta, ArgType } from '@jogak/core'
+${d}
+
+const _sources: readonly string[] = [
+  ${f}
+]
+
+const _autoArgTypes: ReadonlyArray<Record<string, ArgType>> = [
+  ${A}
+]
+
+function _buildEntry(
+  meta: any,
+  named: Record<string, unknown>,
+  source: string,
+  autoArgTypes: Record<string, ArgType>,
+): RegistryEntry | null {
+  if (meta == null || typeof meta.title !== 'string') return null
+  const jogaks = Object.values(named).filter(
+    (v): v is { name: string } =>
+      v !== null && typeof v === 'object' && typeof (v as { name?: unknown }).name === 'string',
+  )
+  const userArgTypes: Record<string, ArgType> = meta.argTypes ?? {}
+  const mergedArgTypes: Record<string, ArgType> = { ...autoArgTypes }
+  for (const key of Object.keys(userArgTypes)) {
+    mergedArgTypes[key] = { ...mergedArgTypes[key], ...userArgTypes[key] }
+  }
+  return {
+    id: meta.title,
+    title: meta.title,
+    jogaks: jogaks as RegistryEntry['jogaks'],
+    meta: { ...meta, argTypes: mergedArgTypes },
+    source,
+  }
+}
+
+function _buildMeta(entry: RegistryEntry, autoArgTypes: Record<string, ArgType>): RegistryEntryMeta {
+  const userArgTypes = (entry.meta.argTypes ?? {}) as Record<string, ArgType>
+  return {
+    id: entry.id,
+    title: entry.title,
+    jogakNames: entry.jogaks.map((j) => j.name),
+    autoArgTypes,
+    userArgTypes,
+    source: entry.source ?? '',
+    filePath: entry.filePath ?? '',
+    metaExtras: {
+      ...(entry.meta.tags !== undefined ? { tags: entry.meta.tags } : {}),
+      ...(entry.meta.parameters !== undefined ? { parameters: entry.meta.parameters } : {}),
+    },
+  }
+}
+
+export const entries: readonly RegistryEntry[] = [
+  ${T}
+].filter((e): e is RegistryEntry => e !== null)
+
+/**
+ * 사이드바 메타 — \`<JogakApp metas={metas} />\` 패턴용.
+ * eager 모드에서는 entries로부터 합성 — ts-morph 추가 호출 없음.
+ */
+export const metas: readonly RegistryEntryMeta[] = entries.map((e, i) =>
+  _buildMeta(e, _autoArgTypes[i] ?? {}),
+)
+`;return await g.mkdir(u,{recursive:!0}),await g.writeFile(a,R,"utf8"),{fileCount:s.length,outFile:a}}exports.createPropsExtractor=y.createPropsExtractor;exports.generateRegistryFile=E;

package/dist/build/index.mjs

@@ -0,0 +1,101 @@
+import { glob as R } from "glob";
+import { readFile as j, mkdir as k, writeFile as E } from "node:fs/promises";
+import { resolve as m, dirname as b, relative as h } from "node:path";
+import { c as p } from "../extractor-client-CReBed7x.js";
+async function S(r) {
+  const i = m(r.cwd), n = m(i, r.outFile), y = b(n), s = (await R(r.patterns, { cwd: i, absolute: !0 })).sort(), g = r.tsConfigFilePath !== void 0 ? p({ tsConfigFilePath: r.tsConfigFilePath }) : p(), c = [], a = [];
+  try {
+    for (const e of s) {
+      c.push(await j(e, "utf8"));
+      try {
+        a.push(await g.extract(e));
+      } catch {
+        a.push({});
+      }
+    }
+  } finally {
+    g.releaseCache();
+  }
+  const l = s.map((e, t) => {
+    const o = h(y, e).replace(/\\/g, "/").replace(/\.(tsx?|jsx?)$/u, ""), u = o.startsWith(".") ? o : `./${o}`;
+    return `import _meta${t.toString()} from ${JSON.stringify(u)}
+import * as _named${t.toString()} from ${JSON.stringify(u)}`;
+  }).join(`
+`), d = c.map((e) => JSON.stringify(e)).join(`,
+  `), f = a.map((e) => JSON.stringify(e)).join(`,
+  `), A = s.map(
+    (e, t) => `_buildEntry(_meta${t.toString()}, _named${t.toString()}, _sources[${t.toString()}], _autoArgTypes[${t.toString()}])`
+  ).join(`,
+  `), T = `// AUTO-GENERATED by @jogak/core/build — do not edit.
+/* eslint-disable */
+import type { RegistryEntry, RegistryEntryMeta, ArgType } from '@jogak/core'
+${l}
+
+const _sources: readonly string[] = [
+  ${d}
+]
+
+const _autoArgTypes: ReadonlyArray<Record<string, ArgType>> = [
+  ${f}
+]
+
+function _buildEntry(
+  meta: any,
+  named: Record<string, unknown>,
+  source: string,
+  autoArgTypes: Record<string, ArgType>,
+): RegistryEntry | null {
+  if (meta == null || typeof meta.title !== 'string') return null
+  const jogaks = Object.values(named).filter(
+    (v): v is { name: string } =>
+      v !== null && typeof v === 'object' && typeof (v as { name?: unknown }).name === 'string',
+  )
+  const userArgTypes: Record<string, ArgType> = meta.argTypes ?? {}
+  const mergedArgTypes: Record<string, ArgType> = { ...autoArgTypes }
+  for (const key of Object.keys(userArgTypes)) {
+    mergedArgTypes[key] = { ...mergedArgTypes[key], ...userArgTypes[key] }
+  }
+  return {
+    id: meta.title,
+    title: meta.title,
+    jogaks: jogaks as RegistryEntry['jogaks'],
+    meta: { ...meta, argTypes: mergedArgTypes },
+    source,
+  }
+}
+
+function _buildMeta(entry: RegistryEntry, autoArgTypes: Record<string, ArgType>): RegistryEntryMeta {
+  const userArgTypes = (entry.meta.argTypes ?? {}) as Record<string, ArgType>
+  return {
+    id: entry.id,
+    title: entry.title,
+    jogakNames: entry.jogaks.map((j) => j.name),
+    autoArgTypes,
+    userArgTypes,
+    source: entry.source ?? '',
+    filePath: entry.filePath ?? '',
+    metaExtras: {
+      ...(entry.meta.tags !== undefined ? { tags: entry.meta.tags } : {}),
+      ...(entry.meta.parameters !== undefined ? { parameters: entry.meta.parameters } : {}),
+    },
+  }
+}
+
+export const entries: readonly RegistryEntry[] = [
+  ${A}
+].filter((e): e is RegistryEntry => e !== null)
+
+/**
+ * 사이드바 메타 — \`<JogakApp metas={metas} />\` 패턴용.
+ * eager 모드에서는 entries로부터 합성 — ts-morph 추가 호출 없음.
+ */
+export const metas: readonly RegistryEntryMeta[] = entries.map((e, i) =>
+  _buildMeta(e, _autoArgTypes[i] ?? {}),
+)
+`;
+  return await k(y, { recursive: !0 }), await E(n, T, "utf8"), { fileCount: s.length, outFile: n };
+}
+export {
+  p as createPropsExtractor,
+  S as generateRegistryFile
+};

package/dist/extractor-client-CReBed7x.js

@@ -0,0 +1,134 @@
+import { fork as k } from "node:child_process";
+import { existsSync as T } from "node:fs";
+import { fileURLToPath as v } from "node:url";
+import { dirname as $, resolve as a } from "node:path";
+const C = 5e3, h = 3e4;
+function S() {
+  const p = v(import.meta.url), e = $(p), s = [
+    a(e, "meta/extractor-child.mjs"),
+    a(e, "../meta/extractor-child.mjs"),
+    a(e, "../../meta/extractor-child.mjs"),
+    a(e, "extractor-child.mjs"),
+    // dev (tsc emit) fallback — 거의 안 쓰지만 안전망
+    a(e, "meta/extractor-child.js"),
+    a(e, "../meta/extractor-child.js")
+  ];
+  for (const f of s)
+    if (T(f)) return f;
+  throw new Error(
+    `[jogak] extractor-child entry를 찾을 수 없습니다. 시도한 경로:
+  ${s.join(`
+  `)}`
+  );
+}
+function R(p = {}) {
+  let e, s, f = 0;
+  const n = /* @__PURE__ */ new Map();
+  let g;
+  function j() {
+    return g === void 0 && (g = S()), g;
+  }
+  function m() {
+    s !== void 0 && (clearTimeout(s), s = void 0);
+  }
+  function u(i) {
+    for (const [, d] of n)
+      clearTimeout(d.timer), d.reject(i);
+    n.clear();
+  }
+  function x() {
+    if (m(), e === void 0) return;
+    const i = e;
+    e = void 0, u(new Error("[jogak] extractor child process disposed"));
+    try {
+      i.disconnect();
+    } catch {
+    }
+    i.killed || i.kill("SIGTERM");
+  }
+  function y() {
+    m(), s = setTimeout(() => {
+      x();
+    }, C), typeof s.unref == "function" && s.unref();
+  }
+  function E() {
+    if (e !== void 0 && e.connected) return e;
+    e !== void 0 && (u(new Error("[jogak] extractor child process exited")), e = void 0);
+    const i = j(), d = p.tsConfigFilePath ?? "", o = k(i, [d], {
+      // detached:false → 부모 종료 시 자식도 종료
+      // serialization:'json' (기본) — ArgType은 plain JSON 호환
+      stdio: ["ignore", "inherit", "inherit", "ipc"]
+    });
+    return o.on("message", (r) => {
+      if (r.type !== "result" && r.type !== "metaResult" && r.type !== "error") return;
+      const t = n.get(r.id);
+      t !== void 0 && (n.delete(r.id), clearTimeout(t.timer), r.type === "result" ? t.kind === "argTypes" ? t.resolve(r.argTypes) : t.reject(new Error("[jogak] extractor child mismatched response: expected metaResult")) : r.type === "metaResult" ? t.kind === "meta" ? t.resolve(r.meta) : t.reject(new Error("[jogak] extractor child mismatched response: expected result")) : t.reject(new Error(`[jogak] extractor child error: ${r.message}`)));
+    }), o.on("exit", (r, t) => {
+      if (e === o) {
+        e = void 0;
+        const c = t !== null ? `signal=${t}` : `code=${(r ?? "null").toString()}`;
+        u(new Error(`[jogak] extractor child exited (${c})`));
+      }
+    }), o.on("error", (r) => {
+      e === o && (e = void 0, u(new Error(`[jogak] extractor child fork error: ${r.message}`)));
+    }), e = o, o;
+  }
+  return {
+    extract(i) {
+      m();
+      const d = E(), o = ++f;
+      return new Promise((r, t) => {
+        const c = setTimeout(() => {
+          n.delete(o) && t(
+            new Error(
+              `[jogak] extractor child timeout (${h}ms): ${i}`
+            )
+          );
+        }, h);
+        typeof c.unref == "function" && c.unref(), n.set(o, { kind: "argTypes", resolve: r, reject: t, timer: c });
+        try {
+          d.send({ type: "extract", id: o, filePath: i });
+        } catch (l) {
+          n.delete(o), clearTimeout(c), t(
+            new Error(
+              `[jogak] extractor child IPC send 실패: ${l instanceof Error ? l.message : String(l)}`
+            )
+          );
+        }
+      }).finally(() => {
+        n.size === 0 && y();
+      });
+    },
+    extractMeta(i) {
+      m();
+      const d = E(), o = ++f;
+      return new Promise((r, t) => {
+        const c = setTimeout(() => {
+          n.delete(o) && t(
+            new Error(
+              `[jogak] extractor child timeout (${h}ms): ${i}`
+            )
+          );
+        }, h);
+        typeof c.unref == "function" && c.unref(), n.set(o, { kind: "meta", resolve: r, reject: t, timer: c });
+        try {
+          d.send({ type: "extractMeta", id: o, filePath: i });
+        } catch (l) {
+          n.delete(o), clearTimeout(c), t(
+            new Error(
+              `[jogak] extractor child IPC send 실패: ${l instanceof Error ? l.message : String(l)}`
+            )
+          );
+        }
+      }).finally(() => {
+        n.size === 0 && y();
+      });
+    },
+    releaseCache() {
+      x();
+    }
+  };
+}
+export {
+  R as c
+};

package/dist/extractor-client-CiWszHel.cjs

@@ -0,0 +1,3 @@
+"use strict";const k=require("node:child_process"),T=require("node:fs"),C=require("node:url"),a=require("node:path");var x=typeof document<"u"?document.currentScript:null;const S=5e3,h=3e4;function _(){const p=C.fileURLToPath(typeof document>"u"?require("url").pathToFileURL(__filename).href:x&&x.tagName.toUpperCase()==="SCRIPT"&&x.src||new URL("extractor-client-CiWszHel.cjs",document.baseURI).href),e=a.dirname(p),s=[a.resolve(e,"meta/extractor-child.mjs"),a.resolve(e,"../meta/extractor-child.mjs"),a.resolve(e,"../../meta/extractor-child.mjs"),a.resolve(e,"extractor-child.mjs"),a.resolve(e,"meta/extractor-child.js"),a.resolve(e,"../meta/extractor-child.js")];for(const u of s)if(T.existsSync(u))return u;throw new Error(`[jogak] extractor-child entry를 찾을 수 없습니다. 시도한 경로:
+  ${s.join(`
+  `)}`)}function $(p={}){let e,s,u=0;const n=new Map;let g;function v(){return g===void 0&&(g=_()),g}function f(){s!==void 0&&(clearTimeout(s),s=void 0)}function m(i){for(const[,d]of n)clearTimeout(d.timer),d.reject(i);n.clear()}function y(){if(f(),e===void 0)return;const i=e;e=void 0,m(new Error("[jogak] extractor child process disposed"));try{i.disconnect()}catch{}i.killed||i.kill("SIGTERM")}function E(){f(),s=setTimeout(()=>{y()},S),typeof s.unref=="function"&&s.unref()}function j(){if(e!==void 0&&e.connected)return e;e!==void 0&&(m(new Error("[jogak] extractor child process exited")),e=void 0);const i=v(),d=p.tsConfigFilePath??"",o=k.fork(i,[d],{stdio:["ignore","inherit","inherit","ipc"]});return o.on("message",r=>{if(r.type!=="result"&&r.type!=="metaResult"&&r.type!=="error")return;const t=n.get(r.id);t!==void 0&&(n.delete(r.id),clearTimeout(t.timer),r.type==="result"?t.kind==="argTypes"?t.resolve(r.argTypes):t.reject(new Error("[jogak] extractor child mismatched response: expected metaResult")):r.type==="metaResult"?t.kind==="meta"?t.resolve(r.meta):t.reject(new Error("[jogak] extractor child mismatched response: expected result")):t.reject(new Error(`[jogak] extractor child error: ${r.message}`)))}),o.on("exit",(r,t)=>{if(e===o){e=void 0;const c=t!==null?`signal=${t}`:`code=${(r??"null").toString()}`;m(new Error(`[jogak] extractor child exited (${c})`))}}),o.on("error",r=>{e===o&&(e=void 0,m(new Error(`[jogak] extractor child fork error: ${r.message}`)))}),e=o,o}return{extract(i){f();const d=j(),o=++u;return new Promise((r,t)=>{const c=setTimeout(()=>{n.delete(o)&&t(new Error(`[jogak] extractor child timeout (${h}ms): ${i}`))},h);typeof c.unref=="function"&&c.unref(),n.set(o,{kind:"argTypes",resolve:r,reject:t,timer:c});try{d.send({type:"extract",id:o,filePath:i})}catch(l){n.delete(o),clearTimeout(c),t(new Error(`[jogak] extractor child IPC send 실패: ${l instanceof Error?l.message:String(l)}`))}}).finally(()=>{n.size===0&&E()})},extractMeta(i){f();const d=j(),o=++u;return new Promise((r,t)=>{const c=setTimeout(()=>{n.delete(o)&&t(new Error(`[jogak] extractor child timeout (${h}ms): ${i}`))},h);typeof c.unref=="function"&&c.unref(),n.set(o,{kind:"meta",resolve:r,reject:t,timer:c});try{d.send({type:"extractMeta",id:o,filePath:i})}catch(l){n.delete(o),clearTimeout(c),t(new Error(`[jogak] extractor child IPC send 실패: ${l instanceof Error?l.message:String(l)}`))}}).finally(()=>{n.size===0&&E()})},releaseCache(){y()}}}exports.createPropsExtractor=$;

package/dist/index.d.ts

@@ -0,0 +1,3 @@
+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';

package/dist/index.js

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