@bitwisedesign/xanoscriptlint 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Bitwise Design
+
+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,128 @@
+# xanoscriptlint
+
+A linter for [XanoScript](https://docs.xano.com/xanoscript/key-concepts).
+
+xanoscriptlint is a style and convention linter, not a compiler. Syntax and semantics stay with Xano (`@xano/xanoscript-language-server`, `xano_validate_xanoscript`). This tool owns convention and pitfall rules, project configuration, path filters, and custom regex rules.
+
+Requires Node.js 20 or later. Runs on linux and macOS (Windows is untested but not blocked).
+
+## Install
+
+```bash
+npm install --save-dev @bitwisedesign/xanoscriptlint
+```
+
+```bash
+npx @bitwisedesign/xanoscriptlint
+npx @bitwisedesign/xanoscriptlint rules
+npx @bitwisedesign/xanoscriptlint path/to/file.xs
+```
+
+`npx` is optional. After a local install, npm puts the binary on `PATH` for scripts:
+
+```json
+"scripts": {
+  "lint:xs": "xanoscriptlint"
+}
+```
+
+Then `npm run lint:xs` runs `xanoscriptlint` with no `npx`.
+
+`npm install -g @bitwisedesign/xanoscriptlint` (no path) only works after the package is published to npm. To put the command on your PATH from a git checkout:
+
+```bash
+npm install
+npm run build
+npm link
+```
+
+Or `npm install -g /path/to/xanoscriptlint`. Remove a link with `npm unlink -g @bitwisedesign/xanoscriptlint`.
+
+## Configuration
+
+Place `.xanoscriptlint.yml` at the project root (or pass `--config`). With no file, built-in defaults apply.
+
+```yaml
+disabled_rules:
+  - no_trailing_newline
+opt_in_rules:
+  - no_var_response
+# only_rules: [empty_function_run]  # exclusive; cannot mix with the two above
+
+included:
+  - "**/*.xs"
+excluded:
+  - ".xano/**"
+  - "**/node_modules/**"
+
+empty_function_run:
+  severity: error
+
+custom_rules:
+  no_todo_in_stack:
+    name: No TODO
+    regex: "TODO"
+    message: "Remove TODO before shipping."
+    severity: warning
+    excluded:
+      - ".*Test\\.xs"
+```
+
+- Built-in rules with `defaultEnabled: true` are on unless listed in `disabled_rules`.
+- Off-by-default rules are enabled with `opt_in_rules`.
+- `only_rules` is an exclusive allowlist and cannot be combined with `disabled_rules` or `opt_in_rules`.
+- `custom_rules` run when defined, unless `only_rules` is set and does not include `custom_rules` or that rule id.
+- `excluded` always wins over `included`. Paths are relative to the config file directory.
+
+See [docs/configuration.md](docs/configuration.md) and [docs/rules.md](docs/rules.md).
+
+## Built-in rules
+
+| Id | Default | Severity | What it catches |
+| --- | --- | --- | --- |
+| `empty_function_run` | on | error | `function.run ""` / `function.run ''` |
+| `no_trailing_newline` | on | error | File does not end with `}` (Xano pull strips trailing newlines); auto-fixable with `--fix` |
+| `no_var_response` | opt-in | warning | `var $response` (Xano rewrites it) |
+
+House style such as a `// Modified:` timestamp belongs in `custom_rules`, not in the default catalog:
+
+```yaml
+custom_rules:
+  modified_stamp:
+    name: Modified stamp
+    regex: "^// Modified: \\d{2}-\\d{2}-\\d{4} \\d{2}:\\d{2}$"
+    message: "Use this only as an example of a team-specific custom rule."
+    severity: warning
+```
+
+(That example matches a stamp line; requiring it as the last header comment is left to your team.)
+
+## Suppressions
+
+XanoScript comments must be on their own line, so suppressions cannot trail a statement.
+
+```xs
+// xanoscriptlint:disable empty_function_run
+// xanoscriptlint:enable empty_function_run
+// xanoscriptlint:disable:next empty_function_run
+// xanoscriptlint:disable:previous empty_function_run
+```
+
+`disable` without `next`/`previous` lasts until a matching `enable` or end of file. A `disable` at the top of the file is the file-wide form.
+
+## CLI
+
+```text
+xanoscriptlint [paths…]
+xanoscriptlint rules
+xanoscriptlint --config path/to/.xanoscriptlint.yml
+xanoscriptlint --reporter json
+xanoscriptlint --strict
+xanoscriptlint --fix
+```
+
+Exit `0` when there are no error-severity violations. Exit `2` when there is at least one error. Warnings alone do not fail CI unless `--strict`.
+
+## License
+
+MIT

package/dist/cli.d.ts

@@ -0,0 +1,6 @@
+#!/usr/bin/env node
+export declare function runCli(argv: string[], io?: {
+    stdout: NodeJS.WritableStream;
+    stderr: NodeJS.WritableStream;
+}): Promise<number>;
+//# 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":";AAuBA,wBAAsB,MAAM,CAC1B,IAAI,EAAE,MAAM,EAAE,EACd,EAAE,GAAE;IAAE,MAAM,EAAE,MAAM,CAAC,cAAc,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC,cAAc,CAAA;CAAY,GAC7E,OAAO,CAAC,MAAM,CAAC,CAiDjB"}

package/dist/cli.js

@@ -0,0 +1,121 @@
+#!/usr/bin/env node
+import { writeFileSync } from "node:fs";
+import { createRequire } from "node:module";
+import { fileURLToPath } from "node:url";
+import { Command, CommanderError } from "commander";
+import { ConfigError, loadConfig } from "./config.js";
+import { discoverXsFiles } from "./discover.js";
+import { fixFile, lintFiles, readSourceFile } from "./lint.js";
+import { builtinRules } from "./rules/index.js";
+import { applyStrict, exitCodeFor, formatFixSummary, formatReport, } from "./report.js";
+import { isMainModule } from "./util.js";
+const require = createRequire(import.meta.url);
+const { version } = require("../package.json");
+export async function runCli(argv, io = process) {
+    let exitCode = 0;
+    const program = new Command();
+    program
+        .name("xanoscriptlint")
+        .description("A linter for XanoScript")
+        .version(version)
+        .option("-c, --config <path>", "path to .xanoscriptlint.yml")
+        .option("--reporter <name>", "stylish or json", "stylish")
+        .option("--strict", "treat warnings as errors", false)
+        .option("--fix", "automatically fix violations where possible", false)
+        .exitOverride()
+        .configureOutput({
+        writeOut: (str) => io.stdout.write(str),
+        writeErr: (str) => io.stderr.write(str),
+    });
+    program
+        .command("lint", { isDefault: true })
+        .description("Lint XanoScript files")
+        .argument("[paths...]", "files or directories to lint")
+        .action(async (paths) => {
+        const opts = program.opts();
+        exitCode = await runLint(paths, opts, io);
+    });
+    program
+        .command("rules")
+        .description("List built-in rules")
+        .action(() => {
+        io.stdout.write(formatRulesList());
+    });
+    try {
+        await program.parseAsync(argv);
+        return exitCode;
+    }
+    catch (error) {
+        if (error instanceof CommanderError) {
+            return error.exitCode;
+        }
+        const message = error instanceof Error ? error.message : String(error);
+        io.stderr.write(`${message}\n`);
+        return 1;
+    }
+}
+async function runLint(paths, opts, io) {
+    const reporter = parseReporter(opts.reporter);
+    if (!reporter) {
+        io.stderr.write(`unknown reporter: ${opts.reporter}\n`);
+        return 1;
+    }
+    try {
+        const cwd = process.cwd();
+        const config = loadConfig({ cwd, configPath: opts.config });
+        const files = await discoverXsFiles({ config, cwd, cliPaths: paths });
+        let sources = files.map((filePath) => readSourceFile(filePath));
+        if (opts.fix) {
+            const corrections = [];
+            const fixed = [];
+            for (const source of sources) {
+                const result = fixFile(source, config);
+                if (result.changed) {
+                    writeFileSync(source.path, result.text, "utf8");
+                }
+                corrections.push(...result.corrections);
+                fixed.push({ path: source.path, text: result.text });
+            }
+            sources = fixed;
+            const summary = formatFixSummary(corrections, cwd);
+            if (summary.length > 0) {
+                const text = summary.endsWith("\n") ? summary : `${summary}\n`;
+                const stream = reporter === "json" ? io.stderr : io.stdout;
+                stream.write(text);
+            }
+        }
+        const violations = applyStrict(lintFiles(sources, config), opts.strict);
+        const report = formatReport(violations, reporter, cwd);
+        if (report.length > 0) {
+            io.stdout.write(report.endsWith("\n") ? report : `${report}\n`);
+        }
+        return exitCodeFor(violations);
+    }
+    catch (error) {
+        if (error instanceof ConfigError) {
+            io.stderr.write(`${error.message}\n`);
+            return 1;
+        }
+        const message = error instanceof Error ? error.message : String(error);
+        io.stderr.write(`${message}\n`);
+        return 1;
+    }
+}
+function formatRulesList() {
+    const lines = ["id                        default    severity   description", "-".repeat(90)];
+    for (const rule of builtinRules) {
+        const enabled = rule.defaultEnabled ? "on" : "opt-in";
+        lines.push(`${rule.id.padEnd(26)}${enabled.padEnd(11)}${rule.defaultSeverity.padEnd(11)}${rule.description}`);
+    }
+    return `${lines.join("\n")}\n`;
+}
+function parseReporter(name) {
+    if (name === "stylish" || name === "json") {
+        return name;
+    }
+    return undefined;
+}
+if (isMainModule(process.argv[1], fileURLToPath(import.meta.url))) {
+    process.exitCode = await runCli(process.argv);
+}
+//# 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,43 @@
+import type { RuleOptions, Severity } from "./rules/types.js";
+export declare class ConfigError extends Error {
+    constructor(message: string);
+}
+export declare const CONFIG_FILENAME = ".xanoscriptlint.yml";
+export interface CustomRuleConfig {
+    id: string;
+    name: string;
+    regex: string;
+    pattern: RegExp;
+    message: string;
+    severity: Severity;
+    included?: string[];
+    excluded?: string[];
+}
+export interface ResolvedConfig {
+    configDir: string;
+    configPath: string | null;
+    enabledRuleIds: Set<string>;
+    ruleOptions: Map<string, RuleOptions>;
+    included: string[];
+    excluded: string[];
+    customRules: CustomRuleConfig[];
+}
+interface RawConfig {
+    disabled_rules?: unknown;
+    opt_in_rules?: unknown;
+    only_rules?: unknown;
+    included?: unknown;
+    excluded?: unknown;
+    custom_rules?: unknown;
+    [key: string]: unknown;
+}
+export declare function findConfigPath(startDir: string): string | null;
+export declare function loadConfig(options: {
+    cwd: string;
+    configPath?: string;
+}): ResolvedConfig;
+export declare function loadConfigFile(configPath: string): ResolvedConfig;
+export declare function loadConfigText(text: string, configDir: string, configPath: string | null): ResolvedConfig;
+export declare function resolveConfig(raw: RawConfig, configDir: string, configPath: string | null): ResolvedConfig;
+export {};
+//# 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":"AAIA,OAAO,KAAK,EAAE,WAAW,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAE9D,qBAAa,WAAY,SAAQ,KAAK;gBACxB,OAAO,EAAE,MAAM;CAI5B;AAED,eAAO,MAAM,eAAe,wBAAwB,CAAC;AAWrD,MAAM,WAAW,gBAAgB;IAC/B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,QAAQ,CAAC;IACnB,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;IACpB,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;CACrB;AAED,MAAM,WAAW,cAAc;IAC7B,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,cAAc,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;IAC5B,WAAW,EAAE,GAAG,CAAC,MAAM,EAAE,WAAW,CAAC,CAAC;IACtC,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,WAAW,EAAE,gBAAgB,EAAE,CAAC;CACjC;AAWD,UAAU,SAAS;IACjB,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAED,wBAAgB,cAAc,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAa9D;AAED,wBAAgB,UAAU,CAAC,OAAO,EAAE;IAClC,GAAG,EAAE,MAAM,CAAC;IACZ,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB,GAAG,cAAc,CAajB;AAED,wBAAgB,cAAc,CAAC,UAAU,EAAE,MAAM,GAAG,cAAc,CAGjE;AAED,wBAAgB,cAAc,CAC5B,IAAI,EAAE,MAAM,EACZ,SAAS,EAAE,MAAM,EACjB,UAAU,EAAE,MAAM,GAAG,IAAI,GACxB,cAAc,CAYhB;AAED,wBAAgB,aAAa,CAC3B,GAAG,EAAE,SAAS,EACd,SAAS,EAAE,MAAM,EACjB,UAAU,EAAE,MAAM,GAAG,IAAI,GACxB,cAAc,CA6FhB"}

package/dist/config.js

@@ -0,0 +1,239 @@
+import { existsSync, readFileSync } from "node:fs";
+import path from "node:path";
+import { parse as parseYaml } from "yaml";
+import { builtinRules } from "./rules/index.js";
+export class ConfigError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = "ConfigError";
+    }
+}
+export const CONFIG_FILENAME = ".xanoscriptlint.yml";
+const KNOWN_KEYS = new Set([
+    "disabled_rules",
+    "opt_in_rules",
+    "only_rules",
+    "included",
+    "excluded",
+    "custom_rules",
+]);
+export function findConfigPath(startDir) {
+    let dir = path.resolve(startDir);
+    while (true) {
+        const candidate = path.join(dir, CONFIG_FILENAME);
+        if (existsSync(candidate)) {
+            return candidate;
+        }
+        const parent = path.dirname(dir);
+        if (parent === dir) {
+            return null;
+        }
+        dir = parent;
+    }
+}
+export function loadConfig(options) {
+    if (options.configPath) {
+        const configPath = path.resolve(options.cwd, options.configPath);
+        if (!existsSync(configPath)) {
+            throw new ConfigError(`config file not found: ${configPath}`);
+        }
+        return loadConfigFile(configPath);
+    }
+    const found = findConfigPath(options.cwd);
+    if (!found) {
+        return resolveConfig({}, path.resolve(options.cwd), null);
+    }
+    return loadConfigFile(found);
+}
+export function loadConfigFile(configPath) {
+    const text = readFileSync(configPath, "utf8");
+    return loadConfigText(text, path.dirname(configPath), configPath);
+}
+export function loadConfigText(text, configDir, configPath) {
+    let raw;
+    try {
+        raw = parseYaml(text) ?? {};
+    }
+    catch (error) {
+        const detail = error instanceof Error ? error.message : String(error);
+        throw new ConfigError(`invalid YAML: ${detail}`);
+    }
+    if (raw === null || typeof raw !== "object" || Array.isArray(raw)) {
+        throw new ConfigError("config must be a YAML mapping");
+    }
+    return resolveConfig(raw, configDir, configPath);
+}
+export function resolveConfig(raw, configDir, configPath) {
+    const builtinIds = new Set(builtinRules.map((rule) => rule.id));
+    const disabledRules = optionalStringList(raw.disabled_rules, "disabled_rules");
+    const optInRules = optionalStringList(raw.opt_in_rules, "opt_in_rules");
+    const onlyRules = optionalStringList(raw.only_rules, "only_rules");
+    const included = optionalStringList(raw.included, "included") ?? ["**/*.xs"];
+    const excluded = optionalStringList(raw.excluded, "excluded") ?? [];
+    const customRules = parseCustomRules(raw.custom_rules);
+    const customIds = new Set(customRules.map((rule) => rule.id));
+    for (const key of Object.keys(raw)) {
+        if (KNOWN_KEYS.has(key) || builtinIds.has(key) || customIds.has(key)) {
+            continue;
+        }
+        throw new ConfigError(`unknown config key: ${key}`);
+    }
+    if (onlyRules !== undefined) {
+        if (disabledRules !== undefined || optInRules !== undefined) {
+            throw new ConfigError("only_rules cannot be combined with disabled_rules or opt_in_rules");
+        }
+    }
+    const knownIds = new Set([...builtinIds, ...customIds]);
+    for (const [listName, list] of [
+        ["disabled_rules", disabledRules],
+        ["opt_in_rules", optInRules],
+        ["only_rules", onlyRules],
+    ]) {
+        if (!list) {
+            continue;
+        }
+        for (const id of list) {
+            if (id === "custom_rules") {
+                if (listName !== "only_rules") {
+                    throw new ConfigError("custom_rules is only valid in only_rules");
+                }
+                continue;
+            }
+            if (!knownIds.has(id)) {
+                throw new ConfigError(`unknown rule id in ${listName}: ${id}`);
+            }
+        }
+    }
+    const enabledRuleIds = new Set();
+    if (onlyRules !== undefined) {
+        for (const id of onlyRules) {
+            if (id === "custom_rules") {
+                for (const customId of customIds) {
+                    enabledRuleIds.add(customId);
+                }
+            }
+            else {
+                enabledRuleIds.add(id);
+            }
+        }
+    }
+    else {
+        for (const rule of builtinRules) {
+            if (rule.defaultEnabled && !disabledRules?.includes(rule.id)) {
+                enabledRuleIds.add(rule.id);
+            }
+            if (!rule.defaultEnabled && optInRules?.includes(rule.id)) {
+                enabledRuleIds.add(rule.id);
+            }
+        }
+        for (const custom of customRules) {
+            if (!disabledRules?.includes(custom.id)) {
+                enabledRuleIds.add(custom.id);
+            }
+        }
+    }
+    const ruleOptions = new Map();
+    for (const rule of builtinRules) {
+        if (rule.id in raw) {
+            ruleOptions.set(rule.id, parseRuleOptions(raw[rule.id], rule.id));
+        }
+    }
+    const activeCustomRules = customRules.filter((rule) => enabledRuleIds.has(rule.id));
+    return {
+        configDir,
+        configPath,
+        enabledRuleIds,
+        ruleOptions,
+        included,
+        excluded,
+        customRules: activeCustomRules,
+    };
+}
+function parseCustomRules(value) {
+    if (value === undefined || value === null) {
+        return [];
+    }
+    if (typeof value !== "object" || Array.isArray(value)) {
+        throw new ConfigError("custom_rules must be a mapping of id to rule");
+    }
+    const result = [];
+    for (const [id, spec] of Object.entries(value)) {
+        if (typeof spec !== "object" || spec === null || Array.isArray(spec)) {
+            throw new ConfigError(`custom_rules.${id} must be a mapping`);
+        }
+        const raw = spec;
+        if (typeof raw.regex !== "string" || raw.regex.length === 0) {
+            throw new ConfigError(`custom_rules.${id}.regex is required`);
+        }
+        let pattern;
+        try {
+            pattern = new RegExp(raw.regex);
+        }
+        catch (error) {
+            const detail = error instanceof Error ? error.message : String(error);
+            throw new ConfigError(`custom_rules.${id}.regex is invalid: ${detail}`);
+        }
+        result.push({
+            id,
+            name: optionalString(raw.name, `custom_rules.${id}.name`) ?? id,
+            regex: raw.regex,
+            pattern,
+            message: optionalString(raw.message, `custom_rules.${id}.message`) ??
+                `custom rule ${id} matched`,
+            severity: optionalSeverity(raw.severity, `custom_rules.${id}.severity`) ?? "warning",
+            included: optionalStringList(raw.included, `custom_rules.${id}.included`),
+            excluded: optionalStringList(raw.excluded, `custom_rules.${id}.excluded`),
+        });
+    }
+    return result;
+}
+function parseRuleOptions(value, id) {
+    if (typeof value === "string") {
+        return { severity: asSeverity(value, id) };
+    }
+    if (typeof value !== "object" || value === null || Array.isArray(value)) {
+        throw new ConfigError(`${id} must be a severity or a mapping`);
+    }
+    const record = value;
+    const options = {};
+    if (record.severity !== undefined) {
+        options.severity = asSeverity(record.severity, `${id}.severity`);
+    }
+    for (const key of Object.keys(record)) {
+        if (key !== "severity") {
+            throw new ConfigError(`unknown option for ${id}: ${key}`);
+        }
+    }
+    return options;
+}
+function optionalStringList(value, label) {
+    if (value === undefined || value === null) {
+        return undefined;
+    }
+    if (!Array.isArray(value) || value.some((item) => typeof item !== "string")) {
+        throw new ConfigError(`${label} must be a list of strings`);
+    }
+    return value;
+}
+function optionalString(value, label) {
+    if (value === undefined || value === null) {
+        return undefined;
+    }
+    if (typeof value !== "string") {
+        throw new ConfigError(`${label} must be a string`);
+    }
+    return value;
+}
+function optionalSeverity(value, label) {
+    if (value === undefined || value === null) {
+        return undefined;
+    }
+    return asSeverity(value, label);
+}
+function asSeverity(value, label) {
+    if (value === "error" || value === "warning") {
+        return value;
+    }
+    throw new ConfigError(`${label} must be "error" or "warning"`);
+}
+//# sourceMappingURL=config.js.map

package/dist/config.js.map

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

package/dist/customRules.d.ts

@@ -0,0 +1,4 @@
+import type { CustomRuleConfig } from "./config.js";
+import type { SourceFile, Violation } from "./rules/types.js";
+export declare function runCustomRules(file: SourceFile, rules: CustomRuleConfig[]): Violation[];
+//# sourceMappingURL=customRules.d.ts.map

package/dist/customRules.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"customRules.d.ts","sourceRoot":"","sources":["../src/customRules.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AACpD,OAAO,KAAK,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAG9D,wBAAgB,cAAc,CAC5B,IAAI,EAAE,UAAU,EAChB,KAAK,EAAE,gBAAgB,EAAE,GACxB,SAAS,EAAE,CA2Bb"}

package/dist/customRules.js

@@ -0,0 +1,43 @@
+import path from "node:path";
+import { isCommentLine, splitLines } from "./util.js";
+export function runCustomRules(file, rules) {
+    const violations = [];
+    const posixPath = file.path.split(path.sep).join("/");
+    for (const rule of rules) {
+        if (!pathAllowed(posixPath, rule)) {
+            continue;
+        }
+        const lines = splitLines(file.text);
+        for (let i = 0; i < lines.length; i += 1) {
+            const line = lines[i];
+            if (isCommentLine(line)) {
+                continue;
+            }
+            const match = rule.pattern.exec(line);
+            if (match) {
+                violations.push({
+                    ruleId: rule.id,
+                    message: rule.message,
+                    severity: rule.severity,
+                    file: file.path,
+                    line: i + 1,
+                    column: match.index + 1,
+                });
+            }
+        }
+    }
+    return violations;
+}
+function pathAllowed(posixPath, rule) {
+    if (rule.excluded?.some((pattern) => matchesPathRegex(posixPath, pattern))) {
+        return false;
+    }
+    if (rule.included && rule.included.length > 0) {
+        return rule.included.some((pattern) => matchesPathRegex(posixPath, pattern));
+    }
+    return true;
+}
+function matchesPathRegex(posixPath, pattern) {
+    return new RegExp(pattern).test(posixPath);
+}
+//# sourceMappingURL=customRules.js.map

package/dist/customRules.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"customRules.js","sourceRoot":"","sources":["../src/customRules.ts"],"names":[],"mappings":"AAAA,OAAO,IAAI,MAAM,WAAW,CAAC;AAG7B,OAAO,EAAE,aAAa,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC;AAEtD,MAAM,UAAU,cAAc,CAC5B,IAAgB,EAChB,KAAyB;IAEzB,MAAM,UAAU,GAAgB,EAAE,CAAC;IACnC,MAAM,SAAS,GAAG,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IACtD,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,IAAI,CAAC,WAAW,CAAC,SAAS,EAAE,IAAI,CAAC,EAAE,CAAC;YAClC,SAAS;QACX,CAAC;QACD,MAAM,KAAK,GAAG,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACpC,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,KAAK,CAAC,MAAM,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC;YACzC,MAAM,IAAI,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC;YACtB,IAAI,aAAa,CAAC,IAAI,CAAC,EAAE,CAAC;gBACxB,SAAS;YACX,CAAC;YACD,MAAM,KAAK,GAAG,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YACtC,IAAI,KAAK,EAAE,CAAC;gBACV,UAAU,CAAC,IAAI,CAAC;oBACd,MAAM,EAAE,IAAI,CAAC,EAAE;oBACf,OAAO,EAAE,IAAI,CAAC,OAAO;oBACrB,QAAQ,EAAE,IAAI,CAAC,QAAQ;oBACvB,IAAI,EAAE,IAAI,CAAC,IAAI;oBACf,IAAI,EAAE,CAAC,GAAG,CAAC;oBACX,MAAM,EAAE,KAAK,CAAC,KAAK,GAAG,CAAC;iBACxB,CAAC,CAAC;YACL,CAAC;QACH,CAAC;IACH,CAAC;IACD,OAAO,UAAU,CAAC;AACpB,CAAC;AAED,SAAS,WAAW,CAAC,SAAiB,EAAE,IAAsB;IAC5D,IAAI,IAAI,CAAC,QAAQ,EAAE,IAAI,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,gBAAgB,CAAC,SAAS,EAAE,OAAO,CAAC,CAAC,EAAE,CAAC;QAC3E,OAAO,KAAK,CAAC;IACf,CAAC;IACD,IAAI,IAAI,CAAC,QAAQ,IAAI,IAAI,CAAC,QAAQ,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC9C,OAAO,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,gBAAgB,CAAC,SAAS,EAAE,OAAO,CAAC,CAAC,CAAC;IAC/E,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED,SAAS,gBAAgB,CAAC,SAAiB,EAAE,OAAe;IAC1D,OAAO,IAAI,MAAM,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;AAC7C,CAAC"}

package/dist/discover.d.ts

@@ -0,0 +1,7 @@
+import type { ResolvedConfig } from "./config.js";
+export declare function discoverXsFiles(options: {
+    config: ResolvedConfig;
+    cwd: string;
+    cliPaths: string[];
+}): Promise<string[]>;
+//# sourceMappingURL=discover.d.ts.map