feat: add literalBrackets option to handle square brackets in file paths

- Add literalBrackets option to automatically escape square brackets
- Helps with Node.js test runner compatibility for files in [param] folders
- Maintains backward compatibility with existing glob behavior
- Addresses issue #612 where test files in bracketed folders aren't found

Closes #612

Author: djunehor

src/glob.ts

@@ -127,6 +127,18 @@ export interface GlobOptions {
    */
   magicalBraces?: boolean
 
+  /**
+   * Treat square brackets `[` and `]` literally instead of as character 
+   * classes. When set to true, patterns containing literal square brackets
+   * in filenames will be automatically escaped.
+   * 
+   * For example, with `literalBrackets: true`, the pattern 
+   * `'src/app/api/[id]/route.js'` will match the literal folder named `[id]`
+   * instead of treating `[id]` as a character class matching any single 
+   * character 'i' or 'd'.
+   */
+  literalBrackets?: boolean
+
   /**
    * Add a `/` character to directory matches. Note that this requires
    * additional stat calls in some cases.
@@ -382,6 +394,7 @@ export class Glob<Opts extends GlobOptions> implements GlobOptions {
   follow: boolean
   ignore?: string | string[] | IgnoreLike
   magicalBraces: boolean
+  literalBrackets: boolean
   mark?: boolean
   matchBase: boolean
   maxDepth: number
@@ -441,6 +454,7 @@ export class Glob<Opts extends GlobOptions> implements GlobOptions {
     this.cwd = opts.cwd || ''
     this.root = opts.root
     this.magicalBraces = !!opts.magicalBraces
+    this.literalBrackets = !!opts.literalBrackets
     this.nobrace = !!opts.nobrace
     this.noext = !!opts.noext
     this.realpath = !!opts.realpath
@@ -471,6 +485,10 @@ export class Glob<Opts extends GlobOptions> implements GlobOptions {
       pattern = pattern.map(p => p.replace(/\\/g, '/'))
     }
 
+    if (this.literalBrackets) {
+      pattern = pattern.map(p => p.replace(/\[/g, '\\[').replace(/\]/g, '\\]'))
+    }
+
     if (this.matchBase) {
       if (opts.noglobstar) {
         throw new TypeError('base matching requires globstar')

test/square-brackets.ts

@@ -0,0 +1,73 @@
+import t from 'tap'
+import { glob } from '../dist/esm/index.js'
+
+t.test('square brackets in folder names', async t => {
+  // Set up test files in directories with square brackets
+  const cwd = t.testdir({
+    'app': {
+      'api': {
+        '[id]': {
+          'route.spec.js': 'export const test = true;'
+        },
+        '[slug]': {
+          'page.spec.js': 'export const test = true;'
+        },
+        'normal': {
+          'file.spec.js': 'export const test = true;'
+        }
+      }
+    }
+  })
+
+  t.test('escaped brackets should match literal brackets in folders', async t => {
+    const results = await glob('app/api/\\[id\\]/*.spec.js', { cwd })
+    t.equal(results.length, 1)
+    t.match(results[0], /\[id\]\/route\.spec\.js$/)
+  })
+
+  t.test('unescaped brackets should not match literal bracket folders', async t => {
+    const results = await glob('app/api/[id]/*.spec.js', { cwd })
+    t.equal(results.length, 0)
+  })
+
+  t.test('wildcard should match all directories including bracketed ones', async t => {
+    const results = await glob('app/api/*/*.spec.js', { cwd })
+    t.equal(results.length, 3) // [id], [slug], and normal
+  })
+
+  t.test('globstar should find all spec files', async t => {
+    const results = await glob('**/*.spec.js', { cwd })
+    t.equal(results.length, 3)
+  })
+
+  t.test('literalBrackets option should auto-escape brackets', async t => {
+    const results = await glob('app/api/[id]/*.spec.js', { cwd, literalBrackets: true })
+    t.equal(results.length, 1)
+    t.match(results[0], /\[id\]\/route\.spec\.js$/)
+  })
+
+  t.test('literalBrackets should work with multiple patterns', async t => {
+    const patterns = ['app/api/[id]/*.spec.js', 'app/api/[slug]/*.spec.js']
+    const results = await glob(patterns, { cwd, literalBrackets: true })
+    t.equal(results.length, 2)
+    t.match(results[0], /\[id\]\/route\.spec\.js$/)
+    t.match(results[1], /\[slug\]\/page\.spec\.js$/)
+  })
+
+  t.test('literalBrackets should not affect normal brackets used as character classes', async t => {
+    // Create files that would match character classes
+    const testCwd = t.testdir({
+      'i': { 'test.js': 'content' },
+      'd': { 'test.js': 'content' },
+      'normal': { 'test.js': 'content' }
+    })
+    
+    // Without literalBrackets, [id] should match directories named 'i' or 'd'
+    const results = await glob('[id]/test.js', { cwd: testCwd })
+    t.equal(results.length, 2) // Should match 'i' and 'd' directories
+    
+    // With literalBrackets, [id] should be treated literally and match nothing
+    const literalResults = await glob('[id]/test.js', { cwd: testCwd, literalBrackets: true })
+    t.equal(literalResults.length, 0) // Should not match any directory
+  })
+})