@dotcontext/cli 0.8.0

package/dist/utils/gitignoreManager.d.ts

@@ -0,0 +1,61 @@
+/**
+ * GitIgnoreManager - Loads and applies .gitignore rules for file filtering.
+ *
+ * Uses the `ignore` library for spec-compliant .gitignore pattern matching.
+ * Caches lookup results via Map for O(1) repeat lookups.
+ * Gracefully falls back to empty rules if no .gitignore exists.
+ *
+ * @see https://github.com/kaelzhang/node-ignore
+ */
+export interface GitIgnoreManagerOptions {
+    /** Extra patterns to add on top of .gitignore + defaults */
+    extraPatterns?: string[];
+    /** Whether to include default exclude patterns (default: true) */
+    useDefaults?: boolean;
+}
+export declare class GitIgnoreManager {
+    private readonly options;
+    private ignoreInstance;
+    private readonly resultCache;
+    private loaded;
+    constructor(options?: GitIgnoreManagerOptions);
+    /**
+     * Load .gitignore rules from the given repository root.
+     * Safe to call multiple times — resets and reloads each time.
+     *
+     * @param repoPath - Absolute path to the repository root
+     */
+    loadFromRepo(repoPath: string): Promise<void>;
+    /**
+     * Check if a path should be ignored.
+     *
+     * @param relativePath - Path relative to the repository root (forward slashes)
+     * @returns true if the path should be ignored
+     */
+    shouldIgnore(relativePath: string): boolean;
+    /**
+     * Filter an array of relative paths, returning only non-ignored ones.
+     *
+     * @param relativePaths - Array of paths relative to repo root
+     * @returns Filtered array of non-ignored paths
+     */
+    filterPaths(relativePaths: string[]): string[];
+    /**
+     * Get all patterns currently loaded (for debugging/logging).
+     */
+    get isLoaded(): boolean;
+    /**
+     * Clear the result cache. Useful after adding new patterns.
+     */
+    clearCache(): void;
+    /**
+     * Parse .gitignore content into an array of patterns.
+     * Strips comments and empty lines.
+     */
+    private parseGitignore;
+    /**
+     * Apply default exclusion patterns.
+     */
+    private applyDefaults;
+}
+//# sourceMappingURL=gitignoreManager.d.ts.map

package/dist/utils/gitignoreManager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"gitignoreManager.d.ts","sourceRoot":"","sources":["../../src/utils/gitignoreManager.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAqBH,MAAM,WAAW,uBAAuB;IACtC,4DAA4D;IAC5D,aAAa,CAAC,EAAE,MAAM,EAAE,CAAC;IACzB,kEAAkE;IAClE,WAAW,CAAC,EAAE,OAAO,CAAC;CACvB;AAED,qBAAa,gBAAgB;IAKf,OAAO,CAAC,QAAQ,CAAC,OAAO;IAJpC,OAAO,CAAC,cAAc,CAAS;IAC/B,OAAO,CAAC,QAAQ,CAAC,WAAW,CAA8B;IAC1D,OAAO,CAAC,MAAM,CAAS;gBAEM,OAAO,GAAE,uBAA4B;IAKlE;;;;;OAKG;IACG,YAAY,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAgCnD;;;;;OAKG;IACH,YAAY,CAAC,YAAY,EAAE,MAAM,GAAG,OAAO;IAoB3C;;;;;OAKG;IACH,WAAW,CAAC,aAAa,EAAE,MAAM,EAAE,GAAG,MAAM,EAAE;IAI9C;;OAEG;IACH,IAAI,QAAQ,IAAI,OAAO,CAEtB;IAED;;OAEG;IACH,UAAU,IAAI,IAAI;IAIlB;;;OAGG;IACH,OAAO,CAAC,cAAc;IAOtB;;OAEG;IACH,OAAO,CAAC,aAAa;CAKtB"}

package/dist/utils/gitignoreManager.js

@@ -0,0 +1,171 @@
+"use strict";
+/**
+ * GitIgnoreManager - Loads and applies .gitignore rules for file filtering.
+ *
+ * Uses the `ignore` library for spec-compliant .gitignore pattern matching.
+ * Caches lookup results via Map for O(1) repeat lookups.
+ * Gracefully falls back to empty rules if no .gitignore exists.
+ *
+ * @see https://github.com/kaelzhang/node-ignore
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.GitIgnoreManager = void 0;
+const path = __importStar(require("path"));
+const fs = __importStar(require("fs-extra"));
+const ignore_1 = __importDefault(require("ignore"));
+/**
+ * Default patterns that should always be excluded, regardless of .gitignore content.
+ * These match the original hardcoded excludes from FileMapper.
+ */
+const DEFAULT_EXCLUDE_PATTERNS = [
+    'node_modules',
+    '.git',
+    'dist',
+    'build',
+    '*.log',
+    '.env*',
+    '*.tmp',
+    '.DS_Store',
+];
+class GitIgnoreManager {
+    constructor(options = {}) {
+        this.options = options;
+        this.resultCache = new Map();
+        this.loaded = false;
+        this.ignoreInstance = (0, ignore_1.default)();
+        this.applyDefaults();
+    }
+    /**
+     * Load .gitignore rules from the given repository root.
+     * Safe to call multiple times — resets and reloads each time.
+     *
+     * @param repoPath - Absolute path to the repository root
+     */
+    async loadFromRepo(repoPath) {
+        // Reset for fresh load
+        this.ignoreInstance = (0, ignore_1.default)();
+        this.resultCache.clear();
+        this.loaded = false;
+        // 1. Apply default patterns
+        this.applyDefaults();
+        // 2. Load .gitignore from repo root
+        const gitignorePath = path.join(repoPath, '.gitignore');
+        try {
+            const exists = await fs.pathExists(gitignorePath);
+            if (exists) {
+                const content = await fs.readFile(gitignorePath, 'utf-8');
+                const patterns = this.parseGitignore(content);
+                if (patterns.length > 0) {
+                    this.ignoreInstance.add(patterns);
+                }
+            }
+        }
+        catch {
+            // .gitignore not readable — continue with defaults only
+        }
+        // 3. Apply extra patterns from options
+        if (this.options.extraPatterns && this.options.extraPatterns.length > 0) {
+            this.ignoreInstance.add(this.options.extraPatterns);
+        }
+        this.loaded = true;
+    }
+    /**
+     * Check if a path should be ignored.
+     *
+     * @param relativePath - Path relative to the repository root (forward slashes)
+     * @returns true if the path should be ignored
+     */
+    shouldIgnore(relativePath) {
+        // Normalize to forward slashes for cross-platform consistency
+        const normalized = relativePath.replace(/\\/g, '/');
+        // Empty or root path should not be ignored
+        if (!normalized || normalized === '.' || normalized === '/') {
+            return false;
+        }
+        // Check cache first
+        const cached = this.resultCache.get(normalized);
+        if (cached !== undefined) {
+            return cached;
+        }
+        const result = this.ignoreInstance.ignores(normalized);
+        this.resultCache.set(normalized, result);
+        return result;
+    }
+    /**
+     * Filter an array of relative paths, returning only non-ignored ones.
+     *
+     * @param relativePaths - Array of paths relative to repo root
+     * @returns Filtered array of non-ignored paths
+     */
+    filterPaths(relativePaths) {
+        return relativePaths.filter(p => !this.shouldIgnore(p));
+    }
+    /**
+     * Get all patterns currently loaded (for debugging/logging).
+     */
+    get isLoaded() {
+        return this.loaded;
+    }
+    /**
+     * Clear the result cache. Useful after adding new patterns.
+     */
+    clearCache() {
+        this.resultCache.clear();
+    }
+    /**
+     * Parse .gitignore content into an array of patterns.
+     * Strips comments and empty lines.
+     */
+    parseGitignore(content) {
+        return content
+            .split(/\r?\n/)
+            .map(line => line.trim())
+            .filter(line => line.length > 0 && !line.startsWith('#'));
+    }
+    /**
+     * Apply default exclusion patterns.
+     */
+    applyDefaults() {
+        if (this.options.useDefaults !== false) {
+            this.ignoreInstance.add([...DEFAULT_EXCLUDE_PATTERNS]);
+        }
+    }
+}
+exports.GitIgnoreManager = GitIgnoreManager;
+//# sourceMappingURL=gitignoreManager.js.map

package/dist/utils/gitignoreManager.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"gitignoreManager.js","sourceRoot":"","sources":["../../src/utils/gitignoreManager.ts"],"names":[],"mappings":"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"}