@marlinjai/clearify 1.5.3 → 1.6.0

package/dist/node/{chunk-NY3VVUQ3.js → chunk-7IXPTIHW.js}

@@ -8,7 +8,7 @@ import {
 } from "./chunk-SCZZB7OE.js";
 import {
   clearifyPlugin
-} from "./chunk-UOVBAJMR.js";
+} from "./chunk-7VYQMIW2.js";
 import {
   loadUserConfig,
   resolveConfig,

package/dist/node/{chunk-UOVBAJMR.js → chunk-7VYQMIW2.js}

@@ -13,6 +13,7 @@ import {
 // src/vite-plugin/index.ts
 import { resolve } from "path";
 import { existsSync, readFileSync } from "fs";
+import { dereference } from "@scalar/openapi-parser";
 var VIRTUAL_CONFIG = "virtual:clearify/config";
 var RESOLVED_VIRTUAL_CONFIG = "\0" + VIRTUAL_CONFIG;
 var VIRTUAL_ROUTES = "virtual:clearify/routes";
@@ -35,7 +36,7 @@ function clearifyPlugin(options = {}) {
   let allSectionNavigations;
   let allSearchEntries;
   let mermaidSvgData = options.mermaidSvgs ?? {};
-  function refreshDocs() {
+  async function refreshDocs() {
     const changelogPath = resolve(userRoot, "CHANGELOG.md");
     sectionDataList = visibleSections.map(
       (section) => buildSectionData(section, changelogPath, config.navigation)
@@ -48,7 +49,7 @@ function clearifyPlugin(options = {}) {
     );
     if (config.openapi?.spec && config.openapi.generatePages !== false) {
       const basePath = config.openapi.basePath ?? "/api";
-      const specData = loadOpenAPISpecData();
+      const specData = await loadOpenAPISpecData();
       if (specData) {
         let opAnchor2 = function(tag, method, opPath) {
           const slug = `${method.toLowerCase()}${opPath.replace(/[{}]/g, "")}`;
@@ -132,7 +133,7 @@ ${routeEntries.join(",\n")}
   }
   let cachedSpecData = null;
   let specDataInitialized = false;
-  function loadOpenAPISpecData() {
+  async function loadOpenAPISpecData() {
     if (specDataInitialized) return cachedSpecData;
     specDataInitialized = true;
     const specPath = config.openapi?.spec;
@@ -148,45 +149,32 @@ ${routeEntries.join(",\n")}
     try {
       const content = readFileSync(resolvedPath, "utf-8");
       const isYaml = /\.ya?ml$/i.test(resolvedPath);
+      let parsed;
       if (isYaml) {
         try {
-          cachedSpecData = JSON.parse(content);
-          return cachedSpecData;
+          parsed = JSON.parse(content);
         } catch {
           console.warn("  YAML OpenAPI specs require js-yaml for page generation. Install it or use a JSON spec.");
           cachedSpecData = null;
           return null;
         }
+      } else {
+        parsed = JSON.parse(content);
       }
-      cachedSpecData = JSON.parse(content);
+      const { schema } = await dereference(parsed);
+      cachedSpecData = schema;
       return cachedSpecData;
     } catch {
       cachedSpecData = null;
       return null;
     }
   }
-  function loadOpenAPISpec() {
-    const specPath = config.openapi?.spec;
-    if (!specPath) {
-      return "export default null;";
-    }
-    const resolvedPath = resolve(userRoot, specPath);
-    if (!existsSync(resolvedPath)) {
-      console.warn(`  OpenAPI spec not found: ${resolvedPath}`);
-      return "export default null;";
-    }
-    try {
-      const content = readFileSync(resolvedPath, "utf-8");
-      const isYaml = /\.ya?ml$/i.test(resolvedPath);
-      if (isYaml) {
-        return `export default ${JSON.stringify(content)};`;
-      }
-      JSON.parse(content);
-      return `export default ${content};`;
-    } catch (err) {
-      console.warn(`  Failed to load OpenAPI spec: ${resolvedPath}`, err instanceof Error ? err.message : err);
+  async function loadOpenAPISpec() {
+    const specData = await loadOpenAPISpecData();
+    if (!specData) {
       return "export default null;";
     }
+    return `export default ${JSON.stringify(specData)};`;
   }
   const mainPlugin = {
     name: "clearify",
@@ -199,7 +187,7 @@ ${routeEntries.join(",\n")}
       const allSections = resolveSections(config, userRoot);
       const isDev = resolvedViteConfig.command === "serve";
       visibleSections = isDev ? allSections : allSections.filter((s) => !s.draft);
-      refreshDocs();
+      await refreshDocs();
     },
     resolveId(id) {
       if (id === VIRTUAL_CONFIG) return RESOLVED_VIRTUAL_CONFIG;
@@ -210,7 +198,7 @@ ${routeEntries.join(",\n")}
       if (id === VIRTUAL_OPENAPI_SPEC) return RESOLVED_VIRTUAL_OPENAPI_SPEC;
       return null;
     },
-    load(id) {
+    async load(id) {
       if (id === RESOLVED_VIRTUAL_CONFIG) {
         return `export default ${JSON.stringify(config)};`;
       }
@@ -227,7 +215,7 @@ ${routeEntries.join(",\n")}
         return `export default ${JSON.stringify(mermaidSvgData)};`;
       }
       if (id === RESOLVED_VIRTUAL_OPENAPI_SPEC) {
-        return loadOpenAPISpec();
+        return await loadOpenAPISpec();
       }
       return null;
     },
@@ -248,16 +236,17 @@ ${routeEntries.join(",\n")}
           if (changedPath === openapiPath) {
             specDataInitialized = false;
             cachedSpecData = null;
-            refreshDocs();
-            const specMod = server.moduleGraph.getModuleById(RESOLVED_VIRTUAL_OPENAPI_SPEC);
-            if (specMod) server.moduleGraph.invalidateModule(specMod);
-            const routesMod = server.moduleGraph.getModuleById(RESOLVED_VIRTUAL_ROUTES);
-            if (routesMod) server.moduleGraph.invalidateModule(routesMod);
-            const navMod = server.moduleGraph.getModuleById(RESOLVED_VIRTUAL_NAVIGATION);
-            if (navMod) server.moduleGraph.invalidateModule(navMod);
-            const searchMod = server.moduleGraph.getModuleById(RESOLVED_VIRTUAL_SEARCH_INDEX);
-            if (searchMod) server.moduleGraph.invalidateModule(searchMod);
-            server.ws.send({ type: "full-reload" });
+            refreshDocs().then(() => {
+              const specMod = server.moduleGraph.getModuleById(RESOLVED_VIRTUAL_OPENAPI_SPEC);
+              if (specMod) server.moduleGraph.invalidateModule(specMod);
+              const routesMod = server.moduleGraph.getModuleById(RESOLVED_VIRTUAL_ROUTES);
+              if (routesMod) server.moduleGraph.invalidateModule(routesMod);
+              const navMod = server.moduleGraph.getModuleById(RESOLVED_VIRTUAL_NAVIGATION);
+              if (navMod) server.moduleGraph.invalidateModule(navMod);
+              const searchMod = server.moduleGraph.getModuleById(RESOLVED_VIRTUAL_SEARCH_INDEX);
+              if (searchMod) server.moduleGraph.invalidateModule(searchMod);
+              server.ws.send({ type: "full-reload" });
+            });
           }
         });
       }
@@ -358,14 +347,15 @@ ${routeEntries.join(",\n")}
         if (!isChangelog && !isInSection) return;
         if (!path.endsWith(".md") && !path.endsWith(".mdx")) return;
         if (event === "add" || event === "unlink" || event === "change") {
-          refreshDocs();
-          const routesMod = server.moduleGraph.getModuleById(RESOLVED_VIRTUAL_ROUTES);
-          const navMod = server.moduleGraph.getModuleById(RESOLVED_VIRTUAL_NAVIGATION);
-          const searchMod = server.moduleGraph.getModuleById(RESOLVED_VIRTUAL_SEARCH_INDEX);
-          if (routesMod) server.moduleGraph.invalidateModule(routesMod);
-          if (navMod) server.moduleGraph.invalidateModule(navMod);
-          if (searchMod) server.moduleGraph.invalidateModule(searchMod);
-          server.ws.send({ type: "full-reload" });
+          refreshDocs().then(() => {
+            const routesMod = server.moduleGraph.getModuleById(RESOLVED_VIRTUAL_ROUTES);
+            const navMod = server.moduleGraph.getModuleById(RESOLVED_VIRTUAL_NAVIGATION);
+            const searchMod = server.moduleGraph.getModuleById(RESOLVED_VIRTUAL_SEARCH_INDEX);
+            if (routesMod) server.moduleGraph.invalidateModule(routesMod);
+            if (navMod) server.moduleGraph.invalidateModule(navMod);
+            if (searchMod) server.moduleGraph.invalidateModule(searchMod);
+            server.ws.send({ type: "full-reload" });
+          });
         }
       });
       return () => {

package/dist/node/node/build.js

@@ -1,9 +1,9 @@
 import {
   buildSite
-} from "../chunk-NY3VVUQ3.js";
+} from "../chunk-7IXPTIHW.js";
 import "../chunk-PRTER35L.js";
 import "../chunk-SCZZB7OE.js";
-import "../chunk-UOVBAJMR.js";
+import "../chunk-7VYQMIW2.js";
 import "../chunk-B2Q23JW3.js";
 import "../chunk-IBK35HZR.js";
 import "../chunk-V7LLYIRO.js";

package/dist/node/node/index.js

@@ -1,13 +1,13 @@
 import {
   buildSite
-} from "../chunk-NY3VVUQ3.js";
+} from "../chunk-7IXPTIHW.js";
 import {
   remarkMermaidToComponent
 } from "../chunk-PRTER35L.js";
 import "../chunk-SCZZB7OE.js";
 import {
   clearifyPlugin
-} from "../chunk-UOVBAJMR.js";
+} from "../chunk-7VYQMIW2.js";
 import "../chunk-B2Q23JW3.js";
 import {
   init

package/dist/node/vite-plugin/index.js

@@ -1,6 +1,6 @@
 import {
   clearifyPlugin
-} from "../chunk-UOVBAJMR.js";
+} from "../chunk-7VYQMIW2.js";
 import "../chunk-B2Q23JW3.js";
 import "../chunk-IBK35HZR.js";
 import "../chunk-V7LLYIRO.js";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@marlinjai/clearify",
-  "version": "1.5.3",
+  "version": "1.6.0",
   "description": "An open-source documentation site generator. Turn markdown into beautiful docs.",
   "type": "module",
   "bin": {
@@ -29,7 +29,7 @@
   "dependencies": {
     "@mdx-js/react": "^3.1.1",
     "@mdx-js/rollup": "^3.1.1",
-    "@scalar/api-reference-react": "^0.8.52",
+    "@scalar/openapi-parser": "^0.10.7",
     "@shikijs/rehype": "^3.22.0",
     "@tailwindcss/typography": "^0.5.19",
     "@tailwindcss/vite": "^4.1.18",