@reverse-craft/smart-fs 1.0.7 → 2.0.1

package/README.md

@@ -1,133 +1,138 @@
 # @reverse-craft/smart-fs
 
-MCP server for AI-assisted JavaScript reverse engineering. Beautifies minified/obfuscated code and truncates long strings to prevent LLM context overflow.
+Smart code processing library with beautification, truncation, search, analysis, and transformation. Multi-language support with source map generation.
 
-## Why?
+## Features
 
-When reverse engineering JavaScript (minified or obfuscated code), AI assistants face two problems:
+- **Code Beautification** - Format minified/obfuscated code with source maps (set breakpoints in Chrome DevTools)
+- **Smart Truncation** - Truncate long strings while preserving line numbers and structure
+- **Code Search** - Search in beautified code, returns original file positions
+- **Variable Analysis** - AST-based scope analysis to find definitions and references
+- **Code Transform** - Apply custom Babel plugins for transformation
 
-1. **Minified code is unreadable** - Single-line code with no formatting
-2. **Long strings overflow context** - Base64 blobs, encrypted data, and huge arrays waste precious tokens
+## Supported Languages
 
-This MCP server solves both by:
-- Auto-beautifying code with source maps (so you can set breakpoints in Chrome DevTools)
-- Truncating strings over a configurable limit while preserving line numbers
+| Language | Beautify | AST Truncation | Source Map |
+|----------|----------|----------------|------------|
+| JavaScript/TypeScript | ✓ | ✓ | ✓ |
+| JSON | ✓ | - | - |
+| HTML/XML | ✓ | - | - |
+| CSS | ✓ | - | - |
+| Others | Fallback | Fallback | - |
 
 ## Installation
 
 ```bash
-npm install -g @reverse-craft/smart-fs
+npm install @reverse-craft/smart-fs
 ```
 
-## MCP Configuration
+## Quick Start
 
-Add to your MCP config (e.g., `~/.kiro/settings/mcp.json`):
+```typescript
+import { smartRead, smartSearch, findUsage } from '@reverse-craft/smart-fs';
 
-```json
-{
-  "mcpServers": {
-    "smart-fs": {
-      "command": "npx",
-      "args": ["@reverse-craft/smart-fs"]
-    }
-  }
-}
-```
+// Read and process file
+const result = await smartRead('./dist/app.min.js', {
+  charLimit: 300,      // String truncation length
+  maxLineChars: 500,   // Max characters per line
+});
+console.log(result.code);
 
-Or if installed globally:
+// Search code
+const searchResult = await smartSearch('./dist/app.min.js', 'function', {
+  contextLines: 2,
+  caseSensitive: false,
+});
+console.log(searchResult.formatted);
 
-```json
-{
-  "mcpServers": {
-    "smart-fs": {
-      "command": "smart-fs"
-    }
-  }
-}
+// Find variable usage
+const usageResult = await findUsage('./dist/app.min.js', 'myFunction');
+console.log(usageResult.formatted);
 ```
 
-## Usage
+## API
 
-The server provides three tools:
+### Convenience Functions
 
-### 1. read_code_smart
+#### `smartRead(filePath, options?)`
 
-Read and beautify minified/obfuscated JavaScript code with source map coordinates.
+Read file with beautification and truncation.
 
-#### Parameters
+```typescript
+const result = await smartRead('./app.min.js', {
+  startLine: 1,        // Start line (optional)
+  endLine: 100,        // End line (optional)
+  charLimit: 300,      // String truncation length
+  maxLineChars: 500,   // Max characters per line
+  saveLocal: false,    // Save beautified file locally
+});
+```
 
-| Parameter | Type | Required | Default | Description |
-|-----------|------|----------|---------|-------------|
-| `file_path` | string | ✓ | - | Path to JavaScript file |
-| `start_line` | number | ✓ | - | Start line (1-based) |
-| `end_line` | number | ✓ | - | End line (1-based) |
-| `char_limit` | number | | 300 | Max string length before truncation |
-| `max_line_chars` | number | | 500 | Maximum characters per line |
-| `save_local` | boolean | | false | Save beautified file locally |
+#### `smartSearch(filePath, query, options?)`
 
-#### Example Output
+Search in beautified code, returns original file positions.
 
+```typescript
+const result = await smartSearch('./app.min.js', 'decrypt', {
+  isRegex: false,
+  caseSensitive: false,
+  contextLines: 2,
+  maxMatches: 50,
+});
 ```
-/path/to/obfuscated.js (1-20/5000)
-Src=original position for breakpoints
- 1 L1:0       var _0x1234 = function() {
- 2 L1:25        var data = "SGVsbG8gV29ybGQ=...[TRUNCATED 50000 CHARS]...base64==";
- 3 L1:50078    return decode(data);
- 4 L1:50100  };
 
-... (Use next start_line=21 to read more)
+#### `findUsage(filePath, identifier, options?)`
+
+Find all definitions and references of a variable/function.
+
+```typescript
+const result = await findUsage('./app.min.js', '_0x1234', {
+  targetLine: 42,      // Target line for precise binding
+  maxReferences: 10,
+});
 ```
 
-### 2. find_usage_smart
+### Module Exports
 
-Find all definitions and references of a variable/function using AST scope analysis.
+The library exports the following modules:
 
-#### Parameters
+```typescript
+// Language detection
+import { detectLanguage, getLanguageInfo, isFullySupportedLanguage } from '@reverse-craft/smart-fs';
 
-| Parameter | Type | Required | Default | Description |
-|-----------|------|----------|---------|-------------|
-| `file_path` | string | ✓ | - | Path to JavaScript file |
-| `identifier` | string | ✓ | - | Variable or function name to find |
-| `line` | number | | - | Line number for precise binding (recommended for obfuscated code) |
-| `char_limit` | number | | 300 | Max string length before truncation |
-| `max_line_chars` | number | | 500 | Maximum characters per line |
+// Code beautification
+import { beautifyCode, ensureBeautified } from '@reverse-craft/smart-fs';
 
-#### Example Output
+// Code truncation
+import { truncateCode, truncateCodeFromFile, truncateFallback } from '@reverse-craft/smart-fs';
 
-```
-/path/to/obfuscated.js
-Identifier="_0x1234"
-Src=original position for breakpoints
-Bindings: 1 (Targeted at line 10)
---- Targeted Scope (const) ---
-📍 Definition:
-      5 L1:100      const _0x1234 = function() {
-🔎 References (3):
-     10 L1:200      return _0x1234(); ◀── hit
-     15 L1:300      _0x1234.call(this);
-     20 L1:400      console.log(_0x1234);
-```
+// Code search
+import { searchInCode, formatSearchResult } from '@reverse-craft/smart-fs';
 
-### 3. search_code_smart
+// Variable analysis
+import { analyzeBindings, formatAnalysisResult } from '@reverse-craft/smart-fs';
 
-Search for text or regex patterns in beautified JavaScript code.
+// Code transformation
+import { applyCustomTransform, loadBabelPlugin } from '@reverse-craft/smart-fs';
+```
 
-#### Parameters
+## Output Examples
 
-| Parameter | Type | Required | Default | Description |
-|-----------|------|----------|---------|-------------|
-| `file_path` | string | ✓ | - | Path to JavaScript file |
-| `query` | string | ✓ | - | Text or regex pattern to search |
-| `context_lines` | number | | 2 | Number of context lines |
-| `case_sensitive` | boolean | | false | Case sensitive search |
-| `is_regex` | boolean | | false | Treat query as regex pattern |
-| `char_limit` | number | | 300 | Max string length before truncation |
-| `max_line_chars` | number | | 500 | Maximum characters per line |
+### smartRead Output
 
-#### Example Output
+```
+/path/to/app.min.js (1-20/5000)
+Src=original position for breakpoints
+ 1 L1:0       var _0x1234 = function() {
+ 2 L1:25        var data = "SGVsbG8gV29ybGQ=...[TRUNCATED 50000 CHARS]...base64==";
+ 3 L1:50078    return decode(data);
+ 4 L1:50100  };
+```
+
+### smartSearch Output
 
 ```
-/path/to/obfuscated.js
+/path/to/app.min.js
 Query="decrypt" (literal, case-insensitive)
 Src=original position for breakpoints
 Matches: 3
@@ -136,29 +141,38 @@ Matches: 3
   41 L1:1020      var key = getKey();
 >>42 L1:1050      return decrypt(data, key);
   43 L1:1080    }
-  44 L1:1100    
 ```
 
-The `Src L:C` shows the original position in the minified file - use these coordinates to set breakpoints in Chrome DevTools.
+### findUsage Output
 
-## Features
+```
+/path/to/app.min.js
+Identifier="_0x1234"
+Src=original position for breakpoints
+Bindings: 1 (Targeted at line 10)
+--- Targeted Scope (const) ---
+📍 Definition:
+      5 L1:100      const _0x1234 = function() {
+� Referetnces (3):
+     10 L1:200      return _0x1234(); ◀── hit
+     15 L1:300      _0x1234.call(this);
+     20 L1:400      console.log(_0x1234);
+```
+
+## Related Packages
 
-- **Auto-beautify**: Formats minified JS using esbuild
-- **Source maps**: Maps beautified lines back to original positions
-- **Smart truncation**: Preserves line count when truncating strings
-- **Caching**: Beautified files are cached based on file modification time
-- **Pagination**: Large files can be read in chunks
+- **[@reverse-craft/smart-fs-mcp](https://github.com/reverse-craft/smart-fs-mcp)** - MCP server exposing smart-fs as MCP tools
+- **[@reverse-craft/ai-tools](https://github.com/reverse-craft/ai-tools)** - AI-powered tools like JSVMP dispatcher detection
 
 ## How It Works
 
 1. **Beautification**: Uses esbuild to format minified code and generate source maps
-2. **Truncation**: Parses AST with meriyah, truncates long string literals while preserving newlines
-3. **Mapping**: Uses source-map-js to map each beautified line back to original coordinates
+2. **Truncation**: Parses AST with meriyah, truncates long strings while preserving newlines
+3. **Mapping**: Uses source-map-js to map beautified lines back to original positions
 
 ## Use Cases
 
 - Reverse engineering obfuscated/minified JavaScript
-- Analyzing obfuscated JavaScript
 - Understanding minified third-party libraries
 - Setting breakpoints in beautified code while debugging original
 

package/README.zh-CN.md

@@ -0,0 +1,181 @@
+# @reverse-craft/smart-fs
+
+智能代码处理库，提供代码美化、截断、搜索、分析和转换功能，支持多语言和 Source Map 生成。
+
+## 功能特性
+
+- **代码美化** - 格式化压缩/混淆代码，生成 Source Map（可在 Chrome DevTools 中设置断点）
+- **智能截断** - 截断超长字符串，保留行号和代码结构
+- **代码搜索** - 在美化后的代码中搜索，返回原始文件位置
+- **变量分析** - 基于 AST 作用域分析，查找变量/函数的定义和引用
+- **代码转换** - 应用自定义 Babel 插件进行代码转换
+
+## 支持的语言
+
+| 语言 | 美化 | AST 截断 | Source Map |
+|------|------|----------|------------|
+| JavaScript/TypeScript | ✓ | ✓ | ✓ |
+| JSON | ✓ | - | - |
+| HTML/XML | ✓ | - | - |
+| CSS | ✓ | - | - |
+| 其他 | 回退模式 | 回退模式 | - |
+
+## 安装
+
+```bash
+npm install @reverse-craft/smart-fs
+```
+
+## 快速开始
+
+```typescript
+import { smartRead, smartSearch, findUsage } from '@reverse-craft/smart-fs';
+
+// 读取并处理文件
+const result = await smartRead('./dist/app.min.js', {
+  charLimit: 300,      // 字符串截断长度
+  maxLineChars: 500,   // 每行最大字符数
+});
+console.log(result.code);
+
+// 搜索代码
+const searchResult = await smartSearch('./dist/app.min.js', 'function', {
+  contextLines: 2,
+  caseSensitive: false,
+});
+console.log(searchResult.formatted);
+
+// 查找变量用法
+const usageResult = await findUsage('./dist/app.min.js', 'myFunction');
+console.log(usageResult.formatted);
+```
+
+## API
+
+### 便捷函数
+
+#### `smartRead(filePath, options?)`
+
+读取文件并进行美化和截断处理。
+
+```typescript
+const result = await smartRead('./app.min.js', {
+  startLine: 1,        // 起始行（可选）
+  endLine: 100,        // 结束行（可选）
+  charLimit: 300,      // 字符串截断长度
+  maxLineChars: 500,   // 每行最大字符数
+  saveLocal: false,    // 是否保存美化后的文件
+});
+```
+
+#### `smartSearch(filePath, query, options?)`
+
+在美化后的代码中搜索，返回原始文件位置。
+
+```typescript
+const result = await smartSearch('./app.min.js', 'decrypt', {
+  isRegex: false,
+  caseSensitive: false,
+  contextLines: 2,
+  maxMatches: 50,
+});
+```
+
+#### `findUsage(filePath, identifier, options?)`
+
+查找变量/函数的所有定义和引用。
+
+```typescript
+const result = await findUsage('./app.min.js', '_0x1234', {
+  targetLine: 42,      // 指定行号精确定位
+  maxReferences: 10,
+});
+```
+
+### 模块导出
+
+库导出以下模块，可按需使用：
+
+```typescript
+// 语言检测
+import { detectLanguage, getLanguageInfo, isFullySupportedLanguage } from '@reverse-craft/smart-fs';
+
+// 代码美化
+import { beautifyCode, ensureBeautified } from '@reverse-craft/smart-fs';
+
+// 代码截断
+import { truncateCode, truncateCodeFromFile, truncateFallback } from '@reverse-craft/smart-fs';
+
+// 代码搜索
+import { searchInCode, formatSearchResult } from '@reverse-craft/smart-fs';
+
+// 变量分析
+import { analyzeBindings, formatAnalysisResult } from '@reverse-craft/smart-fs';
+
+// 代码转换
+import { applyCustomTransform, loadBabelPlugin } from '@reverse-craft/smart-fs';
+```
+
+## 输出示例
+
+### smartRead 输出
+
+```
+/path/to/app.min.js (1-20/5000)
+Src=原始位置（用于设置断点）
+ 1 L1:0       var _0x1234 = function() {
+ 2 L1:25        var data = "SGVsbG8gV29ybGQ=...[TRUNCATED 50000 CHARS]...base64==";
+ 3 L1:50078    return decode(data);
+ 4 L1:50100  };
+```
+
+### smartSearch 输出
+
+```
+/path/to/app.min.js
+Query="decrypt" (literal, case-insensitive)
+Src=原始位置（用于设置断点）
+Matches: 3
+--- Line 42 ---
+  40 L1:1000    function process(data) {
+  41 L1:1020      var key = getKey();
+>>42 L1:1050      return decrypt(data, key);
+  43 L1:1080    }
+```
+
+### findUsage 输出
+
+```
+/path/to/app.min.js
+Identifier="_0x1234"
+Src=原始位置（用于设置断点）
+Bindings: 1 (Targeted at line 10)
+--- Targeted Scope (const) ---
+📍 Definition:
+      5 L1:100      const _0x1234 = function() {
+🔎 References (3):
+     10 L1:200      return _0x1234(); ◀── hit
+     15 L1:300      _0x1234.call(this);
+     20 L1:400      console.log(_0x1234);
+```
+
+## 相关包
+
+- **[@reverse-craft/smart-fs-mcp](https://github.com/reverse-craft/smart-fs-mcp)** - MCP 服务器，将 smart-fs 功能暴露为 MCP 工具
+- **[@reverse-craft/ai-tools](https://github.com/reverse-craft/ai-tools)** - AI 辅助工具，如 JSVMP 分发器检测
+
+## 工作原理
+
+1. **美化**: 使用 esbuild 格式化压缩代码并生成 Source Map
+2. **截断**: 使用 meriyah 解析 AST，截断长字符串同时保留换行符
+3. **映射**: 使用 source-map-js 将美化后的行映射回原始位置
+
+## 使用场景
+
+- 逆向分析混淆/压缩的 JavaScript
+- 理解第三方压缩库
+- 在美化代码中设置断点调试原始代码
+
+## License
+
+MIT

package/dist/analyzer.d.ts

@@ -0,0 +1,91 @@
+import type { SourceMap } from './beautifier.js';
+/**
+ * Original position from source map
+ */
+export interface OriginalPosition {
+    line: number | null;
+    column: number | null;
+}
+/**
+ * Location information for a definition or reference
+ */
+export interface LocationInfo {
+    /** Line number in beautified code (1-based) */
+    line: number;
+    /** Column number in beautified code (0-based) */
+    column: number;
+    /** Original file coordinates from source map */
+    originalPosition: OriginalPosition;
+    /** Content of the line containing this location */
+    lineContent: string;
+}
+/**
+ * Binding information for a variable/function
+ */
+export interface BindingInfo {
+    /** Unique scope identifier */
+    scopeUid: number;
+    /** Binding kind (var, let, const, param, etc.) */
+    kind: string;
+    /** Definition location */
+    definition: LocationInfo;
+    /** All reference locations */
+    references: LocationInfo[];
+    /** Total reference count (before limiting) */
+    totalReferences: number;
+    /** The location that matched the target line (if targeted search) */
+    hitLocation?: LocationInfo;
+}
+/**
+ * Analysis result containing all bindings for an identifier
+ */
+export interface AnalysisResult {
+    /** All bindings found for the identifier */
+    bindings: BindingInfo[];
+    /** The identifier that was searched */
+    identifier: string;
+    /** Whether this was a targeted (line-specific) search */
+    isTargeted: boolean;
+    /** The target line if specified */
+    targetLine?: number;
+}
+/**
+ * Parse JavaScript/TypeScript code into an AST
+ * @param code - Source code to parse
+ * @returns Parsed AST
+ * @throws Error if parsing fails
+ */
+export declare function parseCode(code: string): import("@babel/parser").ParseResult<import("@babel/types").File>;
+/**
+ * Options for binding analysis
+ */
+export interface AnalyzeOptions {
+    /** Maximum references to return per binding (default 10) */
+    maxReferences?: number;
+    /** Target line number for precise binding identification (1-based) */
+    targetLine?: number;
+}
+/**
+ * Analyze bindings for a specific identifier in the code
+ * Uses Babel traverse to find all bindings and their references
+ *
+ * @param code - Beautified code to analyze
+ * @param rawMap - Source map for coordinate mapping
+ * @param identifier - Variable/function name to find
+ * @param options - Analysis options
+ * @returns Analysis result with all bindings
+ */
+export declare function analyzeBindings(code: string, rawMap: SourceMap, identifier: string, options?: AnalyzeOptions): Promise<AnalysisResult>;
+/**
+ * Format source position as "L{line}:{column}" or placeholder
+ */
+export declare function formatSourcePosition(line: number | null, column: number | null): string;
+/**
+ * Format analysis result for output
+ * @param filePath - Path to the file
+ * @param result - Analysis result
+ * @param maxReferences - Maximum references shown per binding
+ * @returns Formatted output string
+ */
+export declare function formatAnalysisResult(filePath: string, result: AnalysisResult, maxReferences?: number): string;
+//# sourceMappingURL=analyzer.d.ts.map

package/dist/analyzer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"analyzer.d.ts","sourceRoot":"","sources":["../src/analyzer.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAsBjD;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IACpB,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;CACvB;AAED;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,+CAA+C;IAC/C,IAAI,EAAE,MAAM,CAAC;IACb,iDAAiD;IACjD,MAAM,EAAE,MAAM,CAAC;IACf,gDAAgD;IAChD,gBAAgB,EAAE,gBAAgB,CAAC;IACnC,mDAAmD;IACnD,WAAW,EAAE,MAAM,CAAC;CACrB;AAED;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,8BAA8B;IAC9B,QAAQ,EAAE,MAAM,CAAC;IACjB,kDAAkD;IAClD,IAAI,EAAE,MAAM,CAAC;IACb,0BAA0B;IAC1B,UAAU,EAAE,YAAY,CAAC;IACzB,8BAA8B;IAC9B,UAAU,EAAE,YAAY,EAAE,CAAC;IAC3B,8CAA8C;IAC9C,eAAe,EAAE,MAAM,CAAC;IACxB,qEAAqE;IACrE,WAAW,CAAC,EAAE,YAAY,CAAC;CAC5B;AAED;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,4CAA4C;IAC5C,QAAQ,EAAE,WAAW,EAAE,CAAC;IACxB,uCAAuC;IACvC,UAAU,EAAE,MAAM,CAAC;IACnB,yDAAyD;IACzD,UAAU,EAAE,OAAO,CAAC;IACpB,mCAAmC;IACnC,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAsBD;;;;;GAKG;AACH,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,oEAOrC;AA6CD;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,4DAA4D;IAC5D,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,sEAAsE;IACtE,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED;;;;;;;;;GASG;AACH,wBAAsB,eAAe,CACnC,IAAI,EAAE,MAAM,EACZ,MAAM,EAAE,SAAS,EACjB,UAAU,EAAE,MAAM,EAClB,OAAO,CAAC,EAAE,cAAc,GACvB,OAAO,CAAC,cAAc,CAAC,CAkIzB;AAGD;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI,GAAG,MAAM,CAKvF;AAmBD;;;;;;GAMG;AACH,wBAAgB,oBAAoB,CAClC,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,cAAc,EACtB,aAAa,GAAE,MAAW,GACzB,MAAM,CAmFR"}

package/dist/beautifier.d.ts

@@ -0,0 +1,120 @@
+import { type SupportedLanguage } from './languageDetector.js';
+export interface SourceMap {
+    version: number;
+    sources: string[];
+    names: string[];
+    mappings: string;
+    file?: string;
+    sourceRoot?: string;
+}
+export interface BeautifyOptions {
+    /** Override auto-detected language */
+    language?: SupportedLanguage;
+    /** Save beautified file locally (default: true for JS/TS) */
+    saveLocal?: boolean;
+}
+export interface BeautifyResult {
+    code: string;
+    /** Source map (null for languages that don't support it) */
+    rawMap: SourceMap | null;
+    /** 本地保存的美化文件路径 */
+    localPath: string;
+    /** 本地保存的 source map 路径 */
+    localMapPath: string;
+    /** 本地保存失败时的错误信息 */
+    localSaveError?: string;
+    /** Whether fallback mode was used */
+    usedFallback: boolean;
+}
+/**
+ * Local paths result interface
+ */
+export interface LocalPaths {
+    /** Path to the beautified file in the same directory as the original */
+    beautifiedPath: string;
+    /** Path to the source map file in the same directory as the original */
+    mapPath: string;
+}
+/**
+ * Get local file paths for beautified output
+ * Given an original file path, returns the paths where the beautified file
+ * and source map should be saved in the same directory.
+ *
+ * Naming convention:
+ * - Original: {filename}.js -> Beautified: {filename}.beautified.js
+ * - Source map: {filename}.beautified.js.map
+ *
+ * @param originalPath - Path to the original JavaScript file
+ * @returns Object containing beautifiedPath and mapPath
+ */
+export declare function getLocalPaths(originalPath: string): LocalPaths;
+/**
+ * Local cache validation result interface
+ */
+export interface LocalCacheCheck {
+    /** Original file modification time in milliseconds */
+    originalMtime: number;
+    /** Whether the beautified file exists */
+    beautifiedExists: boolean;
+    /** Beautified file modification time in milliseconds (0 if not exists) */
+    beautifiedMtime: number;
+    /** Whether the cache is valid (beautifiedMtime >= originalMtime) */
+    isValid: boolean;
+}
+/**
+ * Check if local beautified cache is valid
+ *
+ * A local cache is considered valid when:
+ * 1. The beautified file exists
+ * 2. The beautified file's modification time is >= the original file's modification time
+ *
+ * @param originalPath - Path to the original JavaScript file
+ * @returns LocalCacheCheck object with validation details
+ */
+export declare function isLocalCacheValid(originalPath: string): Promise<LocalCacheCheck>;
+/**
+ * Beautify JSON content with proper indentation
+ * @param content - JSON string to beautify
+ * @returns Object with beautified JSON string and error flag
+ */
+export declare function beautifyJson(content: string): {
+    code: string;
+    parseFailed: boolean;
+};
+/**
+ * Simple HTML/XML beautification with indentation
+ * This is a basic formatter that handles common cases
+ * @param content - HTML/XML string to beautify
+ * @returns Beautified HTML/XML string, or original content if formatting fails
+ */
+export declare function beautifyHtml(content: string): string;
+/**
+ * Simple CSS beautification with indentation
+ * @param content - CSS string to beautify
+ * @returns Beautified CSS string, or original content if formatting fails
+ */
+export declare function beautifyCss(content: string): string;
+/**
+ * Beautify code string directly based on language
+ * @param code - Source code to beautify
+ * @param language - Language type
+ * @returns Beautified code (or original if fallback mode)
+ */
+export declare function beautifyCode(code: string, language: SupportedLanguage): {
+    code: string;
+    usedFallback: boolean;
+};
+/**
+ * Beautify file based on detected or specified language
+ * - JS/TS: Use esbuild for formatting with source map
+ * - JSON: Use JSON.stringify with indentation
+ * - HTML/XML: Use simple indentation-based formatting
+ * - CSS: Use simple formatting
+ * - Unknown: Return original (fallback mode)
+ *
+ * @param originalPath - Original file path
+ * @param options - Optional beautify options (language, saveLocal, etc.)
+ * @returns Beautified code and Source Map (null for non-JS/TS)
+ */
+export declare function ensureBeautified(originalPath: string, options?: BeautifyOptions): Promise<BeautifyResult>;
+//# sourceMappingURL=beautifier.d.ts.map

package/dist/beautifier.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"beautifier.d.ts","sourceRoot":"","sources":["../src/beautifier.ts"],"names":[],"mappings":"AAKA,OAAO,EAAmC,KAAK,iBAAiB,EAAE,MAAM,uBAAuB,CAAC;AAIhG,MAAM,WAAW,SAAS;IACxB,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,eAAe;IAC9B,sCAAsC;IACtC,QAAQ,CAAC,EAAE,iBAAiB,CAAC;IAC7B,6DAA6D;IAC7D,SAAS,CAAC,EAAE,OAAO,CAAC;CACrB;AAED,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,4DAA4D;IAC5D,MAAM,EAAE,SAAS,GAAG,IAAI,CAAC;IACzB,kBAAkB;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,0BAA0B;IAC1B,YAAY,EAAE,MAAM,CAAC;IACrB,mBAAmB;IACnB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,qCAAqC;IACrC,YAAY,EAAE,OAAO,CAAC;CACvB;AA4BD;;GAEG;AACH,MAAM,WAAW,UAAU;IACzB,wEAAwE;IACxE,cAAc,EAAE,MAAM,CAAC;IACvB,wEAAwE;IACxE,OAAO,EAAE,MAAM,CAAC;CACjB;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,aAAa,CAAC,YAAY,EAAE,MAAM,GAAG,UAAU,CAU9D;AAiBD;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,sDAAsD;IACtD,aAAa,EAAE,MAAM,CAAC;IACtB,yCAAyC;IACzC,gBAAgB,EAAE,OAAO,CAAC;IAC1B,0EAA0E;IAC1E,eAAe,EAAE,MAAM,CAAC;IACxB,oEAAoE;IACpE,OAAO,EAAE,OAAO,CAAC;CAClB;AAED;;;;;;;;;GASG;AACH,wBAAsB,iBAAiB,CAAC,YAAY,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,CAAC,CA2CtF;AAED;;;;GAIG;AACH,wBAAgB,YAAY,CAAC,OAAO,EAAE,MAAM,GAAG;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,WAAW,EAAE,OAAO,CAAA;CAAE,CAQpF;AAED;;;;;GAKG;AACH,wBAAgB,YAAY,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAuDpD;AAED;;;;GAIG;AACH,wBAAgB,WAAW,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CA8CnD;AAED;;;;;GAKG;AACH,wBAAgB,YAAY,CAC1B,IAAI,EAAE,MAAM,EACZ,QAAQ,EAAE,iBAAiB,GAC1B;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,YAAY,EAAE,OAAO,CAAA;CAAE,CA4BzC;AAED;;;;;;;;;;;GAWG;AACH,wBAAsB,gBAAgB,CACpC,YAAY,EAAE,MAAM,EACpB,OAAO,CAAC,EAAE,eAAe,GACxB,OAAO,CAAC,cAAc,CAAC,CAyJzB"}