feat: add file info refiner for filtering by file properties

Implements a refiner that filters items based on file information such
as extension, size, modification time, and file type. Supports excluding
hidden files and pattern-based filtering for flexible file selection.

🤖 Generated with [Claude Code](https://claude.ai/code)

Co-Authored-By: Claude <[email protected]>

Author: lambdalisue

builtin/refiner/file_info.ts

@@ -0,0 +1,178 @@
+import { defineRefiner, type Refiner } from "../../refiner.ts";
+import { extname } from "@std/path/extname";
+
+type Detail = {
+  /**
+   * File path
+   */
+  path: string;
+};
+
+export type FileInfoRefinerOptions = {
+  /**
+   * Filter by file extensions.
+   * If provided, only files with these extensions will pass.
+   */
+  extensions?: string[];
+
+  /**
+   * Filter by file size.
+   * Files must be within this range (in bytes).
+   */
+  sizeRange?: {
+    min?: number;
+    max?: number;
+  };
+
+  /**
+   * Filter by modification time.
+   * Files must be modified within this time range.
+   */
+  modifiedWithin?: {
+    days?: number;
+    hours?: number;
+    minutes?: number;
+  };
+
+  /**
+   * Whether to include directories.
+   * @default true
+   */
+  includeDirectories?: boolean;
+
+  /**
+   * Whether to include files.
+   * @default true
+   */
+  includeFiles?: boolean;
+
+  /**
+   * Whether to include symlinks.
+   * @default true
+   */
+  includeSymlinks?: boolean;
+
+  /**
+   * Whether to exclude hidden files (starting with dot).
+   * @default false
+   */
+  excludeHidden?: boolean;
+
+  /**
+   * Patterns to exclude (glob patterns).
+   */
+  excludePatterns?: string[];
+};
+
+/**
+ * Creates a Refiner that filters items based on file information.
+ *
+ * This Refiner can filter files based on various criteria such as
+ * file extension, size, modification time, and file type.
+ *
+ * @param options - Options to customize file filtering.
+ * @returns A Refiner that filters items based on file information.
+ */
+export function fileInfo(
+  options: Readonly<FileInfoRefinerOptions> = {},
+): Refiner<Detail> {
+  const extensions = options.extensions;
+  const sizeRange = options.sizeRange;
+  const modifiedWithin = options.modifiedWithin;
+  const includeDirectories = options.includeDirectories ?? true;
+  const includeFiles = options.includeFiles ?? true;
+  const includeSymlinks = options.includeSymlinks ?? true;
+  const excludeHidden = options.excludeHidden ?? false;
+  const excludePatterns = options.excludePatterns ?? [];
+
+  return defineRefiner(async (_denops, { items }) => {
+    // Process items in parallel and filter
+    const results = await Promise.all(
+      items.map(async (item) => {
+        const { path } = item.detail;
+
+        // Check if hidden file should be excluded
+        if (
+          excludeHidden && path.split("/").some((part) => part.startsWith("."))
+        ) {
+          return null;
+        }
+
+        // Check exclude patterns
+        for (const pattern of excludePatterns) {
+          // Simple glob pattern matching (could be enhanced)
+          const regex = new RegExp(
+            pattern.replace(/\*/g, ".*").replace(/\?/g, "."),
+          );
+          if (regex.test(path)) {
+            return null;
+          }
+        }
+
+        // Check extension filter
+        if (extensions && extensions.length > 0) {
+          const ext = extname(path).toLowerCase();
+          if (!extensions.includes(ext)) {
+            return null;
+          }
+        }
+
+        try {
+          // Get file stats
+          const stat = await Deno.stat(path);
+
+          // Check file type filters
+          if (!includeFiles && stat.isFile) {
+            return null;
+          }
+          if (!includeDirectories && stat.isDirectory) {
+            return null;
+          }
+          if (!includeSymlinks && stat.isSymlink) {
+            return null;
+          }
+
+          // Check size filter
+          if (sizeRange && stat.isFile) {
+            if (sizeRange.min !== undefined && stat.size < sizeRange.min) {
+              return null;
+            }
+            if (sizeRange.max !== undefined && stat.size > sizeRange.max) {
+              return null;
+            }
+          }
+
+          // Check modification time filter
+          if (modifiedWithin && stat.mtime) {
+            const now = new Date();
+            const mtime = stat.mtime;
+            const diffMs = now.getTime() - mtime.getTime();
+
+            let maxMs = 0;
+            if (modifiedWithin.days !== undefined) {
+              maxMs += modifiedWithin.days * 24 * 60 * 60 * 1000;
+            }
+            if (modifiedWithin.hours !== undefined) {
+              maxMs += modifiedWithin.hours * 60 * 60 * 1000;
+            }
+            if (modifiedWithin.minutes !== undefined) {
+              maxMs += modifiedWithin.minutes * 60 * 1000;
+            }
+
+            if (diffMs > maxMs) {
+              return null;
+            }
+          }
+
+          return item;
+        } catch {
+          // If stat fails, exclude the item
+          return null;
+        }
+      }),
+    );
+
+    // Return only non-null items
+    return results.filter((item) => item !== null);
+  });
+}

builtin/refiner/mod.ts

@@ -1,7 +1,9 @@
 // This file is generated by gen-mod.ts
 export * from "./absolute_path.ts";
+export * from "./buffer_info.ts";
 export * from "./cwd.ts";
 export * from "./exists.ts";
+export * from "./file_info.ts";
 export * from "./noop.ts";
 export * from "./regexp.ts";
 export * from "./relative_path.ts";