@levino/shipyard-docs 0.6.0 → 0.6.1-rc-20260108111817

package/README.md

@@ -35,7 +35,7 @@ export default defineConfig({
 ### Content Collection
 
 ```ts
-// content.config.ts
+// src/content.config.ts (Astro 5+)
 import { defineCollection } from 'astro:content'
 import { createDocsCollection } from '@levino/shipyard-docs'
 

package/astro/DocsEntry.astro

@@ -61,8 +61,17 @@ if (custom_edit_url === null) {
 } else if (custom_edit_url) {
   // Custom URL provided
   editUrl = custom_edit_url
+} else if (entry.filePath) {
+  // Use filePath instead of entry.id because Astro's glob loader
+  // strips "index" from entry.id for index pages (e.g., en/index -> en)
+  // Strip the collection base directory to get the relative path
+  const collectionBase = `${docsConfig.collectionName}/`
+  const relativePath = entry.filePath.startsWith(collectionBase)
+    ? entry.filePath.slice(collectionBase.length)
+    : entry.filePath
+  editUrl = getEditUrl(docsConfig.editUrl, relativePath)
 } else {
-  // Use global config
+  // Fallback to entry.id if filePath is not available
   editUrl = getEditUrl(docsConfig.editUrl, entry.id)
 }
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@levino/shipyard-docs",
-  "version": "0.6.0",
+  "version": "0.6.1-rc-20260108111817",
   "description": "Documentation plugin for shipyard with automatic sidebar, pagination, and git metadata",
   "type": "module",
   "main": "src/index.ts",
@@ -26,7 +26,7 @@
   "dependencies": {
     "effect": "^3.12.5",
     "ramda": "^0.31",
-    "@levino/shipyard-base": "^0.6.0"
+    "@levino/shipyard-base": "0.7.0-rc-20260108111817"
   },
   "devDependencies": {
     "@tailwindcss/typography": "^0.5.16",

package/src/index.ts

@@ -251,6 +251,12 @@ export interface DocsConfig {
    * ```
    */
   llmsTxt?: LlmsTxtDocsConfig
+  /**
+   * Whether to prerender docs pages at build time.
+   * Set to false for SSR sites with auth middleware that need access to request headers/cookies.
+   * @default true
+   */
+  prerender?: boolean
 }
 
 /**
@@ -327,6 +333,7 @@ export default (config: DocsConfig = {}): AstroIntegration => {
     showLastUpdateTime = false,
     showLastUpdateAuthor = false,
     llmsTxt,
+    prerender = true,
   } = config
 
   // Normalize the route base path (remove leading/trailing slashes safely)
@@ -434,7 +441,17 @@ if (customEditUrl === null) {
   editUrl = undefined
 } else if (customEditUrl) {
   editUrl = customEditUrl
+} else if (entry.filePath) {
+  // Use filePath instead of entry.id because Astro's glob loader
+  // strips "index" from entry.id for index pages (e.g., en/index -> en)
+  // Strip the collection base directory to get the relative path
+  const collectionBase = \`\${docsConfig.collectionName}/\`
+  const relativePath = entry.filePath.startsWith(collectionBase)
+    ? entry.filePath.slice(collectionBase.length)
+    : entry.filePath
+  editUrl = getEditUrl(docsConfig.editUrl, relativePath)
 } else {
+  // Fallback to entry.id if filePath is not available
   editUrl = getEditUrl(docsConfig.editUrl, entry.id)
 }
 
@@ -506,14 +523,14 @@ if (
           injectRoute({
             pattern: `/[locale]/${normalizedBasePath}/[...slug]`,
             entrypoint: entryFilePath,
-            prerender: true,
+            prerender,
           })
         } else {
           // Without i18n: direct path
           injectRoute({
             pattern: `/${normalizedBasePath}/[...slug]`,
             entrypoint: entryFilePath,
-            prerender: true,
+            prerender,
           })
         }
 
@@ -737,20 +754,20 @@ export const GET: APIRoute = async ({ site }) => {
           injectRoute({
             pattern: `/${normalizedBasePath}/_llms-txt/[...slug].txt`,
             entrypoint: llmsTxtPagesFilePath,
-            prerender: true,
+            prerender,
           })
 
           // Inject routes for llms.txt and llms-full.txt under the docs path
           injectRoute({
             pattern: `/${normalizedBasePath}/llms.txt`,
             entrypoint: llmsTxtFilePath,
-            prerender: true,
+            prerender,
           })
 
           injectRoute({
             pattern: `/${normalizedBasePath}/llms-full.txt`,
             entrypoint: llmsFullTxtFilePath,
-            prerender: true,
+            prerender,
           })
         }
       },