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

package/dist/registry-CnBX6XxF.js

@@ -0,0 +1,397 @@
+var L = Object.defineProperty;
+var C = (i) => {
+  throw TypeError(i);
+};
+var N = (i, t, e) => t in i ? L(i, t, { enumerable: !0, configurable: !0, writable: !0, value: e }) : i[t] = e;
+var z = (i, t, e) => N(i, typeof t != "symbol" ? t + "" : t, e), M = (i, t, e) => t.has(i) || C("Cannot " + e);
+var s = (i, t, e) => (M(i, t, "read from private field"), e ? e.call(i) : t.get(i)), f = (i, t, e) => t.has(i) ? C("Cannot add the same private member more than once") : t instanceof WeakSet ? t.add(i) : t.set(i, e), l = (i, t, e, r) => (M(i, t, "write to private field"), r ? r.call(i, e) : t.set(i, e), e), u = (i, t, e) => (M(i, t, "access private method"), e);
+class S extends Error {
+  constructor(e) {
+    super(`[jogak] Unknown entry id: ${e}`);
+    z(this, "id");
+    this.name = "UnknownEntryError", this.id = e;
+  }
+}
+var o, P, T, v, y, k, E, w, j, A, h, g, x, U;
+class $ {
+  constructor() {
+    f(this, h);
+    f(this, o, /* @__PURE__ */ new Map());
+    f(this, P);
+    // ── F2: subscribe + 내부 캐시 ────────────────────────────────────────
+    f(this, T, /* @__PURE__ */ new Set());
+    f(this, v);
+    f(this, y);
+    // 결정성 fix: hydrated entry list / tree 도 캐시. mutation 시 invalidate.
+    f(this, k);
+    f(this, E);
+    /**
+     * 정렬된 id 순서. mutation 시 invalidate, 다음 호출에서 한 번만 재계산.
+     * getAll / getTree / getAllMeta / getMetaTree 모두 이 순서를 따른다.
+     * 결과: 모든 외부 노출 collection 이 동일 ordering 을 가진다.
+     */
+    f(this, w);
+    /** register()가 registerMeta + hydrateEntry를 합쳐 호출할 때 중간 notify를 억제한다. */
+    f(this, j, !1);
+    /** batch 도중에 mutation이 한 번이라도 일어났는지 — false면 batch 종료 시 notify 안 한다. */
+    f(this, A, !1);
+  }
+  // ── 기존 외부 API: 시그니처 변경 없음. 시맨틱은 hydrated만 표면. ───────────
+  /**
+   * 즉시 hydrated 상태로 entry를 등록한다.
+   * 정적 빌드(`generateRegistryFile` 결과) / 테스트 / 기존 호출자 호환 경로.
+   *
+   * 내부 구현은 `registerMeta` + `hydrateEntry`의 compatibility shim.
+   * 두 mutation은 batch로 묶여 단일 notify만 발생한다.
+   */
+  register(t) {
+    const e = q(t);
+    u(this, h, U).call(this, () => {
+      this.registerMeta(e), this.hydrateEntry(t.id, t.jogaks, t.meta.component);
+    });
+  }
+  unregister(t) {
+    const e = s(this, o).get(t);
+    e !== void 0 && (e.kind === "pending" && e.reject(new S(t)), s(this, o).delete(t), u(this, h, g).call(this));
+  }
+  /** hydrated일 때만 RegistryEntry를 반환한다. meta-only/pending이면 undefined. */
+  get(t) {
+    const e = s(this, o).get(t);
+    return (e == null ? void 0 : e.kind) === "hydrated" ? e.entry : void 0;
+  }
+  /** hydrated 항목만 반환. meta-only는 `getAllMeta()` 사용. */
+  getAll() {
+    if (s(this, k) !== void 0) return s(this, k);
+    const t = [];
+    for (const r of u(this, h, x).call(this)) {
+      const n = s(this, o).get(r);
+      (n == null ? void 0 : n.kind) === "hydrated" && t.push(n.entry);
+    }
+    const e = t;
+    return l(this, k, e), e;
+  }
+  search(t) {
+    const e = t.toLowerCase();
+    return this.getAll().filter((r) => r.title.toLowerCase().includes(e));
+  }
+  /**
+   * title의 '/' 구분자로 hydrated entry만의 계층 트리를 구성한다.
+   *
+   * `getAll()`이 정렬된 순서를 반환하므로 트리 객체의 키 iteration order
+   * (ECMA-262 §OrdinaryOwnPropertyKeys: insertion order for string keys)도 결정적이다.
+   */
+  getTree() {
+    if (s(this, E) !== void 0) return s(this, E);
+    const t = {};
+    for (const e of this.getAll()) {
+      const r = e.title.split("/");
+      let n = t;
+      for (let c = 0; c < r.length - 1; c++) {
+        const d = r[c];
+        if (d === void 0) continue;
+        const m = n[d];
+        (m === void 0 || "id" in m) && (n[d] = {}), n = n[d];
+      }
+      const a = r[r.length - 1];
+      a !== void 0 && (n[a] = e);
+    }
+    return l(this, E, t), t;
+  }
+  clear() {
+    if (s(this, o).size !== 0) {
+      for (const t of s(this, o).values())
+        t.kind === "pending" && t.reject(new Error("[jogak] registry cleared"));
+      s(this, o).clear(), u(this, h, g).call(this);
+    }
+  }
+  /** hydrated 개수. */
+  get size() {
+    let t = 0;
+    for (const e of s(this, o).values())
+      e.kind === "hydrated" && t++;
+    return t;
+  }
+  // ── NEW: 메타 / lazy API ─────────────────────────────────────────────
+  /**
+   * 인덱스 가상모듈이 호출. 기존 hydrated 항목이 있으면 meta만 갱신(HMR) — entry는 보존.
+   * meta 등록만으로는 `getAll()` 결과에 안 들어간다.
+   */
+  registerMeta(t) {
+    const e = s(this, o).get(t.id);
+    if (e === void 0) {
+      s(this, o).set(t.id, { kind: "meta", meta: t }), u(this, h, g).call(this);
+      return;
+    }
+    if (e.kind === "meta") {
+      s(this, o).set(t.id, { kind: "meta", meta: t }), u(this, h, g).call(this);
+      return;
+    }
+    if (e.kind === "pending") {
+      s(this, o).set(t.id, {
+        kind: "pending",
+        meta: t,
+        promise: e.promise,
+        resolve: e.resolve,
+        reject: e.reject
+      }), u(this, h, g).call(this);
+      return;
+    }
+    const r = {
+      ...e.entry,
+      title: t.title,
+      filePath: t.filePath,
+      source: t.source,
+      meta: F(t, e.entry.meta.component)
+    };
+    s(this, o).set(t.id, { kind: "hydrated", meta: t, entry: r }), u(this, h, g).call(this);
+  }
+  /**
+   * entry 가상모듈이 호출. pending Promise들을 resolve.
+   * meta가 없는 상태에서 호출되면(=직접 import) 임시 meta를 합성한다 (defensive).
+   */
+  hydrateEntry(t, e, r) {
+    const n = s(this, o).get(t);
+    let a;
+    n === void 0 ? (console.warn(
+      `[jogak] hydrateEntry called for unknown id "${t}" — synthesizing minimal meta`
+    ), a = {
+      id: t,
+      title: t,
+      jogakNames: e.map((d) => d.name),
+      autoArgTypes: {},
+      userArgTypes: {},
+      source: "",
+      filePath: "",
+      metaExtras: {}
+    }) : a = n.meta;
+    const c = {
+      id: a.id,
+      title: a.title,
+      jogaks: e,
+      meta: F(a, r),
+      ...a.filePath ? { filePath: a.filePath } : {},
+      ...a.source ? { source: a.source } : {}
+    };
+    if ((n == null ? void 0 : n.kind) === "pending") {
+      s(this, o).set(t, { kind: "hydrated", meta: a, entry: c }), u(this, h, g).call(this), n.resolve(c);
+      return;
+    }
+    s(this, o).set(t, { kind: "hydrated", meta: a, entry: c }), u(this, h, g).call(this);
+  }
+  /**
+   * 어댑터가 호출. hydrated였던 entry를 meta 상태로 되돌린다.
+   * HMR meta-update 이벤트에서 args/component 변경을 강제 re-hydrate 시키기 위함.
+   * unknown / meta / pending 상태에는 영향 없음.
+   */
+  invalidateEntry(t) {
+    const e = s(this, o).get(t);
+    e === void 0 || e.kind !== "hydrated" || (s(this, o).set(t, { kind: "meta", meta: e.meta }), u(this, h, g).call(this));
+  }
+  /**
+   * UI/어댑터가 호출. entry id로 완전한 RegistryEntry를 비동기 획득.
+   *
+   *  - hydrated → 즉시 resolve된 Promise
+   *  - pending  → 기존 Promise 반환 (멱등)
+   *  - meta     → loader 트리거 후 새 Promise 반환, 상태를 pending으로
+   *  - unknown  → 즉시 reject (UnknownEntryError)
+   */
+  requestEntry(t) {
+    const e = s(this, o).get(t);
+    if (e === void 0)
+      return Promise.reject(new S(t));
+    if (e.kind === "hydrated")
+      return Promise.resolve(e.entry);
+    if (e.kind === "pending")
+      return e.promise;
+    const r = s(this, P);
+    if (r === void 0)
+      return Promise.reject(
+        new Error(
+          "[jogak] entry loader not set — virtual:jogak index module did not load"
+        )
+      );
+    let n, a;
+    const c = new Promise((d, m) => {
+      n = d, a = m;
+    });
+    return s(this, o).set(t, {
+      kind: "pending",
+      meta: e.meta,
+      promise: c,
+      resolve: n,
+      reject: a
+    }), r(t).then(
+      () => {
+        const d = s(this, o).get(t);
+        (d == null ? void 0 : d.kind) !== "hydrated" && a(
+          new Error(`[jogak] entry module loaded but did not hydrate: ${t}`)
+        );
+      },
+      (d) => {
+        const m = d instanceof Error ? d : new Error(String(d)), p = s(this, o).get(t);
+        (p == null ? void 0 : p.kind) === "pending" && p.promise === c && s(this, o).set(t, { kind: "meta", meta: e.meta }), a(m);
+      }
+    ), c;
+  }
+  /**
+   * 사이드바 메타 전용 — meta-only / pending / hydrated 모두 포함.
+   *
+   * F2: 내부 캐시. mutation 시점에 invalidate되며 재계산 전까지 동일 reference를 반환한다.
+   * useSyncExternalStore의 referential identity 요구를 만족시키기 위함.
+   */
+  getAllMeta() {
+    if (s(this, v) !== void 0) return s(this, v);
+    const t = [];
+    for (const r of u(this, h, x).call(this)) {
+      const n = s(this, o).get(r);
+      n !== void 0 && t.push(n.meta);
+    }
+    const e = t;
+    return l(this, v, e), e;
+  }
+  /**
+   * 사이드바 트리 전용 — 모든 상태의 meta를 트리화.
+   * F2: getAllMeta와 동일한 캐시 정책.
+   */
+  getMetaTree() {
+    if (s(this, y) !== void 0) return s(this, y);
+    const t = {};
+    for (const e of u(this, h, x).call(this)) {
+      const r = s(this, o).get(e);
+      if (r === void 0) continue;
+      const n = r.meta, a = n.title.split("/");
+      let c = t;
+      for (let m = 0; m < a.length - 1; m++) {
+        const p = a[m];
+        if (p === void 0) continue;
+        const b = c[p];
+        (b === void 0 || "id" in b) && (c[p] = {}), c = c[p];
+      }
+      const d = a[a.length - 1];
+      d !== void 0 && (c[d] = n);
+    }
+    return l(this, y, t), t;
+  }
+  /** 진단 — 상태 머신 노출. */
+  getEntryState(t) {
+    const e = s(this, o).get(t);
+    return e === void 0 ? "unknown" : e.kind;
+  }
+  /**
+   * dynamic import 함수를 외부에서 주입. plugin이 인덱스 모듈에서 호출한다.
+   * 빌드/SSR에서 정적 import 매핑으로 교체할 때도 사용.
+   */
+  setEntryLoader(t) {
+    l(this, P, t);
+  }
+  // ── F2: subscribe API ────────────────────────────────────────────────
+  /**
+   * 등록/해제/메타 갱신/hydrate/clear 시 호출되는 listener를 등록한다.
+   *
+   * - listener는 무인자, 동기 호출. 어떤 변화가 있었는지는 listener가
+   *   `getAllMeta()`/`getMetaTree()`로 직접 확인.
+   * - mutation 도중 listener에서 `subscribe`/`unsubscribe`를 호출하는 재진입은
+   *   안전 (내부적으로 listener Set을 한 번 복사한 뒤 순회).
+   * - listener 예외는 catch + console.error 후 계속 (다른 listener 보장).
+   * - 반환값은 unsubscribe 함수 (멱등 — 두 번 호출해도 안전).
+   */
+  subscribe(t) {
+    s(this, T).add(t);
+    let e = !0;
+    return () => {
+      e && (e = !1, s(this, T).delete(t));
+    };
+  }
+}
+o = new WeakMap(), P = new WeakMap(), T = new WeakMap(), v = new WeakMap(), y = new WeakMap(), k = new WeakMap(), E = new WeakMap(), w = new WeakMap(), j = new WeakMap(), A = new WeakMap(), h = new WeakSet(), // ── 내부 헬퍼 ─────────────────────────────────────────────────────────
+/**
+ * 캐시 invalidate + listener 통지를 단일 헬퍼로.
+ * batch 모드에서는 dirty 플래그만 켜고 실제 통지는 batch 종료 시점에 한다.
+ */
+g = function() {
+  if (l(this, v, void 0), l(this, y, void 0), l(this, k, void 0), l(this, E, void 0), l(this, w, void 0), s(this, j)) {
+    l(this, A, !0);
+    return;
+  }
+  const t = Array.from(s(this, T));
+  for (const e of t)
+    try {
+      e();
+    } catch (r) {
+      console.error("[jogak] subscribe listener threw:", r);
+    }
+}, /**
+ * 모든 외부 노출 collection 이 공유하는 정렬된 id 순서.
+ * mutation 시 #cachedSortedIds 가 undefined 로 invalidate, 다음 호출에서 한 번만 재계산.
+ *
+ * 정렬 정책은 module-private `compareMetaForOrdering` 단일 source.
+ */
+x = function() {
+  if (s(this, w) !== void 0) return s(this, w);
+  const t = [];
+  for (const [r, n] of s(this, o))
+    t.push({ id: r, title: n.meta.title });
+  t.sort(I);
+  const e = t.map((r) => r.id);
+  return l(this, w, e), e;
+}, /**
+ * register() 처럼 여러 mutation을 묶어 단일 notify로 처리.
+ * 내부 전용 — public API 아님.
+ */
+U = function(t) {
+  if (s(this, j)) {
+    t();
+    return;
+  }
+  l(this, j, !0), l(this, A, !1);
+  try {
+    t();
+  } finally {
+    l(this, j, !1), s(this, A) && (l(this, A, !1), u(this, h, g).call(this));
+  }
+};
+function q(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 F(i, t) {
+  const e = {
+    ...i.autoArgTypes
+  };
+  for (const r of Object.keys(i.userArgTypes)) {
+    const n = i.userArgTypes[r];
+    n !== void 0 && (e[r] = { ...e[r], ...n });
+  }
+  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 I(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 R = new $();
+export {
+  $ as C,
+  S as U,
+  R as d
+};

package/dist/registry-DRRMxvoz.cjs

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

package/dist/registry.d.ts

@@ -22,6 +22,9 @@ export declare class ComponentRegistry {
     search(query: string): readonly RegistryEntry[];
     /**
      * title의 '/' 구분자로 hydrated entry만의 계층 트리를 구성한다.
+     *
+     * `getAll()`이 정렬된 순서를 반환하므로 트리 객체의 키 iteration order
+     * (ECMA-262 §OrdinaryOwnPropertyKeys: insertion order for string keys)도 결정적이다.
      */
     getTree(): CategoryTree;
     clear(): void;

package/dist/renderers/next/client/Preview.d.ts

@@ -0,0 +1,27 @@
+import { ComponentType, ReactElement } from 'react';
+import { RegistryEntry } from '../../../index.js';
+export interface JogakClientShellProps {
+    readonly jogakId: string;
+    /**
+     * 서버에서 직렬화하여 전달된 RegistryEntry 배열.
+     * Server Component → Client 경계를 넘기 위해 `meta.component`는 직렬화되지 않는다.
+     */
+    readonly initialEntries: readonly RegistryEntry[];
+    /**
+     * jogakId에 해당하는 컴포넌트.
+     * 함수는 Server Component에서 직렬화 불가하므로,
+     * Client 페이지가 자체 import하여 직접 prop으로 전달한다.
+     */
+    readonly component: ComponentType<Record<string, unknown>>;
+    /**
+     * 렌더에 사용할 args. 미지정 시 첫 번째 jogak의 args를 사용한다.
+     */
+    readonly args?: Readonly<Record<string, unknown>>;
+}
+/**
+ * Next.js App Router용 클라이언트 셸.
+ *
+ * 서버에서 받은 entry 메타데이터를 클라이언트 레지스트리에 로드하고,
+ * 함수 prop은 Action spy로 자동 주입한 뒤 React DOM으로 렌더한다.
+ */
+export declare function JogakClientShell({ jogakId, initialEntries, component, args, }: JogakClientShellProps): ReactElement;

package/dist/renderers/next/client/index.d.ts

@@ -0,0 +1,2 @@
+export { JogakClientShell } from './Preview.js';
+export type { JogakClientShellProps } from './Preview.js';

package/dist/renderers/next/index.cjs

@@ -0,0 +1 @@
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const o=require("react/jsx-runtime"),r=require("react"),k=require("react-dom/client"),v=require("../../registry-DRRMxvoz.cjs"),y=require("../../actions-D9bnuJ1b.cjs");function g({jogakId:s,initialEntries:c,component:i,args:u}){var f;const[j]=r.useState(()=>{const t=new v.ComponentRegistry;for(const a of c)t.register(a);return t}),e=j.get(s),l=r.useRef(null),n=r.useRef(null),d=u??((f=e==null?void 0:e.jogaks[0])==null?void 0:f.args)??{};return r.useEffect(()=>{const t=l.current;if(t===null||e===void 0)return;const a=y.injectActions(d,e.meta.argTypes??{});n.current===null&&(n.current=k.createRoot(t)),n.current.render(r.createElement(i,a))},[e,i,d]),r.useEffect(()=>()=>{var t;(t=n.current)==null||t.unmount(),n.current=null},[]),e===void 0?o.jsxs("div",{"data-testid":"jogak-not-found",children:["Jogak not found: ",s]}):o.jsxs("div",{"data-testid":"jogak-client-shell",children:[o.jsx("h2",{"data-testid":"jogak-title",children:e.title}),o.jsx("div",{ref:l,"data-testid":"jogak-preview"})]})}function h({jogakId:s,initialEntries:c,component:i,args:u}){return o.jsx(g,{jogakId:s,initialEntries:c,component:i,...u!==void 0?{args:u}:{}})}exports.JogakClientShell=g;exports.JogakLayout=h;

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

@@ -0,0 +1,4 @@
+export { JogakLayout } from './server/JogakLayout.js';
+export type { JogakLayoutProps } from './server/JogakLayout.js';
+export { JogakClientShell } from './client/Preview.js';
+export type { JogakClientShellProps } from './client/Preview.js';

package/dist/renderers/next/index.mjs

@@ -0,0 +1,53 @@
+import { jsxs as d, jsx as u } from "react/jsx-runtime";
+import { useState as v, useRef as g, useEffect as m, createElement as j } from "react";
+import { createRoot as k } from "react-dom/client";
+import { C as h } from "../../registry-CnBX6XxF.js";
+import { i as R } from "../../actions-BvvUNlgo.js";
+function y({
+  jogakId: n,
+  initialEntries: s,
+  component: o,
+  args: i
+}) {
+  var f;
+  const [p] = v(() => {
+    const e = new h();
+    for (const c of s) e.register(c);
+    return e;
+  }), t = p.get(n), a = g(null), r = g(null), l = i ?? ((f = t == null ? void 0 : t.jogaks[0]) == null ? void 0 : f.args) ?? {};
+  return m(() => {
+    const e = a.current;
+    if (e === null || t === void 0) return;
+    const c = R(l, t.meta.argTypes ?? {});
+    r.current === null && (r.current = k(e)), r.current.render(j(o, c));
+  }, [t, o, l]), m(() => () => {
+    var e;
+    (e = r.current) == null || e.unmount(), r.current = null;
+  }, []), t === void 0 ? /* @__PURE__ */ d("div", { "data-testid": "jogak-not-found", children: [
+    "Jogak not found: ",
+    n
+  ] }) : /* @__PURE__ */ d("div", { "data-testid": "jogak-client-shell", children: [
+    /* @__PURE__ */ u("h2", { "data-testid": "jogak-title", children: t.title }),
+    /* @__PURE__ */ u("div", { ref: a, "data-testid": "jogak-preview" })
+  ] });
+}
+function E({
+  jogakId: n,
+  initialEntries: s,
+  component: o,
+  args: i
+}) {
+  return /* @__PURE__ */ u(
+    y,
+    {
+      jogakId: n,
+      initialEntries: s,
+      component: o,
+      ...i !== void 0 ? { args: i } : {}
+    }
+  );
+}
+export {
+  y as JogakClientShell,
+  E as JogakLayout
+};

package/dist/renderers/next/server/JogakLayout.d.ts

@@ -0,0 +1,28 @@
+import { ComponentType, ReactElement } from 'react';
+import { RegistryEntry } from '../../../index.js';
+export interface JogakLayoutProps {
+    readonly jogakId: string;
+    readonly initialEntries: readonly RegistryEntry[];
+    readonly component: ComponentType<Record<string, unknown>>;
+    readonly args?: Readonly<Record<string, unknown>>;
+}
+/**
+ * Server Component — 직렬화 가능한 entry 메타데이터를 Client Shell로 전달한다.
+ *
+ * `entry.meta.component`는 함수이므로 Server → Client 경계를 넘을 수 없다.
+ * 호출자가 Client Component(`'use client'`)에서 컴포넌트를 import해
+ * `component` prop으로 직접 주입해야 한다.
+ *
+ * 사용 예 (App Router):
+ * ```tsx
+ * // app/showcase/page.tsx
+ * import { JogakLayout } from '@jogak/core/renderers/next'
+ * import { Button } from '@/components/Button'  // 'use client' 모듈
+ * import { entries } from '@/jogak-entries'     // 직렬화 가능한 메타만 담긴 배열
+ *
+ * export default function Page() {
+ *   return <JogakLayout jogakId="Components/Button" initialEntries={entries} component={Button} />
+ * }
+ * ```
+ */
+export declare function JogakLayout({ jogakId, initialEntries, component, args, }: JogakLayoutProps): ReactElement;

package/dist/renderers/next/server/index.d.ts

@@ -0,0 +1,2 @@
+export { JogakLayout } from './JogakLayout.js';
+export type { JogakLayoutProps } from './JogakLayout.js';

package/dist/renderers/react/JogakProvider.d.ts

@@ -0,0 +1,8 @@
+import { ReactNode } from 'react';
+import { ComponentRegistry } from '../../index.js';
+export interface JogakProviderProps {
+    readonly registry?: ComponentRegistry;
+    readonly children: ReactNode;
+}
+export declare function JogakProvider({ registry, children }: JogakProviderProps): React.ReactElement;
+export declare function useRegistry(): ComponentRegistry;

package/dist/renderers/react/adapter.d.ts

@@ -0,0 +1,2 @@
+import { JogakAdapter } from '../../index.js';
+export declare const reactAdapter: JogakAdapter;

package/dist/renderers/react/index.cjs

@@ -0,0 +1 @@
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const a=require("react"),k=require("react-dom/client"),S=require("../../actions-D9bnuJ1b.cjs"),b=require("react/jsx-runtime"),m=require("../../registry-DRRMxvoz.cjs"),R={framework:"react",render(t,e,n){const r=t.meta.component,s=S.injectActions(e,t.meta.argTypes??{}),o=n._jogakRoot;if(o!==void 0)o.render(a.createElement(r,s));else{const u=k.createRoot(n);u.render(a.createElement(r,s)),n._jogakRoot=u}},unmount(t){const e=t._jogakRoot;e==null||e.unmount(),delete t._jogakRoot}},d=a.createContext(m.defaultRegistry);function E({registry:t=m.defaultRegistry,children:e}){return b.jsx(d.Provider,{value:t,children:e})}function g(){return a.useContext(d)}function f(t,e){const n=t.getEntryState(e);if(n==="unknown")return{status:"unknown"};if(n==="hydrated"){const s=t.get(e);return s===void 0?{status:"error",error:new Error(`[jogak] inconsistent registry state for id "${e}"`)}:{status:"ready",entry:s}}const r=p(t,e);return r===void 0?{status:"error",error:new Error(`[jogak] meta missing for id "${e}"`)}:{status:"loading",meta:r}}function p(t,e){for(const n of t.getAllMeta())if(n.id===e)return n}function M(t){const e=g(),[n,r]=a.useState(()=>f(e,t));return a.useEffect(()=>{let s=!1,o=null;const u=()=>{if(s)return;const i=f(e,t);r(i),i.status==="loading"&&o!=="loading"?(o="loading",e.requestEntry(t).catch(l=>{if(s)return;const y=l instanceof Error?l:new Error(String(l));r({status:"error",error:y})})):o=i.status};u();const c=e.subscribe(u);return()=>{s=!0,c()}},[e,t]),n}function j(t){return e=>t.subscribe(e)}function v(t){let e=null,n=null,r=null;return()=>{const s=t.getAllMeta(),o=t.getMetaTree();return r!==null&&s===e&&o===n||(e=s,n=o,r={metas:s,metaTree:o}),r}}function h(){const t=g(),e=a.useMemo(()=>j(t),[t]),n=a.useMemo(()=>v(t),[t]),r=a.useSyncExternalStore(e,n,n),s=a.useCallback(o=>{const u=o.trim().toLowerCase();return u.length===0?r.metas:r.metas.filter(c=>c.title.toLowerCase().includes(u))},[r.metas]);return{metas:r.metas,metaTree:r.metaTree,searchMeta:s}}exports.JogakProvider=E;exports.reactAdapter=R;exports.useEntry=M;exports.useRegistry=g;exports.useRegistryMeta=h;

package/dist/renderers/react/index.d.ts

@@ -0,0 +1,7 @@
+export { reactAdapter } from './adapter.js';
+export { JogakProvider, useRegistry } from './JogakProvider.js';
+export type { JogakProviderProps } from './JogakProvider.js';
+export { useEntry } from './useEntry.js';
+export type { UseEntryState } from './useEntry.js';
+export { useRegistryMeta } from './useRegistryMeta.js';
+export type { UseRegistryMetaReturn } from './useRegistryMeta.js';