specra 0.2.12 → 0.2.13

package/config/svelte-config.js

@@ -44,11 +44,35 @@ export function specraMdsvexConfig(options = {}) {
   }
 }
 
+/**
+ * Read the deployment basePath from specra.config.json if present.
+ * Falls back to the BASE_PATH environment variable, then empty string.
+ */
+function resolveBasePath(configPath = path.join(process.cwd(), 'specra.config.json')) {
+  // Environment variable takes priority
+  if (process.env.BASE_PATH) return process.env.BASE_PATH
+
+  try {
+    if (fs.existsSync(configPath)) {
+      const raw = JSON.parse(fs.readFileSync(configPath, 'utf8'))
+      if (raw.deployment?.basePath) {
+        const bp = raw.deployment.basePath
+        // If custom domain is set, ignore basePath
+        if (raw.deployment?.customDomain) return ''
+        return bp.startsWith('/') ? bp : `/${bp}`
+      }
+    }
+  } catch {
+    // Ignore parse errors
+  }
+  return ''
+}
+
 /**
  * Scan the docs/ directory and return prerender entries for all version root pages.
  * This ensures adapter-static discovers and prerenders every version, not just the active one.
  */
-function discoverVersionEntries(docsDir = path.join(process.cwd(), 'docs')) {
+function discoverVersionEntries(basePath = '', docsDir = path.join(process.cwd(), 'docs')) {
   const entries = ['/']
   try {
     if (!fs.existsSync(docsDir)) return entries
@@ -56,7 +80,7 @@ function discoverVersionEntries(docsDir = path.join(process.cwd(), 'docs')) {
     const items = fs.readdirSync(docsDir, { withFileTypes: true })
     for (const item of items) {
       if (item.isDirectory() && /^v\d/.test(item.name)) {
-        entries.push(`/docs/${item.name}`)
+        entries.push(`${basePath}/docs/${item.name}`)
       }
     }
   } catch {
@@ -66,11 +90,14 @@ function discoverVersionEntries(docsDir = path.join(process.cwd(), 'docs')) {
 }
 
 /**
- * Create a full SvelteKit config with Specra defaults
+ * Create a full SvelteKit config with Specra defaults.
+ * Automatically reads deployment.basePath from specra.config.json
+ * for GitHub Pages deployments.
  */
 export function specraConfig(options = {}) {
   const { vitePreprocess } = options.vitePreprocess || {}
   const userPrerender = options.kit?.prerender || {}
+  const basePath = options.kit?.paths?.base ?? resolveBasePath()
 
   return {
     extensions: ['.svelte', '.md', '.svx', '.mdx'],
@@ -80,11 +107,15 @@ export function specraConfig(options = {}) {
     ],
     kit: {
       ...options.kit,
+      paths: {
+        ...options.kit?.paths,
+        base: basePath,
+      },
       prerender: {
         handleHttpError: 'warn',
         handleMissingId: 'warn',
         handleUnseenRoutes: 'warn',
-        entries: discoverVersionEntries(),
+        entries: discoverVersionEntries(basePath),
         ...userPrerender,
       }
     }

package/dist/utils.d.ts

@@ -1,13 +1,11 @@
 import { type ClassValue } from 'clsx';
 export declare function cn(...inputs: ClassValue[]): string;
 /**
- * Get the correct asset path based on deployment configuration
- * Handles different deployment scenarios:
- * - Vercel/Node.js hosting (standalone build): No basePath needed
- * - GitHub Pages without custom domain: Uses basePath from config
- * - Static hosting with custom domain: No basePath needed
+ * Get the correct asset path based on deployment configuration.
+ * Uses SvelteKit's base path (from kit.paths.base) which is resolved
+ * from deployment.basePath in specra.config.json or the BASE_PATH env var.
  *
- * @param path - The asset path (can start with or without '/')
- * @returns The properly formatted asset path
+ * @param assetPath - The asset path (can start with or without '/')
+ * @returns The properly formatted asset path with base prefix
  */
-export declare function getAssetPath(path: string): string;
+export declare function getAssetPath(assetPath: string): string;

package/dist/utils.js

@@ -4,27 +4,20 @@ export function cn(...inputs) {
     return twMerge(clsx(inputs));
 }
 /**
- * Get the correct asset path based on deployment configuration
- * Handles different deployment scenarios:
- * - Vercel/Node.js hosting (standalone build): No basePath needed
- * - GitHub Pages without custom domain: Uses basePath from config
- * - Static hosting with custom domain: No basePath needed
+ * Get the correct asset path based on deployment configuration.
+ * Uses SvelteKit's base path (from kit.paths.base) which is resolved
+ * from deployment.basePath in specra.config.json or the BASE_PATH env var.
  *
- * @param path - The asset path (can start with or without '/')
- * @returns The properly formatted asset path
+ * @param assetPath - The asset path (can start with or without '/')
+ * @returns The properly formatted asset path with base prefix
  */
-export function getAssetPath(path) {
-    // Get basePath from Next.js config (set during build for static exports)
-    const basePath = process.env.NEXT_PUBLIC_BASE_PATH || process.env.__NEXT_ROUTER_BASEPATH || '';
-    // Normalize the input path: ensure it starts with '/'
-    const normalizedPath = path.startsWith('/') ? path : `/${path}`;
-    // If we have a basePath (GitHub Pages without custom domain), prepend it
+export function getAssetPath(assetPath) {
+    const basePath = process.env.BASE_PATH || '';
+    const normalizedPath = assetPath.startsWith('/') ? assetPath : `/${assetPath}`;
     if (basePath) {
-        // Normalize basePath: remove trailing slash, ensure leading slash
         const normalizedBase = basePath.startsWith('/') ? basePath : `/${basePath}`;
         const cleanBase = normalizedBase.replace(/\/$/, '');
         return `${cleanBase}${normalizedPath}`;
     }
-    // Default: return the normalized path (works for Vercel, custom domains, and dev)
     return normalizedPath;
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "specra",
-  "version": "0.2.12",
+  "version": "0.2.13",
   "description": "A modern documentation library for SvelteKit with built-in versioning, API reference generation, full-text search, and MDX support",
   "svelte": "./dist/index.js",
   "types": "./dist/index.d.ts",