minimatch-fast 0.2.1

package/dist/cjs/minimatch-class.d.ts

@@ -0,0 +1,153 @@
+/**
+ * @fileoverview Minimatch class - core pattern matching implementation
+ *
+ * This is the heart of minimatch-fast. The Minimatch class provides 100% API
+ * compatibility with minimatch's Minimatch class while using picomatch
+ * internally for faster and more secure pattern matching.
+ *
+ * Key features:
+ * - Pattern compilation and caching for efficient repeated matching
+ * - Full support for glob patterns: *, **, ?, [], {}, extglob
+ * - Brace expansion using the 'braces' package
+ * - Negation patterns with !
+ * - Comment patterns with #
+ * - Cross-platform path handling (Windows and POSIX)
+ *
+ * Architecture:
+ * 1. Constructor receives pattern and options
+ * 2. Pattern is parsed and expanded (braces)
+ * 3. Picomatch matchers are created for each expanded pattern
+ * 4. match() method tests paths against all matchers
+ *
+ * Compatibility layer:
+ * Some edge cases require special handling to match minimatch's exact behavior:
+ * - Dotfiles (. and ..) are never matched by wildcards
+ * - Negated character classes [^...] don't match dotfiles
+ * - Backslash escapes in character classes ([\b] = literal 'b')
+ *
+ * @author 686f6c61
+ * @see https://github.com/686f6c61/minimatch-fast
+ * @license MIT
+ */
+import type { MinimatchOptions, MMRegExp, ParseReturn, ParseReturnFiltered, Platform } from './types.js';
+/**
+ * Minimatch class for glob pattern matching
+ */
+export declare class Minimatch {
+    /** Original pattern passed to constructor */
+    pattern: string;
+    /** Options used for matching */
+    options: MinimatchOptions;
+    /** 2D array of parsed pattern parts after brace expansion */
+    set: ParseReturnFiltered[][];
+    /** Whether the pattern is negated (starts with !) */
+    negate: boolean;
+    /** Whether the pattern is a comment (starts with #) */
+    comment: boolean;
+    /** Whether the pattern is empty */
+    empty: boolean;
+    /** Whether to preserve multiple consecutive slashes */
+    preserveMultipleSlashes: boolean;
+    /** Whether to do partial matching */
+    partial: boolean;
+    /** Result of brace expansion on the pattern */
+    globSet: string[];
+    /** Brace-expanded patterns split into path portions */
+    globParts: string[][];
+    /** Whether to perform case-insensitive matching */
+    nocase: boolean;
+    /** Whether running on Windows */
+    isWindows: boolean;
+    /** Target platform */
+    platform: Platform;
+    /** Windows-specific magic root handling */
+    windowsNoMagicRoot: boolean;
+    /** Compiled regular expression (lazily computed) */
+    regexp: false | null | MMRegExp;
+    /** Whether backslash is treated as path separator */
+    windowsPathsNoEscape: boolean;
+    /** Whether negation is disabled */
+    nonegate: boolean;
+    private _picoOpts;
+    private _matchers;
+    private _debugFn;
+    private _hasNegatedCharClassCached;
+    private _requiresTrailingSlashCached;
+    private _patternBasename;
+    /**
+     * Create a new Minimatch instance
+     *
+     * @param pattern - The glob pattern to match against
+     * @param options - Matching options
+     */
+    constructor(pattern: string, options?: MinimatchOptions);
+    /**
+     * Enable debug output
+     */
+    private debug;
+    /**
+     * Check if the pattern contains glob magic characters
+     */
+    hasMagic(): boolean;
+    /**
+     * Build the pattern matching set
+     */
+    private make;
+    /**
+     * Parse negation from the pattern
+     */
+    private parseNegate;
+    /**
+     * Perform brace expansion on the pattern
+     */
+    braceExpand(): string[];
+    /**
+     * Split a path by slashes
+     */
+    slashSplit(p: string): string[];
+    /**
+     * Preprocess glob parts (optimization, normalization)
+     */
+    private preprocess;
+    /**
+     * Parse a single pattern part into a regex or string
+     */
+    private parse;
+    /**
+     * Test if a path matches the pattern
+     *
+     * @param path - The path to test
+     * @param partial - Whether to do partial matching
+     * @returns true if the path matches
+     */
+    match(path: string, partial?: boolean): boolean;
+    /**
+     * Pre-process pattern for minimatch compatibility
+     * Handles edge cases where picomatch behaves differently
+     */
+    private preprocessPattern;
+    /**
+     * Create a regular expression from the pattern
+     *
+     * @returns RegExp or false if pattern is invalid
+     */
+    makeRe(): false | MMRegExp;
+    /**
+     * Match a file array against a pattern array
+     * This is for internal use and advanced matching scenarios
+     *
+     * @param file - Array of path segments
+     * @param pattern - Array of pattern parts
+     * @param partial - Whether to do partial matching
+     * @returns true if file matches pattern
+     */
+    matchOne(file: string[], pattern: ParseReturn[], partial?: boolean): boolean;
+    /**
+     * Create a new Minimatch class with default options
+     *
+     * @param def - Default options to apply
+     * @returns New Minimatch class with defaults
+     */
+    static defaults(def: MinimatchOptions): typeof Minimatch;
+}
+//# sourceMappingURL=minimatch-class.d.ts.map

package/dist/cjs/minimatch-class.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"minimatch-class.d.ts","sourceRoot":"","sources":["../../src/minimatch-class.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AAGH,OAAO,KAAK,EACV,gBAAgB,EAChB,QAAQ,EACR,WAAW,EACX,mBAAmB,EACnB,QAAQ,EAET,MAAM,YAAY,CAAC;AAiBpB;;GAEG;AACH,qBAAa,SAAS;IACpB,6CAA6C;IAC7C,OAAO,EAAE,MAAM,CAAC;IAEhB,gCAAgC;IAChC,OAAO,EAAE,gBAAgB,CAAC;IAE1B,6DAA6D;IAC7D,GAAG,EAAE,mBAAmB,EAAE,EAAE,CAAC;IAE7B,qDAAqD;IACrD,MAAM,EAAE,OAAO,CAAC;IAEhB,uDAAuD;IACvD,OAAO,EAAE,OAAO,CAAC;IAEjB,mCAAmC;IACnC,KAAK,EAAE,OAAO,CAAC;IAEf,uDAAuD;IACvD,uBAAuB,EAAE,OAAO,CAAC;IAEjC,qCAAqC;IACrC,OAAO,EAAE,OAAO,CAAC;IAEjB,+CAA+C;IAC/C,OAAO,EAAE,MAAM,EAAE,CAAC;IAElB,uDAAuD;IACvD,SAAS,EAAE,MAAM,EAAE,EAAE,CAAC;IAEtB,mDAAmD;IACnD,MAAM,EAAE,OAAO,CAAC;IAEhB,iCAAiC;IACjC,SAAS,EAAE,OAAO,CAAC;IAEnB,sBAAsB;IACtB,QAAQ,EAAE,QAAQ,CAAC;IAEnB,2CAA2C;IAC3C,kBAAkB,EAAE,OAAO,CAAC;IAE5B,oDAAoD;IACpD,MAAM,EAAE,KAAK,GAAG,IAAI,GAAG,QAAQ,CAAC;IAEhC,qDAAqD;IACrD,oBAAoB,EAAE,OAAO,CAAC;IAE9B,mCAAmC;IACnC,QAAQ,EAAE,OAAO,CAAC;IAGlB,OAAO,CAAC,SAAS,CAAmB;IACpC,OAAO,CAAC,SAAS,CAAkC;IACnD,OAAO,CAAC,QAAQ,CAA+B;IAG/C,OAAO,CAAC,0BAA0B,CAAU;IAC5C,OAAO,CAAC,4BAA4B,CAAU;IAC9C,OAAO,CAAC,gBAAgB,CAAS;IAEjC;;;;;OAKG;gBACS,OAAO,EAAE,MAAM,EAAE,OAAO,GAAE,gBAAqB;IAsE3D;;OAEG;IACH,OAAO,CAAC,KAAK;IAIb;;OAEG;IACH,QAAQ,IAAI,OAAO;IAkBnB;;OAEG;IACH,OAAO,CAAC,IAAI;IA2DZ;;OAEG;IACH,OAAO,CAAC,WAAW;IAoBnB;;OAEG;IACH,WAAW,IAAI,MAAM,EAAE;IAIvB;;OAEG;IACH,UAAU,CAAC,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE;IAI/B;;OAEG;IACH,OAAO,CAAC,UAAU;IA4ClB;;OAEG;IACH,OAAO,CAAC,KAAK;IAuBb;;;;;;OAMG;IACH,KAAK,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,GAAE,OAAsB,GAAG,OAAO;IA+G7D;;;OAGG;IACH,OAAO,CAAC,iBAAiB;IAazB;;;;OAIG;IACH,MAAM,IAAI,KAAK,GAAG,QAAQ;IA+D1B;;;;;;;;OAQG;IACH,QAAQ,CACN,IAAI,EAAE,MAAM,EAAE,EACd,OAAO,EAAE,WAAW,EAAE,EACtB,OAAO,GAAE,OAAe,GACvB,OAAO;IA8GV;;;;;OAKG;IACH,MAAM,CAAC,QAAQ,CAAC,GAAG,EAAE,gBAAgB,GAAG,OAAO,SAAS;CAazD"}