specra 0.2.63 → 0.2.64

package/config/svelte-config.js

@@ -166,6 +166,12 @@ export function specraConfig(options = {}) {
     kit: {
       ...options.kit,
       paths: {
+        // Absolute (base-prefixed) links rather than relative ones. Under a
+        // subpath deployment, relative links (the SvelteKit default) interact
+        // badly with the prerender crawler and produce wrong targets; absolute
+        // `${base}/...` links resolve and crawl correctly. Override via
+        // options.kit.paths.relative if a site truly needs relative output.
+        relative: false,
         ...options.kit?.paths,
         base: basePath,
       },

package/dist/components/docs/Card.svelte

@@ -2,6 +2,7 @@
   import { ArrowRight, ExternalLink } from 'lucide-svelte';
   import type { Snippet } from 'svelte';
   import Icon from './Icon.svelte';
+  import { link } from '../../links.js';
 
   interface Props {
     title: string;
@@ -13,6 +14,10 @@
   }
 
   let { title, description, href, icon, external = false, children }: Props = $props();
+
+  // Apply the deployment base path to internal absolute hrefs (e.g. /docs/...),
+  // since rehype only rewrites plain markdown links, not component props.
+  const resolvedHref = $derived(href && href.startsWith('/') ? link(href) : href);
 </script>
 
 {#snippet cardContent(isLink: boolean)}
@@ -49,7 +54,7 @@
 
 {#if href}
   <a
-    {href}
+    href={resolvedHref}
     class="card-link group block h-full p-4 rounded-xl border border-border hover:border-primary/50 hover:bg-muted/50 transition-all"
     target={external ? '_blank' : undefined}
     rel={external ? 'noopener noreferrer' : undefined}

package/dist/components/docs/MdxContent.svelte

@@ -2,6 +2,7 @@
   import MdxContent from './MdxContent.svelte';
   import type { Component } from 'svelte';
   import type { MdxNode } from '../../mdx.js';
+  import { base } from '$app/paths';
 
   interface Props {
     nodes: MdxNode[];
@@ -9,11 +10,26 @@
   }
 
   let { nodes, components }: Props = $props();
+
+  // Prefix absolute href/src in raw content HTML with the deployment base path.
+  // The content nodes are pre-rendered HTML emitted via {@html}, which bypasses
+  // rehypeBasePath, so links like /docs/... would otherwise be base-less under a
+  // subpath deployment. Skips protocol-relative (//) and already-based URLs.
+  function withBase(html: string): string {
+    if (!base || !html) return html;
+    return html.replace(
+      /(href|src)="(\/[^"]*)"/g,
+      (m, attr, p) =>
+        p.startsWith('//') || p === base || p.startsWith(base + '/')
+          ? m
+          : `${attr}="${base}${p}"`
+    );
+  }
 </script>
 
 {#each nodes as node}
   {#if node.type === 'html'}
-    {@html node.content}
+    {@html withBase(node.content)}
   {:else if node.type === 'component' && node.name}
     {@const Comp = components[node.name]}
     {#if Comp}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "specra",
-  "version": "0.2.63",
+  "version": "0.2.64",
   "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",