specra 0.2.7 → 0.2.9

package/config/category.schema.json

@@ -0,0 +1,52 @@
+{
+  "$ref": "#/definitions/CategoryConfig",
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "definitions": {
+    "CategoryConfig": {
+      "additionalProperties": false,
+      "properties": {
+        "collapsed": {
+          "type": "boolean"
+        },
+        "collapsible": {
+          "type": "boolean"
+        },
+        "icon": {
+          "type": "string"
+        },
+        "label": {
+          "type": "string"
+        },
+        "link": {
+          "additionalProperties": false,
+          "properties": {
+            "slug": {
+              "type": "string"
+            },
+            "type": {
+              "enum": [
+                "generated-index",
+                "doc"
+              ],
+              "type": "string"
+            }
+          },
+          "required": [
+            "type"
+          ],
+          "type": "object"
+        },
+        "position": {
+          "type": "number"
+        },
+        "sidebar_position": {
+          "type": "number"
+        },
+        "tab_group": {
+          "type": "string"
+        }
+      },
+      "type": "object"
+    }
+  }
+}

package/config/product.schema.json

@@ -0,0 +1,70 @@
+{
+  "$ref": "#/definitions/ProductConfig",
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "definitions": {
+    "ProductConfig": {
+      "additionalProperties": false,
+      "description": "Per-product configuration loaded from docs/{product}/_product_.json Products sit above versions in the config hierarchy.",
+      "properties": {
+        "activeVersion": {
+          "description": "Default version for this product (overrides global site.activeVersion)",
+          "type": "string"
+        },
+        "badge": {
+          "description": "Badge text shown next to the product (e.g., \"New\", \"Beta\")",
+          "type": "string"
+        },
+        "description": {
+          "description": "Short description of the product",
+          "type": "string"
+        },
+        "icon": {
+          "description": "Icon identifier for the product dropdown (lucide icon name)",
+          "type": "string"
+        },
+        "label": {
+          "description": "Display name in the product switcher",
+          "type": "string"
+        },
+        "position": {
+          "description": "Order in the product dropdown (lower = first)",
+          "type": "number"
+        },
+        "tabGroups": {
+          "description": "Product-level tab group overrides",
+          "items": {
+            "$ref": "#/definitions/TabGroup"
+          },
+          "type": "array"
+        }
+      },
+      "required": [
+        "label"
+      ],
+      "type": "object"
+    },
+    "TabGroup": {
+      "additionalProperties": false,
+      "description": "Tab group for organizing documentation",
+      "properties": {
+        "icon": {
+          "description": "Optional icon name (lucide-react icon)",
+          "type": "string"
+        },
+        "id": {
+          "description": "Unique identifier for the tab group",
+          "type": "string"
+        },
+        "label": {
+          "description": "Display label for the tab",
+          "type": "string"
+        }
+      },
+      "required": [
+        "id",
+        "label"
+      ],
+      "type": "object"
+    }
+  }
+}

package/config/svelte-config.js

@@ -17,6 +17,8 @@ import remarkMath from 'remark-math'
 import rehypeSlug from 'rehype-slug'
 import rehypeKatex from 'rehype-katex'
 import rehypeRaw from 'rehype-raw'
+import fs from 'fs'
+import path from 'path'
 
 /**
  * Get mdsvex preprocessor config with all Specra remark/rehype plugins
@@ -42,11 +44,33 @@ export function specraMdsvexConfig(options = {}) {
   }
 }
 
+/**
+ * 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')) {
+  const entries = ['/']
+  try {
+    if (!fs.existsSync(docsDir)) return entries
+
+    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}`)
+      }
+    }
+  } catch {
+    // Ignore errors — fall back to just '/'
+  }
+  return entries
+}
+
 /**
  * Create a full SvelteKit config with Specra defaults
  */
 export function specraConfig(options = {}) {
   const { vitePreprocess } = options.vitePreprocess || {}
+  const userPrerender = options.kit?.prerender || {}
 
   return {
     extensions: ['.svelte', '.md', '.svx', '.mdx'],
@@ -55,7 +79,14 @@ export function specraConfig(options = {}) {
       mdsvex(specraMdsvexConfig(options.mdsvex || {}))
     ],
     kit: {
-      ...(options.kit || {})
+      ...options.kit,
+      prerender: {
+        handleHttpError: 'warn',
+        handleMissingId: 'warn',
+        handleUnseenRoutes: 'warn',
+        entries: discoverVersionEntries(),
+        ...userPrerender,
+      }
     }
   }
 }

package/config/version.schema.json

@@ -0,0 +1,83 @@
+{
+  "$ref": "#/definitions/VersionConfig",
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "definitions": {
+    "BannerConfig": {
+      "additionalProperties": false,
+      "description": "Banner configuration for version-level or site-level banners.   Site-wide banner configuration",
+      "properties": {
+        "text": {
+          "description": "Banner message text. Supports markdown links like [text](/url).",
+          "type": "string"
+        },
+        "type": {
+          "description": "Banner style: info, warning, error, success   Banner type",
+          "enum": [
+            "info",
+            "warning",
+            "error",
+            "success"
+          ],
+          "type": "string"
+        }
+      },
+      "required": [
+        "text"
+      ],
+      "type": "object"
+    },
+    "TabGroup": {
+      "additionalProperties": false,
+      "description": "Tab group for organizing documentation",
+      "properties": {
+        "icon": {
+          "description": "Optional icon name (lucide-react icon)",
+          "type": "string"
+        },
+        "id": {
+          "description": "Unique identifier for the tab group",
+          "type": "string"
+        },
+        "label": {
+          "description": "Display label for the tab",
+          "type": "string"
+        }
+      },
+      "required": [
+        "id",
+        "label"
+      ],
+      "type": "object"
+    },
+    "VersionConfig": {
+      "additionalProperties": false,
+      "description": "Per-version configuration that can override global config settings. Loaded from docs/{version}/_version_.json",
+      "properties": {
+        "badge": {
+          "description": "Short badge text shown next to the version (e.g., \"Beta\", \"LTS\", \"Deprecated\").",
+          "type": "string"
+        },
+        "banner": {
+          "$ref": "#/definitions/BannerConfig",
+          "description": "Banner shown at the top of every page in this version. Overrides global banner."
+        },
+        "hidden": {
+          "description": "Hide this version from the version switcher. Useful for unreleased versions.",
+          "type": "boolean"
+        },
+        "label": {
+          "description": "Display label for this version (e.g., \"v1.0 (Stable)\"). Defaults to directory name.",
+          "type": "string"
+        },
+        "tabGroups": {
+          "description": "Override tab groups for this version. Empty array = no tabs.",
+          "items": {
+            "$ref": "#/definitions/TabGroup"
+          },
+          "type": "array"
+        }
+      },
+      "type": "object"
+    }
+  }
+}

package/dist/category.js

@@ -1,7 +1,7 @@
 // Note: This file uses server-only APIs (fs, path) and should only be imported in Server Components
 import fs from "fs";
 import path from "path";
-const DOCS_DIR = path.join(process.cwd(), "docs");
+const DOCS_DIR = typeof process !== 'undefined' ? path.join(process.cwd(), "docs") : "docs";
 /**
  * Read category.json from a folder
  */

package/dist/components/docs/CategoryIndex.svelte

@@ -55,8 +55,12 @@
   const baseUrl = $derived(
     product && product !== '_default_'
       ? `/docs/${product}`
-      : (config.site?.baseUrl?.replace(/\/$/, '') || '')
+      : '/docs'
   );
+
+  // Note: We always use '/docs' as the base for non-product routes.
+  // Do NOT use config.site?.baseUrl here — that field (e.g. "/") refers to
+  // the site root, not the docs route prefix.
 </script>
 
 <div class="space-y-8">

package/dist/components/docs/MdxContent.svelte

@@ -26,7 +26,9 @@
     {#if Comp}
       {#if node.children && node.children.length > 0}
         <svelte:component this={Comp} {...node.props}>
-          <MdxContent nodes={node.children} {components} />
+          {#snippet children()}
+            <MdxContent nodes={node.children} {components} />
+          {/snippet}
         </svelte:component>
       {:else}
         <svelte:component this={Comp} {...node.props} />

package/dist/components/docs/SearchModal.svelte

@@ -28,7 +28,8 @@
   let inputEl = $state<HTMLInputElement | null>(null);
   let debounceTimer: ReturnType<typeof setTimeout> | null = null;
 
-  const baseUrl = $derived(config.site?.baseUrl || '/');
+  const siteBaseUrl = $derived(config.site?.baseUrl || '/');
+  const docsBaseUrl = '/docs';
 
   $effect(() => {
     if (isOpen && inputEl) {
@@ -75,7 +76,7 @@
     debounceTimer = setTimeout(async () => {
       try {
         const response = await fetch(
-          `${baseUrl.replace(/\/$/, '')}/api/search?q=${encodeURIComponent(value.trim())}`
+          `${siteBaseUrl.replace(/\/$/, '')}/api/search?q=${encodeURIComponent(value.trim())}`
         );
         if (response.ok) {
           const data = await response.json();
@@ -93,7 +94,7 @@
 
   function navigateToResult(result: SearchResult) {
     const version = result.version || config.site?.activeVersion || 'v1';
-    const url = `${baseUrl.replace(/\/$/, '')}/${version}/${result.slug}`;
+    const url = `${docsBaseUrl}/${version}/${result.slug}`;
     goto(url);
     onClose();
   }

package/dist/components/docs/SidebarMenuItems.svelte

@@ -57,7 +57,28 @@
       : `/docs/${version}`
   );
 
-  let collapsed: Record<string, boolean> = $state({});
+  const STORAGE_KEY = 'specra-sidebar-collapsed';
+
+  function loadCollapsedState(): Record<string, boolean> {
+    if (typeof window === 'undefined') return {};
+    try {
+      const stored = localStorage.getItem(STORAGE_KEY);
+      return stored ? JSON.parse(stored) : {};
+    } catch {
+      return {};
+    }
+  }
+
+  function saveCollapsedState(state: Record<string, boolean>) {
+    if (typeof window === 'undefined') return;
+    try {
+      localStorage.setItem(STORAGE_KEY, JSON.stringify(state));
+    } catch {
+      // localStorage unavailable
+    }
+  }
+
+  let collapsed: Record<string, boolean> = $state(loadCollapsedState());
   let pathname = $derived($page.url.pathname.replace(/\/$/, ''));
 
   // Filter docs by active tab group if tab groups are configured
@@ -180,6 +201,7 @@
 
   function toggleSection(section: string) {
     collapsed = { ...collapsed, [section]: !collapsed[section] };
+    saveCollapsedState(collapsed);
   }
 
   function isActiveInGroup(group: SidebarGroup): boolean {

package/dist/components/docs/api/ApiParams.svelte

@@ -13,62 +13,54 @@
   }
 
   let { title = 'Parameters', params }: Props = $props();
+
+  let filteredParams = $derived(
+    Array.isArray(params) ? params.filter(p => p && p.name) : []
+  );
 </script>
 
-{#if params && params.length > 0}
+{#if filteredParams.length > 0}
   <div class="mb-6">
     <h4 class="text-sm font-semibold text-foreground mb-3">{title}</h4>
-    <div class="overflow-x-auto">
-      <table class="w-full border-collapse">
+    <div class="specra-params-table">
+      <table>
         <thead>
-          <tr class="border-b border-border">
-            <th class="text-left py-2 px-3 text-xs font-semibold text-muted-foreground uppercase tracking-wider">
-              Property
-            </th>
-            <th class="text-left py-2 px-3 text-xs font-semibold text-muted-foreground uppercase tracking-wider">
-              Type
-            </th>
-            <th class="text-left py-2 px-3 text-xs font-semibold text-muted-foreground uppercase tracking-wider">
-              Required
-            </th>
-            <th class="text-left py-2 px-3 text-xs font-semibold text-muted-foreground uppercase tracking-wider">
-              Default
-            </th>
-            <th class="text-left py-2 px-3 text-xs font-semibold text-muted-foreground uppercase tracking-wider">
-              Description
-            </th>
+          <tr>
+            <th>Property</th>
+            <th>Type</th>
+            <th>Required</th>
+            <th>Default</th>
+            <th>Description</th>
           </tr>
         </thead>
         <tbody>
-          {#each params as param, index}
-            <tr
-              class={index !== params.length - 1 ? 'border-b border-border/50' : ''}
-            >
-              <td class="py-2.5 px-3">
-                <code class="text-sm font-mono text-foreground">{param.name}</code>
+          {#each filteredParams as param, index}
+            <tr>
+              <td>
+                <code>{param.name}</code>
               </td>
-              <td class="py-2.5 px-3">
-                <span class="text-sm text-muted-foreground font-mono">{param.type}</span>
+              <td>
+                <span class="font-mono">{param.type}</span>
               </td>
-              <td class="py-2.5 px-3">
+              <td>
                 {#if param.required}
-                  <span class="text-sm text-red-600 dark:text-red-400">Yes</span>
+                  <span class="text-red-600 dark:text-red-400">Yes</span>
                 {:else}
-                  <span class="text-sm text-muted-foreground">No</span>
+                  No
                 {/if}
               </td>
-              <td class="py-2.5 px-3">
+              <td>
                 {#if param.default}
-                  <code class="text-sm font-mono text-muted-foreground">{param.default}</code>
+                  <code>{param.default}</code>
                 {:else}
-                  <span class="text-sm text-muted-foreground">-</span>
+                  -
                 {/if}
               </td>
-              <td class="py-2.5 px-3">
+              <td>
                 {#if param.description}
-                  <span class="text-sm text-muted-foreground">{param.description}</span>
+                  {param.description}
                 {:else}
-                  <span class="text-sm text-muted-foreground">-</span>
+                  -
                 {/if}
               </td>
             </tr>
@@ -78,3 +70,69 @@
     </div>
   </div>
 {/if}
+
+<style>
+  .specra-params-table table {
+    border-collapse: separate;
+    border-spacing: 0;
+    border: 1px solid var(--border);
+    border-radius: 0.75rem;
+    overflow: hidden;
+    width: max-content;
+    max-width: 100%;
+    display: block;
+    overflow-x: auto;
+    -webkit-overflow-scrolling: touch;
+  }
+
+  .specra-params-table thead {
+    background: var(--muted);
+  }
+
+  .specra-params-table thead th {
+    border-bottom: 1px solid var(--border);
+    border-right: 1px solid var(--border);
+    padding: 0.625rem 1rem;
+    font-weight: 600;
+    font-size: 0.75rem;
+    text-transform: uppercase;
+    letter-spacing: 0.05em;
+    text-align: left;
+    color: var(--muted-foreground);
+    white-space: nowrap;
+  }
+
+  .specra-params-table thead th:last-child {
+    border-right: none;
+  }
+
+  .specra-params-table tbody td {
+    border-bottom: 1px solid var(--border);
+    border-right: 1px solid var(--border);
+    padding: 0.625rem 1rem;
+    font-size: 0.875rem;
+    color: var(--muted-foreground);
+  }
+
+  .specra-params-table tbody td:last-child {
+    border-right: none;
+  }
+
+  .specra-params-table tbody tr:last-child td {
+    border-bottom: none;
+  }
+
+  .specra-params-table tbody tr:hover {
+    background: var(--muted);
+  }
+
+  .specra-params-table code {
+    font-size: 0.8125rem;
+    font-family: var(--font-mono, ui-monospace, monospace);
+    color: var(--foreground);
+    background: var(--muted);
+    padding: 0.125rem 0.375rem;
+    border-radius: 0.25rem;
+    border: 1px solid var(--border);
+  }
+</style>

package/dist/components/ui/Button.svelte

@@ -36,23 +36,42 @@
 
 <script lang="ts">
   import { cn } from '../../utils.js';
-  import type { HTMLButtonAttributes } from 'svelte/elements';
+  import type { HTMLButtonAttributes, HTMLAnchorAttributes } from 'svelte/elements';
   import type { Snippet } from 'svelte';
 
-  interface Props extends HTMLButtonAttributes {
+  type ButtonProps = HTMLButtonAttributes & {
+    href?: never;
+  };
+
+  type AnchorProps = HTMLAnchorAttributes & {
+    href: string;
+  };
+
+  type Props = (ButtonProps | AnchorProps) & {
     variant?: ButtonVariants['variant'];
     size?: ButtonVariants['size'];
     class?: string;
     children?: Snippet;
-  }
+  };
 
-  let { variant = 'default', size = 'default', class: className, children, ...restProps }: Props = $props();
+  let { variant = 'default', size = 'default', class: className, children, href, ...restProps }: Props = $props();
 </script>
 
-<button
-  data-slot="button"
-  class={cn(buttonVariants({ variant, size, className }))}
-  {...restProps}
->
-  {@render children?.()}
-</button>
+{#if href}
+  <a
+    {href}
+    data-slot="button"
+    class={cn(buttonVariants({ variant, size, className }))}
+    {...restProps}
+  >
+    {@render children?.()}
+  </a>
+{:else}
+  <button
+    data-slot="button"
+    class={cn(buttonVariants({ variant, size, className }))}
+    {...restProps}
+  >
+    {@render children?.()}
+  </button>
+{/if}

package/dist/components/ui/Button.svelte.d.ts

@@ -4,14 +4,20 @@ export declare const buttonVariants: (props?: ({
     size?: "icon" | "default" | "sm" | "lg" | "icon-sm" | "icon-lg" | null | undefined;
 } & import("class-variance-authority/types").ClassProp) | undefined) => string;
 export type ButtonVariants = VariantProps<typeof buttonVariants>;
-import type { HTMLButtonAttributes } from 'svelte/elements';
+import type { HTMLButtonAttributes, HTMLAnchorAttributes } from 'svelte/elements';
 import type { Snippet } from 'svelte';
-interface Props extends HTMLButtonAttributes {
+type ButtonProps = HTMLButtonAttributes & {
+    href?: never;
+};
+type AnchorProps = HTMLAnchorAttributes & {
+    href: string;
+};
+type Props = (ButtonProps | AnchorProps) & {
     variant?: ButtonVariants['variant'];
     size?: ButtonVariants['size'];
     class?: string;
     children?: Snippet;
-}
+};
 declare const Button: import("svelte").Component<Props, {}, "">;
 type Button = ReturnType<typeof Button>;
 export default Button;

package/dist/config.server.js

@@ -150,7 +150,7 @@ export function reloadConfig(userConfig) {
  * Returns null if the file doesn't exist or is invalid.
  */
 const versionConfigCache = new Map();
-const VCFG_TTL = process.env.NODE_ENV === 'development' ? 5000 : 60000;
+const VCFG_TTL = (typeof process !== 'undefined' && process.env?.NODE_ENV === 'development') ? 5000 : 60000;
 export function loadVersionConfig(version, product) {
     const cacheKey = product && product !== "_default_" ? `${product}:${version}` : version;
     const cached = versionConfigCache.get(cacheKey);
@@ -240,7 +240,7 @@ const productsCache = {
     data: null,
     timestamp: 0,
 };
-const PCFG_TTL = process.env.NODE_ENV === 'development' ? 5000 : 60000;
+const PCFG_TTL = (typeof process !== 'undefined' && process.env?.NODE_ENV === 'development') ? 5000 : 60000;
 /** Cache for individual product configs */
 const productConfigCache = new Map();
 /**

package/dist/dev-utils.js

@@ -2,7 +2,7 @@
  * Development utilities for debugging and performance monitoring
  * Only active in development mode
  */
-const isDevelopment = process.env.NODE_ENV === 'development';
+const isDevelopment = typeof process !== 'undefined' && process.env?.NODE_ENV === 'development';
 /**
  * Performance timer for measuring operation duration
  */

package/dist/mdx-cache.js

@@ -10,7 +10,7 @@ import { clearProductCaches } from './config.server';
 import { watch } from 'fs';
 import { join } from 'path';
 import { PerfTimer, logCacheOperation } from './dev-utils';
-const isDevelopment = process.env.NODE_ENV === 'development';
+const isDevelopment = typeof process !== 'undefined' && process.env?.NODE_ENV === 'development';
 // Cache stores
 const versionsCache = {
     data: null,

package/dist/mdx.js

@@ -15,7 +15,7 @@ import { getAllCategoryConfigs } from "./category";
 import { sortSidebarItems, sortSidebarGroups, buildSidebarStructure } from "./sidebar-utils";
 import { sanitizePath, validatePathWithinDirectory, validateMDXSecurity } from "./mdx-security";
 import { getConfig } from "./config";
-const DOCS_DIR = path.join(process.cwd(), "docs");
+const DOCS_DIR = typeof process !== 'undefined' ? path.join(process.cwd(), "docs") : "docs";
 /**
  * Resolve the docs directory for a given version and optional product.
  * - Default product or omitted: docs/{version}/
@@ -379,7 +379,14 @@ function parseJsxExpression(expr) {
             return JSON.parse(trimmed);
         }
         catch {
-            return trimmed;
+            // Convert JS object notation inside arrays to JSON
+            const jsonStr = trimmed.replace(/(\w+)\s*:/g, '"$1":').replace(/:\s*'([^']*)'/g, ': "$1"');
+            try {
+                return JSON.parse(jsonStr);
+            }
+            catch {
+                return trimmed;
+            }
         }
     }
     return trimmed;
@@ -449,6 +456,61 @@ function extractCodeBlockProps(node) {
     const filename = node.properties?.['data-filename'] || codeChild.properties?.['data-filename'];
     return { code, language, ...(filename ? { filename } : {}) };
 }
+/**
+ * Detect GitHub-style alert blockquotes: > [!WARNING] content
+ * Returns the alert type and remaining content children, or null if not an alert.
+ */
+const ALERT_TYPE_MAP = {
+    NOTE: 'note',
+    TIP: 'tip',
+    IMPORTANT: 'info',
+    WARNING: 'warning',
+    CAUTION: 'danger',
+    INFO: 'info',
+    SUCCESS: 'success',
+    ERROR: 'error',
+    DANGER: 'danger',
+};
+function extractBlockquoteAlert(node) {
+    if (node.type !== 'element' || node.tagName !== 'blockquote')
+        return null;
+    if (!node.children || node.children.length === 0)
+        return null;
+    // Find the first paragraph child
+    const firstP = node.children.find((c) => c.type === 'element' && c.tagName === 'p');
+    if (!firstP || !firstP.children || firstP.children.length === 0)
+        return null;
+    // Check first text node for [!TYPE] pattern
+    const firstText = firstP.children[0];
+    if (firstText.type !== 'text')
+        return null;
+    const match = firstText.value.match(/^\s*\[!(\w+)\]\s*\n?/);
+    if (!match)
+        return null;
+    const alertType = ALERT_TYPE_MAP[match[1].toUpperCase()];
+    if (!alertType)
+        return null;
+    // Build remaining content: modify the first paragraph to remove the alert marker
+    const remainingFirstPChildren = [...firstP.children];
+    const remainingText = firstText.value.slice(match[0].length);
+    if (remainingText.trim()) {
+        remainingFirstPChildren[0] = { ...firstText, value: remainingText };
+    }
+    else {
+        remainingFirstPChildren.shift();
+    }
+    const contentChildren = [];
+    if (remainingFirstPChildren.length > 0) {
+        contentChildren.push({ ...firstP, children: remainingFirstPChildren });
+    }
+    // Add any remaining blockquote children (paragraphs after the first)
+    for (const child of node.children) {
+        if (child !== firstP) {
+            contentChildren.push(child);
+        }
+    }
+    return { type: alertType, contentChildren };
+}
 /**
  * Recursively extract text content from a hast node.
  */
@@ -720,6 +782,20 @@ async function hastChildrenToMdxNodes(children) {
                 children: childNodes,
             });
         }
+        else if (extractBlockquoteAlert(child)) {
+            // GitHub-style alert blockquotes: > [!WARNING] content
+            flushHtmlBuffer();
+            const alert = extractBlockquoteAlert(child);
+            const contentNodes = alert.contentChildren.length > 0
+                ? await hastChildrenToMdxNodes(alert.contentChildren)
+                : [];
+            nodes.push({
+                type: 'component',
+                name: 'Callout',
+                props: { type: alert.type },
+                children: contentNodes,
+            });
+        }
         else {
             // Check if this regular element contains any component elements nested within
             if (hasNestedComponent(child)) {

package/dist/parsers/openapi-parser.js

@@ -116,8 +116,13 @@ export class OpenApiParser {
     parseParameters(parameters, spec) {
         const result = { path: [], query: [], header: [] };
         for (const param of parameters) {
+            if (!param)
+                continue;
             // Resolve $ref if present
             const resolved = param.$ref ? this.resolveRef(param.$ref, spec) : param;
+            // Skip params that failed to resolve or have no name
+            if (!resolved || !resolved.name || !resolved.in)
+                continue;
             const apiParam = {
                 name: resolved.name,
                 type: resolved.schema?.type || resolved.type || "string",
@@ -202,7 +207,7 @@ export class OpenApiParser {
         for (const segment of path) {
             current = current[segment];
             if (!current)
-                return {};
+                return null;
         }
         return current;
     }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "specra",
-  "version": "0.2.7",
+  "version": "0.2.9",
   "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",
@@ -34,7 +34,10 @@
     },
     "./styles": "./dist/styles/globals.css",
     "./styles.css": "./dist/styles/globals.css",
-    "./config.schema.json": "./config/specra.config.schema.json"
+    "./config.schema.json": "./config/specra.config.schema.json",
+    "./version.schema.json": "./config/version.schema.json",
+    "./product.schema.json": "./config/product.schema.json",
+    "./category.schema.json": "./config/category.schema.json"
   },
   "files": [
     "dist",
@@ -45,7 +48,7 @@
     "dev": "svelte-package --watch",
     "check": "svelte-kit sync && svelte-check --tsconfig ./tsconfig.json",
     "typecheck": "svelte-check --tsconfig ./tsconfig.json",
-    "generate:schema": "ts-json-schema-generator --path src/lib/config.types.ts --type SpecraConfig --out config/specra.config.schema.json"
+    "generate:schema": "ts-json-schema-generator --path src/lib/config.types.ts --type SpecraConfig --out config/specra.config.schema.json && ts-json-schema-generator --path src/lib/config.types.ts --type VersionConfig --out config/version.schema.json && ts-json-schema-generator --path src/lib/config.types.ts --type ProductConfig --out config/product.schema.json && ts-json-schema-generator --path src/lib/category.ts --type CategoryConfig --out config/category.schema.json"
   },
   "keywords": [
     "documentation",