Table of Contents System

/**
 * Table of contents item with hierarchical navigation structure
 */
interface TocItem {
  /** Slide number */
  no: number;
  /** Whether this item is currently active */
  active?: boolean;
  /** Whether this item is an active parent (has active children) */
  activeParent?: boolean;
  /** Child TOC items for nested structure */
  children: TocItem[];
  /** Whether this item has an active parent */
  hasActiveParent?: boolean;
  /** Nesting level in the hierarchy */
  level: number;
  /** Title level (heading level: 1-6) */
  titleLevel: number;
  /** Navigation path for this item */
  path: string;
  /** Whether to hide this item in TOC display */
  hideInToc?: boolean;
  /** Display title for this item */
  title?: string;
}

import type { TocItem } from "@slidev/types";

// Example TOC structure
const tocStructure: TocItem[] = [
  {
    no: 1,
    active: true,
    activeParent: false,
    children: [],
    hasActiveParent: false,
    level: 0,
    titleLevel: 1,
    path: "/1",
    hideInToc: false,
    title: "Introduction"
  },
  {
    no: 2,
    active: false,
    activeParent: true,
    children: [
      {
        no: 3,
        active: false,
        activeParent: false,
        children: [],
        hasActiveParent: true,
        level: 1,
        titleLevel: 2,
        path: "/3",
        hideInToc: false,
        title: "Getting Started"
      }
    ],
    hasActiveParent: false,
    level: 0,
    titleLevel: 1,
    path: "/2",
    hideInToc: false,
    title: "Tutorial"
  }
];

// Function to find active TOC item
function findActiveTocItem(toc: TocItem[]): TocItem | null {
  for (const item of toc) {
    if (item.active) return item;
    
    const activeChild = findActiveTocItem(item.children);
    if (activeChild) return activeChild;
  }
  return null;
}

// Function to build TOC navigation path
function buildTocPath(item: TocItem): string[] {
  const path = [item.title || `Slide ${item.no}`];
  
  // This would typically traverse up the parent chain
  // Implementation depends on how parent references are maintained
  
  return path.reverse();
}

// Function to filter visible TOC items
function filterVisibleTocItems(toc: TocItem[]): TocItem[] {
  return toc
    .filter(item => !item.hideInToc)
    .map(item => ({
      ...item,
      children: filterVisibleTocItems(item.children)
    }));
}