@jrc03c/gtlint 0.12.1

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Spark Wave
+
+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,235 @@
+# GTLint ✨
+
+**GTLint** is a linter, formatter, and syntax highlighter for the [GuidedTrack](https://guidedtrack.com) language, inspired by ESLint and Prettier. It can be used at the command line or installed as a VSCode extension.
+
+- [Disclaimer](#disclaimer)
+- [VSCode extension](#vscode-extension)
+  - [Installation](#installation)
+  - [Usage](#usage)
+- [Command Line](#command-line)
+  - [Installation](#installation-1)
+  - [Usage](#usage-1)
+- [Configuration](#configuration) (i.e., project-wide settings)
+- [Directives](#directives) (i.e., inline settings)
+- [Tests](#tests)
+- [License](#license)
+
+![VSCode extension](https://github.com/user-attachments/assets/71fc166f-1980-4e2d-a84f-41188f6e0dbe)
+
+![CLI tool](https://github.com/user-attachments/assets/06734d44-794c-475c-b5e2-c389a5f5a34c)
+
+# Disclaimer
+
+This tool was written almost exclusively by [Claude Code](https://claude.com/product/claude-code). [Josh Castle](https://github.com/jrc03c) directed Claude Code and made a few small changes to `CLAUDE.md`, `README.md`, and the GuidedTrack files in the `samples` directory; but virtually everything else was written by Claude Code.
+
+# VSCode extension
+
+## Installation
+
+(1) Download the `.vsix` file from here:
+
+[https://github.com/jrc03c/gtlint/releases/latest/download/gtlint.vsix](https://github.com/jrc03c/gtlint/releases/latest/download/gtlint.vsix)
+
+(2) In VSCode, open the command palette and search for "vsix":
+
+![](https://github.com/user-attachments/assets/03128194-04c5-4991-9acd-e9efb3e38ec9)
+
+Select "Extensions: Install from VSIX...".
+
+(3) Select the `gtlint.vsix` file that you downloaded in the first step.
+
+## Usage
+
+The linter works while you write code in `.gt` files and will show errors as soon as it detects them. The formatter will format code in `.gt` files on save.
+
+See the [Configuration](#configuration) section below for more info about how to control the extension's behavior.
+
+# Command Line
+
+## Installation
+
+> **NOTE:** Requires [Node](https://nodejs.org/en).
+
+In a specific project:
+
+```bash
+npm install --save-dev @jrc03c/gtlint
+```
+
+Or globally:
+
+```bash
+npm install -g @jrc03c/gtlint
+```
+
+## Usage
+
+> **NOTE:** When installed in a specific project, GTLint must be invoked with `npx gtlint`. When installed globally, it can be invoked with just `gtlint`. The examples below assume that it has been installed in a specific project.
+
+**Syntax:**
+
+```
+# lint:
+npx gtlint lint [options] [files]
+
+# format:
+npx gtlint format [options] [files]
+```
+
+**Show help:**
+
+```bash
+npx gtlint
+```
+
+**Lint:**
+
+```bash
+# show errors and warnings in a particular file
+npx gtlint lint path/to/some-file.gt
+
+# show all errors and warnings in all *.gt files in a directory (recursive)
+npx gtlint lint path/to/some-dir
+```
+
+**Format:**
+
+```bash
+# format a specific file
+npx gtlint format path/to/some-file.gt
+
+# format all *.gt files in a directory (recursive)
+npx gtlint format path/to/some-dir
+```
+
+See the [Configuration](#configuration) section below for more info about how to control the command line tool's behavior.
+
+# Configuration
+
+The linter's and formatter's default behaviors can be controlled by settings in a `gtlint.config.js` file at the root of a repository. Here's a sample configuration file containing all of the default values:
+
+```js
+export default {
+  // formatter settings
+  format: {
+    insertFinalNewline: true,
+    spaceAfterComma: true,
+    spaceAroundArrow: true,
+    spaceAroundOperators: true,
+    trimTrailingWhitespace: true,
+  },
+
+  // linter settings
+  rules: {
+    correctIndentation: "error",
+    indentStyle: "error",
+    noDuplicateLabels: "error",
+    noInvalidGoto: "error",
+    noSingleQuotes: "warn",
+    noUnclosedBracket: "error",
+    noUnclosedString: "error",
+    noUndefinedVars: "error",
+    noUnusedVars: "warn",
+    validKeyword: "error",
+    validSubKeyword: "error",
+  },
+}
+```
+
+Linter rules can have these values:
+
+- `"off"` or `0` - Disable the rule
+- `"warn"` or `1` - Show as warning (doesn't fail linting)
+- `"error"` or `2` - Show as error (fails linting)
+
+# Directives
+
+The linter's and formatter's behaviors can also be overridden by inline _directives_ written directly into `.gt` files. Directives are always commented out. For example:
+
+```
+-- @to-child: email_address
+>> email_address = "someone@example.com"
+*program: Add to Mailing List
+```
+
+Here are the available directives and what they do:
+
+**Combined (lint + format):**
+
+- **`@gt-disable`**<br>
+  Disable lint + format until `@gt-enable` or EOF
+
+- **`@gt-enable`**<br>
+  Re-enable lint + format
+
+- **`@gt-disable-next-line`**<br>
+  Disable lint + format for next line only
+
+- **`@gt-disable-next-line rule1, rule2`**<br>
+  Disable specific lint rules + format for next line
+
+**Lint-only:**
+
+- **`@gtlint-disable`**<br>
+  Disable all lint rules until `@gtlint-enable` or EOF
+
+- **`@gtlint-disable rule1, rule2`**<br>
+  Disable specific lint rules
+
+- **`@gtlint-enable`**<br>
+  Re-enable all lint rules
+
+- **`@gtlint-enable rule1`**<br>
+  Re-enable specific lint rule
+
+- **`@gtlint-disable-next-line`**<br>
+  Disable all lint rules for next line
+
+- **`@gtlint-disable-next-line rule1, rule2`**<br>
+  Disable specific rules for next line
+
+- **`@from-child: var1, var2, ...`**<br>
+  Do not mark listed variables as undefined (because they are defined in a child program); warns if a listed variable is never used
+
+- **`@from-parent: var1, var2, ...`**<br>
+  Do not mark listed variables as undefined (because they are defined in a parent program); warns if a listed variable is never used or if its value is overwritten before being read
+
+- **`@from-url: var1, var2, ...`**<br>
+  Do not mark listed variables as undefined (because they are defined in URL query string parameters); warns if a listed variable is never used or if its value is overwritten before being read
+
+- **`@to-child: var1, var2, ...`**<br>
+  Do not mark listed variables as unused (because they will be used in a child program)
+
+- **`@to-parent: var1, var2, ...`**<br>
+  Do not mark listed variables as unused (because they will be used in a parent program)
+
+- **`@to-csv: var1, var2, ...`**<br>
+  Do not mark listed variables as unused (because they will be saved in the root program's CSV)
+
+> **NOTE:** Inline directive rule names always use kebab-case (e.g., `no-unused-vars`), even though config files use camelCase.
+
+**Format-only:**
+
+- **`@gtformat-disable`**<br>
+  Disable formatting until `@gtformat-enable` or EOF
+
+- **`@gtformat-enable`**<br>
+  Re-enable formatting
+
+> **NOTE:** `@gtformat-*` directives don't support rule lists since formatting isn't rule-based.
+
+# Tests
+
+```bash
+pnpm test
+```
+
+The test suite includes integration tests that exercise real GuidedTrack programs from a git submodule (`submodules/gt-lib`). This submodule points to a private repository and is optional. If it's not initialized, those tests are skipped automatically. All other tests will run normally.
+
+# Feedback
+
+If you run into bugs or have feature requests, please [open an issue](https://github.com/jrc03c/gtlint/issues).
+
+# License
+
+MIT

package/bin/gtlint.js

@@ -0,0 +1,4 @@
+#!/usr/bin/env node
+import { main } from '../dist/cli.js';
+
+main(process.argv.slice(2));

package/dist/cli.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export declare function main(args?: string[]): Promise<void>;
+//# sourceMappingURL=cli.d.ts.map

package/dist/cli.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":";AAgQA,wBAAsB,IAAI,CAAC,IAAI,GAAE,MAAM,EAA0B,GAAG,OAAO,CAAC,IAAI,CAAC,CAkChF"}

package/dist/cli.js

@@ -0,0 +1,248 @@
+#!/usr/bin/env node
+import { readFileSync, writeFileSync, existsSync, statSync } from 'fs';
+import { resolve, relative, extname, dirname, join } from 'path';
+import { fileURLToPath } from 'url';
+import { globSync } from 'glob';
+import { Linter } from './linter/index.js';
+import { Formatter } from './formatter/index.js';
+import { loadConfig } from './config.js';
+const __dirname = dirname(fileURLToPath(import.meta.url));
+const { version } = JSON.parse(readFileSync(join(__dirname, '..', 'package.json'), 'utf-8'));
+function printHelp() {
+    console.log(`
+gtlint - A linter and formatter for GuidedTrack
+
+Usage:
+  gtlint lint [options] [files...]    Lint GuidedTrack files
+  gtlint format [options] [files...]  Format GuidedTrack files
+
+Lint Options:
+  --quiet              Only report errors, not warnings
+  --format <type>      Output format: stylish (default), json, compact
+
+Format Options:
+  --write              Format and write back to files
+
+Common Options:
+  --config <path>      Path to config file
+  --help, -h           Show this help message
+  --version, -v        Show version number
+
+Examples:
+  gtlint lint .                    Lint all .gt files in current directory
+  gtlint lint src/                 Lint all .gt files in src directory
+  gtlint lint program.gt           Lint a specific file
+  gtlint format .                  Print formatted output to stdout
+  gtlint format --write .          Format all files in place
+`);
+}
+function printVersion() {
+    console.log(`gtlint v${version}`);
+}
+function parseArgs(args) {
+    const options = {};
+    const files = [];
+    let command = '';
+    let i = 0;
+    while (i < args.length) {
+        const arg = args[i];
+        if (arg === 'lint' || arg === 'format') {
+            command = arg;
+        }
+        else if (arg === '--config' && args[i + 1]) {
+            options.config = args[++i];
+        }
+        else if (arg === '--write') {
+            options.write = true;
+        }
+        else if (arg === '--quiet') {
+            options.quiet = true;
+        }
+        else if (arg === '--format' && args[i + 1]) {
+            options.format = args[++i];
+        }
+        else if (arg === '--help' || arg === '-h') {
+            options.help = true;
+        }
+        else if (arg === '--version' || arg === '-v') {
+            options.version = true;
+        }
+        else if (!arg.startsWith('-')) {
+            files.push(arg);
+        }
+        i++;
+    }
+    return { command, files, options };
+}
+function findFiles(patterns, ignore) {
+    const files = [];
+    for (const pattern of patterns) {
+        const resolved = resolve(pattern);
+        if (existsSync(resolved) && statSync(resolved).isFile()) {
+            if (extname(resolved) === '.gt') {
+                files.push(resolved);
+            }
+        }
+        else if (existsSync(resolved) && statSync(resolved).isDirectory()) {
+            // Find all .gt files in directory
+            const globPattern = `${resolved}/**/*.gt`;
+            const found = globSync(globPattern, { ignore });
+            files.push(...found);
+        }
+        else {
+            // Treat as glob pattern
+            const found = globSync(pattern, { ignore });
+            files.push(...found.filter(f => extname(f) === '.gt'));
+        }
+    }
+    return [...new Set(files)]; // Remove duplicates
+}
+function formatStylish(results) {
+    const lines = [];
+    let totalErrors = 0;
+    let totalWarnings = 0;
+    for (const result of results) {
+        if (result.messages.length === 0)
+            continue;
+        lines.push('');
+        lines.push(result.filePath);
+        for (const msg of result.messages) {
+            const severity = msg.severity === 'error' ? '\x1b[31merror\x1b[0m' : '\x1b[33mwarning\x1b[0m';
+            const location = `${msg.line}:${msg.column}`;
+            lines.push(`  ${location.padEnd(8)} ${severity.padEnd(17)} ${msg.message}  \x1b[90m${msg.ruleId}\x1b[0m`);
+        }
+        totalErrors += result.errorCount;
+        totalWarnings += result.warningCount;
+    }
+    if (totalErrors > 0 || totalWarnings > 0) {
+        lines.push('');
+        const summary = [];
+        if (totalErrors > 0)
+            summary.push(`${totalErrors} error${totalErrors === 1 ? '' : 's'}`);
+        if (totalWarnings > 0)
+            summary.push(`${totalWarnings} warning${totalWarnings === 1 ? '' : 's'}`);
+        lines.push(`\x1b[1m${summary.join(', ')}\x1b[0m`);
+    }
+    return lines.join('\n');
+}
+function formatCompact(results) {
+    const lines = [];
+    for (const result of results) {
+        for (const msg of result.messages) {
+            lines.push(`${result.filePath}:${msg.line}:${msg.column}: ${msg.severity}: ${msg.message} [${msg.ruleId}]`);
+        }
+    }
+    return lines.join('\n');
+}
+function formatJson(results) {
+    const sanitized = results.map(({ source, output, ...rest }) => rest);
+    return JSON.stringify(sanitized, null, 2);
+}
+async function runLint(files, options) {
+    const cwd = process.cwd();
+    const configPath = options.config || cwd;
+    const { linter: linterConfig, ignore } = await loadConfig(configPath);
+    const targetFiles = files.length > 0 ? files : ['.'];
+    const filePaths = findFiles(targetFiles, ignore);
+    if (filePaths.length === 0) {
+        console.log('No .gt files found');
+        return 0;
+    }
+    const linter = new Linter(linterConfig);
+    const results = [];
+    for (const filePath of filePaths) {
+        const source = readFileSync(filePath, 'utf-8');
+        const relativePath = relative(cwd, filePath);
+        const result = linter.lint(source, relativePath);
+        results.push(result);
+    }
+    // Filter warnings if quiet mode
+    if (options.quiet) {
+        for (const result of results) {
+            result.messages = result.messages.filter(m => m.severity === 'error');
+            result.warningCount = 0;
+        }
+    }
+    // Format output
+    let output;
+    switch (options.format) {
+        case 'json':
+            output = formatJson(results);
+            break;
+        case 'compact':
+            output = formatCompact(results);
+            break;
+        default:
+            output = formatStylish(results);
+    }
+    if (output.trim()) {
+        console.log(output);
+    }
+    // Return exit code
+    const hasErrors = results.some(r => r.errorCount > 0);
+    return hasErrors ? 1 : 0;
+}
+async function runFormat(files, options) {
+    const cwd = process.cwd();
+    const configPath = options.config || cwd;
+    const { formatter: formatterConfig, ignore } = await loadConfig(configPath);
+    const targetFiles = files.length > 0 ? files : ['.'];
+    const filePaths = findFiles(targetFiles, ignore);
+    if (filePaths.length === 0) {
+        console.log('No .gt files found');
+        return 0;
+    }
+    const formatter = new Formatter(formatterConfig);
+    let changedCount = 0;
+    for (const filePath of filePaths) {
+        const source = readFileSync(filePath, 'utf-8');
+        const formatted = formatter.format(source);
+        const relativePath = relative(cwd, filePath);
+        if (options.write) {
+            if (source !== formatted) {
+                writeFileSync(filePath, formatted, 'utf-8');
+                changedCount++;
+                console.log(`Formatted: ${relativePath}`);
+            }
+        }
+        else {
+            process.stdout.write(formatted);
+        }
+    }
+    if (options.write && changedCount === 0) {
+        console.log('All files are already properly formatted');
+    }
+    return 0;
+}
+export async function main(args = process.argv.slice(2)) {
+    const { command, files, options } = parseArgs(args);
+    if (options.help || (!command && !options.version)) {
+        printHelp();
+        process.exit(0);
+    }
+    if (options.version) {
+        printVersion();
+        process.exit(0);
+    }
+    try {
+        let exitCode = 0;
+        switch (command) {
+            case 'lint':
+                exitCode = await runLint(files, options);
+                break;
+            case 'format':
+                exitCode = await runFormat(files, options);
+                break;
+            default:
+                console.error(`Unknown command: ${command}`);
+                printHelp();
+                exitCode = 1;
+        }
+        process.exit(exitCode);
+    }
+    catch (error) {
+        console.error('Error:', error instanceof Error ? error.message : error);
+        process.exit(1);
+    }
+}
+//# sourceMappingURL=cli.js.map

package/dist/cli.js.map

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

package/dist/config.d.ts

@@ -0,0 +1,32 @@
+import type { LinterConfig, FormatterConfig } from './types.js';
+export interface GTLintConfig {
+    rules?: LinterConfig['rules'];
+    format?: Partial<FormatterConfig>;
+    ignore?: string[];
+}
+/**
+ * Find a config file by searching up the directory tree
+ */
+export declare function findConfigFile(startDir: string): string | null;
+/**
+ * Load a config file
+ */
+export declare function loadConfigFile(configPath: string): Promise<GTLintConfig>;
+/**
+ * Merge user config with defaults
+ */
+export declare function mergeConfig(userConfig: GTLintConfig): {
+    linter: LinterConfig;
+    formatter: FormatterConfig;
+    ignore: string[];
+};
+/**
+ * Load config from a directory or specific file path
+ */
+export declare function loadConfig(pathOrDir: string): Promise<{
+    linter: LinterConfig;
+    formatter: FormatterConfig;
+    ignore: string[];
+    configPath: string | null;
+}>;
+//# sourceMappingURL=config.d.ts.map

package/dist/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,YAAY,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AA4BhE,MAAM,WAAW,YAAY;IAC3B,KAAK,CAAC,EAAE,YAAY,CAAC,OAAO,CAAC,CAAC;IAC9B,MAAM,CAAC,EAAE,OAAO,CAAC,eAAe,CAAC,CAAC;IAClC,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;CACnB;AAOD;;GAEG;AACH,wBAAgB,cAAc,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAyB9D;AAED;;GAEG;AACH,wBAAsB,cAAc,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC,CAQ9E;AAED;;GAEG;AACH,wBAAgB,WAAW,CAAC,UAAU,EAAE,YAAY,GAAG;IACrD,MAAM,EAAE,YAAY,CAAC;IACrB,SAAS,EAAE,eAAe,CAAC;IAC3B,MAAM,EAAE,MAAM,EAAE,CAAC;CAClB,CAqBA;AAED;;GAEG;AACH,wBAAsB,UAAU,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC;IAC3D,MAAM,EAAE,YAAY,CAAC;IACrB,SAAS,EAAE,eAAe,CAAC;IAC3B,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;CAC3B,CAAC,CAyBD"}

package/dist/config.js

@@ -0,0 +1,112 @@
+import { existsSync } from 'fs';
+import { resolve, dirname } from 'path';
+import { pathToFileURL } from 'url';
+import { DEFAULT_LINTER_CONFIG, DEFAULT_FORMATTER_CONFIG } from './types.js';
+/**
+ * Convert camelCase to kebab-case (e.g., noUnusedVars → no-unused-vars).
+ * Strings that are already kebab-case pass through unchanged.
+ */
+function camelToKebab(str) {
+    return str.replace(/[A-Z]/g, m => '-' + m.toLowerCase());
+}
+function normalizeRuleKeys(rules) {
+    const normalized = {};
+    for (const [key, value] of Object.entries(rules)) {
+        normalized[camelToKebab(key)] = value;
+    }
+    return normalized;
+}
+const CONFIG_FILENAMES = [
+    'gtlint.config.js',
+    'gtlint.config.mjs',
+];
+/**
+ * Find a config file by searching up the directory tree
+ */
+export function findConfigFile(startDir) {
+    let currentDir = resolve(startDir);
+    const root = dirname(currentDir);
+    while (currentDir !== root) {
+        for (const filename of CONFIG_FILENAMES) {
+            const configPath = resolve(currentDir, filename);
+            if (existsSync(configPath)) {
+                return configPath;
+            }
+        }
+        const parentDir = dirname(currentDir);
+        if (parentDir === currentDir)
+            break;
+        currentDir = parentDir;
+    }
+    // Check root directory
+    for (const filename of CONFIG_FILENAMES) {
+        const configPath = resolve(currentDir, filename);
+        if (existsSync(configPath)) {
+            return configPath;
+        }
+    }
+    return null;
+}
+/**
+ * Load a config file
+ */
+export async function loadConfigFile(configPath) {
+    try {
+        const fileUrl = pathToFileURL(resolve(configPath)).href;
+        const module = await import(fileUrl);
+        return module.default || module;
+    }
+    catch (error) {
+        throw new Error(`Failed to load config file: ${configPath}\n${error}`);
+    }
+}
+/**
+ * Merge user config with defaults
+ */
+export function mergeConfig(userConfig) {
+    const linterConfig = {
+        ...DEFAULT_LINTER_CONFIG,
+        rules: {
+            ...DEFAULT_LINTER_CONFIG.rules,
+            ...(userConfig.rules ? normalizeRuleKeys(userConfig.rules) : {}),
+        },
+        format: {
+            ...DEFAULT_LINTER_CONFIG.format,
+            ...userConfig.format,
+        },
+    };
+    const formatterConfig = {
+        ...DEFAULT_FORMATTER_CONFIG,
+        ...userConfig.format,
+    };
+    const ignore = userConfig.ignore || ['**/node_modules/**', '**/dist/**'];
+    return { linter: linterConfig, formatter: formatterConfig, ignore };
+}
+/**
+ * Load config from a directory or specific file path
+ */
+export async function loadConfig(pathOrDir) {
+    let configPath = null;
+    // If path points to a config file, use it directly
+    if (pathOrDir.endsWith('.js') || pathOrDir.endsWith('.mjs')) {
+        if (existsSync(pathOrDir)) {
+            configPath = pathOrDir;
+        }
+    }
+    else {
+        // Search for config file
+        configPath = findConfigFile(pathOrDir);
+    }
+    if (configPath) {
+        const userConfig = await loadConfigFile(configPath);
+        return { ...mergeConfig(userConfig), configPath };
+    }
+    // No config file found, use defaults
+    return {
+        linter: DEFAULT_LINTER_CONFIG,
+        formatter: DEFAULT_FORMATTER_CONFIG,
+        ignore: ['**/node_modules/**', '**/dist/**'],
+        configPath: null,
+    };
+}
+//# sourceMappingURL=config.js.map