jsdoc-scribe 1.7.0 → 1.11.0

package/CHANGELOG.md

@@ -3,6 +3,138 @@
 All notable changes to `jsdoc-scribe` are documented here.
 Format follows [Keep a Changelog](https://keepachangelog.com/en/1.0.0/).
 
+## [1.11.0] - 2026-06-30
+
+### Changed — Code Quality (Phase D)
+
+**`extractor.js` robustness**
+- Added `sourceFile` null guard: if `ts.createSourceFile()` returns a falsy value the function logs to stderr and returns an empty-but-valid module object instead of throwing.
+- Wrapped the entire `visit(node)` body in `try/catch`: a malformed or unexpected AST node now logs a warning (`jsdoc-scribe: skipped node in <file> — <message>`) and continues visiting sibling nodes instead of aborting the whole module.
+
+**`renderer.js` refactor**
+- Extracted `buildSymbolMap(modules)` from `buildSite()` — builds the `{name → {anchorId, modulePath}}` cross-reference map used by `{@link}` resolution.
+- Extracted `buildIndexBody(modules)` — builds the module-grid HTML block for the index page (previously inlined in `buildSite()`).
+- Extracted `buildModuleBody(mod, sourceUrl, symbolMap)` — builds the sections HTML for a single module page (previously inlined in `buildSite()`).
+- `buildSite()` is now a slim coordinator (~25 lines) delegating to the three helpers above.
+
+**`docs.js` async upgrade**
+- `extractModules(files)` is now `async` and uses `Promise.allSettled`: all files are attempted in parallel; fulfilled results are collected, rejected ones are logged to stderr and skipped.
+- `generateSite(inputPaths, options)` is now `async` accordingly.
+
+---
+
+## [1.10.0] - 2026-06-30
+
+### Added — Test coverage (Phase C)
+
+Expanded `npm test` from 7 tests to **25 tests** across three suites.
+
+**`test/extractor.test.js` — 10 new tests** (exercises `lib/extractor.js`):
+- Module-level `@module` description and `@since` extracted from top-of-file JSDoc
+- `@param` type and description parsed from JSDoc block
+- `@returns` type and description parsed
+- `@since` and `@deprecated` on individual items
+- `@throws` with type and description
+- 1-based source line numbers on all functions (ordered)
+- Class with constructor, methods, properties, and static members
+- Interface with optional properties
+- Enum members and their values
+- Type alias and exported `const` variable
+
+**`test/renderer.test.js` — 8 new tests** (exercises `lib/renderer.js` via mock module objects):
+- `buildSite` returns exactly 3 shared assets + `index.html` + one page per module
+- Search index contains every symbol (function, class) with root-relative URLs
+- Module page includes right-side TOC with `data-anchor` attributes and "On this page" title
+- `@deprecated` badge and notice rendered for deprecated items
+- Source link contains GitHub URL and `#L42` line anchor when `sourceUrl` set
+- `@example` blocks rendered with `tok-kw` syntax-highlighting spans
+- Sidebar symbol tree includes `sym-rows` and kind pills for the active module
+- `{@link Symbol}` in descriptions resolves to `<a class="link-ref">` with `href`
+
+### Fixed — `@description` tag in JSDoc blocks
+
+`parseJSDocBlock()` now recognises `@description <text>` as an alias for the plain-text
+description that precedes the first `@tag`. Previously `@description` was silently discarded as
+an unknown tag, leaving `mod.description === null` for any file that used it (including all
+built-in sample files).
+
+---
+
+## [1.9.0] - 2026-06-30
+
+### Changed — Enterprise HTML Redesign (Phase B)
+
+Complete visual overhaul of the generated documentation site.
+
+**Three-column layout**
+- Left sidebar (272 px) · Center content (flexible) · Right TOC (224 px)
+- CSS Grid replaces the old flexbox layout: `.layout { grid-template-columns: 272px 1fr 224px }`
+- Index page uses two-column grid (no right TOC); module pages use three columns automatically via the `has-toc` class
+
+**Right-side "On this page" TOC**
+- New `buildToc(mod)` function generates a per-section TOC (Functions, Classes, Interfaces, etc.) with every symbol as a clickable anchor
+- `IntersectionObserver` scroll spy in `app.js` tracks which card is on screen and highlights the matching TOC item with an accent-colored left border
+- TOC hides at ≤1280 px viewport width; three columns collapse to two
+
+**Symbol tree in sidebar**
+- Active module expands to show every symbol underneath its file link
+- Each symbol is prefixed with a color-coded pill badge (`fn`, `cls`, `if`, `ty`, `en`, `$`) matching its kind
+- New `.sym-rows`, `.sym-row`, `.sym-pill`, `.sym-link` CSS classes
+
+**Color-coded cards**
+- Each card now has a 3 px left accent border: green=function, blue=class, purple=interface, orange=enum, teal=type alias, gray=variable/const
+- Added `card-fn`, `card-cls`, `card-iface`, `card-enum`, `card-type`, `card-var` CSS classes to all render functions
+
+**Server-side syntax highlighting for `@example` blocks**
+- New `highlightCode(raw)` function in `renderer.js` tokenizes JS/TS code at build time
+- Handles line comments, block comments, strings (single/double/template), numbers, and 40+ keywords
+- Produces `<span class="tok-kw|tok-str|tok-cmt|tok-num">` spans; colors adapt to dark/light theme via CSS vars
+
+**Responsive layout**
+- `@media (max-width: 1280px)`: right TOC hidden, grid collapses to two columns
+- `@media (max-width: 860px)`: sidebar becomes a fixed overlay (off-screen by default), hamburger button appears in the top-left, main content uses mobile padding
+- Hamburger toggle with animated open/close icon (three-bar → X)
+
+**Print styles**
+- `@media print`: sidebar, TOC, hamburger, copy buttons, theme toggle, and search box all hidden
+- Cards get `break-inside: avoid` and a neutral border for clean PDF output
+
+**Section counts**
+- Section headings now show item count: `Functions (3)` using a `.section-count` monospace chip
+
+**Other polish**
+- `html { scroll-behavior: smooth }` for smooth anchor navigation
+- Sidebar active link gets a 2 px accent left border instead of just a background change
+- Card hover adds a subtle box-shadow
+- All `section()` calls updated with count display
+- CSS ~15 KB (up from ~9 KB), app.js ~4 KB (up from ~2.6 KB) — still cached after first load
+
+---
+
+## [1.8.0] - 2026-06-30
+
+### Changed — Performance: Shared Static Assets (Phase A)
+
+Previously every generated HTML page inlined the same 9 KB CSS block, 3 KB client JS, and 34 KB search index. On a 9-page site that wasted 630+ KB of duplicate payload.
+
+- **CSS extracted** to `assets/style.css` — written once per build, shared by all pages via `<link rel="stylesheet">`.
+- **Client JS extracted** to `assets/app.js` — written once, shared via `<script src>`. Browsers cache it after the first page load.
+- **Search index extracted** to `search-index.js` — written once as `window.__SEARCH_INDEX__=[...]`, loaded before `app.js` via `<script src>`. No more 34 KB inline JSON on every page.
+- `app.js` auto-detects its location (`/modules/` in the path) and adjusts search result URLs at runtime, so a single shared index file works for both the index page and all module pages.
+
+### Result
+| Metric | Before | After |
+|---|---|---|
+| Total site size | 628 KB | 225 KB (−64%) |
+| Per-page HTML (avg) | ~70 KB | ~20 KB |
+| Cache benefit (2nd+ page) | ~70 KB reload | ~20 KB reload |
+| Shared assets (loaded once) | — | 46 KB |
+
+### Upgraded — `buildSite()` output
+The return array now includes three additional entries: `{ path: 'assets/style.css', html: '...' }`, `{ path: 'assets/app.js', html: '...' }`, `{ path: 'search-index.js', html: '...' }`. The CLI handles these automatically. Programmatic API users should use `fs.mkdirSync(path.dirname(dest), { recursive: true })` before writing each file (the README example is updated).
+
+---
+
 ## [1.7.0] - 2026-06-29
 
 ### Added

package/README.md

@@ -230,7 +230,20 @@ gen-docs src --out docs --title "My Project"
 # Open docs/index.html in your browser
 ```
 
-The output is a self-contained static site — no server required.
+The output is a self-contained static site — no server required. Output structure:
+
+```
+docs/
+  index.html          # project index (module cards)
+  search-index.js     # shared search index (fetched once)
+  assets/
+    style.css         # shared CSS — cached after first page load
+    app.js            # shared JS (search, theme toggle, copy)
+  modules/
+    api.html
+    utils.html
+    ...
+```
 
 ### CLI flags
 
@@ -349,13 +362,19 @@ const {
 
 ```js
 const { generateSite } = require('jsdoc-scribe/docs');
+const fs = require('fs'), path = require('path');
 
-generateSite(['src'], {
-  out: 'docs',
-  title: 'My Project',
-  theme: 'default',
-  sourceUrl: 'https://github.com/org/repo/blob/main',
+const pages = generateSite(['src'], {
+  projectName: 'My Project',
+  version: '1.0.0',
 });
+
+// pages = [{ path: 'index.html', html }, { path: 'assets/style.css', html }, ...]
+for (const p of pages) {
+  const dest = path.join('docs', p.path);
+  fs.mkdirSync(path.dirname(dest), { recursive: true });
+  fs.writeFileSync(dest, p.html, 'utf8');
+}
 ```
 
 ### Step-by-step
@@ -390,13 +409,15 @@ const pages = buildSite(modules, {
   sourceUrl: 'https://github.com/org/repo/blob/main',
 });
 
-// 5. Write pages yourself
+// 5. Write all files
+// pages = [{ path, html }] and includes HTML pages + shared assets:
+//   assets/style.css, assets/app.js, search-index.js
+// Always use mkdirSync so assets/ and modules/ are created automatically.
 const outDir = 'docs';
-fs.mkdirSync(outDir, { recursive: true });
-for (const [filePath, html] of Object.entries(pages)) {
-  const dest = path.join(outDir, filePath);
+for (const p of pages) {
+  const dest = path.join(outDir, p.path);
   fs.mkdirSync(path.dirname(dest), { recursive: true });
-  fs.writeFileSync(dest, html);
+  fs.writeFileSync(dest, p.html, 'utf8');
 }
 ```
 

package/lib/docs.js

@@ -1,71 +1,57 @@
 "use strict";
 
-/**
- * jsdoc-scribe/docs — programmatic API
- *
- * Use this when you want to drive jsdoc-scribe from Node code rather than
- * the CLI. All lower-level pieces are also exported so you can build a
- * custom renderer on top of the same extraction pipeline.
- *
- * @example
- * const { extractModule, buildSite, collectFiles } = require('jsdoc-scribe/docs');
- *
- * const files = collectFiles('./src');
- * const modules = files.map(f => extractModule(f));
- * const pages = buildSite(modules, { projectName: 'My API', version: '1.0.0' });
- *
- * // pages is [{ path: 'index.html', html: '...' }, { path: 'modules/...html', html: '...' }]
- * pages.forEach(p => require('fs').writeFileSync(require('path').join('./docs', p.path), p.html));
- */
-
 const { collectFiles, DEFAULT_EXTENSIONS, DEFAULT_IGNORE_DIRS } = require("./index.js");
 const { extractModule } = require("./extractor.js");
 const { buildSite, moduleLabel, moduleHtmlPath } = require("./renderer.js");
 
 /**
- * Extract structured documentation from every file in an array.
- * Skips files that fail to parse and logs the error to stderr.
- * @param {string[]} files - absolute or relative file paths
- * @returns {object[]} array of module models (same shape as extractModule())
+ * Extract documentation models from an array of file paths.
+ * All files are attempted; failures are logged to stderr and omitted from results.
+ * Uses Promise.allSettled so a single bad file never aborts the batch.
+ *
+ * @param {string[]} files
+ * @returns {Promise<object[]>}
  */
-function extractModules(files) {
+async function extractModules(files) {
+    const results = await Promise.allSettled(
+        files.map(f => Promise.resolve().then(() => extractModule(f)))
+    );
     const modules = [];
-    for (const file of files) {
-        try {
-            modules.push(extractModule(file));
-        } catch (err) {
-            process.stderr.write(`jsdoc-scribe/docs: skipped ${file} — ${err.message}\n`);
+    for (let i = 0; i < results.length; i++) {
+        const r = results[i];
+        if (r.status === "fulfilled") {
+            modules.push(r.value);
+        } else {
+            process.stderr.write("jsdoc-scribe/docs: skipped " + files[i] + ": " + r.reason.message + "\n");
         }
     }
     return modules;
 }
 
 /**
- * One-shot: collect files, extract docs, build site, return pages.
- * @param {string|string[]} inputPaths - file or directory paths to scan
- * @param {{ projectName?: string, version?: string, extensions?: string[], ignoreDirs?: Set<string> }} [options]
- * @returns {{ path: string, html: string }[]}
+ * One-shot convenience: collect files, extract docs, build HTML site.
+ *
+ * @param {string|string[]} inputPaths  Source file or directory paths
+ * @param {object} [options]            Same options as buildSite()
+ * @returns {Promise<Array<{path:string,html:string}>>}
  */
-function generateSite(inputPaths, options) {
+async function generateSite(inputPaths, options) {
     const paths = Array.isArray(inputPaths) ? inputPaths : [inputPaths];
     const opts = options || {};
     const files = [].concat(...paths.map(p => collectFiles(p, opts.extensions, opts.ignoreDirs)));
     const unique = [...new Set(files)];
-    const modules = extractModules(unique);
+    const modules = await extractModules(unique);
     return buildSite(modules, { projectName: opts.projectName, version: opts.version });
 }
 
 module.exports = {
-    // Core pipeline
     collectFiles,
     extractModule,
     extractModules,
     buildSite,
     generateSite,
-    // Helpers
     moduleLabel,
     moduleHtmlPath,
-    // Constants
     DEFAULT_EXTENSIONS,
     DEFAULT_IGNORE_DIRS,
 };

package/lib/extractor.js

@@ -159,6 +159,10 @@ function parseJSDocBlock(raw) {
         } else if (/^@deprecated\b/.test(line)) {
             inExample = false;
             deprecated = line.slice("@deprecated".length).trim() || "";
+        } else if (/^@description\b/.test(line)) {
+            inExample = false;
+            const descText = line.slice("@description".length).trim();
+            if (descText) descLines.push(descText);
         } else if (/^@\w/.test(line)) {
             inExample = false;
         } else if (inExample) {
@@ -395,10 +399,15 @@ function extractModule(filePath) {
     const sourceText = fs.readFileSync(filePath, "utf8");
     const sourceFile = ts.createSourceFile(filePath, sourceText, ts.ScriptTarget.Latest, true, getScriptKind(filePath));
 
+    if (!sourceFile) {
+        process.stderr.write("jsdoc-scribe: could not parse " + filePath + "\n");
+        return { filePath, moduleName: null, description: null, since: null, functions: [], classes: [], interfaces: [], typeAliases: [], enums: [], variables: [] };
+    }
     const moduleDoc = extractModuleDoc(sourceFile);
     const result = { filePath, moduleName: moduleDoc.moduleName, description: moduleDoc.description, since: moduleDoc.since, functions: [], classes: [], interfaces: [], typeAliases: [], enums: [], variables: [] };
 
     function visit(node) {
+        try {
         if (ts.isFunctionDeclaration(node) && node.body && node.name) {
             result.functions.push(extractFunction(node, sourceFile));
         } else if (ts.isClassDeclaration(node)) {
@@ -446,6 +455,9 @@ function extractModule(filePath) {
                 }
             }
         }
+        } catch (err) {
+            process.stderr.write("jsdoc-scribe: skipped node in " + filePath + " — " + err.message + "\n");
+        }
         ts.forEachChild(node, visit);
     }
 

package/lib/renderer.js

@@ -8,7 +8,7 @@ const path = require("path");
 
 const THEMES = {
     default: {
-        light: `:root{--bg:#f8f9fc;--surface:#fff;--border:#e0e4f0;--text:#1a1a2e;--text2:#666;--text3:#888;--sidebar-bg:#1a1a2e;--sidebar-text:#c8d3f0;--sidebar-active:#2d2d4e;--sidebar-title:#7986cb;--accent:#4361ee;--accent2:#e8eaf6;--search-bg:#2d2d4e;--search-border:#3a3a5e;--search-text:#e0e4f8;--search-panel:#252543;--th-bg:#f5f6fa;--code-bg:#f5f6fa;--sub-label:#7986cb;--method-border:#f0f0f0;--dep-bg:#fff8e1;--dep-text:#e65100;--throws-bg:#fce4ec;--throws-text:#c62828}`,
+        light: `:root{--bg:#f8f9fc;--surface:#fff;--border:#e0e4f0;--text:#1a1a2e;--text2:#555;--text3:#888;--sidebar-bg:#1a1a2e;--sidebar-text:#c8d3f0;--sidebar-active:#2d2d4e;--sidebar-title:#7986cb;--accent:#4361ee;--accent2:#e8eaf6;--search-bg:#2d2d4e;--search-border:#3a3a5e;--search-text:#e0e4f8;--search-panel:#252543;--th-bg:#f5f6fa;--code-bg:#f5f6fa;--sub-label:#7986cb;--method-border:#f0f0f0;--dep-bg:#fff8e1;--dep-text:#e65100;--throws-bg:#fce4ec;--throws-text:#c62828}`,
         dark: `[data-theme=dark]{--bg:#0f0f1a;--surface:#1a1a2e;--border:#2d2d4e;--text:#e0e4f8;--text2:#9aa5c8;--text3:#5a6494;--sidebar-bg:#0a0a14;--sidebar-text:#9aa5c8;--sidebar-active:#1a1a2e;--sidebar-title:#5a6494;--accent:#6b8cff;--accent2:#1a1f3a;--search-bg:#1a1a2e;--search-border:#2d2d4e;--search-text:#c8d3f0;--search-panel:#0f0f1a;--th-bg:#1a1a2e;--code-bg:#1a1a2e;--sub-label:#5a6494;--method-border:#2d2d4e;--dep-bg:#2d2000;--dep-text:#ffb300;--throws-bg:#2d0a14;--throws-text:#ef9a9a}`,
         toggleBtn: true,
     },
@@ -25,26 +25,37 @@ const THEMES = {
 };
 
 // ---------------------------------------------------------------------------
-// CSS (shared structural rules; colors come from theme vars above)
+// CSS — layout, components, responsive, print
 // ---------------------------------------------------------------------------
 
 const CSS_STRUCTURE = `
+/* == Reset & base == */
 *,*::before,*::after{box-sizing:border-box;margin:0;padding:0}
+html{scroll-behavior:smooth}
 body{font-family:-apple-system,BlinkMacSystemFont,'Segoe UI',Roboto,sans-serif;font-size:15px;line-height:1.6;color:var(--text);background:var(--bg);transition:background .2s,color .2s}
-a{color:var(--accent);text-decoration:none}a:hover{text-decoration:underline}
+a{color:var(--accent);text-decoration:none}
+a:hover{text-decoration:underline}
 code,pre{font-family:'SFMono-Regular',Consolas,'Liberation Mono',Menlo,monospace}
-.layout{display:flex;min-height:100vh}
-.sidebar{width:272px;min-width:272px;background:var(--sidebar-bg);color:var(--sidebar-text);padding:0;display:flex;flex-direction:column;position:sticky;top:0;height:100vh;overflow-y:auto}
-.sidebar-header{padding:18px 20px 12px;display:flex;align-items:flex-start;justify-content:space-between;gap:8px}
-.sidebar-header a{color:var(--text);font-size:15px;font-weight:700}
-.sidebar-header .version{display:block;font-size:11px;color:var(--sidebar-title);margin-top:2px}
-.theme-btn{background:none;border:1px solid var(--search-border);border-radius:5px;padding:3px 8px;font-size:12px;color:var(--sidebar-text);cursor:pointer;white-space:nowrap;flex-shrink:0;margin-top:2px}
+
+/* == Three-column layout == */
+.layout{display:grid;grid-template-columns:272px 1fr;min-height:100vh}
+.layout.has-toc{grid-template-columns:272px 1fr 224px}
+
+/* == Left sidebar == */
+.sidebar{grid-column:1;background:var(--sidebar-bg);color:var(--sidebar-text);position:sticky;top:0;height:100vh;overflow-y:auto;display:flex;flex-direction:column;border-right:1px solid rgba(255,255,255,.06)}
+.sidebar-header{padding:16px 14px 12px;display:flex;align-items:flex-start;justify-content:space-between;gap:8px;border-bottom:1px solid var(--search-border);flex-shrink:0}
+.sidebar-header a{color:var(--sidebar-text);font-size:14px;font-weight:700;letter-spacing:-.01em}
+.sidebar-header .version{display:block;font-size:11px;color:var(--sidebar-title);margin-top:2px;font-family:monospace}
+.theme-btn{background:none;border:1px solid var(--search-border);border-radius:4px;padding:2px 7px;font-size:11px;color:var(--sidebar-text);cursor:pointer;white-space:nowrap;flex-shrink:0;margin-top:2px}
 .theme-btn:hover{background:var(--sidebar-active)}
-.search-wrap{position:relative;padding:0 14px 12px;border-bottom:1px solid var(--search-border)}
-.search-box{width:100%;background:var(--search-bg);border:1px solid var(--search-border);border-radius:6px;padding:7px 10px 7px 32px;color:var(--search-text);font-size:13px;outline:none}
+
+/* == Search == */
+.search-wrap{position:relative;padding:10px 12px;border-bottom:1px solid var(--search-border);flex-shrink:0}
+.search-icon{position:absolute;left:20px;top:50%;transform:translateY(-50%);width:14px;height:14px;opacity:.5;pointer-events:none}
+.search-box{width:100%;background:var(--search-bg);border:1px solid var(--search-border);border-radius:6px;padding:6px 10px 6px 30px;color:var(--search-text);font-size:13px;outline:none}
 .search-box::placeholder{color:var(--sidebar-title)}
 .search-box:focus{border-color:var(--accent)}
-.search-results{display:none;position:absolute;left:14px;right:14px;background:var(--search-panel);border:1px solid var(--search-border);border-radius:6px;max-height:320px;overflow-y:auto;z-index:100;margin-top:2px}
+.search-results{display:none;position:absolute;left:12px;right:12px;background:var(--search-panel);border:1px solid var(--search-border);border-radius:6px;max-height:320px;overflow-y:auto;z-index:100;margin-top:2px;box-shadow:0 4px 20px rgba(0,0,0,.18)}
 .search-results.visible{display:block}
 .search-result-item{display:block;padding:8px 12px;cursor:pointer;border-bottom:1px solid var(--search-border);text-decoration:none}
 .search-result-item:hover{background:var(--sidebar-active)}
@@ -52,31 +63,65 @@ code,pre{font-family:'SFMono-Regular',Consolas,'Liberation Mono',Menlo,monospace
 .sr-kind{font-size:11px;color:var(--sidebar-title);margin-left:6px}
 .sr-module{font-size:11px;color:var(--sidebar-title);display:block;margin-top:1px;opacity:.7}
 .search-no-results{padding:10px 12px;color:var(--sidebar-title);font-size:13px}
-.sidebar-section{padding:10px 0 4px}
-.sidebar-section-title{padding:4px 20px;font-size:11px;font-weight:700;text-transform:uppercase;letter-spacing:.08em;color:var(--sidebar-title)}
-.sidebar-link{display:block;padding:5px 20px;font-size:13px;color:var(--sidebar-text);transition:background .1s}
-.sidebar-link:hover,.sidebar-link.active{background:var(--sidebar-active);color:var(--text);text-decoration:none}
-.sidebar-dir-toggle{display:flex;align-items:center;gap:4px;cursor:pointer;list-style:none;padding:5px 20px;font-size:11px;font-weight:700;text-transform:uppercase;letter-spacing:.06em;color:var(--sidebar-title);user-select:none}
+.sr-preview{font-size:11px;color:var(--text3);font-style:italic;display:block;margin-top:2px}
+
+/* == Sidebar tree == */
+.sidebar-section{padding:4px 0 12px;flex:1;overflow-y:auto}
+.sidebar-section-title{padding:10px 14px 4px;font-size:10px;font-weight:700;text-transform:uppercase;letter-spacing:.1em;color:var(--sidebar-title)}
+.sidebar-link{display:block;padding:4px 14px;font-size:13px;color:var(--sidebar-text);transition:background .1s;white-space:nowrap;overflow:hidden;text-overflow:ellipsis}
+.sidebar-link:hover{background:var(--sidebar-active);color:var(--text);text-decoration:none}
+.sidebar-link.active{background:var(--sidebar-active);color:var(--text);text-decoration:none;border-left:2px solid var(--accent);padding-left:12px}
+.sidebar-dir-toggle{display:flex;align-items:center;gap:5px;cursor:pointer;list-style:none;padding:4px 14px;font-size:11px;font-weight:700;text-transform:uppercase;letter-spacing:.06em;color:var(--sidebar-title);user-select:none}
 .sidebar-dir-toggle::-webkit-details-marker{display:none}
-.sidebar-dir-toggle::before{content:'▶';font-size:8px;transition:transform .15s}
+.sidebar-dir-toggle::before{content:'▶';font-size:8px;transition:transform .15s;flex-shrink:0}
 details[open] .sidebar-dir-toggle::before{transform:rotate(90deg)}
-.sidebar-link-indent{padding-left:32px}
-.main{flex:1;padding:40px 48px;max-width:960px}
-.page-title{font-size:28px;font-weight:700;color:var(--text);margin-bottom:4px}
-.page-subtitle{color:var(--text2);font-size:13px;margin-bottom:12px}
-.module-desc{color:var(--text2);font-size:14px;line-height:1.6;margin-bottom:28px;max-width:700px}
-.section{margin-bottom:40px}
-.section-title{font-size:18px;font-weight:700;color:var(--text);margin-bottom:14px;padding-bottom:8px;border-bottom:2px solid var(--accent2)}
-.card{background:var(--surface);border:1px solid var(--border);border-radius:8px;padding:18px 22px;margin-bottom:10px;scroll-margin-top:24px}
-.card-header{display:flex;align-items:flex-start;justify-content:space-between;gap:8px}
-.card-name{font-size:15px;font-weight:700;color:var(--text);font-family:monospace}
-.card-sig{font-size:12px;color:var(--text2);margin-top:3px;font-family:monospace;word-break:break-all}
-.card-desc{font-size:13px;color:var(--text2);margin-top:8px;line-height:1.5}
-.card-example{margin-top:10px}
-.card-example pre{background:var(--code-bg);border:1px solid var(--border);border-radius:6px;padding:10px 14px;font-size:12px;overflow-x:auto;color:var(--text)}
+.sidebar-link-indent{padding-left:26px}
+.sidebar-link-indent.active{padding-left:24px}
+
+/* Symbol rows under active module */
+.sym-rows{padding:2px 0 6px}
+.sym-row{display:flex;align-items:center;gap:5px;padding:2px 12px 2px 36px;min-width:0}
+.sym-pill{font-size:9px;font-weight:700;padding:1px 4px;border-radius:3px;font-family:monospace;flex-shrink:0;letter-spacing:.01em;line-height:1.4}
+.sym-fn{background:#1b3a1e;color:#81c784}
+.sym-cls{background:#0d2137;color:#64b5f6}
+.sym-iface{background:#1a0a2e;color:#ce93d8}
+.sym-enum{background:#2d1500;color:#ffb74d}
+.sym-type{background:#00211f;color:#4db6ac}
+.sym-var{background:#1f1f1f;color:#9e9e9e}
+[data-theme=light] .sym-fn,[data-theme=default] .sym-fn,.sym-fn{background:#1b3a1e;color:#81c784}
+.sym-link{font-size:12px;color:var(--sidebar-text);text-decoration:none;overflow:hidden;text-overflow:ellipsis;white-space:nowrap;min-width:0;opacity:.85}
+.sym-link:hover{color:var(--text);opacity:1;text-decoration:none}
+.sym-link.active{color:var(--accent);opacity:1;font-weight:600}
+
+/* == Main content area == */
+.main{padding:40px 48px 80px;min-width:0;overflow-x:hidden}
+.page-title{font-size:26px;font-weight:700;color:var(--text);margin-bottom:4px;letter-spacing:-.02em}
+.page-subtitle{color:var(--text2);font-size:12px;margin-bottom:16px;font-family:monospace}
+.module-desc{color:var(--text2);font-size:14px;line-height:1.7;margin-bottom:28px;max-width:700px}
+.section{margin-bottom:44px}
+.section-title{font-size:16px;font-weight:700;color:var(--text);margin-bottom:14px;padding-bottom:8px;border-bottom:2px solid var(--accent2);display:flex;align-items:center;gap:8px}
+.section-count{font-size:12px;font-weight:400;color:var(--text3);font-family:monospace}
+
+/* == Cards == */
+.card{background:var(--surface);border:1px solid var(--border);border-left:3px solid var(--border);border-radius:8px;padding:18px 20px 16px;margin-bottom:10px;scroll-margin-top:24px;transition:box-shadow .15s,border-left-color .15s}
+.card:hover{box-shadow:0 2px 12px rgba(0,0,0,.08)}
+.card-fn{border-left-color:#43a047}
+.card-cls{border-left-color:#1e88e5}
+.card-iface{border-left-color:#8e24aa}
+.card-enum{border-left-color:#fb8c00}
+.card-type{border-left-color:#00897b}
+.card-var{border-left-color:#757575}
+.card-header{display:flex;align-items:flex-start;justify-content:space-between;gap:8px;margin-bottom:2px}
+.card-name{font-size:15px;font-weight:700;color:var(--text);font-family:monospace;display:flex;align-items:center;gap:4px;flex-wrap:wrap}
+.card-sig{font-size:12px;color:var(--text2);margin-top:3px;font-family:monospace;word-break:break-all;line-height:1.5}
+.card-desc{font-size:13px;color:var(--text2);margin-top:8px;line-height:1.6}
+.card-example{margin-top:12px}
+.card-example pre{background:var(--code-bg);border:1px solid var(--border);border-radius:6px;padding:12px 16px;font-size:12px;overflow-x:auto;color:var(--text);line-height:1.6;tab-size:2}
 .copy-btn{flex-shrink:0;background:none;border:1px solid var(--border);border-radius:5px;padding:3px 8px;font-size:11px;color:var(--text3);cursor:pointer;transition:all .15s;white-space:nowrap}
 .copy-btn:hover{background:var(--accent2);border-color:var(--accent);color:var(--accent)}
 .copy-btn.copied{background:#e8f5e9;border-color:#43a047;color:#2e7d32}
+
+/* == Badges == */
 .badge{display:inline-block;padding:2px 7px;border-radius:4px;font-size:11px;font-weight:600;margin-right:3px;margin-top:5px}
 .badge-exported{background:#e8f5e9;color:#2e7d32}
 .badge-async{background:#e3f2fd;color:#1565c0}
@@ -94,6 +139,8 @@ details[open] .sidebar-dir-toggle::before{transform:rotate(90deg)}
 .badge-since{background:#e8f5e9;color:#2e7d32}
 .deprecated-notice{background:var(--dep-bg);color:var(--dep-text);border-radius:5px;padding:6px 12px;font-size:12px;margin-top:8px}
 .since-label{font-size:11px;color:var(--text3);margin-top:4px}
+
+/* == Tables == */
 .throws-table{width:100%;border-collapse:collapse;margin-top:8px;font-size:13px;border:1px solid var(--throws-bg)}
 .throws-table th{text-align:left;padding:5px 10px;background:var(--throws-bg);color:var(--throws-text);font-weight:600;font-size:12px}
 .throws-table td{padding:5px 10px;border-top:1px solid var(--border);color:var(--text);vertical-align:top}
@@ -104,6 +151,8 @@ details[open] .sidebar-dir-toggle::before{transform:rotate(90deg)}
 .params-table td code{background:var(--code-bg);padding:1px 5px;border-radius:3px;font-size:12px}
 .returns{margin-top:8px;font-size:13px;color:var(--text2)}
 .returns code{background:var(--code-bg);padding:1px 6px;border-radius:3px;font-family:monospace}
+
+/* == Collapsible sections == */
 .collapse-toggle{display:flex;align-items:center;gap:6px;cursor:pointer;user-select:none;list-style:none;margin-top:14px;font-size:12px;font-weight:700;text-transform:uppercase;letter-spacing:.06em;color:var(--sub-label);padding:0}
 .collapse-toggle::-webkit-details-marker{display:none}
 .collapse-toggle::before{content:'▶';font-size:9px;display:inline-block;transition:transform .15s;color:var(--sub-label)}
@@ -112,30 +161,88 @@ details[open] .collapse-toggle::before{transform:rotate(90deg)}
 .method-row{margin-top:8px;padding:10px 0;border-top:1px solid var(--method-border)}
 .method-sig{font-family:monospace;font-size:13px;color:var(--text)}
 .method-desc{font-size:12px;color:var(--text2);margin-top:4px}
-.module-grid{display:grid;grid-template-columns:repeat(auto-fill,minmax(240px,1fr));gap:10px;margin-top:4px}
-.module-card{background:var(--surface);border:1px solid var(--border);border-radius:8px;padding:16px 20px;transition:border-color .15s,box-shadow .15s}
-.module-card:hover{border-color:var(--accent);box-shadow:0 2px 8px rgba(67,97,238,.1);text-decoration:none}
-.module-card-name{font-size:14px;font-weight:700;color:var(--text);font-family:monospace}
-.module-card-stats{font-size:12px;color:var(--text3);margin-top:4px}
+
+/* == Module index grid == */
+.module-grid{display:grid;grid-template-columns:repeat(auto-fill,minmax(260px,1fr));gap:10px;margin-top:4px}
+.module-card{background:var(--surface);border:1px solid var(--border);border-radius:8px;padding:16px 20px;transition:border-color .15s,box-shadow .15s;display:block}
+.module-card:hover{border-color:var(--accent);box-shadow:0 2px 12px rgba(67,97,238,.1);text-decoration:none}
+.module-card-name{font-size:14px;font-weight:700;color:var(--text);font-family:monospace;display:flex;align-items:center;gap:6px;flex-wrap:wrap;margin-bottom:4px}
+.module-card-stats{font-size:12px;color:var(--text3)}
 .module-card-desc{font-size:12px;color:var(--text3);margin-top:6px;line-height:1.4}
+
+/* == Breadcrumb == */
 .breadcrumb{font-size:13px;color:var(--text3);margin-bottom:20px}
 .breadcrumb a{color:var(--accent)}
+
+/* == Misc == */
 .anchor-link{color:var(--sidebar-title);opacity:0;font-size:13px;margin-left:6px;transition:opacity .15s}
 .card:hover .anchor-link{opacity:.6}
 .anchor-link:hover{opacity:1;text-decoration:none}
 .empty{color:var(--text3);font-size:13px;font-style:italic}
 .link-ref{color:var(--accent);text-decoration:none;font-size:inherit}
 .link-ref:hover{text-decoration:underline}
-.sr-body{font-size:11px;color:var(--sidebar-title);display:block;margin-top:2px;white-space:nowrap;overflow:hidden;text-overflow:ellipsis;max-width:220px}
-.sr-preview{font-size:11px;color:var(--text3);font-style:italic;display:block;margin-top:2px}
-
 .source-link{font-size:11px;color:var(--text3);font-family:monospace;text-decoration:none;margin-left:6px;opacity:.7}
 .source-link:hover{opacity:1;text-decoration:underline;color:var(--accent)}
 
+/* == Right TOC == */
+.toc{grid-column:3;position:sticky;top:0;height:100vh;overflow-y:auto;padding:40px 16px 40px 20px;border-left:1px solid var(--border);background:var(--bg)}
+.toc-title{font-size:11px;font-weight:700;text-transform:uppercase;letter-spacing:.1em;color:var(--text3);margin-bottom:14px}
+.toc-section{margin-bottom:14px}
+.toc-section-label{font-size:11px;font-weight:600;color:var(--text2);margin-bottom:4px;padding-bottom:3px;border-bottom:1px solid var(--border)}
+.toc-item{display:block;font-size:12px;color:var(--text3);text-decoration:none;padding:3px 0 3px 8px;border-left:2px solid transparent;transition:color .1s,border-left-color .1s;white-space:nowrap;overflow:hidden;text-overflow:ellipsis;line-height:1.5}
+.toc-item:hover{color:var(--text);border-left-color:var(--border);text-decoration:none}
+.toc-item.active{color:var(--accent);border-left-color:var(--accent);font-weight:600}
+.toc-dep{font-size:9px;color:var(--dep-text);margin-left:3px;font-weight:700;vertical-align:middle}
+
+/* == Hamburger (mobile only) == */
+.hamburger{display:none;flex-direction:column;gap:5px;background:var(--sidebar-bg);border:none;padding:8px 10px;cursor:pointer;position:fixed;top:10px;left:10px;z-index:300;border-radius:6px;box-shadow:0 2px 8px rgba(0,0,0,.2)}
+.hamburger span{width:20px;height:2px;background:var(--sidebar-text);border-radius:2px;display:block;transition:all .2s}
+.hamburger.open span:nth-child(1){transform:translateY(7px) rotate(45deg)}
+.hamburger.open span:nth-child(2){opacity:0}
+.hamburger.open span:nth-child(3){transform:translateY(-7px) rotate(-45deg)}
+
+/* == Code token highlighting == */
+.tok-kw{color:#6b8cff;font-weight:600}
+.tok-str{color:#2e7d32}
+.tok-cmt{color:#888;font-style:italic}
+.tok-num{color:#e65100}
+.tok-type{color:#6a1b9a}
+[data-theme=dark] .tok-kw{color:#89b4ff}
+[data-theme=dark] .tok-str{color:#a8d5a2}
+[data-theme=dark] .tok-cmt{color:#5a6494}
+[data-theme=dark] .tok-num{color:#ffb74d}
+[data-theme=dark] .tok-type{color:#ce93d8}
+
+/* == Responsive == */
+@media (max-width:1280px){
+  .toc{display:none}
+  .layout.has-toc{grid-template-columns:272px 1fr}
+}
+@media (max-width:860px){
+  .layout,.layout.has-toc{grid-template-columns:1fr}
+  .sidebar{position:fixed;top:0;left:0;height:100vh;z-index:200;transform:translateX(-100%);transition:transform .25s ease}
+  .sidebar.open{transform:translateX(0);box-shadow:4px 0 24px rgba(0,0,0,.28)}
+  .hamburger{display:flex}
+  .main{padding:56px 20px 60px}
+}
+
+/* == Print == */
+@media print{
+  .sidebar,.toc,.hamburger,.copy-btn,.theme-btn,.search-wrap,.anchor-link{display:none!important}
+  .layout,.layout.has-toc{grid-template-columns:1fr!important;display:block}
+  .main{padding:0}
+  .card{break-inside:avoid;border:1px solid #ccc;border-left:3px solid #999!important;margin-bottom:16px;box-shadow:none}
+}
 `;
 
+// ---------------------------------------------------------------------------
+// App JS (written to assets/app.js)
+// ---------------------------------------------------------------------------
+
 const CLIENT_JS = `
 (function(){
+  var _pfx=(window.location.pathname.replace(/\\/g,'/').indexOf('/modules/')!==-1)?'../':'';
+  // Theme
   var THEME_KEY='jsdoc-scribe-theme';
   var saved=localStorage.getItem(THEME_KEY);
   if(saved) document.documentElement.setAttribute('data-theme',saved);
@@ -150,6 +257,7 @@ const CLIENT_JS = `
       btn.textContent=next==='dark'?'Light':'Dark';
     });
   }
+  // Copy button
   document.addEventListener('click',function(e){
     var b=e.target.closest('.copy-btn');
     if(!b) return;
@@ -158,33 +266,66 @@ const CLIENT_JS = `
       setTimeout(function(){b.textContent='Copy';b.classList.remove('copied');},1500);
     });
   });
-  var INDEX=window.__SEARCH_INDEX__||[];
+  // Search
+  var INDEX=(window.__SEARCH_INDEX__||[]).map(function(r){return{name:r.name,kind:r.kind,module:r.module,body:r.body,url:_pfx+r.url};});
   var box=document.getElementById('search-box');
   var panel=document.getElementById('search-results');
-  if(!box||!panel) return;
-  function esc(s){return String(s).replace(/&/g,'&amp;').replace(/</g,'&lt;').replace(/>/g,'&gt;');}
-  function render(items){
-    panel.innerHTML=items.length
-      ?items.slice(0,20).map(function(r){return'<a class="search-result-item" href="'+r.url+'"><span class="sr-name">'+esc(r.name)+'</span><span class="sr-kind">'+esc(r.kind)+'</span><span class="sr-module">'+esc(r.module)+'</span>+(r.body?'<span class="sr-preview">'+esc(r.body.slice(0,80))+'</span>':'')+'</a>';}).join('')
-      :'<div class="search-no-results">No results</div>';
-    panel.classList.add('visible');
+  if(box&&panel){
+    function esc(s){return String(s).replace(/&/g,'&amp;').replace(/</g,'&lt;').replace(/>/g,'&gt;');}
+    function render(items){
+      panel.innerHTML=items.length
+        ?items.slice(0,20).map(function(r){return'<a class="search-result-item" href="'+r.url+'"><span class="sr-name">'+esc(r.name)+'</span><span class="sr-kind">'+esc(r.kind)+'</span><span class="sr-module">'+esc(r.module)+'</span>'+(r.body?'<span class="sr-preview">'+esc(r.body.slice(0,80))+'</span>':'')+'</a>';}).join('')
+        :'<div class="search-no-results">No results</div>';
+      panel.classList.add('visible');
+    }
+    function search(q){
+      q=q.trim().toLowerCase();
+      if(!q){panel.classList.remove('visible');return;}
+      render(INDEX.filter(function(r){
+        return r.name.toLowerCase().includes(q)||r.module.toLowerCase().includes(q)||(r.body&&r.body.toLowerCase().includes(q));
+      }));
+    }
+    box.addEventListener('input',function(){search(box.value);});
+    box.addEventListener('focus',function(){if(box.value.trim())search(box.value);});
+    document.addEventListener('click',function(e){if(!box.contains(e.target)&&!panel.contains(e.target))panel.classList.remove('visible');});
+    document.addEventListener('keydown',function(e){
+      if((e.metaKey||e.ctrlKey)&&e.key==='k'){e.preventDefault();box.focus();box.select();}
+      if(e.key==='Escape')panel.classList.remove('visible');
+    });
   }
-  function search(q){
-    q=q.trim().toLowerCase();
-    if(!q){panel.classList.remove('visible');return;}
-    render(INDEX.filter(function(r){
-      return r.name.toLowerCase().includes(q)
-        ||r.module.toLowerCase().includes(q)
-        ||(r.body&&r.body.toLowerCase().includes(q));
-    }));
+  // Right TOC scroll spy via IntersectionObserver
+  var toc=document.getElementById('toc');
+  if(toc&&typeof IntersectionObserver!=='undefined'){
+    var cards=document.querySelectorAll('.card[id]');
+    var tocLinks={};
+    toc.querySelectorAll('[data-anchor]').forEach(function(a){tocLinks[a.dataset.anchor]=a;});
+    var current='';
+    var obs=new IntersectionObserver(function(entries){
+      entries.forEach(function(e){
+        if(e.isIntersecting){
+          if(current&&tocLinks[current])tocLinks[current].classList.remove('active');
+          current=e.target.id;
+          if(tocLinks[current])tocLinks[current].classList.add('active');
+        }
+      });
+    },{rootMargin:'-10% 0px -70% 0px',threshold:0});
+    cards.forEach(function(c){obs.observe(c);});
+  }
+  // Mobile hamburger
+  var hamburger=document.getElementById('hamburger');
+  var sidebar=document.querySelector('.sidebar');
+  if(hamburger&&sidebar){
+    hamburger.addEventListener('click',function(){
+      var open=sidebar.classList.toggle('open');
+      hamburger.classList.toggle('open',open);
+    });
+    document.addEventListener('click',function(e){
+      if(sidebar.classList.contains('open')&&!sidebar.contains(e.target)&&!hamburger.contains(e.target)){
+        sidebar.classList.remove('open');
+        hamburger.classList.remove('open');
+      }
+    });
   }
-  box.addEventListener('input',function(){search(box.value);});
-  box.addEventListener('focus',function(){if(box.value.trim())search(box.value);});
-  document.addEventListener('click',function(e){if(!box.contains(e.target)&&!panel.contains(e.target))panel.classList.remove('visible');});
-  document.addEventListener('keydown',function(e){
-    if((e.metaKey||e.ctrlKey)&&e.key==='k'){e.preventDefault();box.focus();box.select();}
-    if(e.key==='Escape')panel.classList.remove('visible');
-  });
 })();
 `;
 
@@ -204,17 +345,44 @@ function metaHtml(item){
     return out;
 }
 
+/**
+ * Server-side tokenizer for JS/TS @example blocks.
+ * Returns HTML with tok-* spans. Processes strings, comments, numbers, keywords.
+ */
+function highlightCode(raw){
+    if(!raw) return '';
+    var out='';
+    var KW=/\b(function|class|const|let|var|return|new|if|else|for|while|import|export|from|async|await|try|catch|throw|extends|implements|type|interface|enum|this|super|null|undefined|true|false|typeof|instanceof|of|in|do|switch|case|default|break|continue|static|readonly|abstract|private|protected|public|override|declare|namespace|as|satisfies)\b/g;
+    var re=/(\/\/[^\n]*)|(\/\*[\s\S]*?\*\/)|(["'`])(?:(?!\3)[^\\]|\\.)*\3|\b(\d+\.?\d*(?:[eE][+-]?\d+)?)\b/g;
+    var last=0;
+    var m;
+    while((m=re.exec(raw))!==null){
+        if(m.index>last){
+            // Tokenize the plain segment for keywords
+            out+=esc(raw.slice(last,m.index)).replace(KW,function(kw){return'<span class="tok-kw">'+kw+'</span>';});
+        }
+        if(m[1]||m[2]) out+='<span class="tok-cmt">'+esc(m[0])+'</span>';
+        else if(m[3]) out+='<span class="tok-str">'+esc(m[0])+'</span>';
+        else if(m[4]) out+='<span class="tok-num">'+esc(m[0])+'</span>';
+        else out+=esc(m[0]);
+        last=m.index+m[0].length;
+    }
+    if(last<raw.length){
+        out+=esc(raw.slice(last)).replace(KW,function(kw){return'<span class="tok-kw">'+kw+'</span>';});
+    }
+    return out;
+}
+
 function descHtml(item,symbolMap,filePath){
     var out='';
     if(item.description) out+='<div class="card-desc">'+(symbolMap?resolveLinks(item.description,symbolMap,filePath):esc(item.description))+'</div>';
     out+=metaHtml(item);
-    if(item.example) out+='<div class="card-example"><pre>'+esc(item.example)+'</pre></div>';
+    if(item.example) out+='<div class="card-example"><pre>'+highlightCode(item.example)+'</pre></div>';
     return out;
 }
 
 function renderParams(params, jsdocParams){
     if(!params||!params.length) return '';
-    // Build a lookup of JSDoc @param enrichments keyed by name
     var jmap={};
     (jsdocParams||[]).forEach(function(p){jmap[p.name]=p;});
     var html='<table class="params-table"><thead><tr><th>Parameter</th><th>Type</th><th>Optional</th><th>Description</th></tr></thead><tbody>';
@@ -228,7 +396,7 @@ function renderParams(params, jsdocParams){
 
 function renderReturns(returnType, returnsTag){
     var type=returnsTag&&returnsTag.type&&returnsTag.type!=='any'?returnsTag.type:returnType;
-    var desc=returnsTag&&returnsTag.description?'— '+esc(returnsTag.description):'';
+    var desc=returnsTag&&returnsTag.description?'&mdash; '+esc(returnsTag.description):'';
     return'<div class="returns">Returns: <code>'+esc(type)+'</code> '+desc+'</div>';
 }
 
@@ -241,14 +409,12 @@ function renderThrows(throws){
 
 function resolveLinks(text, symbolMap, filePath, moduleHtmlPathFn, modules){
     if(!text||!symbolMap) return esc(text);
-    // Replace {@link Symbol} and {@link Symbol#method} with anchor tags
     return esc(text).replace(/\{@link ([^}]+)\}/g, function(_, ref){
         var parts=ref.trim().split('#');
         var sym=parts[0].trim();
         var method=parts[1]?parts[1].trim():null;
         var entry=symbolMap[sym];
         if(!entry) return'<code>'+esc(ref)+'</code>';
-        // Are we on the same module page?
         var targetPath=entry.modulePath;
         var href=targetPath===filePath?'':(targetPath||'');
         if(method) href+='#meth-'+sym+'_'+method;
@@ -278,10 +444,10 @@ function buildCss(theme){
     return t.light+(t.dark||'')+CSS_STRUCTURE;
 }
 
-function page(title,sidebarHtml,bodyHtml,searchIndex,theme){
-    var t=THEMES[theme]||THEMES.default;
-    var themeJs=t.toggleBtn?CLIENT_JS:'(function(){var INDEX=window.__SEARCH_INDEX__||[];var box=document.getElementById("search-box");var panel=document.getElementById("search-results");if(!box||!panel)return;function esc(s){return String(s).replace(/&/g,"&amp;").replace(/</g,"&lt;").replace(/>/g,"&gt;");}function render(items){panel.innerHTML=items.length?items.slice(0,20).map(function(r){return\'<a class="search-result-item" href="\'+r.url+\'"><span class="sr-name">\'+esc(r.name)+\'</span><span class="sr-kind">\'+esc(r.kind)+\'</span><span class="sr-module">\'+esc(r.module)+\'</span></a>\';}).join(""):\'<div class="search-no-results">No results</div>\';panel.classList.add("visible");}function search(q){q=q.trim().toLowerCase();if(!q){panel.classList.remove("visible");return;}render(INDEX.filter(function(r){return r.name.toLowerCase().includes(q)||r.module.toLowerCase().includes(q);}));}box.addEventListener("input",function(){search(box.value);});box.addEventListener("focus",function(){if(box.value.trim())search(box.value);});document.addEventListener("click",function(e){if(!box.contains(e.target)&&!panel.contains(e.target))panel.classList.remove("visible");});document.addEventListener("keydown",function(e){if((e.metaKey||e.ctrlKey)&&e.key==="k"){e.preventDefault();box.focus();box.select();}if(e.key==="Escape")panel.classList.remove("visible");});document.addEventListener("click",function(e){var b=e.target.closest(".copy-btn");if(!b)return;navigator.clipboard.writeText(b.dataset.sig||"").then(function(){b.textContent="Copied!";b.classList.add("copied");setTimeout(function(){b.textContent="Copy";b.classList.remove("copied");},1500);});});})();';
-    return'<!DOCTYPE html>\n<html lang="en">\n<head>\n<meta charset="UTF-8">\n<meta name="viewport" content="width=device-width,initial-scale=1">\n<title>'+esc(title)+'</title>\n<style>'+buildCss(theme)+'</style>\n</head>\n<body>\n<div class="layout">\n<nav class="sidebar">'+sidebarHtml+'</nav>\n<main class="main">'+bodyHtml+'</main>\n</div>\n<script>window.__SEARCH_INDEX__='+JSON.stringify(searchIndex)+';</script>\n<script>'+themeJs+'</script>\n</body>\n</html>';
+function page(title,sidebarHtml,bodyHtml,theme,assetPrefix,tocHtml){
+    var p=assetPrefix||'';
+    var hasToc=!!tocHtml;
+    return'<!DOCTYPE html>\n<html lang="en">\n<head>\n<meta charset="UTF-8">\n<meta name="viewport" content="width=device-width,initial-scale=1">\n<title>'+esc(title)+'</title>\n<link rel="stylesheet" href="'+p+'assets/style.css">\n</head>\n<body>\n<button id="hamburger" class="hamburger" aria-label="Menu"><span></span><span></span><span></span></button>\n<div class="layout'+(hasToc?' has-toc':'')+'">\n<nav class="sidebar">'+sidebarHtml+'</nav>\n<main class="main">'+bodyHtml+'</main>\n'+(hasToc?'<aside class="toc" id="toc">'+tocHtml+'</aside>\n':'')+'</div>\n<script src="'+p+'search-index.js"></script>\n<script src="'+p+'assets/app.js"></script>\n</body>\n</html>';
 }
 
 // ---------------------------------------------------------------------------
@@ -341,10 +507,10 @@ function buildSearchIndex(modules,prefix){
 }
 
 // ---------------------------------------------------------------------------
-// Sidebar
+// Sidebar (with symbol tree under active module)
 // ---------------------------------------------------------------------------
 
-function buildSidebar(modules,projectName,version,activePath,rootPrefix,showToggle){
+function buildSidebar(modules,projectName,version,activePath,rootPrefix,showToggle,activeModule){
     var prefix=rootPrefix||'';
     var html='<div class="sidebar-header">'
         +'<div><a href="'+prefix+'index.html">'+esc(projectName)+'</a>'+(version?'<span class="version">v'+esc(version)+'</span>':'')+'</div>'
@@ -363,6 +529,26 @@ function buildSidebar(modules,projectName,version,activePath,rootPrefix,showTogg
     });
     var hasGroups=order.some(function(d){return d!=='';});
 
+    function symRows(mod){
+        var rows='<div class="sym-rows">';
+        var specs=[
+            {list:mod.functions,kind:'fn',label:'fn'},
+            {list:mod.classes,kind:'cls',label:'cls'},
+            {list:mod.interfaces,kind:'iface',label:'if'},
+            {list:mod.typeAliases,kind:'type',label:'ty'},
+            {list:mod.enums,kind:'enum',label:'en'},
+            {list:mod.variables,kind:'var',label:'$'},
+        ];
+        specs.forEach(function(s){
+            (s.list||[]).forEach(function(item){
+                var anchor=anchorId(s.kind,item.name);
+                rows+='<div class="sym-row"><span class="sym-pill sym-'+s.kind+'">'+s.label+'</span>'
+                    +'<a class="sym-link" href="#'+anchor+'">'+esc(item.name)+'</a></div>';
+            });
+        });
+        return rows+'</div>';
+    }
+
     order.forEach(function(dir){
         var mods=groups[dir];
         if(hasGroups&&dir){
@@ -372,8 +558,9 @@ function buildSidebar(modules,projectName,version,activePath,rootPrefix,showTogg
                 var rel=moduleHtmlPath(mod.filePath,modules);
                 var label=moduleLabel(mod.filePath,modules);
                 var name=label.slice(dir.length+1);
-                var active=activePath===rel?' active':'';
-                html+='<a class="sidebar-link sidebar-link-indent'+active+'" href="'+esc(prefix+rel)+'">'+esc(name)+'</a>';
+                var isActive=activePath===rel;
+                html+='<a class="sidebar-link sidebar-link-indent'+(isActive?' active':'')+'" href="'+esc(prefix+rel)+'">'+esc(name)+'</a>';
+                if(isActive&&activeModule) html+=symRows(activeModule);
             });
             html+='</details>';
         } else {
@@ -381,14 +568,42 @@ function buildSidebar(modules,projectName,version,activePath,rootPrefix,showTogg
                 var rel=moduleHtmlPath(mod.filePath,modules);
                 var label=moduleLabel(mod.filePath,modules);
                 var name=dir?label.slice(dir.length+1):label;
-                var active=activePath===rel?' active':'';
-                html+='<a class="sidebar-link'+active+'" href="'+esc(prefix+rel)+'">'+esc(name)+'</a>';
+                var isActive=activePath===rel;
+                html+='<a class="sidebar-link'+(isActive?' active':'')+'" href="'+esc(prefix+rel)+'">'+esc(name)+'</a>';
+                if(isActive&&activeModule) html+=symRows(activeModule);
             });
         }
     });
     return html+'</div>';
 }
 
+// ---------------------------------------------------------------------------
+// Right TOC builder
+// ---------------------------------------------------------------------------
+
+function buildToc(mod){
+    var specs=[
+        {title:'Functions',list:mod.functions,kind:'fn'},
+        {title:'Classes',list:mod.classes,kind:'cls'},
+        {title:'Interfaces',list:mod.interfaces,kind:'iface'},
+        {title:'Type Aliases',list:mod.typeAliases,kind:'type'},
+        {title:'Enums',list:mod.enums,kind:'enum'},
+        {title:'Variables',list:mod.variables,kind:'var'},
+    ].filter(function(s){return s.list&&s.list.length;});
+    if(!specs.length) return '';
+    var html='<div class="toc-title">On this page</div>';
+    specs.forEach(function(s){
+        html+='<div class="toc-section"><div class="toc-section-label">'+esc(s.title)+'</div>';
+        s.list.forEach(function(item){
+            var anchor=anchorId(s.kind,item.name);
+            var dep=item.deprecated!=null?'<span class="toc-dep">dep</span>':'';
+            html+='<a class="toc-item" href="#'+anchor+'" data-anchor="'+anchor+'">'+esc(item.name)+dep+'</a>';
+        });
+        html+='</div>';
+    });
+    return html;
+}
+
 // ---------------------------------------------------------------------------
 // Item renderers
 // ---------------------------------------------------------------------------
@@ -398,7 +613,7 @@ function renderFunction(fn,filePath,sourceUrl,symbolMap){
     var sig=fn.name+'('+paramStr+'): '+fn.returnType;
     var id=anchorId('fn',fn.name);
     var badges=[fn.isExported&&badge('exported','exported'),fn.isAsync&&badge('async','async'),fn.isGenerator&&badge('generator','generator'),fn.deprecated!=null&&badge('deprecated','deprecated')].filter(Boolean).join('');
-    return'<div class="card" id="'+id+'">'
+    return'<div class="card card-fn" id="'+id+'">'
         +'<div class="card-header"><div><div class="card-name"><a class="anchor-link" href="#'+id+'">#</a>'+esc(fn.name)+sourceLink(fn,filePath,sourceUrl)+'</div><div class="card-sig">'+esc(sig)+'</div></div>'+copyBtn(sig)+'</div>'
         +'<div>'+badges+'</div>'+descHtml(fn,symbolMap,filePath)
         +renderParams(fn.params,fn.jsdocParams)
@@ -410,7 +625,7 @@ function renderFunction(fn,filePath,sourceUrl,symbolMap){
 function renderClass(cls,filePath,sourceUrl,symbolMap){
     var id=anchorId('cls',cls.name);
     var badges=[cls.isExported&&badge('exported','exported'),cls.isAbstract&&badge('abstract','abstract'),cls.extends.length&&badge('extends '+cls.extends.join(', '),'exported'),cls.implements.length&&badge('implements '+cls.implements.join(', '),'async'),cls.deprecated!=null&&badge('deprecated','deprecated')].filter(Boolean).join('');
-    var inner='<div class="card" id="'+id+'">'
+    var inner='<div class="card card-cls" id="'+id+'">'
         +'<div class="card-header"><div><div class="card-name"><a class="anchor-link" href="#'+id+'">#</a>'+esc(cls.name)+sourceLink(cls,filePath,sourceUrl)+'</div></div>'
         +copyBtn('class '+cls.name+(cls.extends.length?' extends '+cls.extends.join(', '):''))+'</div>'
         +'<div>'+badges+'</div>'+descHtml(cls,symbolMap,filePath);
@@ -449,7 +664,7 @@ function renderClass(cls,filePath,sourceUrl,symbolMap){
 
 function renderInterface(iface,filePath,sourceUrl,symbolMap){
     var id=anchorId('iface',iface.name);
-    var html='<div class="card" id="'+id+'">'
+    var html='<div class="card card-iface" id="'+id+'">'
         +'<div class="card-header"><div><div class="card-name"><a class="anchor-link" href="#'+id+'">#</a>'+esc(iface.name)+sourceLink(iface,filePath,sourceUrl)+'</div></div>'+copyBtn('interface '+iface.name)+'</div>'
         +(iface.isExported?badge('exported','exported'):'')+descHtml(iface,symbolMap,filePath);
     if(iface.properties.length){
@@ -467,7 +682,7 @@ function renderInterface(iface,filePath,sourceUrl,symbolMap){
 
 function renderEnum(enm,filePath,sourceUrl,symbolMap){
     var id=anchorId('enum',enm.name);
-    var html='<div class="card" id="'+id+'">'
+    var html='<div class="card card-enum" id="'+id+'">'
         +'<div class="card-header"><div><div class="card-name"><a class="anchor-link" href="#'+id+'">#</a>'+esc(enm.name)+sourceLink(enm,filePath,sourceUrl)+'</div></div>'+copyBtn('enum '+enm.name)+'</div>'
         +(enm.isExported?badge('exported','exported'):'')+descHtml(enm,symbolMap,filePath)
         +'<table class="params-table" style="margin-top:10px"><thead><tr><th>Member</th><th>Value</th></tr></thead><tbody>';
@@ -477,7 +692,7 @@ function renderEnum(enm,filePath,sourceUrl,symbolMap){
 
 function renderTypeAlias(ta,filePath,sourceUrl,symbolMap){
     var id=anchorId('type',ta.name);
-    return'<div class="card" id="'+id+'">'
+    return'<div class="card card-type" id="'+id+'">'
         +'<div class="card-header"><div><div class="card-name"><a class="anchor-link" href="#'+id+'">#</a>'+esc(ta.name)+sourceLink(ta,filePath,sourceUrl)+'</div><div class="card-sig">type '+esc(ta.name)+' = '+esc(ta.type)+'</div></div>'+copyBtn('type '+ta.name+' = '+ta.type)+'</div>'
         +(ta.isExported?badge('exported','exported'):'')+descHtml(ta,symbolMap,filePath)+'</div>';
 }
@@ -485,91 +700,132 @@ function renderTypeAlias(ta,filePath,sourceUrl,symbolMap){
 function renderVariable(v,filePath,sourceUrl,symbolMap){
     var id=anchorId('var',v.name);
     var decl=(v.isConst?'const':'let')+' '+v.name+': '+v.type;
-    return'<div class="card" id="'+id+'">'
+    return'<div class="card card-var" id="'+id+'">'
         +'<div class="card-header"><div><div class="card-name"><a class="anchor-link" href="#'+id+'">#</a>'+esc(v.name)+sourceLink(v,filePath,sourceUrl)+'</div><div class="card-sig">'+esc(decl)+'</div></div>'+copyBtn(decl)+'</div>'
         +(v.isExported?badge('exported','exported'):'')+badge(v.isConst?'const':'var',v.isConst?'const':'var')+(v.deprecated!=null?badge('deprecated','deprecated'):'')+descHtml(v,symbolMap,filePath)+'</div>';
 }
 
 function section(title,items,renderFn,filePath,sourceUrl,symbolMap){
     if(!items||!items.length) return '';
-    return'<div class="section"><div class="section-title">'+esc(title)+'</div>'+items.map(function(item){return renderFn(item,filePath,sourceUrl,symbolMap);}).join('\n')+'</div>';
+    var count='<span class="section-count">('+items.length+')</span>';
+    return'<div class="section"><div class="section-title">'+esc(title)+count+'</div>'+items.map(function(item){return renderFn(item,filePath,sourceUrl,symbolMap);}).join('\n')+'</div>';
 }
 
 // ---------------------------------------------------------------------------
-// Site builder
+// Site builder — helpers
 // ---------------------------------------------------------------------------
 
-function buildSite(modules,options){
-    options=options||{};
-    var projectName=options.projectName||'Documentation';
-    var version=options.version||'';
-    var theme=options.theme||'default';
-    var sourceUrl=options.sourceUrl||null;
-    // Build a symbol → {anchorId, modulePath} map for @link resolution
-    var symbolMap={};
+/** Build the symbol map for @link cross-reference resolution. */
+function buildSymbolMap(modules){
+    var map={};
     modules.forEach(function(mod){
         var rel=moduleHtmlPath(mod.filePath,modules);
-        function reg(name,aid){symbolMap[name]={anchorId:aid,modulePath:rel};}
+        function reg(name,aid){map[name]={anchorId:aid,modulePath:rel};}
         mod.functions.forEach(function(f){reg(f.name,anchorId('fn',f.name));});
-        mod.classes.forEach(function(c){reg(c.name,anchorId('cls',c.name));c.methods.forEach(function(m){reg(c.name+'.'+m.name,anchorId('cls',c.name));});});
+        mod.classes.forEach(function(c){
+            reg(c.name,anchorId('cls',c.name));
+            c.methods.forEach(function(m){reg(c.name+'.'+m.name,anchorId('cls',c.name));});
+        });
         mod.interfaces.forEach(function(i){reg(i.name,anchorId('iface',i.name));});
         mod.typeAliases.forEach(function(t){reg(t.name,anchorId('type',t.name));});
         mod.enums.forEach(function(e){reg(e.name,anchorId('enum',e.name));});
         mod.variables.forEach(function(v){reg(v.name,anchorId('var',v.name));});
     });
+    return map;
+}
+
+/** Build the module-grid HTML for the index page. */
+function buildIndexBody(modules){
+    var body='<div class="section"><div class="section-title">Modules</div><div class="module-grid">';
+    modules.forEach(function(mod){
+        var rel=moduleHtmlPath(mod.filePath,modules);
+        var label=moduleLabel(mod.filePath,modules);
+        var parts=[
+            mod.functions.length&&mod.functions.length+' fn',
+            mod.classes.length&&mod.classes.length+' class',
+            mod.interfaces.length&&mod.interfaces.length+' iface',
+            mod.enums.length&&mod.enums.length+' enum',
+            mod.variables.length&&mod.variables.length+' const',
+        ].filter(Boolean);
+        var allItems=[].concat(mod.functions,mod.classes,mod.interfaces,mod.typeAliases,mod.enums,mod.variables);
+        var depCount=allItems.filter(function(i){return i.deprecated!=null;}).length;
+        var sinces=allItems.map(function(i){return i.since;}).filter(Boolean).sort();
+        var sinceStr=sinces.length
+            ? (' · since v'+sinces[0]+(sinces.length>1&&sinces[sinces.length-1]!==sinces[0]?'–v'+sinces[sinces.length-1]:''))
+            : '';
+        var depBadge=depCount?'<span class="badge badge-deprecated" style="font-size:10px;padding:1px 5px">'+depCount+' dep</span>':'';
+        var descHtml=mod.description?'<div class="module-card-desc">'+esc(mod.description.slice(0,100))+(mod.description.length>100?'…':'')+'</div>':'';
+        body+='<a class="module-card" href="'+esc(rel)+'">';
+        body+='<div class="module-card-name">'+esc(label)+depBadge+'</div>';
+        body+='<div class="module-card-stats">'+(parts.join(' · ')||'no exported items')+esc(sinceStr)+'</div>';
+        body+=descHtml+'</a>';
+    });
+    return body+'</div></div>';
+}
+
+/** Build a single module page body (sections only, no header). */
+function buildModuleBody(mod,sourceUrl,symbolMap){
+    var isEmpty=!mod.functions.length&&!mod.classes.length&&!mod.interfaces.length
+        &&!mod.typeAliases.length&&!mod.enums.length&&!mod.variables.length;
+    if(isEmpty) return '<p class="empty" style="margin-top:24px">No documented items found.</p>';
+    var body='';
+    body+=section('Functions',mod.functions,renderFunction,mod.filePath,sourceUrl,symbolMap);
+    body+=section('Classes',mod.classes,renderClass,mod.filePath,sourceUrl,symbolMap);
+    body+=section('Interfaces',mod.interfaces,renderInterface,mod.filePath,sourceUrl,symbolMap);
+    body+=section('Type Aliases',mod.typeAliases,renderTypeAlias,mod.filePath,sourceUrl,symbolMap);
+    body+=section('Enums',mod.enums,renderEnum,mod.filePath,sourceUrl,symbolMap);
+    body+=section('Variables & Constants',mod.variables,renderVariable,mod.filePath,sourceUrl,symbolMap);
+    return body;
+}
+
+// ---------------------------------------------------------------------------
+// Site builder
+// ---------------------------------------------------------------------------
+
+function buildSite(modules,options){
+    options=options||{};
+    var projectName=options.projectName||'Documentation';
+    var version=options.version||'';
+    var theme=options.theme||'default';
+    var sourceUrl=options.sourceUrl||null;
+    var symbolMap=buildSymbolMap(modules);
     var showToggle=(THEMES[theme]||THEMES.default).toggleBtn;
     var pages=[];
-    var idxIdx=buildSearchIndex(modules,'');
-    var modIdx=buildSearchIndex(modules,'../');
 
-    // index.html
-    var sidebar=buildSidebar(modules,projectName,version,'index.html','',showToggle);
+    // Shared static assets
+    pages.push({path:'assets/style.css', html:buildCss(theme)});
+    pages.push({path:'assets/app.js',    html:CLIENT_JS});
+    pages.push({path:'search-index.js',  html:'window.__SEARCH_INDEX__='+JSON.stringify(buildSearchIndex(modules,''))+';'});
+
+    // Index page
     var totalFns=modules.reduce(function(s,m){return s+m.functions.length;},0);
     var totalCls=modules.reduce(function(s,m){return s+m.classes.length;},0);
-    var body='<div class="page-title">'+esc(projectName)+'</div>'
-        +'<div class="page-subtitle">'+modules.length+' module(s) &middot; '+totalFns+' function(s) &middot; '+totalCls+' class(es)</div>'
-        +'<div class="section"><div class="section-title">Modules</div><div class="module-grid">';
-    modules.forEach(function(mod){
-        var rel=moduleHtmlPath(mod.filePath,modules);
-        var label=moduleLabel(mod.filePath,modules);
-        var total=mod.functions.length+mod.classes.length+mod.interfaces.length+mod.typeAliases.length+mod.enums.length+mod.variables.length;
-        var parts=[mod.functions.length&&mod.functions.length+' fn',mod.classes.length&&mod.classes.length+' class',mod.interfaces.length&&mod.interfaces.length+' iface',mod.enums.length&&mod.enums.length+' enum',mod.variables.length&&mod.variables.length+' const'].filter(Boolean);
-        // deprecated count across all items
-        var depCount=[].concat(mod.functions,mod.classes,mod.interfaces,mod.typeAliases,mod.enums,mod.variables).filter(function(i){return i.deprecated!=null;}).length;
-        // @since version range
-        var sinces=[].concat(mod.functions,mod.classes,mod.interfaces,mod.typeAliases,mod.enums,mod.variables).map(function(i){return i.since;}).filter(Boolean);
-        var sinceStr=sinces.length?(' · since v'+sinces.sort()[0])+(sinces.length>1&&sinces[sinces.length-1]!==sinces[0]?'–v'+sinces[sinces.length-1]:''):''
-        var depStr=depCount?'<span class="badge badge-deprecated" style="font-size:10px;padding:1px 5px;vertical-align:middle">'+depCount+' deprecated</span>':'';
-        var desc=mod.description?'<div class="module-card-desc">'+esc(mod.description.slice(0,100))+(mod.description.length>100?'…':'')+'</div>':'';
-        body+='<a class="module-card" href="'+esc(rel)+'"><div class="module-card-name">'+esc(label)+depStr+'</div><div class="module-card-stats">'+(parts.join(' · ')||'no exported items')+esc(sinceStr)+'</div>'+desc+'</a>';
+    var idxHeader='<div class="page-title">'+esc(projectName)+'</div>'
+        +'<div class="page-subtitle">'+modules.length+' module(s) &middot; '+totalFns+' function(s) &middot; '+totalCls+' class(es)</div>';
+    pages.push({
+        path:'index.html',
+        html:page(projectName,buildSidebar(modules,projectName,version,'index.html','',showToggle,null),idxHeader+buildIndexBody(modules),theme,'',null),
     });
-    body+='</div></div>';
-    pages.push({path:'index.html',html:page(projectName,sidebar,body,idxIdx,theme)});
 
-    // per-module pages
+    // Per-module pages
     modules.forEach(function(mod){
         var rel=moduleHtmlPath(mod.filePath,modules);
         var label=moduleLabel(mod.filePath,modules);
-        var modSidebar=buildSidebar(modules,projectName,version,rel,'../',showToggle);
-        var mbody='<div class="breadcrumb"><a href="../index.html">'+esc(projectName)+'</a> / '+esc(label)+'</div>'
+        var modHeader='<div class="breadcrumb"><a href="../index.html">'+esc(projectName)+'</a> / '+esc(label)+'</div>'
             +'<div class="page-title">'+esc(label)+'</div>'
-            +'<div class="page-subtitle" style="font-family:monospace;font-size:12px">'+esc(mod.filePath)+'</div>'
+            +'<div class="page-subtitle">'+esc(mod.filePath)+'</div>'
             +(mod.description?'<p class="module-desc">'+esc(mod.description)+'</p>':'');
-        var isEmpty=!mod.functions.length&&!mod.classes.length&&!mod.interfaces.length&&!mod.typeAliases.length&&!mod.enums.length&&!mod.variables.length;
-        if(isEmpty){
-            mbody+='<p class="empty" style="margin-top:24px">No documented items found.</p>';
-        } else {
-            mbody+=section('Functions',mod.functions,renderFunction,mod.filePath,sourceUrl,symbolMap);
-            mbody+=section('Classes',mod.classes,renderClass,mod.filePath,sourceUrl,symbolMap);
-            mbody+=section('Interfaces',mod.interfaces,renderInterface,mod.filePath,sourceUrl,symbolMap);
-            mbody+=section('Type Aliases',mod.typeAliases,renderTypeAlias,mod.filePath,sourceUrl,symbolMap);
-            mbody+=section('Enums',mod.enums,renderEnum,mod.filePath,sourceUrl,symbolMap);
-            mbody+=section('Variables & Constants',mod.variables,renderVariable,mod.filePath,sourceUrl,symbolMap);
-        }
-        pages.push({path:rel,html:page(label+' - '+projectName,modSidebar,mbody,modIdx,theme)});
+        pages.push({
+            path:rel,
+            html:page(
+                label+' - '+projectName,
+                buildSidebar(modules,projectName,version,rel,'../',showToggle,mod),
+                modHeader+buildModuleBody(mod,sourceUrl,symbolMap),
+                theme,'../',buildToc(mod)
+            ),
+        });
     });
 
     return pages;
 }
-
 module.exports = { buildSite, moduleLabel, moduleHtmlPath };

package/package.json

@@ -1,58 +1,58 @@
 {
-    "name": "jsdoc-scribe",
-    "version": "1.7.0",
-    "description": "Pure, deterministic, AST-based JSDoc comment generator and documentation site builder for JavaScript and TypeScript. No AI involved.",
-    "main": "lib/index.js",
-    "exports": {
-        ".": "./lib/index.js",
-        "./docs": "./lib/docs.js"
-    },
-    "bin": {
-        "gen-comments": "./bin/cli.js",
-        "gen-docs": "./bin/gen-docs.js"
-    },
-    "files": [
-        "bin",
-        "lib",
-        "README.md",
-        "CHANGELOG.md",
-        "LICENSE"
-    ],
-    "scripts": {
-        "demo": "node bin/cli.js sample",
-        "docs": "node bin/gen-docs.js sample --out docs --title jsdoc-scribe",
-        "test": "node test/run.js",
-        "prepublishOnly": "npm test"
-    },
-    "keywords": [
-        "jsdoc",
-        "comments",
-        "documentation",
-        "typescript",
-        "javascript",
-        "cli",
-        "ast",
-        "code-documentation",
-        "comment-generator",
-        "autodoc",
-        "docs-generator"
-    ],
-    "author": {
-        "name": "Chintan Goswami"
-    },
-    "license": "MIT",
-    "engines": {
-        "node": ">=14"
-    },
-    "repository": {
-        "type": "git",
-        "url": "git+https://github.com/imchintoo/jsdoc-scribe.git"
-    },
-    "homepage": "https://github.com/imchintoo/jsdoc-scribe#readme",
-    "bugs": {
-        "url": "https://github.com/imchintoo/jsdoc-scribe/issues"
-    },
-    "dependencies": {
-        "typescript": ">=5.0.0"
-    }
+  "name": "jsdoc-scribe",
+  "version": "1.11.0",
+  "description": "Pure, deterministic, AST-based JSDoc comment generator and documentation site builder for JavaScript and TypeScript. No AI involved.",
+  "main": "lib/index.js",
+  "exports": {
+    ".": "./lib/index.js",
+    "./docs": "./lib/docs.js"
+  },
+  "bin": {
+    "gen-comments": "./bin/cli.js",
+    "gen-docs": "./bin/gen-docs.js"
+  },
+  "files": [
+    "bin",
+    "lib",
+    "README.md",
+    "CHANGELOG.md",
+    "LICENSE"
+  ],
+  "scripts": {
+    "demo": "node bin/cli.js sample",
+    "docs": "node bin/gen-docs.js sample --out docs --title jsdoc-scribe",
+    "test": "node test/run.js",
+    "prepublishOnly": "npm test"
+  },
+  "keywords": [
+    "jsdoc",
+    "comments",
+    "documentation",
+    "typescript",
+    "javascript",
+    "cli",
+    "ast",
+    "code-documentation",
+    "comment-generator",
+    "autodoc",
+    "docs-generator"
+  ],
+  "author": {
+    "name": "Chintan Goswami"
+  },
+  "license": "MIT",
+  "engines": {
+    "node": ">=14"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/imchintoo/jsdoc-scribe.git"
+  },
+  "homepage": "https://github.com/imchintoo/jsdoc-scribe#readme",
+  "bugs": {
+    "url": "https://github.com/imchintoo/jsdoc-scribe/issues"
+  },
+  "dependencies": {
+    "typescript": ">=5.0.0"
+  }
 }