@asafarim/direxpo-core

Pure utilities for file discovery and folder tree generation. No runtime dependencies.

Features

• File Discovery: Recursively discover files with filtering options
• Tree Building: Generate folder structure trees
• Smart Exclusions: Automatic exclusion of common directories (node_modules, .git, etc.)
• Type-Safe: Full TypeScript support

🎯 Live Demo

See the package in action: direxpo-core Demo

The demo showcases 8 different use cases with code examples and live output.

Installation

pnpm add @asafarim/direxpo-core

Usage

Discover Files

import { discoverFiles } from '@asafarim/direxpo-core';

const files = await discoverFiles({
  targetPath: './src',
  filter: 'tsx',
  exclude: ['tests', '__mocks__'],
  maxSize: 5 // MB
});

Generate Tree

import { generateTreeSection } from '@asafarim/direxpo-core';

const treeMarkdown = generateTreeSection(files, './src');
console.log(treeMarkdown);

API

discoverFiles(options: DiscoverOptions): Promise<string[]>

Discovers files matching the specified criteria.

Options:

• targetPath: string - Directory to scan
• filter?: FilterType - File type filter ('all' | 'tsx' | 'css' | 'md' | 'json' | 'glob')
• pattern?: string - Glob pattern (when filter is 'glob')
• exclude?: string[] - Directories to exclude
• maxSize?: number - Maximum file size in MB

generateTreeSection(filePaths: string[], basePath: string): string

Generates a markdown tree structure from file paths.

buildFolderTree(filePaths: string[], basePath: string): TreeNode

Builds a tree data structure from file paths.

renderTreeToMarkdown(node: TreeNode): string

Renders a tree node to markdown format.

License

MIT