specra 0.2.62 → 0.2.63

package/dist/index.d.ts

@@ -11,6 +11,7 @@ export * from './parsers/index.js';
 export type * from './api.types.js';
 export type { ApiParam, ApiHeader, ApiResponse as SpecraApiResponse, ApiEndpointSpec, SpecraApiSpec } from './api-parser.types.js';
 export * from './utils.js';
+export * from './links.js';
 export * from './sidebar-utils.js';
 export * from './category.js';
 export * from './redirects.js';

package/dist/index.js

@@ -15,6 +15,7 @@ export * from './config.js';
 export * from './parsers/index.js';
 // Utilities
 export * from './utils.js';
+export * from './links.js';
 export * from './sidebar-utils.js';
 export * from './category.js';
 export * from './redirects.js';

package/dist/links.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Prefix an absolute app path with the configured SvelteKit base path
+ * (derived from `deployment.basePath` in specra.config.json).
+ *
+ * SvelteKit does not auto-apply the base path to `redirect()` targets or to
+ * raw `href` string literals, so any link or redirect built from a string must
+ * go through this helper to resolve correctly under a subpath deployment
+ * (e.g. GitHub Pages at `/repo/`). It works in both client and server code,
+ * since `base` is a plain string.
+ *
+ *   <a href={link('/docs/v1/intro')}>        -> `${base}/docs/v1/intro`
+ *   redirect(302, link(`/docs/${version}`))  -> `${base}/docs/...`
+ *
+ * Passing an empty string returns the site root under the base path.
+ */
+export declare function link(path: string): string;

package/dist/links.js

@@ -0,0 +1,22 @@
+import { base } from '$app/paths';
+/**
+ * Prefix an absolute app path with the configured SvelteKit base path
+ * (derived from `deployment.basePath` in specra.config.json).
+ *
+ * SvelteKit does not auto-apply the base path to `redirect()` targets or to
+ * raw `href` string literals, so any link or redirect built from a string must
+ * go through this helper to resolve correctly under a subpath deployment
+ * (e.g. GitHub Pages at `/repo/`). It works in both client and server code,
+ * since `base` is a plain string.
+ *
+ *   <a href={link('/docs/v1/intro')}>        -> `${base}/docs/v1/intro`
+ *   redirect(302, link(`/docs/${version}`))  -> `${base}/docs/...`
+ *
+ * Passing an empty string returns the site root under the base path.
+ */
+export function link(path) {
+    if (!path || path === '/')
+        return base || '/';
+    const p = path.startsWith('/') ? path : `/${path}`;
+    return `${base}${p}`;
+}

package/package.json

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