docula 1.13.0 → 1.14.0

package/dist/docula.d.ts

@@ -83,6 +83,7 @@ type ApiOperation = {
   id: string;
   method: string;
   methodUpper: string;
+  methodShort: string;
   path: string;
   summary: string;
   description: string;
@@ -448,6 +449,7 @@ declare class DoculaBuilder {
   private readonly _console;
   private readonly _hash;
   onReleaseChangelog?: (entries: DoculaChangelogEntry[], console: DoculaConsole) => Promise<DoculaChangelogEntry[]> | DoculaChangelogEntry[];
+  onAutoReadme?: (content: string, sourcePath: string, console: DoculaConsole) => Promise<string> | string;
   get console(): DoculaConsole;
   constructor(options?: DoculaBuilderOptions, engineOptions?: any);
   get options(): DoculaOptions;

package/dist/docula.js

@@ -12,7 +12,7 @@ import { blue, bold, cyan, dim, gray, green, magenta, red, white, yellow } from
 import { CacheableNet } from "@cacheable/net";
 import os from "node:os";
 //#region package.json
-var version = "1.13.0";
+var version = "1.14.0";
 var package_default = {
 	name: "docula",
 	version,
@@ -69,36 +69,33 @@ var package_default = {
 	],
 	bin: { "docula": "./bin/docula.js" },
 	dependencies: {
-		"@ai-sdk/anthropic": "^3.0.63",
-		"@ai-sdk/google": "^3.0.52",
-		"@ai-sdk/openai": "^3.0.47",
-		"@cacheable/net": "^2.0.6",
-		"ai": "^6.0.134",
+		"@ai-sdk/anthropic": "^3.0.69",
+		"@ai-sdk/google": "^3.0.63",
+		"@ai-sdk/openai": "^3.0.53",
+		"@cacheable/net": "^2.0.7",
+		"ai": "^6.0.164",
 		"colorette": "^2.0.20",
-		"ecto": "^4.8.3",
-		"feed": "^5.2.0",
-		"hashery": "^1.5.1",
+		"ecto": "^4.8.4",
+		"hashery": "^2.0.0",
 		"jiti": "^2.6.1",
 		"serve-handler": "^6.1.7",
 		"update-notifier": "^7.3.1",
-		"writr": "^6.1.0"
+		"writr": "^6.1.1"
 	},
 	devDependencies: {
-		"@biomejs/biome": "^2.4.8",
-		"@playwright/test": "^1.58.2",
-		"@types/express": "^5.0.6",
-		"@types/js-yaml": "^4.0.9",
-		"@types/node": "^25.5.0",
+		"@biomejs/biome": "^2.4.12",
+		"@playwright/test": "^1.59.1",
+		"@types/node": "^25.6.0",
 		"@types/serve-handler": "^6.1.4",
 		"@types/update-notifier": "^6.0.8",
-		"@vitest/coverage-v8": "^4.1.0",
-		"dotenv": "^17.3.1",
+		"@vitest/coverage-v8": "^4.1.4",
+		"dotenv": "^17.4.2",
 		"postject": "1.0.0-alpha.6",
 		"rimraf": "^6.1.3",
-		"tsdown": "^0.21.7",
+		"tsdown": "^0.21.9",
 		"tsx": "^4.21.0",
-		"typescript": "^5.9.3",
-		"vitest": "^4.1.0"
+		"typescript": "^6.0.2",
+		"vitest": "^4.1.4"
 	},
 	files: [
 		"dist",
@@ -379,10 +376,13 @@ function parseOpenApiSpec(specJson) {
 			const requestBody = extractRequestBody(operation, spec);
 			const responses = extractResponses(operation, spec);
 			const codeExamples = generateCodeExamples(method, pathStr, servers.length > 0 ? servers[0].url : "", parameters, requestBody);
+			const operationId = operation.operationId ?? `${method}-${pathStr.replaceAll(/[^a-zA-Z0-9]/g, "-")}`;
+			const methodUpper = method.toUpperCase();
 			const apiOperation = {
-				id: slugify(operation.operationId ?? `${method}-${pathStr.replaceAll(/[^a-zA-Z0-9]/g, "-")}`),
+				id: slugify(operationId),
 				method,
-				methodUpper: method.toUpperCase(),
+				methodUpper,
+				methodShort: methodUpper === "DELETE" ? "DEL" : methodUpper === "OPTIONS" ? "OPT" : methodUpper,
 				path: pathStr,
 				summary: operation.summary ?? "",
 				description: operation.description ?? "",
@@ -1093,6 +1093,22 @@ function hashFile(hash, filePath) {
 	const content = fs.readFileSync(filePath);
 	return hash.toHashSync(content);
 }
+function tryHashFile(hash, filePath) {
+	try {
+		return hashFile(hash, filePath);
+	} catch (error) {
+		if (error.code === "ENOENT") return;
+		/* v8 ignore next 2 -- @preserve */
+		throw error;
+	}
+}
+function hashConfigFile(hash, sitePath) {
+	for (const name of ["docula.config.ts", "docula.config.mjs"]) {
+		const configPath = path.join(sitePath, name);
+		if (fs.existsSync(configPath)) return hashFile(hash, configPath);
+	}
+	return "";
+}
 function hashOptions(hash, options) {
 	const relevant = {
 		siteUrl: options.siteUrl,
@@ -1119,19 +1135,29 @@ function hashOptions(hash, options) {
 		ai: options.ai,
 		googleTagManager: options.googleTagManager
 	};
-	return hash.toHashSync(JSON.stringify(relevant));
+	const optionsHash = hash.toHashSync(JSON.stringify(relevant));
+	const configHash = hashConfigFile(hash, options.sitePath);
+	return hash.toHashSync(`${optionsHash}:${configHash}`);
 }
 function hashTemplateDirectory(hash, templatePath) {
 	/* v8 ignore next 3 -- @preserve */
 	if (!fs.existsSync(templatePath)) return "";
-	const hashes = listFilesRecursive(templatePath).map((f) => hashFile(hash, path.join(templatePath, f)));
+	const files = listFilesRecursive(templatePath);
+	const hashes = [];
+	for (const f of files) {
+		const fileHash = tryHashFile(hash, path.join(templatePath, f));
+		if (fileHash !== void 0) hashes.push(fileHash);
+	}
 	return hash.toHashSync(hashes.join(""));
 }
 function hashSourceFiles(hash, dir) {
 	const hashes = {};
 	if (!fs.existsSync(dir)) return hashes;
 	const files = listFilesRecursive(dir);
-	for (const file of files) hashes[file] = hashFile(hash, path.join(dir, file));
+	for (const file of files) {
+		const fileHash = tryHashFile(hash, path.join(dir, file));
+		if (fileHash !== void 0) hashes[file] = fileHash;
+	}
 	return hashes;
 }
 function recordsEqual(a, b) {
@@ -2739,6 +2765,7 @@ var DoculaBuilder = class {
 	_console;
 	_hash = new Hashery();
 	onReleaseChangelog;
+	onAutoReadme;
 	get console() {
 		return this._console;
 	}
@@ -3014,9 +3041,16 @@ var DoculaBuilder = class {
 				if (packageJson.name && typeof packageJson.name === "string") readmeContent = `# ${packageJson.name}\n\n${readmeContent}`;
 			} catch {}
 		}
+		let content = readmeContent;
+		if (this.onAutoReadme) try {
+			content = await this.onAutoReadme(content, cwdReadmePath, this._console);
+		} catch (error) {
+			const message = error instanceof Error ? error.message : String(error);
+			this._console.error(`onAutoReadme error: ${message}`);
+		}
 		return {
 			sourcePath: cwdReadmePath,
-			content: readmeContent
+			content
 		};
 	}
 	async getGithubData(githubPath) {
@@ -3396,6 +3430,8 @@ var Docula = class {
 		const builder = new DoculaBuilder(Object.assign(this.options, { console: this._console }));
 		/* v8 ignore next 4 -- @preserve */
 		if (this._configFileModule.onReleaseChangelog) builder.onReleaseChangelog = this._configFileModule.onReleaseChangelog;
+		/* v8 ignore next 4 -- @preserve */
+		if (this._configFileModule.onAutoReadme) builder.onAutoReadme = this._configFileModule.onAutoReadme;
 		await builder.build();
 		return builder;
 	}
@@ -3496,12 +3532,16 @@ var Docula = class {
 			}
 			else {
 				const { createJiti } = await import("jiti");
-				this._configFileModule = await createJiti(import.meta.url, { interopDefault: true }).import(absolutePath);
+				const jiti = createJiti(import.meta.url, { interopDefault: true });
+				this._configFileModule = await jiti.import(absolutePath);
 			}
 			return;
 		}
 		/* v8 ignore next -- @preserve */
-		if (fs.existsSync(mjsConfigFile)) this._configFileModule = await import(pathToFileURL(path.resolve(mjsConfigFile)).href);
+		if (fs.existsSync(mjsConfigFile)) {
+			const absolutePath = path.resolve(mjsConfigFile);
+			this._configFileModule = await import(pathToFileURL(absolutePath).href);
+		}
 	}
 	/**
 	* Watch the site path for file changes and rebuild on change

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "docula",
-  "version": "1.13.0",
+  "version": "1.14.0",
   "description": "Beautiful Website for Your Projects",
   "type": "module",
   "main": "./dist/docula.js",
@@ -40,36 +40,33 @@
     "docula": "./bin/docula.js"
   },
   "dependencies": {
-    "@ai-sdk/anthropic": "^3.0.63",
-    "@ai-sdk/google": "^3.0.52",
-    "@ai-sdk/openai": "^3.0.47",
-    "@cacheable/net": "^2.0.6",
-    "ai": "^6.0.134",
+    "@ai-sdk/anthropic": "^3.0.69",
+    "@ai-sdk/google": "^3.0.63",
+    "@ai-sdk/openai": "^3.0.53",
+    "@cacheable/net": "^2.0.7",
+    "ai": "^6.0.164",
     "colorette": "^2.0.20",
-    "ecto": "^4.8.3",
-    "feed": "^5.2.0",
-    "hashery": "^1.5.1",
+    "ecto": "^4.8.4",
+    "hashery": "^2.0.0",
     "jiti": "^2.6.1",
     "serve-handler": "^6.1.7",
     "update-notifier": "^7.3.1",
-    "writr": "^6.1.0"
+    "writr": "^6.1.1"
   },
   "devDependencies": {
-    "@biomejs/biome": "^2.4.8",
-    "@playwright/test": "^1.58.2",
-    "@types/express": "^5.0.6",
-    "@types/js-yaml": "^4.0.9",
-    "@types/node": "^25.5.0",
+    "@biomejs/biome": "^2.4.12",
+    "@playwright/test": "^1.59.1",
+    "@types/node": "^25.6.0",
     "@types/serve-handler": "^6.1.4",
     "@types/update-notifier": "^6.0.8",
-    "@vitest/coverage-v8": "^4.1.0",
-    "dotenv": "^17.3.1",
+    "@vitest/coverage-v8": "^4.1.4",
+    "dotenv": "^17.4.2",
     "postject": "1.0.0-alpha.6",
     "rimraf": "^6.1.3",
-    "tsdown": "^0.21.7",
+    "tsdown": "^0.21.9",
     "tsx": "^4.21.0",
-    "typescript": "^5.9.3",
-    "vitest": "^4.1.0"
+    "typescript": "^6.0.2",
+    "vitest": "^4.1.4"
   },
   "files": [
     "dist",

package/templates/modern/api.hbs

@@ -39,8 +39,8 @@
         <div class="api-sidebar__group-items">
           {{#each this.operations}}
           <a href="#{{this.id}}" class="api-sidebar__item" data-method="{{this.method}}" data-path="{{this.path}}">
-            <span class="method-badge method-badge--{{this.method}}">{{this.methodUpper}}</span>
             <span class="api-sidebar__item-path">{{this.path}}</span>
+            <span class="method-badge method-badge--{{this.method}}">{{this.methodShort}}</span>
           </a>
           {{/each}}
         </div>

package/templates/modern/css/api.css

@@ -100,17 +100,20 @@
 }
 
 .api-sidebar__group-items {
-  padding: 2px 0 8px 0;
+  padding: 4px 0 8px 12px;
+  margin-left: 10px;
+  border-left: 1px solid var(--border);
 }
 
 .api-sidebar__item {
   display: flex;
   align-items: center;
-  gap: 8px;
-  padding: 4px 10px;
+  justify-content: space-between;
+  gap: 12px;
+  padding: 8px 10px;
   font-size: 13px;
   border-radius: 4px;
-  color: var(--fg);
+  color: var(--muted-fg);
   white-space: nowrap;
   overflow: hidden;
   text-overflow: ellipsis;
@@ -125,8 +128,23 @@
 }
 
 .api-sidebar__item-path {
+  min-width: 0;
   overflow: hidden;
   text-overflow: ellipsis;
+  color: var(--muted-fg);
+}
+
+.api-sidebar__item--active .api-sidebar__item-path {
+  color: var(--fg);
+}
+
+.api-sidebar__item .method-badge {
+  background: transparent;
+  padding: 0;
+  min-width: 0;
+  border-radius: 0;
+  font-size: 11px;
+  letter-spacing: 0.5px;
 }
 
 /* Method Badges */

package/templates/modern/css/styles.css

@@ -289,6 +289,44 @@ body {
   letter-spacing: 0.24px;
 }
 
+.nav-sidebar__title:has(.nav-sidebar__toggle) {
+  padding: 0;
+}
+
+.nav-sidebar__toggle {
+  all: unset;
+  box-sizing: border-box;
+  display: flex;
+  align-items: center;
+  justify-content: space-between;
+  width: 100%;
+  cursor: pointer;
+  padding: 0 8px 0 10px;
+  font: inherit;
+  color: inherit;
+  text-transform: inherit;
+  letter-spacing: inherit;
+}
+
+.nav-sidebar__toggle:focus-visible {
+  outline: 2px solid var(--accent, currentColor);
+  outline-offset: 2px;
+  border-radius: 4px;
+}
+
+.nav-sidebar__chevron {
+  flex-shrink: 0;
+  transition: transform 150ms ease;
+}
+
+.nav-sidebar__section--collapsed .nav-sidebar__chevron {
+  transform: rotate(-90deg);
+}
+
+.nav-sidebar__section--collapsed .nav-sidebar__list {
+  display: none;
+}
+
 .nav-sidebar__list {
   margin-block: 2px;
 }

package/templates/modern/includes/scripts.hbs

@@ -227,6 +227,48 @@
       }
     });
 
+    // Sidebar section collapse/expand
+    const SIDEBAR_STORAGE_KEY = 'docula:sidebar-sections';
+    const collapsibleSections = document.querySelectorAll('.nav-sidebar__section--collapsible');
+    if (collapsibleSections.length > 0) {
+      let storedSectionState = {};
+      try {
+        storedSectionState = JSON.parse(localStorage.getItem(SIDEBAR_STORAGE_KEY) || '{}');
+      } catch (e) { storedSectionState = {}; }
+
+      const activeSidebarLink = document.querySelector('.nav-sidebar__item--active');
+      const activeSection = activeSidebarLink ? activeSidebarLink.closest('.nav-sidebar__section--collapsible') : null;
+      const defaultOpenSection = activeSection || collapsibleSections[0];
+
+      const setSectionOpen = (section, toggle, open) => {
+        toggle.setAttribute('aria-expanded', open ? 'true' : 'false');
+        section.classList.toggle('nav-sidebar__section--collapsed', !open);
+      };
+
+      collapsibleSections.forEach((section, idx) => {
+        const toggle = section.querySelector('.nav-sidebar__toggle');
+        const list = section.querySelector('.nav-sidebar__list');
+        if (!toggle || !list) return;
+        const listId = 'nav-sidebar-section-' + idx;
+        list.id = listId;
+        toggle.setAttribute('aria-controls', listId);
+
+        const key = 'section-' + idx;
+        const hasStored = Object.prototype.hasOwnProperty.call(storedSectionState, key);
+        const isOpen = hasStored ? !!storedSectionState[key] : section === defaultOpenSection;
+        setSectionOpen(section, toggle, isOpen);
+
+        toggle.addEventListener('click', () => {
+          const next = toggle.getAttribute('aria-expanded') !== 'true';
+          setSectionOpen(section, toggle, next);
+          storedSectionState[key] = next;
+          try {
+            localStorage.setItem(SIDEBAR_STORAGE_KEY, JSON.stringify(storedSectionState));
+          } catch (e) { /* storage unavailable */ }
+        });
+      });
+    }
+
     // Active header nav link highlighting
     const navLinks = document.querySelectorAll('.header-bottom__item');
     navLinks.forEach((link) => {

package/templates/modern/includes/sidebar.hbs

@@ -1,7 +1,12 @@
 {{#forEach sidebarItems}}
   {{#if children}}
-    <section class="nav-sidebar__section">
-      <h2 class="nav-sidebar__title">{{name}}</h2>
+    <section class="nav-sidebar__section nav-sidebar__section--collapsible">
+      <h2 class="nav-sidebar__title">
+        <button type="button" class="nav-sidebar__toggle" aria-expanded="true">
+          <span class="nav-sidebar__toggle-label">{{name}}</span>
+          <svg class="nav-sidebar__chevron" xmlns="http://www.w3.org/2000/svg" width="12" height="12" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2.5" stroke-linecap="round" stroke-linejoin="round" aria-hidden="true"><polyline points="6 9 12 15 18 9"/></svg>
+        </button>
+      </h2>
       <ul class="nav-sidebar__list">
         {{#forEach children}}
         <li>