specra 0.2.9 → 0.2.11

package/dist/components/docs/CategoryIndex.svelte

@@ -42,8 +42,8 @@
         // Match direct children of this category path
         if (!docPath.startsWith(categoryPath + '/')) return false;
         const remaining = docPath.slice(categoryPath.length + 1);
-        // Only direct children (no further slashes, or is an index)
-        return !remaining.includes('/') && remaining !== 'index';
+        // Only direct children (no further slashes)
+        return !remaining.includes('/');
       })
       .sort((a, b) => {
         const posA = a.meta?.sidebar_position ?? 999;

package/dist/components/docs/MdxContent.svelte

@@ -1,14 +1,7 @@
 <script lang="ts">
   import MdxContent from './MdxContent.svelte';
   import type { Component } from 'svelte';
-
-  interface MdxNode {
-    type: 'html' | 'component';
-    content?: string;
-    name?: string;
-    props?: Record<string, any>;
-    children?: MdxNode[];
-  }
+  import type { MdxNode } from '../../mdx.js';
 
   interface Props {
     nodes: MdxNode[];

package/dist/components/docs/MdxContent.svelte.d.ts

@@ -0,0 +1,10 @@
+import MdxContent from './MdxContent.svelte';
+import type { Component } from 'svelte';
+import type { MdxNode } from '../../mdx.js';
+interface Props {
+    nodes: MdxNode[];
+    components: Record<string, Component>;
+}
+declare const MdxContent: Component<Props, {}, "">;
+type MdxContent = ReturnType<typeof MdxContent>;
+export default MdxContent;

package/dist/components/docs/NotFoundContent.svelte

@@ -3,11 +3,19 @@
 
   interface Props {
     version?: string;
+    product?: string;
   }
 
-  let { version = '' }: Props = $props();
+  let { version = '', product = '' }: Props = $props();
 
-  const homeLink = $derived(version ? `/${version}` : '/');
+  /** URL prefix: /docs/{product}/{version} for named products, /docs/{version} for default */
+  const homeLink = $derived(
+    product && product !== '_default_' && version
+      ? `/docs/${product}/${version}`
+      : version
+        ? `/docs/${version}`
+        : '/'
+  );
 </script>
 
 <div class="flex flex-col items-center justify-center min-h-[60vh] text-center px-4">

package/dist/components/docs/NotFoundContent.svelte.d.ts

@@ -1,5 +1,6 @@
 interface Props {
     version?: string;
+    product?: string;
 }
 declare const NotFoundContent: import("svelte").Component<Props, {}, "">;
 type NotFoundContent = ReturnType<typeof NotFoundContent>;

package/dist/components/docs/SidebarMenuItems.svelte

@@ -134,9 +134,8 @@
         if (isIndexFile) {
           rootGroups[groupName].position = doc.sidebar_position ?? 999;
           rootGroups[groupName].icon = doc.categoryIcon;
-        } else {
-          rootGroups[groupName].items.push(doc);
         }
+        rootGroups[groupName].items.push(doc);
         return;
       }
 
@@ -179,17 +178,14 @@
               if (doc.categoryIcon) {
                 currentLevel[folder].icon = doc.categoryIcon;
               }
-            } else {
-              currentLevel[folder].items.push(doc);
             }
+            currentLevel[folder].items.push(doc);
           }
 
           currentLevel = currentLevel[folder].children;
         }
       } else {
-        if (!isIndexFile) {
-          standalone.push(doc);
-        }
+        standalone.push(doc);
       }
     });
 

package/dist/mdx-components.d.ts

@@ -0,0 +1,22 @@
+/**
+ * MDX/mdsvex component map for Specra documentation.
+ *
+ * In mdsvex, custom components are imported directly in .svx files.
+ * This file exports the component map for programmatic use.
+ *
+ * Usage in .svx files:
+ * ```svelte
+ * <script>
+ *   import { Callout, CodeBlock, Tabs, Tab } from 'specra/components'
+ * </script>
+ *
+ * <Callout type="info">This is a callout</Callout>
+ * ```
+ */
+import type { Component } from 'svelte';
+import { Callout, Accordion, AccordionItem, Tabs, Tab, Image, Video, Card, CardGrid, ImageCard, ImageCardGrid, Steps, Step, Icon, Mermaid, Math, Columns, Column, DocBadge, Tooltip, Frame, CodeBlock, Timeline, TimelineItem, ApiEndpoint, ApiParams, ApiResponse, ApiPlayground, ApiReference } from './components/docs';
+export { Callout, Accordion, AccordionItem, Tabs, Tab, Image, Video, Card, CardGrid, ImageCard, ImageCardGrid, Steps, Step, Icon, Mermaid, Math, Columns, Column, DocBadge, Tooltip, Frame, CodeBlock, Timeline, TimelineItem, ApiEndpoint, ApiParams, ApiResponse, ApiPlayground, ApiReference, };
+/**
+ * Component map for passing to layout components that render MDX content.
+ */
+export declare const mdxComponents: Record<string, Component>;

package/dist/mdx-security.js

@@ -44,22 +44,23 @@ export function validatePathWithinDirectory(filePath, allowedDir) {
  * These patterns can execute arbitrary code during SSR
  */
 const DANGEROUS_PATTERNS = [
-    // JavaScript execution
-    /eval\s*\(/gi,
-    /Function\s*\(/gi,
-    /import\s*\(/gi,
-    /require\s*\(/gi,
+    // JavaScript execution — require expression context (after { ; = or line start)
+    // to avoid false positives on prose like "bulk import (CSV...)" or "fetch (data)"
+    /(?:^|[{;=,])\s*eval\s*\(/gim,
+    /(?:^|[{;=,])\s*Function\s*\(/gim,
+    /(?:^|[{;=,])\s*import\s*\(/gim,
+    /(?:^|[{;=,])\s*require\s*\(/gim,
     // File system access
     /fs\.[a-z]+/gi,
-    /readFile/gi,
-    /writeFile/gi,
+    /(?:^|[{;=,])\s*readFile/gim,
+    /(?:^|[{;=,])\s*writeFile/gim,
     /process\.env/gi,
-    // Network requests during SSR (legitimate client-side usage should use components)
-    /fetch\s*\(/gi,
+    // Network requests during SSR — require expression context
+    /(?:^|[{;=,])\s*fetch\s*\(/gim,
     // Dangerous Node.js modules
     /child_process/gi,
-    /exec\s*\(/gi,
-    /spawn\s*\(/gi,
+    /(?:^|[{;=,])\s*exec\s*\(/gim,
+    /(?:^|[{;=,])\s*spawn\s*\(/gim,
     // Script tag injection
     /<script[>\s]/gi,
     /javascript:/gi,

package/dist/sidebar-utils.js

@@ -79,13 +79,10 @@ export function buildSidebarStructure(docs) {
                 };
             }
             if (isIndexFile) {
-                // Use categoryPosition if available (from _category_.json), otherwise sidebar_position from frontmatter
                 rootGroups[groupName].position = doc.categoryPosition ?? doc.meta.sidebar_position ?? 999;
                 rootGroups[groupName].icon = doc.categoryIcon;
             }
-            else {
-                rootGroups[groupName].items.push(doc);
-            }
+            rootGroups[groupName].items.push(doc);
             return;
         }
         if (pathParts.length > 1) {
@@ -127,17 +124,13 @@ export function buildSidebarStructure(docs) {
                             currentLevel[folder].defaultCollapsed = doc.categoryCollapsed;
                         }
                     }
-                    else {
-                        currentLevel[folder].items.push(doc);
-                    }
+                    currentLevel[folder].items.push(doc);
                 }
                 currentLevel = currentLevel[folder].children;
             }
         }
         else {
-            if (!isIndexFile) {
-                standalone.push(doc);
-            }
+            standalone.push(doc);
         }
     });
     return { rootGroups, standalone };

package/dist/styles/globals.css

@@ -159,28 +159,39 @@
     text-decoration: none;
   }
 
-  /* Link styling - primary color, no underline until hover */
+  /* Prose text links - underlined for readability */
   main .prose a {
     color: var(--color-primary);
-    text-decoration: none;
-    transition: color 0.2s ease, text-decoration 0.2s ease;
+    text-decoration: underline;
+    text-underline-offset: 3px;
+    text-decoration-thickness: 1px;
+    text-decoration-color: color-mix(in srgb, var(--color-primary) 40%, transparent);
+    transition: text-decoration-color 0.2s ease;
   }
 
   main .prose a:hover {
-    text-decoration: none !important;
-    color: var(--color-primary);
+    text-decoration-color: var(--color-primary);
   }
 
-  /* Prose links in documentation */
   .prose a {
     color: var(--color-primary);
-    text-decoration: none !important;
+    text-decoration: underline;
+    text-underline-offset: 3px;
+    text-decoration-thickness: 1px;
+    text-decoration-color: color-mix(in srgb, var(--color-primary) 40%, transparent);
     font-weight: 500;
   }
 
   .prose a:hover {
+    text-decoration-color: var(--color-primary);
+  }
+
+  /* Navigation/UI links inside prose - no underline */
+  .prose .not-prose a,
+  .prose nav a,
+  .prose [data-doc-nav] a,
+  .prose .doc-navigation a {
     text-decoration: none !important;
-    color: var(--color-primary);
   }
 
   /* Sidebar links - no underline on hover */

package/package.json

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