docula 0.41.0 → 0.50.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "docula",
-  "version": "0.41.0",
+  "version": "0.50.0",
   "description": "Beautiful Website for Your Projects",
   "type": "module",
   "main": "./dist/docula.js",
@@ -11,28 +11,15 @@
       "import": "./dist/docula.js"
     }
   },
-  "repository": "https://github.com/jaredwray/docula.git",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/jaredwray/docula.git"
+  },
   "author": "Jared Wray <me@jaredwray.com>",
   "engines": {
     "node": ">=20"
   },
   "license": "MIT",
-  "scripts": {
-    "clean": "rimraf ./dist ./coverage ./node_modules ./package-lock.json ./yarn.lock ./pnpm-lock.yaml ./site/README.md ./site/dist",
-    "build": "pnpm generate-init-file && rimraf ./dist && tsup src/docula.ts --format esm --dts --clean",
-    "lint": "biome check --write --error-on-warnings",
-    "lint:ci": "biome check --error-on-warnings",
-    "test": "pnpm lint && vitest run --coverage",
-    "test:ci": "pnpm lint:ci && vitest run --coverage",
-    "generate-init-file": "tsx scripts/generate-init-file.ts",
-    "website:build": "rimraf ./site/README.md && node bin/docula.mjs build -s ./site -o ./site/dist",
-    "website:serve": "rimraf ./site/README.md && node bin/docula.mjs serve -s ./site -o ./site/dist",
-    "website:build:mega": "rimraf ./test/fixtures/mega-page-site/dist && node bin/docula.mjs build -s ./test/fixtures/mega-page-site",
-    "website:serve:mega": "rimraf ./test/fixtures/mega-page-site/dist && node bin/docula.mjs serve -s ./test/fixtures/mega-page-site",
-    "website:build:changelog": "rimraf ./test/fixtures/changelog-site/dist && node bin/docula.mjs build -s ./test/fixtures/changelog-site",
-    "website:serve:changelog": "rimraf ./test/fixtures/changelog-site/dist && node bin/docula.mjs serve -s ./test/fixtures/changelog-site",
-    "prepare": "pnpm build"
-  },
   "keywords": [
     "static-site-generator",
     "static-site",
@@ -50,13 +37,12 @@
     "handlebars"
   ],
   "bin": {
-    "docula": "./bin/docula.mjs"
+    "docula": "./bin/docula.js"
   },
   "dependencies": {
     "@cacheable/net": "^2.0.5",
     "ecto": "^4.8.2",
     "feed": "^5.2.0",
-    "he": "^1.2.0",
     "jiti": "^2.6.1",
     "serve-handler": "^6.1.6",
     "update-notifier": "^7.3.1",
@@ -65,7 +51,6 @@
   "devDependencies": {
     "@biomejs/biome": "^2.4.2",
     "@types/express": "^5.0.6",
-    "@types/he": "^1.2.3",
     "@types/js-yaml": "^4.0.9",
     "@types/node": "^25.2.3",
     "@types/serve-handler": "^6.1.4",
@@ -80,7 +65,26 @@
   },
   "files": [
     "dist",
-    "template",
+    "templates",
     "bin"
-  ]
-}
+  ],
+  "scripts": {
+    "clean": "rimraf ./dist ./coverage ./node_modules ./package-lock.json ./yarn.lock ./pnpm-lock.yaml ./site/README.md ./site/dist",
+    "build": "pnpm generate-init-file && rimraf ./dist && tsup src/docula.ts --format esm --dts --clean",
+    "lint": "biome check --write --error-on-warnings",
+    "lint:ci": "biome check --error-on-warnings",
+    "test": "pnpm lint && vitest run --coverage",
+    "test:ci": "pnpm lint:ci && vitest run --coverage",
+    "generate-init-file": "tsx scripts/generate-init-file.ts",
+    "website:build": "rimraf ./site/README.md && node bin/docula.js build -s ./site -o ./site/dist",
+    "website:serve": "rimraf ./site/README.md && node bin/docula.js serve -s ./site -o ./site/dist",
+    "website:mega": "pnpm website:build:mega && pnpm website:serve:mega",
+    "website:build:mega": "rimraf ./test/fixtures/mega-page-site/dist && node bin/docula.js build -s ./test/fixtures/mega-page-site",
+    "website:serve:mega": "rimraf ./test/fixtures/mega-page-site/dist && node bin/docula.js serve -s ./test/fixtures/mega-page-site",
+    "website:mega:nohome": "pnpm website:build:mega:nohome && pnpm website:serve:mega:nohome",
+    "website:build:mega:nohome": "rimraf ./test/fixtures/mega-page-site-no-home-page/dist && node bin/docula.js build -s ./test/fixtures/mega-page-site-no-home-page",
+    "website:serve:mega:nohome": "rimraf ./test/fixtures/mega-page-site-no-home-page/dist && node bin/docula.js serve -s ./test/fixtures/mega-page-site-no-home-page",
+    "website:build:changelog": "rimraf ./test/fixtures/changelog-site/dist && node bin/docula.js build -s ./test/fixtures/changelog-site",
+    "website:serve:changelog": "rimraf ./test/fixtures/changelog-site/dist && node bin/docula.js serve -s ./test/fixtures/changelog-site"
+  }
+}

package/{template → templates/classic}/css/base.css

@@ -278,6 +278,16 @@ h1.changelog-entry-title {
   color: #6d28d9;
 }
 
+.changelog-tag-release {
+  background-color: rgba(16, 185, 129, 0.15);
+  color: #047857;
+}
+
+.changelog-tag-pre-release {
+  background-color: rgba(251, 191, 36, 0.15);
+  color: #92400e;
+}
+
 .changelog-entry-body p {
   margin: 0.5rem 0;
 }

package/{template → templates/classic}/css/multipage.css

@@ -25,6 +25,13 @@
   font-weight: 600;
 }
 
+.home-actions {
+  display: flex;
+  justify-content: center;
+  gap: 0.75rem;
+  flex-wrap: wrap;
+}
+
 /* Announcement */
 .announcement {
   max-width: 90%;

package/{template → templates/classic}/docs.hbs

@@ -54,7 +54,7 @@
   <main class="layout">
     {{> multipage/header }}
     {{> multipage/sidebar }}
-    {{> multipage/doc }}
+{{> multipage/doc }}
   </main>
   {{> footer}}
 

package/{template/index.hbs → templates/classic/home.hbs}

@@ -57,6 +57,12 @@
   {{else}}
   <main class="home">
     {{> multipage/hero }}
+    <div class="home-actions">
+      {{> multipage/documentation }}
+      {{#if hasApi}}
+      {{> multipage/api-reference }}
+      {{/if}}
+    </div>
     {{> multipage/home }}
   </main>
   {{/if}}
@@ -69,4 +75,4 @@
   {{/unless}}
 </body>
 
-</html>
+</html>

package/templates/classic/includes/multipage/api-reference.hbs

@@ -0,0 +1 @@
+<a href="/api" class="home-docs-button">API Reference</a>

package/templates/classic/includes/multipage/documentation.hbs

@@ -0,0 +1 @@
+<a href="/docs" class="home-docs-button">Documentation</a>

package/{template → templates/classic}/includes/multipage/hero.hbs

@@ -8,5 +8,4 @@
     {{{announcement}}}
   </div>
   {{/if}}
-  <a href="/docs" class="home-docs-button">Documentation</a>
-</section>
+</section>

package/{template → templates/classic}/includes/multipage/home.hbs

@@ -22,7 +22,7 @@
 
     {{#if github.releases}}
     <div class="content-container">
-        <h2 class="home-title">Latest's Releases</h2>
+        <h2 class="home-title">Changelog</h2>
         {{#each github.releases as |release|}}
           {{#if (lt @index 3)}}
         <div class="release">
@@ -49,8 +49,8 @@
 
         {{#if (gt github.releases.length 6)}}
         <div>
-            <a class="release-btn" href="/releases">
-                All Releases
+            <a class="release-btn" href="/changelog">
+                Full Changelog
                 <span>→</span>
             </a>
         </div>

package/{template → templates/classic}/includes/singlepage/content.hbs

@@ -24,7 +24,7 @@
 
     {{#if github.releases}}
       <div class="content-container">
-        <h2 class="home-title">Latest's Releases</h2>
+        <h2 class="home-title">Changelog</h2>
         {{#each github.releases as |release|}}
           {{#if (lt @index 3)}}
             <div class="release">
@@ -51,8 +51,8 @@
 
         {{#if (gt github.releases.length 6)}}
           <div>
-            <a class="release-btn" href="/releases">
-              All Releases
+            <a class="release-btn" href="/changelog">
+              Full Changelog
               <span>→</span>
             </a>
           </div>

package/templates/modern/api.hbs

@@ -0,0 +1,30 @@
+<!DOCTYPE html>
+<html lang="en">
+
+<head>
+  {{> header }}
+  <title>API Documentation - {{ siteTitle }}</title>
+  <meta name="description" content="API Documentation for {{ siteTitle }}" />
+  <link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/@docutopia/react/dist/browser/docutopia.css" />
+  <style>
+    body {
+      margin: 0;
+      padding: 0;
+    }
+  </style>
+</head>
+
+<body>
+  <div id="docs" style="height: 100vh;"></div>
+
+  <script src="https://cdn.jsdelivr.net/npm/@docutopia/react/dist/browser/docutopia.js"></script>
+  <script>
+    Docutopia.render('docs', {
+      specUrl: '{{ specUrl }}',
+      basename: '/api',
+    });
+  </script>
+  {{> scripts }}
+</body>
+
+</html>

package/templates/modern/changelog-entry.hbs

@@ -0,0 +1,36 @@
+<!DOCTYPE html>
+<html lang="en">
+
+<head>
+  {{> header }}
+  <title>{{siteTitle}} - {{title}}</title>
+</head>
+
+<body>
+  {{> header-bar }}
+  <div class="content">
+    <main class="versions-container">
+      <div class="versions-content">
+        <div class="changelog-entry-nav">
+          <a href="/changelog/">&larr; Back to Changelog</a>
+        </div>
+        <div class="changelog-entry changelog-entry-single">
+          <div class="changelog-entry-header">
+            <h1 class="changelog-entry-title">{{title}}</h1>
+            {{#if tag}}
+            <span class="changelog-tag changelog-tag-{{tagClass}}">{{tag}}</span>
+            {{/if}}
+          </div>
+          <span class="changelog-entry-date">{{formattedDate}}</span>
+          <div class="changelog-entry-body">
+            {{{generatedHtml}}}
+          </div>
+        </div>
+      </div>
+    </main>
+  </div>
+  {{> footer }}
+  {{> scripts }}
+</body>
+
+</html>

package/templates/modern/changelog.hbs

@@ -0,0 +1,38 @@
+<!DOCTYPE html>
+<html lang="en">
+
+<head>
+  {{> header }}
+  <title>{{siteTitle}} Changelog</title>
+</head>
+
+<body>
+  {{> header-bar }}
+  <div class="content">
+    <main class="versions-container">
+      <div class="versions-content">
+        <h2 class="home-title">Changelog</h2>
+        {{#if entries}}
+        {{#each entries as |entry|}}
+        <div class="changelog-entry">
+          <div class="changelog-entry-header">
+            <a class="changelog-entry-title" href="/changelog/{{entry.slug}}/">{{entry.title}}</a>
+            {{#if entry.tag}}
+            <span class="changelog-tag changelog-tag-{{entry.tagClass}}">{{entry.tag}}</span>
+            {{/if}}
+          </div>
+          <span class="changelog-entry-date">{{entry.formattedDate}}</span>
+          <div class="changelog-entry-body">
+            {{{entry.generatedHtml}}}
+          </div>
+        </div>
+        {{/each}}
+        {{/if}}
+      </div>
+    </main>
+  </div>
+  {{> footer }}
+  {{> scripts }}
+</body>
+
+</html>