@reverse-craft/smart-fs 1.0.7 → 2.0.1

package/dist/index.d.ts

@@ -0,0 +1,102 @@
+/**
+ * smart-fs - Smart file processing library
+ *
+ * Provides code beautification, truncation, search, analysis, and transformation
+ * with multi-language support and source map generation.
+ *
+ * @module smart-fs
+ */
+export * from './types.js';
+export { type SupportedLanguage, type LanguageInfo, detectLanguage, getLanguageInfo, isFullySupportedLanguage, getSupportedExtensions, isExtensionSupported, } from './languageDetector.js';
+export { type SourceMap, type BeautifyOptions, type BeautifyResult, type LocalPaths, type LocalCacheCheck, ensureBeautified, beautifyCode, beautifyJson, beautifyHtml, beautifyCss, getLocalPaths, isLocalCacheValid, } from './beautifier.js';
+export { type TruncateOptions, type TruncateResult, truncateCode, truncateCodeFromFile, truncateFallback, truncateLongLines, truncateCodeHighPerf, } from './truncator.js';
+export { type OriginalPosition as SearchOriginalPosition, type ContextLine, type SearchMatch, type SearchOptions, type SearchResult, searchInCode, formatSearchResult, formatSourcePosition as formatSearchSourcePosition, createRegex, escapeRegex, unescapeBackslashes, } from './searcher.js';
+export { type OriginalPosition as AnalyzeOriginalPosition, type LocationInfo, type BindingInfo, type AnalysisResult, type AnalyzeOptions, analyzeBindings, formatAnalysisResult, formatSourcePosition as formatAnalyzeSourcePosition, parseCode, } from './analyzer.js';
+export { type TransformOptions, type TransformResult, type OutputPaths, type BabelPluginFunction, applyCustomTransform, loadBabelPlugin, runBabelTransform, getOutputPaths, cleanBasename, } from './transformer.js';
+import type { SmartReadOptions, ProcessingResult } from './types.js';
+import type { SearchOptions, SearchResult } from './searcher.js';
+import type { AnalyzeOptions, AnalysisResult } from './analyzer.js';
+/**
+ * Smart read file with beautification and truncation
+ *
+ * This is a convenience function that combines beautification and truncation
+ * into a single operation. It handles:
+ * - Language detection (or uses specified language)
+ * - Code beautification (for supported languages)
+ * - String/line truncation
+ * - Optional line range extraction
+ *
+ * @param filePath - Path to the file to read
+ * @param options - Processing options
+ * @returns ProcessingResult with processed code and metadata
+ *
+ * @example
+ * ```typescript
+ * // Read and process entire file
+ * const result = await smartRead('./src/app.js');
+ *
+ * // Read specific lines with custom options
+ * const result = await smartRead('./src/app.js', {
+ *   startLine: 10,
+ *   endLine: 50,
+ *   charLimit: 200,
+ *   maxLineChars: 400
+ * });
+ * ```
+ */
+export declare function smartRead(filePath: string, options?: SmartReadOptions): Promise<ProcessingResult>;
+/**
+ * Smart search in file with beautification and source map support
+ *
+ * This function beautifies the file first, then searches in the beautified code.
+ * Results include original file positions via source map for setting breakpoints.
+ *
+ * @param filePath - Path to the file to search
+ * @param query - Search query (text or regex pattern)
+ * @param options - Search options
+ * @returns SearchResult with matches and original positions
+ *
+ * @example
+ * ```typescript
+ * // Simple text search
+ * const result = await smartSearch('./src/app.js', 'function');
+ *
+ * // Regex search with options
+ * const result = await smartSearch('./src/app.js', 'function\\s+\\w+', {
+ *   isRegex: true,
+ *   caseSensitive: true,
+ *   contextLines: 3
+ * });
+ * ```
+ */
+export declare function smartSearch(filePath: string, query: string, options?: SearchOptions): Promise<SearchResult & {
+    formatted: string;
+    error?: string;
+}>;
+/**
+ * Find variable/function usage in file
+ *
+ * This function analyzes the code to find all bindings (definitions and references)
+ * for a specific identifier. Results include original file positions via source map.
+ *
+ * @param filePath - Path to the file to analyze
+ * @param identifier - Variable or function name to find
+ * @param options - Analysis options
+ * @returns AnalysisResult with bindings and original positions
+ *
+ * @example
+ * ```typescript
+ * // Find all usages of 'myFunction'
+ * const result = await findUsage('./src/app.js', 'myFunction');
+ *
+ * // Find usage at specific line
+ * const result = await findUsage('./src/app.js', 'data', {
+ *   targetLine: 42
+ * });
+ * ```
+ */
+export declare function findUsage(filePath: string, identifier: string, options?: AnalyzeOptions): Promise<AnalysisResult & {
+    formatted: string;
+    error?: string;
+}>;
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAMH,cAAc,YAAY,CAAC;AAG3B,OAAO,EACL,KAAK,iBAAiB,EACtB,KAAK,YAAY,EACjB,cAAc,EACd,eAAe,EACf,wBAAwB,EACxB,sBAAsB,EACtB,oBAAoB,GACrB,MAAM,uBAAuB,CAAC;AAG/B,OAAO,EACL,KAAK,SAAS,EACd,KAAK,eAAe,EACpB,KAAK,cAAc,EACnB,KAAK,UAAU,EACf,KAAK,eAAe,EACpB,gBAAgB,EAChB,YAAY,EACZ,YAAY,EACZ,YAAY,EACZ,WAAW,EACX,aAAa,EACb,iBAAiB,GAClB,MAAM,iBAAiB,CAAC;AAGzB,OAAO,EACL,KAAK,eAAe,EACpB,KAAK,cAAc,EACnB,YAAY,EACZ,oBAAoB,EACpB,gBAAgB,EAChB,iBAAiB,EACjB,oBAAoB,GACrB,MAAM,gBAAgB,CAAC;AAGxB,OAAO,EACL,KAAK,gBAAgB,IAAI,sBAAsB,EAC/C,KAAK,WAAW,EAChB,KAAK,WAAW,EAChB,KAAK,aAAa,EAClB,KAAK,YAAY,EACjB,YAAY,EACZ,kBAAkB,EAClB,oBAAoB,IAAI,0BAA0B,EAClD,WAAW,EACX,WAAW,EACX,mBAAmB,GACpB,MAAM,eAAe,CAAC;AAGvB,OAAO,EACL,KAAK,gBAAgB,IAAI,uBAAuB,EAChD,KAAK,YAAY,EACjB,KAAK,WAAW,EAChB,KAAK,cAAc,EACnB,KAAK,cAAc,EACnB,eAAe,EACf,oBAAoB,EACpB,oBAAoB,IAAI,2BAA2B,EACnD,SAAS,GACV,MAAM,eAAe,CAAC;AAGvB,OAAO,EACL,KAAK,gBAAgB,EACrB,KAAK,eAAe,EACpB,KAAK,WAAW,EAChB,KAAK,mBAAmB,EACxB,oBAAoB,EACpB,eAAe,EACf,iBAAiB,EACjB,cAAc,EACd,aAAa,GACd,MAAM,kBAAkB,CAAC;AAG1B,OAAO,KAAK,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AACrE,OAAO,KAAK,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AACjE,OAAO,KAAK,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAQpE;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH,wBAAsB,SAAS,CAC7B,QAAQ,EAAE,MAAM,EAChB,OAAO,CAAC,EAAE,gBAAgB,GACzB,OAAO,CAAC,gBAAgB,CAAC,CA+D3B;AAED;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,wBAAsB,WAAW,CAC/B,QAAQ,EAAE,MAAM,EAChB,KAAK,EAAE,MAAM,EACb,OAAO,CAAC,EAAE,aAAa,GACtB,OAAO,CAAC,YAAY,GAAG;IAAE,SAAS,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC,CA8D/D;AAED;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,wBAAsB,SAAS,CAC7B,QAAQ,EAAE,MAAM,EAChB,UAAU,EAAE,MAAM,EAClB,OAAO,CAAC,EAAE,cAAc,GACvB,OAAO,CAAC,cAAc,GAAG;IAAE,SAAS,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC,CA+DjE"}