kopytko-linter 0.1.0

package/README.md

@@ -0,0 +1,190 @@
+# kopytko-linter
+
+BrightScript linter for the [Kopytko ecosystem](https://github.com/bchelkowski/vscode-kopytko). Use as a CLI tool in CI pipelines or import as a library.
+
+## Features
+
+- **19 diagnostic rules** covering imports, identifiers, syntax, and test structure
+- **Configurable severity** per rule (`error`, `warning`, `info`, `hint`, `off`)
+- **Three output formats**: text (terminal), JSON, [SARIF](https://sarifweb.azurewebsites.net/) (GitHub Code Scanning)
+- **Config file support**: `kopytko-linter.json` or `.vscode/settings.json`
+- **Library API** for integration with editors and build tools
+
+## Installation
+
+```bash
+npm install --save-dev kopytko-linter
+```
+
+## CLI Usage
+
+```bash
+# Lint the current project
+npx kopytko-lint
+
+# CI mode — exit with code 1 if any errors are found
+npx kopytko-lint --check
+
+# Output as JSON
+npx kopytko-lint --format json
+
+# Output SARIF for GitHub Code Scanning
+npx kopytko-lint --format sarif > results.sarif
+
+# Use a specific config file
+npx kopytko-lint --config my-rules.json
+
+# Override source directory
+npx kopytko-lint --source-dir components
+```
+
+### CLI Options
+
+| Option | Description |
+|---|---|
+| `--check` | Exit with code 1 if any errors are found (for CI) |
+| `--format`, `-f` | Output format: `text` (default), `json`, `sarif` |
+| `--config`, `-c` | Path to config file |
+| `--source-dir` | Override source directory (default: from config or `src`) |
+| `--no-color` | Disable colored terminal output |
+| `--help`, `-h` | Show help |
+| `--version`, `-v` | Show version |
+
+## Configuration
+
+### Config File Resolution
+
+Configuration is resolved in this order:
+
+1. `--config <file>` CLI flag
+2. `kopytko-linter.json` in project root
+3. `.vscode/settings.json` (`kopytko.lint.*` keys)
+4. Default config (all rules enabled at default severity)
+
+### Example `kopytko-linter.json`
+
+```json
+{
+  "rules": {
+    "import/unused": "off",
+    "identifier/shadows-builtin": "warning",
+    "syntax/trailing-comma": "error"
+  },
+  "sourceDir": "src",
+  "resolveModules": true,
+  "generatedPaths": ["/source/generated/**"],
+  "generatedModules": [],
+  "siblingPatterns": []
+}
+```
+
+### VS Code Settings
+
+Add `kopytko.lint.*` keys to `.vscode/settings.json`:
+
+```json
+{
+  "kopytko.lint.sourceDir": "src",
+  "kopytko.lint.rules.import/unused": "off",
+  "kopytko.lint.rules.identifier/shadows-builtin": "warning"
+}
+```
+
+## Rules
+
+### Import Rules
+
+| Rule | Default | Description |
+|---|---|---|
+| `import/duplicate` | error | Same import path imported twice |
+| `import/missing-path` | error | `@import` / `@mock` with empty path |
+| `import/path-not-absolute` | warning | Import path doesn't start with `/` |
+| `import/wrong-comment-style` | error | `@import` written with `"` instead of `'` comment |
+| `import/build-generated` | info | Unresolved path matches a configured generated-path pattern |
+| `import/unresolved` | warning | Cannot resolve import to a file on disk |
+| `import/unused` | warning | Imported file's functions are never referenced |
+
+### Identifier Rules
+
+| Rule | Default | Description |
+|---|---|---|
+| `identifier/undefined-function` | error | Function call to unknown name |
+| `identifier/wrong-arg-count` | error | Built-in function called with wrong number of arguments |
+| `identifier/undefined-variable` | error | Variable used but never assigned in the enclosing scope |
+| `identifier/shadows-builtin` | error | Variable name shadows a BrightScript built-in function |
+| `identifier/unused-parameter` | hint | Function parameter never used in body (prefix `_` to suppress) |
+
+### Syntax Rules
+
+| Rule | Default | Description |
+|---|---|---|
+| `throw/invalid-value` | warning | `throw` with numeric, array, or `invalid` value |
+| `throw/missing-message` | warning | Thrown associative array missing `message` field |
+| `createobject/unknown-component` | warning | `CreateObject("...")` with unrecognized component name |
+| `syntax/trailing-comma` | error | Trailing comma after `return` value |
+| `syntax/flow-outside-loop` | error | `continue for`/`exit while` outside matching loop |
+
+### Test Rules
+
+| Rule | Default | Description |
+|---|---|---|
+| `test/missing-mock-annotation` | warning | `mockFunction("X")` targets a function not in any `@mock`'ed file |
+| `test/missing-return-ts` | warning | `TestSuite__*` function missing `return ts` |
+
+## Library API
+
+```typescript
+import { lintProject, lintFile, DEFAULT_LINTER_CONFIG } from 'kopytko-linter';
+import type { LintContext, LintResult, LintDiagnostic } from 'kopytko-linter';
+
+// Lint a whole project (standalone mode)
+const result: LintResult = lintProject('/path/to/project');
+console.log(`${result.errorCount} errors, ${result.warningCount} warnings`);
+
+// Lint a single file (library mode — provide your own context)
+const context: LintContext = {
+  knownFuncNames: new Set(['init', 'myhelper']),
+  parseImports: (text) => parseImports(text),
+  resolveImportPath: (path) => /* resolve path */,
+  importExists: (path) => /* check existence */,
+  readFile: (path) => /* read file */,
+  parseFunctionsFromFile: (path) => /* parse functions */,
+  getSiblingFiles: (path) => /* find siblings */,
+  isTestFile: (path) => path.endsWith('.test.brs'),
+  generatedPaths: [],
+  generatedModules: [],
+  siblingPatterns: [],
+};
+
+const diagnostics: LintDiagnostic[] = lintFile(
+  '/path/to/file.brs',
+  fileContent,
+  context,
+  DEFAULT_LINTER_CONFIG,
+);
+```
+
+## CI Integration
+
+### GitHub Actions
+
+```yaml
+- name: Lint BrightScript
+  run: npx kopytko-lint --check
+```
+
+### GitHub Code Scanning (SARIF)
+
+```yaml
+- name: Lint BrightScript
+  run: npx kopytko-lint --format sarif > results.sarif
+
+- name: Upload SARIF
+  uses: github/codeql-action/upload-sarif@v3
+  with:
+    sarif_file: results.sarif
+```
+
+## License
+
+MIT

package/dist/bin/kopytko-lint.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=kopytko-lint.d.ts.map

package/dist/bin/kopytko-lint.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"kopytko-lint.d.ts","sourceRoot":"","sources":["../../bin/kopytko-lint.ts"],"names":[],"mappings":""}

package/dist/bin/kopytko-lint.js

@@ -0,0 +1,118 @@
+#!/usr/bin/env node
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const linter_1 = require("../src/linter");
+const config_1 = require("../src/config");
+const textFormatter_1 = require("../src/output/textFormatter");
+const jsonFormatter_1 = require("../src/output/jsonFormatter");
+const sarifFormatter_1 = require("../src/output/sarifFormatter");
+function parseArgs(argv) {
+    const options = {
+        format: 'text',
+        check: false,
+        noColor: false,
+    };
+    for (let i = 2; i < argv.length; i++) {
+        const arg = argv[i];
+        if (arg === '--format' || arg === '-f') {
+            const value = argv[++i];
+            if (value === 'text' || value === 'json' || value === 'sarif') {
+                options.format = value;
+            }
+            else {
+                console.error(`Unknown format: ${value}. Use text, json, or sarif.`);
+                process.exit(2);
+            }
+        }
+        else if (arg === '--config' || arg === '-c') {
+            options.configPath = argv[++i];
+        }
+        else if (arg === '--source-dir') {
+            options.sourceDir = argv[++i];
+        }
+        else if (arg === '--check') {
+            options.check = true;
+        }
+        else if (arg === '--no-color') {
+            options.noColor = true;
+        }
+        else if (arg === '--help' || arg === '-h') {
+            printHelp();
+            process.exit(0);
+        }
+        else if (arg === '--version' || arg === '-v') {
+            printVersion();
+            process.exit(0);
+        }
+        else if (arg.startsWith('-')) {
+            console.error(`Unknown option: ${arg}. Use --help for usage.`);
+            process.exit(2);
+        }
+    }
+    return options;
+}
+function printHelp() {
+    console.log(`
+kopytko-lint — BrightScript linter for the Kopytko ecosystem
+
+Usage:
+  kopytko-lint [options]
+
+Options:
+  --check             Exit with code 1 if any errors are found (for CI)
+  --format, -f        Output format: text (default), json, sarif
+  --config, -c        Path to config file (default: kopytko-linter.json)
+  --source-dir        Source directory (default: from config or "src")
+  --no-color          Disable colored output
+  --help, -h          Show this help message
+  --version, -v       Show version
+
+Config resolution (priority order):
+  1. --config <file>
+  2. kopytko-linter.json in project root
+  3. .vscode/settings.json (kopytko.lint.* keys)
+  4. Default config (all rules enabled)
+
+Examples:
+  kopytko-lint                       # lint current project with default config
+  kopytko-lint --check               # CI mode — exit 1 on errors
+  kopytko-lint --format sarif        # output SARIF for GitHub Code Scanning
+  kopytko-lint --config my-rules.json
+`);
+}
+function printVersion() {
+    try {
+        const pkg = require('../../package.json');
+        console.log(`kopytko-lint v${pkg.version}`);
+    }
+    catch {
+        console.log('kopytko-lint (development)');
+    }
+}
+function main() {
+    const options = parseArgs(process.argv);
+    const projectRoot = process.cwd();
+    const config = (0, config_1.resolveConfig)(projectRoot, options.configPath);
+    if (options.sourceDir) {
+        config.sourceDir = options.sourceDir;
+    }
+    const result = (0, linter_1.lintProject)(projectRoot, config);
+    // Output
+    switch (options.format) {
+        case 'json':
+            console.log((0, jsonFormatter_1.formatJson)(result));
+            break;
+        case 'sarif':
+            console.log((0, sarifFormatter_1.formatSarif)(result, projectRoot));
+            break;
+        default:
+            console.log((0, textFormatter_1.formatText)(result, !options.noColor));
+            break;
+    }
+    // Exit code
+    if (options.check && result.errorCount > 0) {
+        process.exit(1);
+    }
+}
+main();
+//# sourceMappingURL=kopytko-lint.js.map

package/dist/bin/kopytko-lint.js.map

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

package/dist/src/analysis/fsWrapper.d.ts

@@ -0,0 +1,19 @@
+interface DirEntry {
+    name: string;
+    isDirectory: boolean;
+}
+/**
+ * Thin fs wrapper. All filesystem access goes through this module so that
+ * tests can stub individual functions via `sinon.stub(fsWrapper, 'existsSync')`.
+ *
+ * Exported as a mutable object (not direct function exports) to ensure
+ * property descriptors remain configurable under all module systems.
+ */
+declare const fsWrapper: {
+    existsSync(filePath: string): boolean;
+    readFileSync(filePath: string, encoding: BufferEncoding): string;
+    readdirSync(dirPath: string): string[];
+    readdirTyped(dirPath: string): DirEntry[];
+};
+export default fsWrapper;
+//# sourceMappingURL=fsWrapper.d.ts.map

package/dist/src/analysis/fsWrapper.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fsWrapper.d.ts","sourceRoot":"","sources":["../../../src/analysis/fsWrapper.ts"],"names":[],"mappings":"AAEA,UAAU,QAAQ;IAChB,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,OAAO,CAAC;CACtB;AAED;;;;;;GAMG;AACH,QAAA,MAAM,SAAS;yBACQ,MAAM,GAAG,OAAO;2BAId,MAAM,YAAY,cAAc,GAAG,MAAM;yBAI3C,MAAM,GAAG,MAAM,EAAE;0BAIhB,MAAM,GAAG,QAAQ,EAAE;CAM1C,CAAC;AAEF,eAAe,SAAS,CAAC"}

package/dist/src/analysis/fsWrapper.js

@@ -0,0 +1,62 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+const fs = __importStar(require("fs"));
+/**
+ * Thin fs wrapper. All filesystem access goes through this module so that
+ * tests can stub individual functions via `sinon.stub(fsWrapper, 'existsSync')`.
+ *
+ * Exported as a mutable object (not direct function exports) to ensure
+ * property descriptors remain configurable under all module systems.
+ */
+const fsWrapper = {
+    existsSync(filePath) {
+        return fs.existsSync(filePath);
+    },
+    readFileSync(filePath, encoding) {
+        return fs.readFileSync(filePath, encoding);
+    },
+    readdirSync(dirPath) {
+        return fs.readdirSync(dirPath);
+    },
+    readdirTyped(dirPath) {
+        return fs.readdirSync(dirPath, { withFileTypes: true }).map((entry) => ({
+            name: entry.name,
+            isDirectory: entry.isDirectory(),
+        }));
+    },
+};
+exports.default = fsWrapper;
+//# sourceMappingURL=fsWrapper.js.map

package/dist/src/analysis/fsWrapper.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fsWrapper.js","sourceRoot":"","sources":["../../../src/analysis/fsWrapper.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA,uCAAyB;AAOzB;;;;;;GAMG;AACH,MAAM,SAAS,GAAG;IAChB,UAAU,CAAC,QAAgB;QACzB,OAAO,EAAE,CAAC,UAAU,CAAC,QAAQ,CAAC,CAAC;IACjC,CAAC;IAED,YAAY,CAAC,QAAgB,EAAE,QAAwB;QACrD,OAAO,EAAE,CAAC,YAAY,CAAC,QAAQ,EAAE,QAAQ,CAAW,CAAC;IACvD,CAAC;IAED,WAAW,CAAC,OAAe;QACzB,OAAO,EAAE,CAAC,WAAW,CAAC,OAAO,CAAa,CAAC;IAC7C,CAAC;IAED,YAAY,CAAC,OAAe;QAC1B,OAAO,EAAE,CAAC,WAAW,CAAC,OAAO,EAAE,EAAE,aAAa,EAAE,IAAI,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;YACtE,IAAI,EAAE,KAAK,CAAC,IAAI;YAChB,WAAW,EAAE,KAAK,CAAC,WAAW,EAAE;SACjC,CAAC,CAAC,CAAC;IACN,CAAC;CACF,CAAC;AAEF,kBAAe,SAAS,CAAC"}

package/dist/src/analysis/functionIndex.d.ts

@@ -0,0 +1,19 @@
+import type { FunctionDefinition } from '../types';
+export interface InnerMethodDefinition {
+    name: string;
+    nameLower: string;
+    line: number;
+    column: number;
+    filePath: string;
+    ownerFunction?: string;
+}
+/**
+ * Parses all top-level function/sub definitions from a BrightScript text.
+ */
+export declare function parseFunctionDefs(text: string, filePath: string, preLines?: string[]): FunctionDefinition[];
+/**
+ * Parses all associative-array method assignments of the form
+ * `<obj>.<name> = function|sub (...)` from a BrightScript text.
+ */
+export declare function parseInnerMethodDefs(text: string, filePath: string): InnerMethodDefinition[];
+//# sourceMappingURL=functionIndex.d.ts.map

package/dist/src/analysis/functionIndex.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"functionIndex.d.ts","sourceRoot":"","sources":["../../../src/analysis/functionIndex.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,UAAU,CAAC;AAOnD,MAAM,WAAW,qBAAqB;IACpC,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,EAAE,GAAG,kBAAkB,EAAE,CAkB3G;AAED;;;GAGG;AACH,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,qBAAqB,EAAE,CA+B5F"}

package/dist/src/analysis/functionIndex.js

@@ -0,0 +1,69 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.parseFunctionDefs = parseFunctionDefs;
+exports.parseInnerMethodDefs = parseInnerMethodDefs;
+const FUNC_PREFIX_RE = /^\s*(?:function|sub)\s+/i;
+const FUNC_FULL_RE = /^\s*(?:function|sub)\s+(\w+)\s*\(/i;
+const INNER_METHOD_RE = /^\s*\w+\.(\w+)\s*=\s*(?:function|sub)\s*\(/i;
+const INNER_COLON_METHOD_RE = /^\s*(\w+)\s*:\s*(?:function|sub)\s*\(/i;
+/**
+ * Parses all top-level function/sub definitions from a BrightScript text.
+ */
+function parseFunctionDefs(text, filePath, preLines) {
+    const lines = preLines ?? text.split(/\r?\n/);
+    const defs = [];
+    for (let i = 0; i < lines.length; i++) {
+        const match = FUNC_FULL_RE.exec(lines[i]);
+        if (!match)
+            continue;
+        const prefixMatch = FUNC_PREFIX_RE.exec(lines[i]);
+        const column = prefixMatch ? prefixMatch[0].length : 0;
+        defs.push({
+            name: match[1],
+            nameLower: match[1].toLowerCase(),
+            line: i,
+            column,
+            filePath,
+            signature: lines[i].trim(),
+        });
+    }
+    return defs;
+}
+/**
+ * Parses all associative-array method assignments of the form
+ * `<obj>.<name> = function|sub (...)` from a BrightScript text.
+ */
+function parseInnerMethodDefs(text, filePath) {
+    const lines = text.split(/\r?\n/);
+    const funcDefs = parseFunctionDefs(text, filePath, lines);
+    const defs = [];
+    for (let i = 0; i < lines.length; i++) {
+        const line = lines[i];
+        if (/^\s*'/.test(line))
+            continue;
+        let name, column;
+        const dotMatch = INNER_METHOD_RE.exec(line);
+        if (dotMatch) {
+            name = dotMatch[1];
+            const dotIdx = line.indexOf('.');
+            column = line.indexOf(name, dotIdx >= 0 ? dotIdx : 0);
+        }
+        else {
+            const colonMatch = INNER_COLON_METHOD_RE.exec(line);
+            if (!colonMatch)
+                continue;
+            name = colonMatch[1];
+            column = line.search(/\S/);
+        }
+        let ownerFunction;
+        for (let j = funcDefs.length - 1; j >= 0; j--) {
+            if (funcDefs[j].line <= i) {
+                ownerFunction = funcDefs[j].name;
+                break;
+            }
+        }
+        defs.push({ name, nameLower: name.toLowerCase(), line: i, column, filePath, ownerFunction });
+    }
+    return defs;
+}
+//# sourceMappingURL=functionIndex.js.map

package/dist/src/analysis/functionIndex.js.map

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

package/dist/src/analysis/globMatcher.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Minimal glob matcher supporting `*` (any chars except `/`) and `**` (any chars including `/`).
+ * Used to match @import paths against user-configured generated-file patterns.
+ */
+export declare function matchesGlob(str: string, pattern: string): boolean;
+/** Returns the first pattern that matches, or undefined if none match. */
+export declare function findMatchingGlob(str: string, patterns: string[]): string | undefined;
+//# sourceMappingURL=globMatcher.d.ts.map

package/dist/src/analysis/globMatcher.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"globMatcher.d.ts","sourceRoot":"","sources":["../../../src/analysis/globMatcher.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAIH,wBAAgB,WAAW,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAYjE;AAED,0EAA0E;AAC1E,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,GAAG,MAAM,GAAG,SAAS,CAEpF"}

package/dist/src/analysis/globMatcher.js

@@ -0,0 +1,27 @@
+"use strict";
+/**
+ * Minimal glob matcher supporting `*` (any chars except `/`) and `**` (any chars including `/`).
+ * Used to match @import paths against user-configured generated-file patterns.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.matchesGlob = matchesGlob;
+exports.findMatchingGlob = findMatchingGlob;
+const _globRegexCache = new Map();
+function matchesGlob(str, pattern) {
+    let regex = _globRegexCache.get(pattern);
+    if (!regex) {
+        const regexSource = pattern
+            .replace(/[.+^${}()|[\]\\]/g, '\\$&') // escape regex metacharacters
+            .replace(/\*\*/g, '\x00') // placeholder for **
+            .replace(/\*/g, '[^/]*') // * → any non-slash chars
+            .replace(/\x00/g, '.*'); // ** → any chars (including /)
+        regex = new RegExp('^' + regexSource + '$');
+        _globRegexCache.set(pattern, regex);
+    }
+    return regex.test(str);
+}
+/** Returns the first pattern that matches, or undefined if none match. */
+function findMatchingGlob(str, patterns) {
+    return patterns.find((p) => matchesGlob(str, p));
+}
+//# sourceMappingURL=globMatcher.js.map

package/dist/src/analysis/globMatcher.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"globMatcher.js","sourceRoot":"","sources":["../../../src/analysis/globMatcher.ts"],"names":[],"mappings":";AAAA;;;GAGG;;AAIH,kCAYC;AAGD,4CAEC;AAnBD,MAAM,eAAe,GAAG,IAAI,GAAG,EAAkB,CAAC;AAElD,SAAgB,WAAW,CAAC,GAAW,EAAE,OAAe;IACtD,IAAI,KAAK,GAAG,eAAe,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;IACzC,IAAI,CAAC,KAAK,EAAE,CAAC;QACX,MAAM,WAAW,GAAG,OAAO;aACxB,OAAO,CAAC,mBAAmB,EAAE,MAAM,CAAC,CAAC,8BAA8B;aACnE,OAAO,CAAC,OAAO,EAAE,MAAM,CAAC,CAAc,qBAAqB;aAC3D,OAAO,CAAC,KAAK,EAAE,OAAO,CAAC,CAAe,0BAA0B;aAChE,OAAO,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC,CAAe,+BAA+B;QACxE,KAAK,GAAG,IAAI,MAAM,CAAC,GAAG,GAAG,WAAW,GAAG,GAAG,CAAC,CAAC;QAC5C,eAAe,CAAC,GAAG,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC;IACtC,CAAC;IACD,OAAO,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AACzB,CAAC;AAED,0EAA0E;AAC1E,SAAgB,gBAAgB,CAAC,GAAW,EAAE,QAAkB;IAC9D,OAAO,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,WAAW,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC,CAAC;AACnD,CAAC"}

package/dist/src/analysis/importParser.d.ts

@@ -0,0 +1,22 @@
+import type { KopytkoImport } from '../types';
+export declare function parseImports(text: string): KopytkoImport[];
+export interface ImportResolverOptions {
+    workspaceFolders: string[];
+    sourceDir: string;
+    resolveModules: boolean;
+}
+export declare class ImportResolver {
+    private readonly options;
+    private packageCache;
+    constructor(options: ImportResolverOptions);
+    getWorkspaceFolders(): string[];
+    getSourceDir(): string;
+    parseImports(text: string): KopytkoImport[];
+    resolveImportPath(imp: KopytkoImport, documentPath: string): string | undefined;
+    importExists(imp: KopytkoImport, documentPath: string): boolean;
+    invalidatePackageCache(): void;
+    private resolveInternalImport;
+    private resolveExternalImport;
+    resolvePackageBaseDir(packageName: string): string | undefined;
+}
+//# sourceMappingURL=importParser.d.ts.map

package/dist/src/analysis/importParser.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"importParser.d.ts","sourceRoot":"","sources":["../../../src/analysis/importParser.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAK9C,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,aAAa,EAAE,CAkB1D;AAED,MAAM,WAAW,qBAAqB;IACpC,gBAAgB,EAAE,MAAM,EAAE,CAAC;IAC3B,SAAS,EAAE,MAAM,CAAC;IAClB,cAAc,EAAE,OAAO,CAAC;CACzB;AAED,qBAAa,cAAc;IACzB,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAwB;IAChD,OAAO,CAAC,YAAY,CAAoC;gBAE5C,OAAO,EAAE,qBAAqB;IAI1C,mBAAmB,IAAI,MAAM,EAAE;IAI/B,YAAY,IAAI,MAAM;IAItB,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,aAAa,EAAE;IAI3C,iBAAiB,CAAC,GAAG,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS;IAO/E,YAAY,CAAC,GAAG,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,GAAG,OAAO;IAI/D,sBAAsB,IAAI,IAAI;IAI9B,OAAO,CAAC,qBAAqB;IAmB7B,OAAO,CAAC,qBAAqB;IAY7B,qBAAqB,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS;CAa/D"}