specra 0.2.64 → 0.2.66

package/dist/components/docs/SidebarMenuItems.svelte

@@ -5,6 +5,7 @@
   import type { SpecraConfig } from '../../config.types.js';
   import Icon from './Icon.svelte';
   import { sortSidebarItems, sortSidebarGroups } from '../../sidebar-utils.js';
+  import { renderInlineCode } from '../../inline.js';
 
   interface DocItem {
     title: string;
@@ -302,7 +303,7 @@
         {#if group.icon}
           <Icon icon={group.icon} size={16} className="shrink-0" />
         {/if}
-        {group.label}
+        {@html renderInlineCode(group.label)}
       </a>
 
       {#if hasContent && group.collapsible && config.navigation?.collapsibleSidebar}
@@ -342,7 +343,7 @@
               {#if item.doc.meta?.icon}
                 <Icon icon={item.doc.meta.icon} size={16} className="shrink-0" />
               {/if}
-              {item.doc.title}
+              {@html renderInlineCode(item.doc.title)}
               {#if item.doc.meta?.isProtected}
                 <Lock size={14} class="shrink-0 text-muted-foreground ml-auto" />
               {/if}
@@ -369,7 +370,7 @@
         {#if doc.meta?.icon}
           <Icon icon={doc.meta.icon} size={16} className="shrink-0" />
         {/if}
-        {doc.title}
+        {@html renderInlineCode(doc.title)}
         {#if doc.meta?.isProtected}
           <Lock size={14} class="shrink-0 text-muted-foreground ml-auto" />
         {/if}

package/dist/components/docs/TableOfContents.svelte

@@ -2,6 +2,7 @@
   import { browser } from '$app/environment';
   import type { SpecraConfig } from '../../config.types.js';
   import type { TOCItem } from '../../toc.js';
+  import { renderInlineCode } from '../../inline.js';
 
   interface Props {
     items: TOCItem[];
@@ -84,7 +85,7 @@
               ? 'text-primary font-medium'
               : 'text-foreground hover:bg-accent/50'}"
           >
-            {item.title}
+            {@html renderInlineCode(item.title)}
           </a>
         {/each}
       </nav>

package/dist/index.d.ts

@@ -12,6 +12,7 @@ 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 './inline.js';
 export * from './sidebar-utils.js';
 export * from './category.js';
 export * from './redirects.js';

package/dist/index.js

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

package/dist/inline.d.ts

@@ -0,0 +1 @@
+export declare function renderInlineCode(text: string): string;

package/dist/inline.js

@@ -0,0 +1,32 @@
+/**
+ * Render a plain label string that may contain inline-code markdown
+ * (backtick-delimited spans) into safe HTML, turning `` `code` `` into
+ * `<code>code</code>`. Used for TOC entries and sidebar labels, which come from
+ * headings / frontmatter titles as raw text - without this they show the literal
+ * backticks instead of formatted code.
+ *
+ * Everything is HTML-escaped (both the surrounding text and the code content),
+ * so the result is safe to use with `{@html}`. Only inline code is handled; no
+ * other markdown is interpreted.
+ */
+function escapeHtml(s) {
+    return s
+        .replace(/&/g, '&amp;')
+        .replace(/</g, '&lt;')
+        .replace(/>/g, '&gt;');
+}
+export function renderInlineCode(text) {
+    if (!text)
+        return '';
+    let out = '';
+    let last = 0;
+    const re = /`([^`]+)`/g;
+    let m;
+    while ((m = re.exec(text)) !== null) {
+        out += escapeHtml(text.slice(last, m.index));
+        out += `<code>${escapeHtml(m[1])}</code>`;
+        last = m.index + m[0].length;
+    }
+    out += escapeHtml(text.slice(last));
+    return out;
+}

package/dist/mdx.js

@@ -1078,11 +1078,15 @@ function dedentComponentChildren(markdown) {
                 minIndent = indent;
         }
         if (minIndent > 0 && minIndent !== Infinity) {
-            // Dedent non-code-fence lines by the common indent.
-            // Code fence lines are left as-is to preserve their content.
-            const dedented = lines.map((line, i) => {
-                if (codeFenceLines.has(i))
-                    return line;
+            // Dedent every non-empty line by the common indent, including code-fence
+            // lines and their content. Code lines are excluded from the min-indent
+            // *calculation* above (so a column-0 code line doesn't pin minIndent to 0),
+            // but they must still be dedented here: leaving an indented fence at its
+            // original column (e.g. 4 spaces) turns it into a CommonMark *indented*
+            // code block (fences allow <=3 spaces of indent), which renders the raw
+            // ```lang fence literally. The Math.min cap strips only the shared wrapper
+            // indent, never a line's meaningful internal indentation.
+            const dedented = lines.map((line) => {
                 if (line.trim().length === 0)
                     return line;
                 return line.slice(Math.min(minIndent, line.match(/^(\s*)/)?.[1].length ?? 0));

package/package.json

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