docula 1.14.0 → 2.1.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "docula",
-  "version": "1.14.0",
+  "version": "2.1.0",
   "description": "Beautiful Website for Your Projects",
   "type": "module",
   "main": "./dist/docula.js",
@@ -17,7 +17,7 @@
   },
   "author": "Jared Wray <me@jaredwray.com>",
   "engines": {
-    "node": ">=20"
+    "node": "^22.19.0 || >=24.0.0"
   },
   "license": "MIT",
   "keywords": [
@@ -40,33 +40,34 @@
     "docula": "./bin/docula.js"
   },
   "dependencies": {
-    "@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",
+    "@ai-sdk/anthropic": "^3.0.83",
+    "@ai-sdk/google": "^3.0.81",
+    "@ai-sdk/openai": "^3.0.70",
+    "@cacheable/net": "^2.0.8",
+    "ai": "^6.0.202",
     "colorette": "^2.0.20",
-    "ecto": "^4.8.4",
-    "hashery": "^2.0.0",
-    "jiti": "^2.6.1",
+    "ecto": "^4.8.7",
+    "hashery": "^3.0.0",
+    "ipaddr.js": "2.4.0",
+    "jiti": "^2.7.0",
     "serve-handler": "^6.1.7",
+    "undici": "8.4.1",
     "update-notifier": "^7.3.1",
-    "writr": "^6.1.1"
+    "writr": "^6.1.2"
   },
   "devDependencies": {
-    "@biomejs/biome": "^2.4.12",
-    "@playwright/test": "^1.59.1",
-    "@types/node": "^25.6.0",
+    "@biomejs/biome": "^2.4.16",
+    "@playwright/test": "^1.60.0",
+    "@types/node": "^24.13.2",
     "@types/serve-handler": "^6.1.4",
     "@types/update-notifier": "^6.0.8",
-    "@vitest/coverage-v8": "^4.1.4",
+    "@vitest/coverage-v8": "^4.1.8",
     "dotenv": "^17.4.2",
-    "postject": "1.0.0-alpha.6",
     "rimraf": "^6.1.3",
-    "tsdown": "^0.21.9",
-    "tsx": "^4.21.0",
-    "typescript": "^6.0.2",
-    "vitest": "^4.1.4"
+    "tsdown": "^0.22.2",
+    "tsx": "^4.22.4",
+    "typescript": "^6.0.3",
+    "vitest": "^4.1.8"
   },
   "files": [
     "dist",
@@ -76,7 +77,7 @@
   "scripts": {
     "clean": "rimraf ./dist ./coverage ./node_modules ./package-lock.json ./yarn.lock ./pnpm-lock.yaml ./site/dist",
     "build": "pnpm generate-init-file && tsdown",
-    "build:binary": "pnpm generate-init-file && pnpm generate-embedded-templates && tsdown --config tsdown.config.binary.ts && tsx scripts/build-sea.ts",
+    "build:binary": "pnpm generate-init-file && pnpm generate-embedded-templates && tsdown --config tsdown.config.binary.ts",
     "generate-embedded-templates": "tsx scripts/generate-embedded-templates.ts",
     "lint": "biome check --write --error-on-warnings",
     "lint:ci": "biome check --error-on-warnings",

package/templates/classic/includes/header.hbs

@@ -31,4 +31,4 @@ j=d.createElement(s),dl=l!='dataLayer'?'&l='+l:'';j.async=true;j.src=
   rel="stylesheet"
 />
 <link rel="stylesheet" href="/css/highlight/styles/base16/dracula.min.css" />
-<link rel="icon" href="/favicon.ico" />
+{{#if faviconUrl}}<link rel="icon" href="{{faviconUrl}}" />{{/if}}

package/templates/modern/css/styles.css

@@ -221,16 +221,27 @@ body {
 }
 
 .search-button {
-  border: none;
-  border-radius: 4px;
+  border: 1px solid var(--border);
+  border-radius: 6px;
   padding: 0px 10px;
-  height: 30px;
-  width: 150px;
+  height: 32px;
+  width: 200px;
   display: flex;
   align-items: center;
-  gap: 6px;
+  gap: 8px;
   color: var(--muted-fg);
   background: var(--surface);
+  cursor: pointer;
+  transition: border-color 0.15s ease, color 0.15s ease;
+}
+
+.search-button:hover {
+  border-color: var(--border-hover);
+  color: var(--fg);
+}
+
+.search-button svg {
+  flex-shrink: 0;
 }
 
 .search-button__text {
@@ -241,9 +252,254 @@ body {
 }
 
 .search-button__shortcut {
-  font-size: 11px;
+  font-size: 12px;
   font-weight: 500;
-  opacity: 0.6;
+  padding: 1px 6px;
+  border: 1px solid var(--border);
+  border-radius: 4px;
+  opacity: 0.7;
+}
+
+/* Search modal */
+body.search-open {
+  overflow: hidden;
+}
+
+.search-modal {
+  position: fixed;
+  inset: 0;
+  z-index: 200;
+  display: flex;
+  align-items: flex-start;
+  justify-content: center;
+  padding: 12vh 16px 16px;
+}
+
+.search-modal[hidden] {
+  display: none;
+}
+
+.search-modal__backdrop {
+  position: absolute;
+  inset: 0;
+  background: rgba(0, 0, 0, 0.6);
+  backdrop-filter: blur(2px);
+}
+
+.search-modal__panel {
+  position: relative;
+  display: flex;
+  flex-direction: column;
+  width: min(680px, 100%);
+  max-height: 76vh;
+  background: var(--bg);
+  border: 1px solid var(--border-strong);
+  border-radius: 12px;
+  box-shadow: 0 16px 48px rgba(0, 0, 0, 0.5);
+  overflow: hidden;
+}
+
+.search-modal__panel:focus-within {
+  border-color: var(--link);
+}
+
+.search-modal__header {
+  display: flex;
+  align-items: center;
+  gap: 10px;
+  padding: 14px 16px;
+  border-bottom: 1px solid var(--border);
+}
+
+.search-modal__icon {
+  color: var(--muted-fg);
+  flex-shrink: 0;
+}
+
+.search-modal__input {
+  flex: 1;
+  min-width: 0;
+  border: none;
+  background: transparent;
+  color: var(--fg);
+  font-size: 16px;
+  font-family: inherit;
+  outline: none;
+}
+
+.search-modal__input::placeholder {
+  color: var(--muted-fg);
+}
+
+.search-modal__input::-webkit-search-cancel-button {
+  display: none;
+}
+
+.search-modal__clear {
+  display: flex;
+  align-items: center;
+  justify-content: center;
+  border: none;
+  background: transparent;
+  color: var(--muted-fg);
+  cursor: pointer;
+  padding: 2px;
+  border-radius: 4px;
+}
+
+.search-modal__clear:hover {
+  color: var(--fg);
+  background: var(--surface-hover);
+}
+
+.search-modal__clear[hidden] {
+  display: none;
+}
+
+.search-modal__body {
+  flex: 1;
+  overflow-y: auto;
+  padding: 8px;
+}
+
+.search-results {
+  list-style: none;
+  margin: 0;
+  padding: 0;
+  display: flex;
+  flex-direction: column;
+  gap: 4px;
+}
+
+.search-results[hidden] {
+  display: none;
+}
+
+.search-result__link {
+  display: flex;
+  align-items: flex-start;
+  gap: 12px;
+  padding: 10px 12px;
+  border-radius: 8px;
+  border: 1px solid transparent;
+  color: var(--fg);
+  text-decoration: none;
+}
+
+.search-result--active .search-result__link {
+  background: var(--surface-hover);
+  border-color: var(--border-strong);
+}
+
+.search-result__icon {
+  display: flex;
+  align-items: center;
+  color: var(--muted-fg);
+  margin-top: 2px;
+  flex-shrink: 0;
+}
+
+.search-result--active .search-result__icon {
+  color: var(--link);
+}
+
+.search-result__content {
+  min-width: 0;
+  flex: 1;
+}
+
+.search-result__breadcrumb {
+  font-size: 12px;
+  color: var(--muted-fg);
+  margin-bottom: 2px;
+  white-space: nowrap;
+  overflow: hidden;
+  text-overflow: ellipsis;
+}
+
+.search-result__title {
+  font-size: 15px;
+  font-weight: 600;
+  line-height: 1.3;
+}
+
+.search-result__text {
+  font-size: 13px;
+  color: var(--muted-fg);
+  margin-top: 3px;
+  display: -webkit-box;
+  -webkit-line-clamp: 2;
+  -webkit-box-orient: vertical;
+  overflow: hidden;
+}
+
+.search-result__mark {
+  background: transparent;
+  color: var(--link);
+  font-weight: 700;
+  padding: 0;
+}
+
+.search-modal__empty,
+.search-modal__initial {
+  padding: 28px 16px;
+  text-align: center;
+  color: var(--muted-fg);
+  font-size: 14px;
+}
+
+.search-modal__empty[hidden],
+.search-modal__initial[hidden] {
+  display: none;
+}
+
+.search-modal__footer {
+  display: flex;
+  flex-wrap: wrap;
+  gap: 16px;
+  padding: 10px 16px;
+  border-top: 1px solid var(--border);
+  font-size: 12px;
+  color: var(--muted-fg);
+}
+
+.search-modal__hint {
+  display: flex;
+  align-items: center;
+  gap: 4px;
+}
+
+.search-modal__kbd {
+  display: inline-flex;
+  align-items: center;
+  justify-content: center;
+  min-width: 18px;
+  height: 18px;
+  padding: 0 4px;
+  border: 1px solid var(--border);
+  border-radius: 4px;
+  background: var(--surface);
+  font-size: 11px;
+  font-family: inherit;
+}
+
+@media (max-width: 720px) {
+  .search-button {
+    width: auto;
+  }
+
+  .search-button__text,
+  .search-button__shortcut {
+    display: none;
+  }
+
+  .search-modal {
+    padding: 8vh 10px 10px;
+  }
+
+  .search-modal__footer {
+    display: none;
+  }
 }
 
 .content {
@@ -398,7 +654,7 @@ body {
 .copy-code-btn { position: absolute; top: 8px; right: 8px; padding: 4px; line-height: 0; border-radius: 4px; background: transparent; color: var(--muted); border: none; cursor: pointer; opacity: 0; transition: opacity 0.15s; }
 pre:hover .copy-code-btn { opacity: 1; }
 .copy-code-btn:hover { color: var(--fg); }
-.article__main img, .changelog-entry-body img { cursor: zoom-in; }
+.article__main img:not(a img), .changelog-entry-body img:not(a img) { cursor: zoom-in; }
 .lightbox-overlay { display: none; position: fixed; inset: 0; z-index: 200; background: rgba(0, 0, 0, 0.8); justify-content: center; align-items: center; cursor: pointer; }
 .lightbox-overlay--visible { display: flex !important; }
 .lightbox-overlay img { max-width: 90vw; max-height: 90vh; border-radius: 8px; box-shadow: 0 4px 24px rgba(0, 0, 0, 0.4); cursor: default; }

package/templates/modern/includes/header-bar.hbs

@@ -40,6 +40,13 @@
         {{/if}}
       </nav>
       <div class="header-actions">
+        {{#if enableSearch}}
+        <button class="search-button" id="search-button" type="button" aria-label="Search" aria-keyshortcuts="Meta+K Control+K">
+          <svg xmlns="http://www.w3.org/2000/svg" width="16" height="16" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round"><circle cx="11" cy="11" r="8"/><path d="m21 21-4.3-4.3"/></svg>
+          <span class="search-button__text">Search</span>
+          <span class="search-button__shortcut">⌘K</span>
+        </button>
+        {{/if}}
         {{#if cookieAuth.loginUrl}}
         <div class="cookie-auth">
           <a href="{{cookieAuth.loginUrl}}" class="cookie-auth-btn" id="cookie-auth-login">
@@ -119,3 +126,4 @@
   <div class="mobile-sidebar__docs" id="mobile-sidebar-docs"></div>
 </aside>
 <div class="sidebar-backdrop" id="sidebar-backdrop"></div>
+{{> search }}

package/templates/modern/includes/header.hbs

@@ -22,7 +22,7 @@ j=d.createElement(s),dl=l!='dataLayer'?'&l='+l:'';j.async=true;j.src=
 <link rel="stylesheet" href="{{baseUrl}}/css/variables.css">
 <link rel="stylesheet" href="{{baseUrl}}/css/styles.css">
 <link rel="stylesheet" href="{{baseUrl}}/css/highlight/styles/base16/docula.css">
-<link rel="icon" href="{{baseUrl}}/favicon.ico">
+{{#if faviconUrl}}<link rel="icon" href="{{faviconUrl}}">{{/if}}
 <script>
   (function(){
     window.__doculaThemeKey = 'docula:theme:' + ({{#if siteUrl}}'{{siteUrl}}'{{else}}location.origin{{/if}}).replace(/^https?:\/\//, '');

package/templates/modern/includes/scripts.hbs

@@ -236,10 +236,6 @@
         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);
@@ -255,7 +251,7 @@
 
         const key = 'section-' + idx;
         const hasStored = Object.prototype.hasOwnProperty.call(storedSectionState, key);
-        const isOpen = hasStored ? !!storedSectionState[key] : section === defaultOpenSection;
+        const isOpen = hasStored ? !!storedSectionState[key] : true;
         setSectionOpen(section, toggle, isOpen);
 
         toggle.addEventListener('click', () => {
@@ -324,6 +320,7 @@
     document.body.appendChild(lightboxOverlay);
 
     document.querySelectorAll('.article__main img, .changelog-entry-body img').forEach(function(img) {
+      if (img.closest('a')) return;
       img.addEventListener('click', function() {
         lightboxImg.src = img.src;
         lightboxOverlay.classList.add('lightbox-overlay--visible');

package/templates/modern/includes/search.hbs

@@ -0,0 +1,46 @@
+{{#if enableSearch}}
+<div class="search-modal" id="search-modal" hidden>
+  <div class="search-modal__backdrop" data-search-close></div>
+  <div class="search-modal__panel" role="dialog" aria-modal="true" aria-label="Search">
+    <div class="search-modal__header">
+      <svg class="search-modal__icon" xmlns="http://www.w3.org/2000/svg" width="20" height="20" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round"><circle cx="11" cy="11" r="8"/><path d="m21 21-4.3-4.3"/></svg>
+      <input
+        type="search"
+        id="search-input"
+        class="search-modal__input"
+        placeholder="Search"
+        autocomplete="off"
+        autocorrect="off"
+        autocapitalize="off"
+        spellcheck="false"
+        aria-label="Search"
+        aria-controls="search-results"
+        aria-activedescendant=""
+        role="combobox"
+        aria-expanded="true"
+      />
+      <button class="search-modal__clear" id="search-clear" type="button" aria-label="Clear search" hidden>
+        <svg xmlns="http://www.w3.org/2000/svg" width="18" height="18" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round"><line x1="18" y1="6" x2="6" y2="18"/><line x1="6" y1="6" x2="18" y2="18"/></svg>
+      </button>
+    </div>
+    <div class="search-modal__body">
+      <ul class="search-results" id="search-results" role="listbox" aria-label="Search results"></ul>
+      <div class="search-modal__empty" id="search-empty" hidden>
+        No results for "<span class="search-modal__empty-query" id="search-empty-query"></span>"
+      </div>
+      <div class="search-modal__initial" id="search-initial">
+        Type to search the documentation.
+      </div>
+    </div>
+    <div class="search-modal__footer">
+      <span class="search-modal__hint"><kbd class="search-modal__kbd">↑</kbd><kbd class="search-modal__kbd">↓</kbd> to navigate</span>
+      <span class="search-modal__hint"><kbd class="search-modal__kbd">↵</kbd> to select</span>
+      <span class="search-modal__hint"><kbd class="search-modal__kbd">esc</kbd> to close</span>
+    </div>
+  </div>
+</div>
+<script>
+  window.__doculaSearch = { indexUrl: "{{baseUrl}}/search-index.json" };
+</script>
+<script src="{{baseUrl}}/js/search.js" defer></script>
+{{/if}}