specra 0.2.66 → 0.2.68

package/dist/rehype-changelog-ids.js

@@ -0,0 +1,43 @@
+import GithubSlugger from 'github-slugger';
+const HEADING_TAG = /^h[1-6]$/;
+/** Concatenate the text nodes beneath a node, as hast-util-to-string would. */
+function textContent(node) {
+    if (node.type === 'text')
+        return String(node.value ?? '');
+    if (Array.isArray(node.children))
+        return node.children.map(textContent).join('');
+    return '';
+}
+/** Preorder walk over element nodes, i.e. document order. */
+function walkElements(nodes, fn) {
+    for (const node of nodes) {
+        if (node.type !== 'element')
+            continue;
+        fn(node);
+        if (node.children) {
+            walkElements(node.children, fn);
+        }
+    }
+}
+export function rehypeChangelogIds() {
+    return (tree) => {
+        const slugger = new GithubSlugger();
+        walkElements(tree.children, (node) => {
+            // Consume the name rehype-slug already consumed for this heading, keeping
+            // the two occurrence counters aligned. The return value is discarded —
+            // rehype-slug owns the heading's actual id.
+            if (HEADING_TAG.test(node.tagName)) {
+                slugger.slug(textContent(node));
+                return;
+            }
+            if (node.tagName !== 'update')
+                return;
+            const label = node.properties?.label;
+            // A label-less update has no identity to anchor. It still renders; it just
+            // gets no anchor, no ToC entry and no feed item.
+            if (typeof label !== 'string' || !label.trim())
+                return;
+            node.properties = { ...node.properties, id: slugger.slug(label.trim()) };
+        });
+    };
+}

package/dist/sidebar-utils.d.ts

@@ -3,10 +3,12 @@
  * This module provides consistent sidebar logic across the application
  * to ensure ordering is handled the same way everywhere.
  */
+import type { BadgeInput } from "./badges.js";
 export interface SidebarGroup {
     label: string;
     path: string;
     icon?: string;
+    badge?: BadgeInput;
     items: any[];
     position: number;
     collapsible: boolean;
@@ -50,6 +52,7 @@ export declare function buildSidebarStructure<T extends {
     categoryLabel?: string;
     categoryPosition?: number;
     categoryIcon?: string;
+    categoryBadge?: BadgeInput;
     categoryCollapsible?: boolean;
     categoryCollapsed?: boolean;
     meta: any;

package/dist/sidebar-utils.js

@@ -49,11 +49,14 @@ export function buildSidebarStructure(docs) {
     docs.forEach((doc) => {
         const pathParts = doc.filePath.split("/");
         const folderPath = pathParts.length > 1 ? pathParts.slice(0, -1).join("/") : "";
-        if (folderPath && doc.categoryLabel) {
+        // A `_category_.json` may set a badge without setting a label, so keying
+        // this purely off `categoryLabel` would silently drop the badge.
+        if (folderPath && (doc.categoryLabel || doc.categoryBadge)) {
             categoryMetadata.set(folderPath, {
                 label: doc.categoryLabel,
                 position: doc.categoryPosition,
                 icon: doc.categoryIcon,
+                badge: doc.categoryBadge,
                 collapsible: doc.categoryCollapsible,
                 collapsed: doc.categoryCollapsed
             });
@@ -100,6 +103,7 @@ export function buildSidebarStructure(docs) {
                         label: metadata?.label ?? folderLabel,
                         path: currentPath,
                         icon: metadata?.icon,
+                        badge: metadata?.badge,
                         items: [],
                         position: metadata?.position ?? 999,
                         collapsible: metadata?.collapsible ?? true,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "specra",
-  "version": "0.2.66",
+  "version": "0.2.68",
   "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",
@@ -81,6 +81,7 @@
     "clsx": "^2.1.1",
     "date-fns": "^4.1.0",
     "embla-carousel-svelte": "^8.5.1",
+    "github-slugger": "^2.0.0",
     "gray-matter": "^4.0.3",
     "hast-util-to-html": "^9.0.0",
     "js-yaml": "^4.1.1",