@paparats/shared 0.2.22 → 0.2.24

package/dist/index.d.ts

@@ -2,4 +2,5 @@ export { validateIndexingPaths } from './path-validation.js';
 export { normalizeExcludePatterns } from './exclude-patterns.js';
 export { LANGUAGE_EXCLUDE_DEFAULTS, COMMON_EXCLUDE, DEFAULT_EXCLUDE_BARE, getDefaultExcludeForLanguages, } from './language-excludes.js';
 export { createGitignoreFilter, filterFilesByGitignore } from './gitignore.js';
+export { detectLanguageByPath } from './language-detect.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,qBAAqB,EAAE,MAAM,sBAAsB,CAAC;AAC7D,OAAO,EAAE,wBAAwB,EAAE,MAAM,uBAAuB,CAAC;AACjE,OAAO,EACL,yBAAyB,EACzB,cAAc,EACd,oBAAoB,EACpB,6BAA6B,GAC9B,MAAM,wBAAwB,CAAC;AAChC,OAAO,EAAE,qBAAqB,EAAE,sBAAsB,EAAE,MAAM,gBAAgB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,qBAAqB,EAAE,MAAM,sBAAsB,CAAC;AAC7D,OAAO,EAAE,wBAAwB,EAAE,MAAM,uBAAuB,CAAC;AACjE,OAAO,EACL,yBAAyB,EACzB,cAAc,EACd,oBAAoB,EACpB,6BAA6B,GAC9B,MAAM,wBAAwB,CAAC;AAChC,OAAO,EAAE,qBAAqB,EAAE,sBAAsB,EAAE,MAAM,gBAAgB,CAAC;AAC/E,OAAO,EAAE,oBAAoB,EAAE,MAAM,sBAAsB,CAAC"}

package/dist/index.js

@@ -2,4 +2,5 @@ export { validateIndexingPaths } from './path-validation.js';
 export { normalizeExcludePatterns } from './exclude-patterns.js';
 export { LANGUAGE_EXCLUDE_DEFAULTS, COMMON_EXCLUDE, DEFAULT_EXCLUDE_BARE, getDefaultExcludeForLanguages, } from './language-excludes.js';
 export { createGitignoreFilter, filterFilesByGitignore } from './gitignore.js';
+export { detectLanguageByPath } from './language-detect.js';
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,qBAAqB,EAAE,MAAM,sBAAsB,CAAC;AAC7D,OAAO,EAAE,wBAAwB,EAAE,MAAM,uBAAuB,CAAC;AACjE,OAAO,EACL,yBAAyB,EACzB,cAAc,EACd,oBAAoB,EACpB,6BAA6B,GAC9B,MAAM,wBAAwB,CAAC;AAChC,OAAO,EAAE,qBAAqB,EAAE,sBAAsB,EAAE,MAAM,gBAAgB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,qBAAqB,EAAE,MAAM,sBAAsB,CAAC;AAC7D,OAAO,EAAE,wBAAwB,EAAE,MAAM,uBAAuB,CAAC;AACjE,OAAO,EACL,yBAAyB,EACzB,cAAc,EACd,oBAAoB,EACpB,6BAA6B,GAC9B,MAAM,wBAAwB,CAAC;AAChC,OAAO,EAAE,qBAAqB,EAAE,sBAAsB,EAAE,MAAM,gBAAgB,CAAC;AAC/E,OAAO,EAAE,oBAAoB,EAAE,MAAM,sBAAsB,CAAC"}

package/dist/language-detect.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Detect language from a file path, optionally using its content for shebang
+ * detection when the extension is unknown.
+ */
+export declare function detectLanguageByPath(relPath: string, content?: string): string | null;
+//# sourceMappingURL=language-detect.d.ts.map

package/dist/language-detect.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"language-detect.d.ts","sourceRoot":"","sources":["../src/language-detect.ts"],"names":[],"mappings":"AA8CA;;;GAGG;AACH,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAerF"}

package/dist/language-detect.js

@@ -0,0 +1,62 @@
+import path from 'node:path';
+/**
+ * Per-file language detection.
+ *
+ * Returns a language key matching the server's LANGUAGE_PROFILES keys
+ * ('ruby', 'typescript', 'python', 'go', 'rust', 'java', 'c', 'cpp', 'csharp',
+ * 'javascript') or null if the file cannot be confidently classified.
+ *
+ * Strategy: extension table first, shebang fallback for files without a known
+ * extension. Ambiguous extensions are resolved conservatively:
+ *   - `.h` → 'c' (C++ project should carry an explicit project-level fallback)
+ *   - `.js` → 'typescript' (our TS profile already covers .js; keeps tree-sitter
+ *     grammar selection sane in mixed TS/JS repos)
+ */
+const EXT_TO_LANGUAGE = {
+    '.rb': 'ruby',
+    '.rake': 'ruby',
+    '.rbs': 'ruby',
+    '.ts': 'typescript',
+    '.tsx': 'typescript',
+    '.js': 'typescript',
+    '.jsx': 'typescript',
+    '.mjs': 'typescript',
+    '.cjs': 'typescript',
+    '.py': 'python',
+    '.go': 'go',
+    '.rs': 'rust',
+    '.java': 'java',
+    '.c': 'c',
+    '.h': 'c',
+    '.cpp': 'cpp',
+    '.hpp': 'cpp',
+    '.cc': 'cpp',
+    '.hh': 'cpp',
+    '.cxx': 'cpp',
+    '.cs': 'csharp',
+};
+const SHEBANG_TO_LANGUAGE = [
+    { pattern: /^#!.*\b(ruby)\b/, language: 'ruby' },
+    { pattern: /^#!.*\b(python[0-9.]*)\b/, language: 'python' },
+    { pattern: /^#!.*\b(node|deno|bun)\b/, language: 'typescript' },
+];
+/**
+ * Detect language from a file path, optionally using its content for shebang
+ * detection when the extension is unknown.
+ */
+export function detectLanguageByPath(relPath, content) {
+    const ext = path.extname(relPath).toLowerCase();
+    if (ext && EXT_TO_LANGUAGE[ext]) {
+        return EXT_TO_LANGUAGE[ext];
+    }
+    if (content) {
+        const nl = content.indexOf('\n');
+        const firstLine = nl === -1 ? content.slice(0, 200) : content.slice(0, nl);
+        for (const { pattern, language } of SHEBANG_TO_LANGUAGE) {
+            if (pattern.test(firstLine))
+                return language;
+        }
+    }
+    return null;
+}
+//# sourceMappingURL=language-detect.js.map

package/dist/language-detect.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"language-detect.js","sourceRoot":"","sources":["../src/language-detect.ts"],"names":[],"mappings":"AAAA,OAAO,IAAI,MAAM,WAAW,CAAC;AAE7B;;;;;;;;;;;;GAYG;AAEH,MAAM,eAAe,GAA2B;IAC9C,KAAK,EAAE,MAAM;IACb,OAAO,EAAE,MAAM;IACf,MAAM,EAAE,MAAM;IACd,KAAK,EAAE,YAAY;IACnB,MAAM,EAAE,YAAY;IACpB,KAAK,EAAE,YAAY;IACnB,MAAM,EAAE,YAAY;IACpB,MAAM,EAAE,YAAY;IACpB,MAAM,EAAE,YAAY;IACpB,KAAK,EAAE,QAAQ;IACf,KAAK,EAAE,IAAI;IACX,KAAK,EAAE,MAAM;IACb,OAAO,EAAE,MAAM;IACf,IAAI,EAAE,GAAG;IACT,IAAI,EAAE,GAAG;IACT,MAAM,EAAE,KAAK;IACb,MAAM,EAAE,KAAK;IACb,KAAK,EAAE,KAAK;IACZ,KAAK,EAAE,KAAK;IACZ,MAAM,EAAE,KAAK;IACb,KAAK,EAAE,QAAQ;CAChB,CAAC;AAEF,MAAM,mBAAmB,GAAiD;IACxE,EAAE,OAAO,EAAE,iBAAiB,EAAE,QAAQ,EAAE,MAAM,EAAE;IAChD,EAAE,OAAO,EAAE,0BAA0B,EAAE,QAAQ,EAAE,QAAQ,EAAE;IAC3D,EAAE,OAAO,EAAE,0BAA0B,EAAE,QAAQ,EAAE,YAAY,EAAE;CAChE,CAAC;AAEF;;;GAGG;AACH,MAAM,UAAU,oBAAoB,CAAC,OAAe,EAAE,OAAgB;IACpE,MAAM,GAAG,GAAG,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,WAAW,EAAE,CAAC;IAChD,IAAI,GAAG,IAAI,eAAe,CAAC,GAAG,CAAC,EAAE,CAAC;QAChC,OAAO,eAAe,CAAC,GAAG,CAAC,CAAC;IAC9B,CAAC;IAED,IAAI,OAAO,EAAE,CAAC;QACZ,MAAM,EAAE,GAAG,OAAO,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;QACjC,MAAM,SAAS,GAAG,EAAE,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;QAC3E,KAAK,MAAM,EAAE,OAAO,EAAE,QAAQ,EAAE,IAAI,mBAAmB,EAAE,CAAC;YACxD,IAAI,OAAO,CAAC,IAAI,CAAC,SAAS,CAAC;gBAAE,OAAO,QAAQ,CAAC;QAC/C,CAAC;IACH,CAAC;IAED,OAAO,IAAI,CAAC;AACd,CAAC"}

package/dist/language-detect.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=language-detect.test.d.ts.map

package/dist/language-detect.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"language-detect.test.d.ts","sourceRoot":"","sources":["../src/language-detect.test.ts"],"names":[],"mappings":""}

package/dist/language-detect.test.js

@@ -0,0 +1,49 @@
+import { describe, it, expect } from 'vitest';
+import { detectLanguageByPath } from './language-detect.js';
+describe('detectLanguageByPath', () => {
+    it('detects common extensions', () => {
+        expect(detectLanguageByPath('app/models/user.rb')).toBe('ruby');
+        expect(detectLanguageByPath('Rakefile.rake')).toBe('ruby');
+        expect(detectLanguageByPath('sig/user.rbs')).toBe('ruby');
+        expect(detectLanguageByPath('src/index.ts')).toBe('typescript');
+        expect(detectLanguageByPath('src/App.tsx')).toBe('typescript');
+        expect(detectLanguageByPath('script.js')).toBe('typescript');
+        expect(detectLanguageByPath('module.mjs')).toBe('typescript');
+        expect(detectLanguageByPath('main.py')).toBe('python');
+        expect(detectLanguageByPath('main.go')).toBe('go');
+        expect(detectLanguageByPath('lib.rs')).toBe('rust');
+        expect(detectLanguageByPath('App.java')).toBe('java');
+        expect(detectLanguageByPath('Program.cs')).toBe('csharp');
+    });
+    it('maps C/C++ extensions conservatively', () => {
+        expect(detectLanguageByPath('foo.c')).toBe('c');
+        expect(detectLanguageByPath('foo.h')).toBe('c');
+        expect(detectLanguageByPath('foo.cpp')).toBe('cpp');
+        expect(detectLanguageByPath('foo.hpp')).toBe('cpp');
+        expect(detectLanguageByPath('foo.cc')).toBe('cpp');
+    });
+    it('is case-insensitive on extension', () => {
+        expect(detectLanguageByPath('Foo.RB')).toBe('ruby');
+        expect(detectLanguageByPath('Main.JAVA')).toBe('java');
+    });
+    it('returns null for unknown extensions without content', () => {
+        expect(detectLanguageByPath('README.md')).toBeNull();
+        expect(detectLanguageByPath('config.yaml')).toBeNull();
+        expect(detectLanguageByPath('Dockerfile')).toBeNull();
+    });
+    it('detects language from shebang when extension is unknown', () => {
+        expect(detectLanguageByPath('bin/console', '#!/usr/bin/env ruby\nputs :hi\n')).toBe('ruby');
+        expect(detectLanguageByPath('bin/tool', '#!/usr/bin/python3\nprint(1)\n')).toBe('python');
+        expect(detectLanguageByPath('bin/run', '#!/usr/bin/env node\nconsole.log(1)\n')).toBe('typescript');
+    });
+    it('prefers extension over shebang when both are present', () => {
+        expect(detectLanguageByPath('app.rb', '#!/usr/bin/env python3\nputs :hi\n')).toBe('ruby');
+    });
+    it('returns null when content has no shebang and no extension', () => {
+        expect(detectLanguageByPath('LICENSE', 'MIT License\nCopyright ...\n')).toBeNull();
+    });
+    it('handles single-line content without newline', () => {
+        expect(detectLanguageByPath('bin/run', '#!/usr/bin/env ruby')).toBe('ruby');
+    });
+});
+//# sourceMappingURL=language-detect.test.js.map

package/dist/language-detect.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"language-detect.test.js","sourceRoot":"","sources":["../src/language-detect.test.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@paparats/shared",
-  "version": "0.2.22",
+  "version": "0.2.24",
   "type": "module",
   "description": "Shared utilities for Paparats MCP - path validation, gitignore filtering, language-aware exclude patterns",
   "license": "MIT",
@@ -56,8 +56,8 @@
     "ignore": "^7.0.5"
   },
   "devDependencies": {
-    "@types/node": "^25.5.2",
+    "@types/node": "^25.6.0",
     "typescript": "^5.9.3",
-    "vitest": "^4.1.2"
+    "vitest": "^4.1.4"
   }
 }