@nojaja/dirwalker 1.0.0 → 1.0.2

package/LICENSE

@@ -1,21 +1,21 @@
-MIT License
-
-Copyright (c) 2026 nojaja
-
-Permission is hereby granted, free of charge, to any person obtaining a copy
-of this software and associated documentation files (the "Software"), to deal
-in the Software without restriction, including without limitation the rights
-to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
-copies of the Software, and to permit persons to whom the Software is
-furnished to do so, subject to the following conditions:
-
-The above copyright notice and this permission notice shall be included in all
-copies or substantial portions of the Software.
-
-THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
-IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
-FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
-AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
-LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
-OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
-SOFTWARE.
+MIT License
+
+Copyright (c) 2026 nojaja
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -1,547 +1,181 @@
-# dir-walker
-
-A lightweight, flexible directory walker utility for Node.js with pattern matching support.
-
-## Overview
-
-**dir-walker** is a TypeScript-based utility for recursively walking through file systems with built-in pattern matching capabilities. It provides a simple, efficient, and safe API for traversing directories while filtering out unwanted files and directories using regular expressions.
-
-## Features
-
-- 🚀 **Fast & Efficient**: Asynchronous recursive directory traversal with proper error handling
-- 🎯 **Pattern Matching**: Built-in support for excluding directories and file extensions using RegExp patterns
-- 🔒 **Safe**: Automatically skips symbolic links to prevent infinite loops and circular references
-- 📦 **Zero Dependencies**: No external runtime dependencies - fully self-contained
-- 🎨 **TypeScript**: Full TypeScript support with comprehensive type definitions and JSDoc annotations
-- ⚡ **ESM Ready**: Native ES Module support with proper bundling for both CommonJS and UMD environments
-- 🐛 **Debug Mode**: Optional debug logging to track directory traversal and pattern matching
-- 📊 **Async-first**: Supports both synchronous and asynchronous file processing callbacks
-
-## Installation
-
-```bash
-npm install @nojaja/dirwalker
-```
-
-Or with yarn:
-
-```bash
-yarn add @nojaja/dirwalker
-```
-
-### Requirements
-
-- Node.js 18.0.0 or higher
-- npm 6.0.0 or higher (or yarn equivalent)
-
-## Quick Start
-
-```typescript
-import { DirWalker } from '@nojaja/dirwalker';
-
-const walker = new DirWalker();
-
-const fileCount = await walker.walk(
-  './my-directory',
-  {
-    excludeDirs: [/node_modules/, /\.git/],
-    excludeExt: [/\.log$/]
-  },
-  (relativePath, settings) => {
-    console.log('Found file:', relativePath);
-  },
-  (error) => {
-    console.error('Error:', error);
-  }
-);
-
-console.log(`Processed ${fileCount} files`);
-```
-
-## Project Structure
-
-```
-dir-walker/
-├── src/
-│   ├── DirWalker.ts       # Main directory walker class (247 lines)
-│   ├── PatternMatcher.ts  # Pattern matching utility (48 lines)
-│   └── index.ts           # Public API exports
-├── test/
-│   ├── unit/
-│   │   ├── DirWalker.test.ts      # DirWalker unit tests (336 cases)
-│   │   └── PatternMatcher.test.ts # PatternMatcher unit tests
-│   └── fixtures/                  # Test fixtures and sample data
-├── dist/                  # Compiled output (generated at build time)
-├── docs/                  # Generated API documentation (TypeDoc)
-├── package.json           # NPM configuration and scripts
-├── tsconfig.json          # TypeScript configuration (strict mode)
-├── webpack.config.js      # Webpack bundling configuration
-├── jest.unit.config.js    # Jest test configuration
-├── CHANGELOG.md           # Version history and release notes
-└── README.md              # This file
-```
-
-## Technology Stack
-
-- **Language**: TypeScript 5.3.3 (strict mode enabled)
-- **Runtime**: Node.js 18.0.0+
-- **Bundler**: Webpack 5.99.8 (UMD + CommonJS bundling)
-- **Test Framework**: Jest 29.6.1 with ts-jest
-- **Type Checking**: TypeScript with strict mode
-- **Linting**: ESLint 8.45.0 with TypeScript support
-- **Code Style**: Prettier 3.0.0
-- **Documentation**: TypeDoc 0.28.15
-
-## API Reference
-
-### Class: `DirWalker`
-
-The main class for directory walking operations. Exports a default instance and named export.
-
-#### Constructor
-
-```typescript
-constructor(debug?: boolean)
-```
-
-**Parameters:**
-- `debug` (optional, boolean): Enable debug logging for traversal operations. Default: `false`
-
-**Example:**
-```typescript
-const walker = new DirWalker();           // Default, no debug
-const walkerDebug = new DirWalker(true);  // With debug logging enabled
-```
-
-#### Methods
-
-##### `walk(targetPath, settings, fileCallback, errCallback): Promise<number>`
-
-Recursively walks through a directory and processes files matching the specified criteria.
-
-**Parameters:**
-
-| Parameter | Type | Description |
-|-----------|------|-------------|
-| `targetPath` | `string` | Root directory path (absolute or relative). The callback receives relative paths from this base. |
-| `settings` | `WalkSettings` | Configuration object with exclude patterns. Both fields are optional and default to empty arrays. |
-| `fileCallback` | `FileCallback` | Called for each matched file. Supports async operations. |
-| `errCallback` | `ErrorCallback` (optional) | Called when errors occur during traversal. If omitted, errors are logged. |
-
-**Returns:** `Promise<number>` - Total count of files processed (matched)
-
-**WalkSettings Interface:**
-```typescript
-interface WalkSettings {
-  excludeDirs?: RegExp[];    // Patterns to exclude directories
-  excludeExt?: RegExp[];     // Patterns to exclude file extensions
-}
-```
-
-**FileCallback Type:**
-```typescript
-type FileCallback = (
-  relativePath: string,      // Relative path from targetPath
-  settings: WalkSettings     // Settings object used
-) => void | Promise<void>;   // Can be synchronous or async
-```
-
-**ErrorCallback Type:**
-```typescript
-type ErrorCallback = (error: Error) => void;
-```
-
-### Class: `PatternMatcher`
-
-Utility class for pattern matching operations. Typically used internally by DirWalker.
-
-#### Constructor
-
-```typescript
-constructor(debug?: boolean)
-```
-
-#### Methods
-
-##### `match(text: string, patterns?: RegExp[]): boolean`
-
-Tests if text matches any of the provided patterns.
-
-**Parameters:**
-- `text` - The string to test
-- `patterns` - Array of RegExp patterns to match against
-
-**Returns:** `true` if any pattern matches, `false` otherwise
-
-##### `matchEx(text: string, patterns?: RegExp[]): RegExp | null`
-
-Tests if text matches any patterns and returns the matching pattern.
-
-**Parameters:**
-- `text` - The string to test
-- `patterns` - Array of RegExp patterns to match against
-
-**Returns:** The matching RegExp object or `null` if no match found
-
-## Usage Examples
-
-### Basic Usage - Simple File Listing
-
-```typescript
-import { DirWalker } from '@nojaja/dirwalker';
-
-const walker = new DirWalker();
-const fileCount = await walker.walk(
-  './src',
-  {},
-  (relativePath) => {
-    console.log(relativePath);
-  },
-  (error) => {
-    console.error('Error:', error);
-  }
-);
-
-console.log(`Total files processed: ${fileCount}`);
-```
-
-### Excluding Directories
-
-Common patterns to exclude:
-
-```typescript
-const walker = new DirWalker();
-
-await walker.walk(
-  './project',
-  {
-    excludeDirs: [
-      /node_modules/,     // npm dependencies
-      /\.git/,            // git repository
-      /dist/,             // build output
-      /coverage/,         // test coverage
-      /__pycache__/,      // Python cache
-      /\.next/,           // Next.js build
-      /\.venv/            // Python virtual env
-    ]
-  },
-  (relativePath) => {
-    console.log('Source file:', relativePath);
-  }
-);
-```
-
-**Note:** Directory patterns match the full file path, so `node_modules` will match any "node_modules" directory at any level.
-
-### Filtering by File Extension
-
-```typescript
-const walker = new DirWalker();
-
-await walker.walk(
-  './src',
-  {
-    excludeExt: [
-      /\.test\.ts$/,      // Jest test files
-      /\.spec\.ts$/,      // Jasmine spec files
-      /\.d\.ts$/,         // TypeScript declarations
-      /\.map$/,           // Source maps
-      /\.log$/            // Log files
-    ]
-  },
-  (relativePath) => {
-    console.log('Production file:', relativePath);
-  }
-);
-```
-
-### Combining Directory and Extension Filters
-
-```typescript
-const walker = new DirWalker();
-
-await walker.walk(
-  './project',
-  {
-    excludeDirs: [/node_modules/, /\.git/, /dist/],
-    excludeExt: [/\.test\.ts$/, /\.d\.ts$/, /\.log$/]
-  },
-  (relativePath) => {
-    console.log('Production source:', relativePath);
-  }
-);
-```
-
-### Processing Files with Async Operations
-
-```typescript
-import { DirWalker } from '@nojaja/dirwalker';
-import { readFile } from 'fs/promises';
-import * as path from 'path';
-
-const walker = new DirWalker();
-const results = [];
-
-await walker.walk(
-  './docs',
-  {
-    excludeExt: [/^(?!.*\.md$)/]  // Only markdown files
-  },
-  async (filePath) => {
-    try {
-      const content = await readFile(filePath, 'utf-8');
-      results.push({
-        file: filePath,
-        lines: content.split('\n').length,
-        size: content.length
-      });
-    } catch (error) {
-      console.error(`Failed to read ${filePath}:`, error);
-    }
-  },
-  (error) => {
-    console.error('Walk error:', error);
-  }
-);
-
-console.log('Results:', results);
-```
-
-### Counting Files by Extension
-
-```typescript
-import * as path from 'path';
-
-const walker = new DirWalker();
-const stats = new Map<string, number>();
-
-await walker.walk(
-  './src',
-  { excludeDirs: [/node_modules/] },
-  (filePath) => {
-    const ext = path.extname(filePath) || '(no extension)';
-    stats.set(ext, (stats.get(ext) || 0) + 1);
-  }
-);
-
-console.log('Files by extension:');
-for (const [ext, count] of stats) {
-  console.log(`  ${ext}: ${count}`);
-}
-```
-
-### Debug Mode
-
-Enable debug logging to track directory traversal:
-
-```typescript
-import { DirWalker } from '@nojaja/dirwalker';
-
-const walker = new DirWalker(true);  // Enable debug logging
-
-await walker.walk(
-  './src',
-  { excludeDirs: [/node_modules/] },
-  (file) => {
-    console.log('Processing:', file);
-  }
-);
-
-// Debug output example:
-// シンボリックリンクをスキップ: /path/to/symlink
-// ファイル発見: /path/to/file.ts
-// ディレクトリ読み取りエラー: ... (if any)
-```
-
-## Error Handling
-
-The library provides flexible error handling through callbacks:
-
-### Method 1: Error Callback
-
-```typescript
-await walker.walk(
-  './src',
-  {},
-  (relativePath) => {
-    console.log('Processing:', relativePath);
-  },
-  (error) => {
-    // Custom error handling
-    console.error('Walk error:', error.message);
-    // Log to file, send alert, etc.
-  }
-);
-```
-
-### Method 2: Default Logging
-
-If no error callback is provided, errors are logged automatically:
-
-```typescript
-await walker.walk(
-  './src',
-  {},
-  (relativePath) => {
-    console.log('Processing:', relativePath);
-  }
-  // Errors will be logged to console automatically
-);
-```
-
-### Error Scenarios Handled
-
-- **Directory not found** - Directory read error (ENOENT)
-- **Permission denied** - File access errors (EACCES)
-- **Invalid path** - Stat operation failures
-- **Symbolic links** - Automatically skipped (not an error)
-- **RegExp errors** - Caught and logged in debug mode
-
-## Development Setup
-
-### Prerequisites
-
-- Node.js 18.0.0 or higher
-- npm 10.8.2 or yarn equivalent
-
-### Installation
-
-```bash
-# Clone repository
-git clone https://github.com/nojaja/dir-walker.git
-cd dir-walker
-
-# Install dependencies
-npm install
-```
-
-### Development Commands
-
-```bash
-# Run unit tests
-npm run test
-
-# Run tests with coverage report
-npm run test:ci
-
-# TypeScript type checking
-npm run type-check
-
-# Linting with ESLint
-npm run lint
-
-# Build production bundle
-npm run build
-
-# Build development bundle (with source maps)
-npm run build:dev
-
-# Generate API documentation
-npm run docs
-
-# Analyze dependency health
-npm run depcruise
-
-# Clean build artifacts
-npm run clean
-```
-
-### Build Output
-
-The build process generates:
-- **dist/dirwalker.bundle.js** - UMD bundle for universal compatibility
-- **dist/index.d.ts** - TypeScript type definitions
-- **dist/** - Other compiled modules
-
-### Project Scripts Reference
-
-| Script | Purpose |
-|--------|---------|
-| `build` | Production-optimized Webpack bundle |
-| `build:dev` | Development bundle with source maps |
-| `test` | Run Jest unit tests |
-| `test:ci` | Run tests with coverage reporting |
-| `type-check` | TypeScript type checking |
-| `lint` | ESLint code quality check |
-| `clean` | Remove dist/ directory |
-| `depcruise` | Dependency graph analysis |
-| `docs` | Generate TypeDoc HTML documentation |
-
-## TypeScript Support
-
-Full TypeScript definitions are included:
-
-```typescript
-import { 
-  DirWalker, 
-  WalkSettings, 
-  FileCallback, 
-  ErrorCallback 
-} from '@nojaja/dirwalker';
-
-const settings: WalkSettings = {
-  excludeDirs: [/node_modules/, /\.git/],
-  excludeExt: [/\.log$/, /\.tmp$/]
-};
-
-const fileCallback: FileCallback = async (relativePath, settings) => {
-  console.log(`Processing: ${relativePath}`);
-};
-
-const errorCallback: ErrorCallback = (error) => {
-  console.error(`Error: ${error.message}`);
-};
-
-const walker = new DirWalker();
-await walker.walk('./src', settings, fileCallback, errorCallback);
-```
-
-## Current Status
-
-**Version**: 1.0.0 (Initial Release)
-
-### ✅ Completed Features
-- Recursive directory traversal with async/await support
-- RegExp-based pattern matching for directories and file extensions
-- Symbolic link detection and automatic skipping
-- TypeScript with strict mode enabled
-- Comprehensive type definitions and JSDoc annotations
-- Debug mode for detailed logging
-- Unit tests with >80% code coverage
-- Zero external runtime dependencies
-- UMD bundle for universal compatibility
-- Webpack bundling configuration
-
-### Performance Characteristics
-- **Memory**: O(depth) - scales with directory tree depth
-- **Speed**: I/O bound - depends on file system performance
-- **Scalability**: Suitable for projects with thousands of files
-- **Async**: Non-blocking using fs/promises
-
-## License
-
-MIT
-
-## Author
-
-**nojaja** <free.riccia@gmail.com> ([GitHub](https://github.com/nojaja))
-
-## Contributing
-
-Contributions are welcome! Please feel free to submit a Pull Request.
-
-### Development Workflow
-
-1. Fork the repository
-2. Create a feature branch (`git checkout -b feature/amazing-feature`)
-3. Make your changes
-4. Run tests and linting (`npm run test && npm run lint`)
-5. Commit your changes (`git commit -m 'Add amazing feature'`)
-6. Push to the branch (`git push origin feature/amazing-feature`)
-7. Open a Pull Request
-
-## Repository
-
-- **Repository**: [GitHub - nojaja/dir-walker](https://github.com/nojaja/dir-walker)
-- **Issues**: [GitHub Issues](https://github.com/nojaja/dir-walker/issues)
-- **NPM Package**: [@nojaja/dirwalker](https://www.npmjs.com/package/@nojaja/dirwalker)
+yarn add @nojaja/dirwalker
+# @nojaja/dirwalker
+
+Lightweight, callback-first directory walker for Node.js. Provides recursive traversal with RegExp-based exclusion for directories and extensions, returns relative file paths, and ships with TypeScript types out of the box.
+
+## Project Overview
+
+- Purpose: walk a directory tree asynchronously and execute your callback for each file while skipping symlinks and unwanted paths.
+- Package: `@nojaja/dirwalker` (`type: commonjs`, main: `dist/dirwalker.bundle.js`).
+- Current version: 1.0.1.
+
+## Project Structure
+
+```
+.
+├── src/
+│   ├── DirWalker.ts          # Core implementation and exported types
+│   └── index.ts              # Public export surface
+├── test/
+│   ├── unit/DirWalker.test.ts# Jest unit tests (mocked fs/promises)
+│   └── fixtures/             # Fixture roots for tests
+├── dist/                     # Build artifacts (generated)
+├── docs/                     # Generated API docs (typedoc)
+├── dependency-extractor/     # Separate dependency extraction tool (see its README)
+├── webpack.config.js         # Webpack bundle settings
+├── jest.unit.config.js       # Jest config for unit tests
+├── tsconfig.json             # TypeScript config (strict)
+├── package.json              # Scripts and metadata
+└── README.md
+```
+
+## Technology Stack
+
+- TypeScript 5.3.3 (strict) on Node.js >=18
+- Webpack 5.99.8 for production and development bundles
+- Jest 29.6.1 with ts-jest for unit tests
+- ESLint 8.45.0 + TypeScript ESLint, Prettier 3.0.0
+- Runtime deps: `@nojaja/greputil` (RegExpArray helper), `@nojaja/pathutil`
+
+## Features
+
+### Completed
+- Async recursive traversal using `fs/promises`
+- Exclude directories and extensions with RegExp arrays
+- Skips symbolic links to avoid cycles
+- Passes relative paths to your callback
+- Optional debug logging (console.debug)
+- Error handling via callback or default console.error
+- Bundled output (`dist/dirwalker.bundle.js`) plus `.d.ts` types
+
+### Limitations / Not Included
+- Only exclusion filters are supported (no include/allowlist API)
+- No synchronous API; traversal is async-only
+- No built-in CLI; use the library programmatically
+
+## Installation
+
+```bash
+npm install @nojaja/dirwalker
+# or
+yarn add @nojaja/dirwalker
+```
+
+Requirements: Node.js 18+ and npm 10.8.2+.
+
+## Usage (Library)
+
+### Basic example
+
+```typescript
+import { DirWalker } from '@nojaja/dirwalker';
+
+const walker = new DirWalker();
+
+const count = await walker.walk(
+  './my-directory',
+  {},
+  (relativePath) => {
+    console.log(relativePath);
+  }
+);
+
+console.log(`Processed ${count} files`);
+```
+
+### Excluding directories and extensions
+
+```typescript
+const walker = new DirWalker();
+
+await walker.walk(
+  './project',
+  {
+    excludeDirs: [/node_modules/, /\.git/, /dist/],
+    excludeExt: [/\.log$/, /\.map$/]
+  },
+  (relativePath) => {
+    console.log('source file:', relativePath);
+  }
+);
+```
+
+### Handling errors explicitly
+
+```typescript
+const walker = new DirWalker(true); // enable debug logs
+
+await walker.walk(
+  './src',
+  {},
+  async (file) => {
+    // async work per file is allowed
+  },
+  (error) => {
+    // custom error handling
+    console.error('walk error:', error.message);
+  }
+);
+```
+
+### API reference
+
+| Export | Description |
+|--------|-------------|
+| `class DirWalker` | `constructor(debug?: boolean)` creates a walker instance. |
+| `walk(targetPath: string, settings: WalkSettings, fileCallback: FileCallback, errCallback?: ErrorCallback): Promise<number>` | Recursively traverses `targetPath`, executes `fileCallback` for each file, and returns the processed file count. |
+| `WalkSettings` | `{ excludeDirs?: RegExp[]; excludeExt?: RegExp[]; }` exclusion patterns. |
+| `FileCallback` | `(relativePath: string, settings: WalkSettings) => void | Promise<void>` receives the path relative to `targetPath`. |
+| `ErrorCallback` | `(error: Error) => void` invoked on errors; defaults to console.error when omitted. |
+
+## Development Setup
+
+### Local setup
+
+```bash
+git clone https://github.com/nojaja/NodeDirWalker.git
+cd NodeDirWalker
+npm install
+```
+
+### Scripts
+
+| Command | Description |
+|---------|-------------|
+| `npm run build` | Build production bundle (webpack, outputs to dist/). |
+| `npm run build:dev` | Build development bundle with source maps. |
+| `npm run test` | Run Jest unit tests (uses jest.unit.config.js). |
+| `npm run test:ci` | Run tests with coverage. |
+| `npm run test:coverage` | Run Jest with coverage via `--experimental-vm-modules`. |
+| `npm run lint` | ESLint TypeScript linting. |
+| `npm run type-check` | TypeScript type checking with `tsc --noEmit`. |
+| `npm run depcruise` | Dependency cruiser analysis. |
+| `npm run docs` | Generate typedoc output into docs/. |
+| `npm run clean` | Remove dist/. |
+
+## Technical Details
+
+- Uses `fs.promises.readdir` + `fs.promises.stat` for traversal; symlinks are skipped intentionally.
+- Pattern matching relies on `RegExpArray` from `@nojaja/greputil` for both directory and extension filters.
+- Callbacks receive file paths relative to the root you pass to `walk`.
+- Errors are surfaced via `ErrorCallback`; when omitted they are logged with Japanese messages for clarity.
+
+## Current Status
+
+- Package version: 1.0.1.
+- Scope: library-only; no CLI or web UI components.
+- Tests: unit coverage for traversal, exclusions, symlink skipping, debug logging, and error handling (see test/unit/DirWalker.test.ts).
+
+## Performance / Goals
+
+- Traversal is I/O bound; memory scales with directory depth (O(depth)).
+- Designed for thousands of files while keeping callbacks async to avoid blocking the event loop.
+
+## License & Author
+
+- License: MIT
+- Author: nojaja <free.riccia@gmail.com> (https://github.com/nojaja)
+
+## Related Projects
+
+- `dependency-extractor/`: companion tool (same repo) to detect project manifests and export dependency lists. See its README for usage.

package/dist/DirWalker.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"DirWalker.d.ts","sourceRoot":"","sources":["../src/DirWalker.ts"],"names":[],"mappings":"AAIA;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,yDAAyD;IACzD,WAAW,CAAC,EAAE,MAAM,EAAE,CAAC;IACvB,6DAA6D;IAC7D,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC;CACvB;AAED;;;;GAIG;AACH,MAAM,MAAM,YAAY,GAAG,CACzB,YAAY,EAAE,MAAM,EACpB,QAAQ,EAAE,YAAY,KACnB,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;AAE1B;;;GAGG;AACH,MAAM,MAAM,aAAa,GAAG,CAAC,KAAK,EAAE,KAAK,KAAK,IAAI,CAAC;AAEnD;;GAEG;AACH,qBAAa,SAAS;IACpB,OAAO,CAAC,KAAK,CAAU;IACvB,OAAO,CAAC,OAAO,CAAS;IAExB;;;OAGG;gBACS,KAAK,UAAQ;IAKzB;;;;;;;OAOG;IACG,IAAI,CACR,UAAU,EAAE,MAAM,EAClB,QAAQ,EAAE,YAAY,YAAsC,EAC5D,YAAY,EAAE,YAAY,EAC1B,WAAW,CAAC,EAAE,aAAa,GAC1B,OAAO,CAAC,MAAM,CAAC;IASlB;;;;;;;;;OASG;YACW,KAAK;IA0CnB;;;;;;;;;OASG;YACW,aAAa;IAyB3B;;;;;;;;;OASG;YACW,iBAAiB;IAmB/B;;;;;;;;;OASG;YACW,YAAY;IAmC1B;;;;;;;OAOG;IACH,OAAO,CAAC,YAAY;CAWrB;AAED,eAAe,SAAS,CAAC"}
+{"version":3,"file":"DirWalker.d.ts","sourceRoot":"","sources":["../src/DirWalker.ts"],"names":[],"mappings":"AAKA;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,yDAAyD;IACzD,WAAW,CAAC,EAAE,MAAM,EAAE,CAAC;IACvB,6DAA6D;IAC7D,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC;CACvB;AAED;;;;GAIG;AACH,MAAM,MAAM,YAAY,GAAG,CACzB,YAAY,EAAE,MAAM,EACpB,QAAQ,EAAE,YAAY,KACnB,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;AAE1B;;;GAGG;AACH,MAAM,MAAM,aAAa,GAAG,CAAC,KAAK,EAAE,KAAK,KAAK,IAAI,CAAC;AAEnD;;GAEG;AACH,qBAAa,SAAS;IACpB,OAAO,CAAC,KAAK,CAAU;IACvB,OAAO,CAAC,OAAO,CAAS;IAExB;;;OAGG;gBACS,KAAK,UAAQ;IAKzB;;;;;;;OAOG;IACG,IAAI,CACR,UAAU,EAAE,MAAM,EAClB,QAAQ,EAAE,YAAY,YAAsC,EAC5D,YAAY,EAAE,YAAY,EAC1B,WAAW,CAAC,EAAE,aAAa,GAC1B,OAAO,CAAC,MAAM,CAAC;IASlB;;;;;;;;;OASG;YACW,KAAK;IA+CnB;;;;;;;;;OASG;YACW,aAAa;IAyB3B;;;;;;;;;OASG;YACW,iBAAiB;IAmB/B;;;;;;;;;OASG;YACW,YAAY;IAmC1B;;;;;;;OAOG;IACH,OAAO,CAAC,YAAY;CAWrB;AAED,eAAe,SAAS,CAAC"}

package/dist/dirwalker.bundle.js

@@ -1 +1,2 @@
-!function(e,t){"object"==typeof exports&&"object"==typeof module?module.exports=t():"function"==typeof define&&define.amd?define([],t):"object"==typeof exports?exports.DirWalker=t():e.DirWalker=t()}(global,()=>{return e={141(e,t,r){"use strict";var n,s=this&&this.__createBinding||(Object.create?function(e,t,r,n){void 0===n&&(n=r);var s=Object.getOwnPropertyDescriptor(t,r);s&&!("get"in s?!t.__esModule:s.writable||s.configurable)||(s={enumerable:!0,get:function(){return t[r]}}),Object.defineProperty(e,n,s)}:function(e,t,r,n){void 0===n&&(n=r),e[n]=t[r]}),o=this&&this.__setModuleDefault||(Object.create?function(e,t){Object.defineProperty(e,"default",{enumerable:!0,value:t})}:function(e,t){e.default=t}),i=this&&this.__importStar||(n=function(e){return n=Object.getOwnPropertyNames||function(e){var t=[];for(var r in e)Object.prototype.hasOwnProperty.call(e,r)&&(t[t.length]=r);return t},n(e)},function(e){if(e&&e.__esModule)return e;var t={};if(null!=e)for(var r=n(e),i=0;i<r.length;i++)"default"!==r[i]&&s(t,e,r[i]);return o(t,e),t});Object.defineProperty(t,"__esModule",{value:!0}),t.DirWalker=void 0;const a=i(r(943)),c=i(r(928)),u=r(576);class l{debug;counter;constructor(e=!1){this.debug=e,this.counter=0}async walk(e,t={excludeDirs:[],excludeExt:[]},r,n){this.counter=0;const s={...t};return await this._walk(e,e,s,r,n),this.counter}async _walk(e,t,r,n,s){try{const o=await a.readdir(e);for(const i of o){const o=c.resolve(e,i);try{await this._processEntry(o,t,r,n,s)}catch(e){this._handleError(`ファイル処理エラー: ${o}`,e,s)}}}catch(t){this._handleError(`ディレクトリ読み取りエラー: ${e}`,t,s)}}async _processEntry(e,t,r,n,s){const o=await a.stat(e);o.isSymbolicLink()?this.debug&&console.debug(`シンボリックリンクをスキップ: ${e}`):o.isDirectory()?await this._processDirectory(e,t,r,n,s):await this._processFile(e,t,r,n,s)}async _processDirectory(e,t,r,n,s){r.excludeDirs&&r.excludeDirs.length>0&&new u.RegExpArray(r.excludeDirs).test(e)||await this._walk(e,t,r,n,s)}async _processFile(e,t,r,n,s){if(r.excludeExt&&r.excludeExt.length>0&&new u.RegExpArray(r.excludeExt).test(e))return;this.counter++,this.debug&&console.debug(`ファイル発見: ${e}`);const o=c.relative(t,e);try{await n(o,r)}catch(t){this._handleError(`ファイル処理エラー: ${e}`,t,s)}}_handleError(e,t,r){"function"==typeof r?r(t):console.error(`${e}: ${t.message}`)}}t.DirWalker=l,t.default=l},156(e,t,r){"use strict";var n=this&&this.__importDefault||function(e){return e&&e.__esModule?e:{default:e}};Object.defineProperty(t,"__esModule",{value:!0}),t.default=t.DirWalker=void 0;var s=r(141);Object.defineProperty(t,"DirWalker",{enumerable:!0,get:function(){return s.DirWalker}}),Object.defineProperty(t,"default",{enumerable:!0,get:function(){return n(s).default}})},576(e){var t;t=()=>(()=>{"use strict";var e={d:(t,r)=>{for(var n in r)e.o(r,n)&&!e.o(t,n)&&Object.defineProperty(t,n,{enumerable:!0,get:r[n]})},o:(e,t)=>Object.prototype.hasOwnProperty.call(e,t),r:e=>{"undefined"!=typeof Symbol&&Symbol.toStringTag&&Object.defineProperty(e,Symbol.toStringTag,{value:"Module"}),Object.defineProperty(e,"__esModule",{value:!0})}},t={};e.r(t),e.d(t,{BufferPatternMatcher:()=>n,RegExpArray:()=>r});class r{regExpInstanceList;sourceLiat;last;constructor(e){const t=e?Array.isArray(e)?e:[e]:[];this.regExpInstanceList=t.map(e=>e instanceof RegExp?e:Array.isArray(e)?new RegExp(e[0],e[1]):new RegExp(e)),this.sourceLiat=this.regExpInstanceList.map(e=>[e.source,e.flags]),this.last=null}exec(e){return this.regExpInstanceList.reduce((t,r)=>{this.last=r;const n=r.exec(e);return n?t.concat([...n]):t},[])}firstMatch(e){for(const t of this.regExpInstanceList){this.last=t;const r=t.exec(e);if(r)return r}return null}test(e){for(const t of this.regExpInstanceList)if(t.lastIndex=0,t.test(e))return!0;return!1}toArray(){return this.regExpInstanceList}static matchAll(e,t){return null===t?null:(Array.isArray(t)?t:[t]).reduce((t,r)=>{const n=Array.from(e.matchAll(r instanceof RegExp?r:new RegExp(r,"g")));return t.concat(n.map(e=>Array.from(e)))},[])}static firstMatch(e,t){if(null===t)return null;const r=Array.isArray(t)?t:[t];for(const t of r){const r=(t instanceof RegExp?t:new RegExp(t)).exec(e);if(r)return r}return null}static test(e,t){return null!==r.firstMatch(e,t)}}class n{constructor(){}compareBuf(e,t){try{if(!t)return null;for(const r of t)if(r.length<=e.length&&0===r.compare(e.slice(0,r.length)))return!0;return!1}catch(e){throw e instanceof Error&&console.error(`正規表現バッファ比較エラー: ${e.message}`),e}}}return t})(),e.exports=t()},928(e){"use strict";e.exports=require("path")},943(e){"use strict";e.exports=require("fs/promises")}},t={},function r(n){var s=t[n];if(void 0!==s)return s.exports;var o=t[n]={exports:{}};return e[n].call(o.exports,o,o.exports,r),o.exports}(156);var e,t});
+/*! For license information please see dirwalker.bundle.js.LICENSE.txt */
+!function(e,t){"object"==typeof exports&&"object"==typeof module?module.exports=t():"function"==typeof define&&define.amd?define([],t):"object"==typeof exports?exports.DirWalker=t():e.DirWalker=t()}(global,()=>{return e={141(e,t,r){"use strict";var n,o=this&&this.__createBinding||(Object.create?function(e,t,r,n){void 0===n&&(n=r);var o=Object.getOwnPropertyDescriptor(t,r);o&&!("get"in o?!t.__esModule:o.writable||o.configurable)||(o={enumerable:!0,get:function(){return t[r]}}),Object.defineProperty(e,n,o)}:function(e,t,r,n){void 0===n&&(n=r),e[n]=t[r]}),s=this&&this.__setModuleDefault||(Object.create?function(e,t){Object.defineProperty(e,"default",{enumerable:!0,value:t})}:function(e,t){e.default=t}),i=this&&this.__importStar||(n=function(e){return n=Object.getOwnPropertyNames||function(e){var t=[];for(var r in e)Object.prototype.hasOwnProperty.call(e,r)&&(t[t.length]=r);return t},n(e)},function(e){if(e&&e.__esModule)return e;var t={};if(null!=e)for(var r=n(e),i=0;i<r.length;i++)"default"!==r[i]&&o(t,e,r[i]);return s(t,e),t});Object.defineProperty(t,"__esModule",{value:!0}),t.DirWalker=void 0;const a=i(r(943)),c=i(r(928)),u=r(576),l=i(r(556));class f{debug;counter;constructor(e=!1){this.debug=e,this.counter=0}async walk(e,t={excludeDirs:[],excludeExt:[]},r,n){this.counter=0;const o={...t};return await this._walk(e,e,o,r,n),this.counter}async _walk(e,t,r,n,o){try{const s=await a.readdir(e);for(const i of s){const s=l.absolutePath(c.join(e,i));if(!s)continue;const a=l.normalizeSeparator(s)??s;try{await this._processEntry(a,t,r,n,o)}catch(e){this._handleError(`Error processing file: ${a}`,e,o)}}}catch(t){this._handleError(`Error reading directory: ${e}`,t,o)}}async _processEntry(e,t,r,n,o){const s=await a.stat(e);s.isSymbolicLink()?this.debug&&console.debug(`Skipping symbolic link: ${e}`):s.isDirectory()?await this._processDirectory(e,t,r,n,o):await this._processFile(e,t,r,n,o)}async _processDirectory(e,t,r,n,o){r.excludeDirs&&r.excludeDirs.length>0&&new u.RegExpArray(r.excludeDirs).test(e)||await this._walk(e,t,r,n,o)}async _processFile(e,t,r,n,o){if(r.excludeExt&&r.excludeExt.length>0&&new u.RegExpArray(r.excludeExt).test(e))return;this.counter++,this.debug&&console.debug(`file: ${e}`);const s=c.relative(t,e);try{await n(s,r)}catch(t){this._handleError(`Error processing file: ${e}`,t,o)}}_handleError(e,t,r){"function"==typeof r?r(t):console.error(`${e}: ${t.message}`)}}t.DirWalker=f,t.default=f},156(e,t,r){"use strict";var n=this&&this.__importDefault||function(e){return e&&e.__esModule?e:{default:e}};Object.defineProperty(t,"__esModule",{value:!0}),t.default=t.DirWalker=void 0;var o=r(141);Object.defineProperty(t,"DirWalker",{enumerable:!0,get:function(){return o.DirWalker}}),Object.defineProperty(t,"default",{enumerable:!0,get:function(){return n(o).default}})},556(e,t,r){var n;n=()=>(()=>{"use strict";var e={path(e){e.exports=r(928)}},t={};function n(r){var o=t[r];if(void 0!==o)return o.exports;if(void 0===e[r]){var s=new Error("Cannot find module '"+r+"'");throw s.code="MODULE_NOT_FOUND",s}var i=t[r]={exports:{}};return e[r](i,i.exports,n),i.exports}n.n=e=>{var t=e&&e.__esModule?()=>e.default:()=>e;return n.d(t,{a:t}),t},n.d=(e,t)=>{for(var r in t)n.o(t,r)&&!n.o(e,r)&&Object.defineProperty(e,r,{enumerable:!0,get:t[r]})},n.o=(e,t)=>Object.prototype.hasOwnProperty.call(e,t),n.r=e=>{"undefined"!=typeof Symbol&&Symbol.toStringTag&&Object.defineProperty(e,Symbol.toStringTag,{value:"Module"}),Object.defineProperty(e,"__esModule",{value:!0})};var o={};return(()=>{n.r(o),n.d(o,{absolutePath:()=>s,isAbsolute:()=>r,normalizeSeparator:()=>t,relativePath:()=>i});var e=n("path");function t(e){if(!e)return null;const t=e.replace(/(\\|\/)/g,"/"),r=Array.from(t.matchAll(/^\/\/+([\?\.])\//g)),n=r[0]?r[0].index+r[0][0].length:0;return(r[0]?`//${r[0][1]}/`:"")+(r[0]?t.slice(n):t).replace(/\/+/g,"/")}function r(e){const r=t(e);return!!/^[a-z]:\//i.test(r)||!!/^\/\//.test(r)||!!/^\//.test(r)}function s(n,o){if(!n)return null;const s=o||process.cwd();return t(e.win32.normalize(r(n)?n:e.join(s,n)))}function i(r,n){if(!r)return null;const o=t(n)||process.cwd();return t(e.posix.relative(o,r))}})(),o})(),e.exports=n()},576(e){var t;t=()=>(()=>{"use strict";var e={d:(t,r)=>{for(var n in r)e.o(r,n)&&!e.o(t,n)&&Object.defineProperty(t,n,{enumerable:!0,get:r[n]})},o:(e,t)=>Object.prototype.hasOwnProperty.call(e,t),r:e=>{"undefined"!=typeof Symbol&&Symbol.toStringTag&&Object.defineProperty(e,Symbol.toStringTag,{value:"Module"}),Object.defineProperty(e,"__esModule",{value:!0})}},t={};e.r(t),e.d(t,{BufferPatternMatcher:()=>n,RegExpArray:()=>r});class r{regExpInstanceList;sourceLiat;last;constructor(e){const t=e?Array.isArray(e)?e:[e]:[];this.regExpInstanceList=t.map(e=>e instanceof RegExp?e:Array.isArray(e)?new RegExp(e[0],e[1]):new RegExp(e)),this.sourceLiat=this.regExpInstanceList.map(e=>[e.source,e.flags]),this.last=null}exec(e){return this.regExpInstanceList.reduce((t,r)=>{this.last=r;const n=r.exec(e);return n?t.concat([...n]):t},[])}firstMatch(e){for(const t of this.regExpInstanceList){this.last=t;const r=t.exec(e);if(r)return r}return null}test(e){for(const t of this.regExpInstanceList)if(t.lastIndex=0,t.test(e))return!0;return!1}toArray(){return this.regExpInstanceList}static matchAll(e,t){return null===t?null:(Array.isArray(t)?t:[t]).reduce((t,r)=>{const n=Array.from(e.matchAll(r instanceof RegExp?r:new RegExp(r,"g")));return t.concat(n.map(e=>Array.from(e)))},[])}static firstMatch(e,t){if(null===t)return null;const r=Array.isArray(t)?t:[t];for(const t of r){const r=(t instanceof RegExp?t:new RegExp(t)).exec(e);if(r)return r}return null}static test(e,t){return null!==r.firstMatch(e,t)}}class n{constructor(){}compareBuf(e,t){try{if(!t)return null;for(const r of t)if(r.length<=e.length&&0===r.compare(e.slice(0,r.length)))return!0;return!1}catch(e){throw e instanceof Error&&console.error(`正規表現バッファ比較エラー: ${e.message}`),e}}}return t})(),e.exports=t()},928(e){"use strict";e.exports=require("path")},943(e){"use strict";e.exports=require("fs/promises")}},t={},function r(n){var o=t[n];if(void 0!==o)return o.exports;var s=t[n]={exports:{}};return e[n].call(s.exports,s,s.exports,r),s.exports}(156);var e,t});

package/dist/dirwalker.bundle.js.LICENSE.txt

@@ -0,0 +1,5 @@
+/*! path */
+
+/*!*********************!*\
+  !*** ./PathUtil.js ***!
+  \*********************/

package/package.json

@@ -1,69 +1,69 @@
-{
-  "name": "@nojaja/dirwalker",
-  "version": "1.0.0",
-  "description": "A lightweight, flexible directory walker utility for Node.js with pattern matching support",
-  "type": "commonjs",
-  "main": "dist/dirwalker.bundle.js",
-  "types": "dist/index.d.ts",
-  "scripts": {
-    "build": "webpack --mode production",
-    "build:dev": "webpack --mode development",
-    "test": "jest --config jest.unit.config.js",
-    "test:ci": "jest --config jest.unit.config.js --coverage",
-    "test:coverage": "node --experimental-vm-modules node_modules/jest/bin/jest.js --coverage",
-    "lint": "eslint src/**/*.ts --config eslint.config.js",
-    "type-check": "tsc --noEmit",
-    "clean": "node -e \"const fs=require('fs');fs.rmSync('dist',{recursive:true,force:true})\"",
-    "depcruise": "depcruise src --config .dependency-cruiser.js",
-    "docs": "typedoc --config typedoc.js"
-  },
-  "keywords": [
-    "directory",
-    "walker",
-    "file",
-    "traversal",
-    "recursive",
-    "filesystem",
-    "pattern-matching",
-    "utility"
-  ],
-  "author": "nojaja <free.riccia@gmail.com> (https://github.com/nojaja)",
-  "license": "MIT",
-  "repository": {
-    "type": "git",
-    "url": "git+https://github.com/nojaja/NodeDirWalker.git"
-  },
-  "bugs": {
-    "url": "https://github.com/nojaja/NodeDirWalker/issues"
-  },
-  "homepage": "https://github.com/nojaja/NodeDirWalker#readme",
-  "engines": {
-    "node": ">=18.0.0"
-  },
-  "files": [
-    "dist"
-  ],
-  "devDependencies": {
-    "@types/jest": "^29.5.8",
-    "@types/node": "^20.0.0",
-    "@typescript-eslint/eslint-plugin": "^8.18.2",
-    "@typescript-eslint/parser": "^8.18.2",
-    "dependency-cruiser": "^17.3.6",
-    "eslint": "^8.45.0",
-    "eslint-plugin-jsdoc": "^61.5.0",
-    "eslint-plugin-sonarjs": "^3.0.5",
-    "jest": "^29.6.1",
-    "prettier": "^3.0.0",
-    "ts-jest": "^29.1.0",
-    "ts-loader": "^9.5.0",
-    "typedoc": "^0.28.15",
-    "typedoc-plugin-markdown": "^4.9.0",
-    "typescript": "^5.3.3",
-    "webpack": "^5.99.8",
-    "webpack-cli": "^5.0.0"
-  },
-  "dependencies": {
-    "@nojaja/greputil": "^1.0.4",
-    "@nojaja/pathutil": "^1.0.6"
-  }
-}
+{
+  "name": "@nojaja/dirwalker",
+  "version": "1.0.2",
+  "description": "A lightweight, flexible directory walker utility for Node.js with pattern matching support",
+  "type": "commonjs",
+  "main": "dist/dirwalker.bundle.js",
+  "types": "dist/index.d.ts",
+  "scripts": {
+    "build": "webpack --mode production",
+    "build:dev": "webpack --mode development",
+    "test": "jest --config jest.unit.config.js",
+    "test:ci": "jest --config jest.unit.config.js --coverage",
+    "test:coverage": "node --experimental-vm-modules node_modules/jest/bin/jest.js --coverage",
+    "lint": "eslint src/**/*.ts --config eslint.config.js",
+    "type-check": "tsc --noEmit",
+    "clean": "node -e \"const fs=require('fs');fs.rmSync('dist',{recursive:true,force:true})\"",
+    "depcruise": "depcruise src --config .dependency-cruiser.js",
+    "docs": "typedoc --config typedoc.js"
+  },
+  "keywords": [
+    "directory",
+    "walker",
+    "file",
+    "traversal",
+    "recursive",
+    "filesystem",
+    "pattern-matching",
+    "utility"
+  ],
+  "author": "nojaja <free.riccia@gmail.com> (https://github.com/nojaja)",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/nojaja/NodeDirWalker.git"
+  },
+  "bugs": {
+    "url": "https://github.com/nojaja/NodeDirWalker/issues"
+  },
+  "homepage": "https://github.com/nojaja/NodeDirWalker#readme",
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "files": [
+    "dist"
+  ],
+  "devDependencies": {
+    "@types/jest": "^29.5.8",
+    "@types/node": "^20.0.0",
+    "@typescript-eslint/eslint-plugin": "^8.18.2",
+    "@typescript-eslint/parser": "^8.18.2",
+    "dependency-cruiser": "^17.3.6",
+    "eslint": "^8.45.0",
+    "eslint-plugin-jsdoc": "^61.5.0",
+    "eslint-plugin-sonarjs": "^3.0.5",
+    "jest": "^29.6.1",
+    "prettier": "^3.0.0",
+    "ts-jest": "^29.1.0",
+    "ts-loader": "^9.5.0",
+    "typedoc": "^0.28.15",
+    "typedoc-plugin-markdown": "^4.9.0",
+    "typescript": "^5.3.3",
+    "webpack": "^5.99.8",
+    "webpack-cli": "^5.0.0"
+  },
+  "dependencies": {
+    "@nojaja/greputil": "^1.0.4",
+    "@nojaja/pathutil": "^1.0.9"
+  }
+}