codesummary 1.1.0 → 1.2.0

package/src/utils.js

@@ -0,0 +1,139 @@
+/**
+ * Shared utilities for CodeSummary
+ * Single source of truth for common helpers used across modules
+ */
+
+import fs from 'fs';
+import path from 'path';
+
+/**
+ * Format a byte count as a human-readable string
+ * @param {number} bytes
+ * @returns {string} e.g. "1.4 MB"
+ */
+export function formatFileSize(bytes) {
+  const units = ['B', 'KB', 'MB', 'GB'];
+  let size = bytes;
+  let unitIndex = 0;
+
+  while (size >= 1024 && unitIndex < units.length - 1) {
+    size /= 1024;
+    unitIndex++;
+  }
+
+  return `${size.toFixed(1)} ${units[unitIndex]}`;
+}
+
+/**
+ * Return a human-readable language name for a file extension
+ * @param {string} extension - e.g. ".js"
+ * @returns {string}
+ */
+export function getExtensionDescription(extension) {
+  const descriptions = {
+    '.js': 'JavaScript',
+    '.ts': 'TypeScript',
+    '.jsx': 'React JSX',
+    '.tsx': 'TypeScript JSX',
+    '.json': 'JSON',
+    '.xml': 'XML',
+    '.html': 'HTML',
+    '.css': 'CSS',
+    '.scss': 'SCSS',
+    '.sass': 'Sass',
+    '.md': 'Markdown',
+    '.txt': 'Text',
+    '.py': 'Python',
+    '.java': 'Java',
+    '.cs': 'C#',
+    '.cpp': 'C++',
+    '.c': 'C',
+    '.h': 'Header',
+    '.yaml': 'YAML',
+    '.yml': 'YAML',
+    '.sh': 'Shell Script',
+    '.bat': 'Batch File',
+    '.ps1': 'PowerShell',
+    '.php': 'PHP',
+    '.rb': 'Ruby',
+    '.go': 'Go',
+    '.rs': 'Rust',
+    '.swift': 'Swift',
+    '.kt': 'Kotlin',
+    '.scala': 'Scala',
+    '.vue': 'Vue.js',
+    '.svelte': 'Svelte',
+    '.dockerfile': 'Dockerfile',
+    '.sql': 'SQL',
+    '.graphql': 'GraphQL',
+    '.cfg': 'Config File',
+    '.conf': 'Config File',
+    '.env': 'Environment',
+    '.local': 'Local Override',
+    '.service': 'Systemd Service',
+    '.timer': 'Systemd Timer',
+    '.ino': 'Arduino',
+    '.j2': 'Jinja2 Template',
+    '.csv': 'CSV',
+    '.tsv': 'TSV',
+    '.crt': 'Certificate',
+    '.toml': 'TOML',
+    '.ini': 'INI Config',
+    '.properties': 'Java Properties',
+    '.tf': 'Terraform',
+    '.tfvars': 'Terraform Vars',
+    '.proto': 'Protocol Buffers',
+    '.prisma': 'Prisma Schema',
+    '.dart': 'Dart',
+    '.lua': 'Lua',
+    '.r': 'R',
+    '.ex': 'Elixir',
+    '.exs': 'Elixir Script',
+    '.pl': 'Perl',
+    '.mk': 'Makefile',
+    '.cmake': 'CMake',
+    '.mdx': 'MDX',
+    '.astro': 'Astro',
+    '.graphql': 'GraphQL',
+    '.gql': 'GraphQL',
+  };
+
+  return descriptions[extension] || 'Unknown';
+}
+
+/**
+ * Test a filename against a glob pattern (supports * wildcards)
+ * @param {string} fileName
+ * @param {string} pattern - e.g. "*.min.js"
+ * @returns {boolean}
+ */
+export function matchesGlobPattern(fileName, pattern) {
+  if (pattern === fileName) return true;
+
+  const regexPattern = pattern
+    .replace(/\./g, '\\.')
+    .replace(/\*/g, '.*');
+
+  return new RegExp(`^${regexPattern}$`, 'i').test(fileName);
+}
+
+/**
+ * Resolve a versioned output path: if basePath exists, returns basePath-v1,
+ * basePath-v2, etc. Strips any existing -vN suffix before versioning.
+ * @param {string} basePath - e.g. "/out/myproject_llm.md"
+ * @returns {string} A path that does not yet exist on disk
+ */
+export function resolveVersionedPath(basePath) {
+  if (!fs.existsSync(basePath)) return basePath;
+
+  const dir = path.dirname(basePath);
+  const ext = path.extname(basePath);
+  const base = path.basename(basePath, ext).replace(/-v\d+$/, '');
+
+  let version = 1;
+  while (true) {
+    const candidate = path.join(dir, `${base}-v${version}${ext}`);
+    if (!fs.existsSync(candidate)) return candidate;
+    version++;
+  }
+}