@nuitsukera/refine 1.0.0

package/dist/libs/fileUtils.d.ts

@@ -0,0 +1,17 @@
+import * as fs from "node:fs";
+export declare class FileUtils {
+    static readFile(filePath: string): Promise<string>;
+    static writeFile(filePath: string, content: string): Promise<void>;
+    static readDir(dirPath: string): Promise<string[]>;
+    static stat(itemPath: string): Promise<fs.Stats>;
+    static exists(itemPath: string): Promise<boolean>;
+    static isDirectory(itemPath: string): Promise<boolean>;
+    static ensureDir(dirPath: string): Promise<void>;
+    static copyFile(src: string, dest: string): Promise<void>;
+    static getExtension(filePath: string): string;
+    static resolvePath(...paths: string[]): string;
+    static relativePath(from: string, to: string): string;
+    static matchesPattern(filePath: string, pattern: string): boolean;
+    static shouldExclude(filePath: string, patterns: string[]): boolean;
+}
+//# sourceMappingURL=fileUtils.d.ts.map

package/dist/libs/fileUtils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fileUtils.d.ts","sourceRoot":"","sources":["../../src/libs/fileUtils.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,SAAS,CAAC;AAK9B,qBAAa,SAAS;WACR,QAAQ,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;WAU3C,SAAS,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;WAY3D,OAAO,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;WAU3C,IAAI,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,EAAE,CAAC,KAAK,CAAC;WAUzC,MAAM,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;WAS1C,WAAW,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;WAS/C,SAAS,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;WAYzC,QAAQ,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAY/D,MAAM,CAAC,YAAY,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM;IAI7C,MAAM,CAAC,WAAW,CAAC,GAAG,KAAK,EAAE,MAAM,EAAE,GAAG,MAAM;IAI9C,MAAM,CAAC,YAAY,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,GAAG,MAAM;IAIrD,MAAM,CAAC,cAAc,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO;IAYjE,MAAM,CAAC,aAAa,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,GAAG,OAAO;CAWnE"}

package/dist/libs/logger.d.ts

@@ -0,0 +1,19 @@
+import type { RemovedComment } from "../types/parser";
+export declare class Logger {
+    private verbose;
+    constructor(verbose?: boolean);
+    info(message: string): void;
+    success(message: string): void;
+    warning(message: string): void;
+    error(message: string, error?: Error): void;
+    debug(message: string): void;
+    title(message: string): void;
+    separator(): void;
+    stats(stats: Record<string, string | number>): void;
+    list(items: string[], bullet?: string): void;
+    progress(current: number, total: number, label?: string): void;
+    clearLine(): void;
+    setVerbose(verbose: boolean): void;
+    fileReport(filePath: string, removed: RemovedComment[], dryRun: boolean): void;
+}
+//# sourceMappingURL=logger.d.ts.map

package/dist/libs/logger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.d.ts","sourceRoot":"","sources":["../../src/libs/logger.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AAYtD,qBAAa,MAAM;IAClB,OAAO,CAAC,OAAO,CAAU;gBAEb,OAAO,GAAE,OAAe;IAIpC,IAAI,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI;IAI3B,OAAO,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI;IAI9B,OAAO,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI;IAI9B,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,KAAK,GAAG,IAAI;IAO3C,KAAK,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI;IAM5B,KAAK,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI;IAI5B,SAAS,IAAI,IAAI;IAIjB,KAAK,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAAC,GAAG,IAAI;IAOnD,IAAI,CAAC,KAAK,EAAE,MAAM,EAAE,EAAE,MAAM,SAAM,GAAG,IAAI;IAMzC,QAAQ,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,KAAK,SAAK,GAAG,IAAI;IAe1D,SAAS,IAAI,IAAI;IAIjB,UAAU,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI;IAIlC,UAAU,CACT,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,cAAc,EAAE,EACzB,MAAM,EAAE,OAAO,GACb,IAAI;CAsBP"}

package/dist/libs/prompt.d.ts

@@ -0,0 +1,4 @@
+export declare function prompt(question: string): Promise<string>;
+export declare function promptChoice(message: string, choices: string[]): Promise<number>;
+export declare function promptText(question: string, defaultValue?: string): Promise<string>;
+//# sourceMappingURL=prompt.d.ts.map

package/dist/libs/prompt.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"prompt.d.ts","sourceRoot":"","sources":["../../src/libs/prompt.ts"],"names":[],"mappings":"AAEA,wBAAsB,MAAM,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAa9D;AAED,wBAAsB,YAAY,CACjC,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,MAAM,EAAE,GACf,OAAO,CAAC,MAAM,CAAC,CAcjB;AAED,wBAAsB,UAAU,CAC/B,QAAQ,EAAE,MAAM,EAChB,YAAY,SAAK,GACf,OAAO,CAAC,MAAM,CAAC,CAIjB"}

package/dist/libs/safetyGuard.d.ts

@@ -0,0 +1,29 @@
+/**
+ * @file safetyGuard.ts
+ * @description Regras de proteção inatas — independentes de config — que impedem
+ *   a remoção acidental de diretivas de ferramentas, comentários com URLs e
+ *   outras anotações críticas que NUNCA devem ser apagadas.
+ *
+ *   Estas regras têm prioridade máxima: nenhuma opção de config as desativa.
+ */
+/**
+ * Retorna true se o texto do comentário contém uma URL.
+ * Usado como proteção de último recurso: se o parser capturou algo que
+ * inclui uma URL (ex.: "https://..."), é mais seguro preservar.
+ */
+export declare function containsURL(comment: string): boolean;
+export type GuardMatchResult = {
+    /** true = este comentário está protegido e NÃO deve ser removido */
+    protected: boolean;
+    /** Motivo humano legível (útil para logs verbose futuros) */
+    reason?: string;
+};
+/**
+ * Verifica se um comentário está protegido por alguma regra inata.
+ *
+ * @param comment - Texto do comentário (com ou sem delimitadores)
+ * @returns { protected: true, reason } se deve ser preservado,
+ *          { protected: false }        se pode prosseguir para avaliação normal
+ */
+export declare function checkSafetyGuard(comment: string): GuardMatchResult;
+//# sourceMappingURL=safetyGuard.d.ts.map

package/dist/libs/safetyGuard.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"safetyGuard.d.ts","sourceRoot":"","sources":["../../src/libs/safetyGuard.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAqEH;;;;GAIG;AACH,wBAAgB,WAAW,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAEpD;AAMD,MAAM,MAAM,gBAAgB,GAAG;IAC9B,oEAAoE;IACpE,SAAS,EAAE,OAAO,CAAC;IACnB,6DAA6D;IAC7D,MAAM,CAAC,EAAE,MAAM,CAAC;CAChB,CAAC;AAEF;;;;;;GAMG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,MAAM,GAAG,gBAAgB,CAYlE"}

package/dist/parsers/base.d.ts

@@ -0,0 +1,45 @@
+/**
+ * @file BaseParser.ts
+ * @description Classe base abstrata para todos os parsers
+ */
+import type { Config } from "../types/config";
+import type { IParser, ParserOptions, ParserResult } from "../types/parser";
+export declare abstract class BaseParser implements IParser {
+    protected config: Config;
+    protected fileExtension: string;
+    constructor(options: ParserOptions);
+    /**
+     * Método abstrato que cada parser deve implementar
+     */
+    abstract parse(content: string): ParserResult;
+    /**
+     * Verifica se um comentário deve ser preservado
+     */
+    shouldPreserve(comment: string): boolean;
+    /**
+     * Verifica se é um comentário JSDoc
+     */
+    protected isJSDoc(comment: string): boolean;
+    /**
+     * Verifica se é um comentário TODO
+     */
+    protected isTODO(comment: string): boolean;
+    /**
+     * Verifica se é um comentário FIXME
+     */
+    protected isFIXME(comment: string): boolean;
+    /**
+     * Verifica se é um comentário NOTE
+     */
+    protected isNOTE(comment: string): boolean;
+    /**
+     * Verifica se deve remover baseado nas configurações
+     */
+    protected shouldRemove(comment: string): boolean;
+    /**
+     * Remove espaços em branco extras após remoção de comentários
+     */
+    protected cleanupWhitespace(content: string): string;
+    protected commentPreview(comment: string): string;
+}
+//# sourceMappingURL=base.d.ts.map

package/dist/parsers/base.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"base.d.ts","sourceRoot":"","sources":["../../src/parsers/base.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,iBAAiB,CAAC;AAC9C,OAAO,KAAK,EAAE,OAAO,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAE5E,8BAAsB,UAAW,YAAW,OAAO;IAClD,SAAS,CAAC,MAAM,EAAE,MAAM,CAAC;IACzB,SAAS,CAAC,aAAa,EAAE,MAAM,CAAC;gBAEpB,OAAO,EAAE,aAAa;IAKlC;;OAEG;IACH,QAAQ,CAAC,KAAK,CAAC,OAAO,EAAE,MAAM,GAAG,YAAY;IAE7C;;OAEG;IACH,cAAc,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO;IAuBxC;;OAEG;IACH,SAAS,CAAC,OAAO,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO;IAI3C;;OAEG;IACH,SAAS,CAAC,MAAM,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO;IAI1C;;OAEG;IACH,SAAS,CAAC,OAAO,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO;IAI3C;;OAEG;IACH,SAAS,CAAC,MAAM,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO;IAI1C;;OAEG;IACH,SAAS,CAAC,YAAY,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO;IA+BhD;;OAEG;IACH,SAAS,CAAC,iBAAiB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM;IAIpD,SAAS,CAAC,cAAc,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM;CAGjD"}

package/dist/parsers/css.d.ts

@@ -0,0 +1,10 @@
+/**
+ * @file css.ts
+ * @description Parser para arquivos CSS, SCSS e LESS
+ */
+import type { ParserResult } from "../types/parser";
+import { BaseParser } from "./base";
+export declare class CSSParser extends BaseParser {
+    parse(content: string): ParserResult;
+}
+//# sourceMappingURL=css.d.ts.map

package/dist/parsers/css.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"css.d.ts","sourceRoot":"","sources":["../../src/parsers/css.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAkB,MAAM,iBAAiB,CAAC;AACpE,OAAO,EAAE,UAAU,EAAE,MAAM,QAAQ,CAAC;AAEpC,qBAAa,SAAU,SAAQ,UAAU;IACxC,KAAK,CAAC,OAAO,EAAE,MAAM,GAAG,YAAY;CAmFpC"}

package/dist/parsers/factory.d.ts

@@ -0,0 +1,12 @@
+/**
+ * @file ParserFactory.ts
+ * @description Factory para criar parsers baseados na extensão do arquivo
+ */
+import type { IParser, ParserOptions } from "../types/parser";
+export declare class ParserFactory {
+    /**
+     * Cria um parser apropriado para a extensão do arquivo
+     */
+    static createParser(options: ParserOptions): IParser;
+}
+//# sourceMappingURL=factory.d.ts.map

package/dist/parsers/factory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"factory.d.ts","sourceRoot":"","sources":["../../src/parsers/factory.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAQ9D,qBAAa,aAAa;IACzB;;OAEG;IACH,MAAM,CAAC,YAAY,CAAC,OAAO,EAAE,aAAa,GAAG,OAAO;CA4CpD"}

package/dist/parsers/html.d.ts

@@ -0,0 +1,10 @@
+/**
+ * @file HTMLParser.ts
+ * @description Parser para arquivos HTML (.html, .htm)
+ */
+import type { ParserResult } from "../types/parser";
+import { BaseParser } from "./base";
+export declare class HTMLParser extends BaseParser {
+    parse(content: string): ParserResult;
+}
+//# sourceMappingURL=html.d.ts.map

package/dist/parsers/html.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"html.d.ts","sourceRoot":"","sources":["../../src/parsers/html.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAkB,MAAM,iBAAiB,CAAC;AACpE,OAAO,EAAE,UAAU,EAAE,MAAM,QAAQ,CAAC;AAEpC,qBAAa,UAAW,SAAQ,UAAU;IACzC,KAAK,CAAC,OAAO,EAAE,MAAM,GAAG,YAAY;CA8CpC"}

package/dist/parsers/js.d.ts

@@ -0,0 +1,10 @@
+/**
+ * @file JavaScriptParser.ts
+ * @description Parser para arquivos JavaScript/TypeScript (.js, .ts, .mjs, .cjs)
+ */
+import type { ParserResult } from "../types/parser";
+import { BaseParser } from "./base";
+export declare class JavaScriptParser extends BaseParser {
+    parse(content: string): ParserResult;
+}
+//# sourceMappingURL=js.d.ts.map

package/dist/parsers/js.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"js.d.ts","sourceRoot":"","sources":["../../src/parsers/js.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAkB,MAAM,iBAAiB,CAAC;AACpE,OAAO,EAAE,UAAU,EAAE,MAAM,QAAQ,CAAC;AAEpC,qBAAa,gBAAiB,SAAQ,UAAU;IAC/C,KAAK,CAAC,OAAO,EAAE,MAAM,GAAG,YAAY;CA8OpC"}

package/dist/parsers/jsx.d.ts

@@ -0,0 +1,20 @@
+/**
+ * @file JSXParser.ts
+ * @description Parser para arquivos JSX/TSX (.jsx, .tsx)
+ */
+import type { ParserResult } from "../types/parser";
+import { BaseParser } from "./base";
+export declare class JSXParser extends BaseParser {
+    parse(content: string): ParserResult;
+    /**
+     * Remove comentários JavaScript normais (fora do JSX).
+     * Protege comentários JSX ({ /* ... */ }) de serem processados
+     * como block comments do JS, delegando ao JavaScriptParser.
+     */
+    private removeJavaScriptComments;
+    /**
+     * Remove comentários JSX ({* ... *})
+     */
+    private removeJSXComments;
+}
+//# sourceMappingURL=jsx.d.ts.map

package/dist/parsers/jsx.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"jsx.d.ts","sourceRoot":"","sources":["../../src/parsers/jsx.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAkB,MAAM,iBAAiB,CAAC;AACpE,OAAO,EAAE,UAAU,EAAE,MAAM,QAAQ,CAAC;AAGpC,qBAAa,SAAU,SAAQ,UAAU;IACxC,KAAK,CAAC,OAAO,EAAE,MAAM,GAAG,YAAY;IAgCpC;;;;OAIG;IACH,OAAO,CAAC,wBAAwB;IA6BhC;;OAEG;IACH,OAAO,CAAC,iBAAiB;CAuCzB"}

package/dist/parsers/vue.d.ts

@@ -0,0 +1,30 @@
+/**
+ * @file VueParser.ts
+ * @description Parser para arquivos Vue (.vue)
+ */
+import type { ParserResult } from "../types/parser";
+import { BaseParser } from "./base";
+export declare class VueParser extends BaseParser {
+    parse(content: string): ParserResult;
+    /**
+     * Separa as seções do arquivo Vue
+     */
+    private parseSections;
+    /**
+     * Reconstrói o arquivo Vue
+     */
+    private reconstructVueFile;
+    /**
+     * Remove comentários HTML
+     */
+    private removeHTMLComments;
+    /**
+     * Remove comentários JavaScript
+     */
+    private removeJavaScriptComments;
+    /**
+     * Remove comentários CSS
+     */
+    private removeCSSComments;
+}
+//# sourceMappingURL=vue.d.ts.map

package/dist/parsers/vue.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"vue.d.ts","sourceRoot":"","sources":["../../src/parsers/vue.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAkB,MAAM,iBAAiB,CAAC;AACpE,OAAO,EAAE,UAAU,EAAE,MAAM,QAAQ,CAAC;AAepC,qBAAa,SAAU,SAAQ,UAAU;IACxC,KAAK,CAAC,OAAO,EAAE,MAAM,GAAG,YAAY;IA6CpC;;OAEG;IACH,OAAO,CAAC,aAAa;IA6CrB;;OAEG;IACH,OAAO,CAAC,kBAAkB;IAwB1B;;OAEG;IACH,OAAO,CAAC,kBAAkB;IAiC1B;;OAEG;IACH,OAAO,CAAC,wBAAwB;IA0DhC;;OAEG;IACH,OAAO,CAAC,iBAAiB;CAgCzB"}

package/dist/postinstall.d.ts

@@ -0,0 +1,8 @@
+/**
+ * @file postinstall.ts
+ * @description Roda automaticamente apos "npm install / bun install".
+ *   Se nenhum arquivo de config for encontrado no projeto, exibe uma dica
+ *   para o usuario executar "refine init".
+ */
+export {};
+//# sourceMappingURL=postinstall.d.ts.map

package/dist/postinstall.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"postinstall.d.ts","sourceRoot":"","sources":["../src/postinstall.ts"],"names":[],"mappings":"AAAA;;;;;GAKG"}

package/dist/postinstall.js

@@ -0,0 +1,300 @@
+// src/postinstall.ts
+import * as path3 from "node:path";
+import { fileURLToPath } from "node:url";
+
+// src/ConfigLoader.ts
+import * as os from "node:os";
+import * as path2 from "node:path";
+
+// src/libs/fileUtils.ts
+import * as fs from "node:fs";
+import * as fsPromises from "node:fs/promises";
+import * as path from "node:path";
+
+class FileUtils {
+  static async readFile(filePath) {
+    try {
+      return await fsPromises.readFile(filePath, "utf-8");
+    } catch (error) {
+      throw new Error(`Failed to read file ${filePath}: ${error.message}`);
+    }
+  }
+  static async writeFile(filePath, content) {
+    try {
+      const dir = path.dirname(filePath);
+      await FileUtils.ensureDir(dir);
+      await fsPromises.writeFile(filePath, content, "utf-8");
+    } catch (error) {
+      throw new Error(`Failed to write file ${filePath}: ${error.message}`);
+    }
+  }
+  static async readDir(dirPath) {
+    try {
+      return await fsPromises.readdir(dirPath);
+    } catch (error) {
+      throw new Error(`Failed to read directory ${dirPath}: ${error.message}`);
+    }
+  }
+  static async stat(itemPath) {
+    try {
+      return await fsPromises.stat(itemPath);
+    } catch (error) {
+      throw new Error(`Failed to stat ${itemPath}: ${error.message}`);
+    }
+  }
+  static async exists(itemPath) {
+    try {
+      await fsPromises.access(itemPath, fs.constants.F_OK);
+      return true;
+    } catch {
+      return false;
+    }
+  }
+  static async isDirectory(itemPath) {
+    try {
+      const stats = await fsPromises.stat(itemPath);
+      return stats.isDirectory();
+    } catch {
+      return false;
+    }
+  }
+  static async ensureDir(dirPath) {
+    try {
+      if (!await FileUtils.exists(dirPath)) {
+        await fsPromises.mkdir(dirPath, { recursive: true });
+      }
+    } catch (error) {
+      throw new Error(`Failed to ensure directory ${dirPath}: ${error.message}`);
+    }
+  }
+  static async copyFile(src, dest) {
+    try {
+      const destDir = path.dirname(dest);
+      await FileUtils.ensureDir(destDir);
+      await fsPromises.copyFile(src, dest);
+    } catch (error) {
+      throw new Error(`Failed to copy file from ${src} to ${dest}: ${error.message}`);
+    }
+  }
+  static getExtension(filePath) {
+    return path.extname(filePath);
+  }
+  static resolvePath(...paths) {
+    return path.resolve(...paths);
+  }
+  static relativePath(from, to) {
+    return path.relative(from, to);
+  }
+  static matchesPattern(filePath, pattern) {
+    const regexPattern = pattern.replace(/\./g, "\\.").replace(/\*/g, ".*").replace(/\?/g, ".");
+    const regex = new RegExp(`^${regexPattern}$`);
+    const fileName = path.basename(filePath);
+    return regex.test(fileName);
+  }
+  static shouldExclude(filePath, patterns) {
+    const fileName = path.basename(filePath);
+    for (const pattern of patterns) {
+      if (FileUtils.matchesPattern(fileName, pattern)) {
+        return true;
+      }
+    }
+    return false;
+  }
+}
+
+// src/ConfigLoader.ts
+var CONFIG_CANDIDATES = ["refine.json", ".refine.json"];
+
+class ConfigLoader {
+  static getGlobalConfigPath() {
+    const home = os.homedir();
+    const configDir = process.platform === "win32" ? path2.join(process.env.APPDATA ?? home, "refine") : path2.join(home, ".config", "refine");
+    return path2.join(configDir, "refine.json");
+  }
+  static async detectGlobalConfig() {
+    const globalPath = ConfigLoader.getGlobalConfigPath();
+    if (await FileUtils.exists(globalPath)) {
+      return globalPath;
+    }
+    return null;
+  }
+  static async detectConfigFile() {
+    const cwd = process.cwd();
+    for (const name of CONFIG_CANDIDATES) {
+      const filePath = path2.join(cwd, name);
+      if (await FileUtils.exists(filePath)) {
+        return filePath;
+      }
+    }
+    const configJson = path2.join(cwd, "config.json");
+    if (await FileUtils.exists(configJson)) {
+      try {
+        const content = await FileUtils.readFile(configJson);
+        const parsed = JSON.parse(content);
+        if ("refine" in parsed) {
+          return configJson;
+        }
+      } catch {}
+    }
+    return null;
+  }
+  static async load(configPath) {
+    const absolutePath = path2.resolve(process.cwd(), configPath);
+    if (!await FileUtils.exists(absolutePath)) {
+      throw new Error(`Config file not found: ${absolutePath}`);
+    }
+    const content = await FileUtils.readFile(absolutePath);
+    let parsed;
+    try {
+      parsed = JSON.parse(content);
+    } catch (error) {
+      throw new Error(`Failed to parse config file: ${error.message}`);
+    }
+    const raw = "refine" in parsed ? parsed.refine : parsed;
+    ConfigLoader.validate(raw);
+    raw.targetDirectory = path2.resolve(process.cwd(), raw.targetDirectory);
+    if (raw.outputDirectory) {
+      raw.outputDirectory = path2.resolve(process.cwd(), raw.outputDirectory);
+    }
+    return raw;
+  }
+  static createDefault() {
+    return {
+      targetDirectory: "./src",
+      fileExtensions: [
+        ".js",
+        ".mjs",
+        ".cjs",
+        ".ts",
+        ".jsx",
+        ".tsx",
+        ".vue",
+        ".svelte",
+        ".astro",
+        ".html",
+        ".htm",
+        ".jsonc"
+      ],
+      excludeFiles: ["*.config.js", "*.config.ts"],
+      excludeDirs: ["node_modules", "dist", "build", ".git"],
+      preserveComments: [
+        "// @ts-expect-error",
+        "// @ts-ignore",
+        "/// <reference",
+        "#!/usr/bin/env node",
+        "// biome-ignore",
+        "/* webpackIgnore:",
+        "/* webpackChunkName:"
+      ],
+      preservePatterns: [
+        "^\\s*//\\s*@ts-",
+        "^\\s*///\\s*<reference",
+        "^#!/",
+        "biome-ignore",
+        "webpack[A-Za-z]"
+      ],
+      removeJSDoc: false,
+      removeTODO: true,
+      removeFIXME: true,
+      removeNOTE: true,
+      dryRun: false,
+      verbose: false,
+      concurrency: 8
+    };
+  }
+  static async mergeIntoExisting(filePath, config) {
+    const absolutePath = path2.resolve(process.cwd(), filePath);
+    const content = await FileUtils.readFile(absolutePath);
+    let parsed;
+    try {
+      parsed = JSON.parse(content);
+    } catch (error) {
+      throw new Error(`Failed to parse existing file: ${error.message}`);
+    }
+    parsed.refine = config;
+    await FileUtils.writeFile(absolutePath, JSON.stringify(parsed, null, 2));
+  }
+  static validate(config) {
+    if (!config.targetDirectory) {
+      throw new Error("targetDirectory is required in config");
+    }
+    if (!config.fileExtensions || config.fileExtensions.length === 0) {
+      throw new Error("fileExtensions must be a non-empty array");
+    }
+    if (!config.excludeFiles)
+      config.excludeFiles = [];
+    if (!config.excludeDirs)
+      config.excludeDirs = [];
+    if (!config.preserveComments)
+      config.preserveComments = [];
+    if (!config.preservePatterns)
+      config.preservePatterns = [];
+    if (config.removeJSDoc === undefined)
+      config.removeJSDoc = false;
+    if (config.removeTODO === undefined)
+      config.removeTODO = true;
+    if (config.removeFIXME === undefined)
+      config.removeFIXME = true;
+    if (config.removeNOTE === undefined)
+      config.removeNOTE = true;
+    if (config.dryRun === undefined)
+      config.dryRun = false;
+    if (config.verbose === undefined)
+      config.verbose = false;
+  }
+  static async save(config, configPath) {
+    const absolutePath = path2.resolve(process.cwd(), configPath);
+    const content = JSON.stringify(config, null, 2);
+    await FileUtils.writeFile(absolutePath, content);
+  }
+}
+
+// src/postinstall.ts
+var isGlobalInstall = process.env.npm_config_global === "true";
+async function main() {
+  const cwd = process.cwd();
+  const selfPkg = path3.join(fileURLToPath(new URL(".", import.meta.url)), "..", "package.json");
+  const cwdPkg = path3.join(cwd, "package.json");
+  if (path3.resolve(selfPkg) === path3.resolve(cwdPkg))
+    return;
+  if (isGlobalInstall) {
+    const globalConfigPath = ConfigLoader.getGlobalConfigPath();
+    if (!await FileUtils.exists(globalConfigPath)) {
+      const defaultConfig = ConfigLoader.createDefault();
+      await ConfigLoader.save(defaultConfig, globalConfigPath);
+      console.log(`
+${"─".repeat(50)}`);
+      console.log("  refine installed globally!");
+      console.log("  Default config created at:");
+      console.log(`    ${globalConfigPath}`);
+      console.log("  Edit it to customize the default behavior.");
+      console.log(`${"─".repeat(50)}
+`);
+    }
+    return;
+  }
+  for (const name of CONFIG_CANDIDATES) {
+    if (await FileUtils.exists(path3.join(cwd, name)))
+      return;
+  }
+  const configJson = path3.join(cwd, "config.json");
+  if (await FileUtils.exists(configJson)) {
+    try {
+      const content = await FileUtils.readFile(configJson);
+      const parsed = JSON.parse(content);
+      if ("refine" in parsed)
+        return;
+    } catch {}
+  }
+  console.log(`
+${"─".repeat(50)}`);
+  console.log("  refine installed!");
+  console.log("  Run the following command in your project root");
+  console.log("  to create a config file:");
+  console.log(`
+    refine init
+`);
+  console.log(`${"─".repeat(50)}
+`);
+}
+main().catch(() => {});

package/dist/types/config.d.ts

@@ -0,0 +1,53 @@
+/**
+ * @file config.types.ts
+ * @description Tipos TypeScript para configuração do Comment Remover
+ */
+export interface Config {
+    /** Diretório alvo para processar */
+    targetDirectory: string;
+    /** Diretório de saída (opcional, se não especificado sobrescreve originais) */
+    outputDirectory?: string;
+    /** Extensões de arquivos a serem processados */
+    fileExtensions: string[];
+    /** Arquivos a serem excluídos (suporta glob patterns) */
+    excludeFiles: string[];
+    /** Diretórios a serem excluídos */
+    excludeDirs: string[];
+    /** Lista de comentários específicos que devem ser preservados */
+    preserveComments: string[];
+    /** Padrões regex para preservar comentários */
+    preservePatterns: string[];
+    /** Remover comentários JSDoc (@param, @returns, etc) */
+    removeJSDoc: boolean;
+    /** Remover comentários TODO */
+    removeTODO: boolean;
+    /** Remover comentários FIXME */
+    removeFIXME: boolean;
+    /** Remover comentários NOTE */
+    removeNOTE: boolean;
+    /** Modo dry run (não modifica arquivos) */
+    dryRun: boolean;
+    /** Modo verbose (logs detalhados) */
+    verbose: boolean;
+    /** Numero maximo de arquivos processados em paralelo (default: 8) */
+    concurrency?: number;
+    /** Caminho para salvar o report JSON apos o processamento */
+    reportPath?: string;
+    /** Caminho para o arquivo de ignore no estilo gitignore (default: .refineignore) */
+    ignoreFile?: string;
+}
+export interface ProcessingStats {
+    /** Total de arquivos processados */
+    filesProcessed: number;
+    /** Total de arquivos ignorados */
+    filesSkipped: number;
+    /** Total de comentários removidos */
+    commentsRemoved: number;
+    /** Total de comentários preservados */
+    commentsPreserved: number;
+    /** Arquivos com erros */
+    filesWithErrors: string[];
+    /** Tempo de processamento em ms */
+    processingTime: number;
+}
+//# sourceMappingURL=config.d.ts.map

package/dist/types/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../src/types/config.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,MAAM,WAAW,MAAM;IACtB,oCAAoC;IACpC,eAAe,EAAE,MAAM,CAAC;IAExB,+EAA+E;IAC/E,eAAe,CAAC,EAAE,MAAM,CAAC;IAEzB,gDAAgD;IAChD,cAAc,EAAE,MAAM,EAAE,CAAC;IAEzB,yDAAyD;IACzD,YAAY,EAAE,MAAM,EAAE,CAAC;IAEvB,mCAAmC;IACnC,WAAW,EAAE,MAAM,EAAE,CAAC;IAEtB,iEAAiE;IACjE,gBAAgB,EAAE,MAAM,EAAE,CAAC;IAE3B,+CAA+C;IAC/C,gBAAgB,EAAE,MAAM,EAAE,CAAC;IAE3B,wDAAwD;IACxD,WAAW,EAAE,OAAO,CAAC;IAErB,+BAA+B;IAC/B,UAAU,EAAE,OAAO,CAAC;IAEpB,gCAAgC;IAChC,WAAW,EAAE,OAAO,CAAC;IAErB,+BAA+B;IAC/B,UAAU,EAAE,OAAO,CAAC;IAEpB,2CAA2C;IAC3C,MAAM,EAAE,OAAO,CAAC;IAEhB,qCAAqC;IACrC,OAAO,EAAE,OAAO,CAAC;IAEjB,qEAAqE;IACrE,WAAW,CAAC,EAAE,MAAM,CAAC;IAErB,6DAA6D;IAC7D,UAAU,CAAC,EAAE,MAAM,CAAC;IAEpB,oFAAoF;IACpF,UAAU,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,eAAe;IAC/B,oCAAoC;IACpC,cAAc,EAAE,MAAM,CAAC;IAEvB,kCAAkC;IAClC,YAAY,EAAE,MAAM,CAAC;IAErB,qCAAqC;IACrC,eAAe,EAAE,MAAM,CAAC;IAExB,uCAAuC;IACvC,iBAAiB,EAAE,MAAM,CAAC;IAE1B,yBAAyB;IACzB,eAAe,EAAE,MAAM,EAAE,CAAC;IAE1B,mCAAmC;IACnC,cAAc,EAAE,MAAM,CAAC;CACvB"}

package/dist/types/parser.d.ts

@@ -0,0 +1,25 @@
+/**
+ * @file parser.types.ts
+ * @description Tipos TypeScript para parsers
+ */
+import type { Config } from "./config";
+export interface RemovedComment {
+    line: number;
+    preview: string;
+}
+export interface ParserResult {
+    content: string;
+    commentsRemoved: number;
+    commentsPreserved: number;
+    preservedLines: number[];
+    removedComments: RemovedComment[];
+}
+export interface IParser {
+    parse(content: string): ParserResult;
+    shouldPreserve(comment: string): boolean;
+}
+export interface ParserOptions {
+    config: Config;
+    fileExtension: string;
+}
+//# sourceMappingURL=parser.d.ts.map

package/dist/types/parser.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"parser.d.ts","sourceRoot":"","sources":["../../src/types/parser.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,UAAU,CAAC;AAEvC,MAAM,WAAW,cAAc;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,YAAY;IAC5B,OAAO,EAAE,MAAM,CAAC;IAChB,eAAe,EAAE,MAAM,CAAC;IACxB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,cAAc,EAAE,MAAM,EAAE,CAAC;IACzB,eAAe,EAAE,cAAc,EAAE,CAAC;CAClC;AAED,MAAM,WAAW,OAAO;IACvB,KAAK,CAAC,OAAO,EAAE,MAAM,GAAG,YAAY,CAAC;IACrC,cAAc,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC;CACzC;AAED,MAAM,WAAW,aAAa;IAC7B,MAAM,EAAE,MAAM,CAAC;IACf,aAAa,EAAE,MAAM,CAAC;CACtB"}