specra 0.2.61 → 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/dist/mdx-cache.js

@@ -7,8 +7,14 @@
  */
 import { getVersions, getAllDocs, getDocBySlug } from './mdx';
 import { clearProductCaches } from './config.server';
-import { watch } from 'fs';
-import { join } from 'path';
+// Default imports (member access) rather than named imports: under a
+// browser/static build these node builtins are externalized, and named imports
+// (`{ join }`) fail the client bundle with "not exported by
+// __vite-browser-external". Member access (`path.join`) defers to runtime and
+// is dead code client-side, since these caches only run server-side. Matches
+// the import style in mdx.ts / config.server.ts / category.ts.
+import fs from 'fs';
+import path from 'path';
 import { PerfTimer, logCacheOperation } from './dev-utils';
 const isDevelopment = typeof process !== 'undefined' && process.env?.NODE_ENV === 'development';
 // Cache stores
@@ -30,9 +36,9 @@ function initializeWatchers() {
     if (!isDevelopment || watchersInitialized)
         return;
     watchersInitialized = true;
-    const docsPath = join(process.cwd(), 'docs');
+    const docsPath = path.join(process.cwd(), 'docs');
     try {
-        watch(docsPath, { recursive: true }, (eventType, filename) => {
+        fs.watch(docsPath, { recursive: true }, (eventType, filename) => {
             if (!filename)
                 return;
             // Invalidate relevant caches when MDX or JSON files change

package/package.json

@@ -1,10 +1,14 @@
 {
   "name": "specra",
-  "version": "0.2.61",
+  "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",
   "type": "module",
+  "sideEffects": [
+    "**/*.css",
+    "**/*.svelte"
+  ],
   "exports": {
     ".": {
       "types": "./dist/index.d.ts",