kopytko-formatter 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Błażej Chełkowski
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,141 @@
+# kopytko-formatter
+
+BrightScript formatter and code style checker for the [Kopytko ecosystem](https://github.com/bchelkowski/vscode-kopytko).
+
+Use it as a **CLI tool** in CI pipelines, or import it as a **library** in your own tools.
+
+## Installation
+
+```bash
+npm install --save-dev kopytko-formatter
+```
+
+## CLI Usage
+
+```bash
+# Check mode — exit 1 if any file needs formatting (use in CI)
+npx kopytko-format --check "src/**/*.brs"
+
+# Write mode — format files in place
+npx kopytko-format --write "src/**/*.brs"
+
+# With explicit config
+npx kopytko-format --check --config .kopytkorc "components/**/*.brs"
+```
+
+### Options
+
+| Flag | Description |
+|---|---|
+| `--check` | Check mode — exit 1 if any file needs formatting |
+| `--write` | Write formatted output back to files |
+| `--config <path>` | Path to config file (JSON) |
+| `--ignore <glob>` | Glob pattern of files to skip (repeatable) |
+| `--help`, `-h` | Show help |
+| `--version`, `-v` | Show version |
+
+## Configuration
+
+The formatter reads config from (in priority order):
+
+1. `--config <file>` CLI flag
+2. `kopytko-formatter.json` in the current directory
+3. `.vscode/settings.json` — reads `kopytko.format.*` keys automatically
+
+Config keys match the VS Code extension settings without the `kopytko.format.` prefix.
+
+### Example `kopytko-formatter.json`
+
+```json
+{
+  "indentSize": 2,
+  "endKeywordStyle": "spaced",
+  "trimTrailingWhitespace": true,
+  "insertFinalNewline": true,
+  "spaceAroundOperators": true,
+  "spaceAroundAssignment": true,
+  "sortImports": true,
+  "emptyLineAfterImports": true,
+  "maxEmptyLines": 1,
+  "emptyLinesBetweenFunctions": 1,
+  "keywordCasing": "LowerCase",
+  "builtinCasing": "PascalCase",
+  "typeCasing": "PascalCase",
+  "literalCasing": "LowerCase",
+  "logicOperatorCasing": "UpperCase",
+  "ignore": [
+    "**/node_modules/**",
+    "**/dist/**",
+    "**/_tests/**"
+  ]
+}
+```
+
+If your project already has formatting settings in `.vscode/settings.json`, no extra config file is needed — the CLI reads them directly.
+
+### Ignoring files
+
+Exclude paths from formatting via the `ignore` array in your config file or the `--ignore` CLI flag:
+
+```bash
+# CLI flag (repeatable)
+npx kopytko-format --check --ignore "**/_tests/**" --ignore "**/dist/**" app
+
+# Or in kopytko-formatter.json / .vscode/settings.json
+# "ignore": ["**/_tests/**", "**/dist/**"]
+```
+
+Patterns use glob syntax: `*` matches within a path segment, `**` matches any depth.
+
+## Library Usage
+
+```typescript
+import { formatText, checkFormatting, DEFAULT_FORMATTING_CONFIG } from 'kopytko-formatter';
+
+// Format a BrightScript source string
+const formatted = formatText(source, {
+  ...DEFAULT_FORMATTING_CONFIG,
+  indentSize: 2,
+  endKeywordStyle: 'spaced',
+});
+
+// Check if source is already formatted (returns boolean)
+const isClean = checkFormatting(source, DEFAULT_FORMATTING_CONFIG);
+```
+
+### API
+
+#### `formatText(source, config, casing?, userFunctions?): string`
+
+Formats BrightScript source code using an 11-pass engine.
+
+- `source` — raw BrightScript source text
+- `config` — `FormattingConfig` object
+- `casing` — optional `CasingConfig` for identifier casing rules
+- `userFunctions` — optional array of known function definitions for casing normalization
+
+#### `checkFormatting(source, config, casing?, userFunctions?): boolean`
+
+Returns `true` if the source text is already formatted (no changes needed).
+
+## GitHub Actions
+
+```yaml
+# .github/workflows/format-check.yml
+name: Format Check
+on: [push, pull_request]
+jobs:
+  format:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-node@v4
+        with:
+          node-version: 24
+      - run: npm ci
+      - run: npx kopytko-format --check "src/**/*.brs"
+```
+
+## License
+
+MIT

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

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

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

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

package/dist/bin/kopytko-format.js

@@ -0,0 +1,356 @@
+#!/usr/bin/env node
+"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"));
+const path = __importStar(require("path"));
+const formatter_1 = require("../src/formatter");
+const config_1 = require("../src/config");
+const casing_1 = require("../src/casing");
+const VERSION = require('../../package.json').version;
+function printUsage() {
+    console.log(`
+kopytko-format v${VERSION}
+BrightScript formatter for the Kopytko ecosystem.
+
+USAGE
+  kopytko-format [options] <glob ...>
+
+OPTIONS
+  --check           Check mode — exit 1 if any file needs formatting.
+  --write           Write formatted output back to files (default: print diff).
+  --config <path>   Path to config file (JSON). Default: auto-detect.
+  --ignore <glob>   Glob pattern of files to skip (repeatable).
+  --help, -h        Show this help message.
+  --version, -v     Show version.
+
+EXAMPLES
+  kopytko-format --check "src/**/*.brs"
+  kopytko-format --write "src/**/*.brs"
+  kopytko-format --check --config kopytko-formatter.json "components/**/*.brs"
+
+CONFIG
+  The formatter reads config from (in priority order):
+    1. --config <file>            explicit path
+    2. kopytko-formatter.json     in the current directory
+    3. .vscode/settings.json      "kopytko.format.*" keys
+
+  Config keys match VS Code settings without the "kopytko.format." prefix.
+  Example kopytko-formatter.json:
+    {
+      "indentSize": 2,
+      "endKeywordStyle": "spaced",
+      "trimTrailingWhitespace": true,
+      "insertFinalNewline": true,
+      "keywordCasing": "LowerCase",
+      "builtinCasing": "PascalCase",
+      "ignore": [
+        "**/node_modules/**",
+        "**/dist/**",
+        "**/_tests/**"
+      ]
+    }
+`);
+}
+function parseArgs(argv) {
+    const opts = { check: false, write: false, config: null, ignore: [], patterns: [] };
+    for (let i = 0; i < argv.length; i++) {
+        const arg = argv[i];
+        if (arg === '--check') {
+            opts.check = true;
+        }
+        else if (arg === '--write') {
+            opts.write = true;
+        }
+        else if (arg === '--config' && i + 1 < argv.length) {
+            opts.config = argv[++i];
+        }
+        else if (arg === '--ignore' && i + 1 < argv.length) {
+            opts.ignore.push(argv[++i]);
+        }
+        else if (arg === '--help' || arg === '-h') {
+            printUsage();
+            process.exit(0);
+        }
+        else if (arg === '--version' || arg === '-v') {
+            console.log(VERSION);
+            process.exit(0);
+        }
+        else if (arg.startsWith('-')) {
+            console.error(`Unknown option: ${arg}`);
+            process.exit(1);
+        }
+        else {
+            opts.patterns.push(arg);
+        }
+    }
+    return opts;
+}
+/**
+ * Finds the raw config object from the first available source.
+ * Priority: --config flag > kopytko-formatter.json > .vscode/settings.json
+ */
+function findRawConfig(configPath) {
+    // 1. Explicit config file
+    if (configPath) {
+        if (!fs.existsSync(configPath)) {
+            console.error(`Config file not found: ${configPath}`);
+            process.exit(1);
+        }
+        const raw = JSON.parse(fs.readFileSync(configPath, 'utf-8'));
+        return { settings: raw, source: configPath };
+    }
+    // 2. kopytko-formatter.json in cwd
+    const formatterConfigPath = path.join(process.cwd(), 'kopytko-formatter.json');
+    if (fs.existsSync(formatterConfigPath)) {
+        const raw = JSON.parse(fs.readFileSync(formatterConfigPath, 'utf-8'));
+        return { settings: raw, source: formatterConfigPath };
+    }
+    // 3. .vscode/settings.json with "kopytko.format.*" keys
+    const vscodeSettingsPath = path.join(process.cwd(), '.vscode', 'settings.json');
+    if (fs.existsSync(vscodeSettingsPath)) {
+        const content = fs.readFileSync(vscodeSettingsPath, 'utf-8');
+        // Strip single-line comments (// ...) that VS Code allows in JSONC
+        const stripped = content.replace(/^\s*\/\/.*$/gm, '');
+        const raw = JSON.parse(stripped);
+        const extracted = extractVscodeSettings(raw);
+        if (extracted) {
+            return { settings: extracted, source: vscodeSettingsPath };
+        }
+    }
+    return null;
+}
+/**
+ * Extracts kopytko.format.* keys from a VS Code settings.json object.
+ * Strips the "kopytko.format." prefix from each key.
+ * Returns null if no kopytko.format keys are found.
+ */
+function extractVscodeSettings(raw) {
+    const PREFIX = 'kopytko.format.';
+    const result = {};
+    let found = false;
+    for (const [key, value] of Object.entries(raw)) {
+        if (key.startsWith(PREFIX)) {
+            result[key.slice(PREFIX.length)] = value;
+            found = true;
+        }
+    }
+    return found ? result : null;
+}
+/** Maps VS Code casing key names to CasingConfig field names. */
+const CASING_KEY_MAP = {
+    'keywordCasing': 'keywords',
+    'builtinCasing': 'builtins',
+    'methodCasing': 'methods',
+    'typeCasing': 'types',
+    'literalCasing': 'literals',
+    'logicOperatorCasing': 'logicOperators',
+    'mathOperatorCasing': 'mathOperators',
+    'userFunctionCasing': 'userFunctions',
+    'userMethodCasing': 'userMethods',
+    'exactCasing': 'exactCasing',
+};
+function loadConfig(configPath) {
+    const raw = findRawConfig(configPath);
+    if (!raw)
+        return { ...config_1.DEFAULT_FORMATTING_CONFIG };
+    console.log(`  Config: ${raw.source}`);
+    return (0, config_1.parseFormattingConfig)(raw.settings);
+}
+/** Loads ignore patterns from the config file. */
+function loadIgnorePatterns(configPath) {
+    const raw = findRawConfig(configPath);
+    if (!raw)
+        return [];
+    const ignore = raw.settings['ignore'];
+    if (Array.isArray(ignore))
+        return ignore.filter((p) => typeof p === 'string');
+    return [];
+}
+/**
+ * Matches a file path against a glob-like ignore pattern.
+ * Supports: `*` (single segment), `**` (any depth), `?` (single char).
+ */
+function matchesIgnorePattern(filePath, pattern) {
+    const normalized = filePath.replace(/\\/g, '/');
+    const regex = pattern
+        .replace(/\\/g, '/')
+        .replace(/[.+^${}()|[\]]/g, '\\$&')
+        .replace(/\*\*/g, '\u0000')
+        .replace(/\*/g, '[^/]*')
+        .replace(/\u0000/g, '.*')
+        .replace(/\?/g, '[^/]');
+    return new RegExp(`(?:^|/)${regex}(?:$|/)`).test(normalized) ||
+        new RegExp(`^${regex}$`).test(normalized);
+}
+function isIgnored(filePath, ignorePatterns) {
+    return ignorePatterns.some((pattern) => matchesIgnorePattern(filePath, pattern));
+}
+function loadCasingConfig(configPath) {
+    const raw = findRawConfig(configPath);
+    if (!raw)
+        return { ...casing_1.DEFAULT_CASING_CONFIG };
+    const s = raw.settings;
+    const result = {};
+    for (const [srcKey, destKey] of Object.entries(CASING_KEY_MAP)) {
+        // Support both VS Code key names (keywordCasing) and direct names (keywords)
+        if (s[srcKey] !== undefined)
+            result[destKey] = s[srcKey];
+        else if (s[destKey] !== undefined)
+            result[destKey] = s[destKey];
+    }
+    return {
+        builtins: result.builtins ?? 'NoChange',
+        keywords: result.keywords ?? 'NoChange',
+        methods: result.methods ?? 'NoChange',
+        types: result.types,
+        literals: result.literals,
+        logicOperators: result.logicOperators,
+        mathOperators: result.mathOperators,
+        userFunctions: result.userFunctions,
+        userMethods: result.userMethods,
+        exactCasing: result.exactCasing,
+    };
+}
+function collectFiles(patterns) {
+    const files = [];
+    for (const pattern of patterns) {
+        // Simple glob: if it's a direct file path, use it
+        if (fs.existsSync(pattern) && fs.statSync(pattern).isFile()) {
+            files.push(pattern);
+            continue;
+        }
+        // Walk directories for .brs files
+        if (fs.existsSync(pattern) && fs.statSync(pattern).isDirectory()) {
+            walkDir(pattern, files);
+            continue;
+        }
+        // Basic glob support: **/*.brs patterns
+        // For proper glob support, users should pipe from find or use shell expansion
+        const resolved = resolveGlob(pattern);
+        files.push(...resolved);
+    }
+    return [...new Set(files)];
+}
+function walkDir(dir, out) {
+    for (const entry of fs.readdirSync(dir, { withFileTypes: true })) {
+        const full = path.join(dir, entry.name);
+        if (entry.isDirectory()) {
+            if (entry.name === 'node_modules' || entry.name === '.git')
+                continue;
+            walkDir(full, out);
+        }
+        else if (entry.name.endsWith('.brs')) {
+            out.push(full);
+        }
+    }
+}
+function resolveGlob(pattern) {
+    // Handle simple **/*.brs patterns
+    if (pattern.includes('*')) {
+        const parts = pattern.split(path.sep === '\\' ? /[\\/]/ : '/');
+        const baseIdx = parts.findIndex(p => p.includes('*'));
+        const baseDir = baseIdx > 0 ? parts.slice(0, baseIdx).join(path.sep) : '.';
+        const ext = path.extname(pattern) || '.brs';
+        if (!fs.existsSync(baseDir))
+            return [];
+        const files = [];
+        walkDir(baseDir, files);
+        return files.filter(f => f.endsWith(ext));
+    }
+    return [];
+}
+function main() {
+    const opts = parseArgs(process.argv.slice(2));
+    if (opts.patterns.length === 0) {
+        console.error('Error: No file patterns provided.\n');
+        printUsage();
+        process.exit(1);
+    }
+    const config = loadConfig(opts.config);
+    const casing = loadCasingConfig(opts.config);
+    const ignorePatterns = [...loadIgnorePatterns(opts.config), ...opts.ignore];
+    const allFiles = collectFiles(opts.patterns);
+    const files = ignorePatterns.length > 0
+        ? allFiles.filter((f) => !isIgnored(f, ignorePatterns))
+        : allFiles;
+    if (files.length === 0) {
+        console.error('No .brs files found matching the given patterns.');
+        process.exit(1);
+    }
+    let unformatted = 0;
+    let formatted = 0;
+    let errors = 0;
+    for (const file of files) {
+        try {
+            const source = fs.readFileSync(file, 'utf-8');
+            const isClean = (0, formatter_1.checkFormatting)(source, config, casing);
+            if (isClean) {
+                formatted++;
+                continue;
+            }
+            unformatted++;
+            if (opts.write) {
+                const result = (0, formatter_1.formatText)(source, config, casing);
+                fs.writeFileSync(file, result, 'utf-8');
+                console.log(`  ✓ ${file}`);
+            }
+            else if (opts.check) {
+                console.log(`  ✗ ${file}`);
+            }
+            else {
+                // Default: print to stdout
+                const result = (0, formatter_1.formatText)(source, config, casing);
+                console.log(`--- ${file} ---`);
+                console.log(result);
+            }
+        }
+        catch (err) {
+            errors++;
+            console.error(`  ✗ Error processing ${file}: ${err.message}`);
+        }
+    }
+    // Summary
+    const total = files.length;
+    console.log(`\n${total} file(s) checked: ${formatted} clean, ${unformatted} need formatting${errors > 0 ? `, ${errors} error(s)` : ''}.`);
+    if (opts.check && unformatted > 0) {
+        process.exit(1);
+    }
+    if (errors > 0) {
+        process.exit(2);
+    }
+}
+main();
+//# sourceMappingURL=kopytko-format.js.map

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

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

package/dist/src/builtins.d.ts

@@ -0,0 +1,20 @@
+/**
+ * BrightScript built-in functions and global objects.
+ * Covers the standard BrightScript runtime as documented at:
+ * https://developer.roku.com/docs/references/brightscript/language/global-functions.md
+ */
+export interface BrightScriptBuiltin {
+    name: string;
+    signature: string;
+    returnType: string;
+    description: string;
+    category: 'math' | 'string' | 'type' | 'utility' | 'io' | 'filesystem' | 'object';
+}
+export declare const BRIGHTSCRIPT_BUILTINS: BrightScriptBuiltin[];
+export declare function findBuiltin(name: string): BrightScriptBuiltin | undefined;
+export declare const BRIGHTSCRIPT_KEYWORDS: string[];
+/** Keyword sub-categories for granular casing control. */
+export type KeywordCategory = 'keyword' | 'type' | 'literal' | 'logicOperator' | 'mathOperator';
+/** Returns the category of a keyword (lowercase). */
+export declare function getKeywordCategory(keyword: string): KeywordCategory;
+//# sourceMappingURL=builtins.d.ts.map

package/dist/src/builtins.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"builtins.d.ts","sourceRoot":"","sources":["../../src/builtins.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,MAAM,WAAW,mBAAmB;IAClC,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,MAAM,GAAG,QAAQ,GAAG,MAAM,GAAG,SAAS,GAAG,IAAI,GAAG,YAAY,GAAG,QAAQ,CAAC;CACnF;AAED,eAAO,MAAM,qBAAqB,EAAE,mBAAmB,EAsGtD,CAAC;AAMF,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,mBAAmB,GAAG,SAAS,CAEzE;AAED,eAAO,MAAM,qBAAqB,UAQjC,CAAC;AAEF,0DAA0D;AAC1D,MAAM,MAAM,eAAe,GAAG,SAAS,GAAG,MAAM,GAAG,SAAS,GAAG,eAAe,GAAG,cAAc,CAAC;AAmBhG,qDAAqD;AACrD,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,MAAM,GAAG,eAAe,CAEnE"}