@jogak/core 0.1.0-alpha.0

package/dist/vite/index.mjs

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

package/dist/vite/plugin.d.ts

@@ -0,0 +1,3 @@
+import { Plugin } from 'vite';
+import { JogakPluginOptions } from '../types.js';
+export declare function jogak(options?: JogakPluginOptions): Plugin;

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

@@ -0,0 +1,19 @@
+/**
+ * 가상모듈 식별자 — 단일 정의 소스.
+ *
+ * - 인덱스 모듈(`virtual:jogak`): 모든 entry의 meta. user 모듈 import 0개.
+ * - Entry 모듈(`virtual:jogak/entry/<slug>`): 단 하나의 user jogak 파일을 import해
+ *   `defaultRegistry.hydrateEntry`로 register하는 side-effect 모듈.
+ *
+ * id ↔ slug 변환:
+ * - 사용자 title이 `Form/Button` 같은 슬래시를 포함하므로 URL/모듈 경로에 직접 못 씀.
+ * - base64url은 모듈 식별자에 안전 (영숫자 + `-_`).
+ */
+/** 인덱스 모듈 — 모든 entry의 meta. */
+export declare const VIRTUAL_INDEX_ID = "virtual:jogak";
+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;
+export declare function idToSlug(id: string): string;
+export declare function slugToId(slug: string): string;

package/package.json

@@ -0,0 +1,82 @@
+{
+  "name": "@jogak/core",
+  "version": "0.1.0-alpha.0",
+  "description": "Core types, registry, and Vite plugin for Jogak — a lightweight Storybook alternative.",
+  "keywords": [
+    "jogak",
+    "storybook",
+    "storybook-alternative",
+    "showcase",
+    "design-system",
+    "component-library",
+    "vite-plugin"
+  ],
+  "author": {
+    "name": "devclib",
+    "url": "https://github.com/devclib"
+  },
+  "license": "MIT",
+  "homepage": "https://github.com/devclib/jogak#readme",
+  "bugs": "https://github.com/devclib/jogak/issues",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/devclib/jogak.git",
+    "directory": "packages/core"
+  },
+  "type": "module",
+  "sideEffects": false,
+  "main": "./dist/index.js",
+  "module": "./dist/index.mjs",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.mjs",
+      "require": "./dist/index.js"
+    },
+    "./vite": {
+      "types": "./dist/vite/plugin.d.ts",
+      "import": "./dist/vite/index.mjs"
+    },
+    "./build": {
+      "types": "./dist/build/index.d.ts",
+      "import": "./dist/build/index.mjs"
+    }
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE",
+    "CHANGELOG.md"
+  ],
+  "engines": {
+    "node": ">=20.18"
+  },
+  "publishConfig": {
+    "access": "public",
+    "registry": "https://registry.npmjs.org/"
+  },
+  "dependencies": {
+    "glob": "^11.0.0",
+    "ts-morph": "^23.0.0"
+  },
+  "devDependencies": {
+    "vite": "^6.0.0",
+    "vite-plugin-dts": "^4.0.0",
+    "typescript": "^5.5.0",
+    "@types/node": "^20.14.0"
+  },
+  "peerDependencies": {
+    "vite": "^6.0.0"
+  },
+  "peerDependenciesMeta": {
+    "vite": {
+      "optional": true
+    }
+  },
+  "scripts": {
+    "build": "vite build",
+    "dev": "vite build --watch",
+    "typecheck": "tsc --noEmit"
+  }
+}