Function generateTocForFiles

generateTocForFiles(
filePaths: readonly string[],
options?: Readonly<Partial<TocOperationOptions>>,
): Promise<TocResult>
Generate and insert table of contents into markdown files.

Analyzes markdown files to extract headings and generates a formatted table of contents that can be inserted at various positions within the file.
Parameters
- filePaths: readonly string[]
  Array of file paths to process
- options: Readonly<Partial<TocOperationOptions>> = {}
  TOC generation configuration options
Returns Promise<TocResult>
Promise resolving to generation results
Example
Basic TOC generation
```
  const result = await generateToc(['README.md'], {
      position: 'after-title',
      minDepth: 2,
      maxDepth: 4
  });

  console.log(`Added TOC to ${result.filesModified} files`);
```
Example
Replace existing TOC
```
  const result = await generateToc(['docs/*.md'], {
      position: 'replace',
      marker: '',
      skipEmpty: true
  });
```
- Defined in commands/toc.ts:152